@adia-ai/a2ui-runtime 0.7.25 → 0.7.27

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 # Changelog — @adia-ai/a2ui-runtime
+## [0.7.27] — 2026-07-12
+
+### Fixed
+- **Renderer stamps `el.id = comp.id` at all three element-creation sites.** Elements previously carried only `data-a2ui-id`, so authored `[id]`s never reached the live DOM — breaking every setup module that `getElementById`s its targets (the docs migration's dynamic tier surfaced this: pointer-tracking demos, trait wiring). The `id` is set outside the prop-diffing path, so later prop updates can never strip it.
+- **`a2ui.schema.json` — added `updateStyles` / `removeStyles` message schemas.** The renderer has handled the CSS channel since its introduction; the schema (and the generated `.d.ts`) now describe it, so schema validation no longer rejects documents that use it.
+
+## [0.7.26] — 2026-07-04
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.7.26 work shipped in variant="outline" retired as the reach-for-secondary generation-time habit. See `packages/a2ui/compose/CHANGELOG.md#unreleased` for details.
 
 ## [0.7.25] — 2026-07-03
 
@@ -592,7 +602,7 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 
   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 + [.claude/docs/journal/2026/05/2026-05-12.md](../../../.claude/docs/journal/2026/05/2026-05-12.md) §§ 45 / 49 / 51 for per-§ details.
+See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative + `.claude/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)
@@ -784,9 +794,9 @@ Five new A2UI type → AdiaUI tag mappings in `registry.js`:
 - `NavItem` → `nav-item-ui`
 - `NavGroup` → `nav-group-ui`
 
-All 5 components existed in `@adia-ai/web-components`; the registry hadn't been kept in sync. Closing this gap fixes 28/113 hand-authored patterns that previously rendered as `[unknown: X]` placeholders when imported into `/site/playground/a2ui-editor`, plus the render-preview's `streamed-list` example. The `NavItem` and `NavGroup` additions also align with [ADR-0015](../../../.brain/adrs/0015-three-tier-naming-convention.md)'s nav consolidation (the retired `SectionNav`/`SectionNavItem` types are migrated in `@adia-ai/a2ui-corpus`).
+All 5 components existed in `@adia-ai/web-components`; the registry hadn't been kept in sync. Closing this gap fixes 28/113 hand-authored patterns that previously rendered as `[unknown: X]` placeholders when imported into `/site/playground/a2ui-editor`, plus the render-preview's `streamed-list` example. The `NavItem` and `NavGroup` additions also align with `ADR-0015`'s nav consolidation (the retired `SectionNav`/`SectionNavItem` types are migrated in `@adia-ai/a2ui-corpus`).
 
-Smoke side-effect: zettel score 91 → 92; `smoke:engines` flipped from `valid=false score=98/91` to `valid=true score=100/92` because the unregistered types were tripping validation. Per-finding triage in [`.claude/docs/reports/playground-examples-review-2026-05-02.md`](../../../.claude/docs/reports/playground-examples-review-2026-05-02.md).
+Smoke side-effect: zettel score 91 → 92; `smoke:engines` flipped from `valid=false score=98/91` to `valid=true score=100/92` because the unregistered types were tripping validation. Per-finding triage in `.claude/docs/reports/playground-examples-review-2026-05-02.md`.
 
 ---
 ## [0.2.0] — 2026-05-02

package/a2ui.schema.d.ts

@@ -11,6 +11,8 @@ export type A2UIMessage =
   | UpdateDataModelMessage
   | WireComponentsMessage
   | DeleteSurfaceMessage
+  | UpdateStylesMessage
+  | RemoveStylesMessage
   | MetaMessage;
 
 /**
@@ -160,6 +162,23 @@ export interface DeleteSurfaceMessage {
   type: 'deleteSurface';
   surfaceId: string;
 }
+/**
+ * CSS channel: adopts a surface-scoped stylesheet (wrapped in @scope([data-a2ui-surface=<id>]) by the renderer). See specs/genui-css-channel.md.
+ */
+export interface UpdateStylesMessage {
+  type: 'updateStyles';
+  surfaceId: string;
+  styleId: string;
+  css: string;
+}
+/**
+ * CSS channel: removes a previously adopted surface-scoped stylesheet by styleId.
+ */
+export interface RemoveStylesMessage {
+  type: 'removeStyles';
+  surfaceId: string;
+  styleId: string;
+}
 /**
  * LLM self-critique or metadata. Not rendered; passed through for logging.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-runtime",
-  "version": "0.7.25",
+  "version": "0.7.27",
   "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/renderer.js

@@ -155,6 +155,7 @@ export class A2UIRenderer {
           if (!el) {
             el = document.createElement('div');
             el.setAttribute('data-a2ui-id', comp.id);
+            el.id = comp.id;
             el.setAttribute('data-a2ui-unknown', comp.component);
             el.textContent = `[unknown: ${comp.component}]`;
             surface.elements.set(comp.id, el);
@@ -166,11 +167,13 @@ export class A2UIRenderer {
         if (!el) {
           el = document.createElement(tagName);
           el.setAttribute('data-a2ui-id', comp.id);
+          el.id = comp.id;
           surface.elements.set(comp.id, el);
           this.#elements.set(comp.id, el);
         } else if (el.localName !== tagName) {
           const newEl = document.createElement(tagName);
           newEl.setAttribute('data-a2ui-id', comp.id);
+          newEl.id = comp.id;
           el.replaceWith(newEl);
           el = newEl;
           surface.elements.set(comp.id, el);