init

docs/ai/Common/DTS.CommonCore/RibbonControl.md

@@ -0,0 +1,55 @@
+---
+source_files:
+  - Common/DTS.CommonCore/RibbonControl/RibbonControlSelectionChanged.cs
+  - Common/DTS.CommonCore/RibbonControl/RibbonControlOperation.cs
+  - Common/DTS.CommonCore/RibbonControl/RibbonControlSelectionEventArgs.cs
+  - Common/DTS.CommonCore/RibbonControl/RibbonControlSelectionChangeBehavior.cs
+  - Common/DTS.CommonCore/RibbonControl/RibbonRegionAdapter.cs
+generated_at: "2026-04-17T15:35:45.238944+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "58c3d04be273f67a"
+---
+
+# Documentation: DTS.Common.RibbonControl
+
+## 1. Purpose
+
+This module provides Prism region adapter support for integrating WPF `Ribbon` controls with the Prism navigation framework. It enables dynamic addition and removal of `RibbonTab` items through region management, synchronizes tab selection between document/workspace views and the ribbon, and publishes selection change events via the Prism event aggregator. The module bridges the gap between Prism's region-based view composition and the WPF Ribbon control's item management model.
+
+---
+
+## 2. Public Interface
+
+### `RibbonControlOperation` (enum)
+**File:** `RibbonControlOperation.cs`
+
+Defines operation types for ribbon control changes.
+
+| Member | Description |
+|--------|-------------|
+| `AddedItem` | Indicates an item has been added to the TabControl |
+| `RemovedItem` | Indicates an item has been removed from the TabControl |
+
+---
+
+### `RibbonControlSelectionEventArgs` (class)
+**File:** `RibbonControlSelectionEventArgs.cs`
+
+Event arguments carrying information about ribbon selection changes.
+
+```csharp
+public RibbonControlSelectionEventArgs(RibbonControlOperation operation, object item)
+```
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Operation` | `RibbonControlOperation` | Gets the operation type (AddedItem or RemovedItem) |
+| `Item` | `object` | Gets the added or removed tab control item |
+
+---
+
+### `RibbonControlSelectionChanged` (class)
+**File:** `RibbonControlSelectionChanged.cs`
+
+A Prism `