@oods/component-contracts 0.3.2 → 0.4.0

package/dist/index.js

@@ -4,7 +4,7 @@ var component_intake_v1_default = {
   kind: "component-intake",
   baselineCommit: "ae560bc22969c1fd81336730be4330c9115fc316",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 112,
   countRule: "Derived from the unique, deterministically sorted rows array; never from an independent counter.",
   rows: [
     {
@@ -1050,6 +1050,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",
@@ -2155,6 +2177,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 +3226,9 @@ var component_reconciliation_proposed_v2_default = {
   baselineCommit: "a5638cf819bdadb86e2336c4aabe9b2184699c13",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
   status: "proposed-awaiting-approval",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 112,
   approvedRuntimeCensus: null,
-  proposedRuntimeCensus: 110,
+  proposedRuntimeCensus: 112,
   rows: [
     {
       id: "AddressCollectionPanel",
@@ -3896,6 +3948,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",
@@ -4671,6 +4742,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 +5473,7 @@ var component_capability_ledger_v1_default = {
   schemaVersion: "1.0.0",
   kind: "component-capability-ledger",
   generatedAt: "2026-09-11T05:30:00Z",
-  controllingObligationDenominator: 110,
+  controllingObligationDenominator: 112,
   approvedRuntimeCensus: null,
   source: "refresh_structured_data.py#project_measured_surfaces",
   rows: [
@@ -8451,6 +8541,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",
@@ -12039,6 +12200,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",
@@ -15103,6 +15335,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "CycleProgressCard",
   "DatePicker",
   "DetailHeader",
+  "Dialog",
   "FilterPanel",
   "FormLabelGroup",
   "GeoFieldMappingForm",
@@ -15141,6 +15374,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "StatusColorLegend",
   "StatusSelector",
   "StatusTimeline",
+  "Switch",
   "Table",
   "Tabs",
   "TagInput",
@@ -15269,6 +15503,7 @@ var componentBehaviors = {
   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": [] },
@@ -15301,6 +15536,7 @@ var componentBehaviors = {
   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" }] },
@@ -15346,7 +15582,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."
   },
@@ -15369,7 +15605,7 @@ var authoredContracts = {
     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."
   },
@@ -15410,22 +15646,17 @@ var authoredContracts = {
   AuditTimeline: {
     id: "AuditTimeline",
     version: COMPONENT_CONTRACT_VERSION,
-    props: [
-      "title",
-      "events",
-      "history",
-      "entries",
-      "auditLog",
+    props: ["title", "events", "history", "entries", "auditLog", "maxVisible", "showFromState", "showActorId", "showReason"],
+    directives: [
+      "field",
+      "historyField",
+      "statesParameter",
       "auditLogField",
       "createdField",
       "updatedField",
       "eventField",
       "eventTimestampField",
-      "eventOptionsParameter",
-      "maxVisible",
-      "showFromState",
-      "showActorId",
-      "showReason"
+      "eventOptionsParameter"
     ],
     slots: ["default"],
     events: [],
@@ -15441,7 +15672,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."
   },
@@ -15518,7 +15749,7 @@ var authoredContracts = {
     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."
   },
@@ -15537,18 +15768,8 @@ var authoredContracts = {
   CancellationSummary: {
     id: "CancellationSummary",
     version: COMPONENT_CONTRACT_VERSION,
-    props: [
-      "title",
-      "label",
-      "cancelAtPeriodEnd",
-      "requestedAt",
-      "reason",
-      "code",
-      "cancelAtPeriodEndField",
-      "requestedAtField",
-      "reasonField",
-      "codeField"
-    ],
+    props: ["title", "label", "cancelAtPeriodEnd", "requestedAt", "reason", "code"],
+    directives: ["field", "cancelAtPeriodEndField", "requestedAtField", "reasonField", "codeField"],
     slots: ["default"],
     events: [],
     states: ["scheduled", "not-scheduled"],
@@ -15597,7 +15818,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."
   },
@@ -15642,7 +15863,7 @@ 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."
   },
@@ -15681,6 +15902,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; 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. 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,
@@ -15791,7 +16024,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."
   },
@@ -15802,7 +16035,7 @@ 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."
   },
@@ -15839,7 +16072,9 @@ var authoredContracts = {
       "pageSizeOptions",
       "showPageSizeSelector",
       "showGotoPage",
-      "showItemRange",
+      "showItemRange"
+    ],
+    directives: [
       "pageField",
       "pageSizeField",
       "totalItemsField",
@@ -15907,7 +16142,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."
   },
@@ -15935,16 +16170,13 @@ var authoredContracts = {
       "label",
       "value",
       "emphasis",
-      "amountField",
-      "currencyField",
-      "intervalField",
-      "minorUnitsParameter",
       "minorUnits"
     ],
+    directives: ["field", "amountField", "currencyField", "intervalField", "minorUnitsParameter"],
     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."
   },
@@ -15984,10 +16216,9 @@ var authoredContracts = {
       "text",
       "timezone",
       "now",
-      "fallbackField",
-      "timezoneParameter",
       "hideWhenEmpty"
     ],
+    directives: ["field", "fallbackField", "timezoneParameter"],
     slots: ["default"],
     events: [],
     states: ["relative", "absolute", "empty"],
@@ -16013,7 +16244,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."
   },
@@ -16030,12 +16261,9 @@ var authoredContracts = {
       "debounceMs",
       "debounce",
       "minQueryLength",
-      "disabled",
-      "placeholderParameter",
-      "debounceParameter",
-      "minQueryLengthParameter",
-      "clearableParameter"
+      "disabled"
     ],
+    directives: ["field", "placeholderParameter", "debounceParameter", "minQueryLengthParameter", "clearableParameter"],
     slots: [],
     events: ["valueChange", "update", "search", "clear"],
     states: ["empty", "valued", "disabled"],
@@ -16059,7 +16287,8 @@ var authoredContracts = {
   Stack: {
     id: "Stack",
     version: COMPONENT_CONTRACT_VERSION_1_1,
-    props: ["direction", "gap", "align", "justify", "wrap", "patternComponent", "fields"],
+    props: ["direction", "gap", "align", "justify", "wrap"],
+    directives: ["patternComponent", "fields"],
     slots: ["default"],
     events: [],
     states: ["row", "column", "wrapped"],
@@ -16081,15 +16310,14 @@ var authoredContracts = {
       "emphasis",
       "showIcon",
       "variant",
-      "statusField",
-      "domainField",
       "readOnly",
       "compact"
     ],
+    directives: ["field", "statusField", "domainField"],
     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."
   },
@@ -16116,12 +16344,21 @@ var authoredContracts = {
       "stateHistory",
       "status",
       "allowedTransitions",
-      "historyField",
-      "statesParameter",
       "showActorId",
       "showReason",
       "maxVisible"
     ],
+    directives: [
+      "field",
+      "historyField",
+      "statesParameter",
+      "auditLogField",
+      "createdField",
+      "updatedField",
+      "eventField",
+      "eventTimestampField",
+      "eventOptionsParameter"
+    ],
     slots: ["default"],
     events: [],
     states: ["populated", "empty"],
@@ -16129,10 +16366,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 without script, so a static page shows the state and does not toggle."
+  },
   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"],
@@ -16180,7 +16429,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."
   },
@@ -16234,35 +16483,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." },
@@ -16346,7 +16595,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">\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>'}
   }
 };
 
@@ -16428,6 +16677,10 @@ 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"] },
+  { 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"] },
@@ -16536,6 +16789,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(
@@ -16592,6 +16857,453 @@ 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)]
+});
+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 ?? "");
@@ -16695,9 +17407,15 @@ 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);
 }
@@ -16747,12 +17465,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();
@@ -16783,6 +17501,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 }) {
@@ -17007,7 +17746,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 !== 112) errors.push(`intake must contain exactly 112 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);
@@ -17021,4 +17760,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, 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, getBannerToneTokenSet, getBaselineCapability, getStatusPresentation, getToneTokenSet, initialSort, isGovernedComponent, isVizIntentFragment, listStatuses, nextSort, parseBillingAmount, portedComponentContracts, portedScenarios, recipeItemLabels, recordCollectionEvents, relativeTimestampEmptyScenario, resolveStatusIcon, restartedBillingPeriod, sharedScenarios, statusIconMarkup, substitutionContractReport, summarizeSubstitutionReport, summaryValue, svgCarriesTitle, traitEventRows, validMinorUnits, validateComponentIntakeDocument, vizControlFields, vizFieldValue, vizPreviewLayers, vizSummaryRows };