@adia-ai/web-components 0.8.41 → 0.8.43

package/custom-elements.json

@@ -137,7 +137,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Child of <action-list-ui>. One actionable row — icon + label + optional subtitle, forwards activation to the parent action-list. Row contract converges on <menu-item-ui>: icon/text/subtitle/value/variant/disabled props and icon/text/subtitle/trailing slot overrides (#1363 C5).",
+          "description": "Child of <action-list-ui>. One actionable row — icon + label + optional description, forwards activation to the parent action-list. Row contract converges on <menu-item-ui>: icon/text/description/value/variant/disabled props and icon/text/subtitle/trailing slot overrides (#1363 C5). (The deprecated `subtitle` prop alias for `description` was cut in 0.8.43 — ADR-0063, gh#1571/gh#1617.)",
           "name": "UIActionItem",
           "tagName": "action-item-ui",
           "superclass": {
@@ -160,11 +160,11 @@
               "description": "Action label."
             },
             {
-              "name": "subtitle",
+              "name": "description",
               "type": {
                 "text": "string"
               },
-              "description": "Optional secondary description line rendered under the label."
+              "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)."
             },
             {
               "name": "value",
@@ -201,7 +201,7 @@
             },
             {
               "name": "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."
             },
             {
               "name": "trailing",
@@ -1581,7 +1581,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
           "name": "UICalendarPicker",
           "tagName": "calendar-picker-ui",
           "superclass": {
@@ -1768,195 +1768,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/calendar-picker/calendar-picker.test.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "DEPRECATED (gh#1372, 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.",
-          "name": "UIDatetimePicker",
-          "tagName": "datetime-picker-ui",
-          "superclass": {
-            "name": "UIElement",
-            "module": "/core/element.js"
-          },
-          "attributes": [
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "Form field name. The ISO 8601 datetime is submitted under this key when the picker is inside a `<form>`."
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "description": "Current value as ISO 8601 datetime (\"YYYY-MM-DDTHH:mm\" or \"YYYY-MM-DDTHH:mm:ss\"). Empty when no value selected."
-            },
-            {
-              "name": "min",
-              "type": {
-                "text": "string"
-              },
-              "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."
-            },
-            {
-              "name": "max",
-              "type": {
-                "text": "string"
-              },
-              "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."
-            },
-            {
-              "name": "step",
-              "type": {
-                "text": "number"
-              },
-              "default": "60",
-              "description": "Per-Arrow-keypress increment in seconds for the time pane. 60 = minute precision (default), 900 = 15-minute, 1 = second precision."
-            },
-            {
-              "name": "precision",
-              "type": {
-                "text": "string"
-              },
-              "default": "minute",
-              "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)."
-            },
-            {
-              "name": "hour-cycle",
-              "type": {
-                "text": "string"
-              },
-              "description": "Hour cycle for the time pane. Empty (default) derives from the document locale. `h12` forces a 12-hour cycle with an AM/PM (meridiem) segment; `h23` forces 24-hour cycle."
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Block all interaction. Trigger remains rendered but does not open the popover."
-            },
-            {
-              "name": "readonly",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Block edits; allow keyboard navigation for screen-reader inspection."
-            },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Required for validation when inside a `<form>`."
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the popover is currently open."
-            },
-            {
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "default": "Select date and time",
-              "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>`)."
-            },
-            {
-              "name": "format",
-              "type": {
-                "text": "string"
-              },
-              "default": "short",
-              "description": "Trigger button date format. `short`: `Jan 1, 2026 14:30`; `long`: `January 1, 2026 14:30`; `iso`: full ISO string."
-            },
-            {
-              "name": "locale",
-              "type": {
-                "text": "string"
-              },
-              "description": "BCP-47 locale tag used to derive hour-cycle when `hour-cycle` is empty. Falls back to `<html lang>` then to browser default."
-            },
-            {
-              "name": "placement",
-              "type": {
-                "text": "string"
-              },
-              "default": "bottom",
-              "description": "Popover placement relative to the trigger. Default `bottom` centers the calendar+time panel under the trigger (ADR-0034 Rule 2 — ~600px panel >> trigger)."
-            }
-          ],
-          "slots": [
-            {
-              "name": "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)."
-            },
-            {
-              "name": "footer",
-              "description": "Optional Apply / Cancel buttons for explicit-commit flows. Spans both panes below the calendar + time area."
-            }
-          ],
-          "events": [
-            {
-              "name": "change",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when the value commits (date picked + time edited, OR Apply clicked in explicit-commit mode)."
-            },
-            {
-              "name": "input",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired during partial selection (date picked but time still pending, or vice versa)."
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Popover opened (user clicked the trigger or pressed Enter / Space)."
-            },
-            {
-              "name": "close",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Popover closed (without commit, or after commit)."
-            },
-            {
-              "name": "invalid",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "A constraint failed (out of range, parse error)."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "datetime-picker-ui",
-          "declaration": {
-            "name": "UIDatetimePicker",
-            "module": "./components/calendar-picker/calendar-picker.test.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/canvas/canvas.js",
@@ -2146,12 +1957,12 @@
               "description": "Layout hint — drives flex-direction. Actual placement follows DOM order."
             },
             {
-              "name": "static",
+              "name": "interactive",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "When set, rows are non-interactive <span>s (no click, no toggle)."
+              "default": "true",
+              "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)."
             },
             {
               "name": "on-toggle",
@@ -2174,7 +1985,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "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."
             }
           ]
         }
@@ -2228,28 +2039,28 @@
               "description": "Color scheme"
             },
             {
-              "name": "hide-average",
+              "name": "no-average",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, suppress the overlaid average line"
+              "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)."
             },
             {
-              "name": "hide-grid",
+              "name": "no-grid",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Hide gridlines"
+              "description": "Hide gridlines. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideGrid` dual-read shim was cut in 0.8.43 (gh#1617)."
             },
             {
-              "name": "hide-values",
+              "name": "no-values",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Hide value labels"
+              "description": "Hide value labels. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideValues` dual-read shim was cut in 0.8.43 (gh#1617)."
             },
             {
               "name": "corner-radius",
@@ -2846,13 +2657,13 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/color-input/color-input.js",
+      "path": "components/color-area/color-area.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "Compact form-bearing color input — opens a popover-anchored `<color-picker-ui>` from an inline swatch button. §302 (v0.5.12, FEEDBACK-29 re-bucket from v0.6.0). Canonicalizes the USAGE.md §221f Option B recipe (popover + button + color-picker) into a single form-associated tag for inline form contexts (settings drawer \"source color\" field, swatch-row inline-edit, etc.).",
-          "name": "UIColorInput",
-          "tagName": "color-input-ui",
+          "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.",
+          "name": "UIColorArea",
+          "tagName": "color-area-ui",
           "superclass": {
             "name": "UIElement",
             "module": "/core/element.js"
@@ -2863,23 +2674,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Form field name."
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "#3b82f6",
-              "description": "Current color as a string in the active [format]."
-            },
-            {
-              "name": "format",
-              "type": {
-                "text": "string"
-              },
-              "default": "hex",
-              "description": "Output format for the value property + event detail. Hex (`#rrggbb`) or OKLCH (`oklch(L C H)`)."
+              "description": "Form field name"
             },
             {
               "name": "disabled",
@@ -2887,23 +2682,23 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the trigger button + suppresses popover."
+              "description": "Disables all interaction"
             },
             {
-              "name": "placement",
+              "name": "format",
               "type": {
                 "text": "string"
               },
-              "default": "bottom",
-              "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)."
+              "default": "hex",
+              "description": "Output format for the value property"
             },
             {
-              "name": "open",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Reflects the popover's open state. Set programmatically to open/close the picker without a click."
+              "default": "#3b82f6",
+              "description": "Current color as hex string"
             },
             {
               "name": "maxChroma",
@@ -2911,7 +2706,7 @@
                 "text": "number"
               },
               "default": "Infinity",
-              "description": "Generation constraint forwarded to the inner `<color-picker-ui>` (v0.5.13 §-TBD, FB-33 §1). Clamp the OKLCH chroma channel to at most this value. Default Infinity (no constraint)."
+              "description": "Generation constraint (v0.4.9 §99h, FEEDBACK-02 OKLCH chroma channel to at most this value before commit. Out-of- bound mutations round-trip to the nearest in-bound equivalent + fire `constraint-clamp`. Default Infinity (no constraint)."
             },
             {
               "name": "maxL",
@@ -2919,7 +2714,7 @@
                 "text": "number"
               },
               "default": "1",
-              "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at most this value (0..1). Default 1."
+              "description": "Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint)."
             },
             {
               "name": "minL",
@@ -2927,7 +2722,7 @@
                 "text": "number"
               },
               "default": "0",
-              "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at least this value (0..1). Default 0."
+              "description": "Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint)."
             },
             {
               "name": "hueDriftMax",
@@ -2935,7 +2730,7 @@
                 "text": "number"
               },
               "default": "NaN",
-              "description": "Generation constraint forwarded to inner picker — maximum allowed signed-shortest-path hue deviation (degrees) from baseHue. Default NaN (no constraint)."
+              "description": "Generation constraint — maximum allowed signed-shortest-path hue deviation (degrees) from [base-hue] (or the first-committed hue if [base-hue] is unset). Default NaN (no constraint). Wrap-aware so a drift of 350 degrees resolves as -10."
             },
             {
               "name": "baseHue",
@@ -2943,7 +2738,7 @@
                 "text": "number"
               },
               "default": "NaN",
-              "description": "Reference hue (degrees) for the hueDriftMax constraint, forwarded to inner picker. Default NaN — picker falls back to its hue at first commit."
+              "description": "Reference hue (degrees) for the [hue-drift-max] constraint. Default NaN — falls back to the picker's hue at first commit so the consumer can pre-seed the picker and constrain drift from that initial value."
             }
           ],
           "events": [
@@ -2952,14 +2747,21 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the color is committed (pointerup / Enter / picker close). Bubbles from inner picker."
+              "description": "Fired on every color change"
             },
             {
               "name": "input",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired during continuous drag of the inner picker. Bubbles from inner picker."
+              "description": "Fired during continuous interaction (drag)"
+            },
+            {
+              "name": "constraint-clamp",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired immediately before `change` / `input` when one or more consumer-declared constraints (max-chroma / max-l / min-l / hue-drift-max) clamped a channel away from the user-requested value. detail.clamps is an array of axis-specific clamp records."
             }
           ]
         }
@@ -2967,23 +2769,23 @@
       "exports": [
         {
           "kind": "custom-element-definition",
-          "name": "color-input-ui",
+          "name": "color-area-ui",
           "declaration": {
-            "name": "UIColorInput",
-            "module": "./components/color-input/color-input.js"
+            "name": "UIColorArea",
+            "module": "./components/color-area/color-area.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/color-picker/color-picker.js",
+      "path": "components/color-input/color-input.js",
       "declarations": [
         {
           "kind": "class",
-          "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.",
-          "name": "UIColorPicker",
-          "tagName": "color-picker-ui",
+          "description": "Compact form-bearing color input — opens a popover-anchored `<color-area-ui>` from an inline swatch button. §302 (v0.5.12, FEEDBACK-29 re-bucket from v0.6.0). Canonicalizes the USAGE.md §221f Option B recipe (popover + button + color-area) into a single form-associated tag for inline form contexts (settings drawer \"source color\" field, swatch-row inline-edit, etc.). Composes `<color-area-ui>` (ADR-0063, gh#1563 — renamed from `<color-picker-ui>`, cut in 0.8.43, gh#1617); `color-input-ui`'s own tag/name is unaffected.",
+          "name": "UIColorInput",
+          "tagName": "color-input-ui",
           "superclass": {
             "name": "UIElement",
             "module": "/core/element.js"
@@ -2994,15 +2796,15 @@
               "type": {
                 "text": "string"
               },
-              "description": "Form field name"
+              "description": "Form field name."
             },
             {
-              "name": "disabled",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Disables all interaction"
+              "default": "#3b82f6",
+              "description": "Current color as a string in the active [format]."
             },
             {
               "name": "format",
@@ -3010,15 +2812,31 @@
                 "text": "string"
               },
               "default": "hex",
-              "description": "Output format for the value property"
+              "description": "Output format for the value property + event detail. Hex (`#rrggbb`) or OKLCH (`oklch(L C H)`)."
             },
             {
-              "name": "value",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the trigger button + suppresses popover."
+            },
+            {
+              "name": "placement",
               "type": {
                 "text": "string"
               },
-              "default": "#3b82f6",
-              "description": "Current color as hex string"
+              "default": "bottom",
+              "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)."
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Reflects the popover's open state. Set programmatically to open/close the picker without a click."
             },
             {
               "name": "maxChroma",
@@ -3026,7 +2844,7 @@
                 "text": "number"
               },
               "default": "Infinity",
-              "description": "Generation constraint (v0.4.9 §99h, FEEDBACK-02 OKLCH chroma channel to at most this value before commit. Out-of- bound mutations round-trip to the nearest in-bound equivalent + fire `constraint-clamp`. Default Infinity (no constraint)."
+              "description": "Generation constraint forwarded to the inner `<color-area-ui>` (v0.5.13 §-TBD, FB-33 §1). Clamp the OKLCH chroma channel to at most this value. Default Infinity (no constraint)."
             },
             {
               "name": "maxL",
@@ -3034,7 +2852,7 @@
                 "text": "number"
               },
               "default": "1",
-              "description": "Generation constraint — clamp OKLCH lightness to at most this value (0..1). Default 1 (no constraint)."
+              "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at most this value (0..1). Default 1."
             },
             {
               "name": "minL",
@@ -3042,7 +2860,7 @@
                 "text": "number"
               },
               "default": "0",
-              "description": "Generation constraint — clamp OKLCH lightness to at least this value (0..1). Default 0 (no constraint)."
+              "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at least this value (0..1). Default 0."
             },
             {
               "name": "hueDriftMax",
@@ -3050,7 +2868,7 @@
                 "text": "number"
               },
               "default": "NaN",
-              "description": "Generation constraint — maximum allowed signed-shortest-path hue deviation (degrees) from [base-hue] (or the first-committed hue if [base-hue] is unset). Default NaN (no constraint). Wrap-aware so a drift of 350 degrees resolves as -10."
+              "description": "Generation constraint forwarded to inner picker — maximum allowed signed-shortest-path hue deviation (degrees) from baseHue. Default NaN (no constraint)."
             },
             {
               "name": "baseHue",
@@ -3058,7 +2876,7 @@
                 "text": "number"
               },
               "default": "NaN",
-              "description": "Reference hue (degrees) for the [hue-drift-max] constraint. Default NaN — falls back to the picker's hue at first commit so the consumer can pre-seed the picker and constrain drift from that initial value."
+              "description": "Reference hue (degrees) for the hueDriftMax constraint, forwarded to inner picker. Default NaN — picker falls back to its hue at first commit."
             }
           ],
           "events": [
@@ -3067,21 +2885,14 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired on every color change"
+              "description": "Fired when the color is committed (pointerup / Enter / picker close). Bubbles from inner picker."
             },
             {
               "name": "input",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired during continuous interaction (drag)"
-            },
-            {
-              "name": "constraint-clamp",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired immediately before `change` / `input` when one or more consumer-declared constraints (max-chroma / max-l / min-l / hue-drift-max) clamped a channel away from the user-requested value. detail.clamps is an array of axis-specific clamp records."
+              "description": "Fired during continuous drag of the inner picker. Bubbles from inner picker."
             }
           ]
         }
@@ -3089,10 +2900,10 @@
       "exports": [
         {
           "kind": "custom-element-definition",
-          "name": "color-picker-ui",
+          "name": "color-input-ui",
           "declaration": {
-            "name": "UIColorPicker",
-            "module": "./components/color-picker/color-picker.js"
+            "name": "UIColorInput",
+            "module": "./components/color-input/color-input.js"
           }
         }
       ]
@@ -3792,7 +3603,7 @@
                 "text": "string"
               },
               "default": "start",
-              "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."
+              "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."
             },
             {
               "name": "items",
@@ -4514,7 +4325,7 @@
           "slots": [
             {
               "name": "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. DO 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. DO 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."
             },
             {
               "name": "trailing",
@@ -5200,7 +5011,7 @@
                 "text": "string"
               },
               "default": "text",
-              "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."
             },
             {
               "name": "required",
@@ -6153,7 +5964,7 @@
         },
         {
           "kind": "class",
-          "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.)",
           "name": "UIMenuItem",
           "tagName": "menu-item-ui",
           "superclass": {
@@ -6176,11 +5987,11 @@
               "description": "Item label text."
             },
             {
-              "name": "subtitle",
+              "name": "description",
               "type": {
                 "text": "string"
               },
-              "description": "Optional secondary description line rendered under the label."
+              "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)."
             },
             {
               "name": "value",
@@ -6217,7 +6028,7 @@
             },
             {
               "name": "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."
             },
             {
               "name": "trailing",
@@ -7337,7 +7148,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Collapsible, resizable content panel — drag-resize handle on the inner edge when [side=\"leading\"] / [side=\"trailing\"], [resizable] opt-in. Used standalone for resizable two-pane layouts, or wrapped by <editor-sidebar> / <admin-sidebar> which DELEGATE drag to the inner pane-ui rather than reimplementing it. See pane.yaml's a2ui.rules for the full composition contract.",
+          "description": "Collapsible, resizable content panel — drag-resize handle on the inner edge when [edge=\"leading\"] / [edge=\"trailing\"], [resizable] opt-in. Used standalone for resizable two-pane layouts, or wrapped by <editor-sidebar> / <admin-sidebar> which DELEGATE drag to the inner pane-ui rather than reimplementing it. See pane.yaml's a2ui.rules for the full composition contract.",
           "name": "UIPane",
           "tagName": "pane-ui",
           "superclass": {
@@ -7378,7 +7189,7 @@
               "description": "Component property: resizable."
             },
             {
-              "name": "side",
+              "name": "edge",
               "type": {
                 "text": "string"
               },
@@ -7682,81 +7493,13 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/progress-row/progress-row.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "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.",
-          "name": "UIProgressRow",
-          "tagName": "progress-row-ui",
-          "superclass": {
-            "name": "UIElement",
-            "module": "/core/element.js"
-          },
-          "attributes": [
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "description": "Left-hand label text"
-            },
-            {
-              "name": "meta",
-              "type": {
-                "text": "string"
-              },
-              "description": "Right-hand meta text (e.g. '32 GB', '4.2k / 10k')"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "number"
-              },
-              "default": "null",
-              "description": "Progress value 0-100 (null = indeterminate; legacy -1 accepted for back-compat)"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "string"
-              },
-              "default": "default",
-              "description": "Color variant for the progress fill"
-            }
-          ],
-          "slots": [
-            {
-              "name": "label",
-              "description": "Label region — control label."
-            },
-            {
-              "name": "meta",
-              "description": "Child content region for the `meta` slot."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "progress-row-ui",
-          "declaration": {
-            "name": "UIProgressRow",
-            "module": "./components/progress-row/progress-row.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/progress/progress.js",
       "declarations": [
         {
           "kind": "class",
-          "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.",
           "name": "UIProgress",
           "tagName": "progress-ui",
           "superclass": {
@@ -8658,7 +8401,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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)."
             },
             {
               "name": "allow-empty",
@@ -10147,7 +9890,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
           "name": "UITableToolbar",
           "tagName": "table-toolbar-ui",
           "superclass": {
@@ -10176,6 +9919,46 @@
               },
               "description": "Optional count badge value shown next to the title. When unset, falls back to the row count of the bound table."
             },
+            {
+              "name": "range-start",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "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."
+            },
+            {
+              "name": "range-end",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "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."
+            },
+            {
+              "name": "range-total",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "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."
+            },
+            {
+              "name": "page-size",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "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."
+            },
+            {
+              "name": "pageSizeOptions",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]",
+              "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."
+            },
             {
               "name": "no-filter",
               "type": {
@@ -10226,6 +10009,10 @@
             }
           ],
           "slots": [
+            {
+              "name": "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."
+            },
             {
               "name": "actions",
               "description": "Trailing action area — primary buttons (e.g. \"New row\") rendered after the search input."
@@ -10259,6 +10046,13 @@
                 "text": "CustomEvent"
               },
               "description": "Column visibility changed. Detail: { hiddenColumns }."
+            },
+            {
+              "name": "page-size-change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Page-size select changed. Detail: { pageSize }."
             }
           ]
         }
@@ -11600,121 +11394,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/toggle-group/toggle-group.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "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.",
-          "name": "UIToggleGroup",
-          "tagName": "toggle-group-ui",
-          "superclass": {
-            "name": "UIElement",
-            "module": "/core/element.js"
-          },
-          "attributes": [
-            {
-              "name": "single",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "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>."
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "description": "Comma-separated selected values"
-            }
-          ],
-          "slots": [
-            {
-              "name": "default",
-              "description": "Default slot — primary child content."
-            }
-          ],
-          "events": [
-            {
-              "name": "change",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when selection changes. detail: { value }"
-            }
-          ]
-        },
-        {
-          "kind": "class",
-          "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.",
-          "name": "UIToggleOption",
-          "tagName": "toggle-option-ui",
-          "superclass": {
-            "name": "UIElement",
-            "module": "/core/element.js"
-          },
-          "attributes": [
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "description": "Stable identifier matched against the parent group's `value`."
-            },
-            {
-              "name": "text",
-              "type": {
-                "text": "string"
-              },
-              "description": "Visible label text."
-            },
-            {
-              "name": "icon",
-              "type": {
-                "text": "string"
-              },
-              "description": "Optional Phosphor icon name; renders as a leading icon."
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Disabled state — blocks pointer + keyboard activation."
-            },
-            {
-              "name": "selected",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether this option is currently selected. Managed by the parent <toggle-group-ui> container (ADR-0056) — don't set directly; the group's `value` is the single source of truth. Converges onto <segment-ui>'s declared reflected-prop mechanism."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "toggle-group-ui",
-          "declaration": {
-            "name": "UIToggleGroup",
-            "module": "./components/toggle-group/toggle-group.js"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "toggle-option-ui",
-          "declaration": {
-            "name": "UIToggleOption",
-            "module": "./components/toggle-group/toggle-group.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/toggle-scheme/toggle-scheme.js",