init

docs/ai/Common/DTS.CommonCore/Events/TestSetups/TestSetupsList.md

@@ -0,0 +1,63 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Events/TestSetups/TestSetupsList/CurrentTestIdChangedEvent.cs
+  - Common/DTS.CommonCore/Events/TestSetups/TestSetupsList/CurrentTestChangedEvent.cs
+  - Common/DTS.CommonCore/Events/TestSetups/TestSetupsList/TestSetupsListEditTestSetupEvent.cs
+  - Common/DTS.CommonCore/Events/TestSetups/TestSetupsList/TestSetupsListTestSetupSelectedEvent.cs
+generated_at: "2026-04-17T16:34:44.784908+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "d96706f4d371f90e"
+---
+
+# Documentation: DTS.Common.Events.TestSetups.TestSetupsList
+
+## 1. Purpose
+
+This module defines a set of event types used for inter-component communication within the Test Setups List feature. These events leverage the Prism Event Aggregation pattern (via `CompositePresentationEvent<T>`) to enable loosely-coupled publish/subscribe messaging between components that need to react to changes in test setup state, selection, or editing requests. The events facilitate coordination between UI components and business logic without direct dependencies.
+
+---
+
+## 2. Public Interface
+
+### `CurrentTestIdChangedEvent`
+- **Signature:** `public class CurrentTestIdChangedEvent : CompositePresentationEvent<string>`
+- **Payload Type:** `string`
+- **Behavior:** Published when the current test's identifier changes. Subscribers receive the new test ID as a string payload.
+
+### `CurrentTestChangedEvent`
+- **Signature:** `public class CurrentTestChangedEvent : CompositePresentationEvent<string>`
+- **Payload Type:** `string`
+- **Behavior:** Published to signal that the current test setup has changed. Subscribers receive a string payload (content/meaning of payload not specified in source).
+
+### `TestSetupsListEditTestSetupEvent`
+- **Signature:** `public class TestSetupsListEditTestSetupEvent : CompositePresentationEvent<string>`
+- **Payload Type:** `string`
+- **Behavior:** Published when a test setup should be edited. Subscribers receive a string payload, presumably identifying the test setup to edit.
+
+### `TestSetupsListTestSetupSelectedEvent`
+- **Signature:** `public class TestSetupsListTestSetupSelectedEvent : CompositePresentationEvent<string[]>`
+- **Payload Type:** `string[]` (array of strings)
+- **Behavior:** Published when a test setup is selected. According to source remarks, this is used by the Summary step to indicate that the Import button was clicked. Subscribers receive a string array payload.
+
+---
+
+## 3. Invariants
+
+- All event classes inherit from `CompositePresentationEvent<T>` and are sealed by implication of having no further derivation in source.
+- Payload types are fixed per event type:
+  - `CurrentTestIdChangedEvent`: `string`
+  - `CurrentTestChangedEvent`: `string`
+  - `TestSetupsListEditTestSetupEvent`: `string`
+  - `TestSetupsListTestSetupSelectedEvent`: `string[]`
+- All events are reference types that must be resolved through Prism's `IEventAggregator` service; they cannot be instantiated directly for pub/sub operations in typical usage patterns.
+
+---
+
+## 4. Dependencies
+
+### External Dependencies
+- **Microsoft.Practices.Prism.Events** — Provides `CompositePresentationEvent<T>`, the base class for all events in this module. This is part of the Prism library (legacy versions, pre-Prism 6).
+
+### Downstream Dependencies
+- **Unknown from source alone.** Consumers would typically be ViewModels,