@adia-ai/web-components 0.8.37 → 0.8.39

package/custom-elements.json

@@ -241,7 +241,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The Adia brand mark — a rounded square with the \"Adia\" wordmark cut out in a contrasting color. Token-driven: the background always reads as the current scheme's inverse surface, and the wordmark always reads as the current scheme's inverse foreground, so a single asset replaces separate light/dark/transparent static exports (gh `icon-ui` registry entry — icon-ui is the Phosphor-glyph registry only; this is a fixed, one-off brand image, a separate delivery shape.",
+          "description": "The Adia brand mark — a rounded square with the \"Adia\" wordmark cut out in a contrasting color. Token-driven: the background always reads as the current scheme's inverse surface, and the wordmark always reads as the current scheme's inverse foreground, so a single asset replaces separate light/dark/transparent static exports (gh#283). Not an `icon-ui` registry entry — icon-ui is the Phosphor-glyph registry only; this is a fixed, one-off brand image, a separate delivery shape.",
           "name": "UIAdiaMark",
           "tagName": "adia-mark-ui",
           "superclass": {
@@ -285,7 +285,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The Adia wordmark — the \"Adia\" text logotype rendered as inline SVG. Unlike `adia-mark-ui` (gh this is a standalone mark meant to sit directly on a surface: its fill defaults to the current scheme's on-surface foreground token (`--a-fg-strong`) rather than a fixed inverse pairing, so it reads correctly wherever it's placed — a login header, a footer, a splash screen — without needing a background chip (gh",
+          "description": "The Adia wordmark — the \"Adia\" text logotype rendered as inline SVG. Unlike `adia-mark-ui` (gh#283's fixed inverse-on-inverse square tile), this is a standalone mark meant to sit directly on a surface: its fill defaults to the current scheme's on-surface foreground token (`--a-fg-strong`) rather than a fixed inverse pairing, so it reads correctly wherever it's placed — a login header, a footer, a splash screen — without needing a background chip (gh#390).",
           "name": "UIAdiaWordmark",
           "tagName": "adia-wordmark-ui",
           "superclass": {
@@ -434,7 +434,7 @@
               "description": "Disable all actions."
             },
             {
-              "name": "saveIcon",
+              "name": "save-icon",
               "type": {
                 "text": "string"
               },
@@ -442,7 +442,7 @@
               "description": "Save button icon."
             },
             {
-              "name": "saveLabel",
+              "name": "save-label",
               "type": {
                 "text": "string"
               },
@@ -521,7 +521,7 @@
               "description": "Headline question."
             },
             {
-              "name": "submitLabel",
+              "name": "submit-label",
               "type": {
                 "text": "string"
               },
@@ -572,7 +572,7 @@
           },
           "attributes": [
             {
-              "name": "noAutocollapse",
+              "name": "no-autocollapse",
               "type": {
                 "text": "boolean"
               },
@@ -860,14 +860,14 @@
               "description": "Dunning mode only — ISO 4217 currency code driving the `Intl.NumberFormat` style=\"currency\" rendering. Defaults to `USD`."
             },
             {
-              "name": "dueAt",
+              "name": "due-at",
               "type": {
                 "text": "string"
               },
               "description": "Dunning mode only — ISO 8601 due / failed-at timestamp. Formatted via `Intl.DateTimeFormat`. Ignored when [pattern] is not `dunning`. Attribute spelling: `due-at`."
             },
             {
-              "name": "cardLast4",
+              "name": "card-last4",
               "type": {
                 "text": "string"
               },
@@ -884,7 +884,7 @@
           "slots": [
             {
               "name": "content",
-              "description": "Alert body. For single-line text use the `text=` attribute (alert.js stamps a `<span slot=\"content\">` automatically). For structured banners use card-ui's section rhythm INSIDE the content element (gh `<footer>` (actions — right-aligned with its own step of air) children of the slotted wrapper; the component owns the gaps (`--alert-section-gap`, `--alert-footer-gap`), so spacing balances without per-banner col-ui/row-ui improvisation. Free-form content without those children lays out exactly as before."
+              "description": "Alert body. For single-line text use the `text=` attribute (alert.js stamps a `<span slot=\"content\">` automatically). For structured banners use card-ui's section rhythm INSIDE the content element (gh#507): semantic `<header>` (title), `<section>` (body), and `<footer>` (actions — right-aligned with its own step of air) children of the slotted wrapper; the component owns the gaps (`--alert-section-gap`, `--alert-footer-gap`), so spacing balances without per-banner col-ui/row-ui improvisation. Free-form content without those children lays out exactly as before."
             },
             {
               "name": "leading",
@@ -938,7 +938,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Persistent, anchored, elevated surface for chrome that must stay visible while a condition holds — floating bulk-action toolbars, undo bars, sticky wizard/commit footers. Distinct from <toast-ui> (auto-dismissing, notification semantics) and <modal-ui>/<drawer-ui> (blocking overlays with backdrop + focus-trap semantics). Default mode anchors [anchor] to the nearest scroll container via `position: sticky` — the shape gh bulk-action-toolbar pattern hand-rolled with card-ui + position:sticky. Opt into [viewport] for a surface that anchors to the browser viewport instead, promoted to the top layer via the Popover API (`popover=\"manual\"`) so it wins stacking over shell chrome without a z-index war. Visibility is [open] (default false, no auto-dismiss timer) — arbitrary content (typically <toolbar-ui> or <text-ui> + <button-ui>) rides the default slot.",
+          "description": "Persistent, anchored, elevated surface for chrome that must stay visible while a condition holds — floating bulk-action toolbars, undo bars, sticky wizard/commit footers. Distinct from <toast-ui> (auto-dismissing, notification semantics) and <modal-ui>/<drawer-ui> (blocking overlays with backdrop + focus-trap semantics). Default mode anchors [anchor] to the nearest scroll container via `position: sticky` — the shape gh#494's bulk-action-toolbar pattern hand-rolled with card-ui + position:sticky. Opt into [viewport] for a surface that anchors to the browser viewport instead, promoted to the top layer via the Popover API (`popover=\"manual\"`) so it wins stacking over shell chrome without a z-index war. Visibility is [open] (default false, no auto-dismiss timer) — arbitrary content (typically <toolbar-ui> or <text-ui> + <button-ui>) rides the default slot.",
           "name": "UIAnchorBar",
           "tagName": "anchor-bar-ui",
           "superclass": {
@@ -1134,7 +1134,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Inline pill-shaped badge — READ-ONLY status flag, count, or notification dot. Text rendered via CSS `attr(text)`. Distinct from <tag-ui>, which is INTERACTIVE / removable and fires a `remove` event. Use badge-ui for status flags (Beta / New / Deprecated), notification counts, and unread indicators; use tag-ui for filter chips or user-managed labels. REGISTER (gh issue 845; weight revised gh the same geometry family — pill radius (`--a-radius-full`) and padding token rhythm are identical, so shape is NOT how you tell them apart. Typography is: badge is UPPERCASE, mono (kbd-ui's `--a-font-family-code` stack), medium weight, wide-tracked (`--a-font-tracking-wider`, 0.06em), tabular numerals for counts. Tag stays proportional sentence-case, also weight 500 — weight no longer distinguishes the two (gh the register split now. Neither component exposes a prop that crosses this line; the registers cannot be mixed à la carte. Remaining distinctions: badge is non-interactive and carries the semantic-color voice (status tones ARE the message, solid by default — gh default for family variants (gh family-less variant (gh",
+          "description": "Inline pill-shaped badge — READ-ONLY status flag, count, or notification dot. Text rendered via CSS `attr(text)`. Distinct from <tag-ui>, which is INTERACTIVE / removable and fires a `remove` event. Use badge-ui for status flags (Beta / New / Deprecated), notification counts, and unread indicators; use tag-ui for filter chips or user-managed labels. REGISTER (gh issue 845; weight revised gh#866): badge and tag share the same geometry family — pill radius (`--a-radius-full`) and padding token rhythm are identical, so shape is NOT how you tell them apart. Typography is: badge is UPPERCASE, mono (kbd-ui's `--a-font-family-code` stack), medium weight, wide-tracked (`--a-font-tracking-wider`, 0.06em), tabular numerals for counts. Tag stays proportional sentence-case, also weight 500 — weight no longer distinguishes the two (gh#866); case + tracking + mono carry the register split now. Neither component exposes a prop that crosses this line; the registers cannot be mixed à la carte. Remaining distinctions: badge is non-interactive and carries the semantic-color voice (status tones ARE the message, solid by default — gh#864); tag is interactive/removable, muted/tinted by default for family variants (gh#864), solid by default for the family-less variant (gh#794, unaffected by gh#864).",
           "name": "UIBadge",
           "tagName": "badge-ui",
           "superclass": {
@@ -1192,7 +1192,7 @@
                 "text": "string"
               },
               "default": "solid",
-              "description": "Fill style — orthogonal to [variant]. Badge defaults to `solid` (gh default formulas; this restores badge's own). Three values: - `solid` (default) — saturated bg + on-strong text. The badge IS the state (status stamp). `primary` is badge's sole brand-emphasis variant (`accent` retired, gh - `muted` — tinted bg + scheme-paired text. Use for quiet metadata — counts, IDs, status pills in dense rows. Family-tinted `muted` (e.g. `variant=\"info\" tone=\"muted\"`) shares `<tag-ui>`'s `[tone=\"muted\"]` shape; family-less `tone=\"muted\"` does NOT (gh `<tag-ui>`'s family-less muted stays on the lighter `--a-bg-muted` pair (gh - `outline` — transparent bg + family-colored border + family- colored text. Lightest visual weight; good in dense data rows. Vocabulary mirrors `<tag-ui>` (which now defaults to `muted` for its family variants, gh autocomplete chip)."
+              "description": "Fill style — orthogonal to [variant]. Badge defaults to `solid` (gh#864 — badge and tag were swapped relative to their reported default formulas; this restores badge's own). Three values: - `solid` (default) — saturated bg + on-strong text. The badge IS the state (status stamp). `primary` is badge's sole brand-emphasis variant (`accent` retired, gh#874). - `muted` — tinted bg + scheme-paired text. Use for quiet metadata — counts, IDs, status pills in dense rows. Family-tinted `muted` (e.g. `variant=\"info\" tone=\"muted\"`) shares `<tag-ui>`'s `[tone=\"muted\"]` shape; family-less `tone=\"muted\"` does NOT (gh#873) — it renders the stronger `neutral-low` fill, while `<tag-ui>`'s family-less muted stays on the lighter `--a-bg-muted` pair (gh#778 dense-list rationale). - `outline` — transparent bg + family-colored border + family- colored text. Lightest visual weight; good in dense data rows. Vocabulary mirrors `<tag-ui>` (which now defaults to `muted` for its family variants, gh#864 — different role as filter / autocomplete chip)."
             }
           ]
         }
@@ -1328,7 +1328,7 @@
               "description": "Collapse middle crumbs into a `…` overflow popover when there are 4+ items."
             },
             {
-              "name": "collapseKeepLeading",
+              "name": "collapse-keep-leading",
               "type": {
                 "text": "number"
               },
@@ -1336,7 +1336,7 @@
               "description": "Number of leading items to keep visible when [collapse] is active. The first item (often a home/icon link) sits before the overflow popover."
             },
             {
-              "name": "collapseKeepTrailing",
+              "name": "collapse-keep-trailing",
               "type": {
                 "text": "number"
               },
@@ -1549,14 +1549,14 @@
               "description": "Blocks selection but allows month navigation."
             },
             {
-              "name": "rangeStart",
+              "name": "range-start",
               "type": {
                 "text": "string"
               },
               "description": "Start of a date range (ISO YYYY-MM-DD). When both rangeStart and rangeEnd are set + ordered, day cells strictly between the endpoints get `[data-in-range]` stamped for visual continuity. Used by `<date-range-picker-ui>` which pushes the same from/to onto both calendar panes. Endpoints themselves render via the `value` prop's `[data-selected]` state."
             },
             {
-              "name": "rangeEnd",
+              "name": "range-end",
               "type": {
                 "text": "string"
               },
@@ -1930,7 +1930,7 @@
               "description": "When set, rows are non-interactive <span>s (no click, no toggle)."
             },
             {
-              "name": "onToggle",
+              "name": "on-toggle",
               "type": {
                 "text": "string"
               },
@@ -2004,7 +2004,7 @@
               "description": "Color scheme"
             },
             {
-              "name": "hideAverage",
+              "name": "hide-average",
               "type": {
                 "text": "boolean"
               },
@@ -2012,7 +2012,7 @@
               "description": "When true, suppress the overlaid average line"
             },
             {
-              "name": "hideGrid",
+              "name": "hide-grid",
               "type": {
                 "text": "boolean"
               },
@@ -2020,7 +2020,7 @@
               "description": "Hide gridlines"
             },
             {
-              "name": "hideValues",
+              "name": "hide-values",
               "type": {
                 "text": "boolean"
               },
@@ -2056,14 +2056,14 @@
                 "text": "string"
               },
               "default": "all",
-              "description": "Marker (dot) visibility for line and multi-line series. `all` draws a circle[data-dot] on every datum (default — matches pre-gh behavior). `none` hides all dots so a dense series reads as a clean line. `hover` shows only the currently-hovered datum's dot. `last` shows only the terminal point per series (sparkline convention). Tooltip hit targets ([data-hit]) are a separate always-rendered layer — every mode keeps hover/click working along the whole line."
+              "description": "Marker (dot) visibility for line and multi-line series. `all` draws a circle[data-dot] on every datum (default — matches pre-gh#561 behavior). `none` hides all dots so a dense series reads as a clean line. `hover` shows only the currently-hovered datum's dot. `last` shows only the terminal point per series (sparkline convention). Tooltip hit targets ([data-hit]) are a separate always-rendered layer — every mode keeps hover/click working along the whole line."
             },
             {
-              "name": "seriesEmphasis",
+              "name": "series-emphasis",
               "type": {
                 "text": "string"
               },
-              "description": "Multi-line only. Names one series key (matching a `y` key) to render at full strength — area fill + full-opacity line. Every other series drops its area fill and renders line-only at --chart-deemphasized-opacity. Empty (default) applies full treatment to every series, unchanged from pre-gh"
+              "description": "Multi-line only. Names one series key (matching a `y` key) to render at full strength — area fill + full-opacity line. Every other series drops its area fill and renders line-only at --chart-deemphasized-opacity. Empty (default) applies full treatment to every series, unchanged from pre-gh#561 behavior."
             },
             {
               "name": "loading",
@@ -2362,12 +2362,12 @@
               "description": "Label text beside the checkbox"
             },
             {
-              "name": "labelHidden",
+              "name": "label-hidden",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, [label] still sets the accessible name (aria-label) but the visible text is suppressed via the canonical sr-only technique (gh visually (e.g. a title next to a check-ui used as a list-item icon) and the plain-visible label would paint it twice."
+              "description": "When true, [label] still sets the accessible name (aria-label) but the visible text is suppressed via the canonical sr-only technique (gh#1010). Use when a sibling element already shows the same name visually (e.g. a title next to a check-ui used as a list-item icon) and the plain-visible label would paint it twice."
             },
             {
               "name": "value",
@@ -2439,7 +2439,7 @@
               "description": "Language hint for syntax highlighting"
             },
             {
-              "name": "lineNumbers",
+              "name": "line-numbers",
               "type": {
                 "text": "boolean"
               },
@@ -2665,7 +2665,7 @@
                 "text": "string"
               },
               "default": "hex",
-              "description": "Output format for the value property + event detail. Hex (`"
+              "description": "Output format for the value property + event detail. Hex (`#rrggbb`) or OKLCH (`oklch(L C H)`)."
             },
             {
               "name": "disabled",
@@ -3184,6 +3184,10 @@
               "name": "footer",
               "description": "Keyboard hint bar"
             },
+            {
+              "name": "input",
+              "description": "The auto-stamped search field — a contenteditable=\"plaintext-only\" span carrying role=\"combobox\" (per ADR-0025/ADR-0055; no native <input>). Internal only; not consumer-slottable."
+            },
             {
               "name": "list",
               "description": "Container for command items and groups"
@@ -3327,7 +3331,7 @@
               "description": "Selected range as `{from, to}` ISO 8601 dates. Null when empty. Emitted on commit."
             },
             {
-              "name": "compareValue",
+              "name": "compare-value",
               "type": {
                 "text": "string"
               },
@@ -3404,7 +3408,7 @@
               "description": "Trigger button date format. `short`: `Jan 1, 2026`; `long`: `January 1, 2026`; `iso`: `2026-01-01`."
             },
             {
-              "name": "noPresets",
+              "name": "no-presets",
               "type": {
                 "text": "boolean"
               },
@@ -3543,7 +3547,7 @@
               "description": "Time-pane precision. `minute` (default) emits `HH:mm`; `second` exposes the seconds segment and emits `HH:mm:ss`."
             },
             {
-              "name": "hourcycle",
+              "name": "hour-cycle",
               "type": {
                 "text": "string"
               },
@@ -3688,7 +3692,7 @@
           },
           "attributes": [
             {
-              "name": "labelOn",
+              "name": "label-on",
               "type": {
                 "text": "string"
               },
@@ -3696,7 +3700,7 @@
               "description": "Header label rendered when state is \"on\"."
             },
             {
-              "name": "labelOff",
+              "name": "label-off",
               "type": {
                 "text": "string"
               },
@@ -4065,6 +4069,147 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/drilldown/drilldown.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Single-panel, multi-level drill-in menu. One list panel slides between levels (a level header with back navigation replaces stacking a column per level) — for hierarchical data where miller columns don't fit the viewport (>2 levels, >12 top-level entries, or narrow layouts). Rows compose a leading dot/icon, primary label, optional meta line, and trailing row-native count chips (not full <badge-ui>, which reads oversized at row density) — plus a drill-in chevron on branch items. Set `.items` to a tree of `{value, label, meta?, dot?, counts?, children?}` nodes; `children` may be an array (sync) or a function returning an array/Promise (lazy, fetched on drill-in — a loading level is shown via <skeleton-ui> while it resolves). Distinct from <tree-ui> (inline expand/collapse — right for file-tree shapes, wrong for wide/deep data where the expanded tree becomes a wall of rows), <nav-ui> (flat app navigation, not hierarchical drill-in), and <context-menu> (transient popover submenus, not a persistent content panel).",
+          "name": "UIDrilldown",
+          "tagName": "drilldown-ui",
+          "superclass": {
+            "name": "UIElement",
+            "module": "/core/element.js"
+          },
+          "attributes": [
+            {
+              "name": "items",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]",
+              "description": "Root-level array of node objects: {value, label, meta?, dot?, counts?, children?, leaf?}. `value` is the stable id used in `path` and event details. `dot` names a semantic tone (info, success, warning, danger, primary, neutral) rendered as a small leading color swatch. `counts` is an array of {variant?, value} rendered as compact trailing chips. `children` is either an array of child nodes (resolved synchronously) or a function `(item) => array | Promise<array>` for lazy per-level fetch — a loading level renders while the promise is pending. `leaf: true` forces no drill chevron even when `children` is present (rare — normally omit `children` instead)."
+            },
+            {
+              "name": "path",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]",
+              "description": "Current drilled-in level, as an array of ancestor item `value`s (root = `[]`). Setting `.path` restores directly to that nested level without animating through every intermediate level — the deep-link/URL-restore path. Hand-managed (not the generic `reflect:` mechanism, which can't JSON-encode arrays) — it still genuinely reflects to a JSON-encoded `path` attribute both ways (property → attribute and attribute → property), unlike most array props on this kit."
+            },
+            {
+              "name": "rootLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "Level-header title shown at the root level (depth 0). Empty by default (no title row)."
+            },
+            {
+              "name": "filterable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a filter input pinned above the list, filtering the current level's rows by label/meta."
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "Filter…",
+              "description": "Placeholder text for the filter input (only rendered when `[filterable]`)."
+            },
+            {
+              "name": "select-on-drill",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, clicking/activating a branch item (one with children) BOTH fires `select` and drills into it — the Schema Manager shape, where picking a namespace is both a selection and a navigation. Default false: branch activation only drills in; only leaf activation fires `select`."
+            },
+            {
+              "name": "static",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Suppress the horizontal slide transition between levels — instant swap. Also honored automatically under `prefers-reduced-motion: reduce`."
+            }
+          ],
+          "slots": [
+            {
+              "name": "breadcrumb",
+              "description": "Optional slot for a consumer-supplied <breadcrumb-ui> in the level header, for deep hierarchies. Not managed by drilldown-ui — the consumer wires jump clicks to `.path = [...]` itself."
+            },
+            {
+              "name": "header",
+              "description": "Auto-stamped level-header container (back affordance + breadcrumb + title/count). Structural — not consumer-overridable."
+            },
+            {
+              "name": "back",
+              "description": "Auto-stamped back-affordance <button> (chevron + parent-level label). Hidden at the root level."
+            },
+            {
+              "name": "title",
+              "description": "Auto-stamped title cluster (current-level label + item count) inside the header."
+            },
+            {
+              "name": "filter",
+              "description": "Auto-stamped filter-input row, shown only when `[filterable]` is set."
+            },
+            {
+              "name": "viewport",
+              "description": "Auto-stamped clipping container for the current level's panel (hosts the slide-transition overflow clip)."
+            },
+            {
+              "name": "dot",
+              "description": "Auto-stamped per-row leading color swatch, rendered when the row's data item declares a `dot` tone."
+            },
+            {
+              "name": "main",
+              "description": "Auto-stamped per-row content column (label + optional meta line)."
+            },
+            {
+              "name": "meta",
+              "description": "Auto-stamped per-row secondary meta line, rendered when the row's data item declares `meta`."
+            },
+            {
+              "name": "counts",
+              "description": "Auto-stamped per-row trailing count-chip cluster, rendered when the row's data item declares `counts`."
+            }
+          ],
+          "events": [
+            {
+              "name": "select",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when a leaf item is activated (click/Enter), or when a branch item is activated with `[select-on-drill]` set. detail: { path, item }. `path` is the drilled-in level the item lives at (the current `.path` at the time of activation); `item` is the raw node object."
+            },
+            {
+              "name": "navigate",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired whenever the shown level changes — drill-in, back, breadcrumb jump, or a programmatic `.path` assignment. detail: { path }. Hosts mirror this to the URL instead of listening to `select`."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "drilldown-ui",
+          "declaration": {
+            "name": "UIDrilldown",
+            "module": "./components/drilldown/drilldown.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/embed/embed.js",
@@ -4253,7 +4398,7 @@
                 "text": "string"
               },
               "default": "default",
-              "description": "Semantic variant — `default | info | success | warning | danger | primary`. `primary` is the brand-emphasis fill (accent-filled bg + on-accent text), ported from toast.css's `primary` variant (gh posted toasts."
+              "description": "Semantic variant — `default | info | success | warning | danger | primary`. `primary` is the brand-emphasis fill (accent-filled bg + on-accent text), ported from toast.css's `primary` variant (gh#1104) now that feed-item-ui is the real paint site for posted toasts."
             },
             {
               "name": "duration",
@@ -4553,7 +4698,7 @@
               "description": "Block-axis alignment of grid items (start/center/end/stretch) via align-items — e.g. vertically centering a text column against a visual in a 2-column hero. Sets grid-item alignment, NOT text alignment."
             },
             {
-              "name": "columnGap",
+              "name": "column-gap",
               "type": {
                 "text": "string"
               },
@@ -4584,14 +4729,14 @@
               "description": "Inline-axis alignment of grid items (start/center/end/stretch) via justify-items. Default stretch (items fill their column track)."
             },
             {
-              "name": "minColumnWidth",
+              "name": "min-column-width",
               "type": {
                 "text": "string"
               },
               "description": "Minimum track width for columns=\"auto-fit\"/\"auto-fill\" (any CSS length, e.g. \"240px\", \"16rem\"). Sets the minmax() floor so cards don't shrink below it before wrapping; unset uses the 12rem default. No effect on numeric columns."
             },
             {
-              "name": "rowGap",
+              "name": "row-gap",
               "type": {
                 "text": "string"
               },
@@ -4648,7 +4793,7 @@
               "description": "Aspect ratio"
             },
             {
-              "name": "colorScheme",
+              "name": "color-scheme",
               "type": {
                 "text": "string"
               },
@@ -4664,7 +4809,7 @@
               "description": "Column count"
             },
             {
-              "name": "noLegend",
+              "name": "no-legend",
               "type": {
                 "text": "boolean"
               },
@@ -4688,7 +4833,7 @@
               "description": "Value-to-bucket scale"
             },
             {
-              "name": "startDate",
+              "name": "start-date",
               "type": {
                 "text": "string"
               },
@@ -5517,7 +5662,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Inline navigation primitive — semantic `<a href>` wrapper. Use for cross-page navigation, footer / Terms-of-Service / Privacy-Policy inline references, \"Sign in\" / \"Sign up\" cross-page links, and any affordance whose purpose is to take the user somewhere (not to perform an action). Sibling of `<button-ui>` — they have separate semantics and must not be substituted for each other: | Affordance | Use | |---------------------------|----------------| | Submit form | `<button-ui>` | | Trigger action / modal | `<button-ui>` | | Copy to clipboard | `<button-ui>` | | Open modal / drawer | `<button-ui>` | | Navigate to another page | `<link-ui>` | | Open external URL | `<link-ui>` | | Anchor jump ( | Inline reference in prose | `<link-ui>` | Renders `<a href=\"…\">` internally so middle-click open-in-new-tab, right-click context menu, hover URL preview, search-engine crawlability, and bookmark-ability all work without any custom wiring. ARIA role is \"link\" (set automatically by `<a>` element).",
+          "description": "Inline navigation primitive — semantic `<a href>` wrapper. Use for cross-page navigation, footer / Terms-of-Service / Privacy-Policy inline references, \"Sign in\" / \"Sign up\" cross-page links, and any affordance whose purpose is to take the user somewhere (not to perform an action). Sibling of `<button-ui>` — they have separate semantics and must not be substituted for each other: | Affordance | Use | |---------------------------|----------------| | Submit form | `<button-ui>` | | Trigger action / modal | `<button-ui>` | | Copy to clipboard | `<button-ui>` | | Open modal / drawer | `<button-ui>` | | Navigate to another page | `<link-ui>` | | Open external URL | `<link-ui>` | | Anchor jump (#section) | `<link-ui>` | | Inline reference in prose | `<link-ui>` | Renders `<a href=\"…\">` internally so middle-click open-in-new-tab, right-click context menu, hover URL preview, search-engine crawlability, and bookmark-ability all work without any custom wiring. ARIA role is \"link\" (set automatically by `<a>` element).",
           "name": "UILink",
           "tagName": "link-ui",
           "superclass": {
@@ -5636,7 +5781,7 @@
               "description": "The items to virtualize. Required for prop-driven authoring; ignored when data-stream-src is set."
             },
             {
-              "name": "itemSize",
+              "name": "item-size",
               "type": {
                 "text": "number"
               },
@@ -5644,7 +5789,7 @@
               "description": "Fixed item height in pixels. When > 0, uses the constant-time fast path (avoids per-row measurement)."
             },
             {
-              "name": "itemSizeRem",
+              "name": "item-size-rem",
               "type": {
                 "text": "number"
               },
@@ -5652,7 +5797,7 @@
               "description": "Fixed item height in rem. Useful for typographic-scale rows that should track the body type."
             },
             {
-              "name": "estimatedSize",
+              "name": "estimated-size",
               "type": {
                 "text": "number"
               },
@@ -5676,7 +5821,7 @@
               "description": "Scroll axis — vertical (default) or horizontal carousel."
             },
             {
-              "name": "pinBottom",
+              "name": "pin-bottom",
               "type": {
                 "text": "boolean"
               },
@@ -5684,7 +5829,7 @@
               "description": "When appending items, keep scroll pinned to the bottom (chat-thread / log-tail pattern)."
             },
             {
-              "name": "startIndex",
+              "name": "start-index",
               "type": {
                 "text": "number"
               },
@@ -5811,7 +5956,7 @@
           "slots": [
             {
               "name": "text",
-              "description": "Override slot for richer primary-text markup than the plain [text] attribute string. Styled by `:scope [slot=\"text\"]` (list.css) and honored by UIListItem's stamping logic — a consumer-provided [slot=\"text\"] child is never overwritten (only component-stamped ones are). Undeclared until gh"
+              "description": "Override slot for richer primary-text markup than the plain [text] attribute string. Styled by `:scope [slot=\"text\"]` (list.css) and honored by UIListItem's stamping logic — a consumer-provided [slot=\"text\"] child is never overwritten (only component-stamped ones are). Undeclared until gh#653; the element source always supported it."
             },
             {
               "name": "content",
@@ -5866,7 +6011,7 @@
               "description": "Enable selection on child listitems (roving tabindex + aria-selected)."
             },
             {
-              "name": "selectedKey",
+              "name": "selected-key",
               "type": {
                 "text": "string"
               },
@@ -6554,6 +6699,14 @@
                 "text": "string"
               },
               "description": "Optional kicker label. Section variant renders it via ::before; primary uses it as aria-label only."
+            },
+            {
+              "name": "multi-expand",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Opt out of the default single-expanded-group behavior. When unset, selecting a nav-item-ui collapses every nav-group-ui except the one containing the newly selected item (all, when the selection is ungrouped); manual multi-expansion still works up until the next selection."
             }
           ],
           "slots": [
@@ -6638,7 +6791,7 @@
               "description": "Port indicator dot size in pixels"
             },
             {
-              "name": "portSize",
+              "name": "port-size",
               "type": {
                 "text": "number"
               },
@@ -6662,7 +6815,7 @@
               "description": "Show port indicator dots. Defaults to true when editable"
             },
             {
-              "name": "showPorts",
+              "name": "show-ports",
               "type": {
                 "text": "boolean"
               },
@@ -6678,7 +6831,7 @@
               "description": "Stroke width in pixels"
             },
             {
-              "name": "strokeWidth",
+              "name": "stroke-width",
               "type": {
                 "text": "number"
               },
@@ -6753,7 +6906,7 @@
               "description": "The numeric value to format. Empty string or non-numeric value renders nothing."
             },
             {
-              "name": "numberStyle",
+              "name": "number-style",
               "type": {
                 "text": "string"
               },
@@ -6783,7 +6936,7 @@
               "description": "`Intl.NumberFormat` `notation` option. `standard` is the thousands-grouped form (1,234,567); `compact` is the abbreviated form (1.2M); `scientific` and `engineering` are the exponent forms. Defaults to `standard`."
             },
             {
-              "name": "compactDisplay",
+              "name": "compact-display",
               "type": {
                 "text": "string"
               },
@@ -6791,7 +6944,7 @@
               "description": "When [notation=\"compact\"], controls the compact-form length. `short` = \"1.2M\" (default); `long` = \"1.2 million\"."
             },
             {
-              "name": "minimumFractionDigits",
+              "name": "minimum-fraction-digits",
               "type": {
                 "text": "number"
               },
@@ -6799,7 +6952,7 @@
               "description": "Minimum fractional digits (0–20). Padded with trailing zeros. Useful for currency display to force \".00\" suffix."
             },
             {
-              "name": "maximumFractionDigits",
+              "name": "maximum-fraction-digits",
               "type": {
                 "text": "number"
               },
@@ -6814,7 +6967,7 @@
               "description": "BCP-47 locale tag for the formatter. Empty defaults to the document locale (`<html lang>`) then to browser default."
             },
             {
-              "name": "signDisplay",
+              "name": "sign-display",
               "type": {
                 "text": "string"
               },
@@ -7071,7 +7224,7 @@
               "description": "Sets the page as a scroll container. `overflow-y: auto`, full height, contained overscroll. Use when the page IS the scroll surface (standalone pages); leave off when nested inside a parent that already manages scroll (e.g. inside an `<admin-shell>`'s main `<section>`)."
             },
             {
-              "name": "maxWidth",
+              "name": "max-width",
               "type": {
                 "text": "string"
               },
@@ -7085,7 +7238,7 @@
               "description": "Page-padding scale from the spacing system. Accepts `0`–`8` (mapped to `--a-space-N`). Empty (no value) applies the `--page-padding` token; `0` removes padding."
             },
             {
-              "name": "stickyHeader",
+              "name": "sticky-header",
               "type": {
                 "text": "boolean"
               },
@@ -7096,7 +7249,23 @@
           "slots": [
             {
               "name": "default",
-              "description": "Composes from the slot primitives — `<header-ui>` (page header), `<section-ui>` (main content), optional `<footer-ui>`. Native `<header>` / `<section>` / `<footer>` also work; the @scope rules target both via `:where(header, header-ui)`."
+              "description": "Composes from the slot primitives — `<header-ui>` (page header), `<section-ui>` (main content), optional `<footer-ui>`. Native `<header>` / `<section>` / `<footer>` also work; the @scope rules target both via `:where(header, header-ui)`. The page header also activates the named slot-gated grid (`slot=\"icon\"` / `slot=\"heading\"` / `slot=\"description\"` / `slot=\"action\"`) once any DIRECT header child carries a `slot` attribute — same contract as `<card-ui>`'s header (gh#1253)."
+            },
+            {
+              "name": "icon",
+              "description": "Leading icon for the page header — status, brand, or type marker. Placed in column 1 of the header grid when present; heading + description shift to column 2. Direct child of `<header>` / `<header-ui>` only, per the :has(> [slot=\"icon\"]) gate."
+            },
+            {
+              "name": "heading",
+              "description": "Primary title — grid row 1 inside the page header. Also accepts bare `<h1>`–`<h6>` tags (or A2UI's transpiled display/title/heading/subsection `<text-ui>` variants) as direct children without slot=\"heading\". A slot=\"heading\" wrapper can contain inline badges or metadata alongside the title text."
+            },
+            {
+              "name": "description",
+              "description": "Secondary metadata — grid row 2 beneath the heading inside the page header. Also accepts bare `<p>` / `<small>` / body-variant `<text-ui>` as direct children without slot=\"description\"."
+            },
+            {
+              "name": "action",
+              "description": "Trailing control cluster inside the page header (icon-buttons, menu trigger, scheme toggle, more-options). Aligns to the flex-end edge — the fix for gh#1253's dropped `<toggle-scheme-ui>`."
             }
           ]
         }
@@ -7212,7 +7381,7 @@
               "description": "Component property: collapsed."
             },
             {
-              "name": "maxWidth",
+              "name": "max-width",
               "type": {
                 "text": "number"
               },
@@ -7220,7 +7389,7 @@
               "description": "Component property: maxWidth."
             },
             {
-              "name": "minWidth",
+              "name": "min-width",
               "type": {
                 "text": "number"
               },
@@ -7297,7 +7466,7 @@
               "description": "The password string to score. JS-property only — NOT reflected to a DOM attribute (so the password never leaks into rendered HTML). Wire to an input via `input.addEventListener('input', e => meter.value = e.target.value)`."
             },
             {
-              "name": "minScore",
+              "name": "min-score",
               "type": {
                 "text": "number"
               },
@@ -7305,7 +7474,7 @@
               "description": "Minimum acceptable score (0–3). The `score-change` event's `detail.satisfied` boolean reflects whether the current score meets this threshold. Useful for gating a submit button."
             },
             {
-              "name": "showLabel",
+              "name": "show-label",
               "type": {
                 "text": "boolean"
               },
@@ -7497,7 +7666,7 @@
               "description": "Pane arrangement. Defaults to `split` — render and code side-by-side in a responsive 2-column grid that collapses to stacked on narrow widths (a bare `<preview-ui>` stamps `layout=\"split\"` on connect). Use `stack` to force the render stacked above the code; the docs auto-apply `stack` to wide self-framing demos (card / shell / table) that read cramped at half width. The `rows` attribute is a separate gallery mode and overrides this."
             },
             {
-              "name": "codeFirst",
+              "name": "code-first",
               "type": {
                 "text": "boolean"
               },
@@ -7699,7 +7868,7 @@
               "description": "Host display size in CSS pixels (width and height; the SVG is always square). Default 200. Internal cell size is computed from this divided by `matrix-size + 2·margin`."
             },
             {
-              "name": "errorCorrection",
+              "name": "error-correction",
               "type": {
                 "text": "string"
               },
@@ -7719,14 +7888,14 @@
               "type": {
                 "text": "string"
               },
-              "description": "Foreground (dark-cell) color. Any CSS color string (hex, rgb, token reference). **Empty defaults to ` for guaranteed scanability** (theme-aware `currentColor` would produce light-on-dark in dark mode, which most phone scanners refuse to decode). Override for branded QRs only when you've verified the chosen color/background pair scans on the target devices."
+              "description": "Foreground (dark-cell) color. Any CSS color string (hex, rgb, token reference). **Empty defaults to `#000000` — hardcoded black for guaranteed scanability** (theme-aware `currentColor` would produce light-on-dark in dark mode, which most phone scanners refuse to decode). Override for branded QRs only when you've verified the chosen color/background pair scans on the target devices."
             },
             {
               "name": "background",
               "type": {
                 "text": "string"
               },
-              "description": "Background (light-cell) color. **Empty defaults to ` hardcoded white** alongside the black foreground, for guaranteed scanability. Override only when paired with an explicit [color] (the contrast pair must scan)."
+              "description": "Background (light-cell) color. **Empty defaults to `#ffffff` — hardcoded white** alongside the black foreground, for guaranteed scanability. Override only when paired with an explicit [color] (the contrast pair must scan)."
             },
             {
               "name": "label",
@@ -7756,7 +7925,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Groups a set of bare <radio-ui label=\"…\"> children under one accessible name — role=\"radiogroup\" on the host plus aria-labelledby pointing at its own [label]. Radio-ui already supports ancestor fieldset/[role=radiogroup] grouping for exclusivity + arrow-key navigation (unchanged by this wrapper); a plain layout container (Column) can carry neither the role nor the label association, which left the canonical questionnaire shape (radio.yaml's own example) with no programmatic question↔group link (gh mutually-exclusive radio-ui options — it is the ONLY primitive that carries the group's accessible name; radio-ui itself stays self-labeling per-option.",
+          "description": "Groups a set of bare <radio-ui label=\"…\"> children under one accessible name — role=\"radiogroup\" on the host plus aria-labelledby pointing at its own [label]. Radio-ui already supports ancestor fieldset/[role=radiogroup] grouping for exclusivity + arrow-key navigation (unchanged by this wrapper); a plain layout container (Column) can carry neither the role nor the label association, which left the canonical questionnaire shape (radio.yaml's own example) with no programmatic question↔group link (gh#729). Use this wherever a question/prompt introduces a set of mutually-exclusive radio-ui options — it is the ONLY primitive that carries the group's accessible name; radio-ui itself stays self-labeling per-option.",
           "name": "UIRadioGroup",
           "tagName": "radio-group-ui",
           "superclass": {
@@ -8059,7 +8228,7 @@
               "description": "Form participation — field name when submitted"
             },
             {
-              "name": "allowHalf",
+              "name": "allow-half",
               "type": {
                 "text": "boolean"
               },
@@ -8149,7 +8318,7 @@
               "description": "ISO 8601 timestamp (e.g. `2026-05-25T09:30:00Z`) or any string parseable by `Date`. Required for output — empty value renders nothing."
             },
             {
-              "name": "timeStyle",
+              "name": "time-style",
               "type": {
                 "text": "string"
               },
@@ -8172,7 +8341,7 @@
               "description": "BCP-47 locale tag for the formatter. Empty defaults to the document locale (`<html lang>`) then to the browser default."
             },
             {
-              "name": "updateInterval",
+              "name": "update-interval",
               "type": {
                 "text": "number"
               },
@@ -8312,7 +8481,7 @@
               "description": "Enable flex-wrap unconditionally. For viewport-responsive wrapping use [wrap-at] instead."
             },
             {
-              "name": "wrapAt",
+              "name": "wrap-at",
               "type": {
                 "text": "string"
               },
@@ -8529,7 +8698,7 @@
               "description": "Value of the currently selected segment."
             },
             {
-              "name": "allowEmpty",
+              "name": "allow-empty",
               "type": {
                 "text": "boolean"
               },
@@ -8651,7 +8820,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Suppress the single-select radio indicator on option rows (gh For menu-shaped switchers — workspace or user identity menus — where the trigger already shows the committed value and a per-row radio reads as redundant selection language. Rows keep their layout and aria-selected state; the trigger and selected-row weight carry the signal. No effect under [multiple]. IMPLIED by [mark] — a mark declares an identity switcher, which is always menu-shaped (gh"
+              "description": "Suppress the single-select radio indicator on option rows (gh#498). For menu-shaped switchers — workspace or user identity menus — where the trigger already shows the committed value and a per-row radio reads as redundant selection language. Rows keep their layout and aria-selected state; the trigger and selected-row weight carry the signal. No effect under [multiple]. IMPLIED by [mark] — a mark declares an identity switcher, which is always menu-shaped (gh#498 reopen: per-instance opt-outs proved forgettable)."
             },
             {
               "name": "error",
@@ -8727,7 +8896,7 @@
                 "text": "string"
               },
               "default": "null",
-              "description": "Multi-select only (gh text line: a single selection shows its own label; N > 1 shows \"<summary-label> (N)\" — e.g. \"Organizations (2)\"; none shows the placeholder. Popover checkbox rows, Backspace-removes-last, the comma-separated form value, [select-all], and [clearable] are unchanged. Absent (default) = tag-ui chip trigger. Prefer this form for narrow triggers (filter bars) where wrapping chips would balloon the control."
+              "description": "Multi-select only (gh#442). Replaces the chip trigger with one text line: a single selection shows its own label; N > 1 shows \"<summary-label> (N)\" — e.g. \"Organizations (2)\"; none shows the placeholder. Popover checkbox rows, Backspace-removes-last, the comma-separated form value, [select-all], and [clearable] are unchanged. Absent (default) = tag-ui chip trigger. Prefer this form for narrow triggers (filter bars) where wrapping chips would balloon the control."
             },
             {
               "name": "min",
@@ -8929,7 +9098,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Accessibility utility — visually-hidden link that becomes visible on keyboard focus, letting keyboard users skip past repetitive navigation to the main content. WCAG 2.1 Success Criterion 2.4.1 \"Bypass Blocks\". Place as the FIRST focusable element on the page (typically inside `<body>` before any nav / shell chrome). Target an `id` on your main content region (commonly `",
+          "description": "Accessibility utility — visually-hidden link that becomes visible on keyboard focus, letting keyboard users skip past repetitive navigation to the main content. WCAG 2.1 Success Criterion 2.4.1 \"Bypass Blocks\". Place as the FIRST focusable element on the page (typically inside `<body>` before any nav / shell chrome). Target an `id` on your main content region (commonly `#main` / `#main-content`).",
           "name": "UISkipNav",
           "tagName": "skip-nav-ui",
           "superclass": {
@@ -9066,7 +9235,7 @@
               "description": "Two-thumb range slider mode. When enabled, [lower-value] and [upper-value] are authoritative and [value] is ignored. The fill renders between the two thumbs (not from left to thumb). Form-data under [name] serializes as \"<lower>,<upper>\". Use for price filters, date ranges, audio range gates, etc."
             },
             {
-              "name": "lowerValue",
+              "name": "lower-value",
               "type": {
                 "text": "number"
               },
@@ -9074,7 +9243,7 @@
               "description": "Lower thumb value (dual mode only; clamped to ≤ [upper-value])."
             },
             {
-              "name": "upperValue",
+              "name": "upper-value",
               "type": {
                 "text": "number"
               },
@@ -9523,7 +9692,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Opt into click-to-navigate + roving-tabindex keyboard nav (arrow keys / Home / End / Enter / Space). Absent by default — a bare stepper is a read-only progress display, not a nav control (gh"
+              "description": "Opt into click-to-navigate + roving-tabindex keyboard nav (arrow keys / Home / End / Enter / Space). Absent by default — a bare stepper is a read-only progress display, not a nav control (gh#711 S1)."
             }
           ],
           "slots": [
@@ -9538,7 +9707,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Cancelable — fires BEFORE [step] mutates, on a click or keyboard navigation. call preventDefault() to veto: the step does not change, [change] does not fire, and focus/roving-tabindex stay exactly where they were. A host that never listens for this event keeps the pre-veto uncontrolled behavior unchanged (gh"
+              "description": "Cancelable — fires BEFORE [step] mutates, on a click or keyboard navigation. call preventDefault() to veto: the step does not change, [change] does not fire, and focus/roving-tabindex stay exactly where they were. A host that never listens for this event keeps the pre-veto uncontrolled behavior unchanged (gh#711 S1 review)."
             },
             {
               "name": "change",
@@ -9748,7 +9917,7 @@
               "description": "When set, computes the swatch color's OKLab L and switches the label / detail color between light + dark so it remains legible against the tile background. Active when `label-position=\"overlay\"` (where the label sits ON the tile). Uses a 1px canvas probe to handle any CSS color form (oklch / hex / hsl / named / var() references)."
             },
             {
-              "name": "labelPosition",
+              "name": "label-position",
               "type": {
                 "text": "string"
               },
@@ -9811,7 +9980,7 @@
               "description": "Enable auto-advance"
             },
             {
-              "name": "slidesPerView",
+              "name": "slides-per-view",
               "type": {
                 "text": "string"
               },
@@ -9849,7 +10018,7 @@
               "description": "Infinite loop"
             },
             {
-              "name": "noPauseOnHover",
+              "name": "no-pause-on-hover",
               "type": {
                 "text": "boolean"
               },
@@ -10080,7 +10249,7 @@
               "description": "Optional count badge value shown next to the title. When unset, falls back to the row count of the bound table."
             },
             {
-              "name": "noFilter",
+              "name": "no-filter",
               "type": {
                 "text": "boolean"
               },
@@ -10088,7 +10257,7 @@
               "description": "Hide the Filter popover button. Filter is shown by default; set to opt out."
             },
             {
-              "name": "noSort",
+              "name": "no-sort",
               "type": {
                 "text": "boolean"
               },
@@ -10096,7 +10265,7 @@
               "description": "Hide the Sort popover button. Sort is shown by default; set to opt out."
             },
             {
-              "name": "noColumns",
+              "name": "no-columns",
               "type": {
                 "text": "boolean"
               },
@@ -10104,7 +10273,7 @@
               "description": "Hide the Columns visibility popover button. Columns control is shown by default; set to opt out."
             },
             {
-              "name": "noSearch",
+              "name": "no-search",
               "type": {
                 "text": "boolean"
               },
@@ -10205,7 +10374,7 @@
                 "text": "array"
               },
               "default": "[]",
-              "description": "JS property (set programmatically — `el.data = [...]`) — row records, an array of plain objects keyed to columns[].key. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect (gh Custom accessor on the element class, not a reflected attribute."
+              "description": "JS property (set programmatically — `el.data = [...]`) — row records, an array of plain objects keyed to columns[].key. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect (gh#288) — the same pattern chart-ui's `data` attribute uses. Custom accessor on the element class, not a reflected attribute."
             },
             {
               "name": "density",
@@ -10284,7 +10453,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Drop the table's outer 1px perimeter and nothing else (gh#511) — row dividers are untouched (the perimeter is split onto its own --table-perimeter token, defaulting to --table-border). For card-composed tables: the card owns the frame, so the table's square perimeter otherwise renders a doubled edge (flush bleed) or a stray inner box (with content above). Standalone tables keep their chrome by default. Theming path without the attribute: set --table-perimeter to transparent per instance. Note: `<card-ui><section bleed>` already drops a direct-child table-ui's chrome automatically (card.css, gh instance still applies and is honored, but is no longer required just to avoid the doubled-edge look in that composition."
+              "description": "Drop the table's outer 1px perimeter and nothing else (gh#511) — row dividers are untouched (the perimeter is split onto its own --table-perimeter token, defaulting to --table-border). For card-composed tables: the card owns the frame, so the table's square perimeter otherwise renders a doubled edge (flush bleed) or a stray inner box (with content above). Standalone tables keep their chrome by default. Theming path without the attribute: set --table-perimeter to transparent per instance. Note: `<card-ui><section bleed>` already drops a direct-child table-ui's chrome automatically (card.css, gh#796) — `frameless`/`raw` on the instance still applies and is honored, but is no longer required just to avoid the doubled-edge look in that composition."
             },
             {
               "name": "valign",
@@ -10292,7 +10461,7 @@
                 "text": "string"
               },
               "default": "center",
-              "description": "Vertical alignment of body-cell content. 'center' (default) keeps today's behavior — every cell centers on the row's cross-axis, which reads well for single-line rows. 'top' aligns each cell's content to the top of its padding box instead, so tall/wrapped rows (a [wrap] title column, a stacked identity cell) share one first-line scan anchor across the row rather than each cell floating at a different vertical center (gh (or <col-def valign=\"…\">) overrides the host per-column — e.g. keep a checkbox column centered while data cells top-align. Header cells always stay centered regardless of this prop (single-line by contract) — the checkbox/expand structural columns also default to centered under [valign=\"top\"] since they're not part of columns[]."
+              "description": "Vertical alignment of body-cell content. 'center' (default) keeps today's behavior — every cell centers on the row's cross-axis, which reads well for single-line rows. 'top' aligns each cell's content to the top of its padding box instead, so tall/wrapped rows (a [wrap] title column, a stacked identity cell) share one first-line scan anchor across the row rather than each cell floating at a different vertical center (gh#505). Per-column `valign` in the columns[] array (or <col-def valign=\"…\">) overrides the host per-column — e.g. keep a checkbox column centered while data cells top-align. Header cells always stay centered regardless of this prop (single-line by contract) — the checkbox/expand structural columns also default to centered under [valign=\"top\"] since they're not part of columns[]."
             },
             {
               "name": "wrap",
@@ -10573,7 +10742,7 @@
                 "text": "string"
               },
               "default": "muted",
-              "description": "Fill style — orthogonal to [variant]. Three values: - `muted` (default for the family variants — info/success/warning/ danger/primary — gh their reported default formulas; this restores tag's own) — tinted bg with scheme-paired text. Matches <badge-ui>'s `[tone=\"muted\"]` look. Use on metadata / citation chips in dense lists or tables where a saturated fill would compete for attention (gh the family-less `default` variant, which stays solid unconditionally (gh `<tag-ui text=\"…\">` still renders that solid look with no attributes at all. - `solid` — saturated bg + on-strong (near-white) text. The chip IS the state. Opt in explicitly for a family variant (gh or it's already the unconditional look for the family-less `default` variant (gh - `outline` — transparent bg + family-colored border + family-colored text. The lightest visual weight; good in dense data tables or faceted filter rows where multiple chips would otherwise compete. `tone` is a declarative presentational attribute (not a reactive prop — see tag.class.js) so its schema `default` here is documentation of the rendered-by-default look, not a reflected attribute value."
+              "description": "Fill style — orthogonal to [variant]. Three values: - `muted` (default for the family variants — info/success/warning/ danger/primary — gh#864: tag and badge were swapped relative to their reported default formulas; this restores tag's own) — tinted bg with scheme-paired text. Matches <badge-ui>'s `[tone=\"muted\"]` look. Use on metadata / citation chips in dense lists or tables where a saturated fill would compete for attention (gh#778's oversized-pill concern). Does NOT apply to the family-less `default` variant, which stays solid unconditionally (gh#794, unaffected by gh#864) — a bare `<tag-ui text=\"…\">` still renders that solid look with no attributes at all. - `solid` — saturated bg + on-strong (near-white) text. The chip IS the state. Opt in explicitly for a family variant (gh#864), or it's already the unconditional look for the family-less `default` variant (gh#794). - `outline` — transparent bg + family-colored border + family-colored text. The lightest visual weight; good in dense data tables or faceted filter rows where multiple chips would otherwise compete. `tone` is a declarative presentational attribute (not a reactive prop — see tag.class.js) so its schema `default` here is documentation of the rendered-by-default look, not a reflected attribute value."
             }
           ],
           "events": [
@@ -10644,7 +10813,7 @@
               "description": "Inline character that commits the typed value as a chip. The sentinel `enter` disables in-line commit — only the Enter key (or programmatic `addToken`) commits. Default is `,`."
             },
             {
-              "name": "pasteSplit",
+              "name": "paste-split",
               "type": {
                 "text": "string"
               },
@@ -10668,7 +10837,7 @@
               "description": "Minimum required tokens for form validity."
             },
             {
-              "name": "minLength",
+              "name": "min-length",
               "type": {
                 "text": "number"
               },
@@ -10676,7 +10845,7 @@
               "description": "Minimum per-token character count after `transform` is applied."
             },
             {
-              "name": "maxLength",
+              "name": "max-length",
               "type": {
                 "text": "number"
               },
@@ -11126,7 +11295,7 @@
               "description": "Whether the seconds segment is exposed. `minute` (default) hides seconds; `second` adds the seconds segment + separator."
             },
             {
-              "name": "hourcycle",
+              "name": "hour-cycle",
               "type": {
                 "text": "string"
               },
@@ -11583,6 +11752,14 @@
               },
               "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 (was previously a private `data-selected` stamp with no declared API surface)."
             }
           ]
         }
@@ -11645,7 +11822,7 @@
               "description": "Persist the user's choice to localStorage under `${storage-prefix}scheme`."
             },
             {
-              "name": "storagePrefix",
+              "name": "storage-prefix",
               "type": {
                 "text": "string"
               },
@@ -11653,7 +11830,7 @@
               "description": "LocalStorage key prefix; default matches <theme-panel> for cross-element interop."
             },
             {
-              "name": "iconLight",
+              "name": "icon-light",
               "type": {
                 "text": "string"
               },
@@ -11661,7 +11838,7 @@
               "description": "Phosphor icon shown when active-scheme is \"light\" (clicking switches to dark)."
             },
             {
-              "name": "iconDark",
+              "name": "icon-dark",
               "type": {
                 "text": "string"
               },
@@ -11669,7 +11846,7 @@
               "description": "Phosphor icon shown when active-scheme is \"dark\" (clicking switches to light)."
             },
             {
-              "name": "labelLight",
+              "name": "label-light",
               "type": {
                 "text": "string"
               },
@@ -11677,7 +11854,7 @@
               "description": "aria-label / title applied to the internal button when active-scheme is \"light\"."
             },
             {
-              "name": "labelDark",
+              "name": "label-dark",
               "type": {
                 "text": "string"
               },
@@ -11716,7 +11893,7 @@
               "description": "Disables the internal button."
             },
             {
-              "name": "activeScheme",
+              "name": "active-scheme",
               "type": {
                 "text": "string"
               },