init

docs/ai/Common/DTS.CommonCore/Interface/ISO/ExtraProperties.md

@@ -0,0 +1,46 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Interface/ISO/ExtraProperties/IExtraPropertiesListView.cs
+  - Common/DTS.CommonCore/Interface/ISO/ExtraProperties/IExtraPropertiesListViewModel.cs
+  - Common/DTS.CommonCore/Interface/ISO/ExtraProperties/IExtraProperty.cs
+generated_at: "2026-04-17T16:35:09.375049+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "81b9bbf7852fdb8a"
+---
+
+# Documentation: DTS.Common.Interface.ISO.ExtraProperties
+
+## 1. Purpose
+
+This module defines the contract for a Model-View-ViewModel (MVVM) pattern implementation for managing extra properties in an ISO-related context. It provides interfaces for a key-value property list system where users can view, edit, copy, delete, filter, and sort custom properties. The module supports read-only modes, multi-row paste operations (e.g., CSV data), and validation with error reporting. It is designed to integrate with a broader page-based application framework.
+
+---
+
+## 2. Public Interface
+
+### `IExtraPropertiesListView`
+**Signature:** `public interface IExtraPropertiesListView : IBaseView { }`
+
+A marker interface representing the view component in the MVVM pattern. It extends `IBaseView` and defines no additional members.
+
+---
+
+### `IExtraPropertiesListViewModel`
+**Signature:** `public interface IExtraPropertiesListViewModel : IBaseViewModel`
+
+Defines the ViewModel contract for managing a collection of extra properties.
+
+| Member | Signature | Description |
+|--------|-----------|-------------|
+| `SetPage` | `void SetPage(IDataPROPage page)` | Associates a page context with the ViewModel. |
+| `SetParent` | `void SetParent(object parent)` | Sets a parent object reference. |
+| `View` | `IExtraPropertiesListView View { get; set; }` | Gets or sets the associated view instance. |
+| `CopySelected` | `void CopySelected()` | Copies the currently selected properties. |
+| `DeleteSelected` | `void DeleteSelected()` | Deletes the currently selected properties. |
+| `ExtraProperties` | `ObservableCollection<IExtraProperty> ExtraProperties { get; set; }` | The observable collection of extra properties for UI binding. |
+| `SetExtraProperties` | `void SetExtraProperties(IList<IExtraProperty> properties)` | Replaces the property collection with the provided list. |
+| `Filter` | `void Filter(object tag, string term)` | Filters the property collection based on a tag and search term. |
+| `Sort` | `void Sort(object o, bool columnClick)` | Sorts the property collection. |
+| `Validate` | `bool Validate(ref List<string> errors)` | Validates the properties; returns `true` if valid, `false` otherwise. Errors are added to the provided list. |
+|