@adia-ai/web-components 0.8.41 → 0.8.43

package/components/pane/pane.yaml

@@ -7,7 +7,7 @@ category: layout
 version: 1
 description: |
   Collapsible, resizable content panel — drag-resize handle on the
-  inner edge when [side="leading"] / [side="trailing"], [resizable]
+  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
@@ -35,7 +35,7 @@ props:
     description: 'Component property: resizable.'
     type: boolean
     default: false
-  side:
+  edge:
     description: 'Opts a pane into horizontal-sibling chrome: suppresses the default
 
       four-sided border and moves the resize grabber to the inner edge
@@ -46,7 +46,9 @@ props:
 
       Unset keeps the pane-intrinsic chrome (full border, right-edge
 
-      grabber when resizable).
+      grabber when resizable). Canonical spelling (ADR-0063, gh#1563) — the
+
+      deprecated `side` dual-read alias was cut in 0.8.43 (gh#1617).
 
       '
     type: string
@@ -82,10 +84,10 @@ a2ui:
   rules:
     - >-
       pane-ui is a resizable / collapsible content panel. As a standalone
-      primitive (no [side] attribute), it carries its own four-sided
+      primitive (no [edge] attribute), it carries its own four-sided
       chrome and a right-edge resize grabber. As a horizontal-sibling
-      child of a layout container (set [side="leading"] or
-      [side="trailing"]), the chrome and grabber move to the inner
+      child of a layout container (set [edge="leading"] or
+      [edge="trailing"]), the chrome and grabber move to the inner
       edge so adjacent panes share a single seam.
     - >-
       Wrapped by <editor-sidebar slot="leading|trailing"> inside
@@ -101,7 +103,7 @@ a2ui:
       navigator tree, inspector form rows, or other primary content.
     - >-
       For a standalone resizable two-pane layout (no shell), nest panes
-      directly inside a flex row — both with [side]-typed chrome —
+      directly inside a flex row — both with [edge]-typed chrome —
       and the resize handle will live on the seam between them. For
       a non-resizable summary pane (a fixed-width detail rail), drop
       [resizable] and pane-ui collapses to a static container.

package/components/progress/progress.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/Progress.json",
   "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": [
     {

package/components/progress/progress.class.js

@@ -23,8 +23,8 @@
  * (Legacy `value="-1"` is still treated as indeterminate for back-compat.)
  *
  * `label` (non-empty) activates the labeled row layout — label + bar +
- * optional `meta` text in one row (absorbed from the now-deprecated
- * <progress-row-ui>, gh#1363 C4). Omit `label` for a plain standalone bar.
+ * optional `meta` text in one row (absorbed from <progress-row-ui>,
+ * gh#1363 C4, cut in 0.8.43, gh#1617). Omit `label` for a plain standalone bar.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/progress/progress.d.ts

@@ -1,5 +1,5 @@
 /**
- * `<progress-ui>` — 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.
+ * `<progress-ui>` — 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.
  *
  * @see https://ui-kit.exe.xyz/site/components/progress
  *

package/components/progress/progress.yaml

@@ -12,8 +12,8 @@ description: >-
   `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
+  <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.
 props:
   value:

package/components/radio/radio.css

@@ -14,6 +14,12 @@ radio-ui[checked] [slot="dot"] {
   background: var(--radio-bg-checked);
   border-color: var(--radio-border-checked);
 }
+/* gh#1596 — a checked dot kept its full primary fill when disabled; higher
+   specificity (2 attrs) than the rule above wins without reordering. */
+radio-ui[checked][disabled] [slot="dot"] {
+  background: var(--radio-bg-checked-disabled);
+  border-color: var(--radio-bg-checked-disabled);
+}
 radio-ui[checked] [slot="dot"]::after {
   width: calc(var(--radio-size) * 0.6);
   height: calc(var(--radio-size) * 0.6);
@@ -40,6 +46,7 @@ radio-ui[checked] [slot="dot"]::after {
 
     /* ── State: disabled ── */
     --radio-fg-disabled:      var(--a-ui-text-disabled);
+    --radio-bg-checked-disabled: var(--a-ui-bg-disabled);
 
     /* ── State: focus ── */
     --radio-focus-ring:       var(--a-focus-ring);

package/components/search/search.css

@@ -18,7 +18,16 @@
     pointer-events: none;
   }
 
-  [slot="suffix"] {
+  /* input-ui's suffix slot is decorative-only by default (input.css's own
+     @scope (input-ui) sets pointer-events: none on [slot="prefix"|"suffix"]).
+     search-ui repurposes it as the clickable clear (x-circle) affordance, so
+     it must opt back into pointer events. A same-specificity `[slot="suffix"]`
+     here loses to input.css's rule on scoping proximity — @scope(input-ui) is
+     the CLOSER scope root to the suffix span than @scope(search-ui), and
+     proximity is only a tiebreak AFTER specificity. Add `input-ui` to the
+     selector so specificity itself decides the override (gh#1593). */
+  input-ui [slot="suffix"] {
+    pointer-events: auto;
     transition: opacity var(--search-duration) var(--search-easing);
   }
 

package/components/segment/segment.a2ui.json

@@ -90,8 +90,7 @@
     "name": "UISegment",
     "parts": {},
     "related": [
-      "segmented-control",
-      "ToggleOption"
+      "segmented-control"
     ],
     "slots": {},
     "states": [

package/components/segment/segment.css

@@ -17,6 +17,15 @@ segment-ui[selected] {
 segmented-ui[multiple] > segment-ui[selected] {
   background: var(--segment-bg-selected);
 }
+/* gh#1596 — a selected segment in [multiple] mode kept its full
+   primary-container fill when disabled (only the label fg dimmed); 2-attr
+   selector outweighs the 1-attr rule above regardless of source order.
+   Neutralizes to the same shared disabled-bg role button-ui's colored
+   variants already reset to, rather than a color-family container-low
+   (disabled drops color semantics entirely, same convention as button). */
+segmented-ui[multiple] > segment-ui[selected][disabled] {
+  background: var(--segment-bg-selected-disabled);
+}
 
 @scope (segment-ui) {
   :where(:scope) {
@@ -43,6 +52,7 @@ segmented-ui[multiple] > segment-ui[selected] {
     --segment-fg-hover:        var(--a-ui-text-hover);
     --segment-fg-selected:     var(--a-chrome-dark);
     --segment-fg-disabled:     var(--a-ui-text-disabled);
+    --segment-bg-selected-disabled: var(--a-ui-bg-disabled);
     /* [multiple] only — see the moved-out selector above (Safari 17.x bug
        note at top of file). Same default the deprecated
        toggle-option-ui[selected] background used, for visual continuity

package/components/segment/segment.yaml

@@ -61,7 +61,7 @@ a2ui:
   rules:
     - rule: 'Child of <segmented-ui> — one selectable option button; the parent''s [multiple] axis decides single- or multi-select, segment-ui itself is unchanged either way.'
       reason: 'Cluster contract.'
-    - rule: '<toggle-option-ui> (deprecated, gh#1369) is the same concept — use segment-ui inside <segmented-ui multiple> instead.'
+    - rule: '<toggle-option-ui> (cut in 0.8.43, gh#1617, gh#1369) was the same concept — use segment-ui inside <segmented-ui multiple> instead.'
       reason: 'Deprecation redirect.'
     - rule: 'Selected state managed by the parent <segmented-ui> — it syncs the selected attribute onto every child whose value is in its own value (single value, or the [multiple] comma-separated set); do not set selected directly on segment.'
       reason: 'Parent owns selection state.'
@@ -243,4 +243,3 @@ synonyms:
   segment: [segment-button, segmented-option, option-button, toggle-option]
 related:
   - segmented-control
-  - ToggleOption

package/components/segmented/segmented.a2ui.json

@@ -22,7 +22,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
     },
@@ -81,8 +81,6 @@
     },
     "related": [
       "Segment",
-      "ToggleGroup",
-      "ToggleOption",
       "Tabs",
       "Radio"
     ],

package/components/segmented/segmented.class.js

@@ -29,8 +29,8 @@
  * [multiple] (gh#1369, #1363 C1): multi-select mode — `value` is a
  * comma-separated set, no sliding indicator (each selected segment carries
  * its own background instead), Space/Enter toggles instead of arrow-move.
- * Absorbs <toggle-group-ui>/<toggle-option-ui>'s role, which are deprecated
- * in favor of this axis.
+ * Absorbs <toggle-group-ui>/<toggle-option-ui>'s role; those components
+ * were cut in 0.8.43 (gh#1617) in favor of this axis.
  */
 
 import { UIFormElement } from '../../core/form.js';

package/components/segmented/segmented.yaml

@@ -12,7 +12,7 @@ props:
     type: string
     default: ''
   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
     reflect: true
@@ -45,7 +45,7 @@ a2ui:
   rules:
     - rule: 'Single-select by default. Hosts <segment-ui> children; exactly one selected at a time.'
       reason: 'Single-select cluster contract.'
-    - rule: 'For multi-select (filter chips, multi-flag toggles, day-of-week pickers), set [multiple] instead of using a separate component — value becomes a comma-separated set of selected segment values. <toggle-group-ui>/<toggle-option-ui> are deprecated; use <segmented-ui multiple> + <segment-ui> instead (gh#1369, #1363 C1).'
+    - rule: 'For multi-select (filter chips, multi-flag toggles, day-of-week pickers), set [multiple] instead of using a separate component — value becomes a comma-separated set of selected segment values. <toggle-group-ui>/<toggle-option-ui> were cut in 0.8.43 (gh#1617); use <segmented-ui multiple> + <segment-ui> instead (gh#1369, #1363 C1).'
       reason: 'Selection model axis — multiple absorbs the deprecated multi-select pair.'
     - rule: 'Use for view-mode switches (grid/list, light/dark) or short filter sets (3-5 options); for longer sets use <tabs-ui> or <select-ui multiple>.'
       reason: 'Capacity guidance.'
@@ -201,7 +201,5 @@ synonyms:
   - Segmented
 related:
   - Segment
-  - ToggleGroup
-  - ToggleOption
   - Tabs
   - Radio

package/components/select/select.css

@@ -21,6 +21,11 @@
        --select-bg-selected to re-enable a tinted selected row. */
     --select-bg-selected:       transparent;
     --select-bg-hover:          var(--a-ui-bg-hover);
+    /* gh#1596 — the trigger kept its full field bg when disabled (no
+       swap existed at all, unlike input-ui/textarea-ui's own
+       --<component>-bg-disabled indirection); wired to the same shared
+       role those already alias to. */
+    --select-bg-disabled:       var(--a-ui-bg-disabled);
     --select-border:            var(--a-ui-border);
     --select-border-hover:      var(--a-ui-border-hover);
     --select-focus-ring:        var(--a-focus-ring);
@@ -69,6 +74,7 @@
     align-items: center;
   }
   :scope[disabled] { pointer-events: none; color: var(--select-fg-disabled); }
+  :scope[disabled] [slot="trigger"] { background: var(--select-bg-disabled); }
 
   /* Label */
   :scope::before {

package/components/step-progress/step-progress.yaml

@@ -51,7 +51,7 @@ a2ui:
       reason: 'Minimal stepper visualization.'
     - rule: 'Different from <stepper-ui> (labeled, expanded) — step-progress is dense and label-free.'
       reason: 'Density boundary.'
-    - rule: 'For multi-task progress bars (multiple labeled rows) use a stack of <progress-ui> with `label` set (absorbed the row layout from the now-deprecated progress-row-ui).'
+    - rule: 'For multi-task progress bars (multiple labeled rows) use a stack of <progress-ui> with `label` set (absorbed the row layout from progress-row-ui, which was cut in 0.8.43, gh#1617).'
       reason: 'Different layout.'
 anti_patterns: []
 

package/components/swatch/swatch.yaml

@@ -154,7 +154,7 @@ tokens:
     description: Color of the focus + selected ring when [selectable] is set.
 a2ui:
   rules:
-    - rule: 'Use to display a single color sample with optional label. For interactive color picking use <color-picker-ui>.'
+    - rule: 'Use to display a single color sample with optional label. For interactive color picking use <color-area-ui>.'
       reason: 'Swatch is read-only display; picker is input.'
     - rule: 'Inside design-token displays or palette grids; not for general decoration.'
       reason: 'Semantic purpose: color sample.'

package/components/switch/switch.css

@@ -14,6 +14,13 @@ switch-ui[checked] {
   --switch-track-border: var(--switch-track-border-checked);
   --switch-thumb-bg: var(--switch-thumb-bg-checked);
 }
+/* gh#1596 — a checked track kept its full primary fill when disabled
+   (only the label fg dimmed); 2-attr selector outweighs the 1-attr rule
+   above regardless of source order. */
+switch-ui[checked][disabled] {
+  --switch-track-bg: var(--switch-track-bg-checked-disabled);
+  --switch-track-border: var(--switch-track-bg-checked-disabled);
+}
 switch-ui[checked] [slot="thumb"] {
   transform: translateX(var(--switch-thumb-travel));
 }
@@ -60,6 +67,7 @@ switch-ui[checked] [slot="thumb"] {
 
     /* ── State: disabled ── */
     --switch-fg-disabled:          var(--a-ui-text-disabled);
+    --switch-track-bg-checked-disabled: var(--a-ui-bg-disabled);
     text-align: start;  /* §text-align-reset — blocks inheritance from centered ancestors */
 }
 

package/components/table-toolbar/table-toolbar.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/TableToolbar.json",
   "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": [
     {
@@ -46,11 +46,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": "common_types.json#/$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",
@@ -92,6 +116,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 }."
       },
@@ -104,6 +131,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": [
@@ -132,6 +164,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": [
@@ -183,6 +218,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"
       },