init

docs/ai/Common/DTS.Common/Classes/ISO/ExtraProperties.md

@@ -0,0 +1,60 @@
+---
+source_files:
+  - Common/DTS.Common/Classes/ISO/ExtraProperties/TextPastedArgs.cs
+generated_at: "2026-04-17T16:40:00.349676+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "d715f67ccc715086"
+---
+
+# Documentation: TextPastedArgs
+
+## 1. Purpose
+
+`TextPastedArgs` is an event argument class that encapsulates data related to text paste operations within the ISO Extra Properties system. It implements `ITextPastedEventArgs` and serves as a data transfer object to communicate paste event details—including the pasted text content, the source extra property, an identifier, and an optional tag—between event producers and consumers.
+
+## 2. Public Interface
+
+### Class: `TextPastedArgs`
+**Namespace:** `DTS.Common.ISO.ExtraProperties`  
+**Implements:** `ITextPastedEventArgs`
+
+#### Properties
+
+| Property | Type | Access | Description |
+|----------|------|--------|-------------|
+| `Text` | `string` | Read-only | The text content that was pasted. |
+| `Sender` | `object` | Read-only | The source object of the paste event. Set from the `extraProperty` constructor parameter. |
+| `Id` | `string` | Read-only | An identifier associated with the paste event. |
+| `Tag` | `object` | Read-only | An arbitrary object for additional context or data. |
+
+#### Constructor
+
+```csharp
+public TextPastedArgs(string text, IExtraProperty extraProperty, string id, object tag)
+```
+
+Creates a new `TextPastedArgs` instance with the specified values. The `extraProperty` parameter is assigned to the `Sender` property.
+
+## 3. Invariants
+
+- All properties are immutable after construction (read-only getters with no setters).
+- `Sender` is always assigned from an `IExtraProperty` instance passed to the constructor, though the property type is `object`.
+- No null validation is performed in the constructor; any parameter may be `null`.
+
+## 4. Dependencies
+
+### This module depends on:
+- `DTS.Common.Events` — Likely contains event infrastructure or the `ITextPastedEventArgs` interface definition.
+- `DTS.Common.Interface.ISO.ExtraProperties` — Provides `ITextPastedEventArgs` and `IExtraProperty` interfaces.
+
+### What depends on this module:
+- Cannot be determined from this source file alone.
+
+## 5. Gotchas
+
+1. **Naming mismatch:** The constructor parameter is named `extraProperty` but is assigned to the `Sender` property. This naming inconsistency may cause confusion about the intended semantics of the property.
+
+2. **Unused imports:** The file imports `System.Collections.Generic`, `System.Linq`, and `System.Text`, none of which are used in the current implementation. This may indicate dead code or remnants from previous refactoring.
+
+3. **No null guards:** The constructor performs no validation. Callers should be aware that `Text`, `Id`, `Sender`, and `Tag` may all be `null` depending on what is passed in.