@oods/component-contracts 0.3.3 → 0.4.1

package/dist/index.js

@@ -4,7 +4,7 @@ var component_intake_v1_default = {
   kind: "component-intake",
   baselineCommit: "ae560bc22969c1fd81336730be4330c9115fc316",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 114,
   countRule: "Derived from the unique, deterministically sorted rows array; never from an independent counter.",
   rows: [
     {
@@ -935,6 +935,38 @@ var component_intake_v1_default = {
         "traits/visual/Colorized.trait.yaml"
       ]
     },
+    {
+      id: "Combobox",
+      displayName: "Combobox",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "autocomplete",
+          "combobox",
+          "field",
+          "filter",
+          "form",
+          "input",
+          "interactive",
+          "primitive",
+          "select"
+        ],
+        contexts: [
+          "form"
+        ],
+        regions: [
+          "form",
+          "main"
+        ]
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#Combobox",
+        "packages/mcp-server/src/render/component-map.ts#renderCombobox"
+      ],
+      addedBy: "s223-m02; decision #2527 ruling 11"
+    },
     {
       id: "CommunicationDetailPanel",
       displayName: "CommunicationDetailPanel",
@@ -1050,6 +1082,28 @@ var component_intake_v1_default = {
         "traits/content/Labelled.trait.yaml"
       ]
     },
+    {
+      id: "Dialog",
+      displayName: "Dialog",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "dialog",
+          "modal",
+          "overlay",
+          "primitive"
+        ],
+        contexts: [],
+        regions: []
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#Dialog",
+        "packages/mcp-server/src/render/component-map.ts#renderDialog"
+      ],
+      addedBy: "s222-m02; decision #2502 ruling 11"
+    },
     {
       id: "FilterPanel",
       displayName: "FilterPanel",
@@ -1898,6 +1952,37 @@ var component_intake_v1_default = {
         "traits/behavioral/Searchable.trait.yaml"
       ]
     },
+    {
+      id: "SegmentedControl",
+      displayName: "SegmentedControl",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "choice",
+          "field",
+          "form",
+          "input",
+          "interactive",
+          "primitive",
+          "radio",
+          "segmented-control"
+        ],
+        contexts: [
+          "form"
+        ],
+        regions: [
+          "form",
+          "main"
+        ]
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#SegmentedControl",
+        "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl"
+      ],
+      addedBy: "s223-m02; decision #2527 ruling 10"
+    },
     {
       id: "Select",
       displayName: "Select",
@@ -2155,6 +2240,36 @@ var component_intake_v1_default = {
         "traits/lifecycle/Stateful.trait.yaml"
       ]
     },
+    {
+      id: "Switch",
+      displayName: "Switch",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "boolean",
+          "field",
+          "form",
+          "input",
+          "interactive",
+          "primitive",
+          "switch"
+        ],
+        contexts: [
+          "form"
+        ],
+        regions: [
+          "form",
+          "main"
+        ]
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#Switch",
+        "packages/mcp-server/src/render/component-map.ts#renderSwitch"
+      ],
+      addedBy: "s222-m02; decision #2502 ruling 11"
+    },
     {
       id: "Table",
       displayName: "Table",
@@ -3174,9 +3289,9 @@ var component_reconciliation_proposed_v2_default = {
   baselineCommit: "a5638cf819bdadb86e2336c4aabe9b2184699c13",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
   status: "proposed-awaiting-approval",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 114,
   approvedRuntimeCensus: null,
-  proposedRuntimeCensus: 110,
+  proposedRuntimeCensus: 114,
   rows: [
     {
       id: "AddressCollectionPanel",
@@ -3816,6 +3931,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "Combobox",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderCombobox",
+        "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+        "packages/components-vue/evidence/vue-readiness.v1.json#Combobox",
+        "packages/component-contracts/src/contracts.ts#Combobox"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "Combobox",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2527 (ruling 11). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "CommunicationDetailPanel",
       proposedClassification: "recipe",
@@ -3896,6 +4030,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "Dialog",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderDialog",
+        "packages/components-react/evidence/react-readiness.v1.json#Dialog",
+        "packages/components-vue/evidence/vue-readiness.v1.json#Dialog",
+        "packages/component-contracts/src/contracts.ts#Dialog"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "Dialog",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2502 (ruling 11). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "FilterPanel",
       proposedClassification: "recipe",
@@ -4510,6 +4663,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "SegmentedControl",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl",
+        "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+        "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl",
+        "packages/component-contracts/src/contracts.ts#SegmentedControl"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "SegmentedControl",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2527 (ruling 10). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "Select",
       proposedClassification: "native",
@@ -4671,6 +4843,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "Switch",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderSwitch",
+        "packages/components-react/evidence/react-readiness.v1.json#Switch",
+        "packages/components-vue/evidence/vue-readiness.v1.json#Switch",
+        "packages/component-contracts/src/contracts.ts#Switch"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "Switch",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2502 (ruling 11). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "Table",
       proposedClassification: "native",
@@ -5383,7 +5574,7 @@ var component_capability_ledger_v1_default = {
   schemaVersion: "1.0.0",
   kind: "component-capability-ledger",
   generatedAt: "2026-09-11T05:30:00Z",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 114,
   approvedRuntimeCensus: null,
   source: "refresh_structured_data.py#project_measured_surfaces",
   rows: [
@@ -8092,6 +8283,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "Combobox",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#Combobox"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#Combobox"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderCombobox"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-measured.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-measured.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-theme/report.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-theme/report.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-measured.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-measured.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        }
+      }
+    },
     {
       id: "CommunicationDetailPanel",
       proposedClassification: "recipe",
@@ -8451,6 +8713,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "Dialog",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#Dialog"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#Dialog"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderDialog"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#Dialog"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#Dialog"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-measured.json#Dialog",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-measured.json#Dialog",
+            "packages/components-react/evidence/react-readiness.v1.json#Dialog",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Dialog"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-theme/report.json#Dialog",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-theme/report.json#Dialog",
+            "packages/components-react/evidence/react-readiness.v1.json#Dialog",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Dialog"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-measured.json#Dialog",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-measured.json#Dialog",
+            "packages/components-react/evidence/react-readiness.v1.json#Dialog",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Dialog"
+          ]
+        }
+      }
+    },
     {
       id: "FilterPanel",
       proposedClassification: "recipe",
@@ -11072,6 +11405,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "SegmentedControl",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#SegmentedControl"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#SegmentedControl"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-measured.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-measured.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-theme/report.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-theme/report.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-measured.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-measured.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        }
+      }
+    },
     {
       id: "Select",
       proposedClassification: "native",
@@ -12039,6 +12443,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "Switch",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#Switch"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#Switch"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderSwitch"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#Switch"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#Switch"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-measured.json#Switch",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-measured.json#Switch",
+            "packages/components-react/evidence/react-readiness.v1.json#Switch",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Switch"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-theme/report.json#Switch",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-theme/report.json#Switch",
+            "packages/components-react/evidence/react-readiness.v1.json#Switch",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Switch"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/react-measured.json#Switch",
+            "artifacts/product-reality/sprint-222/m02/switch-dialog/vue-measured.json#Switch",
+            "packages/components-react/evidence/react-readiness.v1.json#Switch",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Switch"
+          ]
+        }
+      }
+    },
     {
       id: "Table",
       proposedClassification: "native",
@@ -15099,10 +15574,12 @@ var NUCLEUS_COMPONENT_IDS = [
   "ColorStatePicker",
   "ColorSwatch",
   "ColorizedBadge",
+  "Combobox",
   "CommunicationDetailPanel",
   "CycleProgressCard",
   "DatePicker",
   "DetailHeader",
+  "Dialog",
   "FilterPanel",
   "FormLabelGroup",
   "GeoFieldMappingForm",
@@ -15133,6 +15610,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "RoleAssignmentForm",
   "RoleBadgeList",
   "SearchInput",
+  "SegmentedControl",
   "Select",
   "SortIndicator",
   "Stack",
@@ -15141,6 +15619,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "StatusColorLegend",
   "StatusSelector",
   "StatusTimeline",
+  "Switch",
   "Table",
   "Tabs",
   "TagInput",
@@ -15266,9 +15745,15 @@ var componentBehaviors = {
   ClassificationPanel: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "ClassificationPanel presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   ColorSwatch: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "ColorSwatch presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   ColorizedBadge: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "ColorizedBadge presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
+  // s223-m02 (#2527 ruling 11): each trigger starts from the documented example (Canada chosen, the list closed). Tab reaches
+  // the input; typing edits the filter text; Down opens the list at the first option and Up at the last (Japan, disabled,
+  // is never reached); Home and End act on the list a key has opened; Enter picks the active option (France, after three
+  // Downs); and Escape with the list closed clears the field and emits an empty value.
+  Combobox: { "role": "combobox", "name": { "strategy": "label", "target": 'input[role="combobox"]' }, "keyboard": { "Tab": "Move focus to the named native control; an open list closes without picking", "x": "Type to filter the options by label", "ArrowDown": "Open the list and move to the next option", "ArrowUp": "Move to the previous option; with the list closed, open it at the last option", "Home": "Move to the first option of an open list", "End": "Move to the last option of an open list", "Enter": "Pick the active option and close the list", "Escape": "Close the list; with the list closed, clear the field" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "x", "effect": { "kind": "value", "value": "Canadax" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "ArrowDown", "effect": { "kind": "active-option", "value": "Australia" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "ArrowUp", "effect": { "kind": "active-option", "value": "United States" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowUp"], "key": "Home", "effect": { "kind": "active-option", "value": "Australia" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowDown"], "key": "End", "effect": { "kind": "active-option", "value": "United States" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowDown", "ArrowDown", "ArrowDown"], "key": "Enter", "effect": { "kind": "event", "value": "fr" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "Escape", "effect": { "kind": "event", "value": "" } }] },
   CycleProgressCard: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "CycleProgressCard presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   DatePicker: { "role": "none", "name": { "strategy": "label", "target": 'input[type="date"]' }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[type="date"]', "key": "Tab", "effect": { "kind": "focus" } }] },
   DetailHeader: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "DetailHeader presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
+  Dialog: { "role": "button", "name": { "strategy": "aria-label", "target": 'button[aria-label="Close"]' }, "keyboard": { "Tab": "Move focus to the named native control", "Enter": "Activate the control", "Escape": "Close the dialog" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'button[aria-label="Close"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": 'button[aria-label="Close"]', "effect": { "kind": "event" }, "action": "click" }, { "trigger": "keyboard", "target": 'button[aria-label="Close"]', "effect": { "kind": "event" }, "key": "Enter" }, { "trigger": "keyboard", "target": 'button[aria-label="Close"]', "effect": { "kind": "event" }, "key": "Escape" }] },
   FilterPanel: { "role": "button", "name": { "strategy": "label", "target": "button[data-filter-apply]" }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "button[data-filter-apply]", "key": "Tab", "effect": { "kind": "focus" } }] },
   FormLabelGroup: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "FormLabelGroup presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   Grid: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "Grid presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
@@ -15296,11 +15781,15 @@ var componentBehaviors = {
   RoleAssignmentForm: { "role": "textbox", "name": { "strategy": "label", "target": 'input[name="assignee"]' }, "keyboard": { "Tab": "Move focus to the named native control", "x": "Edit the named control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[name="assignee"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[name="assignee"]', "effect": { "kind": "value", "value": "ada@example.testx" }, "key": "x" }] },
   RoleBadgeList: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "RoleBadgeList presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   SearchInput: { "role": "searchbox", "name": { "strategy": "label", "target": "input" }, "keyboard": { "Tab": "Move focus to the named native control", "Escape": "Clear the current search" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "input", "key": "Escape", "effect": { "kind": "event", "value": "" } }, { "trigger": "keyboard", "target": "input", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": 'button[aria-label="Clear search"]', "action": "click", "effect": { "kind": "event", "value": "" } }] },
+  // s223-m02 (#2527 ruling 10): the focus target is the checked radio, as Tabs names its tab; the radiogroup and its name
+  // are asserted in each framework's scenario spec. The browser owns the keys, so each is a native radio-group move.
+  SegmentedControl: { "role": "radio", "name": { "strategy": "label", "target": 'input[type="radio"]:checked' }, "keyboard": { "Tab": "Move focus to the checked option", "ArrowRight": "Check and focus the next option", "ArrowDown": "Check and focus the next option", "ArrowLeft": "Check and focus the previous option", "ArrowUp": "Check and focus the previous option" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowRight", "effect": { "kind": "event", "value": "yearly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowDown", "effect": { "kind": "event", "value": "yearly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowLeft", "effect": { "kind": "event", "value": "monthly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowUp", "effect": { "kind": "event", "value": "monthly" } }, { "trigger": "pointer", "target": 'input[value="yearly"]', "effect": { "kind": "event", "value": "yearly" }, "action": "click" }] },
   Select: { "role": "combobox", "name": { "strategy": "label", "target": "select" }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "select", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": "select", "effect": { "kind": "event", "value": "basic" }, "action": "select", "value": "basic" }] },
   Stack: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "Stack presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   StatusBadge: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "StatusBadge presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   StatusSelector: { "role": "combobox", "name": { "strategy": "label", "target": "select" }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "select", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": "select", "effect": { "kind": "event", "value": "draft" }, "action": "select", "value": "draft" }] },
   StatusTimeline: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "StatusTimeline presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
+  Switch: { "role": "switch", "name": { "strategy": "label", "target": 'button[role="switch"]' }, "keyboard": { "Tab": "Move focus to the named native control", " ": "Toggle the switch", "Enter": "Toggle the switch" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'button[role="switch"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": 'button[role="switch"]', "effect": { "kind": "event", "value": true }, "action": "click" }, { "trigger": "keyboard", "target": 'button[role="switch"]', "effect": { "kind": "event", "value": true }, "key": " " }, { "trigger": "keyboard", "target": 'button[role="switch"]', "effect": { "kind": "event", "value": true }, "key": "Enter" }] },
   Table: { "role": "button", "name": { "strategy": "label", "target": "tbody button" }, "keyboard": { "Tab": "Move focus to the named native control", "Enter": "Activate the control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "tbody button", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": "tbody button", "effect": { "kind": "event", "value": "sub-1" }, "action": "click" }, { "trigger": "keyboard", "target": "tbody button", "effect": { "kind": "event", "value": "sub-1" }, "key": "Enter" }] },
   Tabs: { "role": "tab", "name": { "strategy": "label", "target": '[role="tab"][data-tab-id="overview"]' }, "keyboard": { "Tab": "Move focus to the named native control", "ArrowRight": "Select and focus the next tab" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": '[role="tab"][data-tab-id="overview"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": '[role="tab"][data-tab-id="overview"]', "effect": { "kind": "selected-tab", "value": "billing", "target": '[role="tab"][data-tab-id="billing"]' }, "key": "ArrowRight" }] },
   TagInput: { "role": "textbox", "name": { "strategy": "label", "target": "input" }, "keyboard": { "Tab": "Move focus to the named native control", "x": "Edit the named control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "input", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": "input", "effect": { "kind": "event", "value": "bex" }, "key": "x" }] },
@@ -15326,7 +15815,7 @@ var authoredContracts = {
     states: ["summary", "content"],
     tokenRoles: ["panel.background", "panel.border", "panel.title", "panel.subtitle"],
     accessibility: ["A real h3 heading names the panel section", "Subtitle and summary text remain visible beside the heading", "The panel is noninteractive"],
-    compatibility: "Mirrors renderAddressCollectionPanel over renderPanelSection with data-panel-type=address: title aliases title/label/heading/name (default Addresses), subtitle aliases subtitle/description/metadata, and summary/text/body/emptyMessage fill the content area only without authored children. The saved-schema directives roleField, defaultRoleField and roleParameter are consumed by codegen and left unbound, and the generic field (the addresses collection) is consumed without a binding: the HTML renderer reads no address data, so the panel presents its heading, subtitle, summary and authored children only."
+    compatibility: "Mirrors renderAddressCollectionPanel over renderPanelSection with data-panel-type=address: title aliases title/label/heading/name (default Addresses), subtitle aliases subtitle/description/metadata, and summary/text/body/emptyMessage fill the content area only without authored children. The saved-schema directives roleField, defaultRoleField and roleParameter are consumed by codegen and left unbound. The generic field (the addresses collection) lowers to summary, the record's addresses one line each (addressCollectionSummary; a generated workflow's store prints the same line), in every renderer and on a single screen as in a workflow."
   },
   AddressEditor: {
     id: "AddressEditor",
@@ -15346,7 +15835,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Inherits Badge inline noninteractive status label semantics", "The resolved label is always visible text"],
     compatibility: "Mirrors renderAddressSummaryBadge over renderBadgePrimitive with default variant address and default label Address: the label reads label/text/role/value in that order, the status reads status/state/role, and both are exposed as data-badge-status and data-badge-variant on the governed Badge substrate; tone and emphasis retain their shared Badge behaviour. The generic field lowers to role (the address role that names the status), so an authored label stays the visible text while the bound role drives data-badge-status; role is the address role, never an ARIA role, on a noninteractive badge."
   },
@@ -15361,17 +15850,17 @@ var authoredContracts = {
     accessibility: ["A log region named by its title, which is also a real h3 heading", "Events are an ordered list with machine-readable timestamps", "An empty timeline is named No events"],
     compatibility: "Mirrors renderAddressValidationTimeline over renderTimelineContainer with data-timeline-type=address-validation and role=log: title aliases title/label/heading/name (default Address Validation Timeline); the first array among events/validations/history supplies the events, each rendered as label, time and detail exactly as normalizeTimelineItems reads them (records use label/title/event/status/state/text/name, timestamp/datetime/time/at/createdAt/updatedAt and detail/description/reason/message/from/to; scalars render as text); no events renders the named empty item; authored children replace the list. The generic field (the addresses collection) lowers to events."
   },
-  ArchiveEvent: { "id": "ArchiveEvent", "version": "1.1.0", "props": ["title", "archivedAt", "restoredAt", "archivedBy", "reason", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied. metadataField and restorationMetadataField are consumed unbound, matching the retained renderer; metadata inspection is not claimed." },
+  ArchiveEvent: { "id": "ArchiveEvent", "version": "1.1.0", "props": ["title", "archivedAt", "restoredAt", "archivedBy", "reason", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied; with no archive or restore recorded the card renders nothing (s223-m01). metadataField and restorationMetadataField are consumed unbound, matching the retained renderer; metadata inspection is not claimed." },
   ArchivePill: {
     id: "ArchivePill",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "isArchived"],
+    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "isArchived", "hideWhenFalse"],
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["false remains visible", "archive is the badge variant"],
-    compatibility: "Mirrors renderArchivePill over renderBadgePrimitive: label/text/status/state/isArchived/value label precedence, status/state/isArchived/value status precedence, Archive fallback and archive variant. Boolean flags read Not archived / Archived while preserving their recorded status; absent flags remain absent and authored labels or children win. field binds isArchived. archivedAtField is consumed unbound because the HTML pill has no date term. Noninteractive; no archive or restore action."
+    compatibility: 'Mirrors renderArchivePill over renderBadgePrimitive: label/text/status/state/isArchived/value label precedence, status/state/isArchived/value status precedence, Archive fallback and archive variant. Boolean flags read Not archived / Archived while preserving their recorded status; absent flags remain absent and authored labels or children win. field binds isArchived. With hideWhenFalse a false flag renders nothing (s223-m01: a card shows "Archived", never the default "Not archived"); a true flag still reads Archived. archivedAtField is consumed unbound because the HTML pill has no date term. Noninteractive; no archive or restore action.'
   },
   ArchiveSummary: {
     id: "ArchiveSummary",
@@ -15436,7 +15925,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text", "badge.icon"],
+    tokenRoles: ["badge.background", "badge.text", "badge.icon"],
     accessibility: ["Inline noninteractive status label", "Decorative icons are hidden from assistive technology"],
     compatibility: "The existing React status registry is the starting implementation."
   },
@@ -15509,15 +15998,15 @@ var authoredContracts = {
   CancellationBadge: {
     id: "CancellationBadge",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "cancelAtPeriodEnd", "isCancelled"],
+    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "cancelAtPeriodEnd", "isCancelled", "hideWhenFalse"],
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["false remains visible", "cancellation is the badge variant"],
-    compatibility: "Mirrors renderCancellationBadge over renderBadgePrimitive: label/text/status/state/cancelAtPeriodEnd/value label precedence; status/state/cancelAtPeriodEnd/isCancelled/value status precedence; Cancellation fallback and cancellation variant. Boolean flags read No cancellation scheduled / Cancellation scheduled while preserving their recorded status; absent flags remain absent. field binds cancelAtPeriodEnd. Authored labels or children win. Noninteractive; no cancellation action."
+    compatibility: 'Mirrors renderCancellationBadge over renderBadgePrimitive: label/text/status/state/cancelAtPeriodEnd/value label precedence; status/state/cancelAtPeriodEnd/isCancelled/value status precedence; Cancellation fallback and cancellation variant. Boolean flags read No cancellation scheduled / Cancellation scheduled while preserving their recorded status; absent flags remain absent. field binds cancelAtPeriodEnd. With hideWhenFalse a false flag renders nothing (s223-m01: a card shows "Cancellation scheduled", never the default "No cancellation scheduled"); a true flag still reads Cancellation scheduled. Authored labels or children win. Noninteractive; no cancellation action.'
   },
-  CancellationEvent: { "id": "CancellationEvent", "version": "1.1.0", "props": ["title", "timestamp", "reason", "code", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Cancellation timestamp, reason and code are visible without initiating cancellation; an absent request remains an explicit empty state." },
+  CancellationEvent: { "id": "CancellationEvent", "version": "1.1.0", "props": ["title", "timestamp", "reason", "code", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Cancellation timestamp, reason and code are visible without initiating cancellation; with no request recorded the card renders nothing (s223-m01: an empty card is not content)." },
   CancellationForm: {
     id: "CancellationForm",
     version: COMPONENT_CONTRACT_VERSION,
@@ -15582,7 +16071,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["category is visible", "mode is the status metadata", "noninteractive badge"],
     compatibility: "Mirrors renderClassificationBadge over Badge: label/text/category/value precedence, status/state/mode precedence and classification variant. primaryCategoryField binds category; tagPreviewField is consumed unbound because the HTML badge reads no tag preview. Noninteractive."
   },
@@ -15627,10 +16116,29 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text", "badge.icon", "badge.color"],
+    tokenRoles: ["badge.background", "badge.text", "badge.icon", "badge.color"],
     accessibility: ["Inherits Badge inline noninteractive status label semantics", "A visible text label always accompanies the decorative color marker", "Color is never the sole status signal"],
     compatibility: "Mirrors renderColorizedBadge over renderBadgePrimitive label/status/color aliases and default variant colorized; Badge tone and emphasis retain their shared behavior."
   },
+  // s223-m02 (#2527 ruling 11): pick one value from a list by typing to filter it, the WAI-ARIA combobox pattern with a
+  // listbox popup. One markup in React, Vue and HTML; HTML's inline script gives it the same behaviour.
+  Combobox: {
+    id: "Combobox",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["id", "label"],
+    props: ["id", "label", "options", "value", "defaultValue", "placeholder", "name", "required", "disabled", "help", "validation", "size"],
+    slots: ["label", "help", "validation"],
+    events: ["change", "update"],
+    states: ["closed", "open", "no-matches", "selected", "disabled", "invalid"],
+    tokenRoles: ["input.background", "input.border", "input.text", "input.placeholder", "input.focus", "combobox.popup", "combobox.shadow", "combobox.option", "combobox.optionActive", "combobox.check", "field.message"],
+    accessibility: [
+      "An input with role combobox controls a listbox popup and reports aria-expanded, aria-autocomplete list and, while an option is active, aria-activedescendant; focus stays in the input",
+      "The visible label names the combobox and its listbox; help and error text describe the input",
+      "The chosen option reports aria-selected and shows a check mark; a disabled option reports aria-disabled and is skipped",
+      "Down opens the list and moves, Up moves, Home and End go to the ends, Enter picks the active option, Escape closes the list and then clears the field, and Tab closes the list without picking"
+    ],
+    compatibility: 'Typing filters the options to those whose label contains the typed text, ignoring case, and opens the list; when none matches the popup says No matches, which is not an option. value (controlled) or defaultValue (uncontrolled) names the chosen option, and the input shows its label. Picking an option (Enter on the active one, or a click) emits change and update with its value and closes the list; Escape with the list closed empties the input and, when an option was chosen, emits them with an empty value. An outside click or Tab closes the list without picking, and leaving the field restores the chosen label. size is the control height: xs 24, sm 28, md 32 (default) or lg 40, as Input, Select and Button. name submits the chosen value through a hidden input. The HTML renderer writes the same markup with the list closed and appends an inline script (data-oods-runtime="combobox") that gives it the same behaviour; without the script the input still shows the chosen label. One value only: no multiple selection, async loading, created values, grouped options or virtualization.'
+  },
   CommunicationDetailPanel: { "id": "CommunicationDetailPanel", "version": "1.1.0", "props": ["title", "channels", "templates", "policies", "conversations"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "A named read-only section renders declared channel, template, delivery policy and conversation entries. A polite status announces the conversation count; it performs no delivery or network operation." },
   CycleProgressCard: {
     id: "CycleProgressCard",
@@ -15666,6 +16174,18 @@ var authoredContracts = {
     accessibility: ["A real heading element follows as/level with default h2", "Subtitle and metadata remain visible beside the heading"],
     compatibility: "Mirrors renderDetailHeader title/subtitle/metadata aliases and headingTag(level, 2); saved-schema as selects a heading element, and authored default-slot content is preserved. Saved-schema titleField and subtitleField lower to title and subtitle, and an integer headingLevel lowers to level; none of the three is a public prop."
   },
+  Dialog: {
+    id: "Dialog",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["title"],
+    props: ["id", "open", "modal", "title", "description", "dismissLabel", "size", "actions"],
+    slots: ["default", "actions"],
+    events: ["close"],
+    states: ["open", "closed"],
+    tokenRoles: ["dialog.background", "dialog.border", "dialog.shadow", "dialog.backdrop", "dialog.title", "dialog.description"],
+    accessibility: ["A native dialog element named by its h2 title (aria-labelledby) and described by its description (aria-describedby)", "The close control is a ghost icon button named by dismissLabel (default Close)", "Escape and the close control emit close"],
+    compatibility: "The consumer owns open: the close control, Escape and a browser close request emit close, and the dialog stays open until open becomes false. modal (default true) opens it in the browser with showModal(), over a backdrop with the page behind it inert and not scrolling (the page's own overflow and padding come back exactly when it closes, by any route, or unmounts), and a click on the backdrop emits close; modal false shows it in place, which a gallery or a static page uses. Server-rendered and static HTML carry the open attribute while open, and on a static page an inline runtime script makes the close control close it. size sets the largest inline size: sm 400px, md 512px or lg 640px. The default slot is the body; the actions slot (or the actions prop) is the right-aligned footer, and the HTML renderer draws a string or { label, intent } list there as buttons."
+  },
   FilterPanel: {
     id: "FilterPanel",
     version: COMPONENT_CONTRACT_VERSION,
@@ -15776,7 +16296,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Inherits Badge inline noninteractive status label semantics", "The resolved label is always visible text"],
     compatibility: "Mirrors renderMessageStatusBadge over renderBadgePrimitive with default variant message and default label Message: the label reads label/text/status/delivery/value in that order, the status reads status/state/delivery/value, and both are exposed as data-badge-status and data-badge-variant on the governed Badge substrate; tone and emphasis retain their shared Badge behaviour. The saved-schema directive statusesField is consumed and left unbound: the HTML renderer reads no statuses collection."
   },
@@ -15787,20 +16307,20 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["owner identity is visible", "owner is the badge variant"],
     compatibility: "Mirrors renderOwnerBadge over renderBadgePrimitive: label/text/owner/ownerType/value precedence, status/state metadata, owner variant and Owner fallback. ownerIdField lowers to the unchanged owner and a display-only label from the declared reference label or honest unavailability; ownerTypeField lowers to ownerType. The badge is noninteractive; no ownership change is implied."
   },
   OwnershipMeta: {
     id: "OwnershipMeta",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "heading", "name", "ownerType", "owner_type", "role", "ownershipRole"],
+    props: ["title", "label", "heading", "name", "ownerType", "owner_type", "role", "ownershipRole", "ownerLabel"],
     slots: ["default"],
     events: [],
     states: ["populated", "empty"],
     tokenRoles: ["meta.text", "meta.label"],
     accessibility: ["metadata has inline term labels", "role is visible text not an ARIA role"],
-    compatibility: "Mirrors renderOwnershipMeta over renderMetaInline: title/label/heading/name (default Ownership), Owner Type ownerType/owner_type, Role role/ownershipRole. Each value is an inline span with a strong term and separator; children replace the entire body including its title. ownerTypeField and roleField lower to their consumed keys. role is displayed data, never an ARIA role. Noninteractive."
+    compatibility: 'Mirrors renderOwnershipMeta over renderMetaInline: title/label/heading/name (default Ownership), Owner Type ownerType/owner_type, Role role/ownershipRole. Each value is an inline span with a strong term and separator; children replace the entire body including its title. ownerTypeField and roleField lower to their consumed keys. s223-m01: given ownerLabel (ownerIdField binds the display label of the owner reference) the body is one phrase, "Owned by <label> \xB7 <type> \xB7 <role>", or "<Type>-owned" when the reference has no name. role is displayed data, never an ARIA role. Noninteractive.'
   },
   OwnershipSummary: {
     id: "OwnershipSummary",
@@ -15894,7 +16414,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Inherits Badge inline noninteractive status label semantics", "The resolved label is always visible text"],
     compatibility: "Mirrors renderPreferenceSummaryBadge over renderBadgePrimitive with default variant preference and default label Preferences: the label reads label/text/namespace/value in that order, the status reads status/state/version, and both are exposed as data-badge-status and data-badge-variant on the governed Badge substrate; tone and emphasis retain their shared Badge behaviour. versionField lowers to version; namespacesField is consumed and left unbound because the renderer reads a scalar namespace alias while the field is the preference_namespaces array."
   },
@@ -15928,7 +16448,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["priced", "missing-price"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Formatted amount and currency remain visible text"],
     compatibility: "Currency is formatted content; the emitted badge variant remains price."
   },
@@ -15996,7 +16516,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["populated", "fallback"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Each role is visible text inside one inline noninteractive group", "An empty list falls back to a visible label"],
     compatibility: "Mirrors renderRoleBadgeList: roles, then badges, roleLabels or value (records read label/name/role/value/id, scalars render as text) render one data-role-badge item each inside a span carrying data-badge-variant from variant, then tone, then roles; with no items the label, then text, then Roles is the visible fallback; authored children replace the list. rolesField lowers to roles and fallbackRoleParameter is consumed."
   },
@@ -16023,6 +16543,19 @@ var authoredContracts = {
     accessibility: ["Native search input semantics", "Clear control has an accessible label"],
     compatibility: "Debounce and minimum-query settings preserve value updates across both targets."
   },
+  // s223-m02 (#2527 ruling 10): one choice from two to five options, shown as joined segments.
+  SegmentedControl: {
+    id: "SegmentedControl",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["id", "label"],
+    props: ["id", "label", "options", "value", "defaultValue", "name", "size", "disabled"],
+    slots: ["label"],
+    events: ["change", "update"],
+    states: ["selected", "unselected", "disabled"],
+    tokenRoles: ["segmented.track", "segmented.selected", "segmented.ring", "segmented.text", "segmented.focus"],
+    accessibility: ["Native radio inputs in a radiogroup named by its visible label through aria-labelledby", "Each option is a radio inside its own label, so the option text names it", "The browser gives the radio-group keyboard: the arrows move and check, and Tab enters at the checked option"],
+    compatibility: "One choice from two to five options, each { value, label, disabled }, shown as joined segments in sizes xs, sm, md and lg: 24, 28, 32 and 40px, the button, input and select heights at each size. value (controlled) or defaultValue (uncontrolled) checks one option; with neither, none is checked and Tab enters at the first. name groups the radios and defaults to the id; disabled disables every option. Each change emits change and update with the chosen value. React, Vue and the HTML renderer write one markup, and the HTML needs no script: the native radios carry the keyboard. Icon-only segments and more than one selection are not part of it."
+  },
   Select: {
     id: "Select",
     version: COMPONENT_CONTRACT_VERSION_1_1,
@@ -16048,7 +16581,7 @@ var authoredContracts = {
     accessibility: ["Does not alter child semantics"],
     compatibility: "Maps saved-schema stack and inline modes to one flex primitive; patternComponent and fields are executed composition directives. Trait recipe directives authored on pattern-group Stacks are consumed by codegen: channelsField, templatesField, policiesField, conversationsField, labelField and showActor are left unbound (a layout container reads no data and the lowered StatusTimeline never governed them), while historyField and showReason travel with the lowering to the StatusTimeline whose contract governs them. Two more authoring leftovers are consumed unbound: the form composer leaves as on a Stack when it expands a heading title slot into several components, and a pattern-group Stack restates its first fields entry as a generic field; a layout container renders neither."
   },
-  StateTransitionEvent: { "id": "StateTransitionEvent", "version": "1.1.0", "props": ["title", "history", "status", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented." },
+  StateTransitionEvent: { "id": "StateTransitionEvent", "version": "1.1.0", "props": ["title", "history", "status", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented; with no history the card renders nothing (s223-m01)." },
   StatusBadge: {
     id: "StatusBadge",
     version: COMPONENT_CONTRACT_VERSION,
@@ -16069,7 +16602,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text", "badge.icon"],
+    tokenRoles: ["badge.background", "badge.text", "badge.icon"],
     accessibility: ["Status label is visible", "Color is not the sole status signal"],
     compatibility: "Both targets share the lifecycle status-to-tone table."
   },
@@ -16118,10 +16651,22 @@ var authoredContracts = {
     accessibility: ["Ordered status events retain chronological semantics", "Current state is named"],
     compatibility: "Configures the shared timeline primitive with status-transition semantics."
   },
+  Switch: {
+    id: "Switch",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["id", "label"],
+    props: ["id", "label", "checked", "defaultChecked", "required", "disabled", "help", "validation", "size"],
+    slots: ["label", "help", "validation"],
+    events: ["change", "update"],
+    states: ["off", "on", "disabled", "invalid"],
+    tokenRoles: ["switch.track", "switch.thumb", "switch.border", "switch.focus", "field.message"],
+    accessibility: ["A native button with role switch reports its state in aria-checked", "The visible label names the switch; help and error text describe it", "Space and Enter toggle it"],
+    compatibility: `Shares the Checkbox field API for a setting that applies at once: checked (controlled) or defaultChecked (uncontrolled), required, disabled, help and validation, in sizes sm and md. Each toggle emits change and update with the next checked value. The HTML renderer paints the same markup and an inline runtime script turns it over on a static page (aria-checked, from a click, Space or Enter); bound to a form field it also carries the field's value, "true" or "false", in a hidden input the script keeps. Bound to a record field in a generated form, it reads and writes the field's boolean as Checkbox does.`
+  },
   Table: {
     id: "Table",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["caption", "columns", "rows", "density", "selectable"],
+    props: ["caption", "showCaption", "columns", "rows", "density", "selectable"],
     slots: ["caption", "head", "body", "row", "headerCell", "cell"],
     events: ["rowActivate"],
     states: ["default", "compact", "selectable"],
@@ -16169,7 +16714,7 @@ var authoredContracts = {
     slots: ["default"],
     events: [],
     states: ["populated", "overflow", "empty"],
-    tokenRoles: ["badge.background", "badge.border", "badge.text"],
+    tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["Each visible tag is text inside one noninteractive group", "The overflow label is visible text"],
     compatibility: "Mirrors renderTagPills with data-summary-type=tag-pills: tags, then value (records read label/name/role/value/id, scalars render as text) render one data-tag-pill each up to maxVisible (a number or numeric string; default every tag); when tags remain, overflowLabel replaces {{ tag_count }} with the total tag count exactly as the HTML renderer does, or +N with the hidden count without a template; authored children replace the pills. The generic field lowers to tags; the saved-schema label is consumed and left unbound because the renderer never reads it."
   },
@@ -16223,35 +16768,35 @@ var authoredContracts = {
   VizAreaPreview: {
     id: "VizAreaPreview",
     version: COMPONENT_CONTRACT_VERSION_1_1,
-    props: ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"],
+    props: ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"],
     slots: ["default"],
     events: [],
     states: ["placeholder", "content"],
     tokenRoles: ["preview.frame", "preview.placeholder"],
     accessibility: ["The empty frame has a visible text placeholder", "Authored default-slot content preserves its own semantics", "Static SVG renders in a labelled figure with role img and preserves SVG IDs and ARIA", "A title the SVG does not paint is the figure heading (figcaption), so a placed chart names itself outside its pixels"],
-    compatibility: "Mirrors renderVizAreaPreview through renderVizPreview with data-viz-preview-type=area and default dimensions 640x360; the placeholder appears only without authored content. With svg, renders a labelled figure preserving static SVG IDs and ARIA; without svg, the placeholder remains unchanged. svgNarrow is the same chart at the narrow size: the figure shows it instead of svg when its own inline size is at most 600px (a container query), so axis text keeps its size on a phone column. svgWide is the same chart at the wide size: the figure shows it instead of svg when its own inline size is at least 900px, and a figure that carries it fills its column, so a detail chart spans a desktop screen at design scale."
+    compatibility: "Mirrors renderVizAreaPreview through renderVizPreview with data-viz-preview-type=area and default dimensions 640x360; the placeholder appears only without authored content. With svg, renders a labelled figure preserving static SVG IDs and ARIA; without svg, the placeholder remains unchanged. svgNarrow is the same chart at the narrow size: the figure shows it instead of svg when its own inline size is at most 600px (a container query), so axis text keeps its size on a phone column. svgWide is the same chart at the wide size: the figure shows it instead of svg when its own inline size is at least 900px, and a figure that carries it fills its column, so a detail chart spans a desktop screen at design scale. svgDark, svgDarkNarrow and svgDarkWide, and svgHc, svgHcNarrow and svgHcWide, are the same chart drawn in the dark and high-contrast themes: with any of them svg, svgNarrow and svgWide are the light renders, the renders of each theme sit in a data-viz-theme wrapper, and the figure shows the one matching the nearest data-theme."
   },
   VizAxisControls: { "id": "VizAxisControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Axis: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizAxisSummary: { "id": "VizAxisSummary", "version": "1.1.0", "props": ["title", "value", "channel"], "slots": [], "events": [], "states": ["unbound", "bound"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text renders the authored input fragment without implying an executed chart."], "compatibility": "Read-only recipe renders the same Cartesian viz.render input fragment. Missing bindings remain disclosed; renderer defaults are not fabricated as authored values." },
   VizColorControls: { "id": "VizColorControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Color encoding: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizColorLegendConfig: { "id": "VizColorLegendConfig", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Color legend: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizEncodingBadge: { "id": "VizEncodingBadge", "version": "1.1.0", "props": ["title", "value", "channel"], "slots": [], "events": [], "states": ["unbound", "bound"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text renders the authored input fragment without implying an executed chart."], "compatibility": "Read-only recipe renders the same Cartesian viz.render input fragment. Missing bindings remain disclosed; renderer defaults are not fabricated as authored values." },
-  VizGraphPreview: { "id": "VizGraphPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizGraphPreview uses the existing force_graph renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizGraphPreview: { "id": "VizGraphPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizGraphPreview uses the existing force_graph renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizHeatmapControls: { "id": "VizHeatmapControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Heatmap: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
-  VizHeatmapPreview: { "id": "VizHeatmapPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizHeatmapPreview uses the existing heatmap renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizHeatmapPreview: { "id": "VizHeatmapPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizHeatmapPreview uses the existing heatmap renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizLineControls: { "id": "VizLineControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Line chart: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
-  VizLinePreview: { "id": "VizLinePreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizLinePreview uses the existing line renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizLinePreview: { "id": "VizLinePreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizLinePreview uses the existing line renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizMarkControls: { "id": "VizMarkControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Chart mark: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
-  VizMarkPreview: { "id": "VizMarkPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizMarkPreview uses the existing bar renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizMarkPreview: { "id": "VizMarkPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizMarkPreview uses the existing bar renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizOpacityControls: { "id": "VizOpacityControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Mark opacity: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizOpacitySummary: { "id": "VizOpacitySummary", "version": "1.1.0", "props": ["title", "value", "channel"], "slots": [], "events": [], "states": ["unbound", "bound"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text renders the authored input fragment without implying an executed chart."], "compatibility": "Read-only recipe renders the same Cartesian viz.render input fragment. Missing bindings remain disclosed; renderer defaults are not fabricated as authored values." },
   VizPointControls: { "id": "VizPointControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Point chart: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
-  VizPointPreview: { "id": "VizPointPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizPointPreview uses the existing scatter renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizPointPreview: { "id": "VizPointPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizPointPreview uses the existing scatter renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizRoleBadge: { "id": "VizRoleBadge", "version": "1.1.0", "props": ["title", "value", "channel"], "slots": [], "events": [], "states": ["unbound", "bound"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text renders the authored input fragment without implying an executed chart."], "compatibility": "Read-only recipe renders the same Cartesian viz.render input fragment. Missing bindings remain disclosed; renderer defaults are not fabricated as authored values." },
   VizScaleControls: { "id": "VizScaleControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Scale: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizScaleSummary: { "id": "VizScaleSummary", "version": "1.1.0", "props": ["title", "value", "channel"], "slots": [], "events": [], "states": ["unbound", "bound"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text renders the authored input fragment without implying an executed chart."], "compatibility": "Read-only recipe renders the same Cartesian viz.render input fragment. Missing bindings remain disclosed; renderer defaults are not fabricated as authored values." },
   VizScatterControls: { "id": "VizScatterControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Scatter chart: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
-  VizScatterPreview: { "id": "VizScatterPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizScatterPreview uses the existing scatter renderer; this is no new chart family. No pixels are invented when svg is absent." },
+  VizScatterPreview: { "id": "VizScatterPreview", "version": "1.1.0", "props": ["svg", "svgNarrow", "svgWide", "svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide", "title", "description", "width", "height"], "slots": ["default"], "events": [], "states": ["unbound", "rendered"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Static shared-renderer SVG is preserved inside a named image figure; absence is explicitly disclosed."], "compatibility": "Recipe over VizAreaPreview's static SVG mechanism. VizScatterPreview uses the existing scatter renderer; this is no new chart family. No pixels are invented when svg is absent." },
   VizShapeControls: { "id": "VizShapeControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Shape encoding: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizShapeLegend: { "id": "VizShapeLegend", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Shape legend: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
   VizSizeControls: { "id": "VizSizeControls", "version": "1.1.0", "props": ["title", "value", "channel", "disabled"], "slots": [], "events": ["change"], "states": ["bound", "editing", "invalid", "disabled"], "tokenRoles": ["input.background", "input.border", "input.text", "input.focus", "field.message"], "accessibility": ["Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment."], "compatibility": "Size encoding: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component." },
@@ -16335,7 +16880,7 @@ var viz_preview_samples_v1_default = {
       input: {
         name: "Example connected relationships",
         description: "Synthetic neighborhood edges illustrating relationships that share an endpoint; these are examples, not live graph data."},
-      svg: '<svg width="360" height="200" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" baseProfile="full" viewBox="0 0 360 200" role="img" aria-label="Example connected relationships" aria-description="Synthetic neighborhood edges illustrating relationships that share an endpoint; these are examples, not live graph data."><title>Example connected relationships</title><desc>Synthetic neighborhood edges illustrating relationships that share an endpoint; these are examples, not live graph data.</desc>\n<rect width="360" height="200" x="0" y="0" fill="#F9FAFC"></rect>\n<path d="M208.4 34Q249.7 88.3 221.2 150.3" fill="none" pointer-events="visible" stroke="rgb(88, 9, 24)" stroke-opacity="0.5" ecmeta_series_index="0" ecmeta_data_index="0" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M221.2 150.3Q155.5 166.3 110.4 115.8" fill="none" pointer-events="visible" stroke="rgb(88, 9, 24)" stroke-opacity="0.5" ecmeta_series_index="0" ecmeta_data_index="1" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M110.4 115.8Q176.1 99.8 221.2 150.3" fill="none" pointer-events="visible" stroke="rgb(88, 9, 24)" stroke-opacity="0.5" ecmeta_series_index="0" ecmeta_data_index="2" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,110.3635,115.779)" fill="rgb(88, 9, 24)" ecmeta_series_index="0" ecmeta_data_index="0" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,221.2255,150.2583)" fill="rgb(88, 9, 24)" ecmeta_series_index="0" ecmeta_data_index="1" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,208.3976,33.9582)" fill="rgb(88, 9, 24)" ecmeta_series_index="0" ecmeta_data_index="2" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(120.3635 115.779)" fill="#1A1D23">example-document</text>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(231.2255 150.2583)" fill="#1A1D23">example-project</text>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(218.3976 33.9582)" fill="#1A1D23">example-team</text>\n<path d="M-108.1 -5l216.2 0l0 24l-216.2 0Z" transform="translate(180 13)" fill="rgb(0,0,0)" fill-opacity="0" stroke="#3c3c41" stroke-width="0" class="oods-zr-2"></path>\n<text dominant-baseline="central" text-anchor="middle" style="font-size:14px;font-family:sans-serif;font-weight:600;" xml:space="preserve" y="7" transform="translate(180 13)" fill="#1A1D23">Example connected relationships</text>\n<style ><![CDATA[\n.oods-zr-0:hover {\ncursor:pointer;\nstroke-width:4;\n}\n.oods-zr-1:hover {\ncursor:pointer;\nfill:rgba(96,9,26,1);\n}\n.oods-zr-2:hover {\npointer-events:none;\n}\n\n]]>\n\n</style>\n</svg>'}
+      svg: '<svg width="360" height="200" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" baseProfile="full" viewBox="0 0 360 200" role="img" aria-label="Example connected relationships" aria-description="Synthetic neighborhood edges illustrating relationships that share an endpoint; these are examples, not live graph data."><title>Example connected relationships</title><desc>Synthetic neighborhood edges illustrating relationships that share an endpoint; these are examples, not live graph data.</desc>\n<rect width="360" height="200" x="0" y="0" fill="#FFFFFF"></rect>\n<path d="M239.2 59.3Q245.2 127.2 188.1 164.5" fill="none" pointer-events="visible" stroke="rgb(62, 99, 221)" stroke-opacity="0.75" ecmeta_series_index="0" ecmeta_data_index="0" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M188.1 164.5Q123.9 143 112.7 76.2" fill="none" pointer-events="visible" stroke="rgb(62, 99, 221)" stroke-opacity="0.75" ecmeta_series_index="0" ecmeta_data_index="1" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M112.7 76.2Q176.9 97.7 188.1 164.5" fill="none" pointer-events="visible" stroke="rgb(62, 99, 221)" stroke-opacity="0.75" ecmeta_series_index="0" ecmeta_data_index="2" ecmeta_ssr_type="chart" class="oods-zr-0"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,112.6711,76.2258)" fill="rgb(62, 99, 221)" ecmeta_series_index="0" ecmeta_data_index="0" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,188.0808,164.5013)" fill="rgb(62, 99, 221)" ecmeta_series_index="0" ecmeta_data_index="1" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<path d="M1 0A1 1 0 1 1 1 -0.1A1 1 0 0 1 1 0" transform="matrix(5,0,0,5,239.241,59.2736)" fill="rgb(62, 99, 221)" ecmeta_series_index="0" ecmeta_data_index="2" ecmeta_ssr_type="chart" class="oods-zr-1"></path>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(122.6711 76.2258)" fill="#0A0A0A">example-document</text>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(198.0808 164.5013)" fill="#0A0A0A">example-project</text>\n<text dominant-baseline="central" text-anchor="start" style="font-size:12px;font-family:sans-serif;" transform="translate(249.241 59.2736)" fill="#0A0A0A">example-team</text>\n<path d="M-108.1 -5l216.2 0l0 24l-216.2 0Z" transform="translate(180 13)" fill="rgb(0,0,0)" fill-opacity="0" stroke="#3c3c41" stroke-width="0" class="oods-zr-2"></path>\n<text dominant-baseline="central" text-anchor="middle" style="font-size:14px;font-family:sans-serif;font-weight:600;" xml:space="preserve" y="7" transform="translate(180 13)" fill="#0A0A0A">Example connected relationships</text>\n<style ><![CDATA[\n.oods-zr-0:hover {\ncursor:pointer;\nstroke-width:4;\n}\n.oods-zr-1:hover {\ncursor:pointer;\nfill:rgba(68,108,243,1);\n}\n.oods-zr-2:hover {\npointer-events:none;\n}\n\n]]>\n\n</style>\n</svg>'}
   }
 };
 
@@ -16368,7 +16913,7 @@ var authoredScenarios = [
   { "id": "VizSizeControls", "oodsComponentId": "VizSizeControls", "props": { "value": { "encodings": { "size": { "field": "size", "scale": "linear" } } } }, "slots": {}, "initialState": { "encodings": { "size": { "field": "size", "scale": "linear" } } }, "renderExpectation": { "name": "change", "trigger": "append x to the first field", "expected": '{"encodings":{"size":{"field":"sizex","scale":"linear"}}}' }, "assertions": ["emitted payload is a typed public input fragment", "untouched sibling bindings are preserved", "labels name native controls"] },
   { "id": "VizSizeSummary", "oodsComponentId": "VizSizeSummary", "props": { "value": { "encodings": { "size": { "field": "size", "scale": "linear" } } } }, "slots": {}, "initialState": { "authored": true }, "renderExpectation": { "name": "render", "trigger": "mount the authored fragment or shared-renderer SVG", "expected": '{"encodings":{"size":{"field":"size","scale":"linear"}}}' }, "assertions": ["authored binding values remain readable", "no interactive chart action is implied"] },
   { "id": "ArchiveEvent", "oodsComponentId": "ArchiveEvent", "props": { "archivedAt": "2026-09-01T12:00:00Z", "restoredAt": "2026-09-02T12:00:00Z", "archivedBy": "operator-1", "reason": "Duplicate record" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
-  { "id": "CancellationEvent", "oodsComponentId": "CancellationEvent", "props": { "timestamp": "2026-09-01T12:00:00Z", "reason": "Customer request", "code": "customer_request" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Cancellation timestamp, reason and code are visible without initiating cancellation; an absent request remains an explicit empty state." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
+  { "id": "CancellationEvent", "oodsComponentId": "CancellationEvent", "props": { "timestamp": "2026-09-01T12:00:00Z", "reason": "Customer request", "code": "customer_request" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Cancellation timestamp, reason and code are visible without initiating cancellation; with no request recorded the card renders nothing." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
   { "id": "StateTransitionEvent", "oodsComponentId": "StateTransitionEvent", "props": { "history": [{ "from_state": "draft", "to_state": "active", "transitioned_at": "2026-09-01T12:00:00Z", "actor_id": "operator-1", "reason": "Approved" }] }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
   { "id": "ColorStatePicker", "oodsComponentId": "ColorStatePicker", "props": { "colorStates": ["neutral", "success"], "value": "neutral" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "A labelled Select inside a fieldset edits only declared semantic color states and emits one string change; prop changes resynchronise local selection." }, "assertions": ["Visible text explains the declared trait values", "Every native control has a visible label"] },
   { "id": "StatusColorLegend", "oodsComponentId": "StatusColorLegend", "props": { "colorStates": ["neutral", "success"], "value": "success", "showTokenReferences": true }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "A named section pairs semantic color swatches with visible state names, the current state and optional token references. Meaning is never color alone." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
@@ -16383,7 +16928,7 @@ var authoredScenarios = [
   { id: "address-editor-fields-and-change", oodsComponentId: "AddressEditor", props: { title: "Shipping address", street: "1 Main St", city: "Springfield", region: "IL", postalCode: "62701" }, slots: {}, initialState: { street: "1 Main St" }, renderExpectation: { name: "change", trigger: "type into the City input", expected: "change emitted with the current street/city/region/postalCode record" }, assertions: ["title is a real h2 heading", "four labelled inputs are prefilled", "change carries the whole address record", "submitting is a no-op"] },
   { id: "address-summary-badge-role", oodsComponentId: "AddressSummaryBadge", props: { label: "Billing address", role: "billing" }, slots: {}, initialState: { status: "billing" }, renderExpectation: { name: "render", trigger: "mount", expected: "visible Billing address label with data-badge-status billing and the address variant" }, assertions: ["label is visible text", "data-badge-status is billing", "data-badge-variant is address", "badge is noninteractive"] },
   { id: "address-validation-timeline-events", oodsComponentId: "AddressValidationTimeline", props: { title: "Address checks", validations: [{ label: "Postal code verified", timestamp: "2026-09-05T12:00:00Z", detail: "Matched carrier database" }, "Geocoded"] }, slots: {}, initialState: { events: 2 }, renderExpectation: { name: "render", trigger: "mount", expected: "a log region titled Address checks with two ordered events, the first timestamped and detailed" }, assertions: ["region has role log and an h2 title", "events are ordered list items", "the timestamp is a time element", "scalar entries render as text"] },
-  { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant"] },
+  { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Archived" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant", "hideWhenFalse hides only the default"] },
   { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms"] },
   { id: "archived-row-presentation", oodsComponentId: "ArchivedRowOverlay", props: { "isArchived": true, "showBadge": true, "separateTab": true, "tabLabel": "Archived", "label": "Team subscription" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "Archived row stays accessible and its badge and tab label agree" }, assertions: ["Archived row stays accessible and its badge and tab label agree"] },
   { id: "audit-event-type-and-timestamp", oodsComponentId: "AuditEvent", props: { event: "user.updated", timestamp: "2026-09-05T12:00:00Z", detail: "Display name changed" }, slots: {}, initialState: { timestamped: true }, renderExpectation: { name: "render", trigger: "mount", expected: "one audit article with a machine-readable time, the event label and the detail" }, assertions: ["article carries data-event-type audit", "time element has a datetime", "label and detail are visible text"] },
@@ -16403,7 +16948,7 @@ var authoredScenarios = [
   { id: "billing-interval-subscription", oodsComponentId: "BillingIntervalSelector", props: { interval: "monthly", intervals: ["monthly", "yearly"], label: "Billing interval" }, slots: {}, initialState: { interval: "monthly" }, renderExpectation: { name: "change", trigger: "ArrowDown from monthly", expected: "yearly selected and emitted" }, assertions: ["only the resolved object intervals are selectable", "a native select supports keyboard selection", "invalid interval is announced"] },
   { id: "billing-summary-minor-units", oodsComponentId: "BillingSummaryBadge", props: { amount: 1999, currency: "usd", minorUnits: 100, interval: "monthly" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "$19.99 \xB7 monthly" }, assertions: ["integer minor units format as a currency amount", "one visible phrase includes interval"] },
   { id: "button-activate", oodsComponentId: "Button", props: { content: "Save changes", intent: "neutral", size: "md" }, slots: { default: "Save changes" }, initialState: { disabled: false }, renderExpectation: { name: "activate", trigger: "pointer click or Enter", expected: "activation handler called once" }, assertions: ["native type defaults to button", "focus is visible"] },
-  { id: "cancellation-badge-false", oodsComponentId: "CancellationBadge", props: { "cancelAtPeriodEnd": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No cancellation scheduled remains visible; machine status remains false; cancellation is the badge variant" }, assertions: ["No cancellation scheduled remains visible; machine status remains false", "cancellation is the badge variant"] },
+  { id: "cancellation-badge-false", oodsComponentId: "CancellationBadge", props: { "cancelAtPeriodEnd": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No cancellation scheduled remains visible; machine status remains false; cancellation is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Cancellation scheduled" }, assertions: ["No cancellation scheduled remains visible; machine status remains false", "cancellation is the badge variant", "hideWhenFalse hides only the default"] },
   { id: "cancellation-form-presentational-controls", oodsComponentId: "CancellationForm", props: { "title": "Cancellation request", "reasonCode": "budget", "reason": "Costs changed" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "reason and code retain their initial values; native controls are labelled; submit does not cancel or save" }, assertions: ["reason and code retain their initial values", "native controls are labelled", "submit does not cancel or save"] },
   {
     id: "cancellation-summary-boolean",
@@ -16417,6 +16962,12 @@ var authoredScenarios = [
   { id: "card-elevated-content", oodsComponentId: "Card", props: { elevated: true }, slots: { default: "Account summary" }, initialState: { elevated: true }, renderExpectation: { name: "render", trigger: "mount", expected: "semantic container with visible content" }, assertions: ["content is not empty", "elevated state is exposed"] },
   { id: "card-header-supporting-text", oodsComponentId: "CardHeader", props: { title: "Account summary", supportingText: "Current subscription" }, slots: {}, initialState: { heading: "h2" }, renderExpectation: { name: "render", trigger: "mount", expected: "h2 heading and visible supporting text" }, assertions: ["title is a real h2 heading", "supporting text is visible"] },
   { id: "checkbox-controlled", oodsComponentId: "Checkbox", props: { id: "marketing", label: "Product updates", checked: false, required: true, help: "Choose whether to subscribe" }, slots: {}, initialState: { checked: false }, renderExpectation: { name: "change", trigger: "click checkbox", expected: "checked=true emitted once" }, assertions: ["label targets input", "help describes input"] },
+  // s222-m02 (#2502 ruling 11): the two components 0.4.0 adds. The dialog example is shown in place (modal false), as a
+  // gallery shows it; modal true is the default.
+  { id: "dialog-confirm", oodsComponentId: "Dialog", props: { id: "archive-workspace", open: true, modal: false, title: "Archive workspace", description: "Members lose access until the workspace is restored.", size: "sm" }, slots: { default: "Invoices and subscriptions stay in the archive for 30 days.", actions: ["Cancel", "Archive workspace"] }, initialState: { open: true }, renderExpectation: { name: "close", trigger: "activate the close button or press Escape", expected: "close emitted once; the dialog stays open until open becomes false" }, assertions: ["the dialog is named by its title and described by its description", "the close button is named", "the actions sit in the footer"] },
+  // s223-m02 (#2527 ruling 11): the combobox example; Japan is disabled, so the keyboard skips it and a click cannot pick it.
+  { id: "combobox-filter-and-pick", oodsComponentId: "Combobox", props: { id: "shipping-country", label: "Shipping country", value: "ca", placeholder: "Search countries", help: "Type to filter. We do not ship to Japan yet.", options: [{ value: "au", label: "Australia" }, { value: "ca", label: "Canada" }, { value: "fr", label: "France" }, { value: "de", label: "Germany" }, { value: "jp", label: "Japan", disabled: true }, { value: "mx", label: "Mexico" }, { value: "gb", label: "United Kingdom" }, { value: "us", label: "United States" }] }, slots: {}, initialState: { open: false, value: "ca" }, renderExpectation: { name: "change", trigger: "type to filter, then Down and Enter, or click an option", expected: "the picked value emitted once and the list closed" }, assertions: ["role combobox controls its listbox and reports aria-expanded", "the label names the combobox and the listbox; help describes the input", "typing filters by label and an empty result says No matches", "the chosen option reports aria-selected and shows a check mark"] },
+  { id: "switch-controlled", oodsComponentId: "Switch", props: { id: "payment-alerts", label: "Payment alerts", checked: false, help: "Email the account owner when a payment fails" }, slots: {}, initialState: { checked: false }, renderExpectation: { name: "change", trigger: "click the switch or press Space or Enter", expected: "checked=true emitted once" }, assertions: ["role switch reports aria-checked", "the label names the switch", "help describes the switch"] },
   { id: "classification-badge-category", oodsComponentId: "ClassificationBadge", props: { "category": "Electronics", "mode": "strict" }, slots: {}, initialState: { "content": "populated" }, renderExpectation: { "name": "render", "trigger": "mount", "expected": "category is visible; mode is the status metadata; noninteractive badge" }, assertions: ["category is visible", "mode is the status metadata", "noninteractive badge"] },
   { id: "classification-editor-presentational-controls", oodsComponentId: "ClassificationEditor", props: { "title": "Product classification", "category": "Electronics", "tags": ["alpha", "beta"], "mode": "flexible" }, slots: {}, initialState: { "content": "populated" }, renderExpectation: { "name": "render", "trigger": "mount", "expected": "labelled native inputs retain their values; mode selection is flexible; submit does not navigate or save" }, assertions: ["labelled native inputs retain their values", "mode selection is flexible", "submit does not navigate or save"] },
   { id: "classification-panel-title-and-summary", oodsComponentId: "ClassificationPanel", props: { title: "Classification", subtitle: "Taxonomy and tags", summary: "Electronics > Mobile > Android" }, slots: {}, initialState: { content: "summary" }, renderExpectation: { name: "render", trigger: "mount without authored children", expected: "h2 heading, visible subtitle and the summary text inside the content area" }, assertions: ["title is a real h2 heading", "data-panel-type is classification", "summary text is visible", "panel is noninteractive"] },
@@ -16436,7 +16987,7 @@ var authoredScenarios = [
   { id: "message-event-timeline-statuses", oodsComponentId: "MessageEventTimeline", props: { heading: "Delivery", statuses: [{ status: "delivered", at: "2026-09-02T09:00:00Z" }] }, slots: {}, initialState: { events: 1 }, renderExpectation: { name: "render", trigger: "mount with statuses only", expected: "statuses supply the events when messages are absent, in the message timeline type" }, assertions: ["region has role log and an h2 title", "status doubles as the event label", "data-timeline-type is message"] },
   { id: "message-status-badge-delivery", oodsComponentId: "MessageStatusBadge", props: { delivery: "delivered" }, slots: {}, initialState: { status: "delivered" }, renderExpectation: { name: "render", trigger: "mount", expected: "delivery doubles as the visible label and the status in the message variant" }, assertions: ["label is visible text", "data-badge-status is delivered", "data-badge-variant is message", "badge is noninteractive"] },
   { id: "owner-badge-principal", oodsComponentId: "OwnerBadge", props: { "owner": "user-7", "ownerType": "person", "status": "active" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "owner identity is visible; owner is the badge variant" }, assertions: ["owner identity is visible", "owner is the badge variant"] },
-  { id: "ownership-meta-inline-terms", oodsComponentId: "OwnershipMeta", props: { "ownerType": "organization", "role": "custodian" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "metadata has inline term labels; role is visible text not an ARIA role" }, assertions: ["metadata has inline term labels", "role is visible text not an ARIA role"] },
+  { id: "ownership-meta-inline-terms", oodsComponentId: "OwnershipMeta", props: { "ownerType": "organization", "role": "custodian" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "metadata has inline term labels; role is visible text not an ARIA role; given ownerLabel one phrase names the owner" }, assertions: ["metadata has inline term labels", "role is visible text not an ARIA role", "ownerLabel reads as one phrase"] },
   { id: "ownership-summary-terms", oodsComponentId: "OwnershipSummary", props: { "ownerId": "user-7", "ownerType": "person", "role": "administrator" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "a real h2 names the description list; owner label or honest unavailability, type and role remain associated terms" }, assertions: ["a real h2 names the description list", "owner label or honest unavailability, type and role remain associated terms"] },
   {
     id: "pagination-bar-navigation",
@@ -16484,6 +17035,9 @@ var authoredScenarios = [
     renderExpectation: { name: "clear", trigger: "activate clear control", expected: "empty value emitted once" },
     assertions: ["input has search semantics", "clear control is named"]
   },
+  // s223-m02 (#2527 ruling 10): the middle option is checked, so Tab landing on it shows the group's one tab stop is the
+  // checked option, and both arrow directions have a neighbour.
+  { id: "segmented-control-billing-period", oodsComponentId: "SegmentedControl", props: { id: "billing-period", label: "Billing period", value: "quarterly", options: [{ value: "monthly", label: "Monthly" }, { value: "quarterly", label: "Quarterly" }, { value: "yearly", label: "Yearly" }] }, slots: {}, initialState: { value: "quarterly" }, renderExpectation: { name: "change", trigger: "ArrowRight or ArrowLeft from Quarterly, or click Yearly", expected: "the neighbouring value emitted once; the consumer owns value" }, assertions: ["the radiogroup is named by its visible label", "each option is a native radio named by its own label", "the checked option is the value and is the one tab stop"] },
   { id: "select-controlled", oodsComponentId: "Select", props: { id: "plan", label: "Plan", value: "pro", options: [{ value: "basic", label: "Basic" }, { value: "pro", label: "Pro" }] }, slots: {}, initialState: { value: "pro" }, renderExpectation: { name: "change", trigger: "choose Basic", expected: "basic emitted once" }, assertions: ["label targets select", "selected option is visible"] },
   { id: "stack-wrapped-row", oodsComponentId: "Stack", props: { direction: "row", gap: "sm", align: "center", wrap: true }, slots: { default: ["Primary", "Secondary"] }, initialState: { direction: "row", wrap: true }, renderExpectation: { name: "render", trigger: "resize to phone width", expected: "children wrap in DOM order" }, assertions: ["two children remain visible", "gap token is used"] },
   {
@@ -16525,6 +17079,18 @@ var sharedScenarios = [...authoredScenarios].sort((a, b) => a.oodsComponentId <
     event: behavior.event
   };
 });
+var relativeTimestampEmptyScenario = {
+  id: "relative-timestamp-empty",
+  oodsComponentId: "RelativeTimestamp",
+  props: { datetime: "" },
+  slots: {},
+  initialState: { content: "empty" },
+  renderExpectation: { name: "render", trigger: "mount with an empty datetime", expected: "Unknown time is visible and no datetime attribute is emitted" },
+  assertions: ["an empty value reads Unknown time", "an empty datetime is omitted, never emitted empty"],
+  interaction: componentBehaviors.RelativeTimestamp.interaction,
+  interactionReason: componentBehaviors.RelativeTimestamp.interactionReason,
+  event: componentBehaviors.RelativeTimestamp.event
+};
 
 // src/ported-contracts.ts
 var portedComponentContracts = Object.fromEntries(
@@ -16581,6 +17147,454 @@ var RESULT_STATES = ["violation", "passed", "needs_review", "not_applicable", "n
 var RESULT_STATE_TONE = "neutral";
 var SEVERITY_TONES = ["positive", "success", "warning", "critical", "danger"];
 
+// src/status-icons.ts
+var path = (d) => ({ tag: "path", attrs: { d } });
+var circle = (cx, cy, r, filled = false) => ({
+  tag: "circle",
+  attrs: filled ? { cx, cy, r, fill: "currentColor", stroke: "none" } : { cx, cy, r }
+});
+var STATUS_ICON_SHAPES = Object.freeze({
+  check: [path("M3.5 8.5l3 3 6-7")],
+  x: [path("M4.5 4.5l7 7M11.5 4.5l-7 7")],
+  alert: [path("M8 2.5l6 11H2z"), path("M8 6.5v3"), circle("8", "11.5", "0.75", true)],
+  info: [circle("8", "8", "6"), path("M8 7.5V11"), circle("8", "5", "0.75", true)],
+  clock: [circle("8", "8", "6"), path("M8 5v3l2 1.5")],
+  dots: [circle("4", "8", "1", true), circle("8", "8", "1", true), circle("12", "8", "1", true)],
+  refresh: [path("M13 8a5 5 0 1 1-1.5-3.5"), path("M13 2.5v3h-3")],
+  pause: [path("M6 4v8M10 4v8")],
+  ban: [circle("8", "8", "6"), path("M3.8 12.2l8.4-8.4")],
+  pencil: [path("M10.5 3L13 5.5 6 12.5H3.5V10z")],
+  star: [path("M8 2.5l1.7 3.5 3.8.5-2.8 2.6.7 3.8L8 11.1l-3.4 1.8.7-3.8-2.8-2.6 3.8-.5z")],
+  undo: [path("M3 8a5 5 0 1 0 1.5-3.5"), path("M3 2.5v3h3")],
+  lock: [{ tag: "rect", attrs: { x: "3.5", y: "7", width: "9", height: "6.5", rx: "1.5" } }, path("M5.5 7V5a2.5 2.5 0 0 1 5 0v2")],
+  unlock: [{ tag: "rect", attrs: { x: "3.5", y: "7", width: "9", height: "6.5", rx: "1.5" } }, path("M5.5 7V5a2.5 2.5 0 0 1 4.8-1")],
+  dot: [circle("8", "8", "2.5", true)],
+  "chevron-down": [path("M4 6l4 4 4-4")]
+});
+var STATUS_ICON_SVG_ATTRS = Object.freeze({
+  width: "1em",
+  height: "1em",
+  viewBox: "0 0 16 16",
+  fill: "none",
+  stroke: "currentColor",
+  "stroke-width": "1.5",
+  "stroke-linecap": "round",
+  "stroke-linejoin": "round",
+  "aria-hidden": "true",
+  focusable: "false"
+});
+var STATUS_ICON_ALIASES = Object.freeze({
+  success: "check",
+  paid: "check",
+  warning: "alert",
+  critical: "x",
+  danger: "x",
+  error: "x",
+  negative: "x",
+  pending: "dots",
+  processing: "refresh",
+  paused: "pause",
+  canceled: "ban",
+  cancelled: "ban",
+  void: "ban",
+  draft: "pencil",
+  info: "info",
+  trial: "star",
+  future: "clock",
+  scheduled: "clock",
+  refunded: "undo",
+  locked: "lock",
+  unlocked: "unlock",
+  default: "dot"
+});
+function resolveStatusIcon(iconName) {
+  const segment = iconName?.split(".").pop()?.toLowerCase();
+  if (!segment) return void 0;
+  return STATUS_ICON_ALIASES[segment] ?? "dot";
+}
+var escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+var attributes = (attrs) => Object.entries(attrs).map(([name, value]) => ` ${name}="${escapeAttribute(value)}"`).join("");
+function statusIconMarkup(name) {
+  const shapes = STATUS_ICON_SHAPES[name].map((shape) => `<${shape.tag}${attributes(shape.attrs)}></${shape.tag}>`).join("");
+  return `<svg${attributes(STATUS_ICON_SVG_ATTRS)}>${shapes}</svg>`;
+}
+
+// registry/status-map.json
+var status_map_default = {
+  domains: {
+    subscription: {
+      future: {
+        description: "Subscription is scheduled but not yet active.",
+        chip: {
+          foreground: "color.text.info",
+          background: "color.background.info.subtle",
+          border: "color.border.info",
+          icon: "icon.status.scheduled"
+        },
+        banner: {
+          foreground: "color.text.info",
+          background: "color.background.surface.default",
+          border: "color.border.info",
+          icon: "icon.status.scheduled"
+        }
+      },
+      trialing: {
+        description: "Subscription is in a trial period before billing begins.",
+        chip: {
+          foreground: "color.text.accent",
+          background: "color.background.accent.subtle",
+          border: "color.border.accent",
+          icon: "icon.status.trial"
+        },
+        banner: {
+          foreground: "color.text.accent",
+          background: "color.background.surface.default",
+          border: "color.border.accent",
+          icon: "icon.status.trial"
+        }
+      },
+      active: {
+        description: "Subscription is paid and service is provisioned.",
+        chip: {
+          foreground: "color.text.positive",
+          background: "color.background.positive.subtle",
+          border: "color.border.positive",
+          icon: "icon.status.success"
+        },
+        banner: {
+          foreground: "color.text.positive",
+          background: "color.background.surface.default",
+          border: "color.border.positive",
+          icon: "icon.status.success"
+        }
+      },
+      paused: {
+        description: "Billing paused temporarily by finance or customer request.",
+        chip: {
+          foreground: "color.text.neutral",
+          background: "color.background.neutral.subtle",
+          border: "color.border.neutral",
+          icon: "icon.status.paused"
+        },
+        banner: {
+          foreground: "color.text.neutral",
+          background: "color.background.surface.muted",
+          border: "color.border.neutral",
+          icon: "icon.status.paused"
+        }
+      },
+      pending_cancellation: {
+        description: "Subscription will cancel at period end but remains active now.",
+        chip: {
+          foreground: "color.text.info",
+          background: "color.background.info.subtle",
+          border: "color.border.info",
+          icon: "icon.status.pending"
+        },
+        banner: {
+          foreground: "color.text.info",
+          background: "color.background.surface.default",
+          border: "color.border.info",
+          icon: "icon.status.pending"
+        }
+      },
+      past_due: {
+        description: "Renewal payment failed; smart retries ongoing and access retained during the grace window.",
+        chip: {
+          foreground: "color.text.danger",
+          background: "color.background.danger.subtle",
+          border: "color.border.danger",
+          icon: "icon.status.warning"
+        },
+        banner: {
+          foreground: "color.text.onbold",
+          background: "color.background.danger.bold",
+          border: "color.border.danger",
+          icon: "icon.status.warning"
+        }
+      },
+      unpaid: {
+        description: "Payment retries exhausted; service access revoked.",
+        chip: {
+          foreground: "color.text.danger",
+          background: "color.background.danger.subtle",
+          border: "color.border.danger",
+          icon: "icon.status.error"
+        },
+        banner: {
+          foreground: "color.text.onbold",
+          background: "color.background.danger.bold",
+          border: "color.border.danger",
+          icon: "icon.status.error"
+        }
+      },
+      terminated: {
+        description: "Subscription ended; service access revoked and billing stopped.",
+        chip: {
+          foreground: "color.text.disabled",
+          background: "color.background.disabled",
+          border: "color.border.disabled",
+          icon: "icon.status.canceled"
+        },
+        banner: {
+          foreground: "color.text.neutral",
+          background: "color.background.neutral.subtle",
+          border: "color.border.neutral",
+          icon: "icon.status.canceled"
+        }
+      }
+    },
+    invoice: {
+      draft: {
+        description: "Invoice is editable and not yet finalized.",
+        chip: {
+          foreground: "color.text.neutral",
+          background: "color.background.neutral.subtle",
+          border: "color.border.neutral",
+          icon: "icon.status.draft"
+        },
+        banner: {
+          foreground: "color.text.neutral",
+          background: "color.background.surface.muted",
+          border: "color.border.neutral",
+          icon: "icon.status.draft"
+        }
+      },
+      posted: {
+        description: "Invoice finalized with terms before collection.",
+        chip: {
+          foreground: "color.text.info",
+          background: "color.background.info.subtle",
+          border: "color.border.info",
+          icon: "icon.status.pending"
+        },
+        banner: {
+          foreground: "color.text.info",
+          background: "color.background.surface.default",
+          border: "color.border.info",
+          icon: "icon.status.pending"
+        }
+      },
+      paid: {
+        description: "Invoice collected successfully in full.",
+        chip: {
+          foreground: "color.text.positive",
+          background: "color.background.positive.subtle",
+          border: "color.border.positive",
+          icon: "icon.status.success"
+        },
+        banner: {
+          foreground: "color.text.positive",
+          background: "color.background.surface.default",
+          border: "color.border.positive",
+          icon: "icon.status.success"
+        }
+      },
+      past_due: {
+        description: "Invoice is unpaid past its due date.",
+        chip: {
+          foreground: "color.text.danger",
+          background: "color.background.danger.subtle",
+          border: "color.border.danger",
+          icon: "icon.status.error"
+        },
+        banner: {
+          foreground: "color.text.onbold",
+          background: "color.background.danger.bold",
+          border: "color.border.danger",
+          icon: "icon.status.error"
+        }
+      },
+      void: {
+        description: "Invoice canceled and no longer payable.",
+        chip: {
+          foreground: "color.text.disabled",
+          background: "color.background.disabled",
+          border: "color.border.disabled",
+          icon: "icon.status.void"
+        },
+        banner: {
+          foreground: "color.text.neutral",
+          background: "color.background.neutral.subtle",
+          border: "color.border.neutral",
+          icon: "icon.status.void"
+        }
+      }
+    }
+  }
+};
+
+// registry/lifecycle-status-tones.json
+var lifecycle_status_tones_default = {
+  states: {
+    active: { tone: "success", icon: "icon.status.success", description: "Active and in use." },
+    available: { tone: "success", icon: "icon.status.success", description: "Available to use." },
+    published: { tone: "success", icon: "icon.status.success", description: "Published and visible." },
+    settled: { tone: "success", icon: "icon.status.success", description: "Settled in full." },
+    succeeded: { tone: "success", icon: "icon.status.success", description: "Completed successfully." },
+    paid: { tone: "success", icon: "icon.status.paid", description: "Paid in full." },
+    completed: { tone: "success", icon: "icon.status.success", description: "Completed." },
+    good_standing: { tone: "success", icon: "icon.status.success", description: "In good standing." },
+    in_stock: { tone: "success", icon: "icon.status.success", description: "In stock." },
+    ok: { tone: "success", icon: "icon.status.success", description: "Working as expected." },
+    invited: { tone: "info", icon: "icon.status.pending", description: "Invited and not yet joined." },
+    onboarding: { tone: "info", icon: "icon.status.processing", description: "Being set up." },
+    pending: { tone: "info", icon: "icon.status.pending", description: "Waiting to be processed." },
+    authorized: { tone: "info", icon: "icon.status.pending", description: "Authorized and not yet settled." },
+    processing: { tone: "info", icon: "icon.status.processing", description: "Being processed." },
+    in_review: { tone: "info", icon: "icon.status.pending", description: "In review." },
+    scheduled: { tone: "info", icon: "icon.status.scheduled", description: "Scheduled for later." },
+    ingested: { tone: "info", icon: "icon.status.pending", description: "Received and not yet processed." },
+    proposed: { tone: "info", icon: "icon.status.pending", description: "Proposed and not yet agreed." },
+    posted: { tone: "info", icon: "icon.status.pending", description: "Finalized and posted." },
+    open: { tone: "info", icon: "icon.status.pending", description: "Open and awaiting action." },
+    future: { tone: "info", icon: "icon.status.future", description: "Starts later." },
+    trialing: { tone: "accent", icon: "icon.status.trial", description: "In a trial period." },
+    private_beta: { tone: "accent", icon: "icon.status.trial", description: "Available to a limited group." },
+    retrying: { tone: "warning", icon: "icon.status.processing", description: "Failed once and retrying." },
+    delayed: { tone: "warning", icon: "icon.status.warning", description: "Behind schedule." },
+    investigating: { tone: "warning", icon: "icon.status.warning", description: "Being investigated." },
+    low_stock: { tone: "warning", icon: "icon.status.warning", description: "Running low." },
+    backorder: { tone: "warning", icon: "icon.status.warning", description: "Out of stock and on order." },
+    suspended: { tone: "warning", icon: "icon.status.paused", description: "Suspended for now." },
+    deprecated: { tone: "warning", icon: "icon.status.warning", description: "Being phased out." },
+    past_due: { tone: "critical", icon: "icon.status.warning", description: "Past its due date." },
+    failed: { tone: "critical", icon: "icon.status.critical", description: "Failed." },
+    unpaid: { tone: "critical", icon: "icon.status.critical", description: "Unpaid." },
+    uncollectible: { tone: "critical", icon: "icon.status.critical", description: "Could not be collected." },
+    draft: { tone: "neutral", icon: "icon.status.draft", description: "A draft, not yet final." },
+    prospect: { tone: "neutral", icon: "icon.status.default", description: "Not yet a customer." },
+    paused: { tone: "neutral", icon: "icon.status.paused", description: "Paused." },
+    archived: { tone: "neutral", icon: "icon.status.default", description: "Archived." },
+    legacy: { tone: "neutral", icon: "icon.status.default", description: "Kept for existing users and no longer offered." },
+    refunded: { tone: "neutral", icon: "icon.status.refunded", description: "Refunded." },
+    cancelled: { tone: "neutral", icon: "icon.status.cancelled", description: "Cancelled." },
+    canceled: { tone: "neutral", icon: "icon.status.canceled", description: "Cancelled." },
+    void: { tone: "neutral", icon: "icon.status.void", description: "Voided." },
+    retired: { tone: "neutral", icon: "icon.status.canceled", description: "Retired and no longer offered." },
+    discontinued: { tone: "neutral", icon: "icon.status.canceled", description: "Discontinued." },
+    deactivated: { tone: "neutral", icon: "icon.status.canceled", description: "Deactivated." },
+    terminated: { tone: "neutral", icon: "icon.status.canceled", description: "Ended." },
+    churned: { tone: "neutral", icon: "icon.status.canceled", description: "No longer a customer." }
+  }
+};
+
+// src/status-registry.ts
+var TONE_ALIASES = {
+  info: "info",
+  informational: "info",
+  accent: "accent",
+  highlight: "accent",
+  positive: "success",
+  success: "success",
+  ok: "success",
+  warning: "warning",
+  caution: "warning",
+  danger: "critical",
+  critical: "critical",
+  error: "critical",
+  negative: "critical",
+  neutral: "neutral",
+  pending: "info"
+};
+var toLabel = (status) => status.split(/[_-]/).filter(Boolean).map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1)).join(" ");
+var inferTone = (entry) => {
+  if (!entry) return "neutral";
+  for (const reference of [entry.foreground, entry.background, entry.border]) {
+    const segments = reference.replace(/^\{|\}$/g, "").split(/[\s./_-]+/).reverse();
+    for (const segment of segments) {
+      const tone = TONE_ALIASES[segment.toLowerCase()];
+      if (tone) return tone;
+    }
+  }
+  return "neutral";
+};
+var componentTokenSet = (tone) => {
+  const normalized = tone === "positive" ? "success" : tone === "danger" ? "critical" : tone;
+  return {
+    background: `var(--sys-status-${normalized}-surface)`,
+    border: `var(--sys-status-${normalized}-border)`,
+    foreground: `var(--sys-status-${normalized}-text)`
+  };
+};
+var rawTokenSet = (entry) => {
+  const tone = inferTone(entry);
+  return componentTokenSet(tone);
+};
+var bannerFallback = (tone) => tone === "neutral" ? {
+  background: "var(--cmp-banner-background)",
+  border: "var(--cmp-banner-border)",
+  foreground: "var(--cmp-banner-text)"
+} : componentTokenSet(tone);
+var fallback = (domain, status, tone = "neutral") => ({
+  domain,
+  status,
+  label: toLabel(status || "Unknown"),
+  description: "Status not found in registry; falling back to the requested token set.",
+  tone,
+  badge: { subtle: componentTokenSet(tone), solid: componentTokenSet(tone) },
+  banner: { subtle: bannerFallback(tone), solid: componentTokenSet(tone) }
+});
+var registry = /* @__PURE__ */ new Map();
+for (const [domain, entries] of Object.entries(status_map_default.domains)) {
+  const domainEntries = /* @__PURE__ */ new Map();
+  for (const [status, entry] of Object.entries(entries)) {
+    const tone = inferTone(entry.chip);
+    domainEntries.set(status.toLowerCase(), {
+      domain,
+      status,
+      label: toLabel(status),
+      description: entry.description,
+      tone,
+      iconName: entry.chip.icon ?? entry.banner?.icon,
+      badge: { subtle: rawTokenSet(entry.chip), solid: componentTokenSet(tone) },
+      banner: {
+        subtle: entry.banner ? rawTokenSet(entry.banner) : bannerFallback(tone),
+        solid: componentTokenSet(tone)
+      }
+    });
+  }
+  registry.set(domain, domainEntries);
+}
+var lifecycleEntries = /* @__PURE__ */ new Map();
+for (const [status, entry] of Object.entries(lifecycle_status_tones_default.states)) {
+  lifecycleEntries.set(status, {
+    domain: "lifecycle",
+    status,
+    label: toLabel(status),
+    description: entry.description,
+    tone: entry.tone,
+    iconName: entry.icon,
+    badge: { subtle: componentTokenSet(entry.tone), solid: componentTokenSet(entry.tone) },
+    banner: { subtle: bannerFallback(entry.tone), solid: componentTokenSet(entry.tone) }
+  });
+}
+registry.set("lifecycle", lifecycleEntries);
+var LEGACY_STATUS_ALIASES = {
+  subscription: { delinquent: "unpaid" }
+};
+var STATUS_DOMAINS = Object.freeze([...registry.keys()]);
+function getStatusPresentation(domain, status) {
+  const entries = registry.get(domain);
+  const normalized = status.toLowerCase();
+  const direct = entries?.get(normalized);
+  if (direct) return direct;
+  const alias = LEGACY_STATUS_ALIASES[domain]?.[normalized];
+  const aliased = alias ? entries?.get(alias) : void 0;
+  if (aliased) return { ...aliased, status, label: toLabel(status) };
+  const shared = lifecycleEntries.get(normalized);
+  return shared ? { ...shared, status, label: toLabel(status) } : fallback(domain, status);
+}
+function listStatuses(domain) {
+  return [...registry.get(domain)?.values() ?? []];
+}
+function getToneTokenSet(tone) {
+  return componentTokenSet(tone);
+}
+function getBannerToneTokenSet(tone) {
+  return bannerFallback(tone);
+}
+
 // src/billing-views.ts
 function billingCycle(values) {
   const start = Date.parse(values.periodStart ?? "");
@@ -16656,10 +17670,19 @@ function summaryValue(value) {
 function chronologicalEvents(events) {
   return events.filter((event) => Number.isFinite(Date.parse(event.at))).map((event, index) => ({ event, index })).sort((a, b) => Date.parse(a.event.at) - Date.parse(b.event.at) || a.index - b.index).map(({ event }) => event);
 }
-function formatReadOnlyValue(value, type, code = false) {
+function formatDeclaredNumber(value, format) {
+  const number = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : NaN;
+  if (!Number.isFinite(number)) return void 0;
+  return format === "percent" ? new Intl.NumberFormat("en-US", { style: "percent", maximumFractionDigits: 2 }).format(number / 100) : new Intl.NumberFormat("en-US", { maximumFractionDigits: 2 }).format(number);
+}
+function formatReadOnlyValue(value, type, code = false, format) {
   if (value == null || value === "") return "Not recorded";
   if (type === "date" || type === "datetime") return formatDateTime(value) || "Invalid date";
   if (typeof value === "boolean") return value ? "Yes" : "No";
+  if (format && !Array.isArray(value)) {
+    const formatted = formatDeclaredNumber(value, format);
+    if (formatted !== void 0) return formatted;
+  }
   if (Array.isArray(value)) {
     if (value.some((item) => item !== null && typeof item === "object")) return `${value.length} ${value.length === 1 ? "record" : "records"}`;
     return value.map((item) => summaryValue(item) ?? "").join(", ") || "None recorded";
@@ -16684,18 +17707,40 @@ function recordCollectionEvents(record2, options = {}) {
     const description = paid ? formatBillingAmount(paid.amount, String(paid.currency ?? record2.currency), options.minorUnits ?? 100) : billingSummary(Number(record2.amount), String(record2.currency), options.minorUnits ?? 100, String(record2.billing_interval));
     events.push({ id: "payment-" + source2.field, title: source2.title, at, description, kind: "payment" });
   }
-  for (const source2 of [{ field: "created_at", title: "Created" }, { field: "last_event_at", title: String(record2.last_event ?? "Updated").replaceAll("_", " ") }, { field: "issued_at", title: "Issued" }, { field: "period_start", title: "Period started" }, { field: "ownership_transferred_at", title: "Ownership transferred" }]) {
-    const at = record2[source2.field];
-    if (!chronologicalEvents(events).length && typeof at === "string" && Number.isFinite(Date.parse(at))) events.push({ id: "record-" + source2.field, kind: "state", title: source2.title, at, description: "" });
+  if (!chronologicalEvents(events).length) {
+    const lastEvent = String(record2.last_event ?? "Updated");
+    const dated = [{ field: "created_at", title: "Created" }, { field: "last_event_at", title: lastEvent.split(/[_-]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ") }, { field: "issued_at", title: "Issued" }, { field: "period_start", title: "Period started" }, { field: "ownership_transferred_at", title: "Ownership transferred" }].filter((source2) => typeof record2[source2.field] === "string" && Number.isFinite(Date.parse(record2[source2.field])));
+    const both = dated[0]?.field === "created_at" && dated[1]?.field === "last_event_at" && lastEvent !== "created";
+    for (const source2 of dated.slice(0, both ? 2 : 1)) events.push({ id: "record-" + source2.field, kind: "state", title: source2.title, at: record2[source2.field], description: "" });
+  }
+  for (const [field2, title, reason] of [["archived_at", "Archived", "archive_reason"], ["restored_at", "Restored", void 0], ["cancellation_requested_at", "Cancellation requested", "cancellation_reason"]]) {
+    const at = record2[field2];
+    if (typeof at === "string" && Number.isFinite(Date.parse(at))) events.push({ id: "record-" + field2, kind: "state", title, at, description: reason && typeof record2[reason] === "string" ? String(record2[reason]) : "" });
   }
   return chronologicalEvents(events);
 }
+function addressCollectionSummary(entries) {
+  const asRecord = (value) => value && typeof value === "object" ? value : {};
+  return (Array.isArray(entries) ? entries : []).map((entry) => {
+    const address = asRecord(asRecord(entry).address);
+    const street = Array.isArray(address.addressLines) ? address.addressLines.map(String).join(", ") : "";
+    return [asRecord(entry).role, street, String(address.locality ?? ""), String(address.administrativeArea ?? ""), String(address.postalCode ?? "")].filter(Boolean).join(", ");
+  }).join("; ");
+}
 var UUID_REFERENCE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function formatReferenceLabel(identifier, label, subject = "Reference") {
   if (identifier == null || identifier === "") return `${subject} unavailable`;
   if (typeof label === "string" && label.trim() && !UUID_REFERENCE.test(label.trim())) return label;
   return `${subject} reference not resolved`;
 }
+var UNRESOLVED_REFERENCE_LABEL = / (?:unavailable|reference not resolved)$/;
+function ownershipPhrase(ownerLabel, ownerType, role) {
+  const text2 = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+  const name = text2(ownerLabel) && !UNRESOLVED_REFERENCE_LABEL.test(text2(ownerLabel)) ? text2(ownerLabel) : void 0;
+  const type = text2(ownerType)?.replace(/[_-]+/g, " ");
+  const parts = name ? [`Owned by ${name}`, type, text2(role)] : type ? [`${type.charAt(0).toUpperCase()}${type.slice(1)}-owned`, text2(role)] : [];
+  return parts.filter(Boolean).join(" \xB7 ") || void 0;
+}
 function formatRecordLabel(value) {
   return typeof value === "string" && UUID_REFERENCE.test(value.trim()) ? "Record name unavailable" : String(value ?? "");
 }
@@ -16736,12 +17781,12 @@ function assertStaticSvg(svg) {
   for (const match of markup.matchAll(/<\/?([\w:-]+)((?:[^<>"']|"[^"]*"|'[^']*')*)>/g)) {
     if (markup.slice(end, match.index).includes("<") || !allowed.has(match[1].toLowerCase())) unsafe();
     end = match.index + match[0].length;
-    const attributes = match[2].replace(/\/\s*$/, "");
+    const attributes2 = match[2].replace(/\/\s*$/, "");
     const attribute = /\s+([\w:-]+)\s*=\s*("[^"]*"|'[^']*')/y;
     let offset = 0;
-    while (offset < attributes.trimEnd().length) {
+    while (offset < attributes2.trimEnd().length) {
       attribute.lastIndex = offset;
-      const found = attribute.exec(attributes);
+      const found = attribute.exec(attributes2);
       if (!found) unsafe();
       offset = attribute.lastIndex;
       const name = found[1].toLowerCase();
@@ -16772,6 +17817,27 @@ function svgCarriesTitle(svg, title) {
   }
   return false;
 }
+var VIZ_THEME_SVG_PROPS = Object.freeze(["svgDark", "svgDarkNarrow", "svgDarkWide", "svgHc", "svgHcNarrow", "svgHcWide"]);
+var VIZ_SVG_PROPS = Object.freeze(["svg", "svgNarrow", "svgWide", ...VIZ_THEME_SVG_PROPS]);
+function vizPreviewLayers(props) {
+  if (typeof props.svg !== "string") return [];
+  const sets = [
+    ["light", props.svg, props.svgNarrow, props.svgWide],
+    ["dark", props.svgDark, props.svgDarkNarrow, props.svgDarkWide],
+    ["hc", props.svgHc, props.svgHcNarrow, props.svgHcWide]
+  ];
+  const themed = VIZ_THEME_SVG_PROPS.some((key) => typeof props[key] === "string");
+  return (themed ? sets : sets.slice(0, 1)).filter(([, design]) => typeof design === "string").map(([theme, design, narrow, wide]) => ({
+    ...themed ? { theme } : {},
+    narrow: typeof narrow === "string",
+    wide: typeof wide === "string",
+    renders: [
+      ["data-viz-svg", assertStaticSvg(design)],
+      ...typeof narrow === "string" ? [["data-viz-svg-narrow", assertStaticSvg(narrow)]] : [],
+      ...typeof wide === "string" ? [["data-viz-svg-wide", assertStaticSvg(wide)]] : []
+    ]
+  }));
+}
 
 // src/disputed.ts
 function auditSummary({ auditLog = [], lastN = 5 }) {
@@ -16996,7 +18062,7 @@ function validateComponentIntakeDocument(input) {
   if (!Array.isArray(document.rows)) return [...errors, "intake rows must be an array"];
   const ids = document.rows.map((row) => row && typeof row === "object" && !Array.isArray(row) && typeof row.id === "string" ? row.id : "");
   if (ids.some((id) => id.length === 0)) errors.push("every intake row must have a non-empty id");
-  if (ids.length !== 110) errors.push(`intake must contain exactly 110 rows; received ${ids.length}`);
+  if (ids.length !== 114) errors.push(`intake must contain exactly 114 rows; received ${ids.length}`);
   const uniqueCount = new Set(ids).size;
   if (uniqueCount !== ids.length) errors.push("intake IDs must be unique");
   const sorted = [...ids].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
@@ -17010,4 +18076,4 @@ function getBaselineCapability(componentId) {
   return componentCapabilityBaseline.rows.find((row) => row.id === componentId);
 }
 
-export { BILLING_AMOUNT_ERROR, BILLING_INTERVALS, BILLING_INTERVAL_ERROR, BILLING_MINOR_UNITS, COMPONENT_CLASSIFICATIONS, COMPONENT_CONTRACT_VERSION, COMPONENT_CONTRACT_VERSION_1_1, DEFAULT_COLOR_STATES, EMISSION_ELIGIBILITY_EVIDENCE_CLASSES, FOUNDATION_V1_EVIDENCE_CLASSES, GOVERNED_DEFINITION, GOVERNED_SURFACES, NO_LAST_PAYMENT, NO_NEXT_PAYMENT, NUCLEUS_COMPONENT_IDS, PORTED_COMPONENT_IDS, RESULT_STATES, RESULT_STATE_TONE, SEVERITY_TONES, UI_WORKFLOW_STATES, VIZ_CONTROL_IDS, VIZ_CONTROL_TITLES, VIZ_PREVIEW_TYPES, VIZ_SUMMARY_IDS, ariaSort, assertStaticSvg, auditSummary, billingAmountMessage, billingAmountText, billingCycle, billingDate, billingIntervalMessage, billingPaymentRows, billingPaymentSummary, billingPeriodEnd, billingSummary, chronologicalEvents, componentBehaviors, componentCapabilityBaseline, componentContracts, componentIntake, componentReconciliationProposal, currencyMinorUnits, dateTimeInputValue, defaultVizIntent, deriveStartingComponentCount, editVizIntent, evaluateEmissionEligibility, evaluateFoundationV1, formatBillingAmount, formatDateTime, formatPriceAmount, formatPriceCode, formatReadOnlyValue, formatRecordLabel, formatReferenceLabel, geoFieldMapping, getBaselineCapability, initialSort, isGovernedComponent, isVizIntentFragment, nextSort, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, restartedBillingPeriod, sharedScenarios, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizSummaryRows };
+export { BILLING_AMOUNT_ERROR, BILLING_INTERVALS, BILLING_INTERVAL_ERROR, BILLING_MINOR_UNITS, COMPONENT_CLASSIFICATIONS, COMPONENT_CONTRACT_VERSION, COMPONENT_CONTRACT_VERSION_1_1, DEFAULT_COLOR_STATES, EMISSION_ELIGIBILITY_EVIDENCE_CLASSES, FOUNDATION_V1_EVIDENCE_CLASSES, GOVERNED_DEFINITION, GOVERNED_SURFACES, NO_LAST_PAYMENT, NO_NEXT_PAYMENT, NUCLEUS_COMPONENT_IDS, PORTED_COMPONENT_IDS, RESULT_STATES, RESULT_STATE_TONE, SEVERITY_TONES, STATUS_DOMAINS, STATUS_ICON_SHAPES, STATUS_ICON_SVG_ATTRS, UI_WORKFLOW_STATES, VIZ_CONTROL_IDS, VIZ_CONTROL_TITLES, VIZ_PREVIEW_TYPES, VIZ_SUMMARY_IDS, VIZ_SVG_PROPS, VIZ_THEME_SVG_PROPS, addressCollectionSummary, ariaSort, assertStaticSvg, auditSummary, billingAmountMessage, billingAmountText, billingCycle, billingDate, billingIntervalMessage, billingPaymentRows, billingPaymentSummary, billingPeriodEnd, billingSummary, chronologicalEvents, componentBehaviors, componentCapabilityBaseline, componentContracts, componentIntake, componentReconciliationProposal, currencyMinorUnits, dateTimeInputValue, defaultVizIntent, deriveStartingComponentCount, editVizIntent, evaluateEmissionEligibility, evaluateFoundationV1, formatBillingAmount, formatDateTime, formatDeclaredNumber, formatPriceAmount, formatPriceCode, formatReadOnlyValue, formatRecordLabel, formatReferenceLabel, geoFieldMapping, getBannerToneTokenSet, getBaselineCapability, getStatusPresentation, getToneTokenSet, initialSort, isGovernedComponent, isVizIntentFragment, listStatuses, nextSort, ownershipPhrase, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, relativeTimestampEmptyScenario, resolveStatusIcon, restartedBillingPeriod, sharedScenarios, statusIconMarkup, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizPreviewLayers, vizSummaryRows };