@adia-ai/web-components 0.8.41 → 0.8.43

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog — @adia-ai/web-components
 
+## [0.8.43] — 2026-08-18
+
+### Removed
+- **BREAKING — ADR-0063 attribute-grammar addendum cuts: `chart-ui[hide-average|hide-grid|hide-values]`, `chart-legend-ui[static]`, `pane-ui[side]`, `menu-item-ui[subtitle]` prop, and the `color-picker-ui` tag (gh#1617, gh#1377/gh#1563).** Each 0.8.42 dual-read compat shim is removed outright — the deprecated old spellings are now inert (no property, no mirroring, no console warning): `chart-ui` keeps only `no-average`/`no-grid`/`no-values`; `chart-legend-ui` keeps only `interactive` (default still `true` — the ADR's own default-inversion consumer-scan remains a separate follow-up); `pane-ui` keeps only `edge`; `menu-item-ui` keeps only the `description` prop (its `subtitle` SLOT is unchanged); `color-picker-ui`/`ColorPicker`/`UIColorPicker` no longer resolve at all — `color-area-ui`/`ColorArea`/`UIColorArea` is the sole tag/component/class. Operator ruling on gh#1562 (IDR-0004 deviation) lifted all 0.9.0-parked breaking cuts onto this 0.8.43 wave. See `.claude/docs/MIGRATION GUIDE.md` § Shipped in `0.8.43` — ADR-0063 attribute-grammar addendum.
+- **BREAKING — `action-item-ui[subtitle]` prop cut (gh#1617, gh#1571).** `[description]` is the sole prop now; the `subtitle` SLOT is unchanged. Closes the gap PR #1569 flagged once `menu-item-ui` converged onto `description`. See `.claude/docs/MIGRATION GUIDE.md` § Shipped in `0.8.43` — `action-item-ui[description]` ADR-0063 convergence.
+- **BREAKING — three 0.8.41-era deprecated components removed outright: `toggle-group-ui`/`toggle-option-ui`, `progress-row-ui`, `datetime-picker-ui` (gh#1617).** Each shipped its `status: deprecated` soft-deprecation additively in 0.8.41 with a one-time `console.warn`, behavior unchanged; all three are now removed — none of the three tags register as custom elements anymore. Migrate `<toggle-group-ui value>` + `<toggle-option-ui>` children → `<segmented-ui multiple value>` + `<segment-ui>` children (`<toggle-group-ui single>` → plain `<segmented-ui>`); `<progress-row-ui label value meta>` → `<progress-ui label value meta>` (mechanical tag rename); `<datetime-picker-ui>` → `<calendar-picker-ui precision="minute">`. Each alias's successor shipped in 0.8.41, one full release (0.8.42) before this cut — the maturity guard the ticket required. See `.claude/docs/MIGRATION GUIDE.md` § Shipped in `0.8.43` — three 0.8.41-era deprecated components removed.
+
+### Maintenance
+- **`core/` touched in this release window** (1 file(s), e.g. `core/icons.js`) — carried by the entries above.
+- **`dist/` bundles rebuilt** in this cut's window (6 file(s)) — regenerated from the source changes described above, not independent edits.
+- **`patterns/` touched in this release window** (3 file(s), e.g. `chart-in-card/chart-in-card.examples.html`) — carried by the entries above.
+- **`styles/` touched in this release window** (2 file(s), e.g. `semantics/features.css`) — carried by the entries above.
+- **`traits/` touched in this release window** (2 file(s), e.g. `arrow-grid-nav/arrow-grid-nav.js`) — carried by the entries above.
+
+## [0.8.42] — 2026-08-17
+
+### Added
+- **ADR-0063 `0.8.42` compat shims (gh#1562 wave, PR #1569).** Dual-read/alias shims easing the planned 0.9.0 renames: chart `no-*` boolean axes, `chart-legend-ui[interactive]`, `pane-ui[edge]`, the `color-area-ui` alias, and `menu-item-ui[description]`. Old names keep working this cut; the breaking removals ride 0.9.0 per the migration guide.
+- **Rename-wave W1 compat shims (gh#1560, PR #1565).** `data-sidebar-resize` / `data-layout-grid` are dual-read alongside the legacy `data-resize` / `data-grid` stamps.
+
+### Changed
+- **Rename-wave W2 (gh#1561, PR #1567).** In-repo consumers, demos, and docs migrate to the new `data-sidebar-resize` / `data-layout-grid` names; the W1 shims keep external consumers working.
+
+### Fixed
+- **`table-toolbar`** falls back to the column key when a column label is whitespace-only, and hides the title cluster when it has nothing to show (PR #1573, gh#1571 family).
+
+### Maintenance
+- ADR-0069 Class-R derived artifacts re-derived on main by the new `derived-resync` job (PR #1568).
+- Demo-attribute sweep touched `traits/view-transition`'s examples (one dead attribute dropped, gh#1576 family, PR #1584) — no trait API change.
+- **`components/` touched in this release window** (62 file(s), e.g. `chart-legend/chart-legend.a2ui.json`) — carried by the entries above.
+- **`core/` touched in this release window** (1 file(s), e.g. `core/icons.js`) — carried by the entries above.
+- **`dist/` bundles rebuilt** in this cut's window (4 file(s)) — regenerated from the source changes described above, not independent edits.
+- **`patterns/` touched in this release window** (2 file(s), e.g. `admin-shell/admin-shell.examples.html`) — carried by the entries above.
+- **`styles/` touched in this release window** (1 file(s), e.g. `styles/components.css`) — carried by the entries above.
+
 ## [0.8.41] — 2026-08-17
 
 ### Added

package/MIGRATION.md

@@ -64,7 +64,7 @@ Version cuts and migration scope:
 
 - **Shipped in `0.8.41` (`progress-ui` retires `variant`, gh#1370)** — **BREAKING, no deprecation alias:** `<progress-ui>`'s `variant` prop (`bar` | `spinner`) is removed — progress is bar-only now. The former `variant="spinner"` render mode (a Sanctioned Mode Attribute per the component-token-contract) is gone; `<spinner-ui>` owns circular loading indicators (`arc`/`ring`/`dots`/`knight`). Migration: `<progress-ui variant="spinner">` → `<spinner-ui>` (pick the closest `variant`; `arc` is the nearest visual match to the old spinner render). `<progress-ui variant="bar">` → drop the attribute (bar was already the default). Filed from the catalog-regularity audit's C2 finding (gh#1363) — a 2026-06 merge folded a standalone spinner into progress as `variant="spinner"`, then a richer standalone `spinner-ui` was re-added later, leaving two circular-loading answers in the catalog; this rider un-forks them. See [§ Shipped in `0.8.41` — `progress-ui` retires `variant`](#upcoming--progress-ui-retires-variant-090-gh1370).
 
-- **Shipped in `0.8.41` (`input-ui` trims `type` enum, gh#1381)** — **BREAKING, no deprecation alias:** `<input-ui>`'s `type` enum drops `search`/`date`/`datetime-local`/`time`/`month`/`week`/`color` — none ever rendered a native affordance (all seven fell back to a plain contenteditable surface), so the enum was first-pass-VALID but functionally broken generation output. The implemented set is now exactly `text`/`email`/`password`/`number`/`tel`/`url`. Migration: `type="search"` → `<search-ui>`; `type="date"`/`"month"`/`"week"` → `<calendar-picker-ui>` (day granularity only — no dedicated month/week primitive exists); `type="datetime-local"` → `<datetime-picker-ui>`; `type="time"` → `<time-picker-ui>`; `type="color"` → `<color-input-ui>` (or `<color-picker-ui>` directly for a full-surface editor). Filed from the catalog-regularity audit's B10 finding (gh#1363). See [§ Shipped in `0.8.41` — `input-ui` trims `type` enum](#upcoming--input-ui-trims-type-enum-090-gh1381).
+- **Shipped in `0.8.41` (`input-ui` trims `type` enum, gh#1381)** — **BREAKING, no deprecation alias:** `<input-ui>`'s `type` enum drops `search`/`date`/`datetime-local`/`time`/`month`/`week`/`color` — none ever rendered a native affordance (all seven fell back to a plain contenteditable surface), so the enum was first-pass-VALID but functionally broken generation output. The implemented set is now exactly `text`/`email`/`password`/`number`/`tel`/`url`. Migration: `type="search"` → `<search-ui>`; `type="date"`/`"month"`/`"week"` → `<calendar-picker-ui>` (day granularity only — no dedicated month/week primitive exists); `type="datetime-local"` → `<calendar-picker-ui precision="minute">` (`<datetime-picker-ui>` was cut in 0.8.43, gh#1617); `type="time"` → `<time-picker-ui>`; `type="color"` → `<color-input-ui>` (or `<color-area-ui>` directly for a full-surface editor — `<color-picker-ui>` was likewise cut in 0.8.43, gh#1617). Filed from the catalog-regularity audit's B10 finding (gh#1363). See [§ Shipped in `0.8.41` — `input-ui` trims `type` enum](#upcoming--input-ui-trims-type-enum-090-gh1381).
 
 - **Shipped in `0.8.41` (web-modules `data-*` state converges to bare attributes, gh#1332)** — **BREAKING, no deprecation alias:** two web-modules' declared `states:` entries drop a private `data-*` stamp for a bare state attribute, per the data-* usage sweep's Category A disposition (ADR-0056's rule generalized past `toggle-option-ui`). `<integrations-page-ui>`'s `empty-search`/`empty-data` states (was `data-empty-search`/`data-empty-data`) and `<onboarding-checklist-ui>`'s `complete` state (was `data-complete`) now match their own sibling states' existing bare-attribute convention (`loading`, `collapsed`). Migration: any `[data-empty-search]`/`[data-empty-data]`/`[data-complete]` CSS or script targeting these two modules moves to `[empty-search]`/`[empty-data]`/`[complete]`. See [§ Shipped in `0.8.41` — web-modules data-* state converges to bare attributes](#upcoming--web-modules-data--state-converges-to-bare-attributes-090-gh1332).
 
@@ -82,6 +82,14 @@ Version cuts and migration scope:
 
 - **Shipped in `0.8.41` (`image-ui` load/error states declared + converge to bare attributes, gh#1464)** — **BREAKING, no deprecation alias.** The final residue of the [data-* usage sweep](https://github.com/adiahealth/gen-ui-kit/issues/1332), deferred out of the residual round above because it needed a new `states:` declaration rather than a bare mapping change: `<image-ui>`'s `[data-loaded]`/`[data-error]` were genuine undeclared host-level state (never yaml-declared at all) — now declared as `loaded`/`error` in `image.yaml`'s `states:` list with bare `attribute:` mappings, matching qr-code-ui's own converged `error` state. Migration: any `[data-loaded]`/`[data-error]` CSS or script targeting `image-ui` moves to `[loaded]`/`[error]`; `image-ui`'s unrelated `[data-overlay]` skeleton-proximity marker (gh#1362) is untouched. A repo-wide consumer sweep (`rg -nU 'data-loaded|data-error'`) found zero external consumers of image-ui's forms specifically, so no deprecation alias was kept. The same ticket also dispositioned the `data-msg-*` validation-message config family (`data-msg-required`/`pattern`/`minlength`/`maxlength`/`min`/`max`/`bad-input`) as **exempt, non-breaking, no migration** — it stays `data-*` by design (component-side config read by `core/form.js`'s shared mixin across 7+ components, not host-reflected state; see `primitive-authoring/references/yaml-contract.md`'s new `data-msg-*` section for the full rationale). See [§ Shipped in `0.8.41` — image-ui load/error states declared + converge to bare attributes](#upcoming--image-ui-loaderror-states-declared--converge-to-bare-attributes-090-gh1464).
 
+- **Shipped in `0.8.43` (rename wave — `data-grid` / `data-resize`, docs/ops/plan/plan-090-rename-wave.md)** — **BREAKING, no deprecation alias — the 0.8.x dual-read compat shim (gh#1560/gh#1561) is removed.** `admin-shell`'s consumer-authored 2/3-column content-layout helper `[data-grid]` / `[data-grid="3"]` is renamed to `[data-layout-grid]` / `[data-layout-grid="3"]` (sits with the `data-col`/`data-row`/`data-actions`/`data-spacer` form-layout-helper family it belongs to, outside every trait-owned root). The author-supplied drag-handle child of `<admin-sidebar>`/`<chat-sidebar>`/`<editor-sidebar>` `[data-resize]` is renamed to `[data-sidebar-resize]` (owner-scoped to the `*-sidebar` composite family, outside resize-observer's grandfathered `resize` root). Both attributes decorate plain light-DOM children the shells don't own (not a trait/component API), so only the name changed. **The old names no longer resolve:** `[data-resize]` now falls through to `<admin-sidebar>`'s existing "no handle found" author warning (the correct post-cut behavior, no new code needed — `<chat-sidebar>` has no such warning and is silently unhandled) and `[data-grid]` simply no longer matches any CSS rule. `adia-lint`'s SHELL-RESIZE rule now requires `[data-sidebar-resize]` only; its transition-window `DEPRECATED-LAYOUT-NAME` advisory is retired with the window it existed for. `KNOWN_GRAZING_PAIRS` (`scripts/build/traits-catalog.mjs`) drops both entries — 2 → 0, and `verify:traits` now fails hard on any NEW overlap with either old name. Migration (mechanical): `git grep -l 'data-resize' | xargs perl -pi -e 's/\bdata-resize\b(?!-)/data-sidebar-resize/g'` and `git grep -l 'data-grid' | xargs perl -pi -e 's/\bdata-grid\b(?!-)/data-layout-grid/g'` (negative lookahead protects trait-owned `data-resize-*`/`data-grid-*` names — unrelated grandfathered attributes, e.g. resize-observer's `data-resize-width`/`data-resize-observer-observed` and arrow-grid-nav's `data-grid-columns`/`mode`/`active-row`/`active-col`, which this wave never touches). Shipped: gh#1560 (W1 shim) → gh#1561 (W2 in-repo consumer + docs migration) → gh#1562 (W3, this cut). **Deviates from release invariant 7 / IDR-0004** (breaking removals never ship in a patch) — operator ruling 2026-08-18 on gh#1562 moved this 0.9.0-parked cut into the `0.8.43` window ("whatever items are waiting for 0.9.0 should use 0.8.43"), the same recorded-deviation pattern as the `0.8.41` cut. Disjoint from, and coordinated with, gh#1377/gh#1563's ADR-0063 rename set (chart `hide-*`, `pane[side]`, `color-picker-ui` → `color-area-ui`, `menu-item-ui[subtitle]`) and gh#1617's own 0.8.43 breaking-wave build — separate PRs, no file overlap.
+
+- **Shipped in `0.8.43` (ADR-0063 attribute-grammar addendum — chart `no-*`, `chart-legend[interactive]`, `pane[edge]`, `color-area-ui`, `menu-item[description]`, gh#1377/gh#1563/gh#1617)** — **BREAKING.** The 0.8.42 additive dual-read compat shims are removed per the operator ruling on gh#1562 (IDR-0004 deviation) lifting all 0.9.0-parked breaking cuts onto 0.8.43. Five identifiers now resolve to ADR-0063's ratified spellings ONLY: `chart-ui[hideAverage|hideGrid|hideValues]` → `[noAverage|noGrid|noValues]`; `chart-legend-ui[static]` → `[interactive]` (default still NOT flipped — that inversion remains its own unscoped follow-up); `pane-ui[side]` → `[edge]`; `menu-item-ui[subtitle]` prop → `[description]` prop (the `subtitle` SLOT is unchanged); and `color-picker-ui`/`ColorPicker`/`UIColorPicker` are removed outright — `color-area-ui`/`ColorArea`/`UIColorArea` is the sole tag/component/class. Every old name/tag is now inert (no property, no dual-read, no warning). Filed from the catalog-regularity audit's B2/B3/B5/B11 findings (gh#1363) via [ADR-0063](../../docs/ops/adr/adr-0063-attribute-grammar-addendum.md). **Rejected/deferred:** `chart-legend-ui[interactive]`'s default-inversion to `false` (its own consumer-scan requirement is unmet); `drilldown-ui[static]`, `alert-ui[dismissible]`, `card-ui[outline]`, `agent-reasoning-ui[status]`, `noodles-ui[port-size]`/`[show-ports]` cleanup (separately-scoped follow-ups). See [§ Shipped in `0.8.43` — ADR-0063 attribute-grammar addendum](#upcoming--adr-0063-attribute-grammar-addendum-chart-no--chart-legendinteractive-paneedge-color-area-ui-menu-itemdescription-090-gh1377gh1563).
+
+- **Shipped in `0.8.43` (ADR-0063 convergence — `action-item-ui[description]`, gh#1571/gh#1617)** — **BREAKING.** `action-item-ui[subtitle]` prop is removed — `[description]` is the sole prop now (the `subtitle` **slot** is unchanged, exactly like `menu-item-ui`'s own gh#1563 shape). Closes the gap PR #1569 flagged as a follow-up once `menu-item-ui` converged onto `description`. See [§ Shipped in `0.8.43` — `action-item-ui[description]` ADR-0063 convergence](#upcoming--action-item-uidescription-adr-0063-convergence-090-gh1571).
+
+- **Shipped in `0.8.43` (three 0.8.41-era deprecated components removed — `toggle-group-ui`/`toggle-option-ui`, `progress-row-ui`, `datetime-picker-ui`, gh#1617)** — **BREAKING.** Each shipped its `status: deprecated` soft-deprecation additively in `0.8.41` (its own entry below); all three are now removed outright per the same operator ruling (gh#1562, IDR-0004 deviation). None of the three tags register as custom elements anymore. Migrate: `<toggle-group-ui value>` + `<toggle-option-ui>` children → `<segmented-ui multiple value>` + `<segment-ui>` children (`<toggle-group-ui single>` → plain `<segmented-ui>`, no `[multiple]`); `<progress-row-ui label value meta>` → `<progress-ui label value meta>` (mechanical tag rename); `<datetime-picker-ui>` → `<calendar-picker-ui precision="minute">`. See [§ Shipped in `0.8.43` — three 0.8.41-era deprecated components removed](#shipped-in-0843--three-0841-era-deprecated-components-removed-toggle-group-uitoggle-option-ui-progress-row-ui-datetime-picker-ui-gh1617).
+
 Live demos and per-component docs at [ui-kit.exe.xyz/site/](https://ui-kit.exe.xyz/site/). The `adia-ui-migration` skill (in `.agents/skills/`) automates most of the mechanical sweeps in this guide.
 
 ---
@@ -745,9 +753,9 @@ finding, [gh#1363](https://github.com/adiahealth/gen-ui-kit/issues/1363).
 | `<input-ui type="search">` | `<search-ui>` (built-in magnifying-glass icon, clear button, debounced `search` event) |
 | `<input-ui type="date">` | `<calendar-picker-ui>` (single-date, day granularity) |
 | `<input-ui type="month">` / `type="week"` | `<calendar-picker-ui>` — no dedicated month/week-granularity primitive exists in the catalog; day granularity is the closest routed primitive |
-| `<input-ui type="datetime-local">` | `<datetime-picker-ui>` |
+| `<input-ui type="datetime-local">` | `<calendar-picker-ui precision="minute">` (`<datetime-picker-ui>` was a thin compat alias, cut in 0.8.43, gh#1617) |
 | `<input-ui type="time">` | `<time-picker-ui>` |
-| `<input-ui type="color">` | `<color-input-ui>` (compact form-row swatch + popover) — or `<color-picker-ui>` directly for a full-surface editor (Tokens-Studio-style canvas) |
+| `<input-ui type="color">` | `<color-input-ui>` (compact form-row swatch + popover) — or `<color-area-ui>` directly for a full-surface editor (Tokens-Studio-style canvas; `<color-picker-ui>` was likewise cut in 0.8.43, gh#1617) |
 | `<input-ui>` (no type, or `text`/`email`/`password`/`number`/`tel`/`url`) | unchanged |
 
 The routed primitives are NOT drop-in attribute-compatible with
@@ -1650,6 +1658,235 @@ npm run check
 
 ---
 
+## Shipped in `0.8.43` — ADR-0063 attribute-grammar addendum (chart no-*, chart-legend[interactive], pane[edge], color-area-ui, menu-item[description], gh#1377/gh#1563/gh#1617)
+
+**BREAKING.** The additive dual-read compat shims shipped in `0.8.42`
+(previous entry below); this cut removes the deprecated old spellings per
+the operator ruling recorded on gh#1562 (IDR-0004 deviation) that lifted
+all 0.9.0-parked breaking cuts onto `0.8.43`.
+[ADR-0063](../../docs/ops/adr/adr-0063-attribute-grammar-addendum.md)
+ratified six decisions from the catalog-regularity audit
+([gh#1363](https://github.com/adiahealth/gen-ui-kit/issues/1363)); this
+entry covers the five identifiers gh#1563's own build scope named. (The
+sixth — `agent-reasoning-ui[status]`'s `done`→`completed` stage-terminal
+convergence — and the `alert`/`card`/`drilldown`/`noodles` decision-2
+items ship under their own separately-scoped follow-up tickets, not
+this one.)
+
+### What changed (BREAKING, 0.8.43)
+
+| Component | Old (removed) | New (sole spelling) | Shape |
+|---|---|---|---|
+| `<chart-ui>` | `[hide-average]` | `[no-average]` | straight rename, same polarity |
+| `<chart-ui>` | `[hide-grid]` | `[no-grid]` | straight rename, same polarity |
+| `<chart-ui>` | `[hide-values]` | `[no-values]` | straight rename, same polarity |
+| `<chart-legend-ui>` | `[static]` (opt-out) | `[interactive]` (opt-in) | polarity flip — **default still NOT flipped**, see below |
+| `<pane-ui>` | `[side]` | `[edge]` | straight rename, same type/default/enum (`drawer-ui[side]` is untouched — different component, different vocabulary) |
+| `<menu-item-ui>` | `[subtitle]` prop | `[description]` prop | straight rename — the `subtitle` **slot** is a separate surface, deliberately left unrenamed |
+| `<color-picker-ui>` (tag) | `color-picker-ui` / `ColorPicker` / `UIColorPicker` | `color-area-ui` / `ColorArea` / `UIColorArea` | tag/component/class removed outright (B11, picker-naming convention) — `color-area-ui` is the sole tag now |
+
+The old names/tag no longer resolve: `[hide-average]`/`[hide-grid]`/
+`[hide-values]` are inert attributes on `<chart-ui>` (no property, no
+dual-read); `<chart-legend-ui>`'s `[static]` is likewise inert;
+`<pane-ui>`'s `[side]` is inert; `<menu-item-ui>`'s `[subtitle]` PROP is
+inert (the `subtitle` **slot** is unchanged); and `<color-picker-ui>` no
+longer registers as a custom element at all — `<color-area-ui>` is the
+sole tag, class, and catalog identity.
+
+**`chart-legend-ui[interactive]`'s default is still NOT flipped in this
+release.** `[interactive]` defaults `true` — a `<chart-legend-ui>` naming
+neither attribute renders exactly as it does today (interactive
+`<button>`-role rows). The ADR's own "default-inversion" consumer-scan
+requirement — every `<chart-legend-ui>` tag, with or without the
+attribute, reviewed for whether omission was relying on the old default —
+remains open and is out of this ticket's scope (gh#1617); it ships under
+its own separately-scoped follow-up.
+
+### Migration (mechanical — already applied repo-wide in gh#1617)
+
+```bash
+git grep -l 'hide-average\|hide-grid\|hide-values' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/\bhide-average\b/no-average/g; s/\bhide-grid\b/no-grid/g; s/\bhide-values\b/no-values/g'
+
+git grep -l '<pane-ui\b' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/(<pane-ui\b[^>]*\b)side=/\1edge=/g'
+
+git grep -l '<menu-item-ui\b' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/(<menu-item-ui\b[^>]*\b)subtitle=/\1description=/g'
+
+git grep -rl 'color-picker-ui\|UIColorPicker' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/color-picker-ui/color-area-ui/g; s/UIColorPicker/UIColorArea/g'
+```
+
+Every `<chart-legend-ui>` tag still needs a manual (not mechanical)
+review pass: add `[interactive]` explicitly wherever the page relied on
+the current "interactive by default" behavior, ahead of the still-open
+default-inversion follow-up.
+
+**Find every remaining consumer site (external consumers upgrading from
+pre-0.8.42):**
+
+```bash
+npm run qa:contract-migration-scan -- --roots packages,apps,playgrounds,site,site-a2ui \
+  --base <pre-upgrade-ref> --head <post-upgrade-ref>
+rg -nU 'hide-average|hide-grid|hide-values|<pane-ui\b[^>]*\bside=|<menu-item-ui\b[^>]*\bsubtitle=|color-picker-ui|UIColorPicker' \
+  -g '!**/dist/**' -g '!**/*.a2ui.json' -g '!docs/adr/**'
+```
+
+`--roots packages,apps,playgrounds,site,site-a2ui` is required (not the
+scanner's own default) — `site-a2ui/` is a separate top-level directory
+the default roots miss entirely (ADR-0063's own consumer-scan
+mechanism section explains why).
+
+### Rejected / deferred (explicitly out of gh#1617's scope)
+
+- `segmented-ui[multiple]`'s comma-separated value encoding — sanctioned
+  as-is (operator ruling, gh#1563, 2026-08-17).
+- `chart-legend-ui[interactive]`'s default-inversion to `false` — the
+  ADR's own consumer-scan requirement is still unmet; ships under its own
+  separately-scoped follow-up, not this ticket.
+- `drilldown-ui[static]` → `[no-slide-transition]`, `alert-ui[dismissible]`
+  retirement, `card-ui[outline]` retirement,
+  `agent-reasoning-ui[status="done"]` → `"completed"`, and
+  `noodles-ui[port-size]`/`[show-ports]` duplicate-entry cleanup — all
+  real ADR-0063 decisions, each its own separately-scoped follow-up
+  build, not part of this ticket's scope.
+- `menu-item-ui`'s `subtitle` **slot** (distinct from the prop) — left
+  unrenamed by design; renaming a slot is a different, unscoped surface.
+
+### Verify
+
+```bash
+npm run qa:contract-migration-scan -- --roots packages,apps,playgrounds,site,site-a2ui \
+  --base <pre-upgrade-ref> --head <post-upgrade-ref>
+node scripts/build/components.mjs --verify
+npm run check
+```
+
+---
+
+## Shipped in `0.8.43` — `action-item-ui[description]` ADR-0063 convergence (gh#1571/gh#1617)
+
+**BREAKING.** The additive dual-read compat shim shipped ahead of this cut
+(previous entry below); this cut removes the deprecated `[subtitle]` prop
+per the operator ruling recorded on gh#1562 (IDR-0004 deviation) that
+lifted all 0.9.0-parked breaking cuts onto `0.8.43`. This closes the gap
+[PR #1569](https://github.com/adiahealth/gen-ui-kit/pull/1569) itself
+flagged under its own "Rejected/deferred" section: once `<menu-item-ui>`
+converged its `subtitle` prop onto `description`
+([ADR-0063](../../docs/ops/adr/adr-0063-attribute-grammar-addendum.md),
+gh#1563), `<action-item-ui>` became the corpus's remaining sole `subtitle`
+outlier — the same shape of defect ADR-0063 fixed for menu-item.
+
+### What changed (BREAKING, 0.8.43)
+
+| Component | Old (removed) | New (sole spelling) | Shape |
+|---|---|---|---|
+| `<action-item-ui>` | `[subtitle]` prop | `[description]` prop | straight rename — the `subtitle` **slot** is a separate surface, deliberately left unrenamed |
+
+`[description]` is now the only prop — `[subtitle]` no longer resolves,
+mirrors, or warns (it is an inert attribute; the `subtitle` **slot** is
+unaffected and still renders custom content the same way it always did).
+
+### Migration (mechanical — already applied repo-wide in gh#1617)
+
+```bash
+git grep -l '<action-item-ui\b' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/(<action-item-ui\b[^>]*\b)subtitle=/\1description=/g'
+```
+
+**Find every remaining consumer site (external consumers upgrading from
+pre-0.8.43):**
+
+```bash
+npm run qa:contract-migration-scan -- --roots packages,apps,playgrounds,site,site-a2ui \
+  --base <pre-upgrade-ref> --head <post-upgrade-ref>
+rg -nU '<action-item-ui\b[^>]*\bsubtitle=' \
+  -g '!**/dist/**' -g '!**/*.a2ui.json' -g '!docs/adr/**'
+```
+
+### Rejected / deferred
+
+- `action-item-ui`'s `subtitle` **slot** (distinct from the prop) — left
+  unrenamed by design, same as `menu-item-ui`'s own gh#1563 shape;
+  renaming a slot is a different, unscoped surface.
+
+### Verify
+
+```bash
+npm run qa:contract-migration-scan -- --roots packages,apps,playgrounds,site,site-a2ui \
+  --base <pre-upgrade-ref> --head <post-upgrade-ref>
+node scripts/build/components.mjs --verify
+npm run check
+```
+
+---
+
+## Shipped in `0.8.43` — three 0.8.41-era deprecated components removed (toggle-group-ui/toggle-option-ui, progress-row-ui, datetime-picker-ui, gh#1617)
+
+**BREAKING.** These three components shipped their `status: deprecated`
+soft-deprecation additively in `0.8.41` (each entry above) — behavior
+unchanged, a one-time `console.warn`, kept fully working. This cut removes
+them outright, per the operator ruling recorded on gh#1562 (IDR-0004
+deviation) that lifted all 0.9.0-parked breaking cuts onto `0.8.43`. Each
+alias's successor shipped ≥1 release before `0.8.43` (`0.8.41`, with
+`0.8.42` released in between) — the maturity guard gh#1617 verified
+against CHANGELOG/git history before cutting.
+
+### What changed (BREAKING, 0.8.43)
+
+| Removed component | Successor | Migration |
+|---|---|---|
+| `<toggle-group-ui>` + `<toggle-option-ui>` | `<segmented-ui multiple>` + `<segment-ui>` | `<toggle-group-ui value="…">` + `<toggle-option-ui>` children → `<segmented-ui multiple value="…">` + `<segment-ui>` children (identical comma-separated `value` encoding; `text`/`icon`/`disabled` map directly). `<toggle-group-ui single value="…">` → `<segmented-ui value="…">` (no `[multiple]`) |
+| `<progress-row-ui>` | `<progress-ui label meta>` | `<progress-row-ui label="…" value="…" meta="…">` → `<progress-ui label="…" value="…" meta="…">` (mechanical tag rename, identical attribute names). `variant` (color-family prop) has no successor — recolor via `--progress-fill` |
+| `<datetime-picker-ui>` | `<calendar-picker-ui precision="minute">` | `<datetime-picker-ui>` → `<calendar-picker-ui precision="minute">` (or `precision="second"`) |
+
+None of the three tags register as custom elements anymore — mounting
+one is inert markup (no upgrade, no shadow/light DOM stamped). The A2UI
+catalog identities `ToggleGroup`, `ToggleOption`, `ProgressRow`, and
+`DatetimePicker` are removed from `registry.js`; generation should never
+emit them.
+
+**Behavioral gap carried over from the `0.8.41` entry:** `<toggle-group-ui
+single>`'s clear-on-reclick has no `<segmented-ui>` equivalent — see the
+`0.8.41` entry above for the capture-phase workaround if a migrated
+consumer relied on it.
+
+### Migration (mechanical)
+
+```bash
+git grep -l '<toggle-group-ui\|<toggle-option-ui' -- packages apps playgrounds site site-a2ui \
+  -g '!*CHANGELOG*.md' -g '!**/dist/**' -g '!*.examples.md' -g '!*MIGRATION*' -g '!.claude/docs/**'
+# Rewrite by hand — this is a tag + structural rename, not an attribute
+# rename: parent AND child tags change, and `single` mode maps to
+# segmented-ui's OWN single-select (absence of [multiple]), not a prop.
+
+git grep -l '<progress-row-ui\b' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/<progress-row-ui\b/<progress-ui/g; s/<\/progress-row-ui>/<\/progress-ui>/g'
+
+git grep -l '<datetime-picker-ui\b' -- packages apps playgrounds site site-a2ui \
+  | xargs perl -pi -e 's/<datetime-picker-ui(\s|>)/<calendar-picker-ui precision="minute"\1/g; s/<\/datetime-picker-ui>/<\/calendar-picker-ui>/g'
+```
+
+**Find every remaining consumer site (external consumers upgrading from
+pre-0.8.43):**
+
+```bash
+rg -nU '<toggle-group-ui[^>]*>|<toggle-option-ui[^>]*>|<progress-row-ui[^>]*>|<datetime-picker-ui[^>]*>' \
+  -g '!*CHANGELOG*.md' -g '!**/dist/**' -g '!*.examples.md' -g '!*MIGRATION*' -g '!.claude/docs/**'
+```
+
+A hit means a broken page — none of these three tags register anymore.
+
+### Verify
+
+```bash
+node scripts/build/components.mjs --verify
+npm run check
+```
+
+---
+
 ## Migrating to `@adia-ai/*@v0.8.23` (2026-07-30)
 
 - **Removed: the `--a-font` alias** (pre-ADR-0035 name, DEPRECATED since the 0.8.x line). Any surviving `font-family: var(--a-font)` goes invalid-at-computed-value-time → `inherit` → UA **serif** — the visible symptom is Times-faced labels on an otherwise-correct page.

package/USAGE.md

@@ -437,7 +437,7 @@ Some primitives emit named events beyond `change`/`input`:
 - `<select-ui>` — emits `action` for option-callbacks with `detail.action`
 - `<search-ui>` — emits `search` after debounce with `detail.value`
 - `<chat-composer>` — emits `composer-submit` on Enter with `detail.value`
-- `<color-picker-ui>` — emits `input` + `change` with rich detail (`{ value, l, c, h, hex, oklch }`)
+- `<color-area-ui>` — emits `input` + `change` with rich detail (`{ value, l, c, h, hex, oklch }`)
 
 Each primitive's yaml lists its complete event surface. Live demos at `https://ui-kit.exe.xyz/site/components/<name>`.
 
@@ -1208,18 +1208,18 @@ When a custom `[slot="header"]` carries action buttons (Copy / Download / Edit),
 
 §206 (v0.5.7) added the `[slot="action"]` / `[slot="actions"]` / `[data-no-toggle]` exclusion list to the toggle-cascade.
 
-### §221f — `<color-picker-ui>` inline pattern
+### §221f — `<color-area-ui>` inline pattern
 
 For a compact swatch-and-popover authoring shape:
 
 ```html
 <popover-ui trigger="click" placement="bottom-start">
   <button-ui slot="trigger" text="" icon="palette" aria-label="Pick a color"></button-ui>
-  <color-picker-ui slot="content" value="oklch(0.7 0.15 220)" alpha="off"></color-picker-ui>
+  <color-area-ui slot="content" value="oklch(0.7 0.15 220)" alpha="off"></color-area-ui>
 </popover-ui>
 ```
 
-The popover handles focus management + click-outside dismiss; the button-ui exposes the right ARIA semantics. `<color-picker-ui>` fires `change` events that bubble through the popover — listen on the popover host.
+The popover handles focus management + click-outside dismiss; the button-ui exposes the right ARIA semantics. `<color-area-ui>` fires `change` events that bubble through the popover — listen on the popover host. (`<color-area-ui>` is the ADR-0063/gh#1563 rename of `<color-picker-ui>`; the old tag was cut in 0.8.43, gh#1617 — this recipe is exactly what `<color-input-ui>` canonicalizes.)
 
 ### §221g — `[data-scheme]` ancestor opt-in for color scheme
 

package/color/index.js

@@ -1,6 +1,6 @@
 /**
  * @adia-ai/web-components/color — color-space conversion + gamut utilities
- * shared between primitives (color-picker, swatch, contrast-badge) and
+ * shared between primitives (color-area, swatch, contrast-badge) and
  * available to consumers as a standalone subpath.
  *
  * §301 (v0.5.12, FEEDBACK-29 re-bucket from v0.6.0). Pure functions; no

package/components/action-list/action-item.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ActionItem.json",
   "title": "ActionItem",
-  "description": "Child of <action-list-ui>. One actionable row — icon + label + optional\nsubtitle, forwards activation to the parent action-list. Row contract\nconverges on <menu-item-ui>: icon/text/subtitle/value/variant/disabled\nprops and icon/text/subtitle/trailing slot overrides (#1363 C5).",
+  "description": "Child of <action-list-ui>. One actionable row — icon + label + optional\ndescription, forwards activation to the parent action-list. Row contract\nconverges on <menu-item-ui>: icon/text/description/value/variant/disabled\nprops and icon/text/subtitle/trailing slot overrides (#1363 C5). (The\ndeprecated `subtitle` prop alias for `description` was cut in 0.8.43 —\nADR-0063, gh#1571/gh#1617.)",
   "type": "object",
   "allOf": [
     {
@@ -13,6 +13,11 @@
     }
   ],
   "properties": {
+    "description": {
+      "description": "Optional secondary description line rendered under the label. Canonical spelling (ADR-0063, gh#1571) replacing `subtitle` — converges action-item onto the same spelling <menu-item-ui> adopted under gh#1563. The deprecated `subtitle` prop alias was cut in 0.8.43 (gh#1617).",
+      "type": "string",
+      "default": ""
+    },
     "component": {
       "const": "ActionItem"
     },
@@ -25,11 +30,6 @@
       "description": "Leading icon name (Phosphor).",
       "type": "string"
     },
-    "subtitle": {
-      "description": "Optional secondary description line rendered under the label.",
-      "type": "string",
-      "default": ""
-    },
     "text": {
       "description": "Action label.",
       "type": "string"
@@ -80,7 +80,7 @@
         "description": "Override the [icon] glyph with a custom slotted element (custom icon-ui, image, avatar). Mutually exclusive with the [icon] attribute — slot child wins."
       },
       "subtitle": {
-        "description": "Custom secondary-line content override; falls through to [subtitle] prop if not slotted."
+        "description": "Custom secondary-line content override; falls through to the [description] prop if not slotted (ADR-0063, gh#1571 — the deprecated [subtitle] prop alias was cut in 0.8.43, gh#1617). The slot's own name is unchanged by that rename — this is a distinct, deliberately-unrenamed surface."
       },
       "text": {
         "description": "Custom label content; falls through to [text] prop if not slotted."

package/components/action-list/action-item.yaml

@@ -17,9 +17,11 @@ category: navigation
 version: 1
 description: |-
   Child of <action-list-ui>. One actionable row — icon + label + optional
-  subtitle, forwards activation to the parent action-list. Row contract
-  converges on <menu-item-ui>: icon/text/subtitle/value/variant/disabled
-  props and icon/text/subtitle/trailing slot overrides (#1363 C5).
+  description, forwards activation to the parent action-list. Row contract
+  converges on <menu-item-ui>: icon/text/description/value/variant/disabled
+  props and icon/text/subtitle/trailing slot overrides (#1363 C5). (The
+  deprecated `subtitle` prop alias for `description` was cut in 0.8.43 —
+  ADR-0063, gh#1571/gh#1617.)
 
 props:
   icon:
@@ -28,8 +30,13 @@ props:
   text:
     description: Action label.
     type: string
-  subtitle:
-    description: Optional secondary description line rendered under the label.
+  description:
+    description: >-
+      Optional secondary description line rendered under the label.
+      Canonical spelling (ADR-0063, gh#1571) replacing `subtitle` —
+      converges action-item onto the same spelling <menu-item-ui> adopted
+      under gh#1563. The deprecated `subtitle` prop alias was cut in
+      0.8.43 (gh#1617).
     type: string
     default: ''
   value:
@@ -55,8 +62,11 @@ slots:
     description: Custom label content; falls through to [text] prop if not slotted.
   subtitle:
     description: >-
-      Custom secondary-line content override; falls through to [subtitle]
-      prop if not slotted.
+      Custom secondary-line content override; falls through to the
+      [description] prop if not slotted (ADR-0063, gh#1571 — the
+      deprecated [subtitle] prop alias was cut in 0.8.43, gh#1617). The
+      slot's own name is unchanged by that rename — this is a distinct,
+      deliberately-unrenamed surface.
   trailing:
     description: >-
       Trailing element pinned to the far edge (shortcut hint, badge, caret).
@@ -82,7 +92,7 @@ a2ui:
   allowedParents:
     - ActionList
   rules:
-    - rule: 'Child of <action-list-ui> — one inline-action row with icon + label + optional subtitle + optional trailing shortcut/badge.'
+    - rule: 'Child of <action-list-ui> — one inline-action row with icon + label + optional description + optional trailing shortcut/badge.'
       reason: 'Action-list cluster contract.'
     - rule: 'Different from <menu-item-ui>: action-items live inline in content surfaces; menu-items live inside <menu-ui> popovers.'
       reason: 'Context boundary.'
@@ -90,5 +100,7 @@ a2ui:
       reason: 'Different intent — actions vs navigation.'
     - rule: 'Use [variant="danger"] exclusively for destructive/irreversible actions (Delete, Remove). Pair danger items with an explicit confirm flow when the action cannot be undone.'
       reason: 'Converged with <menu-item-ui>''s danger-variant guidance (#1363 C5).'
-    - rule: 'Prefer [icon]/[text]/[subtitle] props over slotted markup; use slot="icon"/"text"/"subtitle"/"trailing" only for custom markup (e.g. a slotted <kbd> shortcut hint).'
+    - rule: 'Prefer [icon]/[text]/[description] props over slotted markup; use slot="icon"/"text"/"subtitle"/"trailing" only for custom markup (e.g. a slotted <kbd> shortcut hint).'
       reason: 'Row-contract convergence with <menu-item-ui> (#1363 C5).'
+    - rule: 'NOTE (ADR-0063, gh#1571): the deprecated [subtitle] prop alias for [description] was cut in 0.8.43 (gh#1617) — [description] is the sole prop now.'
+      reason: 'Convergence with <menu-item-ui>''s own subtitle -> description rename (gh#1563).'

package/components/action-list/action-list.class.js

@@ -94,7 +94,12 @@ export class UIActionItem extends UIElement {
   static properties = {
     icon:     { type: String,  default: '', reflect: true },
     text:     { type: String,  default: '', reflect: true },
-    subtitle: { type: String,  default: '', reflect: true },
+    // ADR-0063 (gh#1571) — `description` is canonical (action-item was
+    // the corpus's remaining `subtitle` outlier once <menu-item-ui>
+    // converged under gh#1563); the deprecated `subtitle` PROP dual-read
+    // shim was cut in 0.8.43 (gh#1617). The `subtitle` SLOT (a separate
+    // surface — see action-item.yaml) is unchanged.
+    description: { type: String, default: '', reflect: true },
     value:    { type: String,  default: '', reflect: true },
     variant:  { type: String,  default: 'default', reflect: true },
     disabled: { type: Boolean, default: false, reflect: true },
@@ -143,10 +148,10 @@ export class UIActionItem extends UIElement {
       this.appendChild(span);
     }
 
-    if (this.subtitle && !this.#ownChild('[slot="subtitle"]')) {
+    if (this.description && !this.#ownChild('[slot="subtitle"]')) {
       const sub = this.#stampMark(document.createElement('span'));
       sub.setAttribute('slot', 'subtitle');
-      sub.textContent = this.subtitle;
+      sub.textContent = this.description;
       this.appendChild(sub);
     }
   }
@@ -181,15 +186,16 @@ export class UIActionItem extends UIElement {
     const textEl = this.#ownChild('[slot="text"]');
     if (this.#wasStamped(textEl)) textEl.textContent = this.text;
 
-    // Sync subtitle — only touch elements we stamped.
+    // Sync subtitle (backed by the `description` prop — ADR-0063, gh#1571)
+    // — only touch elements we stamped.
     const subEl = this.#ownChild('[slot="subtitle"]');
-    if (this.subtitle) {
+    if (this.description) {
       if (subEl) {
-        if (this.#wasStamped(subEl)) subEl.textContent = this.subtitle;
+        if (this.#wasStamped(subEl)) subEl.textContent = this.description;
       } else {
         const sub = this.#stampMark(document.createElement('span'));
         sub.setAttribute('slot', 'subtitle');
-        sub.textContent = this.subtitle;
+        sub.textContent = this.description;
         this.appendChild(sub);
       }
     } else if (this.#wasStamped(subEl)) {

package/components/action-list/action-list.d.ts

@@ -34,12 +34,12 @@ export class UIActionList extends UIElement {
 }
 
 export class UIActionItem extends UIElement {
+  /** Optional secondary description line rendered under the label. Canonical spelling (ADR-0063, gh#1571) replacing `subtitle` — converges action-item onto the same spelling <menu-item-ui> adopted under gh#1563. The deprecated `subtitle` prop alias was cut in 0.8.43 (gh#1617). */
+  description: string;
   /** Disables click + keyboard activation; aria-disabled is set. */
   disabled: boolean;
   /** Leading icon name (Phosphor). */
   icon: string;
-  /** Optional secondary description line rendered under the label. */
-  subtitle: string;
   /** Action label. */
   text: string;
   /** Identifier passed to the action-list change/activate handlers. */

package/components/button/button.yaml

@@ -165,7 +165,7 @@ a2ui:
       reason: 'Per existing slot.discipline rule — visual redundancy guard.'
     - rule: 'For navigation (route-change) use <nav-item-ui> or anchor; button-ui is for actions only.'
       reason: 'Action vs navigation semantics.'
-    - rule: 'For toggleable on/off state use <switch-ui>; for multi-select clusters use <segmented-ui multiple> + <segment-ui> (gh#1369 — <toggle-group-ui>/<toggle-option-ui> are deprecated).'
+    - rule: 'For toggleable on/off state use <switch-ui>; for multi-select clusters use <segmented-ui multiple> + <segment-ui> (<toggle-group-ui>/<toggle-option-ui> were cut in 0.8.43, gh#1617, gh#1369).'
       reason: 'Stateless action vs stateful toggle.'
 anti_patterns:
   - description: >-

package/components/calendar-picker/calendar-picker.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/CalendarPicker.json",
   "title": "CalendarPicker",
-  "description": "Date (and, per `[precision]`, date+time) picker with trigger button and popover panel. Form-associated input emitting an ISO date (or, when `precision` is `minute`/`second`, ISO datetime) string via change events; supports min/max and disabled-date masks. Use for single-date or single-datetime input in forms; for date ranges use <date-range-picker-ui> instead of composing two calendar-picker instances. gh#1372 (#1363 C3c) folded <datetime-picker-ui>'s surface into this widened `precision` axis — see the deprecated <datetime-picker-ui> alias.",
+  "description": "Date (and, per `[precision]`, date+time) picker with trigger button and popover panel. Form-associated input emitting an ISO date (or, when `precision` is `minute`/`second`, ISO datetime) string via change events; supports min/max and disabled-date masks. Use for single-date or single-datetime input in forms; for date ranges use <date-range-picker-ui> instead of composing two calendar-picker instances. gh#1372 (#1363 C3c) folded <datetime-picker-ui>'s surface into this widened `precision` axis — that thin alias component was cut in 0.8.43 (gh#1617); this is the sole tag now.",
   "type": "object",
   "allOf": [
     {

package/components/calendar-picker/calendar-picker.class.js

@@ -25,9 +25,8 @@
  * `"minute"`/`"second"` additionally composes `<divider-ui>` +
  * `<time-picker-ui>` as a second pane, `value` becomes a full ISO 8601
  * datetime string, and `hour-cycle`/`step`/`locale` become active — the same
- * contract `<datetime-picker-ui>` shipped, which is now a deprecated thin
- * alias subclass (see datetime-picker.class.js) mapping onto this class with
- * `precision="minute"` by default. Per ADR-0027, the consumer must
+ * contract `<datetime-picker-ui>` shipped; that thin alias subclass was cut
+ * in 0.8.43 (gh#1617) — this is the sole tag now. Per ADR-0027, the consumer must
  * explicitly import every composed primitive (see `composes:` in
  * calendar-picker.yaml) — this class doesn't auto-import them.
  *