@adia-ai/a2ui 0.8.41 → 0.8.43

package/catalog/catalog-a2ui_0_9.json

@@ -416,7 +416,7 @@
     },
     "ActionItem": {
       "title": "ActionItem",
-      "description": "Child of <action-list-ui>. One actionable row — icon + label + optional\nsubtitle, forwards activation to the parent action-list. Row contract\nconverges on <menu-item-ui>: icon/text/subtitle/value/variant/disabled\nprops and icon/text/subtitle/trailing slot overrides (#1363 C5).",
+      "description": "Child of <action-list-ui>. One actionable row — icon + label + optional\ndescription, forwards activation to the parent action-list. Row contract\nconverges on <menu-item-ui>: icon/text/description/value/variant/disabled\nprops and icon/text/subtitle/trailing slot overrides (#1363 C5). (The\ndeprecated `subtitle` prop alias for `description` was cut in 0.8.43 —\nADR-0063, gh#1571/gh#1617.)",
       "type": "object",
       "allOf": [
         {
@@ -427,6 +427,11 @@
         }
       ],
       "properties": {
+        "description": {
+          "description": "Optional secondary description line rendered under the label. Canonical spelling (ADR-0063, gh#1571) replacing `subtitle` — converges action-item onto the same spelling <menu-item-ui> adopted under gh#1563. The deprecated `subtitle` prop alias was cut in 0.8.43 (gh#1617).",
+          "type": "string",
+          "default": ""
+        },
         "component": {
           "const": "ActionItem"
         },
@@ -439,11 +444,6 @@
           "description": "Leading icon name (Phosphor).",
           "type": "string"
         },
-        "subtitle": {
-          "description": "Optional secondary description line rendered under the label.",
-          "type": "string",
-          "default": ""
-        },
         "text": {
           "description": "Action label.",
           "type": "string"
@@ -494,7 +494,7 @@
             "description": "Override the [icon] glyph with a custom slotted element (custom icon-ui, image, avatar). Mutually exclusive with the [icon] attribute — slot child wins."
           },
           "subtitle": {
-            "description": "Custom secondary-line content override; falls through to [subtitle] prop if not slotted."
+            "description": "Custom secondary-line content override; falls through to the [description] prop if not slotted (ADR-0063, gh#1571 — the deprecated [subtitle] prop alias was cut in 0.8.43, gh#1617). The slot's own name is unchanged by that rename — this is a distinct, deliberately-unrenamed surface."
           },
           "text": {
             "description": "Custom label content; falls through to [text] prop if not slotted."
@@ -1781,7 +1781,7 @@
     },
     "AdminShell": {
       "title": "AdminShell",
-      "description": "Behavior-only application shell. Canonical authoring shape uses\ncluster-namespaced bespoke children — <admin-topbar> at the top,\n<admin-sidebar slot=\"leading|trailing\"> rails, <admin-content> for\nthe main content region, <admin-command> for the Cmd+K palette, and\noptional <admin-statusbar> at the bottom. The shell wires sidebar\ntoggle forwarding, command-palette triggers, and the ResizeObserver\nthat drives responsive sidebar collapse; each bespoke child owns\nits own resize / collapse / open state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<aside data-sidebar>, <dialog\ndata-command>, [data-resize], <aside-ui slot=>, <span data-spacer>,\n<div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
+      "description": "Behavior-only application shell. Canonical authoring shape uses\ncluster-namespaced bespoke children — <admin-topbar> at the top,\n<admin-sidebar slot=\"leading|trailing\"> rails, <admin-content> for\nthe main content region, <admin-command> for the Cmd+K palette, and\noptional <admin-statusbar> at the bottom. The shell wires sidebar\ntoggle forwarding, command-palette triggers, and the ResizeObserver\nthat drives responsive sidebar collapse; each bespoke child owns\nits own resize / collapse / open state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<aside data-sidebar>, <dialog\ndata-command>, [data-sidebar-resize], <aside-ui slot=>, <span data-spacer>,\n<div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
       "type": "object",
       "allOf": [
         {
@@ -1934,7 +1934,7 @@
           "default": ""
         },
         "resizable": {
-          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-resize] element as the drag handle.\n",
+          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-sidebar-resize] element as the drag handle.\n",
           "type": "boolean",
           "default": false
         },
@@ -5124,7 +5124,7 @@
     },
     "CalendarPicker": {
       "title": "CalendarPicker",
-      "description": "Date (and, per `[precision]`, date+time) picker with trigger button and popover panel. Form-associated input emitting an ISO date (or, when `precision` is `minute`/`second`, ISO datetime) string via change events; supports min/max and disabled-date masks. Use for single-date or single-datetime input in forms; for date ranges use <date-range-picker-ui> instead of composing two calendar-picker instances. gh#1372 (#1363 C3c) folded <datetime-picker-ui>'s surface into this widened `precision` axis — see the deprecated <datetime-picker-ui> alias.",
+      "description": "Date (and, per `[precision]`, date+time) picker with trigger button and popover panel. Form-associated input emitting an ISO date (or, when `precision` is `minute`/`second`, ISO datetime) string via change events; supports min/max and disabled-date masks. Use for single-date or single-datetime input in forms; for date ranges use <date-range-picker-ui> instead of composing two calendar-picker instances. gh#1372 (#1363 C3c) folded <datetime-picker-ui>'s surface into this widened `precision` axis — that thin alias component was cut in 0.8.43 (gh#1617); this is the sole tag now.",
       "type": "object",
       "allOf": [
         {
@@ -5861,23 +5861,23 @@
           ],
           "default": "abbr"
         },
-        "hideAverage": {
-          "description": "When true, suppress the overlaid average line",
+        "loading": {
+          "description": "Show a skeleton placeholder instead of the chart body. Set to true while data is being fetched; clear once data arrives. Preserves the element's aspect-ratio dimensions so the skeleton occupies the same space the chart will fill. Parity with stat-ui[loading] and table-ui[loading] (§FB-12, v0.6.27).",
           "type": "boolean",
           "default": false
         },
-        "hideGrid": {
-          "description": "Hide gridlines",
+        "noAverage": {
+          "description": "When true, suppress the overlaid average line. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideAverage` dual-read shim was cut in 0.8.43 (gh#1617).",
           "type": "boolean",
           "default": false
         },
-        "hideValues": {
-          "description": "Hide value labels",
+        "noGrid": {
+          "description": "Hide gridlines. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideGrid` dual-read shim was cut in 0.8.43 (gh#1617).",
           "type": "boolean",
           "default": false
         },
-        "loading": {
-          "description": "Show a skeleton placeholder instead of the chart body. Set to true while data is being fetched; clear once data arrives. Preserves the element's aspect-ratio dimensions so the skeleton occupies the same space the chart will fill. Parity with stat-ui[loading] and table-ui[loading] (§FB-12, v0.6.27).",
+        "noValues": {
+          "description": "Hide value labels. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideValues` dual-read shim was cut in 0.8.43 (gh#1617).",
           "type": "boolean",
           "default": false
         },
@@ -6154,6 +6154,11 @@
           "type": "string",
           "default": ""
         },
+        "interactive": {
+          "description": "Canonical opt-in spelling (ADR-0063, gh#1563) — the deprecated `static` opt-out alias was cut in 0.8.43 (gh#1617). Rows are interactive <button>-role badges by default — this default stays `true` (deliberately NOT flipped yet; the 0.9.0 cut inverts it to `false` after a full consumer scan of every `<chart-legend-ui>` tag per the ADR).",
+          "type": "boolean",
+          "default": true
+        },
         "onToggle": {
           "description": "Series-toggle mode emitted via the `toggle` event. `hide` removes the series from the render; `opacity` fades it. Wired via [for] on chart-ui.",
           "type": "string",
@@ -6184,11 +6189,6 @@
             "dashed"
           ],
           "default": "dot"
-        },
-        "static": {
-          "description": "When set, rows are non-interactive <span>s (no click, no toggle).",
-          "type": "boolean",
-          "default": false
         }
       },
       "required": [
@@ -6204,7 +6204,7 @@
         ],
         "events": {
           "toggle": {
-            "description": "Fires on row click (non-static). Detail: {key, active, mode}. `active` is the new state (true=visible). Consumers (or chart-ui via [for]) wire this to series visibility.",
+            "description": "Fires on row click when interactive. Detail: {key, active, mode}. `active` is the new state (true=visible). Consumers (or chart-ui via [for]) wire this to series visibility.",
             "detail": {
               "active": {
                 "description": "New visibility state (true = visible).",
@@ -6261,12 +6261,8 @@
             "name": "idle"
           },
           {
-            "description": "Rows are <button>s. Default unless [static].",
+            "description": "Rows are <button>s (the default). When false, rows are <span>s — no click handler, no toggle affordance.",
             "name": "interactive"
-          },
-          {
-            "description": "Rows are <span>s. No click handler, no toggle affordance.",
-            "name": "static"
           }
         ],
         "status": "stable",
@@ -6895,7 +6891,7 @@
           "default": ""
         },
         "resizable": {
-          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-resize] element as the drag handle.\n",
+          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-sidebar-resize] element as the drag handle.\n",
           "type": "boolean",
           "default": false
         },
@@ -7668,9 +7664,155 @@
         "version": 1
       }
     },
+    "ColorArea": {
+      "title": "ColorArea",
+      "description": "OKLCH-native color picker with 2D area and H/C/L sliders. Form-associated input emitting OKLCH color strings; canonical color authoring surface in the AdiaUI token system. Use for color input in design tools or theming UIs; for simple color swatches use <swatch-ui> or <color-input-ui> instead. Renamed from `<color-picker-ui>` (ADR-0063, gh#1563 — `-picker` is reserved for the outer trigger + popover composite shape; this is the inline substrate, mirroring <calendar-grid-ui>'s naming precedent). `<color-picker-ui>` was cut in 0.8.43 (gh#1617) — this is the sole tag now.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "baseHue": {
+          "description": "Reference hue (degrees) for the [hue-drift-max] constraint. Default\nNaN — falls back to the picker's hue at first commit so the consumer\ncan pre-seed the picker and constrain drift from that initial value.\n",
+          "type": "number",
+          "default": "NaN"
+        },
+        "component": {
+          "const": "ColorArea"
+        },
+        "disabled": {
+          "description": "Disables all interaction",
+          "type": "boolean",
+          "default": false
+        },
+        "format": {
+          "description": "Output format for the value property",
+          "type": "string",
+          "enum": [
+            "hex",
+            "oklch"
+          ],
+          "default": "hex"
+        },
+        "hueDriftMax": {
+          "description": "Generation constraint — maximum allowed signed-shortest-path hue\ndeviation (degrees) from [base-hue] (or the first-committed hue\nif [base-hue] is unset). Default NaN (no constraint). Wrap-aware\nso a drift of 350 degrees resolves as -10.\n",
+          "type": "number",
+          "default": "NaN"
+        },
+        "maxChroma": {
+          "description": "Generation constraint (v0.4.9 §99h, FEEDBACK-02 #7) — clamp the\nOKLCH chroma channel to at most this value before commit. Out-of-\nbound mutations round-trip to the nearest in-bound equivalent +\nfire `constraint-clamp`. Default Infinity (no constraint).\n",
+          "type": "number",
+          "default": "Infinity"
+        },
+        "maxL": {
+          "description": "Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint).",
+          "type": "number",
+          "default": 1
+        },
+        "minL": {
+          "description": "Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint).",
+          "type": "number",
+          "default": 0
+        },
+        "name": {
+          "description": "Form field name",
+          "type": "string",
+          "default": ""
+        },
+        "value": {
+          "description": "Current color as hex string",
+          "type": "string",
+          "default": "#3b82f6"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "input",
+        "composes": [
+          "slider-ui"
+        ],
+        "events": {
+          "change": {
+            "description": "Fired on every color change"
+          },
+          "constraint-clamp": {
+            "description": "Fired immediately before `change` / `input` when one or more\nconsumer-declared constraints (max-chroma / max-l / min-l /\nhue-drift-max) clamped a channel away from the user-requested\nvalue. detail.clamps is an array of axis-specific clamp records.\n",
+            "detail": {
+              "clamps": {
+                "description": "Array of `{ axis, requested, clamped, reason }` objects. axis is\none of \"l\" / \"c\" / \"h\". reason names the triggering constraint\nprop. Empty arrays are never emitted.\n",
+                "type": "array"
+              }
+            }
+          },
+          "input": {
+            "description": "Fired during continuous interaction (drag)"
+          }
+        },
+        "examples": [
+          {
+            "description": "Color picker card with a color picker component for selecting colors with swatches.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"cp\"\n    ]\n  },\n  {\n    \"id\": \"cp\",\n    \"component\": \"ColorArea\",\n    \"value\": \"#6366f1\"\n  }\n]",
+            "name": "color-area-demo"
+          },
+          {
+            "description": "Color picker with swatch selection in a card.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"cp\"\n    ]\n  },\n  {\n    \"id\": \"cp\",\n    \"component\": \"ColorArea\",\n    \"value\": \"#3b82f6\"\n  }\n]",
+            "name": "color-area-panel"
+          }
+        ],
+        "keywords": [
+          "colorarea",
+          "color-area",
+          "colorpicker",
+          "color-picker",
+          "color",
+          "picker"
+        ],
+        "name": "UIColorArea",
+        "parts": {},
+        "related": [
+          "grid",
+          "button"
+        ],
+        "slots": {},
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "Non-interactive; dimmed.",
+            "attribute": "disabled",
+            "name": "disabled"
+          }
+        ],
+        "status": "stable",
+        "synonyms": {
+          "color-area": [
+            "color-canvas",
+            "color-surface",
+            "swatch-picker",
+            "color-picker"
+          ]
+        },
+        "tag": "color-area-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ColorInput": {
       "title": "ColorInput",
-      "description": "Compact form-bearing color input — opens a popover-anchored\n`<color-picker-ui>` from an inline swatch button. §302 (v0.5.12,\nFEEDBACK-29 re-bucket from v0.6.0). Canonicalizes the USAGE.md §221f\nOption B recipe (popover + button + color-picker) into a single\nform-associated tag for inline form contexts (settings drawer \"source\ncolor\" field, swatch-row inline-edit, etc.).",
+      "description": "Compact form-bearing color input — opens a popover-anchored\n`<color-area-ui>` from an inline swatch button. §302 (v0.5.12,\nFEEDBACK-29 re-bucket from v0.6.0). Canonicalizes the USAGE.md §221f\nOption B recipe (popover + button + color-area) into a single\nform-associated tag for inline form contexts (settings drawer \"source\ncolor\" field, swatch-row inline-edit, etc.). Composes `<color-area-ui>`\n(ADR-0063, gh#1563 — renamed from `<color-picker-ui>`, cut in 0.8.43,\ngh#1617); `color-input-ui`'s own tag/name is unaffected.",
       "type": "object",
       "allOf": [
         {
@@ -7709,7 +7851,7 @@
           "default": "NaN"
         },
         "maxChroma": {
-          "description": "Generation constraint forwarded to the inner `<color-picker-ui>` (v0.5.13\n§-TBD, FB-33 §1). Clamp the OKLCH chroma channel to at most this value.\nDefault Infinity (no constraint).\n",
+          "description": "Generation constraint forwarded to the inner `<color-area-ui>` (v0.5.13\n§-TBD, FB-33 §1). Clamp the OKLCH chroma channel to at most this value.\nDefault Infinity (no constraint).\n",
           "type": "number",
           "default": "Infinity"
         },
@@ -7734,7 +7876,7 @@
           "default": false
         },
         "placement": {
-          "description": "Popover placement relative to the trigger. Default `bottom` centers the color-picker panel under the swatch button (ADR-0034 Rule 2 — panel wider than trigger).",
+          "description": "Popover placement relative to the trigger. Default `bottom` centers the color-area panel under the swatch button (ADR-0034 Rule 2 — panel wider than trigger).",
           "type": "string",
           "enum": [
             "top",
@@ -7764,7 +7906,7 @@
         "composes": [
           "button-ui",
           "popover-ui",
-          "color-picker-ui"
+          "color-area-ui"
         ],
         "events": {
           "change": {
@@ -7845,7 +7987,7 @@
         "name": "UIColorInput",
         "parts": {},
         "related": [
-          "color-picker",
+          "color-area",
           "popover",
           "button",
           "swatch"
@@ -7886,9 +8028,9 @@
         "version": 1
       }
     },
-    "ColorPicker": {
-      "title": "ColorPicker",
-      "description": "OKLCH-native color picker with 2D area and H/C/L sliders. Form-associated input emitting OKLCH color strings; canonical color authoring surface in the AdiaUI token system. Use for color input in design tools or theming UIs; for simple color swatches use <swatch-ui> or <color-input-ui> instead.",
+    "Combobox": {
+      "title": "Combobox",
+      "description": "Typeahead-filterable single-select primitive — the constrained-choice\ncombobox per WAI-APG \"Combobox With List Autocomplete (manual\nselection)\". The committed value MUST come from the options list\nunless `[free-text]` is set. Distinct from `<select-ui searchable>`\n(button-first dropdown) and `<autocomplete-input-ui>` (free-form).\nForm-bearing via UIFormElement: `[name]`, `[value]`, `[required]`,\n`[disabled]`, fires `change`. Options via native `<option>` /\n`<optgroup>` children OR programmatic `.options` array.\n",
       "type": "object",
       "allOf": [
         {
@@ -7899,238 +8041,95 @@
         }
       ],
       "properties": {
-        "baseHue": {
-          "description": "Reference hue (degrees) for the [hue-drift-max] constraint. Default\nNaN — falls back to the picker's hue at first commit so the consumer\ncan pre-seed the picker and constrain drift from that initial value.\n",
-          "type": "number",
-          "default": "NaN"
+        "required": {
+          "description": "Marks the field as required for form validation",
+          "type": "boolean",
+          "default": false
+        },
+        "clearable": {
+          "description": "Renders an `x` clear button when value is set",
+          "type": "boolean",
+          "default": false
         },
         "component": {
-          "const": "ColorPicker"
+          "const": "Combobox"
+        },
+        "creatable": {
+          "description": "Implies `[free-text]`; on Enter with unmatched typed text fires a\n`create` event with detail.value so the consumer can run a\nbackend create-then-refresh-options flow.",
+          "type": "boolean",
+          "default": false
         },
         "disabled": {
-          "description": "Disables all interaction",
+          "description": "Disables interaction and dims the control",
           "type": "boolean",
           "default": false
         },
-        "format": {
-          "description": "Output format for the value property",
+        "error": {
+          "description": "Validation error message",
+          "type": "string",
+          "default": ""
+        },
+        "filter-mode": {
+          "description": "Client-side filter algorithm.",
           "type": "string",
           "enum": [
-            "hex",
-            "oklch"
+            "substring",
+            "prefix",
+            "fuzzy"
           ],
-          "default": "hex"
+          "default": "substring"
         },
-        "hueDriftMax": {
-          "description": "Generation constraint — maximum allowed signed-shortest-path hue\ndeviation (degrees) from [base-hue] (or the first-committed hue\nif [base-hue] is unset). Default NaN (no constraint). Wrap-aware\nso a drift of 350 degrees resolves as -10.\n",
-          "type": "number",
-          "default": "NaN"
+        "free-text": {
+          "description": "Allow typed text not in the options list. Blurs the distinction\nwith <autocomplete-input-ui>; prefer the dedicated primitive\nunless the value model truly needs both modes (tag-with-suggestions,\nemail-with-recent-recipients).",
+          "type": "boolean",
+          "default": false
         },
-        "maxChroma": {
-          "description": "Generation constraint (v0.4.9 §99h, FEEDBACK-02 #7) — clamp the\nOKLCH chroma channel to at most this value before commit. Out-of-\nbound mutations round-trip to the nearest in-bound equivalent +\nfire `constraint-clamp`. Default Infinity (no constraint).\n",
-          "type": "number",
-          "default": "Infinity"
+        "highlight-match": {
+          "description": "Wraps the matched substring in `<mark>` inside option labels",
+          "type": "boolean",
+          "default": true
         },
-        "maxL": {
-          "description": "Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint).",
+        "hint": {
+          "description": "Caption text below the field; wires `aria-describedby` on the host\nso screen readers announce it as a description.",
+          "type": "string",
+          "default": ""
+        },
+        "label": {
+          "description": "Inline label rendered above the field. Wrap with <field-ui> for\nproper `<label for>` association in form-row compositions.",
+          "type": "string",
+          "default": ""
+        },
+        "loading": {
+          "description": "Shows a loading spinner inside the popover; consumer drives async fetch",
+          "type": "boolean",
+          "default": false
+        },
+        "max-options": {
+          "description": "Cap on rendered options. Overflow shows a \"scroll for more\" hint",
           "type": "number",
-          "default": 1
+          "default": 100
         },
-        "minL": {
-          "description": "Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint).",
+        "max-visible-items": {
+          "description": "How many option rows are visible before the listbox scrolls — the menu height hugs N rows instead of growing to the 18rem fallback. Distinct from max-options (the render cap). 0 disables.",
           "type": "number",
-          "default": 0
+          "default": 10
         },
         "name": {
-          "description": "Form field name",
+          "description": "Form control name for form data submission",
           "type": "string",
           "default": ""
         },
-        "value": {
-          "description": "Current color as hex string",
-          "type": "string",
-          "default": "#3b82f6"
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "anti_patterns": [],
-        "category": "input",
-        "composes": [
-          "slider-ui"
-        ],
-        "events": {
-          "change": {
-            "description": "Fired on every color change"
-          },
-          "constraint-clamp": {
-            "description": "Fired immediately before `change` / `input` when one or more\nconsumer-declared constraints (max-chroma / max-l / min-l /\nhue-drift-max) clamped a channel away from the user-requested\nvalue. detail.clamps is an array of axis-specific clamp records.\n",
-            "detail": {
-              "clamps": {
-                "description": "Array of `{ axis, requested, clamped, reason }` objects. axis is\none of \"l\" / \"c\" / \"h\". reason names the triggering constraint\nprop. Empty arrays are never emitted.\n",
-                "type": "array"
-              }
-            }
-          },
-          "input": {
-            "description": "Fired during continuous interaction (drag)"
-          }
-        },
-        "examples": [
-          {
-            "description": "Color picker card with a color picker component for selecting colors with swatches.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"cp\"\n    ]\n  },\n  {\n    \"id\": \"cp\",\n    \"component\": \"ColorPicker\",\n    \"value\": \"#6366f1\"\n  }\n]",
-            "name": "color-picker-demo"
-          },
-          {
-            "description": "Color picker with swatch selection in a card.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"cp\"\n    ]\n  },\n  {\n    \"id\": \"cp\",\n    \"component\": \"ColorPicker\",\n    \"value\": \"#3b82f6\"\n  }\n]",
-            "name": "color-picker-panel"
-          }
-        ],
-        "keywords": [
-          "colorpicker",
-          "color-picker",
-          "color",
-          "picker"
-        ],
-        "name": "UIColorPicker",
-        "parts": {},
-        "related": [
-          "grid",
-          "button"
-        ],
-        "slots": {},
-        "states": [
-          {
-            "description": "Default, ready for interaction.",
-            "name": "idle"
-          },
-          {
-            "description": "Non-interactive; dimmed.",
-            "attribute": "disabled",
-            "name": "disabled"
-          }
-        ],
-        "status": "stable",
-        "synonyms": {
-          "color-picker": [
-            "color-canvas",
-            "color-surface",
-            "swatch-picker"
-          ]
-        },
-        "tag": "color-picker-ui",
-        "tokens": {},
-        "traits": [],
-        "version": 1
-      }
-    },
-    "Combobox": {
-      "title": "Combobox",
-      "description": "Typeahead-filterable single-select primitive — the constrained-choice\ncombobox per WAI-APG \"Combobox With List Autocomplete (manual\nselection)\". The committed value MUST come from the options list\nunless `[free-text]` is set. Distinct from `<select-ui searchable>`\n(button-first dropdown) and `<autocomplete-input-ui>` (free-form).\nForm-bearing via UIFormElement: `[name]`, `[value]`, `[required]`,\n`[disabled]`, fires `change`. Options via native `<option>` /\n`<optgroup>` children OR programmatic `.options` array.\n",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "required": {
-          "description": "Marks the field as required for form validation",
-          "type": "boolean",
-          "default": false
-        },
-        "clearable": {
-          "description": "Renders an `x` clear button when value is set",
-          "type": "boolean",
-          "default": false
-        },
-        "component": {
-          "const": "Combobox"
-        },
-        "creatable": {
-          "description": "Implies `[free-text]`; on Enter with unmatched typed text fires a\n`create` event with detail.value so the consumer can run a\nbackend create-then-refresh-options flow.",
-          "type": "boolean",
-          "default": false
-        },
-        "disabled": {
-          "description": "Disables interaction and dims the control",
-          "type": "boolean",
-          "default": false
-        },
-        "error": {
-          "description": "Validation error message",
-          "type": "string",
-          "default": ""
-        },
-        "filter-mode": {
-          "description": "Client-side filter algorithm.",
-          "type": "string",
-          "enum": [
-            "substring",
-            "prefix",
-            "fuzzy"
-          ],
-          "default": "substring"
-        },
-        "free-text": {
-          "description": "Allow typed text not in the options list. Blurs the distinction\nwith <autocomplete-input-ui>; prefer the dedicated primitive\nunless the value model truly needs both modes (tag-with-suggestions,\nemail-with-recent-recipients).",
-          "type": "boolean",
-          "default": false
-        },
-        "highlight-match": {
-          "description": "Wraps the matched substring in `<mark>` inside option labels",
-          "type": "boolean",
-          "default": true
-        },
-        "hint": {
-          "description": "Caption text below the field; wires `aria-describedby` on the host\nso screen readers announce it as a description.",
-          "type": "string",
-          "default": ""
-        },
-        "label": {
-          "description": "Inline label rendered above the field. Wrap with <field-ui> for\nproper `<label for>` association in form-row compositions.",
-          "type": "string",
-          "default": ""
-        },
-        "loading": {
-          "description": "Shows a loading spinner inside the popover; consumer drives async fetch",
-          "type": "boolean",
-          "default": false
-        },
-        "max-options": {
-          "description": "Cap on rendered options. Overflow shows a \"scroll for more\" hint",
-          "type": "number",
-          "default": 100
-        },
-        "max-visible-items": {
-          "description": "How many option rows are visible before the listbox scrolls — the menu height hugs N rows instead of growing to the 18rem fallback. Distinct from max-options (the render cap). 0 disables.",
-          "type": "number",
-          "default": 10
-        },
-        "name": {
-          "description": "Form control name for form data submission",
-          "type": "string",
-          "default": ""
-        },
-        "open": {
-          "description": "Reflects popover open / closed state",
-          "type": "boolean",
-          "default": false
-        },
-        "options": {
-          "description": "Programmatic option list. Array of {value, label, disabled?, group?} or grouped {label, options:[…]}. Alternative to declarative <option> / <optgroup> children.",
-          "$ref": "#/$defs/DynamicObjectList"
-        },
-        "placeholder": {
-          "description": "Placeholder text in the input when value is empty",
+        "open": {
+          "description": "Reflects popover open / closed state",
+          "type": "boolean",
+          "default": false
+        },
+        "options": {
+          "description": "Programmatic option list. Array of {value, label, disabled?, group?} or grouped {label, options:[…]}. Alternative to declarative <option> / <optgroup> children.",
+          "$ref": "#/$defs/DynamicObjectList"
+        },
+        "placeholder": {
+          "description": "Placeholder text in the input when value is empty",
           "type": "string",
           "default": "Select..."
         },
@@ -9810,260 +9809,6 @@
         "version": 1
       }
     },
-    "DatetimePicker": {
-      "title": "DatetimePicker",
-      "description": "DEPRECATED (gh#1372, #1363 C3c) — folded into <calendar-picker-ui>'s widened `precision` axis. `<datetime-picker-ui>` is now a thin `UICalendarPicker` subclass (see datetime-picker.class.js) rather than an independent implementation: `precision` defaults to `\"minute\"` (not `\"date\"`) and `placeholder` defaults to `\"Select date and time\"`; every other prop/event/token is inherited unchanged from <calendar-picker-ui>. Existing markup keeps working, but new markup should reach for `<calendar-picker-ui precision=\"minute\">` (or `precision=\"second\"`) directly. See <calendar-picker-ui> for the full contract.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "required": {
-          "description": "Required for validation when inside a `<form>`.",
-          "type": "boolean",
-          "default": false
-        },
-        "component": {
-          "const": "DatetimePicker"
-        },
-        "disabled": {
-          "description": "Block all interaction. Trigger remains rendered but does not open the popover.",
-          "type": "boolean",
-          "default": false
-        },
-        "format": {
-          "description": "Trigger button date format. `short`: `Jan 1, 2026 14:30`; `long`: `January 1, 2026 14:30`; `iso`: full ISO string.",
-          "type": "string",
-          "enum": [
-            "short",
-            "long",
-            "iso"
-          ],
-          "default": "short"
-        },
-        "hourcycle": {
-          "description": "Hour cycle for the time pane. Empty (default) derives from the\ndocument locale. `h12` forces a 12-hour cycle with an AM/PM\n(meridiem) segment; `h23` forces 24-hour cycle.\n",
-          "type": "string",
-          "enum": [
-            "",
-            "h12",
-            "h23"
-          ],
-          "default": ""
-        },
-        "locale": {
-          "description": "BCP-47 locale tag used to derive hour-cycle when `hour-cycle` is empty. Falls back to `<html lang>` then to browser default.",
-          "type": "string",
-          "default": ""
-        },
-        "max": {
-          "description": "Latest selectable ISO 8601 datetime (inclusive). Days after are disabled in the calendar pane; times after are rejected by the time pane on the same day.",
-          "type": "string",
-          "default": ""
-        },
-        "min": {
-          "description": "Earliest selectable ISO 8601 datetime (inclusive). Days before are disabled in the calendar pane; times before are rejected by the time pane on the same day.",
-          "type": "string",
-          "default": ""
-        },
-        "name": {
-          "description": "Form field name. The ISO 8601 datetime is submitted under this key when the picker is inside a `<form>`.",
-          "type": "string",
-          "default": ""
-        },
-        "open": {
-          "description": "Whether the popover is currently open.",
-          "type": "boolean",
-          "default": false
-        },
-        "placeholder": {
-          "description": "Text shown in the trigger when the value is empty. Defaults to \"Select date and time\" HERE (vs. \"Select date...\" on the base `<calendar-picker-ui>`).",
-          "type": "string",
-          "default": "Select date and time"
-        },
-        "placement": {
-          "description": "Popover placement relative to the trigger. Default `bottom` centers the calendar+time panel under the trigger (ADR-0034 Rule 2 — ~600px panel >> trigger).",
-          "type": "string",
-          "enum": [
-            "top",
-            "bottom",
-            "left",
-            "right",
-            "top-start",
-            "top-end",
-            "bottom-start",
-            "bottom-end"
-          ],
-          "default": "bottom"
-        },
-        "precision": {
-          "description": "Time-pane precision. `minute` (default HERE — `date` on the base `<calendar-picker-ui>`) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`; `date` drops the time pane entirely (identical to the base class's own default).",
-          "type": "string",
-          "enum": [
-            "date",
-            "minute",
-            "second"
-          ],
-          "default": "minute"
-        },
-        "readonly": {
-          "description": "Block edits; allow keyboard navigation for screen-reader inspection.",
-          "type": "boolean",
-          "default": false
-        },
-        "step": {
-          "description": "Per-Arrow-keypress increment in seconds for the time pane. 60 = minute precision (default), 900 = 15-minute, 1 = second precision.",
-          "type": "number",
-          "default": 60
-        },
-        "value": {
-          "description": "Current value as ISO 8601 datetime (\"YYYY-MM-DDTHH:mm\" or \"YYYY-MM-DDTHH:mm:ss\"). Empty when no value selected.",
-          "$ref": "#/$defs/DynamicString"
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "anti_patterns": [
-          {
-            "fix": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24T00:00\"}\n",
-            "why": "`value` is a date-only string — no time component. The contract requires\na full ISO 8601 datetime including the `T` and time segment.\n",
-            "wrong": "{\"component\": \"DatetimePicker\", \"value\": \"2026-05-24\"}\n"
-          },
-          {
-            "fix": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\", \"name\": \"appointment\"}\n",
-            "why": "DatetimePicker is deprecated (gh#1372) — new generation should reach\nfor CalendarPicker's widened precision axis instead.\n",
-            "wrong": "{\"component\": \"DatetimePicker\", \"name\": \"appointment\"}\n"
-          }
-        ],
-        "category": "input",
-        "composes": [
-          "calendar-grid-ui",
-          "time-picker-ui",
-          "divider-ui"
-        ],
-        "events": {
-          "change": {
-            "description": "Fired when the value commits (date picked + time edited, OR Apply clicked in explicit-commit mode).",
-            "detail": {
-              "value": "string"
-            }
-          },
-          "close": {
-            "description": "Popover closed (without commit, or after commit).",
-            "detail": {
-              "reason": "string"
-            }
-          },
-          "input": {
-            "description": "Fired during partial selection (date picked but time still pending, or vice versa).",
-            "detail": {
-              "value": "string"
-            }
-          },
-          "invalid": {
-            "description": "A constraint failed (out of range, parse error).",
-            "detail": {
-              "reason": "string",
-              "value": "string"
-            }
-          },
-          "open": {
-            "description": "Popover opened (user clicked the trigger or pressed Enter / Space).",
-            "detail": {
-              "trigger": "string"
-            }
-          }
-        },
-        "examples": [
-          {
-            "description": "Form-field-wrapped picker with min/max bounds. Prefer the CalendarPicker[precision] form for NEW markup — see calendar-picker-ui's own \"datetime-picker\" example.",
-            "a2ui": "[\n  {\n    \"id\": \"field\",\n    \"component\": \"Field\",\n    \"label\": \"Appointment\",\n    \"children\": [\"dt\"]\n  },\n  {\n    \"id\": \"dt\",\n    \"component\": \"DatetimePicker\",\n    \"name\": \"appointment\",\n    \"min\": \"2026-01-01T00:00\",\n    \"max\": \"2026-12-31T23:59\"\n  }\n]\n",
-            "name": "canonical"
-          }
-        ],
-        "keywords": [
-          "datetimepicker",
-          "datetime-picker",
-          "datetime",
-          "date-time",
-          "dateandtime",
-          "appointment",
-          "schedule",
-          "timestamp"
-        ],
-        "name": "UIDatetimePicker",
-        "parts": {},
-        "related": [
-          "calendar-picker",
-          "time-picker",
-          "date-range-picker",
-          "popover",
-          "field",
-          "button"
-        ],
-        "slots": {
-          "footer": {
-            "description": "Optional Apply / Cancel buttons for explicit-commit flows. Spans both panes below the calendar + time area."
-          },
-          "trigger": {
-            "description": "Custom trigger replacement. When omitted, a default trigger is stamped (a plain clickable span, per the base `<calendar-picker-ui>` — NOT the old standalone datetime-picker's `<button-ui>` trigger; see the Consequences note below)."
-          }
-        },
-        "states": [
-          {
-            "description": "Closed, no pending selection.",
-            "name": "idle"
-          },
-          {
-            "description": "Popover open.",
-            "attribute": "open",
-            "name": "open"
-          },
-          {
-            "description": "Non-interactive; dimmed.",
-            "attribute": "disabled",
-            "name": "disabled"
-          },
-          {
-            "description": "Read-only; trigger keyboard-focusable but popover does not open.",
-            "attribute": "readonly",
-            "name": "readonly"
-          }
-        ],
-        "status": "deprecated",
-        "synonyms": {
-          "appointment": [
-            "datetime",
-            "meeting",
-            "schedule"
-          ],
-          "datetime": [
-            "date-time",
-            "timestamp",
-            "appointment",
-            "schedule"
-          ],
-          "tags": [
-            "DateTimePicker",
-            "DateTimeInput",
-            "DatetimeInput",
-            "Timestamp"
-          ]
-        },
-        "tag": "datetime-picker-ui",
-        "tokens": {},
-        "traits": [],
-        "version": 2
-      }
-    },
     "DemoToggle": {
       "title": "DemoToggle",
       "description": "Side-by-side comparison primitive — header bar with a switch + two child slots (\"on\" / \"off\"); toggling the switch swaps which slot is visible. Used on trait detail pages to show \"with trait\" vs \"without trait\" on the same chrome. data-mode=\"overlay\" stacks the slots on the same coordinates so layout never shifts.",
@@ -10235,7 +9980,7 @@
           "$ref": "#/$defs/DynamicStringList"
         },
         "align": {
-          "description": "Alignment for inline layout. `start` (default): term and value pack to the term column edge. `between`: term left, value right-aligned with `text-align: end`. `stretch`: value fills the remaining track width (e.g. for a `<slider-ui>` / `<select-ui>` / `<color-picker-ui>` as `<dd>` that should span the full row). Sets `justify-self: stretch` and `width: 100%` on `dd` so block-level form controls inside reach the column edge rather than shrink-wrapping to content.\n",
+          "description": "Alignment for inline layout. `start` (default): term and value pack to the term column edge. `between`: term left, value right-aligned with `text-align: end`. `stretch`: value fills the remaining track width (e.g. for a `<slider-ui>` / `<select-ui>` / `<color-area-ui>` as `<dd>` that should span the full row). Sets `justify-self: stretch` and `width: 100%` on `dd` so block-level form controls inside reach the column edge rather than shrink-wrapping to content.\n",
           "type": "string",
           "enum": [
             "start",
@@ -11057,6 +10802,9 @@
           "--drilldown-row-px": {
             "description": "Inline padding of each row."
           },
+          "--drilldown-row-py": {
+            "description": "Block padding of each row (grows a row past --drilldown-row-height once content, e.g. a two-line label+meta row, exceeds it)."
+          },
           "--drilldown-row-radius": {
             "description": "Border radius of each row."
           }
@@ -12321,7 +12069,7 @@
         ],
         "slots": {
           "default": {
-            "description": "The form control — a WIDE control like input-ui, select-ui, textarea-ui, slider-ui, range-ui, calendar-picker-ui, color-picker-ui, upload-ui, otp-input-ui. Auto-id'd for the label's [for] binding.\nDO NOT wrap small self-labeling widgets here. check-ui, switch-ui, radio-ui, toggle-ui all carry their own [label] attribute that renders inline next to the control — wrapping them in field-ui produces broken layouts (settings-row `justify-self: end` rule pushes the control to the trailing edge, away from the label that field-ui stamps; the widget's own label then renders again on the right, creating a doubled / right-justified affordance). See anti_patterns below for the canonical alternatives."
+            "description": "The form control — a WIDE control like input-ui, select-ui, textarea-ui, slider-ui, range-ui, calendar-picker-ui, color-area-ui, upload-ui, otp-input-ui. Auto-id'd for the label's [for] binding.\nDO NOT wrap small self-labeling widgets here. check-ui, switch-ui, radio-ui, toggle-ui all carry their own [label] attribute that renders inline next to the control — wrapping them in field-ui produces broken layouts (settings-row `justify-self: end` rule pushes the control to the trailing edge, away from the label that field-ui stamps; the widget's own label then renders again on the right, creating a doubled / right-justified affordance). See anti_patterns below for the canonical alternatives."
           },
           "action": {
             "description": "Button adjacent to the control for inline actions (clear, reset, help popover)."
@@ -13988,7 +13736,7 @@
       ],
       "properties": {
         "type": {
-          "description": "Input type. `password` wraps a native `<input>` for disc masking; `number` renders a contenteditable + stepper buttons (no native input). `text`/`email`/`tel`/`url` use plain contenteditable. input-ui does NOT implement date/time/color/search affordances — those HTML5 type values render as a plain contenteditable with no calendar, clock, swatch, or search affordance (first-pass-VALID against this enum historically, but functionally broken generation output). Use the owning primitive instead — CalendarPicker for date (+ month/week, no dedicated granularity primitive exists), DatetimePicker for datetime-local, TimePicker for time, ColorInput/ColorPicker for color, Search for search. See anti_patterns.",
+          "description": "Input type. `password` wraps a native `<input>` for disc masking; `number` renders a contenteditable + stepper buttons (no native input). `text`/`email`/`tel`/`url` use plain contenteditable. input-ui does NOT implement date/time/color/search affordances — those HTML5 type values render as a plain contenteditable with no calendar, clock, swatch, or search affordance (first-pass-VALID against this enum historically, but functionally broken generation output). Use the owning primitive instead — CalendarPicker for date (+ month/week, no dedicated granularity primitive exists), CalendarPicker precision=\"minute\" for datetime-local, TimePicker for time, ColorInput/ColorArea for color, Search for search. See anti_patterns.",
           "type": "string",
           "enum": [
             "text",
@@ -14139,8 +13887,8 @@
             "wrong": "{\"component\": \"Input\", \"type\": \"date\"}\n"
           },
           {
-            "fix": "{\"component\": \"DatetimePicker\"}\n",
-            "why": "Same gap as \"date\" — no native datetime picker rendered. Use\nDatetimePicker for combined date + time input.\n",
+            "fix": "{\"component\": \"CalendarPicker\", \"precision\": \"minute\"}\n",
+            "why": "Same gap as \"date\" — no native datetime picker rendered. Use\nCalendarPicker with precision=\"minute\" for combined date + time\ninput (DatetimePicker was a deprecated thin alias, cut in 0.8.43,\ngh#1617 — CalendarPicker is the sole tag now).\n",
             "wrong": "{\"component\": \"Input\", \"type\": \"datetime-local\"}\n"
           },
           {
@@ -14160,7 +13908,7 @@
           },
           {
             "fix": "{\"component\": \"ColorInput\"}\n",
-            "why": "No native color swatch/picker rendered — just a plain text\nsurface. Use ColorInput for a compact form-bearing swatch +\npopover, or ColorPicker directly for the full OKLCH picker\nsurface.\n",
+            "why": "No native color swatch/picker rendered — just a plain text\nsurface. Use ColorInput for a compact form-bearing swatch +\npopover, or ColorArea directly for the full OKLCH picker surface\n(ColorPicker was a deprecated thin alias, cut in 0.8.43, gh#1617 —\nColorArea is the sole tag now).\n",
             "wrong": "{\"component\": \"Input\", \"type\": \"color\"}\n"
           },
           {
@@ -16873,7 +16621,7 @@
     },
     "MenuItem": {
       "title": "MenuItem",
-      "description": "Child of `<menu-ui>`. One actionable row inside a menu, with optional leading icon + label + subtitle + value.",
+      "description": "Child of `<menu-ui>`. One actionable row inside a menu, with optional leading icon + label + description + value. (The deprecated `subtitle` prop alias for `description` was cut in 0.8.43 — ADR-0063, gh#1563/gh#1617.)",
       "type": "object",
       "allOf": [
         {
@@ -16884,6 +16632,11 @@
         }
       ],
       "properties": {
+        "description": {
+          "description": "Optional secondary description line rendered under the label. Canonical spelling (ADR-0063, gh#1563) replacing `subtitle` — converges menu-item onto the ~20-component corpus majority that already names this concept `description`. The deprecated `subtitle` prop alias was cut in 0.8.43 (gh#1617).",
+          "type": "string",
+          "default": ""
+        },
         "component": {
           "const": "MenuItem"
         },
@@ -16897,11 +16650,6 @@
           "type": "string",
           "default": ""
         },
-        "subtitle": {
-          "description": "Optional secondary description line rendered under the label.",
-          "type": "string",
-          "default": ""
-        },
         "text": {
           "description": "Item label text.",
           "type": "string",
@@ -16952,7 +16700,7 @@
             "description": "Custom leading element override; falls through to `[icon]` prop if not slotted."
           },
           "subtitle": {
-            "description": "Custom secondary-line content override; falls through to `[subtitle]` prop if not slotted."
+            "description": "Custom secondary-line content override; falls through to the `[description]` prop if not slotted (ADR-0063, gh#1563 — the deprecated `[subtitle]` prop alias was cut in 0.8.43, gh#1617). The slot's own name is unchanged by that rename — this is a distinct, deliberately-unrenamed surface."
           },
           "text": {
             "description": "Custom label content; falls through to `[text]` prop if not slotted."
@@ -19129,7 +18877,7 @@
     },
     "Pane": {
       "title": "Pane",
-      "description": "Collapsible, resizable content panel — drag-resize handle on the\ninner edge when [side=\"leading\"] / [side=\"trailing\"], [resizable]\nopt-in. Used standalone for resizable two-pane layouts, or wrapped\nby <editor-sidebar> / <admin-sidebar> which DELEGATE drag to the\ninner pane-ui rather than reimplementing it. See pane.yaml's\na2ui.rules for the full composition contract.\n",
+      "description": "Collapsible, resizable content panel — drag-resize handle on the\ninner edge when [edge=\"leading\"] / [edge=\"trailing\"], [resizable]\nopt-in. Used standalone for resizable two-pane layouts, or wrapped\nby <editor-sidebar> / <admin-sidebar> which DELEGATE drag to the\ninner pane-ui rather than reimplementing it. See pane.yaml's\na2ui.rules for the full composition contract.\n",
       "type": "object",
       "allOf": [
         {
@@ -19148,6 +18896,16 @@
         "component": {
           "const": "Pane"
         },
+        "edge": {
+          "description": "Opts a pane into horizontal-sibling chrome: suppresses the default\nfour-sided border and moves the resize grabber to the inner edge\n(right edge for `leading`, left edge for `trailing`). Also flips the\nresize-drag direction so `trailing` panes grow when dragged leftward.\nUnset keeps the pane-intrinsic chrome (full border, right-edge\ngrabber when resizable). Canonical spelling (ADR-0063, gh#1563) — the\ndeprecated `side` dual-read alias was cut in 0.8.43 (gh#1617).\n",
+          "type": "string",
+          "enum": [
+            "",
+            "leading",
+            "trailing"
+          ],
+          "default": ""
+        },
         "maxWidth": {
           "description": "Component property: maxWidth.",
           "type": "number",
@@ -19162,16 +18920,6 @@
           "description": "Component property: resizable.",
           "type": "boolean",
           "default": false
-        },
-        "side": {
-          "description": "Opts a pane into horizontal-sibling chrome: suppresses the default\nfour-sided border and moves the resize grabber to the inner edge\n(right edge for `leading`, left edge for `trailing`). Also flips the\nresize-drag direction so `trailing` panes grow when dragged leftward.\nUnset keeps the pane-intrinsic chrome (full border, right-edge\ngrabber when resizable).\n",
-          "type": "string",
-          "enum": [
-            "",
-            "leading",
-            "trailing"
-          ],
-          "default": ""
         }
       },
       "required": [
@@ -20726,7 +20474,7 @@
     },
     "Progress": {
       "title": "Progress",
-      "description": "Linear progress bar indicator. Value < 0 marks indeterminate state showing animated activity instead of a fill. Bar-only — for circular loading indicators use <spinner-ui> instead (the former `variant=\"spinner\"` render mode was retired; spinner-ui owns circular). Set `label` for a labeled task-list row (label + bar + optional `meta` text in one row, e.g. storage quotas, capacity breakdowns) — absorbed <progress-row-ui>'s row layout directly; that component is now a deprecated alias. Omit `label` for a standalone bar (global loading indicators); for percent-complete inline displays use <stat-ui> instead.",
+      "description": "Linear progress bar indicator. Value < 0 marks indeterminate state showing animated activity instead of a fill. Bar-only — for circular loading indicators use <spinner-ui> instead (the former `variant=\"spinner\"` render mode was retired; spinner-ui owns circular). Set `label` for a labeled task-list row (label + bar + optional `meta` text in one row, e.g. storage quotas, capacity breakdowns) — absorbed <progress-row-ui>'s row layout directly; that component was cut in 0.8.43 (gh#1617). Omit `label` for a standalone bar (global loading indicators); for percent-complete inline displays use <stat-ui> instead.",
       "type": "object",
       "allOf": [
         {
@@ -20902,138 +20650,33 @@
             "progress",
             "tracker"
           ],
-          "tags": [
-            "LoadingIndicator"
-          ],
-          "timeline": [
-            "social",
-            "post",
-            "activity",
-            "team",
-            "progress"
-          ],
-          "wizard": [
-            "wizard",
-            "step",
-            "progress",
-            "tracker",
-            "onboarding"
-          ],
-          "workflow": [
-            "kanban",
-            "board",
-            "project",
-            "wizard",
-            "progress",
-            "step"
-          ]
-        },
-        "tag": "progress-ui",
-        "tokens": {},
-        "traits": [],
-        "version": 1
-      }
-    },
-    "ProgressRow": {
-      "title": "ProgressRow",
-      "description": "DEPRECATED (gh#1363 C4) — absorbed into <progress-ui>: set `label` (and optional `meta`) directly on <progress-ui> instead, which activates the identical row layout in place. progress-row-ui keeps working (still composes <progress-ui> internally, unchanged behavior) for existing back-compat markup, but is no longer taught or generated for new work. Was: inline labeled progress row with label, progress bar, and meta text — storage quotas, capacity breakdowns, usage indicators.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "component": {
-          "const": "ProgressRow"
-        },
-        "label": {
-          "description": "Left-hand label text",
-          "type": "string",
-          "default": ""
-        },
-        "meta": {
-          "description": "Right-hand meta text (e.g. '32 GB', '4.2k / 10k')",
-          "type": "string",
-          "default": ""
-        },
-        "value": {
-          "description": "Progress value 0-100 (null = indeterminate; legacy -1 accepted for back-compat)",
-          "type": [
-            "number",
-            "null"
-          ],
-          "default": null
-        },
-        "variant": {
-          "description": "Color variant for the progress fill",
-          "type": "string",
-          "enum": [
-            "default",
-            "success",
-            "warning",
-            "danger"
+          "tags": [
+            "LoadingIndicator"
           ],
-          "default": "default"
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "anti_patterns": [
-          {
-            "fix": "{\"component\": \"Progress\", \"label\": \"CPU\", \"value\": 92}\n",
-            "why": "ProgressRow is deprecated — its row layout was absorbed\ninto Progress directly.\n",
-            "wrong": "{\"component\": \"ProgressRow\", \"label\": \"CPU\", \"value\": 92}\n"
-          }
-        ],
-        "category": "feedback",
-        "composes": [
-          "progress-ui"
-        ],
-        "events": {},
-        "examples": [],
-        "keywords": [
-          "progressrow",
-          "progress-row",
-          "progress",
-          "row"
-        ],
-        "name": "UIProgressRow",
-        "parts": {},
-        "related": [
-          "Progress",
-          "StepProgress",
-          "List"
-        ],
-        "slots": {
-          "label": {
-            "description": "Label region — control label."
-          },
-          "meta": {
-            "description": "Child content region for the `meta` slot."
-          }
-        },
-        "states": [
-          {
-            "description": "Default, ready for interaction.",
-            "name": "idle"
-          }
-        ],
-        "status": "deprecated",
-        "synonyms": {
-          "progress-row": [
-            "task-row",
-            "progress-line",
-            "labeled-progress"
+          "timeline": [
+            "social",
+            "post",
+            "activity",
+            "team",
+            "progress"
+          ],
+          "wizard": [
+            "wizard",
+            "step",
+            "progress",
+            "tracker",
+            "onboarding"
+          ],
+          "workflow": [
+            "kanban",
+            "board",
+            "project",
+            "wizard",
+            "progress",
+            "step"
           ]
         },
-        "tag": "progress-row-ui",
+        "tag": "progress-ui",
         "tokens": {},
         "traits": [],
         "version": 1
@@ -22515,8 +22158,7 @@
         "name": "UISegment",
         "parts": {},
         "related": [
-          "segmented-control",
-          "ToggleOption"
+          "segmented-control"
         ],
         "slots": {},
         "states": [
@@ -22571,7 +22213,7 @@
           "const": "Segmented"
         },
         "multiple": {
-          "description": "Enables multi-select — value becomes a comma-separated set, the sliding indicator is suppressed (each selected segment carries its own background instead), and Space/Enter toggles a focused segment instead of arrow-move selecting it. Positive polarity, matching select-ui[multiple]. Absorbs the role of the deprecated <toggle-group-ui> + <toggle-option-ui> pair (gh#1369, #1363 C1). Unlike <toggle-group-ui single>, re-clicking an already-selected segment does NOT clear the selection — segmented-ui's single-select is standard radiogroup semantics (always exactly one selected once a value is set).",
+          "description": "Enables multi-select — value becomes a comma-separated set, the sliding indicator is suppressed (each selected segment carries its own background instead), and Space/Enter toggles a focused segment instead of arrow-move selecting it. Positive polarity, matching select-ui[multiple]. Absorbs the role of the <toggle-group-ui> + <toggle-option-ui> pair (gh#1369, #1363 C1) — those components were cut in 0.8.43 (gh#1617). Unlike the former <toggle-group-ui single>, re-clicking an already-selected segment does NOT clear the selection — segmented-ui's single-select is standard radiogroup semantics (always exactly one selected once a value is set).",
           "type": "boolean",
           "default": false
         },
@@ -22630,8 +22272,6 @@
         },
         "related": [
           "Segment",
-          "ToggleGroup",
-          "ToggleOption",
           "Tabs",
           "Radio"
         ],
@@ -26031,7 +25671,7 @@
     },
     "TableToolbar": {
       "title": "TableToolbar",
-      "description": "Header / companion bar for a sibling table-ui. Renders title + count badge, filter / sort / columns popovers, and a search input — all wired to the target table via an [for] id-ref. Modeled on chart-legend-ui's [for] binding pattern. Drop next to (or above) any table-ui to add the standard data-grid toolbar without re-implementing search, filter, sort, or column visibility. Filter rows auto-pick a primitive per column: ≤ 50 distinct values → multi- select (searchable when ≥ 12 options), id-like keys → free-text contains. The column descriptor's `filter` field overrides the auto-detect: `'select'` forces multi-select even on high-cardinality columns; `'text'` forces a contains input even on small enums.",
+      "description": "Header / companion bar for a sibling table-ui. Renders an optional leading [slot=\"scope\"] region, title + count badge, an optional \"Showing X–Y of N\" range summary, filter / sort / columns popovers, a search input, an optional page-size select, and a trailing [slot=\"actions\"] region — all wired to the target table via an [for] id-ref. Modeled on chart-legend-ui's [for] binding pattern. Drop next to (or above) any table-ui to add the standard data-grid toolbar without re-implementing search, filter, sort, column visibility, or pagination summary/page-size. Filter rows auto-pick a primitive per column: ≤ 50 distinct values → multi-select (searchable when ≥ 12 options), id-like keys → free-text contains. The column descriptor's `filter` field overrides the auto-detect: `'select'` forces multi-select even on high-cardinality columns; `'text'` forces a contains input even on small enums.",
       "type": "object",
       "allOf": [
         {
@@ -26075,11 +25715,35 @@
           "type": "boolean",
           "default": false
         },
+        "pageSize": {
+          "description": "Current rows-per-page value, shown as the selected option in the page-size select. Falls back to the first entry of pageSizeOptions when unset (0) or not present among the options. Applied directly to the bound table's own [paginate] prop (rows-per-page), the same way filter/sort/columns changes are applied to the target — mirror this prop only to reflect state to URL / persistence / analytics.",
+          "type": "number",
+          "default": 0
+        },
+        "pageSizeOptions": {
+          "description": "Rows-per-page choices rendered as `<option>`s in the page-size select (e.g. `[10, 25, 50, 100]`). JS property (`.pageSizeOptions = [...]`), or a declarative JSON-array `page-size-options=\"[10,25,50]\"` attribute hydrated once at connect — the same dynamic-array pattern table-ui's own `columns`/`data` props use. Empty (the default) hides the page-size select entirely — additive opt-in, no footprint on existing consumers.",
+          "$ref": "#/$defs/DynamicStringList"
+        },
         "placeholder": {
           "description": "Placeholder text for the search input.",
           "type": "string",
           "default": "Search..."
         },
+        "rangeEnd": {
+          "description": "1-indexed last row number of the current page, for the range summary (e.g. `25` in \"Showing 1–25 of 320\"). See rangeStart.",
+          "type": "number",
+          "default": 0
+        },
+        "rangeStart": {
+          "description": "1-indexed first row number of the current page, for the \"Showing X–Y of N\" range summary (e.g. `1` in \"Showing 1–25 of 320\"). Renders alongside — never in place of — [text]/[count]; the range summary is its own cluster, independent of the title cluster. All three of rangeStart/rangeEnd/rangeTotal must be set (> 0) for the summary to render; omit all three (the default) to opt out entirely.",
+          "type": "number",
+          "default": 0
+        },
+        "rangeTotal": {
+          "description": "Total row count across all pages, for the range summary (e.g. `320` in \"Showing 1–25 of 320\"). Distinct from pagination-ui's `total` (total PAGES) — this is total ROWS; deliberately not spelled `total` to avoid that cross-sibling name collision (ADR-0063 B5). See rangeStart.",
+          "type": "number",
+          "default": 0
+        },
         "text": {
           "description": "Title text shown on the left.",
           "type": "string",
@@ -26121,6 +25785,9 @@
           "filter-change": {
             "description": "Filter set changed. Detail: { filters }."
           },
+          "page-size-change": {
+            "description": "Page-size select changed. Detail: { pageSize }."
+          },
           "search": {
             "description": "Debounced search query change. Detail: { value }."
           },
@@ -26133,6 +25800,11 @@
             "description": "Members table with filter/sort/columns/search wired to a sibling table-ui.",
             "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Column\", \"gap\": \"3\", \"children\": [\"bar\", \"card\"]},\n  {\"id\": \"bar\", \"component\": \"TableToolbar\", \"for\": \"members\", \"text\": \"All Employees\", \"count\": \"32\"},\n  {\"id\": \"card\", \"component\": \"Card\", \"children\": [\"sec\"]},\n  {\"id\": \"sec\", \"component\": \"Section\", \"bleed\": true, \"children\": [\"tbl\"]},\n  {\"id\": \"tbl\", \"component\": \"Table\", \"id\": \"members\", \"sortable\": true, \"raw\": true}\n]",
             "name": "members-toolbar"
+          },
+          {
+            "description": "The ratified adiav2 list-page toolbar row (ADIA2-9123): scope menu, range summary, filter/columns triggers, page-size select, and a primary CTA — search and sort dropped per that contract.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Column\", \"gap\": \"3\", \"children\": [\"bar\", \"card\"]},\n  {\"id\": \"bar\", \"component\": \"TableToolbar\", \"for\": \"accounts\", \"no-sort\": true, \"no-search\": true, \"range-start\": 1, \"range-end\": 25, \"range-total\": 320, \"page-size\": 25, \"page-size-options\": [10, 25, 50, 100]},\n  {\"id\": \"card\", \"component\": \"Card\", \"children\": [\"sec\"]},\n  {\"id\": \"sec\", \"component\": \"Section\", \"bleed\": true, \"children\": [\"tbl\"]},\n  {\"id\": \"tbl\", \"component\": \"Table\", \"id\": \"accounts\", \"sortable\": true, \"raw\": true}\n]",
+            "name": "adiav2-list-page-toolbar-row"
           }
         ],
         "keywords": [
@@ -26161,6 +25833,9 @@
         "slots": {
           "actions": {
             "description": "Trailing action area — primary buttons (e.g. \"New row\") rendered after the search input."
+          },
+          "scope": {
+            "description": "Leading region rendered BEFORE the [text]/[count] title cluster — e.g. a scope/view-switcher menu (an org's teams, a saved view). Positioning is CSS by DOM order, mirroring how [slot=\"actions\"] is a real, author-fillable insertion point rather than template-stamped content."
           }
         },
         "states": [
@@ -26212,6 +25887,12 @@
           "--table-toolbar-radius": {
             "description": "Toolbar corner radius (variant=card)"
           },
+          "--table-toolbar-summary-fg": {
+            "description": "Range-summary (\"Showing X–Y of N\") text color"
+          },
+          "--table-toolbar-summary-size": {
+            "description": "Range-summary font size"
+          },
           "--table-toolbar-title-fg": {
             "description": "Title text color"
           },
@@ -28210,236 +27891,6 @@
         "version": 1
       }
     },
-    "ToggleGroup": {
-      "title": "ToggleGroup",
-      "description": "DEPRECATED (gh#1369) — use <segmented-ui multiple> + <segment-ui> instead. Multi-select button group (unlike <segmented-ui> which is single-select by default). Hosts <toggle-option-ui> children, each independently toggleable; emits change events with the active value set.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "component": {
-          "const": "ToggleGroup"
-        },
-        "single": {
-          "description": "When true, restrict to one active option (single-select) — clicking the already-selected option again CLEARS it (empty value), unlike a native radiogroup. Migration (gh#1369): [single]=true maps to plain <segmented-ui> (no [multiple]) — note segmented-ui's single-select never clears on re-click, it's standard radiogroup semantics; the default (false, multi-select) maps to <segmented-ui multiple>.",
-          "type": "boolean",
-          "default": false
-        },
-        "value": {
-          "description": "Comma-separated selected values",
-          "type": "string",
-          "default": ""
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "allowedChildren": [
-          "ToggleOption"
-        ],
-        "anti_patterns": [],
-        "category": "navigation",
-        "composes": [],
-        "events": {
-          "change": {
-            "description": "Fired when selection changes. detail: { value }",
-            "detail": {
-              "value": {
-                "description": "New toggle-group value.",
-                "type": "string"
-              }
-            }
-          }
-        },
-        "examples": [
-          {
-            "description": "Basic ToggleGroup usage",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"ToggleGroup\",\n    \"value\": \"\"\n  }\n]",
-            "name": "basic-toggle-group"
-          }
-        ],
-        "keywords": [
-          "togglegroup",
-          "toggle-group",
-          "toggle",
-          "group"
-        ],
-        "name": "UIToggleGroup",
-        "parts": {},
-        "related": [
-          "ToggleOption",
-          "Segmented",
-          "Radio"
-        ],
-        "slots": {
-          "default": {
-            "description": "Default slot — primary child content."
-          }
-        },
-        "states": [
-          {
-            "description": "Default, ready for interaction.",
-            "name": "idle"
-          }
-        ],
-        "status": "deprecated",
-        "synonyms": {
-          "toggle-group": [
-            "segmented-control",
-            "option-group",
-            "toggle-set"
-          ]
-        },
-        "tag": "toggle-group-ui",
-        "tokens": {
-          "--toggle-group-border": {
-            "description": "Border color of the group container"
-          },
-          "--toggle-group-height": {
-            "description": "Height of the group container"
-          },
-          "--toggle-group-radius": {
-            "description": "Border radius of the group container"
-          },
-          "--toggle-option-bg-hover": {
-            "description": "Background color on hover"
-          },
-          "--toggle-option-border": {
-            "description": "Border color between adjacent options"
-          },
-          "--toggle-option-duration": {
-            "description": "Transition duration"
-          },
-          "--toggle-option-easing": {
-            "description": "Transition easing function"
-          },
-          "--toggle-option-fg": {
-            "description": "Default text color"
-          },
-          "--toggle-option-fg-disabled": {
-            "description": "Text color when disabled"
-          },
-          "--toggle-option-fg-hover": {
-            "description": "Text color on hover"
-          },
-          "--toggle-option-focus-ring": {
-            "description": "Focus ring box-shadow"
-          },
-          "--toggle-option-font-size": {
-            "description": "Font size for option text and icons"
-          },
-          "--toggle-option-gap": {
-            "description": "Gap between icon and text within an option"
-          },
-          "--toggle-option-height": {
-            "description": "Min-height of each option"
-          },
-          "--toggle-option-px": {
-            "description": "Horizontal padding of each option"
-          },
-          "--toggle-option-selected-bg": {
-            "description": "Background color when selected"
-          },
-          "--toggle-option-selected-fg": {
-            "description": "Text color when selected"
-          }
-        },
-        "traits": [],
-        "version": 1
-      }
-    },
-    "ToggleOption": {
-      "title": "ToggleOption",
-      "description": "DEPRECATED (gh#1369) — use `<segment-ui>` inside `<segmented-ui multiple>` instead. Child of `<toggle-group-ui>`. One toggleable option inside a single-select or multi-select group. Pressed state mirrors `value` against the parent's selection.",
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/$defs/ComponentCommon"
-        },
-        {
-          "$ref": "#/$defs/CatalogComponentCommon"
-        }
-      ],
-      "properties": {
-        "component": {
-          "const": "ToggleOption"
-        },
-        "disabled": {
-          "description": "Disabled state — blocks pointer + keyboard activation.",
-          "type": "boolean",
-          "default": false
-        },
-        "icon": {
-          "description": "Optional Phosphor icon name; renders as a leading icon.",
-          "type": "string",
-          "default": ""
-        },
-        "selected": {
-          "description": "Whether this option is currently selected. Managed by the parent\n<toggle-group-ui> container (ADR-0056) — don't set directly; the group's\n`value` is the single source of truth. Converges onto <segment-ui>'s\ndeclared reflected-prop mechanism.",
-          "type": "boolean",
-          "default": false
-        },
-        "text": {
-          "description": "Visible label text.",
-          "type": "string",
-          "default": ""
-        },
-        "value": {
-          "description": "Stable identifier matched against the parent group's `value`.",
-          "type": "string",
-          "default": ""
-        }
-      },
-      "required": [
-        "component"
-      ],
-      "unevaluatedProperties": false,
-      "x-adiaui": {
-        "allowedParents": [
-          "ToggleGroup"
-        ],
-        "anti_patterns": [],
-        "category": "form",
-        "composes": [],
-        "events": {},
-        "examples": [],
-        "keywords": [
-          "toggle-option",
-          "toggle-segment",
-          "option-toggle",
-          "segmented-option"
-        ],
-        "name": "UIToggleOption",
-        "parts": {},
-        "related": [
-          "ToggleGroup",
-          "Segment",
-          "Radio"
-        ],
-        "slots": {},
-        "states": [],
-        "status": "deprecated",
-        "synonyms": {
-          "toggle-option": [
-            "toggle-segment",
-            "option-button",
-            "segmented-option"
-          ]
-        },
-        "tag": "toggle-option-ui",
-        "tokens": {},
-        "traits": [],
-        "version": 1
-      }
-    },
     "ToggleScheme": {
       "title": "ToggleScheme",
       "description": "Icon-button primitive that toggles `color-scheme` between light and dark on a target element (default `:root`). Encapsulates the prefers-color-scheme initial-resolution, the inline-style write to the target, optional localStorage persistence (sharing the `adia-theme-` namespace with <theme-panel>), and the moon/sun icon swap. Replaces the hand-wired `<button-ui id=\"theme-toggle\">` + `applyScheme()` pattern previously duplicated across apps/genui, apps/construct-canvas, playgrounds/chat.",