@adia-ai/web-components 0.6.31 → 0.6.33

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog — @adia-ai/web-components
 
+## [0.6.33] — 2026-05-23
+
+### Changed — `dist/icons-manifest.js` comment header updated (FB-53 §1 companion)
+
+- **`dist/icons-manifest.js`** is regenerated as a companion to the web-modules co-emit (see `@adia-ai/web-modules` [Unreleased] entry). The manifest file content is byte-identical except for the header comment, which now mentions co-location with both `web-components.min.js` AND `web-modules/everything.min.js`. `dist/web-components.min.js` rebuilt as part of the same bundle pass; no functional change. Files: `dist/icons-manifest.js`, `dist/web-components.min.js`.
+
+### Fixed — `<table-ui raw>` is now a true visual-only passthrough (FB-53 §2)
+
+- **`<table-ui raw>` previously applied the chrome reset but still ran the full data lifecycle**, so wrapping a consumer-authored native `<table>` with no `.data` set produced a phantom `[data-empty]` "No data" overlay above the consumer's content. Root cause: `class.js` `render()` had no `this.raw` short-circuit; `#renderOverlays` injected the empty-state placeholder unconditionally whenever `this.#data.length === 0`. Fix: `render()` now early-returns when `this.raw` is set — no header injection, no body reconciliation, no overlays, no aggregation, no pagination. Raw is now the documented "consumer owns the body shape" mode. yaml description expanded with the full semantic. NEW 4 vitest cases in `table.test.js` (lock the contract: no `[data-empty]`, no `[data-header]`, no `[data-body]`, no rowgroups; non-raw default still injects them); 18/18 passing. Files: `components/table/class.js`, `components/table/table.yaml`, `components/table/table.test.js`.
+
+### Fixed — `<field-ui>` no longer reserves row-gap for an absent message row (FB-54)
+
+- **`field.css` `:scope` declared `row-gap: var(--field-gap)` unconditionally**, so when no `[slot="hint"]` and no `[slot="error"]` were present, the grid's zero-content message row still reserved `--field-gap` (~8 px) between itself and the control row. Result: `<field-ui inline>` rendered ~7-8 px taller than non-field-ui siblings in a `<row-ui align="center">`, visually "lifting" the label relative to sibling control text. Fix: move `row-gap: var(--field-gap)` into a `:has(> [slot="hint"], > [slot="error"])` guard so the gap is reserved only when a message slot is actually present. Existing consumers with hints/errors get the same rendering; consumers without get a tighter, sibling-matching height. `:has()` is baseline (Chromium 105 / Safari 15.4 / Firefox 121 — well within ADR-0007's floor). NEW source-grep regression tests in `field.test.js` lock the contract (19/19 passing). Files: `components/field/field.css`, `components/field/field.test.js`.
+
+### Changed — `<tabs-ui>` row height now anchors to `var(--a-size)` (was hardcoded `2.25rem`)
+
+- **`--tabs-button-height` retargeted from the hardcoded `2.25rem` (36 px, equivalent to `[size="lg"]`) to `var(--a-size)`.** Tabs now respond to the universal `[size]` attribute system like `button-ui`, `select-ui`, `nav-item-ui`, and other row-family primitives — `<tabs-ui size="sm">` → 24 px, default → 30 px, `<tabs-ui size="lg">` → 36 px (all at default `--a-density: 1`). Default-rendered tabs visibly shrink from 36 px → 30 px. **Behavior change** for consumers depending on lg-by-default tabs: set `[size="lg"]` on the host (or override `--tabs-button-height: var(--a-size-lg)`) to restore. Caught by NEW `check:size-wiring` audit (commit `2d931b980`). Files: `components/tabs/tabs.css`, `components/tabs/tabs.examples.html`.
+
+### Maintenance — `<kbd-ui>` exempted from size-wiring audit
+
+- **`scripts/release/check-size-wiring.mjs`** EXEMPT + YAML_SIZE_EXEMPT: added `kbd-ui` to both — `--kbd-height: 1.25rem` is intentional (keyboard-key cap matching small-text rhythm, not row-family) and the `size:` prop drives font-size scale, parallel to existing exemptions for `badge`, `tag`, `icon`. Pre-existing technical debt surfaced by the new audit in v0.6.32; not a v0.6.33-introduced violation. Files: `scripts/release/check-size-wiring.mjs`.
+
+## [0.6.32] — 2026-05-23
+
+### Fixed (P0) — `everything.js` CDN bundle now includes all primitives (FB-51)
+
+- **`packages/web-modules/everything.js` was shells-only in v0.6.29–v0.6.31** — it registered all four shells but did NOT register the 95+ primitives (`search-ui`, `select-ui`, `field-ui`, `stat-ui`, `row-ui`, etc.). Consumers using the CDN-first "just drop in `everything.min.js`" path hit a hard `TypeError: Cannot read properties of undefined (reading 'toLowerCase')` on any interaction with a primitive element. Root cause: `bundle-js.mjs` assembled the bundle from only the web-modules `index.js`, which re-exports shells but not primitives. Fix: bundle now explicitly includes `web-components/index.js` (all primitives) before web-modules. File: `packages/web-modules/everything.js`.
+
+### Added — `dist/icons-manifest.js` CDN icons-manifest; `core/icons-phosphor.js` CDN prefix (FB-51)
+
+- **`packages/web-components/dist/icons-manifest.js`** is now included in the npm tarball's `files:` field and exposed via the `./dist/icons-manifest` export path. Consumers loading via CDN received a 404 on the manifest fetch because the file was excluded from the published package. File: `packages/web-components/dist/icons-manifest.js`.
+- **`core/icons-phosphor.js`** — the non-Vite fallback path now destructures `{ cdn: cdnBase, ...weights }` from the manifest. When `cdnBase` is present (as it is in the new generated manifest), SVG fetches use the CDN URL (`https://cdn.jsdelivr.net/npm/@phosphor-icons/core@X.Y.Z/assets/`) instead of `/node_modules/...` (localhost-only). File: `core/icons-phosphor.js`.
+
+### Added — `site/llms.txt` + `scripts/build/llms.mjs` machine-readable docs
+
+- **`site/llms.txt`** is an LLMs.txt-spec document generated by `scripts/build/llms.mjs` and included in every EXE site deploy. It exposes the full component API surface and usage patterns in a format suitable for LLM context injection. Build step wired into `build:site` as a pre-step.
+
+### Added — `status: stable` field on all 141 component YAMLs
+
+- Every component YAML now carries `status: stable`, making the stability signal machine-readable in A2UI catalog queries and corpus retrieval. The field is optional in the schema; previously it defaulted to absent (implicitly stable for all released components).
+
+### Documentation — anatomy sections added to all `components/`, `styles/`, and `traits/` example pages
+
+- **Canonical anatomy sections** (`data-property="slots|data-attrs|keyboard|css-vars|a2ui|related"`) added to all 124 component example pages, 56 trait example pages, and 10 token (`styles/`) example pages via `scripts/docs/anatomy-sweep.mjs`. The sweep generates slot tables, keyboard interaction tables, CSS custom property tables, A2UI composition rules, and related-component links directly from each component's `.a2ui.json` sidecar data. Existing `properties`, `events`, `CSS Tokens`, and `usage` sections were normalized to the canonical `data-property` vocabulary. Files: `components/**/*.examples.html`, `styles/**/*.examples.html`, `traits/**/*.examples.html`.
+
+### Fixed — `<tag-ui>` / `<badge-ui>` / `<segment-ui>` phantom trailing gap when content is slotted (not `[text]`)
+
+- **Three primitives in the same family rendered `::after { content: attr(text) }` unconditionally.** When consumers passed text via the default slot (`<tag-ui>Beta</tag-ui>`) instead of the `[text]` attribute, `attr(text)` resolved to `""` — an empty string IS generated content, so the pseudo-element existed as a flex item. Combined with the host's `display: inline-flex` + `gap`, gap was applied between the slotted text and the empty `::after`, adding a phantom `--{component}-gap`-wide trailing space (~4 px). Fix: gate the rule on `:scope[text]` so the pseudo-element is only generated when the attribute exists — matches the already-correct form in `button.css`. NEW `tag/tag.test.js` (3 cases) pins the contract via source-grep so the ungated form can't drift back. Files: `components/tag/tag.css`, `components/tag/tag.test.js`, `components/badge/badge.css`, `components/segment/segment.css`.
+
 ## [0.6.31] — 2026-05-23
 
 ### Documentation — 3 legacy `patterns/*` example files rewritten as canonical hubs

package/components/accordion/accordion-item.a2ui.json

@@ -68,6 +68,7 @@
       }
     },
     "states": [],
+    "status": "stable",
     "synonyms": {
       "accordion-item": [
         "collapsible-row",

package/components/accordion/accordion-item.yaml

@@ -11,6 +11,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAccordionItem
 tag: accordion-item-ui
+status: stable
 component: AccordionItem
 category: layout
 version: 1

package/components/accordion/accordion.a2ui.json

@@ -85,6 +85,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "accordion": [
         "accordion",

package/components/accordion/accordion.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAccordion
 tag: accordion-ui
+status: stable
 component: Accordion
 category: container
 version: 1

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

@@ -64,6 +64,7 @@
     ],
     "slots": {},
     "states": [],
+    "status": "stable",
     "synonyms": {
       "action-item": [
         "command-item",

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

@@ -11,6 +11,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIActionItem
 tag: action-item-ui
+status: stable
 component: ActionItem
 category: navigation
 version: 1

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

@@ -76,6 +76,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "action-list": [
         "command-list",

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

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIActionList
 tag: action-list-ui
+status: stable
 component: ActionList
 category: navigation
 version: 1

package/components/agent-artifact/agent-artifact.a2ui.json

@@ -100,6 +100,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "artifact": [
         "agent-artifact",

package/components/agent-artifact/agent-artifact.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentArtifact
 tag: agent-artifact-ui
+status: stable
 component: AgentArtifact
 category: agent
 version: 1

package/components/agent-feedback-bar/agent-feedback-bar.a2ui.json

@@ -91,6 +91,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "feedback-bar": [
         "agent-feedback",

package/components/agent-feedback-bar/agent-feedback-bar.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentFeedbackBar
 tag: agent-feedback-bar-ui
+status: stable
 component: AgentFeedbackBar
 category: agent
 version: 1

package/components/agent-questions/agent-questions.a2ui.json

@@ -93,6 +93,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "questions": [
         "clarifying-questions",

package/components/agent-questions/agent-questions.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentQuestions
 tag: agent-questions-ui
+status: stable
 component: AgentQuestions
 category: agent
 version: 1

package/components/agent-reasoning/agent-reasoning.a2ui.json

@@ -120,6 +120,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chain-of-thought-ui": "agent-reasoning-ui",
       "cot-ui": "agent-reasoning-ui"

package/components/agent-reasoning/agent-reasoning.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentReasoning
 tag: agent-reasoning-ui
+status: stable
 component: AgentReasoning
 category: agent
 version: 1

package/components/agent-suggestions/agent-suggestions.a2ui.json

@@ -95,6 +95,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "suggestions": [
         "follow-ups",

package/components/agent-suggestions/agent-suggestions.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentSuggestions
 tag: agent-suggestions-ui
+status: stable
 component: AgentSuggestions
 category: agent
 version: 1

package/components/agent-trace/agent-trace.a2ui.json

@@ -76,6 +76,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "trace": [
         "agent-trace",

package/components/agent-trace/agent-trace.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAgentTrace
 tag: agent-trace-ui
+status: stable
 component: AgentTrace
 category: agent
 version: 1

package/components/alert/alert.a2ui.json

@@ -128,6 +128,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "alert": [
         "alert",

package/components/alert/alert.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAlert
 tag: alert-ui
+status: stable
 component: Alert
 category: container
 version: 1

package/components/aside/aside.a2ui.json

@@ -76,6 +76,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "aside": [
         "side-region",

package/components/aside/aside.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAside
 tag: aside-ui
+status: stable
 component: Aside
 category: container
 version: 1

package/components/avatar/avatar-group.a2ui.json

@@ -51,6 +51,7 @@
     ],
     "slots": {},
     "states": [],
+    "status": "stable",
     "synonyms": {
       "avatar-group": [
         "facepile",

package/components/avatar/avatar-group.yaml

@@ -10,6 +10,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAvatarGroup
 tag: avatar-group-ui
+status: stable
 component: AvatarGroup
 category: feedback
 version: 1

package/components/avatar/avatar.a2ui.json

@@ -126,6 +126,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "avatar": [
         "user",

package/components/avatar/avatar.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIAvatar
 tag: avatar-ui
+status: stable
 component: Avatar
 category: display
 version: 1

package/components/badge/badge.a2ui.json

@@ -72,7 +72,8 @@
     }
   },
   "required": [
-    "component"
+    "component",
+    "text"
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
@@ -127,6 +128,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "badge": [
         "badge",

package/components/badge/badge.css

@@ -31,7 +31,12 @@
     vertical-align: middle;
   }
 
-  :scope::after {
+  /* `[text]` attribute selector gates the ::after so consumers using
+     slotted content (`<badge-ui>3</badge-ui>`) don't get an empty
+     pseudo-element flex item — which would otherwise inherit the
+     host's `gap` and add a phantom `--badge-gap`-wide trailing space
+     after the slotted content. Mirrors `button.css` / `tag.css`. */
+  :scope[text]::after {
     content: attr(text);
   }
 

package/components/badge/badge.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIBadge
 tag: badge-ui
+status: stable
 component: Badge
 category: display
 version: 1
@@ -48,6 +49,7 @@ props:
       - beta
   text:
     description: Badge text content. Falls back to existing textContent.
+    required: true
     type: string
     default: ""
   textContent:

package/components/block/block.a2ui.json

@@ -84,6 +84,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "code": [
         "code",

package/components/block/block.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIBlock
 tag: block-ui
+status: stable
 component: Block
 category: layout
 version: 1

package/components/breadcrumb/breadcrumb.a2ui.json

@@ -77,6 +77,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "back": [
         "breadcrumb",

package/components/breadcrumb/breadcrumb.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIBreadcrumb
 tag: breadcrumb-ui
+status: stable
 component: Breadcrumb
 category: navigation
 version: 1

package/components/button/button.a2ui.json

@@ -162,6 +162,7 @@
         "selector": ":active"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "button": [
         "btn",

package/components/button/button.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIButton
 tag: button-ui
+status: stable
 component: Button
 category: action
 version: 1

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

@@ -131,6 +131,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "tags": [
         "DateTimeInput",

package/components/calendar-picker/calendar-picker.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UICalendarPicker
 tag: calendar-picker-ui
+status: stable
 component: CalendarPicker
 category: input
 version: 1

package/components/canvas/canvas.a2ui.json

@@ -62,6 +62,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "tags": [
         "render-surface",

package/components/canvas/canvas.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UICanvas
 tag: canvas-ui
+status: stable
 component: Canvas
 category: agent
 version: 1

package/components/card/card.a2ui.json

@@ -120,6 +120,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "catalog": [
         "product",

package/components/card/card.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UICard
 tag: card-ui
+status: stable
 component: Card
 category: container
 version: 1

package/components/chart/chart.a2ui.json

@@ -139,7 +139,8 @@
     }
   },
   "required": [
-    "component"
+    "component",
+    "type"
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
@@ -219,6 +220,7 @@
         "name": "empty"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "analytics": [
         "chart",

package/components/chart/chart.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIChart
 tag: chart-ui
+status: stable
 component: Chart
 category: agent
 version: 1
@@ -13,6 +14,7 @@ description: >-
 props:
   type:
     description: Chart type. All 18 enum values have dedicated render paths in chart.js.
+    required: true
     type: string
     default: bar
     enum:

package/components/chart-legend/chart-legend.a2ui.json

@@ -140,6 +140,7 @@
         "name": "static"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chart": [
         "chart-legend",

package/components/chart-legend/chart-legend.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIChartLegend
 tag: chart-legend-ui
+status: stable
 component: ChartLegend
 category: agent
 version: 1

package/components/chat-thread/chat-input.a2ui.json

@@ -143,6 +143,7 @@
         "name": "loading"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "message-input": [
         "conversation-input",

package/components/chat-thread/chat-input.yaml

@@ -21,6 +21,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIChatInput
 tag: chat-input-ui
+status: stable
 component: ChatInput
 category: agent
 version: 1

package/components/chat-thread/chat-thread.a2ui.json

@@ -103,6 +103,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "ai": [
         "chat",

package/components/chat-thread/chat-thread.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UIChatThread
 tag: chat-thread-ui
+status: stable
 component: ChatThread
 category: agent
 version: 1

package/components/check/check.a2ui.json

@@ -58,7 +58,8 @@
     }
   },
   "required": [
-    "component"
+    "component",
+    "label"
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
@@ -115,6 +116,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "checkbox": [
         "check",

package/components/check/check.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UICheck
 tag: check-ui
+status: stable
 component: Check
 category: layout
 version: 1
@@ -44,6 +45,7 @@ props:
     default: false
   label:
     description: Label text beside the checkbox
+    required: true
     type: string
     default: ""
   value:

package/components/code/code.a2ui.json

@@ -177,6 +177,7 @@
         "name": "invalid"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "api": [
         "api",

package/components/code/code.css

@@ -313,7 +313,7 @@
   }
 
   :scope .cm-content {
-    padding: 0;
+    padding: var(--code-py) var(--code-px);
     caret-color: var(--code-cursor);
   }
 

package/components/code/code.yaml

@@ -3,6 +3,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: UICode
 tag: code-ui
+status: stable
 component: Code
 category: display
 version: 1

package/components/col/col.a2ui.json

@@ -81,6 +81,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "column": [
         "col",