@adia-ai/a2ui-runtime 0.6.32 → 0.6.33

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — @adia-ai/a2ui-runtime
 
+## [0.6.33] — 2026-05-23
+
+### Fixed — card-ui body-slot drift closed across runtime + fixtures
+
+- **`renderer.js`** — card-ui body-slot resolution now respects the canonical `<card-ui><section>…</section></card-ui>` shape across all render paths. Runtime previously produced inconsistent body-slot wrapping for some A2UI tree shapes, causing visual fixture drift in eval-076, eval-082, eval-090, eval-099 visual goldens. Fix: 70-line resolver change in `renderer.js` aligns runtime output with the documented card body-slot contract. Companion eval visual goldens regenerated (4 PNGs). Audit script `scripts/audit/audit-card-structure.mjs` extended with the new contract. Files: `packages/a2ui/runtime/renderer.js`.
+
+## [0.6.32] — 2026-05-23
+
+### 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.6.32 work shipped in `@adia-ai/web-modules` (`everything.js` CDN entry + `admin-shell.helpers.css` scoping) and `@adia-ai/web-components` (FB-51 `everything.js` primitive bundle fix + status:stable yaml sweep). See those packages' CHANGELOGs for details.
+
 ## [0.6.31] — 2026-05-23
 
 ### Maintenance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-runtime",
-  "version": "0.6.32",
+  "version": "0.6.33",
   "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

@@ -171,6 +171,13 @@ export class A2UIRenderer {
       }
     }
 
+    // Structural validation: warn when Card/Drawer body content skips
+    // the canonical <Section> wrap. Mirrors scripts/audit/audit-card-structure.mjs
+    // (which scans authored HTML) — this hook catches runtime-built trees
+    // where the audit can't see. See feedback_card_drawer_body_section_wrap
+    // memory + packages/web-components/components/{card,drawer}/yaml.
+    this.#validateContainerStructure(components);
+
     // Build parent map for cycle detection
     const parentMap = new Map();
     for (const comp of components) {
@@ -228,6 +235,69 @@ export class A2UIRenderer {
     }
   }
 
+  // ── Structural validation (Card / Drawer body contract) ──
+
+  static #CARD_CANONICAL_CHILDREN = new Set([
+    'Header', 'Section', 'Footer',
+    // Media-first siblings (mirrors audit-card-structure.mjs whitelist):
+    // void/media elements may sit as siblings of header/section/footer.
+    'Img', 'Image', 'Video', 'Picture', 'Iframe',
+    // Layout siblings:
+    //   Aside    — "card with side nav" pattern per aside.yaml.
+    //   Divider  — visual rule between sibling content blocks (pricing-tier
+    //              pattern in eval-025).
+    'Aside', 'Divider',
+  ]);
+
+  static #DRAWER_CANONICAL_CHILDREN = new Set([
+    'Header', 'Section', 'Footer',
+  ]);
+
+  // Slot values that opt a child into a canonical body slot
+  // (drawer-ui supports explicit [slot="header|body|footer"]; card-ui
+  // accepts header/section/footer children for the same slots).
+  static #CANONICAL_SLOT_VALUES = new Set(['header', 'body', 'footer']);
+
+  #warnedStructure = new Set();
+
+  #validateContainerStructure(components) {
+    const componentsById = new Map();
+    for (const comp of components) {
+      if (comp.id != null) componentsById.set(comp.id, comp);
+    }
+
+    for (const comp of components) {
+      const isCard = comp.component === 'Card' || comp.component === 'ErrorContainer';
+      const isDrawer = comp.component === 'Drawer';
+      if (!isCard && !isDrawer) continue;
+
+      const allowed = isDrawer
+        ? A2UIRenderer.#DRAWER_CANONICAL_CHILDREN
+        : A2UIRenderer.#CARD_CANONICAL_CHILDREN;
+      const containerLabel = isDrawer ? '<drawer-ui>' : '<card-ui>';
+
+      const childIds = Array.isArray(comp.children) ? comp.children : [];
+      for (const childId of childIds) {
+        const child = componentsById.get(childId);
+        if (!child) continue;
+        // Allow if child has slot attribute matching canonical body slots
+        if (typeof child.slot === 'string'
+            && A2UIRenderer.#CANONICAL_SLOT_VALUES.has(child.slot)) continue;
+        if (allowed.has(child.component)) continue;
+
+        const key = `${comp.id}::${childId}::${child.component}`;
+        if (this.#warnedStructure.has(key)) continue;
+        this.#warnedStructure.add(key);
+        console.warn(
+          `A2UI: ${containerLabel} (id="${comp.id}") body must wrap "${child.component}" ` +
+          `(id="${childId}") in <Section>. Direct flow children bypass the canonical body ` +
+          `slot and lose --card-inset margin. Canonical children: ${[...allowed].join(', ')}` +
+          (isDrawer ? `, or slot="header|body|footer".` : `.`)
+        );
+      }
+    }
+  }
+
   // ── Apply props ──
 
   static #JS_PROPS = new Set(['data', 'columns', 'options', 'itemRenderer', 'textContent']);