@adia-ai/a2ui-runtime 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -13,6 +13,39 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 
 _No pending changes._
 
+## [0.4.4] - 2026-05-12
+
+### Changed
+
+- **`runtime/registry.js` — proactive transpiler+web-modules audit (§49).** Cross-referenced transpiler-emitted A2UI types (40 emissions) against the registry's PascalCase Map → Pass 1 found only `Search` as a gap (and Search is deliberately deprecated per the in-file comment). Per user directive ("use web-modules as part of the catalog mappings as needed"), expanded scope to `packages/web-modules/**/<name>.yaml` and discovered **0 of 28 web-modules had correct registry entries**. Added 27 new entries in a new "§49 — web-module catalog mappings" section, organized by cluster:
+  - **Admin shell (10):** `AdminCommand`, `AdminContent`, `AdminPage`, `AdminPageBody`, `AdminPageHeader`, `AdminScroll`, `AdminShell`, `AdminSidebar`, `AdminStatusbar`, `AdminTopbar`.
+  - **Chat (6):** `ChatComposer`, `ChatEmpty`, `ChatHeader`, `ChatShell`, `ChatSidebar`, `ChatStatus`.
+  - **Editor (6):** `EditorCanvas`, `EditorCanvasEmpty`, `EditorShell`, `EditorSidebar`, `EditorStatusbar`, `EditorToolbar`.
+  - **Singletons (5):** `GenRoot`, `SimpleContent`, `SimpleHero`, `SimpleShell`, `ThemePanel`.
+- **`Sidebar` → `admin-sidebar`** (was: native `<aside>`) per user directive in §49. AdminSidebar at `packages/web-modules/shell/admin-sidebar/` is the canonical sidebar affordance; native `<aside>` falls back via the validator's bare-HTML allowlist if needed.
+- **`ChatThread` → `chat-thread`** (was: `chat-thread-ui` primitive) — the module owns scroll-to-bottom + streaming behavior; the primitive remains accessible via its bare tag. Verified zero corpus records use `ChatThread` today before re-routing.
+- **`FormContainer` → `form` registry alias (§45)** — closes 12 `unknown-component` criticals surfaced when §45's auth chunks (containing `<form>` markup) hit the validator. The transpiler maps `<form>` → `FormContainer` (per `transpiler-maps.js`) but the registry had no entry. Renders as native `<form>` (no `form-ui` component exists).
+
+### Fixed
+
+- **`runtime/renderer.js` `#toAttr()` — preserve HTML standard single-token attributes (§51).** The naive `name.replace(/([A-Z])/g, '-$1').toLowerCase()` unconditionally kebab-cased camelCase prop names. Correct for multi-token HTML attrs (`ariaLabel` → `aria-label`, `dataChunk` → `data-chunk`), but BROKE HTML standard single-token attributes spelled all-lowercase:
+  - `autoComplete` → `"auto-complete"` ✗ (HTML attr is `autocomplete`)
+  - `inputMode`    → `"input-mode"`    ✗ (HTML attr is `inputmode`)
+  - `tabIndex`     → `"tab-index"`     ✗ (HTML attr is `tabindex`)
+  - `maxLength`    → `"max-length"`    ✗ (HTML attr is `maxlength`)
+
+  Project-lifetime category error; same shape as the §47 `<a>` → Button transpiler bug. Both encoded incorrect assumptions about HTML attribute spelling. Fix: new `static #HTML_LOWERCASE_ATTRS` set (38 HTML-spec attrs sourced from MDN reference + DOM specs covering input/form/media/image/anchor/generic/microdata/script categories); `#toAttr()` now consults the set before kebab-casing. Multi-token attrs still kebab correctly.
+
+See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative + [docs/journal/2026/05/2026-05-12.md](../../../docs/journal/2026/05/2026-05-12.md) §§ 45 / 49 / 51 for per-§ details.
+
+## [0.4.3] - 2026-05-11
+
+### Ride-along (no source changes)
+
+Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.3` (input-ui type=number locale + thousands grouping + hold-to-repeat) + `@adia-ai/a2ui-compose@0.4.3` + `@adia-ai/a2ui-retrieval@0.4.3` (process.env browser-compat fix) + `@adia-ai/a2ui-corpus@0.4.3` (catalog regen + chunks re-harvest with new settings-appearance pattern). Source byte-identical to v0.4.2.
+
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
+
 ## [0.4.2] - 2026-05-11
 
 ### Ride-along (no source changes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-runtime",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "A2UI runtime \u2014 renderer, registry, streams, surface manifest, and wiring primitives for the A2UI (Agent-to-UI) protocol. Framework-agnostic; pairs with any A2UI-conformant component set.",
   "type": "module",
   "exports": {

package/registry.js

@@ -98,6 +98,10 @@ export const registry = new Map([
 
   // Navigation
   ['Breadcrumb',       'breadcrumb-ui'],
+  ['Link',             'link-ui'],
+  ['Anchor',           'link-ui'],
+  ['Hyperlink',        'link-ui'],
+  ['NavLink',          'link-ui'],
   ['Nav',              'nav-ui'],
   ['NavGroup',         'nav-group-ui'],
   ['NavItem',          'nav-item-ui'],
@@ -155,6 +159,7 @@ export const registry = new Map([
   ['search-ui',        'search-ui'],
   ['upload-ui',        'upload-ui'],
   ['breadcrumb-ui',    'breadcrumb-ui'],
+  ['link-ui',          'link-ui'],
   ['nav-ui',           'nav-ui'],
   ['noodles-ui',       'noodles-ui'],
   ['pagination-ui',    'pagination-ui'],
@@ -184,8 +189,70 @@ export const registry = new Map([
   ['Keyboard',         'kbd-ui'],
   ['DatePicker',       'calendar-picker-ui'],
   ['CommandPalette',   'command-ui'],
+  ['FormContainer',    'form'],  // §45 — transpiler maps <form> → FormContainer; no form-ui component exists, so render as native <form>
+  ['Sidebar',          'admin-sidebar'], // §48 — transpiler maps <aside> → Sidebar; routed to the AdminSidebar web-module (packages/web-modules/shell/admin-sidebar/). Per-user directive in §49: prefer admin-sidebar over native <aside> for sidebar affordances.
   ['Segmented',        'segmented-ui'],
   ['OTP',              'otp-input-ui'],
+
+  // Missing PascalCase entries discovered by verify:corpus (§39, 2026-05-12).
+  // Composition corpus used these names; registry didn't map them so the
+  // renderer would have silently dropped these components.
+  ['Textarea',         'textarea-ui'],          // case alias for TextArea
+  ['RichText',         'richtext-ui'],
+  ['Richtext',         'richtext-ui'],          // case alias
+  ['DescriptionList',  'description-list-ui'],
+  ['ActionItem',       'action-item-ui'],
+  ['ActionList',       'action-list-ui'],
+  ['Inspector',        'inspector-ui'],
+  ['Heatmap',          'heatmap-ui'],
+  ['Chat',             'chat-ui'],
+  ['ChatThread',       'chat-thread'],          // §49 — re-routed to the chat web-module (was: chat-thread-ui primitive). The module owns scroll-to-bottom + streaming; primitive remains accessible via bare `chat-thread-ui` tag.
+  ['ChatInput',        'chat-input-ui'],
+  ['OptionCard',       'option-card-ui'],
+  ['Option',           'option-card-ui'],       // bare Option → option-card-ui
+
+  // §49 — web-module catalog mappings (packages/web-modules/<cluster>/).
+  // These are module-tier components that compose primitives into full
+  // surface affordances (page shells, sidebars, chat surfaces, editor
+  // surfaces, theme panel). Without these entries, A2UI corpus records
+  // emitting any of them produce unknown-component criticals (same
+  // pattern caught reactively for FormContainer §45 + Sidebar §48).
+  // Discovered via a transpiler-vs-registry audit across §49.
+
+  // Admin shell cluster — chrome surfaces for SaaS admin/dashboard surfaces
+  ['AdminCommand',     'admin-command'],
+  ['AdminContent',     'admin-content'],
+  ['AdminPage',        'admin-page'],
+  ['AdminPageBody',    'admin-page-body'],
+  ['AdminPageHeader',  'admin-page-header'],
+  ['AdminScroll',      'admin-scroll'],
+  ['AdminShell',       'admin-shell'],
+  ['AdminSidebar',     'admin-sidebar'],         // canonical PascalCase mapping; the Sidebar alias above resolves through this
+  ['AdminStatusbar',   'admin-statusbar'],
+  ['AdminTopbar',      'admin-topbar'],
+
+  // Chat cluster — LLM-streaming conversation surfaces
+  ['ChatComposer',     'chat-composer'],
+  ['ChatEmpty',        'chat-empty'],
+  ['ChatHeader',       'chat-header'],
+  ['ChatShell',        'chat-shell'],
+  ['ChatSidebar',      'chat-sidebar'],
+  ['ChatStatus',       'chat-status'],
+
+  // Editor cluster — A2UI canvas editor surfaces
+  ['EditorCanvas',     'editor-canvas'],
+  ['EditorCanvasEmpty', 'editor-canvas-empty'],
+  ['EditorShell',      'editor-shell'],
+  ['EditorSidebar',    'editor-sidebar'],
+  ['EditorStatusbar',  'editor-statusbar'],
+  ['EditorToolbar',    'editor-toolbar'],
+
+  // Runtime / simple / theme — singleton surfaces
+  ['GenRoot',          'gen-root'],
+  ['SimpleContent',    'simple-content'],
+  ['SimpleHero',       'simple-hero'],
+  ['SimpleShell',      'simple-shell'],
+  ['ThemePanel',       'theme-panel'],
 ]);
 
 /**

package/renderer.js

@@ -252,6 +252,40 @@ export class A2UIRenderer {
     body: 'p', caption: 'small',
   };
 
+  // §51 — HTML-standard single-token attributes. These are valid attribute
+  // names spelled all-lowercase in the HTML spec (NOT multi-token kebab
+  // names like aria-label / data-chunk). When the corpus or LLM writes
+  // them in camelCase (autoComplete, inputMode, tabIndex), the renderer
+  // should pass through as the canonical lowercase form, not naive kebab.
+  // List sourced from MDN HTML attribute reference + DOM specs; covers
+  // the attributes actually emitted by A2UI components.
+  static #HTML_LOWERCASE_ATTRS = new Set([
+    // Input / form attributes
+    'autocomplete', 'autofocus', 'autocapitalize', 'autocorrect',
+    'inputmode', 'enterkeyhint', 'spellcheck',
+    'maxlength', 'minlength', 'readonly', 'novalidate', 'formnovalidate',
+    'formaction', 'formenctype', 'formmethod', 'formtarget',
+    'multiple', 'pattern', 'placeholder', 'required',
+    'tabindex', 'accesskey',
+    // Media attributes
+    'autoplay', 'autopictureinpicture', 'controls', 'crossorigin',
+    'disablepictureinpicture', 'disableremoteplayback',
+    'loop', 'muted', 'playsinline', 'preload',
+    // Image / source attributes
+    'srcset', 'srcdoc', 'srclang', 'sizes', 'loading',
+    'decoding', 'fetchpriority', 'ismap', 'usemap',
+    // Anchor / link attributes
+    'hreflang', 'referrerpolicy', 'download',
+    // Generic / structural
+    'contenteditable', 'contextmenu', 'draggable',
+    'dirname', 'colspan', 'rowspan', 'headers',
+    'allowfullscreen', 'allowpaymentrequest',
+    // Microdata
+    'itemid', 'itemprop', 'itemref', 'itemscope', 'itemtype',
+    // Module / script
+    'nomodule', 'nonce',
+  ]);
+
   #resolveTextTag(variant, comp) {
     // Semantic HTML variants get native tags (accessibility)
     if (!comp?.slot && A2UIRenderer.#TEXT_TAG_MAP[variant]) {
@@ -319,6 +353,18 @@ export class A2UIRenderer {
   }
 
   #toAttr(name) {
+    // §51 — HTML-standard single-token attributes are passed through unchanged
+    // (lowercased). The naive `\$1`-based kebab-case mangles these into
+    // multi-token forms that the platform doesn't recognize:
+    //   autoComplete → "auto-complete" ✗ (HTML attr is "autocomplete")
+    //   inputMode    → "input-mode"    ✗ (HTML attr is "inputmode")
+    //   tabIndex     → "tab-index"     ✗ (HTML attr is "tabindex")
+    //   maxLength    → "max-length"    ✗ (HTML attr is "maxlength")
+    // Multi-token attrs like ariaLabel → aria-label and dataChunk → data-chunk
+    // remain kebab-cased because that IS the HTML spec for them.
+    if (A2UIRenderer.#HTML_LOWERCASE_ATTRS.has(name.toLowerCase())) {
+      return name.toLowerCase();
+    }
     return name.replace(/([A-Z])/g, '-$1').toLowerCase();
   }