@adia-ai/a2ui-compose 0.5.6 → 0.5.7

package/CHANGELOG.md

@@ -10,6 +10,17 @@ generator graph.
 ## [Unreleased]
 
 _No pending changes._
+
+## [0.5.7] - 2026-05-15
+
+### Changed — §210 cross-package sweep — `transpiler/`+`strategies/` text-variant retargeting (v0.5.7)
+
+Companion to `@adia-ai/web-components@0.5.7` §210 (`<text-ui>` variant enum cleanup — removed 6 phantom entries `h1`-`h6` + `subheading`).
+
+- `transpiler/transpiler-maps.js` — `HTML_TAG_MAP` retargets native `<h1>`-`<h6>` + `<summary>` from removed `h1`-`h6` variants to working role tokens (`display` / `title` / `heading` / `subsection`). Pre-§210 the mapping rendered silent body-default; post-§210 each level renders at its declared token size.
+- `strategies/monolithic/_shared.js` — TEXT TYPES system-prompt block updated to enumerate the actual `<text-ui>` variant enum (display/title/heading/subsection/section for headings; body / caption / label / kicker / code / deck / metric for inline / meta / lede). Generator prompt now matches the runtime contract.
+- `strategies/free-form-composer/free-form-composer.test.js` — fixture variant `'h1'` → `'display'` (test stub uses real variant).
+
 ## [0.5.6] - 2026-05-14
 
 ### Removed — §195 (v0.5.6) — retired fragment-graph iteration codepath

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adia-ai/a2ui-compose",
-  "version": "0.5.6",
-  "description": "AdiaUI A2UI compose engine \u2014 framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
+  "version": "0.5.7",
+  "description": "AdiaUI A2UI compose engine — framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
   "type": "module",
   "exports": {
     ".": "./index.js",

package/strategies/free-form-composer/free-form-composer.test.js

@@ -22,7 +22,7 @@ const FIXTURE_VOCAB = [
     keywords: ['login', 'auth'],
     template: [
       { id: 'card', component: 'Card', children: ['title', 'submit'] },
-      { id: 'title', component: 'Text', variant: 'h1', textContent: 'Sign in' },
+      { id: 'title', component: 'Text', variant: 'display', textContent: 'Sign in' },
       { id: 'submit', component: 'Button', text: 'Continue', variant: 'primary' },
     ],
   },
@@ -33,7 +33,7 @@ const FIXTURE_VOCAB = [
     keywords: ['signup', 'register'],
     template: [
       { id: 'card', component: 'Card', children: ['title'] },
-      { id: 'title', component: 'Text', variant: 'h1', textContent: 'Create account' },
+      { id: 'title', component: 'Text', variant: 'display', textContent: 'Create account' },
     ],
   },
 ];

package/strategies/monolithic/_shared.js

@@ -195,9 +195,10 @@ LAYOUT PRIMITIVES:
 - Grid (grid-ui): CSS grid. Use columns="2"|"3"|"4", gap="4".
 
 TEXT TYPES (component="Text"):
-- variant="h1" through "h6" for headings (renders native heading tags)
-- variant="body" for paragraphs
-- for small text
+- variant="display" / "title" / "heading" / "subsection" / "section" for headings (largest → smallest)
+- variant="body" for paragraphs (default)
+- variant="caption" / "label" / "kicker" / "code" for small / meta text
+- variant="deck" / "metric" for lede / KPI text
 - Use textContent prop for the display text
 
 TABS (component="Tabs"):

package/transpiler/transpiler-maps.js

@@ -186,12 +186,26 @@ for (const [type, tag] of registry) {
 
 /** @type {Record<string, { type: string, props?: Record<string, unknown> }>} */
 export const HTML_TAG_MAP = {
-  h1:         { type: 'Text', props: { variant: 'h1' } },
-  h2:         { type: 'Text', props: { variant: 'h2' } },
-  h3:         { type: 'Text', props: { variant: 'h3' } },
-  h4:         { type: 'Text', props: { variant: 'h4' } },
-  h5:         { type: 'Text', props: { variant: 'h5' } },
-  h6:         { type: 'Text', props: { variant: 'h6' } },
+  // §210 (v0.5.7, FEEDBACK-17 §1): map native heading levels to working
+  // text-ui variants. Pre-§210 these mapped to `h1`-`h6` strings that
+  // text.css had no `:scope[variant=…]` rule for — silent body-default
+  // rendering. The retired variants (`h1`-`h6` + `subheading`) were
+  // removed from text.yaml/text.d.ts/text.a2ui.json in §210 because no
+  // matching tokens shipped. Replacement mapping prefers role tokens
+  // that actually render:
+  //   <h1> → 'display' (largest type — marketing hero)
+  //   <h2> → 'title'   (page title)
+  //   <h3> → 'heading' (section division)
+  //   <h4> → 'subsection' (sub-grouping inside a heading section)
+  //   <h5>, <h6> → 'subsection' (no smaller subsection token ships;
+  //                               consistent fallback over silent
+  //                               body-default)
+  h1:         { type: 'Text', props: { variant: 'display' } },
+  h2:         { type: 'Text', props: { variant: 'title' } },
+  h3:         { type: 'Text', props: { variant: 'heading' } },
+  h4:         { type: 'Text', props: { variant: 'subsection' } },
+  h5:         { type: 'Text', props: { variant: 'subsection' } },
+  h6:         { type: 'Text', props: { variant: 'subsection' } },
   p:          { type: 'Text', props: { variant: 'body' } },
   small:      { type: 'Text', props: { variant: 'caption' } },
   strong:     { type: 'Text', props: { variant: 'body' } },
@@ -217,7 +231,7 @@ export const HTML_TAG_MAP = {
   main:       { type: 'Column' },
   article:    { type: 'Card' },
   details:    { type: 'Accordion' },
-  summary:    { type: 'Text', props: { variant: 'h5' } },
+  summary:    { type: 'Text', props: { variant: 'subsection' } },
   dialog:     { type: 'Modal' },
   hr:         { type: 'Divider' },
   a:          { type: 'Link' },  // §47 — was: Button + variant=ghost (button.yaml line 60: "for inline navigation use `<link-ui>` instead")