@adia-ai/a2ui 0.8.38 → 0.8.40

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 > 0.8.37 (the estate-split cut) were released under the old name and are kept
 > verbatim.
 
+## [0.8.40] — 2026-08-15
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the lockstep version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.40 work shipped in the ADR-0052/0053/0054/0056 attribute-grammar and token-convention breaking wave. See `packages/web-components/CHANGELOG.md#0840--2026-08-15` for details.
+- **`catalog/` touched in this release window** (2 file(s), e.g. `catalog/catalog-a2ui_0_9.json`) — carried by the entries above.
+
+## [0.8.39] — 2026-08-15
+
+### Added
+- **L1 is populated — 44 curated widgets in `@adia-ai/a2ui/catalog/tiers` (ADR-0050, gh#1291 phase 1).** The gap tier the ladder was built for: named, versioned, chat-scale functional units, each carrying its `composes` edge to L0, an A2UI `template`, a description, retrieval keywords, and `source` provenance — enough for a consumer to enumerate a widget and emit it without the corpus. Breadth-first across 17 domains (agent, auth, billing, content, dashboard, data, data-management, display, error, forms, input, layout, marketing, navigation, onboarding, overlay, settings), capped at 3 per domain. Curated from the 516 harvested templates by five mechanical gates and three selection rules, both authored in `catalog/tiers/curation/l1-widgets.curation.json` with their rationale. L2 is unblocked — the composability law had L1 as its precondition. The tier index grows 25 KB → 213 KB; `wiring` and `preview` remain unpopulated (later phases).
+
+### Changed
+- **The composability law now reaches into templates (gh#1291).** For any tier entry carrying a `template`, `composes` must be exactly the set of rung-below entries the template uses — no undeclared uses, no unused declarations — joining A2UI standard type names (`Column`, `CheckBox`) to catalog component names (`Col`, `Check`) through the registry's tag mapping. Additive: the index schema is unchanged, and L0's derivation is untouched. Previously `composes` was a hand-claimed list nothing verified, which made the ladder's one law decorative for any tier shipping templates.
+- **The `preview` key is documented as reserved-and-unbuilt (gh#1291 phase 2).** `catalog/tiers/README.md` now says so at the file-shape sketch instead of implying a generator exists. Rendering a widget needs a browser, and every rendering path in the repo is ephemeral review tooling against a running dev server; the scope-out rationale and the re-entry checklist live in `.claude/docs/specs/tiered-catalogs.md` ## Previews. `source.page` remains the pointer at a live demo page.
+- **The L0+L1 rungs are served over MCP** by `adia-mcp protocol`'s new `get_catalog_ladder` (see `@adia-ai/mcp`) — reading this package's `./catalog/tiers` export, which is what lets a protocol-only consumer enumerate widgets without the generation system.
+
 ## [0.8.38] — 2026-08-15
 
 ### Added

package/catalog/catalog-a2ui_0_9.json

@@ -3310,7 +3310,7 @@
             "name": "open"
           }
         ],
-        "status": "draft",
+        "status": "experimental",
         "synonyms": {
           "embed": [
             "embedded",
@@ -5442,6 +5442,11 @@
         "component": {
           "const": "Chart"
         },
+        "cornerRadius": {
+          "description": "Bar corner radius in px (null = let CSS tokens decide)",
+          "type": "number",
+          "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.",
           "$ref": "#/$defs/DynamicObjectList"
@@ -5488,11 +5493,6 @@
           "type": "boolean",
           "default": false
         },
-        "radius": {
-          "description": "Bar corner radius (null = let CSS tokens decide)",
-          "type": "number",
-          "default": null
-        },
         "seriesEmphasis": {
           "description": "Multi-line only. Names one series key (matching a `y` key) to render at full strength — area fill + full-opacity line. Every other series drops its area fill and renders line-only at --chart-deemphasized-opacity. Empty (default) applies full treatment to every series, unchanged from pre-gh#561 behavior.",
           "type": "string",
@@ -8078,6 +8078,9 @@
           "footer": {
             "description": "Keyboard hint bar"
           },
+          "input": {
+            "description": "The auto-stamped search field — a contenteditable=\"plaintext-only\" span carrying role=\"combobox\" (per ADR-0025/ADR-0055; no native <input>). Internal only; not consumer-slottable."
+          },
           "list": {
             "description": "Container for command items and groups"
           }
@@ -10539,7 +10542,9 @@
         "composes": [
           "icon-ui",
           "skeleton-ui",
-          "empty-state-ui"
+          "empty-state-ui",
+          "input-ui",
+          "button-ui"
         ],
         "events": {
           "navigate": {
@@ -16684,6 +16689,11 @@
           "type": "string",
           "default": ""
         },
+        "multiExpand": {
+          "description": "Opt out of the default single-expanded-group behavior. When unset, selecting a nav-item-ui collapses every nav-group-ui except the one containing the newly selected item (all, when the selection is ungrouped); manual multi-expansion still works up until the next selection.",
+          "type": "boolean",
+          "default": false
+        },
         "variant": {
           "description": "Visual treatment. primary = app sidebar; section = subnav rail.",
           "type": "string",
@@ -20447,7 +20457,7 @@
     },
     "QRCode": {
       "title": "QRCode",
-      "description": "Inline QR code generator — renders a scannable code as inline SVG.\nTwo modes:\n\n**A. Auto-encode (default).** Set `[value]` to a string (URL, plain\ntext, share link, 2FA secret). The component encodes the data with\nthe built-in zero-deps QR encoder (byte mode, ECC level configurable,\nversions 1–10 up to ~150 byte chars) and renders an SVG.\n\n**B. Bring-your-own matrix.** Set `[matrix]` to a JSON string of a\n2-D 0/1 array (`[[1,0,1,...],[...],...]`). The component renders the\nsupplied matrix directly without invoking its own encoder. Use this\nwhen you need versions 11–40, kanji/alphanumeric mode, or any\nencoder feature beyond the built-in. When both `[value]` and\n`[matrix]` are set, the matrix wins (BYO override).\n\nOutput is a single `<svg>` with `viewBox=\"0 0 N N\"`. Crisp-edges\nrendering preserves the scannable cell boundaries at any size.\nSizing is controlled by the `[size]` prop (host CSS-pixel dimension);\ninternal cell size is computed from `size / (matrix-size + 2 ·\nmargin)`. ARIA: `role=\"img\"` with `aria-label` (default \"QR code\"\nor the `[label]` prop).\n",
+      "description": "Inline QR code generator — renders a scannable code as inline SVG.\nTwo modes:\n\n**A. Auto-encode (default).** Set `[value]` to a string (URL, plain\ntext, share link, 2FA secret). The component encodes the data with\nthe built-in zero-deps QR encoder (byte mode, ECC level configurable,\nversions 1–10 up to ~150 byte chars) and renders an SVG.\n\n**B. Bring-your-own matrix.** Set `[matrix]` to a JSON string of a\n2-D 0/1 array (`[[1,0,1,...],[...],...]`). The component renders the\nsupplied matrix directly without invoking its own encoder. Use this\nwhen you need versions 11–40, kanji/alphanumeric mode, or any\nencoder feature beyond the built-in. When both `[value]` and\n`[matrix]` are set, the matrix wins (BYO override).\n\nOutput is a single `<svg>` with `viewBox=\"0 0 N N\"`. Crisp-edges\nrendering preserves the scannable cell boundaries at any size.\nSizing is controlled by the `[size]` prop (host CSS-pixel dimension);\ninternal cell size is computed from `size / (matrix-size + 2 ·\nquiet-zone)`. ARIA: `role=\"img\"` with `aria-label` (default \"QR code\"\nor the `[label]` prop).\n",
       "type": "object",
       "allOf": [
         {
@@ -20487,18 +20497,18 @@
           "type": "string",
           "default": "QR code"
         },
-        "margin": {
-          "description": "Quiet zone in cells around the QR pattern. QR spec requires a\nminimum 4-cell margin for reliable scanning; smaller values may\nnot scan on some devices. Default `4`.\n",
-          "type": "number",
-          "default": 4
-        },
         "matrix": {
           "description": "BYO precomputed bit matrix as JSON — a 2-D array of 0/1\n(`[[1,0,...],[0,1,...],...]`). When set, the built-in encoder is\nbypassed and this matrix renders directly. Useful for QR variants\nthe built-in doesn't support (versions 11–40, alphanumeric mode,\nkanji, etc.) — bring your own encoder, pass the matrix here.\n",
           "type": "string",
           "default": ""
         },
+        "quietZone": {
+          "description": "Quiet zone in cells around the QR pattern. QR spec requires a\nminimum 4-cell quiet zone for reliable scanning; smaller values\nmay not scan on some devices. Default `4`. (Renamed from\n`[margin]` — that name collided with the framework's global\n`[margin]` Scale attribute; `margin` on `qr-code-ui` now means\nthe global spacing attribute, per ADR-0053.)\n",
+          "type": "number",
+          "default": 4
+        },
         "size": {
-          "description": "Host display size in CSS pixels (width and height; the SVG is\nalways square). Default 200. Internal cell size is computed from\nthis divided by `matrix-size + 2·margin`.\n",
+          "description": "Host display size in CSS pixels (width and height; the SVG is\nalways square). Default 200. Internal cell size is computed from\nthis divided by `matrix-size + 2·quiet-zone`.\n",
           "type": "number",
           "default": 200
         },
@@ -20520,9 +20530,9 @@
             "wrong": "<qr-code-ui value=\"https://very.long.url.that.exceeds.150.bytes.of.utf8.encoded.length...\"></qr-code-ui>\n"
           },
           {
-            "fix": "<qr-code-ui value=\"...\" margin=\"4\"></qr-code-ui>\n",
-            "why": "Zero margin breaks scanning. QR spec requires a 4-cell quiet\nzone for reliable detection.\n",
-            "wrong": "<qr-code-ui value=\"...\" margin=\"0\"></qr-code-ui>\n"
+            "fix": "<qr-code-ui value=\"...\" quiet-zone=\"4\"></qr-code-ui>\n",
+            "why": "Zero quiet zone breaks scanning. QR spec requires a 4-cell quiet\nzone for reliable detection.\n",
+            "wrong": "<qr-code-ui value=\"...\" quiet-zone=\"0\"></qr-code-ui>\n"
           }
         ],
         "category": "display",
@@ -24605,16 +24615,6 @@
           "description": "JS property (set programmatically — `el.data = [...]`) — row records, an array of plain objects keyed to columns[].key. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect (gh#288) — the same pattern chart-ui's `data` attribute uses. Custom accessor on the element class, not a reflected attribute.",
           "$ref": "#/$defs/DynamicObjectList"
         },
-        "density": {
-          "description": "Controls cell padding and row height. 'compact' for dense data, 'standard' for default spacing, 'comfortable' for spacious rows.",
-          "type": "string",
-          "enum": [
-            "compact",
-            "standard",
-            "comfortable"
-          ],
-          "default": "standard"
-        },
         "expandable": {
           "description": "Enable row expansion",
           "type": "boolean",
@@ -27635,6 +27635,11 @@
           "type": "string",
           "default": ""
         },
+        "selected": {
+          "description": "Whether this option is currently selected. Managed by the parent\n<toggle-group-ui> container (ADR-0056) — don't set directly; the group's\n`value` is the single source of truth. Converges onto <segment-ui>'s\ndeclared reflected-prop mechanism.",
+          "type": "boolean",
+          "default": false
+        },
         "text": {
           "description": "Visible label text.",
           "type": "string",

package/catalog/catalog-a2ui_0_9_rules.txt

@@ -478,6 +478,7 @@
 - Variants: variant="primary" (default) — app sidebar; ResizeObserver collapses to icon-only ≤96px; collapsible groups open as a popover when collapsed. variant="section" — subnav rail; quieter chrome; optional [heading] kicker rendered via ::before.
 - Section-variant cascade (ADR-0015 § Nav consolidation): variant="section" on <nav-ui> cascades visually to direct <nav-group-ui> / <nav-item-ui> descendants via CSS `:not([variant])`. Children's JS state is NOT mutated; the cascade is purely visual. Explicit [variant] on a child always wins — use it to escape the cascade or style a standalone group/item.
 - Decision rule: if the user navigates AWAY (different page, route, or anchor) → <nav-ui>. If the user switches VIEWS within the same logical page → <tabs-ui>. Never use <nav-ui> as an in-page section switcher.
+- Group expansion on selection: selecting a <nav-item-ui> collapses every <nav-group-ui> except the one containing the newly selected item (all groups, when the selection is ungrouped). Manual multi-expansion is allowed right up until the next selection. Set [multi-expand] on <nav-ui> to opt out and keep multiple groups open across selections. This clears the JS [open] state (and aria-expanded) on every collapsed group in BOTH variants — primary visually hides that group's children as a result; section variant's CSS keeps children visible regardless of [open] (per the section-variant cascade rule above), so only the accessibility state resets there, with no visible change.
 - Anti-patterns: do NOT wrap <nav-ui> children in <col-ui> / <row-ui> — wrapping breaks selection bubbling + the variant cascade. Do NOT nest <nav-ui> inside <nav-ui>. The legacy 6-element family (<app-nav-ui> / <section-nav-ui> / <app-nav-item-ui> / <section-nav-item-ui> / <app-nav-group-ui> / <section-nav-group-ui>) was retired in ADR-0015 — only <nav-ui> / <nav-group-ui> / <nav-item-ui> remain.
 
 ## Noodles
@@ -559,7 +560,7 @@
 - Set [value] for URLs / share links / plain text. The built-in encoder covers byte-mode UTF-8 up to QR version 10 (~150 chars at ECC-M, more at lower ECC levels).
 - For data that exceeds version 10, switch to a higher ECC level downgrade ([error-correction=L]) OR use a BYO encoder and pass the precomputed [matrix].
 - When QR sits over a non-white surface, set [background] to a solid color. White-on-image QR backgrounds are unreliable for scanners — quiet-zone contrast against the dark cells is the load-bearing visual.
-- The [margin] (quiet zone) defaults to 4 cells per QR spec. Smaller margins may scan on some devices but not others; do not go below 2.
+- The [quiet-zone] defaults to 4 cells per QR spec. Smaller values may scan on some devices but not others; do not go below 2.
 
 ## RadioGroup
 - The canonical radio-group shape is <radio-group-ui label="…"> wrapping a set of bare <radio-ui label="…" name="…"> children — the wrapper supplies the group's accessible name (role=radiogroup + aria-labelledby); Column/Section cannot carry a role, so a bare Column of radios has no programmatic question↔group association.
@@ -793,11 +794,12 @@
 - Multi-select button cluster — hosts <toggle-option-ui> children, each independently toggleable.
 - Different from <segmented-ui> (single-select) — toggle-group emits a SET of active values.
 - Use for filter chips, multi-flag toggles, day-of-week pickers; for binary on/off use <switch-ui>.
+- Sets the child <toggle-option-ui>'s declared [selected] prop to reflect the group value (ADR-0056) — do not author [selected] directly in generated markup; author the group's value instead.
 
 ## ToggleOption
 - Child of <toggle-group-ui> — one independently-toggleable button in a multi-select cluster.
 - Different from <segment-ui> (which is single-select inside <segmented-ui>).
-- Active state controlled via the toggle-option's own active attribute (independent of siblings).
+- Selected state exposed via its own declared [selected] reflected prop, set by the parent <toggle-group-ui> (ADR-0056) — mirrors <segment-ui>'s convention. Do not set [selected] directly; drive the group's value instead.
 
 ## ToggleScheme
 - Place toggle-scheme-ui in the shell topbar's trailing action cluster — slot="action" inside <admin-topbar slot="header"> of <admin-content>. It is a persistent, app-wide preference control; never put it in a sidebar footer / <admin-statusbar>, which hosts user-account items only.