@adia-ai/web-components 0.6.30 → 0.6.32

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog — @adia-ai/web-components
 
+## [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
+
+Three pre-v0.4.0 `patterns/*.examples.html` files used legacy markup retired by ADR-0024 (`<aside data-sidebar>`, `<main>`, `<dialog data-command>` for admin-shell; raw `<header data-chat-name>` + `<section data-chat-messages>` + `<chat-input-ui data-chat-input>` for chat-shell; raw `<header>` + `<div data-editor-body>` + `<pane-ui data-left|data-right>` + `<div data-canvas>` for editor-shell). All three rewritten as canonical-hierarchy pattern hubs — code-ui block with the bespoke vocabulary + part-by-part table linking to `/site/components/*` reference pages + authoring rules + "where to next" cross-links. Affects EXE-rendered docs only (`patterns/` is NOT in the npm tarball's `files:` field). Files: `patterns/admin-shell/admin-shell.examples.html`, `patterns/chat-shell/chat-shell.examples.html`, `patterns/editor-shell/editor-shell.examples.html`.
+
+### Maintenance
+
+- Lockstep version bump tied to docs surface scrub. No source changes in this package; bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`.
+
 ## [0.6.30] — 2026-05-23
 
 ### Added — `dist/web-components.min.js` rolled-up CDN-ready JS bundle

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",

package/components/col/col.yaml

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

package/components/color-input/color-input.a2ui.json

@@ -198,6 +198,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "color-field": [
         "color-input"