init

docs/ai/Common/DTS.Common.SerializationPlus/Control.md

@@ -0,0 +1,68 @@
+---
+source_files:
+  - Common/DTS.Common.SerializationPlus/Control/ReviewableAttribute.cs
+  - Common/DTS.Common.SerializationPlus/Control/IntervalSec.cs
+generated_at: "2026-04-17T15:41:28.581864+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "6dbfe6ac8568fa23"
+---
+
+# Documentation: DTS.Slice.Control Types
+
+## 1. Purpose
+
+This module provides two foundational types for the DTS Slice Control subsystem. `ReviewableAttribute` is an abstract base class representing attributes that can be displayed on a "review tab," with values computed on-demand via a delegate. `IntervalSec` is a simple value type representing a time interval in seconds, with bidirectional implicit conversion to/from `DTS.Serialization.Test.IntervalSec` for serialization purposes.
+
+---
+
+## 2. Public Interface
+
+### `ReviewableAttribute` (abstract class)
+
+**Namespace:** `DTS.Slice.Control`  
+**Base class:** `Exceptional`
+
+#### Constructor
+```csharp
+public ReviewableAttribute(string name, DetermineValueString calculateValue)
+```
+Initializes a new instance with the given name and value calculation delegate.
+
+#### Properties
+
+| Property | Type | Access | Description |
+|----------|------|--------|-------------|
+| `Name` | `string` | get / private set | The name associated with this review tab-displayable attribute. |
+| `Value` | `string` | get | Returns the computed value string. On exception, logs the error via `Utilities.Logging.APILogger.Log()` and returns `"N/A"`. |
+
+#### Delegate
+```csharp
+public delegate string DetermineValueString()
+```
+Delegate type used to compute the attribute's value on demand.
+
+---
+
+### `IntervalSec` (class)
+
+**Namespace:** `DTS.Slice.Control`  
+**Base class:** `Exceptional`
+
+#### Constructors
+
+```csharp
+public IntervalSec()
+```
+Creates an instance with `Begin` and `End` properties left "uninitialized" (defaulting to `0` per the `Property<double>` initialization).
+
+```csharp
+public IntervalSec(double begin, double end)
+```
+Creates an instance with the specified begin and end times.
+
+#### Properties
+
+| Property | Type | Access | Description |
+|----------|------|--------|-------------|
+| `Begin` | `double`