@adia-ai/web-components 0.8.44 → 0.8.46

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog — @adia-ai/web-components
 
+## [0.8.46] — 2026-08-22
+
+
+### Maintenance
+- **`components/` touched in this release window** (31 file(s), e.g. `card/card.css`) — 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** (6 file(s), e.g. `chart-in-card/chart-in-card.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.45] — 2026-08-20
+
+### Added
+- **`createStore()` — a signal-backed store primitive in `core/store.js` (gh#1761).** `subscribe(cb) -> unsubscribe`, an `Object.is` no-notify guard, and interop with `UIElement.controller`; ships alongside a new `check-no-hand-rolled-stores.mjs` lint gate (gh#1779) that rejects new hand-rolled Set-of-listeners stores outside `core/`.
+
+### Changed
+- **`for=`-carrying components normalized to an events-only interaction contract (gh#1764/#1780), ADR-0079.** `table-toolbar-ui` → `table-ui` direct writes/calls (`paginate=`, `search=`, `setFilter()`, `clearFilters()`, `columns=`) became five `toolbar-*` command CustomEvents with matching `table-ui` listeners — additive, zero observable-behavior change. `context-menu-ui`'s `for` (selector-flavored) renamed to `target-selector`, `for` kept as a deprecated back-compat alias.
+- **`RouteController` deduplicated into `core/controller.js` (gh#1766).** `provider.js` now imports/re-exports the canonical location.
+- **`[density="compact"|"spacious"]` re-declares `--a-space-*` at the scoped selector, not only `:root` (gh#1771, gh#570).** Element-scoped density was globally inert; `components/table/table.css`'s stale ADR-0054 comment corrected alongside.
+- **Billing composites (`billing-overview`, `invoice-history`, `invoice-detail`, `plan-picker`) route fetch through `core/transport.js`, opting out of the `core/data-stream.js` auto-observer via a new `data-stream-managed="false"` marker (gh#1760).**
+- **`select`/`table-toolbar` — visually-hidden `select` label (`[label-hidden]`) + actions-leading icon-only Filter/Columns reduction (gh#1748).**
+- **`table-ui` adopts an `isEqualNode()`-based `adoptOrDiffChildren()` for SSR adopt-in-place, with `RENDERER_OWNED` `WeakSet` tagging for unconditional replacement of renderer-owned cells (gh#1678).**
+- **`search-ui`/`pagination-ui` post-adopt attribute writes are idempotent under SSR zero-mutation (gh#1755).**
+- **Three independently-authored path-walker implementations in `packages/gen-ui/a2ui/path-pointer.js` unified, preserving each call site's real divergent edge-case semantics rather than silently collapsing them (empty-path, primitive mid-path, doubled-slash) — mechanical staging toward ADR-0078's vendored-model migration.**
+
+### Docs
+- **New `table-with-toolbar-in-card-header` demo** — `table-toolbar-ui` composed inside `card-ui`'s header (sole-child case; a real `card.css` grid/centering conflict documented for the heading+action-slot case, not yet supported).
+- **`nav-group-ui`'s `[data-nav-label]` group-label hook documented (gh#1736).**
+- **Render clock & external-store wiring doctrine ratified in `.claude/docs/specs/component-implementation-patterns.md` (gh#1777/#1778)** — `table-ui`'s rAF-batched render clock named as the sole verified exception to the microtask-flush contract; `BaseController` promoted as a `createStore()` adapter via its existing optional-chaining `controller` setter (no new adapter code needed — the contract was already satisfied).
+
+### Maintenance
+- **`dist/` bundles rebuilt** in this cut's window (6 file(s)) — regenerated from the source changes described above, not independent edits.
+- **`styles/` touched in this release window** (2 file(s), e.g. `api/sizing.css`) — carried by the entries above.
+
 ## [0.8.44] — 2026-08-20
 
 ### Added

package/components/card/card.css

@@ -427,29 +427,18 @@
     border-radius: 0;
   }
 
-  /* Guide/value/legend safety inset (gh#1095) — [bleed]'s zero-inset is
-     only collision-free for the bare-marks case: a sparkline (its
-     renderer never emits axis ticks, gridlines, value labels, or a
-     legend — chart.class.js #renderSparkline), or any other chart-ui
-     type with BOTH [no-grid] and [no-values] set (the author opted
-     out of every text element). A chart that still draws guides or
-     value text — or is paired with a <chart-legend-ui> — needs
-     clearance from the card's frame, or that text collides with the
-     card edge and clips under the corner-rounded `overflow: hidden`
-     (:scope, top of file). Restore the card's own inset automatically
-     for those cases rather than relying on every author to remember —
-     the :has() selector's specificity already beats the plain [bleed]
-     reset above regardless of source order. Pairing a legend with a
-     genuinely full-bleed chart still works — put the legend in its OWN
-     section below, wired via chart-legend-ui[for="<chart id>"], which
-     never enters this selector (see chart-in-card.examples.html's
-     "Full-bleed chart + legend band" example). */
-  & > section[bleed]:has(> chart-ui:not([type="sparkline"]):not([no-grid])),
-  & > section[bleed]:has(> chart-ui:not([type="sparkline"]):not([no-values])),
-  & > section[bleed]:has(> chart-legend-ui) {
-    margin: var(--card-inset);
-    padding: 0;
-  }
+  /* [bleed] is unconditionally author-controlled (gh#1801, operator ruling
+     2026-08-20 — supersedes gh#1095's mechanical auto-restore, removed
+     here). A full-bleed chart-ui that still draws gridlines, value labels,
+     or is paired with a <chart-legend-ui> can clip that text under the
+     card's corner-rounded `overflow: hidden` (:scope, top of file) — this
+     is now the AUTHOR's responsibility to avoid, not something this
+     stylesheet silently repairs by re-inserting an inset the author
+     explicitly opted out of. card.yaml's `bleed` prop docs and
+     chart-in-card.examples.html both carry the clipping-hazard note and
+     the recommended mitigation: render value/guide text as overlay chips
+     INSET within the plot area (never hanging outside it) rather than
+     relying on card margin for clearance. */
 
   /* ═══════ Footer ═══════
      Margin-based inset. Flex row for actions.

package/components/card/card.yaml

@@ -161,6 +161,17 @@ a2ui:
     row 2 without needing slot="description".
   - Multiple <section> siblings are allowed and stack vertically. [bleed] on a section removes its margin for edge-to-edge
     content (tables, charts); [padding] adds a canvas-scrim background for hero regions.
+  - >-
+    [bleed] is unconditionally author-controlled — card.css never restores
+    the section's inset on your behalf (gh#1801, operator ruling
+    2026-08-20; supersedes gh#1095's removed auto-restore guard). A
+    full-bleed <chart-ui> that still draws gridlines or value labels, or is
+    paired with a <chart-legend-ui>, can clip that text under the card's
+    own corner-rounded overflow:hidden — keeping it clear of the card
+    frame is YOUR responsibility as the author, e.g. by rendering value/
+    guide text as overlay chips INSET within the plot area rather than
+    hanging outside it, or by placing a <chart-legend-ui> in its own
+    non-bled section. See chart-in-card.examples.html for the pattern.
   - >-
     When neither [raw] nor [frameless] is present, a <table-ui> placed
     directly inside a <section bleed> automatically renders chromeless

package/components/chart/chart.a2ui.json

@@ -62,7 +62,7 @@
       "default": null
     },
     "data": {
-      "description": "JS property (set programmatically — `el.data = [...]`). An array of plain objects; each object's keys are named by the `x` and `y` attributes — e.g. `<chart-ui x=\"month\" y=\"revenue\">` consumes `[{month:'Jan', revenue:3200}, {month:'Feb', revenue:4100}]`. The Chart.js `{labels, datasets}` envelope is NOT chart-ui's API — passing it (or any non-array value) renders an empty chart. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect. Custom accessor on the element class, not a reflected attribute.",
+      "description": "JS property (set programmatically — `el.data = [...]`). An array of plain objects; each object's keys are named by the `x` and `y` attributes — e.g. `<chart-ui x=\"month\" y=\"revenue\">` consumes `[{month:'Jan', revenue:3200}, {month:'Feb', revenue:4100}]`. The Chart.js `{labels, datasets}` envelope is NOT chart-ui's API — passing it (or any non-array value) renders an empty chart. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect. Custom accessor on the element class, not a reflected attribute. A datum object carrying a truthy `provisional` key (ADR-0081) renders that period's type-specific incomplete-period treatment (hollow/dashed bar, dashed line + faded area, hollow ring dot) on cartesian types; a no-op on radial/part-to-whole types and sparkline (gh#1690's N/A list). Provisional state is per-datum data-shape, not a chart-ui attribute — see ADR-0081 §3.",
       "$ref": "common_types.json#/$defs/DynamicObjectList"
     },
     "dots": {
@@ -87,6 +87,16 @@
       ],
       "default": "abbr"
     },
+    "labels": {
+      "description": "Chart 2.0 axis-label mode (ADR-0081). Unset (default, \"\") always resolves to `outside` — today's pre-2.0 outside-the-plot axis labels, byte-for-byte unchanged. Set explicitly to `chip` to opt into the pill-treated overlay labels inset within the plot box (never hanging outside it) — the resolved value reflects onto the host as `data-labels-resolved=\"chip\"|\"outside\"`. Deliberately explicit-opt-in rather than auto-detected from full-bleed ancestry (`section[bleed]`/ `card-ui[padding=\"none\"]`): an earlier draft auto-activated chip mode on any full-bleed composition, which silently changed the rendering of every ALREADY-SHIPPED full-bleed chart the moment it shipped — this build's own 60-fixture Charts visual-eval floor caught it (2 `comp-chart-in-card-n-*` regressions). `chart-in-card` compositions opt in explicitly once their own examples are updated (gh#1805).",
+      "type": "string",
+      "enum": [
+        "",
+        "chip",
+        "outside"
+      ],
+      "default": ""
+    },
     "loading": {
       "description": "Show a skeleton placeholder instead of the chart body. Set to true while data is being fetched; clear once data arrives. Preserves the element's aspect-ratio dimensions so the skeleton occupies the same space the chart will fill. Parity with stat-ui[loading] and table-ui[loading] (§FB-12, v0.6.27).",
       "type": "boolean",
@@ -137,6 +147,11 @@
       "type": "number",
       "default": 0.4
     },
+    "today": {
+      "description": "Names the datum whose x-axis value marks \"today\" (ADR-0081). Unset (default, \"\") renders no marker — additive. Compared against each datum's x-key value via a loose string comparison (`String(datum[x]) === String(today)`), so category axes (\"month\", \"region\") work the same as literal date strings; chart-ui never auto-derives today from the clock. Renders a baseline dot + a short band tick (REQ-F-008) on cartesian types (bar, line, area, scatter, multi-line, stacked-bar, grouped-bar, composed); a no-op on every radial/part-to-whole type and on sparkline (gh#1690's N/A list). Fallback (not the primary mechanism): a datum already carrying a truthy `today` key is treated as an equivalent marker even with this attribute unset.",
+      "type": "string",
+      "default": ""
+    },
     "x": {
       "description": "Data key for x-axis (category) values",
       "type": "string",