@oods/component-contracts 0.4.0 → 0.4.1

package/dist/index.cjs

@@ -6,7 +6,7 @@ var component_intake_v1_default = {
   kind: "component-intake",
   baselineCommit: "ae560bc22969c1fd81336730be4330c9115fc316",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
-  controllingObligationDenominator: 112,
+  controllingObligationDenominator: 114,
   countRule: "Derived from the unique, deterministically sorted rows array; never from an independent counter.",
   rows: [
     {
@@ -937,6 +937,38 @@ var component_intake_v1_default = {
         "traits/visual/Colorized.trait.yaml"
       ]
     },
+    {
+      id: "Combobox",
+      displayName: "Combobox",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "autocomplete",
+          "combobox",
+          "field",
+          "filter",
+          "form",
+          "input",
+          "interactive",
+          "primitive",
+          "select"
+        ],
+        contexts: [
+          "form"
+        ],
+        regions: [
+          "form",
+          "main"
+        ]
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#Combobox",
+        "packages/mcp-server/src/render/component-map.ts#renderCombobox"
+      ],
+      addedBy: "s223-m02; decision #2527 ruling 11"
+    },
     {
       id: "CommunicationDetailPanel",
       displayName: "CommunicationDetailPanel",
@@ -1922,6 +1954,37 @@ var component_intake_v1_default = {
         "traits/behavioral/Searchable.trait.yaml"
       ]
     },
+    {
+      id: "SegmentedControl",
+      displayName: "SegmentedControl",
+      baselineMetadata: {
+        categories: [
+          "primitive"
+        ],
+        tags: [
+          "choice",
+          "field",
+          "form",
+          "input",
+          "interactive",
+          "primitive",
+          "radio",
+          "segmented-control"
+        ],
+        contexts: [
+          "form"
+        ],
+        regions: [
+          "form",
+          "main"
+        ]
+      },
+      intakeEvidence: [
+        "packages/component-contracts/src/contracts.ts#SegmentedControl",
+        "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl"
+      ],
+      addedBy: "s223-m02; decision #2527 ruling 10"
+    },
     {
       id: "Select",
       displayName: "Select",
@@ -3228,9 +3291,9 @@ var component_reconciliation_proposed_v2_default = {
   baselineCommit: "a5638cf819bdadb86e2336c4aabe9b2184699c13",
   planningCommit: "8ce349076e7e3ba3f0b2f3f667d4fbb5c6a4b63b",
   status: "proposed-awaiting-approval",
-  controllingObligationDenominator: 112,
+  controllingObligationDenominator: 114,
   approvedRuntimeCensus: null,
-  proposedRuntimeCensus: 112,
+  proposedRuntimeCensus: 114,
   rows: [
     {
       id: "AddressCollectionPanel",
@@ -3870,6 +3933,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "Combobox",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderCombobox",
+        "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+        "packages/components-vue/evidence/vue-readiness.v1.json#Combobox",
+        "packages/component-contracts/src/contracts.ts#Combobox"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "Combobox",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2527 (ruling 11). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "CommunicationDetailPanel",
       proposedClassification: "recipe",
@@ -4583,6 +4665,25 @@ var component_reconciliation_proposed_v2_default = {
       implementationStatus: "implemented-evidence-complete",
       compatibilityNote: "Retain the named public ID and existing HTML discovery contract. Governed framework implementation and measurements are linked; classification remains a proposal."
     },
+    {
+      id: "SegmentedControl",
+      proposedClassification: "native",
+      approvalState: "pending-approval",
+      evidence: [
+        "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl",
+        "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+        "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl",
+        "packages/component-contracts/src/contracts.ts#SegmentedControl"
+      ],
+      implementationStatus: "implemented-evidence-complete",
+      proposedResolution: {
+        surface: "react+vue+html",
+        implementation: "SegmentedControl",
+        source: "packages/component-contracts/src/contracts.ts",
+        publicIdRetained: true
+      },
+      compatibilityNote: "New public identity added by decision #2527 (ruling 10). Governed framework implementation and measurements are linked; classification remains a proposal."
+    },
     {
       id: "Select",
       proposedClassification: "native",
@@ -5475,7 +5576,7 @@ var component_capability_ledger_v1_default = {
   schemaVersion: "1.0.0",
   kind: "component-capability-ledger",
   generatedAt: "2026-09-11T05:30:00Z",
-  controllingObligationDenominator: 112,
+  controllingObligationDenominator: 114,
   approvedRuntimeCensus: null,
   source: "refresh_structured_data.py#project_measured_surfaces",
   rows: [
@@ -8184,6 +8285,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "Combobox",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#Combobox"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#Combobox"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderCombobox"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-measured.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-measured.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-theme/report.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-theme/report.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/combobox/react-measured.json#Combobox",
+            "artifacts/product-reality/sprint-223/m02/combobox/vue-measured.json#Combobox",
+            "packages/components-react/evidence/react-readiness.v1.json#Combobox",
+            "packages/components-vue/evidence/vue-readiness.v1.json#Combobox"
+          ]
+        }
+      }
+    },
     {
       id: "CommunicationDetailPanel",
       proposedClassification: "recipe",
@@ -11235,6 +11407,77 @@ var component_capability_ledger_v1_default = {
         }
       }
     },
+    {
+      id: "SegmentedControl",
+      proposedClassification: "native",
+      reconciliationState: "proposed-awaiting-approval",
+      surfaces: {
+        contract: {
+          state: "versioned-v1",
+          evidence: [
+            "packages/component-contracts/src/contracts.ts#SegmentedControl"
+          ]
+        },
+        metadata: {
+          state: "available",
+          evidence: [
+            "packages/component-contracts/registry/component-intake.v1.json#SegmentedControl"
+          ]
+        },
+        html: {
+          state: "mapped",
+          evidence: [
+            "packages/mcp-server/src/render/component-map.ts#renderSegmentedControl"
+          ]
+        },
+        react: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        vue: {
+          state: "implemented-evidence-complete",
+          evidence: [
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        generatedConsumer: {
+          state: "unavailable",
+          evidence: [
+            "artifacts/product-reality/sprint-193/m07/runtime/runtime-cells.v1.json"
+          ],
+          reason: "No current runtime cell places this component; historical receipts do not establish current coverage."
+        },
+        accessibility: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-measured.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-measured.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        theme: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-theme/report.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-theme/report.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        },
+        interaction: {
+          state: "verified",
+          evidence: [
+            "artifacts/product-reality/sprint-223/m02/segmented-control/react-measured.json#SegmentedControl",
+            "artifacts/product-reality/sprint-223/m02/segmented-control/vue-measured.json#SegmentedControl",
+            "packages/components-react/evidence/react-readiness.v1.json#SegmentedControl",
+            "packages/components-vue/evidence/vue-readiness.v1.json#SegmentedControl"
+          ]
+        }
+      }
+    },
     {
       id: "Select",
       proposedClassification: "native",
@@ -15333,6 +15576,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "ColorStatePicker",
   "ColorSwatch",
   "ColorizedBadge",
+  "Combobox",
   "CommunicationDetailPanel",
   "CycleProgressCard",
   "DatePicker",
@@ -15368,6 +15612,7 @@ var NUCLEUS_COMPONENT_IDS = [
   "RoleAssignmentForm",
   "RoleBadgeList",
   "SearchInput",
+  "SegmentedControl",
   "Select",
   "SortIndicator",
   "Stack",
@@ -15502,6 +15747,11 @@ var componentBehaviors = {
   ClassificationPanel: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "ClassificationPanel presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   ColorSwatch: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "ColorSwatch presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   ColorizedBadge: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "ColorizedBadge presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
+  // s223-m02 (#2527 ruling 11): each trigger starts from the documented example (Canada chosen, the list closed). Tab reaches
+  // the input; typing edits the filter text; Down opens the list at the first option and Up at the last (Japan, disabled,
+  // is never reached); Home and End act on the list a key has opened; Enter picks the active option (France, after three
+  // Downs); and Escape with the list closed clears the field and emits an empty value.
+  Combobox: { "role": "combobox", "name": { "strategy": "label", "target": 'input[role="combobox"]' }, "keyboard": { "Tab": "Move focus to the named native control; an open list closes without picking", "x": "Type to filter the options by label", "ArrowDown": "Open the list and move to the next option", "ArrowUp": "Move to the previous option; with the list closed, open it at the last option", "Home": "Move to the first option of an open list", "End": "Move to the last option of an open list", "Enter": "Pick the active option and close the list", "Escape": "Close the list; with the list closed, clear the field" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "x", "effect": { "kind": "value", "value": "Canadax" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "ArrowDown", "effect": { "kind": "active-option", "value": "Australia" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "ArrowUp", "effect": { "kind": "active-option", "value": "United States" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowUp"], "key": "Home", "effect": { "kind": "active-option", "value": "Australia" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowDown"], "key": "End", "effect": { "kind": "active-option", "value": "United States" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "keys": ["ArrowDown", "ArrowDown", "ArrowDown"], "key": "Enter", "effect": { "kind": "event", "value": "fr" } }, { "trigger": "keyboard", "target": 'input[role="combobox"]', "key": "Escape", "effect": { "kind": "event", "value": "" } }] },
   CycleProgressCard: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "CycleProgressCard presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   DatePicker: { "role": "none", "name": { "strategy": "label", "target": 'input[type="date"]' }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[type="date"]', "key": "Tab", "effect": { "kind": "focus" } }] },
   DetailHeader: { "role": "none", "name": { "strategy": "heading", "target": "h1,h2,h3,h4,h5,h6" }, "keyboard": {}, "interaction": "none", "interactionReason": "DetailHeader presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
@@ -15533,6 +15783,9 @@ var componentBehaviors = {
   RoleAssignmentForm: { "role": "textbox", "name": { "strategy": "label", "target": 'input[name="assignee"]' }, "keyboard": { "Tab": "Move focus to the named native control", "x": "Edit the named control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[name="assignee"]', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[name="assignee"]', "effect": { "kind": "value", "value": "ada@example.testx" }, "key": "x" }] },
   RoleBadgeList: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "RoleBadgeList presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   SearchInput: { "role": "searchbox", "name": { "strategy": "label", "target": "input" }, "keyboard": { "Tab": "Move focus to the named native control", "Escape": "Clear the current search" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "input", "key": "Escape", "effect": { "kind": "event", "value": "" } }, { "trigger": "keyboard", "target": "input", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": 'button[aria-label="Clear search"]', "action": "click", "effect": { "kind": "event", "value": "" } }] },
+  // s223-m02 (#2527 ruling 10): the focus target is the checked radio, as Tabs names its tab; the radiogroup and its name
+  // are asserted in each framework's scenario spec. The browser owns the keys, so each is a native radio-group move.
+  SegmentedControl: { "role": "radio", "name": { "strategy": "label", "target": 'input[type="radio"]:checked' }, "keyboard": { "Tab": "Move focus to the checked option", "ArrowRight": "Check and focus the next option", "ArrowDown": "Check and focus the next option", "ArrowLeft": "Check and focus the previous option", "ArrowUp": "Check and focus the previous option" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowRight", "effect": { "kind": "event", "value": "yearly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowDown", "effect": { "kind": "event", "value": "yearly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowLeft", "effect": { "kind": "event", "value": "monthly" } }, { "trigger": "keyboard", "target": 'input[type="radio"]:checked', "key": "ArrowUp", "effect": { "kind": "event", "value": "monthly" } }, { "trigger": "pointer", "target": 'input[value="yearly"]', "effect": { "kind": "event", "value": "yearly" }, "action": "click" }] },
   Select: { "role": "combobox", "name": { "strategy": "label", "target": "select" }, "keyboard": { "Tab": "Move focus to the named native control" }, "interaction": "interactive", "event": [{ "trigger": "keyboard", "target": "select", "key": "Tab", "effect": { "kind": "focus" } }, { "trigger": "pointer", "target": "select", "effect": { "kind": "event", "value": "basic" }, "action": "select", "value": "basic" }] },
   Stack: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "Stack presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
   StatusBadge: { "role": "none", "name": { "strategy": "none", "target": ":root" }, "keyboard": {}, "interaction": "none", "interactionReason": "StatusBadge presents content and owns no focusable control or action; authored child actions remain the consumer's responsibility.", "event": [] },
@@ -15564,7 +15817,7 @@ var authoredContracts = {
     states: ["summary", "content"],
     tokenRoles: ["panel.background", "panel.border", "panel.title", "panel.subtitle"],
     accessibility: ["A real h3 heading names the panel section", "Subtitle and summary text remain visible beside the heading", "The panel is noninteractive"],
-    compatibility: "Mirrors renderAddressCollectionPanel over renderPanelSection with data-panel-type=address: title aliases title/label/heading/name (default Addresses), subtitle aliases subtitle/description/metadata, and summary/text/body/emptyMessage fill the content area only without authored children. The saved-schema directives roleField, defaultRoleField and roleParameter are consumed by codegen and left unbound, and the generic field (the addresses collection) is consumed without a binding: the HTML renderer reads no address data, so the panel presents its heading, subtitle, summary and authored children only."
+    compatibility: "Mirrors renderAddressCollectionPanel over renderPanelSection with data-panel-type=address: title aliases title/label/heading/name (default Addresses), subtitle aliases subtitle/description/metadata, and summary/text/body/emptyMessage fill the content area only without authored children. The saved-schema directives roleField, defaultRoleField and roleParameter are consumed by codegen and left unbound. The generic field (the addresses collection) lowers to summary, the record's addresses one line each (addressCollectionSummary; a generated workflow's store prints the same line), in every renderer and on a single screen as in a workflow."
   },
   AddressEditor: {
     id: "AddressEditor",
@@ -15599,17 +15852,17 @@ var authoredContracts = {
     accessibility: ["A log region named by its title, which is also a real h3 heading", "Events are an ordered list with machine-readable timestamps", "An empty timeline is named No events"],
     compatibility: "Mirrors renderAddressValidationTimeline over renderTimelineContainer with data-timeline-type=address-validation and role=log: title aliases title/label/heading/name (default Address Validation Timeline); the first array among events/validations/history supplies the events, each rendered as label, time and detail exactly as normalizeTimelineItems reads them (records use label/title/event/status/state/text/name, timestamp/datetime/time/at/createdAt/updatedAt and detail/description/reason/message/from/to; scalars render as text); no events renders the named empty item; authored children replace the list. The generic field (the addresses collection) lowers to events."
   },
-  ArchiveEvent: { "id": "ArchiveEvent", "version": "1.1.0", "props": ["title", "archivedAt", "restoredAt", "archivedBy", "reason", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied. metadataField and restorationMetadataField are consumed unbound, matching the retained renderer; metadata inspection is not claimed." },
+  ArchiveEvent: { "id": "ArchiveEvent", "version": "1.1.0", "props": ["title", "archivedAt", "restoredAt", "archivedBy", "reason", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied; with no archive or restore recorded the card renders nothing (s223-m01). metadataField and restorationMetadataField are consumed unbound, matching the retained renderer; metadata inspection is not claimed." },
   ArchivePill: {
     id: "ArchivePill",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "isArchived"],
+    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "isArchived", "hideWhenFalse"],
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
     tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["false remains visible", "archive is the badge variant"],
-    compatibility: "Mirrors renderArchivePill over renderBadgePrimitive: label/text/status/state/isArchived/value label precedence, status/state/isArchived/value status precedence, Archive fallback and archive variant. Boolean flags read Not archived / Archived while preserving their recorded status; absent flags remain absent and authored labels or children win. field binds isArchived. archivedAtField is consumed unbound because the HTML pill has no date term. Noninteractive; no archive or restore action."
+    compatibility: 'Mirrors renderArchivePill over renderBadgePrimitive: label/text/status/state/isArchived/value label precedence, status/state/isArchived/value status precedence, Archive fallback and archive variant. Boolean flags read Not archived / Archived while preserving their recorded status; absent flags remain absent and authored labels or children win. field binds isArchived. With hideWhenFalse a false flag renders nothing (s223-m01: a card shows "Archived", never the default "Not archived"); a true flag still reads Archived. archivedAtField is consumed unbound because the HTML pill has no date term. Noninteractive; no archive or restore action.'
   },
   ArchiveSummary: {
     id: "ArchiveSummary",
@@ -15747,15 +16000,15 @@ var authoredContracts = {
   CancellationBadge: {
     id: "CancellationBadge",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "cancelAtPeriodEnd", "isCancelled"],
+    props: ["label", "text", "status", "state", "value", "variant", "tone", "emphasis", "cancelAtPeriodEnd", "isCancelled", "hideWhenFalse"],
     slots: ["default"],
     events: [],
     states: ["subtle", "solid"],
     tokenRoles: ["badge.background", "badge.text"],
     accessibility: ["false remains visible", "cancellation is the badge variant"],
-    compatibility: "Mirrors renderCancellationBadge over renderBadgePrimitive: label/text/status/state/cancelAtPeriodEnd/value label precedence; status/state/cancelAtPeriodEnd/isCancelled/value status precedence; Cancellation fallback and cancellation variant. Boolean flags read No cancellation scheduled / Cancellation scheduled while preserving their recorded status; absent flags remain absent. field binds cancelAtPeriodEnd. Authored labels or children win. Noninteractive; no cancellation action."
+    compatibility: 'Mirrors renderCancellationBadge over renderBadgePrimitive: label/text/status/state/cancelAtPeriodEnd/value label precedence; status/state/cancelAtPeriodEnd/isCancelled/value status precedence; Cancellation fallback and cancellation variant. Boolean flags read No cancellation scheduled / Cancellation scheduled while preserving their recorded status; absent flags remain absent. field binds cancelAtPeriodEnd. With hideWhenFalse a false flag renders nothing (s223-m01: a card shows "Cancellation scheduled", never the default "No cancellation scheduled"); a true flag still reads Cancellation scheduled. Authored labels or children win. Noninteractive; no cancellation action.'
   },
-  CancellationEvent: { "id": "CancellationEvent", "version": "1.1.0", "props": ["title", "timestamp", "reason", "code", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Cancellation timestamp, reason and code are visible without initiating cancellation; an absent request remains an explicit empty state." },
+  CancellationEvent: { "id": "CancellationEvent", "version": "1.1.0", "props": ["title", "timestamp", "reason", "code", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Cancellation timestamp, reason and code are visible without initiating cancellation; with no request recorded the card renders nothing (s223-m01: an empty card is not content)." },
   CancellationForm: {
     id: "CancellationForm",
     version: COMPONENT_CONTRACT_VERSION,
@@ -15869,6 +16122,25 @@ var authoredContracts = {
     accessibility: ["Inherits Badge inline noninteractive status label semantics", "A visible text label always accompanies the decorative color marker", "Color is never the sole status signal"],
     compatibility: "Mirrors renderColorizedBadge over renderBadgePrimitive label/status/color aliases and default variant colorized; Badge tone and emphasis retain their shared behavior."
   },
+  // s223-m02 (#2527 ruling 11): pick one value from a list by typing to filter it, the WAI-ARIA combobox pattern with a
+  // listbox popup. One markup in React, Vue and HTML; HTML's inline script gives it the same behaviour.
+  Combobox: {
+    id: "Combobox",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["id", "label"],
+    props: ["id", "label", "options", "value", "defaultValue", "placeholder", "name", "required", "disabled", "help", "validation", "size"],
+    slots: ["label", "help", "validation"],
+    events: ["change", "update"],
+    states: ["closed", "open", "no-matches", "selected", "disabled", "invalid"],
+    tokenRoles: ["input.background", "input.border", "input.text", "input.placeholder", "input.focus", "combobox.popup", "combobox.shadow", "combobox.option", "combobox.optionActive", "combobox.check", "field.message"],
+    accessibility: [
+      "An input with role combobox controls a listbox popup and reports aria-expanded, aria-autocomplete list and, while an option is active, aria-activedescendant; focus stays in the input",
+      "The visible label names the combobox and its listbox; help and error text describe the input",
+      "The chosen option reports aria-selected and shows a check mark; a disabled option reports aria-disabled and is skipped",
+      "Down opens the list and moves, Up moves, Home and End go to the ends, Enter picks the active option, Escape closes the list and then clears the field, and Tab closes the list without picking"
+    ],
+    compatibility: 'Typing filters the options to those whose label contains the typed text, ignoring case, and opens the list; when none matches the popup says No matches, which is not an option. value (controlled) or defaultValue (uncontrolled) names the chosen option, and the input shows its label. Picking an option (Enter on the active one, or a click) emits change and update with its value and closes the list; Escape with the list closed empties the input and, when an option was chosen, emits them with an empty value. An outside click or Tab closes the list without picking, and leaving the field restores the chosen label. size is the control height: xs 24, sm 28, md 32 (default) or lg 40, as Input, Select and Button. name submits the chosen value through a hidden input. The HTML renderer writes the same markup with the list closed and appends an inline script (data-oods-runtime="combobox") that gives it the same behaviour; without the script the input still shows the chosen label. One value only: no multiple selection, async loading, created values, grouped options or virtualization.'
+  },
   CommunicationDetailPanel: { "id": "CommunicationDetailPanel", "version": "1.1.0", "props": ["title", "channels", "templates", "policies", "conversations"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "A named read-only section renders declared channel, template, delivery policy and conversation entries. A polite status announces the conversation count; it performs no delivery or network operation." },
   CycleProgressCard: {
     id: "CycleProgressCard",
@@ -15914,7 +16186,7 @@ var authoredContracts = {
     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."
+    compatibility: "The consumer owns open: the close control, Escape and a browser close request emit close, and the dialog stays open until open becomes false. modal (default true) opens it in the browser with showModal(), over a backdrop with the page behind it inert and not scrolling (the page's own overflow and padding come back exactly when it closes, by any route, or unmounts), and a click on the backdrop emits close; modal false shows it in place, which a gallery or a static page uses. Server-rendered and static HTML carry the open attribute while open, and on a static page an inline runtime script makes the close control close it. size sets the largest inline size: sm 400px, md 512px or lg 640px. The default slot is the body; the actions slot (or the actions prop) is the right-aligned footer, and the HTML renderer draws a string or { label, intent } list there as buttons."
   },
   FilterPanel: {
     id: "FilterPanel",
@@ -16044,13 +16316,13 @@ var authoredContracts = {
   OwnershipMeta: {
     id: "OwnershipMeta",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "heading", "name", "ownerType", "owner_type", "role", "ownershipRole"],
+    props: ["title", "label", "heading", "name", "ownerType", "owner_type", "role", "ownershipRole", "ownerLabel"],
     slots: ["default"],
     events: [],
     states: ["populated", "empty"],
     tokenRoles: ["meta.text", "meta.label"],
     accessibility: ["metadata has inline term labels", "role is visible text not an ARIA role"],
-    compatibility: "Mirrors renderOwnershipMeta over renderMetaInline: title/label/heading/name (default Ownership), Owner Type ownerType/owner_type, Role role/ownershipRole. Each value is an inline span with a strong term and separator; children replace the entire body including its title. ownerTypeField and roleField lower to their consumed keys. role is displayed data, never an ARIA role. Noninteractive."
+    compatibility: 'Mirrors renderOwnershipMeta over renderMetaInline: title/label/heading/name (default Ownership), Owner Type ownerType/owner_type, Role role/ownershipRole. Each value is an inline span with a strong term and separator; children replace the entire body including its title. ownerTypeField and roleField lower to their consumed keys. s223-m01: given ownerLabel (ownerIdField binds the display label of the owner reference) the body is one phrase, "Owned by <label> \xB7 <type> \xB7 <role>", or "<Type>-owned" when the reference has no name. role is displayed data, never an ARIA role. Noninteractive.'
   },
   OwnershipSummary: {
     id: "OwnershipSummary",
@@ -16273,6 +16545,19 @@ var authoredContracts = {
     accessibility: ["Native search input semantics", "Clear control has an accessible label"],
     compatibility: "Debounce and minimum-query settings preserve value updates across both targets."
   },
+  // s223-m02 (#2527 ruling 10): one choice from two to five options, shown as joined segments.
+  SegmentedControl: {
+    id: "SegmentedControl",
+    version: COMPONENT_CONTRACT_VERSION,
+    requiredProps: ["id", "label"],
+    props: ["id", "label", "options", "value", "defaultValue", "name", "size", "disabled"],
+    slots: ["label"],
+    events: ["change", "update"],
+    states: ["selected", "unselected", "disabled"],
+    tokenRoles: ["segmented.track", "segmented.selected", "segmented.ring", "segmented.text", "segmented.focus"],
+    accessibility: ["Native radio inputs in a radiogroup named by its visible label through aria-labelledby", "Each option is a radio inside its own label, so the option text names it", "The browser gives the radio-group keyboard: the arrows move and check, and Tab enters at the checked option"],
+    compatibility: "One choice from two to five options, each { value, label, disabled }, shown as joined segments in sizes xs, sm, md and lg: 24, 28, 32 and 40px, the button, input and select heights at each size. value (controlled) or defaultValue (uncontrolled) checks one option; with neither, none is checked and Tab enters at the first. name groups the radios and defaults to the id; disabled disables every option. Each change emits change and update with the chosen value. React, Vue and the HTML renderer write one markup, and the HTML needs no script: the native radios carry the keyboard. Icon-only segments and more than one selection are not part of it."
+  },
   Select: {
     id: "Select",
     version: COMPONENT_CONTRACT_VERSION_1_1,
@@ -16298,7 +16583,7 @@ var authoredContracts = {
     accessibility: ["Does not alter child semantics"],
     compatibility: "Maps saved-schema stack and inline modes to one flex primitive; patternComponent and fields are executed composition directives. Trait recipe directives authored on pattern-group Stacks are consumed by codegen: channelsField, templatesField, policiesField, conversationsField, labelField and showActor are left unbound (a layout container reads no data and the lowered StatusTimeline never governed them), while historyField and showReason travel with the lowering to the StatusTimeline whose contract governs them. Two more authoring leftovers are consumed unbound: the form composer leaves as on a Stack when it expands a heading title slot into several components, and a pattern-group Stack restates its first fields entry as a generic field; a layout container renders neither."
   },
-  StateTransitionEvent: { "id": "StateTransitionEvent", "version": "1.1.0", "props": ["title", "history", "status", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented." },
+  StateTransitionEvent: { "id": "StateTransitionEvent", "version": "1.1.0", "props": ["title", "history", "status", "showActor", "showReason"], "slots": [], "events": [], "states": ["empty", "populated"], "tokenRoles": ["surface.panel", "text.body"], "accessibility": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"], "compatibility": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented; with no history the card renders nothing (s223-m01)." },
   StatusBadge: {
     id: "StatusBadge",
     version: COMPONENT_CONTRACT_VERSION,
@@ -16378,7 +16663,7 @@ var authoredContracts = {
     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."
+    compatibility: `Shares the Checkbox field API for a setting that applies at once: checked (controlled) or defaultChecked (uncontrolled), required, disabled, help and validation, in sizes sm and md. Each toggle emits change and update with the next checked value. The HTML renderer paints the same markup and an inline runtime script turns it over on a static page (aria-checked, from a click, Space or Enter); bound to a form field it also carries the field's value, "true" or "false", in a hidden input the script keeps. Bound to a record field in a generated form, it reads and writes the field's boolean as Checkbox does.`
   },
   Table: {
     id: "Table",
@@ -16630,7 +16915,7 @@ var authoredScenarios = [
   { "id": "VizSizeControls", "oodsComponentId": "VizSizeControls", "props": { "value": { "encodings": { "size": { "field": "size", "scale": "linear" } } } }, "slots": {}, "initialState": { "encodings": { "size": { "field": "size", "scale": "linear" } } }, "renderExpectation": { "name": "change", "trigger": "append x to the first field", "expected": '{"encodings":{"size":{"field":"sizex","scale":"linear"}}}' }, "assertions": ["emitted payload is a typed public input fragment", "untouched sibling bindings are preserved", "labels name native controls"] },
   { "id": "VizSizeSummary", "oodsComponentId": "VizSizeSummary", "props": { "value": { "encodings": { "size": { "field": "size", "scale": "linear" } } } }, "slots": {}, "initialState": { "authored": true }, "renderExpectation": { "name": "render", "trigger": "mount the authored fragment or shared-renderer SVG", "expected": '{"encodings":{"size":{"field":"size","scale":"linear"}}}' }, "assertions": ["authored binding values remain readable", "no interactive chart action is implied"] },
   { "id": "ArchiveEvent", "oodsComponentId": "ArchiveEvent", "props": { "archivedAt": "2026-09-01T12:00:00Z", "restoredAt": "2026-09-02T12:00:00Z", "archivedBy": "operator-1", "reason": "Duplicate record" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Archive and restoration instants remain distinct and ordered as declared; valid dates render stable UTC time, missing dates remain disclosed. Actor and reason are visible when supplied." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
-  { "id": "CancellationEvent", "oodsComponentId": "CancellationEvent", "props": { "timestamp": "2026-09-01T12:00:00Z", "reason": "Customer request", "code": "customer_request" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Cancellation timestamp, reason and code are visible without initiating cancellation; an absent request remains an explicit empty state." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
+  { "id": "CancellationEvent", "oodsComponentId": "CancellationEvent", "props": { "timestamp": "2026-09-01T12:00:00Z", "reason": "Customer request", "code": "customer_request" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Cancellation timestamp, reason and code are visible without initiating cancellation; with no request recorded the card renders nothing." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
   { "id": "StateTransitionEvent", "oodsComponentId": "StateTransitionEvent", "props": { "history": [{ "from_state": "draft", "to_state": "active", "transitioned_at": "2026-09-01T12:00:00Z", "actor_id": "operator-1", "reason": "Approved" }] }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "Declared history order, from/to states, actor and reason remain visible; showActor/showReason suppress their respective details. No history is invented." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
   { "id": "ColorStatePicker", "oodsComponentId": "ColorStatePicker", "props": { "colorStates": ["neutral", "success"], "value": "neutral" }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "A labelled Select inside a fieldset edits only declared semantic color states and emits one string change; prop changes resynchronise local selection." }, "assertions": ["Visible text explains the declared trait values", "Every native control has a visible label"] },
   { "id": "StatusColorLegend", "oodsComponentId": "StatusColorLegend", "props": { "colorStates": ["neutral", "success"], "value": "success", "showTokenReferences": true }, "slots": {}, "initialState": {}, "renderExpectation": { "name": "render", "trigger": "mount and declared input triggers", "expected": "A named section pairs semantic color swatches with visible state names, the current state and optional token references. Meaning is never color alone." }, "assertions": ["Visible text exposes values without relying on color", "Named semantic container or noninteractive span"] },
@@ -16645,7 +16930,7 @@ var authoredScenarios = [
   { id: "address-editor-fields-and-change", oodsComponentId: "AddressEditor", props: { title: "Shipping address", street: "1 Main St", city: "Springfield", region: "IL", postalCode: "62701" }, slots: {}, initialState: { street: "1 Main St" }, renderExpectation: { name: "change", trigger: "type into the City input", expected: "change emitted with the current street/city/region/postalCode record" }, assertions: ["title is a real h2 heading", "four labelled inputs are prefilled", "change carries the whole address record", "submitting is a no-op"] },
   { id: "address-summary-badge-role", oodsComponentId: "AddressSummaryBadge", props: { label: "Billing address", role: "billing" }, slots: {}, initialState: { status: "billing" }, renderExpectation: { name: "render", trigger: "mount", expected: "visible Billing address label with data-badge-status billing and the address variant" }, assertions: ["label is visible text", "data-badge-status is billing", "data-badge-variant is address", "badge is noninteractive"] },
   { id: "address-validation-timeline-events", oodsComponentId: "AddressValidationTimeline", props: { title: "Address checks", validations: [{ label: "Postal code verified", timestamp: "2026-09-05T12:00:00Z", detail: "Matched carrier database" }, "Geocoded"] }, slots: {}, initialState: { events: 2 }, renderExpectation: { name: "render", trigger: "mount", expected: "a log region titled Address checks with two ordered events, the first timestamped and detailed" }, assertions: ["region has role log and an h2 title", "events are ordered list items", "the timestamp is a time element", "scalar entries render as text"] },
-  { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant"] },
+  { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Archived" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant", "hideWhenFalse hides only the default"] },
   { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms"] },
   { id: "archived-row-presentation", oodsComponentId: "ArchivedRowOverlay", props: { "isArchived": true, "showBadge": true, "separateTab": true, "tabLabel": "Archived", "label": "Team subscription" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "Archived row stays accessible and its badge and tab label agree" }, assertions: ["Archived row stays accessible and its badge and tab label agree"] },
   { id: "audit-event-type-and-timestamp", oodsComponentId: "AuditEvent", props: { event: "user.updated", timestamp: "2026-09-05T12:00:00Z", detail: "Display name changed" }, slots: {}, initialState: { timestamped: true }, renderExpectation: { name: "render", trigger: "mount", expected: "one audit article with a machine-readable time, the event label and the detail" }, assertions: ["article carries data-event-type audit", "time element has a datetime", "label and detail are visible text"] },
@@ -16665,7 +16950,7 @@ var authoredScenarios = [
   { id: "billing-interval-subscription", oodsComponentId: "BillingIntervalSelector", props: { interval: "monthly", intervals: ["monthly", "yearly"], label: "Billing interval" }, slots: {}, initialState: { interval: "monthly" }, renderExpectation: { name: "change", trigger: "ArrowDown from monthly", expected: "yearly selected and emitted" }, assertions: ["only the resolved object intervals are selectable", "a native select supports keyboard selection", "invalid interval is announced"] },
   { id: "billing-summary-minor-units", oodsComponentId: "BillingSummaryBadge", props: { amount: 1999, currency: "usd", minorUnits: 100, interval: "monthly" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "$19.99 \xB7 monthly" }, assertions: ["integer minor units format as a currency amount", "one visible phrase includes interval"] },
   { id: "button-activate", oodsComponentId: "Button", props: { content: "Save changes", intent: "neutral", size: "md" }, slots: { default: "Save changes" }, initialState: { disabled: false }, renderExpectation: { name: "activate", trigger: "pointer click or Enter", expected: "activation handler called once" }, assertions: ["native type defaults to button", "focus is visible"] },
-  { id: "cancellation-badge-false", oodsComponentId: "CancellationBadge", props: { "cancelAtPeriodEnd": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No cancellation scheduled remains visible; machine status remains false; cancellation is the badge variant" }, assertions: ["No cancellation scheduled remains visible; machine status remains false", "cancellation is the badge variant"] },
+  { id: "cancellation-badge-false", oodsComponentId: "CancellationBadge", props: { "cancelAtPeriodEnd": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No cancellation scheduled remains visible; machine status remains false; cancellation is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Cancellation scheduled" }, assertions: ["No cancellation scheduled remains visible; machine status remains false", "cancellation is the badge variant", "hideWhenFalse hides only the default"] },
   { id: "cancellation-form-presentational-controls", oodsComponentId: "CancellationForm", props: { "title": "Cancellation request", "reasonCode": "budget", "reason": "Costs changed" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "reason and code retain their initial values; native controls are labelled; submit does not cancel or save" }, assertions: ["reason and code retain their initial values", "native controls are labelled", "submit does not cancel or save"] },
   {
     id: "cancellation-summary-boolean",
@@ -16682,6 +16967,8 @@ var authoredScenarios = [
   // s222-m02 (#2502 ruling 11): the two components 0.4.0 adds. The dialog example is shown in place (modal false), as a
   // gallery shows it; modal true is the default.
   { id: "dialog-confirm", oodsComponentId: "Dialog", props: { id: "archive-workspace", open: true, modal: false, title: "Archive workspace", description: "Members lose access until the workspace is restored.", size: "sm" }, slots: { default: "Invoices and subscriptions stay in the archive for 30 days.", actions: ["Cancel", "Archive workspace"] }, initialState: { open: true }, renderExpectation: { name: "close", trigger: "activate the close button or press Escape", expected: "close emitted once; the dialog stays open until open becomes false" }, assertions: ["the dialog is named by its title and described by its description", "the close button is named", "the actions sit in the footer"] },
+  // s223-m02 (#2527 ruling 11): the combobox example; Japan is disabled, so the keyboard skips it and a click cannot pick it.
+  { id: "combobox-filter-and-pick", oodsComponentId: "Combobox", props: { id: "shipping-country", label: "Shipping country", value: "ca", placeholder: "Search countries", help: "Type to filter. We do not ship to Japan yet.", options: [{ value: "au", label: "Australia" }, { value: "ca", label: "Canada" }, { value: "fr", label: "France" }, { value: "de", label: "Germany" }, { value: "jp", label: "Japan", disabled: true }, { value: "mx", label: "Mexico" }, { value: "gb", label: "United Kingdom" }, { value: "us", label: "United States" }] }, slots: {}, initialState: { open: false, value: "ca" }, renderExpectation: { name: "change", trigger: "type to filter, then Down and Enter, or click an option", expected: "the picked value emitted once and the list closed" }, assertions: ["role combobox controls its listbox and reports aria-expanded", "the label names the combobox and the listbox; help describes the input", "typing filters by label and an empty result says No matches", "the chosen option reports aria-selected and shows a check mark"] },
   { id: "switch-controlled", oodsComponentId: "Switch", props: { id: "payment-alerts", label: "Payment alerts", checked: false, help: "Email the account owner when a payment fails" }, slots: {}, initialState: { checked: false }, renderExpectation: { name: "change", trigger: "click the switch or press Space or Enter", expected: "checked=true emitted once" }, assertions: ["role switch reports aria-checked", "the label names the switch", "help describes the switch"] },
   { id: "classification-badge-category", oodsComponentId: "ClassificationBadge", props: { "category": "Electronics", "mode": "strict" }, slots: {}, initialState: { "content": "populated" }, renderExpectation: { "name": "render", "trigger": "mount", "expected": "category is visible; mode is the status metadata; noninteractive badge" }, assertions: ["category is visible", "mode is the status metadata", "noninteractive badge"] },
   { id: "classification-editor-presentational-controls", oodsComponentId: "ClassificationEditor", props: { "title": "Product classification", "category": "Electronics", "tags": ["alpha", "beta"], "mode": "flexible" }, slots: {}, initialState: { "content": "populated" }, renderExpectation: { "name": "render", "trigger": "mount", "expected": "labelled native inputs retain their values; mode selection is flexible; submit does not navigate or save" }, assertions: ["labelled native inputs retain their values", "mode selection is flexible", "submit does not navigate or save"] },
@@ -16702,7 +16989,7 @@ var authoredScenarios = [
   { id: "message-event-timeline-statuses", oodsComponentId: "MessageEventTimeline", props: { heading: "Delivery", statuses: [{ status: "delivered", at: "2026-09-02T09:00:00Z" }] }, slots: {}, initialState: { events: 1 }, renderExpectation: { name: "render", trigger: "mount with statuses only", expected: "statuses supply the events when messages are absent, in the message timeline type" }, assertions: ["region has role log and an h2 title", "status doubles as the event label", "data-timeline-type is message"] },
   { id: "message-status-badge-delivery", oodsComponentId: "MessageStatusBadge", props: { delivery: "delivered" }, slots: {}, initialState: { status: "delivered" }, renderExpectation: { name: "render", trigger: "mount", expected: "delivery doubles as the visible label and the status in the message variant" }, assertions: ["label is visible text", "data-badge-status is delivered", "data-badge-variant is message", "badge is noninteractive"] },
   { id: "owner-badge-principal", oodsComponentId: "OwnerBadge", props: { "owner": "user-7", "ownerType": "person", "status": "active" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "owner identity is visible; owner is the badge variant" }, assertions: ["owner identity is visible", "owner is the badge variant"] },
-  { id: "ownership-meta-inline-terms", oodsComponentId: "OwnershipMeta", props: { "ownerType": "organization", "role": "custodian" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "metadata has inline term labels; role is visible text not an ARIA role" }, assertions: ["metadata has inline term labels", "role is visible text not an ARIA role"] },
+  { id: "ownership-meta-inline-terms", oodsComponentId: "OwnershipMeta", props: { "ownerType": "organization", "role": "custodian" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "metadata has inline term labels; role is visible text not an ARIA role; given ownerLabel one phrase names the owner" }, assertions: ["metadata has inline term labels", "role is visible text not an ARIA role", "ownerLabel reads as one phrase"] },
   { id: "ownership-summary-terms", oodsComponentId: "OwnershipSummary", props: { "ownerId": "user-7", "ownerType": "person", "role": "administrator" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "a real h2 names the description list; owner label or honest unavailability, type and role remain associated terms" }, assertions: ["a real h2 names the description list", "owner label or honest unavailability, type and role remain associated terms"] },
   {
     id: "pagination-bar-navigation",
@@ -16750,6 +17037,9 @@ var authoredScenarios = [
     renderExpectation: { name: "clear", trigger: "activate clear control", expected: "empty value emitted once" },
     assertions: ["input has search semantics", "clear control is named"]
   },
+  // s223-m02 (#2527 ruling 10): the middle option is checked, so Tab landing on it shows the group's one tab stop is the
+  // checked option, and both arrow directions have a neighbour.
+  { id: "segmented-control-billing-period", oodsComponentId: "SegmentedControl", props: { id: "billing-period", label: "Billing period", value: "quarterly", options: [{ value: "monthly", label: "Monthly" }, { value: "quarterly", label: "Quarterly" }, { value: "yearly", label: "Yearly" }] }, slots: {}, initialState: { value: "quarterly" }, renderExpectation: { name: "change", trigger: "ArrowRight or ArrowLeft from Quarterly, or click Yearly", expected: "the neighbouring value emitted once; the consumer owns value" }, assertions: ["the radiogroup is named by its visible label", "each option is a native radio named by its own label", "the checked option is the value and is the one tab stop"] },
   { id: "select-controlled", oodsComponentId: "Select", props: { id: "plan", label: "Plan", value: "pro", options: [{ value: "basic", label: "Basic" }, { value: "pro", label: "Pro" }] }, slots: {}, initialState: { value: "pro" }, renderExpectation: { name: "change", trigger: "choose Basic", expected: "basic emitted once" }, assertions: ["label targets select", "selected option is visible"] },
   { id: "stack-wrapped-row", oodsComponentId: "Stack", props: { direction: "row", gap: "sm", align: "center", wrap: true }, slots: { default: ["Primary", "Secondary"] }, initialState: { direction: "row", wrap: true }, renderExpectation: { name: "render", trigger: "resize to phone width", expected: "children wrap in DOM order" }, assertions: ["two children remain visible", "gap token is used"] },
   {
@@ -16880,7 +17170,8 @@ var STATUS_ICON_SHAPES = Object.freeze({
   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)]
+  dot: [circle("8", "8", "2.5", true)],
+  "chevron-down": [path("M4 6l4 4 4-4")]
 });
 var STATUS_ICON_SVG_ATTRS = Object.freeze({
   width: "1em",
@@ -17381,10 +17672,19 @@ function summaryValue(value) {
 function chronologicalEvents(events) {
   return events.filter((event) => Number.isFinite(Date.parse(event.at))).map((event, index) => ({ event, index })).sort((a, b) => Date.parse(a.event.at) - Date.parse(b.event.at) || a.index - b.index).map(({ event }) => event);
 }
-function formatReadOnlyValue(value, type, code = false) {
+function formatDeclaredNumber(value, format) {
+  const number = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : NaN;
+  if (!Number.isFinite(number)) return void 0;
+  return format === "percent" ? new Intl.NumberFormat("en-US", { style: "percent", maximumFractionDigits: 2 }).format(number / 100) : new Intl.NumberFormat("en-US", { maximumFractionDigits: 2 }).format(number);
+}
+function formatReadOnlyValue(value, type, code = false, format) {
   if (value == null || value === "") return "Not recorded";
   if (type === "date" || type === "datetime") return formatDateTime(value) || "Invalid date";
   if (typeof value === "boolean") return value ? "Yes" : "No";
+  if (format && !Array.isArray(value)) {
+    const formatted = formatDeclaredNumber(value, format);
+    if (formatted !== void 0) return formatted;
+  }
   if (Array.isArray(value)) {
     if (value.some((item) => item !== null && typeof item === "object")) return `${value.length} ${value.length === 1 ? "record" : "records"}`;
     return value.map((item) => summaryValue(item) ?? "").join(", ") || "None recorded";
@@ -17421,12 +17721,28 @@ function recordCollectionEvents(record2, options = {}) {
   }
   return chronologicalEvents(events);
 }
+function addressCollectionSummary(entries) {
+  const asRecord = (value) => value && typeof value === "object" ? value : {};
+  return (Array.isArray(entries) ? entries : []).map((entry) => {
+    const address = asRecord(asRecord(entry).address);
+    const street = Array.isArray(address.addressLines) ? address.addressLines.map(String).join(", ") : "";
+    return [asRecord(entry).role, street, String(address.locality ?? ""), String(address.administrativeArea ?? ""), String(address.postalCode ?? "")].filter(Boolean).join(", ");
+  }).join("; ");
+}
 var UUID_REFERENCE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function formatReferenceLabel(identifier, label, subject = "Reference") {
   if (identifier == null || identifier === "") return `${subject} unavailable`;
   if (typeof label === "string" && label.trim() && !UUID_REFERENCE.test(label.trim())) return label;
   return `${subject} reference not resolved`;
 }
+var UNRESOLVED_REFERENCE_LABEL = / (?:unavailable|reference not resolved)$/;
+function ownershipPhrase(ownerLabel, ownerType, role) {
+  const text2 = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+  const name = text2(ownerLabel) && !UNRESOLVED_REFERENCE_LABEL.test(text2(ownerLabel)) ? text2(ownerLabel) : void 0;
+  const type = text2(ownerType)?.replace(/[_-]+/g, " ");
+  const parts = name ? [`Owned by ${name}`, type, text2(role)] : type ? [`${type.charAt(0).toUpperCase()}${type.slice(1)}-owned`, text2(role)] : [];
+  return parts.filter(Boolean).join(" \xB7 ") || void 0;
+}
 function formatRecordLabel(value) {
   return typeof value === "string" && UUID_REFERENCE.test(value.trim()) ? "Record name unavailable" : String(value ?? "");
 }
@@ -17748,7 +18064,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 !== 112) errors.push(`intake must contain exactly 112 rows; received ${ids.length}`);
+  if (ids.length !== 114) errors.push(`intake must contain exactly 114 rows; received ${ids.length}`);
   const uniqueCount = new Set(ids).size;
   if (uniqueCount !== ids.length) errors.push("intake IDs must be unique");
   const sorted = [...ids].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
@@ -17791,6 +18107,7 @@ exports.VIZ_PREVIEW_TYPES = VIZ_PREVIEW_TYPES;
 exports.VIZ_SUMMARY_IDS = VIZ_SUMMARY_IDS;
 exports.VIZ_SVG_PROPS = VIZ_SVG_PROPS;
 exports.VIZ_THEME_SVG_PROPS = VIZ_THEME_SVG_PROPS;
+exports.addressCollectionSummary = addressCollectionSummary;
 exports.ariaSort = ariaSort;
 exports.assertStaticSvg = assertStaticSvg;
 exports.auditSummary = auditSummary;
@@ -17818,6 +18135,7 @@ exports.evaluateEmissionEligibility = evaluateEmissionEligibility;
 exports.evaluateFoundationV1 = evaluateFoundationV1;
 exports.formatBillingAmount = formatBillingAmount;
 exports.formatDateTime = formatDateTime;
+exports.formatDeclaredNumber = formatDeclaredNumber;
 exports.formatPriceAmount = formatPriceAmount;
 exports.formatPriceCode = formatPriceCode;
 exports.formatReadOnlyValue = formatReadOnlyValue;
@@ -17833,6 +18151,7 @@ exports.isGovernedComponent = isGovernedComponent;
 exports.isVizIntentFragment = isVizIntentFragment;
 exports.listStatuses = listStatuses;
 exports.nextSort = nextSort;
+exports.ownershipPhrase = ownershipPhrase;
 exports.parseBillingAmount = parseBillingAmount;
 exports.portedComponentContracts = portedComponentContracts;
 exports.portedScenarios = portedScenarios;