@adia-ai/web-components 0.8.47 → 0.8.50

package/CHANGELOG.md

@@ -1,7 +1,57 @@
 # Changelog — @adia-ai/web-components
 
+## [0.8.50] — 2026-08-23
+
+### Added
+- **`stat-ui` KPI tile layout — full-bleed chart band + overlaid delta chip (gh#1835, PR #1920, ADR-0083).** New `[bleed]` (with the existing `[band]`) composition on the chart slot lets the chart reach the card's edges — a right-column bleed alone, a three-edge bottom band together with `band` — with the value/label/change stack overlaying it. New public CSS custom properties: `--stat-change-inset`, `--stat-change-size`, and the six `--stat-change-chip-*` tokens (`bg`, `fg`, `font-size`, `pad-x`, `pad-y`, `radius`). (Entry added at cut time — PR #1920 merged without one.)
+
+### Removed
+- **BREAKING: `[prose]`/`[verse]` deprecated attribute sheets removed (gh#1885, closes gh#1822).** `styles/prose.css` and `styles/verse.css` — deprecated since v0.8.11 in favor of the ancestor `[scale]` register — are deleted outright, along with the `[prose]`/`[verse]` HTML attributes, `<theme-provider scale="prose"|"verse">`'s legacy alias mapping, and the a2ui catalog's deprecated `prose` `DynamicBoolean` prop (`common_types.json`). No deprecation alias — use `scale="content-md"` / `scale="ui-sm"` (byte-identical rendering). Migration guide: `.claude/docs/MIGRATION GUIDE.md` § Shipped in `0.8.50`. Ships in this PATCH cut per Kim ruling of 2026-08-23 PDT, held-items entry dated 2026-08-24 UTC (recorded invariant-7/IDR-0004 deviation).
+
+### Changed
+- **BREAKING: `input-ui`/`search-ui` fill-default sizing posture, `[inline]` hugs (ADR-0077, Steps 1-2, gh#1856).** A form control dropped into a flex toolbar row with no explicit width/flex collapsed to its content/floor width instead of filling the row's remaining space, because `input-ui`'s 20ch legibility floor (gh#781) applied unconditionally on the plain `:scope` — fighting any container that wanted to size it (same root-cause class as gh#1633's select-ui/combobox-ui collapse). `input-ui`'s `:scope` now fills (`width: 100%`) by default; `--input-min-width` moves to `:scope[inline]`, which also flips to inline-level display + `fit-content` per ADR-0037 §2 hug mechanics. `search-ui` gets the same fill-default posture on its own host and forwards its `[inline]` attribute onto its internal `<input-ui>` (light-DOM composition, so `:scope[inline]` can't reach across that boundary) via a hand-rolled `observedAttributes`/`attributeChangedCallback`. `select-ui`/`combobox-ui`/`date-range-picker-ui` remain on the old posture, scheduled as later plan waves (`docs/ops/plan/plan-form-control-sizing.md`). See `.claude/docs/MIGRATION GUIDE.md`.
+
+### Maintenance
+- **`components/` touched in this release window** (38 file(s), e.g. `chart/chart.class.js`) — carried by the entries above.
+- **`core/` touched in this release window** (2 file(s), e.g. `core/element.js`) — carried by the entries above.
+- **`dist/` bundles rebuilt** in this cut's window (8 file(s)) — regenerated from the source changes described above, not independent edits.
+
+## [0.8.48] — 2026-08-23
+
+### Added
+- **`table-ui`/`table-footer-ui`/`table-toolbar-ui` range grammar — `open-total`, `range-of`, `range-noun` (gh#1877), ADR-0082 Amendment.** Server-side pagination's range summary ("1–20 of 200") gets three composable authoring knobs: `open-total` drops the known-total suffix for unbounded/streamed counts, `range-of` swaps the connector word, `range-noun` supplies the counted-thing label — wired through `components/table/table.css`, `components/table-footer/table-footer.js`, and `components/table-toolbar/table-toolbar.js` (#1890).
+- **`table-toolbar-ui[title-always]` opt-out for the scope-reconciliation title hide (gh#1879).** The `:has([data-scope]:not(:empty)) [data-title]` reconciliation rule (landed in 0.8.47) drops the title whenever a scope chip is present; `title-always` opts a toolbar out so the title survives alongside scope chips (#1880).
+
+### Changed
+- **`link-ui`/`anchor-ui`-bearing surfaces get hover tokens, transitions, and a new `--link-fg-disabled` (gh#1881).** Every anchor-bearing component now declares `--link-fg-hover`/`--link-fg-active` plus a `color`/`text-decoration-color` transition instead of relying on inherited defaults; `--link-fg-disabled` fills the missing disabled-state role (#1887).
+- **`[prose]`/`[verse]` live usages swept to `scale=` (gh#1822).** Component demos and yaml examples using the deprecated `[prose]`/`[verse]` attribute pair migrated to the `scale=` contract ratified in an earlier cut (#1874).
+
+### Fixed
+- **`card-ui` preserves footer top inset in content-sized cards (gh#1866).** A content-sized (non-fixed-height) card's footer lost its top inset because the inset was conditioned on a fixed-height layout branch that content-sized cards never take; the inset now applies unconditionally (`components/card/card.css`) (#1875).
+- **A2UI runtime stops stamping synthetic `.id` onto elements with no authored id.** `resolve-node.js`'s synthetic-id path was firing for every unauthored element, polluting the DOM with runtime-only ids that leaked into snapshot tests and event targeting; now only elements that need an id for event wiring get one (#1872).
+- **A2UI runtime reflects `JS_PROPS` as JSON attributes alongside property writes (gh#1858).** `prop-apply.js` wrote JS property values but skipped the matching attribute reflection for `JS_PROPS`-classified props, so attribute-based selectors and SSR snapshots saw a stale value; both now update together (#1870).
+- **`themes.css`/`material-static.css` theme-scoped semantic alias resolution under descendant `[theme]` scopes (gh#1863).** A `--a-*` semantic alias resolved against the wrong `[theme]` ancestor when a themed subtree nested inside another themed subtree; two new gates guard the resolution order (#1873).
+
+### Docs
+- **`site/components/table-toolbar` canonical sample composes the toolbar as a `card-ui` header (#1884).** Replaces the prior bare-toolbar sample with the pattern most consumers actually use.
+- **`components/chart/chart.yaml` `ratio=` comment repaired** — the per-type wave landed in an earlier cut; the yaml comment still described the old single-ratio contract (#1871).
+
+### Maintenance
+- **`dist/` bundles rebuilt** in this cut's window — regenerated from the source changes described above, not independent edits.
+- **`styles/` touched in this release window** (`colors/material-static.css`, `themes.css`) — carried by the theme-scoped alias fix above (gh#1863, #1873).
+
 ## [0.8.47] — 2026-08-22
 
+### Changed
+- **`nav-group-ui`/`nav-item-ui`/`nav-ui` token simplification (gh#1740, gh#459, gh#1736).** `nav-group-ui` header text settles on one unconditional NEUTRAL-HIGH (`--nav-group-fg-active` deleted; `--nav-group-fg-selected` kept for the popover's current-option row); `nav-ui[data-nav-label]` moves from `--a-fg-muted` to plain NEUTRAL with retuned padding (top 16 / sides 4 / bottom 8). Dev server: `vite.config.js` gets an explicit `server.fs.allow`/`deny` — fixes vite's default `**/.git/**` deny blocking its own `/@vite/client` after resolving pnpm symlinks into a bootstrapped worktree's shared store (#1853).
+
+### Fixed
+- **`material-static.css`'s identical-leg `light-dark()` roles dropped; stale `themes.css` dead-code claim corrected (gh#1852).** ~224 solid-fill/hover/active/on-*/alpha-family `--md-sys-color-*` roles wrapped in a no-op `light-dark()` (both legs identical) — unwrapped. The header's second claim, that `themes.css` ships a dead divergent neutral ramp, was a false premise on investigation (a themed ancestor's override wins via ordinary custom-property inheritance, verified in Playwright) — corrected in place rather than deleting live theming infrastructure (#1854).
+- **`table-toolbar-ui[size]` prop, overflow-trigger cascade tie, and three min-width floor fights.** New `size` prop wired via ambient CSS inheritance; the `[data-toolbar-overflow]` cascade tie with `menu-ui`'s base rule (redundant "More" trigger re-render) fixed; `:has([data-scope]:not(:empty)) [data-title]` reconciliation drops a duplicate title/count cluster; toolbar/input/select/menu min-width floors reconciled (#1855).
+- **`core/anchor.js` popover-anchor reuse guard (all 12 consumers).** A trigger reused as the anchor for a second popover had its anchor-name clobbered by the first popover's async close-cleanup, landing the second popover at the viewport origin — fixed with an ownership guard in the cleanup closure (284 consumer tests green) (#1855).
+
+### Docs
+- **`site/components/table-toolbar` side-by-side docs demos.** `[data-preview-split]` opt-in pairs a demo's live render with its authored HTML side by side; table-toolbar visual goldens re-baselined after the verified layout fixes (#1855).
 
 ### Maintenance
 - **`components/` touched in this release window** (12 file(s), e.g. `nav-group/nav-group.css`) — carried by the entries above.

package/MIGRATION.md

@@ -90,6 +90,10 @@ Version cuts and migration scope:
 
 - **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).
 
+- **Shipped in `0.8.50` (Kim ruling of 2026-08-23 PDT (held-items entry dated 2026-08-24 UTC) — invariant-7/IDR-0004 recorded deviation, ships in a PATCH cut)** — **BREAKING:** the `[prose]`/`[verse]` deprecated attribute sheets (`styles/prose.css`, `styles/verse.css`, deprecated since `0.8.11`) are removed outright, with no deprecation alias — `[prose]`/`[verse]` and `<theme-provider scale="prose"|"verse">` no longer resolve. Use `scale="content-md"` / `scale="ui-sm"` instead (byte-identical rendering). The a2ui catalog's deprecated `prose` `DynamicBoolean` prop is also dropped from `common_types.json`. (gh#1885, closing gh#1822.) See [§ Shipped in `0.8.50` — `[prose]`/`[verse]` sheets removed](#shipped-in-0850--proseverse-sheets-removed-gh1885-gh1822).
+
+- **Shipped in `0.8.50` (`input-ui`/`search-ui` fill-default sizing posture, ADR-0077, gh#1856)** — **BREAKING, no deprecation alias.** A form control dropped into a flex toolbar row with no explicit width/flex used to collapse to its content/floor width instead of filling the row's remaining space (visible as clipped search placeholder text in consumer admin surfaces), because `input-ui`'s 20ch legibility floor (gh#781) applied unconditionally on the plain `:scope`. `<input-ui>`'s `:scope` now fills (`width: 100%`) by default; the old floor (`--input-min-width`) moves to `:scope[inline]`, which also switches to inline-level display + `fit-content` per ADR-0037 §2 hug mechanics. `<search-ui>` gets the same fill-default posture and forwards `[inline]` onto its internal `<input-ui>`. Migration: any consumer relying on the old shrink-wrap default (e.g. an unconstrained `<input-ui>`/`<search-ui>` inline among text, expecting it to hug its content) must add `[inline]` explicitly. `select-ui`/`combobox-ui`/`date-range-picker-ui` are unaffected — same old posture, later plan waves. See [§ Shipped in `0.8.50` — input-ui/search-ui fill-default sizing posture](#shipped-in-0850--input-uisearch-ui-fill-default-sizing-posture-adr-0077-gh1856).
+
 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.
 
 ---
@@ -1887,6 +1891,138 @@ npm run check
 
 ---
 
+## Shipped in `0.8.50` — `[prose]`/`[verse]` sheets removed (gh#1885, gh#1822)
+
+**BREAKING, no deprecation alias.** `styles/prose.css` and `styles/verse.css`
+— deprecated since `0.8.11` in favor of the ancestor `[scale]` register — are
+removed outright (gh#1885, closing gh#1822's open question). The `[prose]`/
+`[verse]` HTML attributes and `<theme-provider scale="verse">`/
+`scale="prose"`'s legacy aliases no longer resolve to anything. All live
+in-repo usage had already migrated to `scale="content-md"`/`scale="ui-sm"`
+in PR #1874; this cut deletes the byte-identical fallback sheets those
+attributes depended on.
+
+### `[prose]` → `scale="content-md"` (`prose` → `content-md`)
+
+`[prose]` was the long-form/reading register — byte-identical to
+`scale="content-md"`.
+
+**Audit:**
+```bash
+git grep -nE '\[prose\]|<[a-z-]+ prose\b|prose="'
+```
+
+**Sweep:**
+```bash
+git grep -lz -E '\bprose\b' -- '*.html' '*.js' | while IFS= read -r -d '' f; do
+  perl -i -pe 's/\bprose(=""|="true")?\b(?!-)/scale="content-md"/g if /<[a-z-]+[^>]*\bprose\b/' "$f"
+done
+# Boolean-attribute rewrites are structural, not string-substitutable in
+# general — review each hit; the sweep above only rewrites the exact
+# `<tag prose>` / `<tag prose="">` shape. A theme-provider scale="prose"
+# call site is a plain value rename instead:
+git grep -lz 'scale="prose"' | while IFS= read -r -d '' f; do
+  perl -i -pe 's/scale="prose"/scale="content-md"/g' "$f"
+done
+```
+
+### `[verse]` → `scale="ui-sm"` (`verse` → `ui-sm`)
+
+`[verse]` was the dense/compact-product-UI register — byte-identical to
+`scale="ui-sm"`.
+
+**Audit:**
+```bash
+git grep -nE '\[verse\]|<[a-z-]+ verse\b|verse="'
+```
+
+**Sweep:**
+```bash
+git grep -lz -E '\bverse\b' -- '*.html' '*.js' | while IFS= read -r -d '' f; do
+  perl -i -pe 's/\bverse(=""|="true")?\b(?!-)/scale="ui-sm"/g if /<[a-z-]+[^>]*\bverse\b/' "$f"
+done
+git grep -lz 'scale="verse"' | while IFS= read -r -d '' f; do
+  perl -i -pe 's/scale="verse"/scale="ui-sm"/g' "$f"
+done
+```
+
+### The a2ui catalog `prose` prop is gone too
+
+`common_types.json`'s deprecated `prose` `DynamicBoolean` prop (mapped onto
+the legacy `[prose]` attribute) is removed from `ComponentCommon`. Generated
+a2ui documents carrying `"prose": true` on any node no longer validate —
+regenerate via the composer, or hand-migrate to an ancestor
+`{"component": "ThemeProvider", "scale": "content-md"}` wrapper.
+
+### Verify
+
+```bash
+git grep -nE '\[prose\]|\[verse\]|prose-ui|verse-ui|prose\.css|verse\.css' \
+  -- ':!CHANGELOG.md' ':!**/CHANGELOG*.md' ':!docs/ops/releases/**' \
+  ':!.claude/ops/**' ':!**/HANDOFF*.md' ':!**/BUILD.md' \
+  ':!.claude/docs/specs/cascade-layer-architecture.md' \
+  ':!.claude/docs/MIGRATION GUIDE.md' ':!packages/web-components/MIGRATION.md'
+node scripts/build/components.mjs --verify
+npm run check
+```
+
+---
+
+## Shipped in `0.8.50` — `input-ui`/`search-ui` fill-default sizing posture (ADR-0077, gh#1856)
+
+**BREAKING, no deprecation alias.** A form control dropped into a flex
+toolbar row with no explicit width/flex collapsed to its content/floor
+width instead of filling the row's remaining space (visible as clipped
+search placeholder text in consumer admin surfaces), because `input-ui`'s
+20ch legibility floor (gh#781) applied unconditionally on the plain
+`:scope`, fighting any container that wanted to size it. Same root-cause
+class as gh#1633's select-ui/combobox-ui collapse.
+
+Implements Steps 1-2 of `docs/ops/plan/plan-form-control-sizing.md` against
+the ratified `docs/ops/adr/adr-0077-form-control-sizing-posture.md` /
+`spec-form-control-sizing-posture`: form controls fill their container by
+default; `[inline]` opts into the old shrink-wrap/hug behavior, where the
+legibility floor now lives instead of on every state.
+
+### What changed
+
+- **`input-ui`** — `:scope` fills (`width: 100%`) by default; `--input-min-width`
+  moves to `:scope[inline]`, which also flips to inline-level display +
+  `fit-content` per ADR-0037 §2 hug mechanics.
+- **`search-ui`** — same fill-default posture on its own host. Forwards its
+  `[inline]` attribute onto the internal `<input-ui>` (light-DOM
+  composition — CSS `:scope[inline]` can't reach across that boundary) via
+  a hand-rolled `observedAttributes`/`attributeChangedCallback`.
+- **Unaffected:** `select-ui`/`combobox-ui`/`date-range-picker-ui` remain on
+  the old posture — scheduled as later `plan-form-control-sizing.md` waves.
+
+### Migration
+
+Any consumer relying on the previous shrink-wrap default — an unconstrained
+`<input-ui>`/`<search-ui>` placed inline among text or in a layout that
+expected it to hug its content rather than stretch — must add `[inline]`
+explicitly:
+
+```html
+<!-- before (0.8.48 and earlier): hugged its content by default -->
+<input-ui placeholder="Search…"></input-ui>
+
+<!-- after: fills its container by default; opt into the old hug -->
+<input-ui inline placeholder="Search…"></input-ui>
+```
+
+A control already given an explicit width, or already inside a container
+that constrains it (a `card-ui`, a fixed-width `field-ui`), needs no change.
+
+### 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/components/card/card.css

@@ -76,8 +76,30 @@
     display: flex;
     flex-direction: column;
   }
+  /* Explicit (not left to the base `& > footer` rule further down) so this
+     value is the one that wins regardless of declaration order — kept
+     alongside the bottom-pin spacer it replaces, gh#1866. */
   :scope > footer {
-    margin-top: auto;
+    margin-block-start: var(--card-inset);
+  }
+
+  /* Bottom-pin (gh#559), preserved WITHOUT sacrificing the footer's own
+     top inset (gh#1866). The old approach put `margin-top: auto` directly
+     on the footer: that absorbs FREE SPACE in an equal-height grid/flex
+     row (the pin), but a content-sized card has none to absorb, so the
+     auto margin resolved to 0 and the footer lost its --card-inset gap
+     entirely — every OTHER region kept its inset, only the footer didn't.
+     Moving the auto margin to the region immediately before the footer
+     keeps both behaviors distinct: that region still soaks up any
+     leftover height (still bottom-pinning the footer in an equal-height
+     card), while the footer's own margin-block-start above stays the
+     ordinary --card-inset in every card, content-sized included.
+     `:has(+ footer)` (not `:last-of-type`) so exactly the ONE region
+     directly adjacent to the footer gets the spacer — `:last-of-type` would
+     match the last header AND the last section independently when both are
+     present, splitting the auto margin across two elements instead of one. */
+  :scope:has(> footer) > :is(header, section):has(+ footer) {
+    margin-block-end: auto;
   }
 
   /* Flex containers never collapse adjacent margins the way block flow
@@ -87,7 +109,8 @@
      single inset block flow would have collapsed them to. The leading
      region's own margin-bottom already supplies that inset; zero the
      trailing region's margin-top. footer is excluded — its margin-top is
-     handled above (bottom-pin `auto`) or by [divider] below. */
+     handled above (its own explicit --card-inset, gh#1866) or by
+     [divider] below. */
   :scope:has(> footer) > :is(header, section) + :is(header, section) {
     margin-block-start: 0;
   }

package/components/chart/chart.a2ui.json

@@ -118,7 +118,7 @@
       "default": false
     },
     "ratio": {
-      "description": "Chart 2.0 aspect-ratio bucket (ADR-0074). Unset (default) auto-snaps to the nearest of the three studied ratios by comparing the chart's own live box aspect against two midpoint boundaries (5:4 between 3:2/1:1, 4:5 between 1:1/2:3) — never interpolated; the resolved bucket reflects onto the host as `data-ratio-resolved`. Setting `ratio` explicitly pins that bucket regardless of the box's actual aspect, overriding the auto-snap. Orthogonal to `size` (overall scale) and `type`/`color` (ADR-0064's family axis) — this attribute lands the grammar + snap plumbing only; per-type studied renderings per bucket are later waves (gh#1624 plan steps 2-4).",
+      "description": "Chart 2.0 aspect-ratio bucket (ADR-0074). Unset (default) auto-snaps to the nearest of the three studied ratios by comparing the chart's own live box aspect against two midpoint boundaries (5:4 between 3:2/1:1, 4:5 between 1:1/2:3) — never interpolated; the resolved bucket reflects onto the host as `data-ratio-resolved`. Setting `ratio` explicitly pins that bucket regardless of the box's actual aspect, overriding the auto-snap. Orthogonal to `size` (overall scale) and `type`/`color` (ADR-0064's family axis) — per-type studied renderings per bucket shipped across Waves A-C (gh#1624 plan steps 2-4: #1658 bar/line/area/pie/donut/sparkline, #1659 radar/scatter/ radial-bar/gauge/segments/stacked-bar/grouped-bar/multi-line, #1662 funnel/treemap/sankey/composed) — all 18 types have dedicated per-ratio render paths.",
       "type": "string",
       "enum": [
         "3:2",

package/components/chart/chart.class.js

@@ -569,7 +569,14 @@ export class UIChart extends UIElement {
         if (!this.#data.length) return;
         const rw = Math.round(w);
         const rh = Math.round(h);
-        if (rw === this.#lastW && (!this.hasAttribute('resize') || rh === this.#lastH)) return;
+        // gh#1901 — #dims() now trusts a measured clientHeight for EVERY
+        // chart (not only `resize`-attributed ones, see #dims() above), so
+        // a height-only change (e.g. `--stat-chart-band-height` changing,
+        // or the box's own CSS height rule flipping via a media query)
+        // must re-render regardless of the `resize` attribute — gating
+        // height changes behind `resize` froze the viewBox on exactly
+        // that class of change.
+        if (rw === this.#lastW && rh === this.#lastH) return;
         this.#lastW = rw;
         this.#lastH = rh;
         if (this.#resizeRaf) return;
@@ -614,18 +621,42 @@ export class UIChart extends UIElement {
     const n = this.#data.length || 1;
 
     const width = Math.max(containerW, 120);
-    // When element has explicit height (resize handle, CSS height, inline style),
-    // use it. Otherwise derive from aspect ratio. Safe because resize sets
-    // overflow:auto which prevents content from pushing height.
-    const hasExplicitHeight = this.hasAttribute('resize') || this.style.height;
-    // ADR-0074 — an explicit `ratio` PINS the box's own aspect, overriding
-    // whatever height the container/explicit-height path would otherwise
-    // give (REQ-R-002: "regardless of the container's actual aspect
-    // ratio"). Unset falls through to the pre-existing behavior unchanged.
+    // gh#1901 — trust a measured clientHeight above the noise floor
+    // regardless of WHERE the height came from (inline style, the
+    // `resize` handle, or a plain CSS rule like
+    // `stat-ui[band] [slot="chart"] { height: … }`). Checking only
+    // `this.style.height`/`resize` missed the CSS-rule case entirely —
+    // an author can size the box from a stylesheet just as validly as
+    // from an inline style, and #dims() has no way to tell those apart:
+    // `getComputedStyle(this).height` resolves to a used-value px length
+    // for ANY laid-out box (an explicit `height:`, an `aspect-ratio:`
+    // box, OR a plain `align-items:stretch` grid/flex item with no
+    // declared size at all) — there is no computed-style read that
+    // reports "an author declared this" versus "layout resolved this".
+    //
+    // KNOWN TRADE-OFF (gh#1901 review) — because of that, a chart-ui
+    // dropped bare into a generic grid/flex row also gets stretched to
+    // match a taller sibling's track/row, and that stretched height is
+    // trusted the same as a deliberate `height:`/`aspect-ratio:` rule
+    // (see chart.test.js's "ambient grid-stretch height" fixture, which
+    // asserts and documents this rather than hiding it). This is the
+    // same default a plain `<img>`/`<video>` gets in that layout — no
+    // intrinsic size fills whatever the stretched box gives it — and it
+    // is consistent with the intentional stretch-to-bleed already used by
+    // `stat-ui[bleed] [slot="chart"]` (`align-self:stretch; height:auto`,
+    // stat.css), which relies on exactly this same measured-height path.
+    // A narrower heuristic (e.g. gating on a specific computed-style
+    // signal) would have to reject that intentional case too, since
+    // mechanically it is indistinguishable from the accidental one.
+    // Below the 40px floor there's nothing to trust yet (pre-layout/
+    // empty box), so fall back to the aspect-ratio guess; once real
+    // content has rendered once, this stays self-consistent on every
+    // re-measure (a fallback-derived height reproduces the same value
+    // next time).
     const pinnedRatio = CHART_RATIOS[this.ratio];
     let height = pinnedRatio
       ? Math.round(width / pinnedRatio)
-      : hasExplicitHeight && containerH > 40
+      : containerH > 40
         ? containerH
         : Math.round(width / aspect.ratio);
 

package/components/chart/chart.d.ts

@@ -40,7 +40,7 @@ export class UIChart extends UIElement {
   noGrid: boolean;
   /** Hide value labels. Canonical spelling (ADR-0063, gh#1563) — the deprecated `hideValues` dual-read shim was cut in 0.8.43 (gh#1617). */
   noValues: boolean;
-  /** Chart 2.0 aspect-ratio bucket (ADR-0074). Unset (default) auto-snaps to the nearest of the three studied ratios by comparing the chart's own live box aspect against two midpoint boundaries (5:4 between 3:2/1:1, 4:5 between 1:1/2:3) — never interpolated; the resolved bucket reflects onto the host as `data-ratio-resolved`. Setting `ratio` explicitly pins that bucket regardless of the box's actual aspect, overriding the auto-snap. Orthogonal to `size` (overall scale) and `type`/`color` (ADR-0064's family axis) — this attribute lands the grammar + snap plumbing only; per-type studied renderings per bucket are later waves (gh#1624 plan steps 2-4). */
+  /** Chart 2.0 aspect-ratio bucket (ADR-0074). Unset (default) auto-snaps to the nearest of the three studied ratios by comparing the chart's own live box aspect against two midpoint boundaries (5:4 between 3:2/1:1, 4:5 between 1:1/2:3) — never interpolated; the resolved bucket reflects onto the host as `data-ratio-resolved`. Setting `ratio` explicitly pins that bucket regardless of the box's actual aspect, overriding the auto-snap. Orthogonal to `size` (overall scale) and `type`/`color` (ADR-0064's family axis) — per-type studied renderings per bucket shipped across Waves A-C (gh#1624 plan steps 2-4: #1658 bar/line/area/pie/donut/sparkline, #1659 radar/scatter/ radial-bar/gauge/segments/stacked-bar/grouped-bar/multi-line, #1662 funnel/treemap/sankey/composed) — all 18 types have dedicated per-ratio render paths. */
   ratio: '3:2' | '1:1' | '2:3';
   /** 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. */
   seriesEmphasis: string;

package/components/chart/chart.yaml

@@ -105,9 +105,12 @@ props:
       bucket reflects onto the host as `data-ratio-resolved`. Setting
       `ratio` explicitly pins that bucket regardless of the box's actual
       aspect, overriding the auto-snap. Orthogonal to `size` (overall
-      scale) and `type`/`color` (ADR-0064's family axis) — this attribute
-      lands the grammar + snap plumbing only; per-type studied renderings
-      per bucket are later waves (gh#1624 plan steps 2-4).
+      scale) and `type`/`color` (ADR-0064's family axis) — per-type studied
+      renderings per bucket shipped across Waves A-C (gh#1624 plan steps
+      2-4: #1658 bar/line/area/pie/donut/sparkline, #1659 radar/scatter/
+      radial-bar/gauge/segments/stacked-bar/grouped-bar/multi-line, #1662
+      funnel/treemap/sankey/composed) — all 18 types have dedicated
+      per-ratio render paths.
     type: string
     default: ""
     enum:

package/components/input/input.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/Input.json",
   "title": "Input",
-  "description": "Text input field with contenteditable surface. Supports prefix/suffix icons, label, form participation, and a `type=\"number\"` mode that renders [+]/[-] stepper buttons, numeric input filtering, and ARIA spinbutton semantics — no native `<input type=\"number\">` under the hood. Password type uses a native `<input>` (only path that still wraps native, for `-webkit-text-security` disc masking). Has a 20ch minimum width (`--input-min-width`, mirrors the native `<input>` baseline) so a bare, placeholder-only instance stays usable inside a flex row (row-ui) with no explicit sizing — explicit `width`/`flex` or CSS can size the host above the floor; values below the floor remain clamped unless `--input-min-width` is lowered.",
+  "description": "Text input field with contenteditable surface. Supports prefix/suffix icons, label, form participation, and a `type=\"number\"` mode that renders [+]/[-] stepper buttons, numeric input filtering, and ARIA spinbutton semantics — no native `<input type=\"number\">` under the hood. Password type uses a native `<input>` (only path that still wraps native, for `-webkit-text-security` disc masking). Fills its container's available inline width by default (ADR-0077 / spec-form-control-sizing-posture) — in a flex row (row-ui) or grid track it tracks the container all the way down, with no host floor. `[inline]` opts into the old shrink-wrap behavior and is where the 20ch minimum width (`--input-min-width`, mirrors the native `<input>` baseline) survives, guarding a bare, placeholder-only instance from collapsing to near-zero as a hugging flex item.",
   "type": "object",
   "allOf": [
     {
@@ -370,7 +370,7 @@
         "description": "Override line height"
       },
       "--input-min-width": {
-        "description": "Override the minimum-width floor (20ch, mirrors the native `<input>` baseline). Keeps an empty, placeholder-only instance legible when placed directly in a flex row (row-ui) with no explicit width/flex sizing — the placeholder renders via an out-of-flow ::before that contributes no intrinsic width of its own, so without this floor the host collapses to near-zero as a flex item. Explicit sizing (width/flex) can grow the host above the floor but does not bypass it — set to 0 or another lower value to permit a narrower explicit size."
+        "description": "Override the minimum-width floor (20ch, mirrors the native `<input>` baseline), applied only in the `[inline]` hug state (ADR-0077 / spec-form-control-sizing-posture REQ-F-001/REQ-F-002). Keeps an empty, placeholder-only `[inline]` instance legible — the placeholder renders via an out-of-flow ::before that contributes no intrinsic width of its own, so without this floor a hugging instance collapses to near-zero. The default (non-`[inline]`) fill state carries no floor at all — the container owns the width all the way down. Set to 0 or another lower value to permit a narrower `[inline]` instance."
       },
       "--input-padding": {
         "description": "Override base padding (density-scaled)"

package/components/input/input.css

@@ -32,10 +32,14 @@ input-ui:not([disabled]) [slot="field"]:hover [slot="suffix"] {
     --input-affix-fg:        var(--a-ui-text-placeholder);
     --input-field-gap:       var(--a-space-1);
     --input-label-min-width: 8ch;
-    /* Native-<input> baseline (historically ~20 characters). Floors the
-       host so an empty, placeholder-only instance stays legible as a
-       flex item — see the :scope min-width rule below for the collapse
-       mechanism this guards against. */
+    /* Native-<input> baseline (historically ~20 characters). ADR-0077 /
+       spec-form-control-sizing-posture (REQ-F-001/REQ-F-002) moved this
+       floor from the plain :scope to :scope[inline] — the default
+       (fill) posture carries no host floor at all; the container owns
+       the width all the way down. The floor survives ONLY in the hug
+       state, where it guards an empty, placeholder-only instance from
+       collapsing to near-zero (gh#781/gh#1633). See :scope[inline]
+       below for the rule that now consumes this token. */
     --input-min-width:       20ch;
 
     /* ── Transitions ── */
@@ -63,18 +67,43 @@ input-ui:not([disabled]) [slot="field"]:hover [slot="suffix"] {
     /* ── Base ── */
     box-sizing: border-box;
     display: block;
-    /* `display: block` gives no width once this host becomes a flex item
-       (row-ui, or any display:flex parent) — flex items size from
-       content/flex-basis, not display type. The one child that could
-       drive content-based sizing, [slot="text"], is EMPTY when the
-       input has no value; its placeholder renders via an out-of-flow
-       ::before (deliberately, for caret positioning — see the pseudo
-       below) that contributes zero intrinsic width. Without a floor,
-       an empty placeholder-only input-ui collapses to near-zero in any
-       flex context that doesn't otherwise force a width (gh#781).
-       min-width, not width, so explicit width/flex can size the host
-       above the floor; values below the floor remain clamped. Override
-       via --input-min-width (e.g. 0 to opt back out) or size explicitly. */
+    /* ADR-0077 / spec-form-control-sizing-posture REQ-P-001 (fill, the
+       default): `display: block` alone gives no width once this host
+       becomes a flex item (row-ui, or any display:flex parent) — flex
+       items size from content/flex-basis, not display type, and the one
+       child that could drive content-based sizing, [slot="text"], is
+       EMPTY when the input has no value (its placeholder renders via an
+       out-of-flow ::before — deliberately, for caret positioning, see
+       the pseudo below — that contributes zero intrinsic width). So the
+       host declares the fill explicitly with `width: 100%`: in block
+       flow this is a no-op (width:auto already fills — ADR-0037's
+       confirmed full-width default), in flex parents it over-constrains
+       the line and lets the shrink algorithm split real space among
+       fill-state siblings (REQ-P-002), and in grid parents it's
+       redundant-but-harmless against the track's own default stretch.
+       This is a deliberate SCOPE-EXTENT exception: the family contract
+       (REQ-R-001) requires it, the same mechanism field-ui (bug-34) and
+       otp-input-ui (bug-37) already ship. No host floor survives here —
+       the container owns the width all the way down (REQ-F-001); the
+       legibility floor moves to the hug state below. */
+    width: 100%;
+  }
+
+  /* ADR-0077 / spec-form-control-sizing-posture REQ-P-003 (hug, via
+     [inline]): the explicit opt-in for the old shrink-to-content
+     behavior. ADR-0037 §2's display-flip mechanics (block → inline-block)
+     plus `width: fit-content` — fit-content (not the absence of the fill
+     rule) because a grid item is blockified/stretch-aligned by default,
+     so a bare `width: auto` [inline] host would still render at track
+     width. The gh#781/gh#1633 legibility floor moves here from the plain
+     :scope (REQ-F-001/REQ-F-002): it guards an empty, placeholder-only
+     instance from collapsing to near-zero, exactly as it always has —
+     just scoped to the state where the control, not the container, owns
+     its size. Override --input-min-width to 0 to opt a hug instance back
+     into full collapse. */
+  :scope[inline] {
+    display: inline-block;
+    width: fit-content;
     min-width: var(--input-min-width);
   }
 

package/components/input/input.yaml

@@ -8,9 +8,10 @@ version: 1
 description: Text input field with contenteditable surface. Supports prefix/suffix icons, label, form participation, and a
   `type="number"` mode that renders [+]/[-] stepper buttons, numeric input filtering, and ARIA spinbutton semantics — no native
   `<input type="number">` under the hood. Password type uses a native `<input>` (only path that still wraps native, for `-webkit-text-security`
-  disc masking). Has a 20ch minimum width (`--input-min-width`, mirrors the native `<input>` baseline) so a bare,
-  placeholder-only instance stays usable inside a flex row (row-ui) with no explicit sizing — explicit `width`/`flex`
-  or CSS can size the host above the floor; values below the floor remain clamped unless `--input-min-width` is lowered.
+  disc masking). Fills its container's available inline width by default (ADR-0077 / spec-form-control-sizing-posture) —
+  in a flex row (row-ui) or grid track it tracks the container all the way down, with no host floor. `[inline]` opts into
+  the old shrink-wrap behavior and is where the 20ch minimum width (`--input-min-width`, mirrors the native `<input>`
+  baseline) survives, guarding a bare, placeholder-only instance from collapsing to near-zero as a hugging flex item.
 # Per ADR-0027 — primitives that programmatically create other primitives
 # do NOT auto-import them. Consumer (or demo shell) must explicitly import.
 composes:
@@ -238,12 +239,13 @@ tokens:
     description: Override line height
   --input-min-width:
     description: Override the minimum-width floor (20ch, mirrors the native `<input>`
-      baseline). Keeps an empty, placeholder-only instance legible when placed directly
-      in a flex row (row-ui) with no explicit width/flex sizing — the placeholder renders
-      via an out-of-flow ::before that contributes no intrinsic width of its own, so
-      without this floor the host collapses to near-zero as a flex item. Explicit sizing
-      (width/flex) can grow the host above the floor but does not bypass it — set to 0
-      or another lower value to permit a narrower explicit size.
+      baseline), applied only in the `[inline]` hug state (ADR-0077 / spec-form-control-sizing-posture
+      REQ-F-001/REQ-F-002). Keeps an empty, placeholder-only `[inline]` instance legible —
+      the placeholder renders via an out-of-flow ::before that contributes no intrinsic
+      width of its own, so without this floor a hugging instance collapses to near-zero.
+      The default (non-`[inline]`) fill state carries no floor at all — the container owns
+      the width all the way down. Set to 0 or another lower value to permit a narrower
+      `[inline]` instance.
   --input-padding:
     description: Override base padding (density-scaled)
   --input-placeholder-color:

package/components/link/link.css

@@ -10,6 +10,7 @@
     --link-fg:              var(--a-link);
     --link-fg-hover:        var(--a-link-hover);
     --link-fg-visited:      var(--a-link-visited);
+    --link-fg-disabled:     var(--md-sys-color-neutral-on-surface-disabled);
     --link-underline-offset: 2px;
     --link-focus-ring:      var(--a-focus-ring);
   }
@@ -89,9 +90,9 @@
   /* ── Disabled ── */
 
   :scope[disabled] > a {
-    color: var(--md-sys-color-neutral-on-surface-disabled);
+    color: var(--link-fg-disabled);
     cursor: not-allowed;
-    text-decoration-color: var(--md-sys-color-neutral-on-surface-disabled);
+    text-decoration-color: var(--link-fg-disabled);
     pointer-events: none;
   }
 }

package/components/richtext/richtext.css

@@ -21,8 +21,8 @@
        page and inverted inside cards. Same tier as --a-bg-muted/hover. */
     --richtext-code-bg:        var(--md-sys-color-neutral-container-low);
     --richtext-border:         var(--md-sys-color-neutral-outline-variant);
-    --richtext-link:           var(--a-primary-bg);
-    --richtext-link-hover:     var(--md-sys-color-primary);
+    --richtext-link:           var(--a-link);
+    --richtext-link-hover:     var(--a-link-hover);
 
     /* ── Typography ── */
     --richtext-font:           var(--a-font-family);

package/components/search/search.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/Search.json",
   "title": "Search",
-  "description": "Search input with magnifying-glass icon, clear button, and debounced search event.",
+  "description": "Search input with magnifying-glass icon, clear button, and debounced search event. Fills its container's available inline width by default (ADR-0077 / spec-form-control-sizing-posture) — in a flex row (row-ui) or grid track it tracks the container all the way down. `[inline]` opts into the old shrink-wrap behavior and forwards onto the internal input-ui so its 20ch legibility floor applies.",
   "type": "object",
   "allOf": [
     {