@adia-ai/a2ui-corpus 0.7.26 → 0.7.28

package/CHANGELOG.md

@@ -1,4 +1,50 @@
 # Changelog — @adia-ai/a2ui-corpus
+## [0.7.28] — 2026-07-14
+
+### Fixed — TKT-0010, corpus admission-time validation classes 1 and 3
+
+`harvest-chunks.mjs`'s new admission-time validator (Phase 4a, shipped
+0.7.27) found 104/384 templated chunk instances (27%) failing schema/
+catalog validation. This cycle fixes the two classes owned by this
+package's schemas:
+
+- **`common_types.json`'s `CatalogComponentCommon`** now declares `span`
+  as a cross-cutting `DynamicString` property (mirroring the existing
+  `slot` entry) and a `patternProperties` allowance for `^data-` —
+  both legitimate JS/CSS hooks the transpiler already universally
+  preserves (TKT-0002), but previously rejected by Ajv's
+  `unevaluatedProperties: false` on every generated component schema
+  (the dominant failure class, ~70 of the 104).
+- **New `DynamicObjectList` `$def`** — `Chart.data`/`Table.data`'s
+  dynamic array props were compiled to `DynamicStringList`
+  (array-of-string only), the wrong shape for row-record data. Split a
+  proper array-of-object variant; `components.mjs`'s `compileProp`
+  selects it when a prop's yaml declares `items: {type: object}` (see
+  `@adia-ai/web-components`'s `chart.yaml`/`table.yaml`). The
+  companion transpiler-side bug (the attribute value was never
+  actually `JSON.parse`d) is fixed in `@adia-ai/a2ui-compose`.
+- **`catalog-a2ui_0_9.json` regenerated** to pick up both schema
+  changes.
+
+Verified: `harvest-chunks.mjs --dry` dropped from 104 → 16 invalid
+chunk instances; all 16 remaining are already-tracked class-2 debt
+(enum drift + accessibility anti-patterns, matching `verify:corpus`'s
+existing 118-warn baseline) — zero new class-1/3-shaped failures.
+`--strict` stays opt-in (not flipped to the harvester's default) since
+that floor is accepted, not cleared, by this cycle.
+
+### Maintenance
+- **Chunk corpus re-harvested** to reflect the schema fixes above plus
+  content fixes in three `.contents.html` sources (`IntegrationCard.provider`,
+  `Stat.label`, `Heatmap.type`, two runtime-badge placeholders, and
+  `Chart.data` now carrying real parsed arrays instead of raw JSON
+  text). 394 chunks total.
+
+## [0.7.27] — 2026-07-12
+
+### Maintenance
+- **Chunk corpus re-harvested through the 0.7.27 transpiler** — chunk bodies now carry the fidelity fixes shipped in `@adia-ai/a2ui-compose` 0.7.27 (`[span]` preservation, `Tag` `text`-prop labels) and the `aria-label` propagation contract; embeddings index rebuilt to match (394 chunks × 1536d).
+- **Catalog (`catalog-a2ui_0_9.json`) regenerated** — picks up `richtext-ui`'s new `flush` prop from the yaml SoT.
 
 ## [0.7.26] — 2026-07-04
 
@@ -302,7 +348,7 @@ Patterns shipped: card-ui header/section/footer anatomy; row-ui header pattern;
 
 ### Maintenance
 
-- **Lockstep version bump only.** Peer's v0.6.32 absorbed the chunk + embeddings regen against the status:stable yaml sweep (recovery committed at `e864fc396` post peer's release commit `5285defa8`; see [`2026-05-23-freshness-gate-recovery-v0.6.32.md` case study](../../../.agents/skills/adia-ui-release/assets/case-studies/2026-05-23-freshness-gate-recovery-v0.6.32.md)).
+- **Lockstep version bump only.** Peer's v0.6.32 absorbed the chunk + embeddings regen against the status:stable yaml sweep (recovery committed at `e864fc396` post peer's release commit `5285defa8`; see `2026-05-23-freshness-gate-recovery-v0.6.32.md` case study (git history)).
 
 ## [0.6.31] — 2026-05-23
 
@@ -953,7 +999,7 @@ The harvester is repo-tooling (`scripts/build/`), not a corpus package member, b
 - **§42 nested-expand-then-transpile pass** — after collection, recursively expands `<!-- nested: <name> -->` placeholders in annotated chunks, then transpiles the expanded HTML to A2UI templates via `transpileHTML(html, { mode: 'instant' })`.
 - **§45 source-aware tier-1 expansion fix** — replaces §42's "first wins" canonical-html rule with directory-aware selection. **Bug**: `auth-card-content` has 24 instances; the 404 page sorted alphabetically first, so EVERY auth chunk silently inlined 404 page content from §41 landing through §45 discovery (smoke tests only checked retrieval strategy, not template content). **Fix**: Tier 1 exact directory match → Tier 2 deepest common directory prefix → Tier 3 alphabetical. Without it, `apps/user-flow/app/auth/sign-in/` shares depth with `apps/user-flow/app/auth/sign-in/mfa/` and tie-break would pick wrong sibling.
 
-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) §§ 36-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` §§ 36-51 for per-§ details.
 ## [0.4.3] - 2026-05-11
 
 ### Changed
@@ -1202,7 +1248,7 @@ Patch cut — no breaking changes.
 
 ### Changed — Trait registry now generated from web-components SoT (2026-05-02)
 
-`packages/a2ui/retrieval/catalog.js` no longer carries a hand-curated `traitRegistry` array. The trait list is loaded at module init from `packages/web-components/traits/_catalog.json` (generated by `node scripts/build/traits-catalog.mjs` in the monorepo root from live `defineTrait()` metadata). Per [ADR-0018](../../../.brain/adrs/0018-trait-source-of-truth-and-declarative-attribute.md).
+`packages/a2ui/retrieval/catalog.js` no longer carries a hand-curated `traitRegistry` array. The trait list is loaded at module init from `packages/web-components/traits/_catalog.json` (generated by `node scripts/build/traits-catalog.mjs` in the monorepo root from live `defineTrait()` metadata). Per `ADR-0018`.
 
 Behavior changes:
 - 4 phantom traits (`disabled-state`, `form-associated`, `value-sync`, `resettable`) no longer appear in MCP `get_traits` responses — they had no implementation in `traits/`. Auto-pruned by construction.
@@ -1250,11 +1296,11 @@ New `scripts/build/under-harvest-audit.mjs` flags pages under `site/pages/{patte
 ### Fixed — A2UI registry gap closure + ADR-0015 pattern migration (2026-05-02)
 
 - **Registry additions** in `@adia-ai/a2ui-utils`: `Field`, `Rating`, `ListItem`, `NavItem`, `NavGroup`. All 5 components existed; only the registry mapping was missing. Net effect on the corpus: 28/113 hand-authored patterns previously rendered with `[unknown: X]` placeholders when imported into `/site/playground/a2ui-editor`. After: 0/113 unknown.
-- **`patterns/navigation/section-subnav.json`** migrated per [ADR-0015 § Nav consolidation](../../../.brain/adrs/0015-three-tier-naming-convention.md). `SectionNav` → `Nav variant=section`; `SectionNavItem` → `NavItem`. The pattern was referencing the retired 6-element nav family.
+- **`patterns/navigation/section-subnav.json`** migrated per `ADR-0015 § Nav consolidation`. `SectionNav` → `Nav variant=section`; `SectionNavItem` → `NavItem`. The pattern was referencing the retired 6-element nav family.
 - **`patterns/layout/weather-widget.json`** — renamed `Metric` → `Stat` (no `<metric-ui>` exists; `Stat` is the canonical metric/value/change/trend primitive).
 - Smoke side-effect: zettel score bumped 91 → 92; smoke validation flipped from `valid=false score=98/91` → `valid=true score=100/92`. The registry gaps were tripping validation upstream.
 
-Per-finding triage in [`.claude/docs/reports/playground-examples-review-2026-05-02.md`](../../../.claude/docs/reports/playground-examples-review-2026-05-02.md).
+Per-finding triage in `.claude/docs/reports/playground-examples-review-2026-05-02.md`.
 ## [0.2.0] - 2026-05-02
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages now share one
@@ -1304,12 +1350,12 @@ release.
   `<adia-chat-ui>`; `<editor-shell>` was `<adia-editor-ui>`;
   `<admin-shell>` was `<app-shell-ui>`; `<gen-root>` was
   `<gen-ui-ui>`; `<chat-thread-ui>` was `<chat-ui>`). Element renames
-  per [ADR-0015](../../../.brain/adrs/0015-three-tier-naming-convention.md);
+  per `ADR-0015`;
   nav consolidation per ADR-0015 § Nav consolidation. The 6-element
   nav family (`<app-nav-*>` + `<section-nav-*>`) collapsed into 3
   primitives. Synthesizer no longer emits the renamed-away tags.
 - **`yaml name:` fields swept** per
-  [ADR-0016](../../../.brain/adrs/0016-class-naming-convention.md) —
+  `ADR-0016` —
   primitives now `name: UI<X>` (was `Adia<X>`); modules now
   `name: <X>` without the `Adia` prefix. Consumers reading the
   catalog to cross-reference class names get the current convention.

package/README.md

@@ -61,7 +61,7 @@ hand-authored ungrounded JSON lives in `corpus/`.
 > retrievable equivalents were either (a) already represented in the
 > chunks corpus via annotated `data-chunk-*` regions, or (b) deemed
 > non-grounded under the locked rule and DELETE'd in §73 Mode-C triage
-> (target for v0.4.7). See [`.claude/docs/journal/2026/05/2026-05-12.md`](../../../.claude/docs/journal/2026/05/2026-05-12.md)
+> (target for v0.4.7). See `.claude/docs/journal/2026/05/2026-05-12.md`
 > §§ 36-§42, §65, §72 for the multi-arc retirement narrative.
 
 ## Layout

package/catalog-a2ui_0_9.json

@@ -4618,7 +4618,7 @@
         },
         "data": {
           "description": "JS property (set programmatically — `el.data = [...]`). An array of plain objects; each object's keys are named by the `x` and `y` attributes — e.g. `<chart-ui x=\"month\" y=\"revenue\">` consumes `[{month:'Jan', revenue:3200}, {month:'Feb', revenue:4100}]`. The Chart.js `{labels, datasets}` envelope is NOT chart-ui's API — passing it (or any non-array value) renders an empty chart. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect. Custom accessor on the element class, not a reflected attribute.",
-          "$ref": "#/$defs/DynamicStringList"
+          "$ref": "#/$defs/DynamicObjectList"
         },
         "format": {
           "description": "Number-format mode applied to axis labels + value overlays + donut total + gauge value + treemap value + funnel value + internal tooltip. `abbr` is the legacy 1.2K / 3M format; `decimal` fixes 2 decimals; `currency` prefixes via `--chart-currency-prefix` token (default \"$\"); `percent` multiplies × 100 and adds a % suffix.",
@@ -13904,6 +13904,10 @@
             "lg"
           ],
           "default": ""
+        },
+        "textContent": {
+          "description": "Key label text, extracted from innerHTML (e.g. \"Ctrl+K\"). The main payload field for Kbd components extracted from HTML — mirrors Text/Code's textContent prop.",
+          "$ref": "#/$defs/DynamicString"
         }
       },
       "required": [
@@ -19977,6 +19981,11 @@
         "component": {
           "const": "RichText"
         },
+        "flush": {
+          "description": "Paragraph-grade embedding mode — removes the article chrome (body padding and the 45rem reading measure, plus the trailing paragraph margin) so the rendered markdown sits flush in a host column like a plain text block. Use when richtext carries a single paragraph or fragment inside an already-measured layout (doc pages, cards); leave off for standalone articles and chat transcripts.",
+          "type": "boolean",
+          "default": false
+        },
         "markdown": {
           "description": "Component property: markdown.",
           "type": "string",
@@ -23148,7 +23157,7 @@
         },
         "data": {
           "description": "Row records. Array of plain objects keyed to columns[].key.",
-          "$ref": "#/$defs/DynamicStringList"
+          "$ref": "#/$defs/DynamicObjectList"
         },
         "density": {
           "description": "Controls cell padding and row height. 'compact' for dense data, 'standard' for default spacing, 'comfortable' for spacious rows.",
@@ -28046,6 +28055,10 @@
           "description": "Named slot to project into when child of a slotted container.",
           "type": "string"
         },
+        "span": {
+          "description": "Grid-child column span, read by grid-ui's CSS attribute selector ([span=\"N\"] { grid-column: span N }). Layout-bearing like slot — accepted on every component, not a per-component prop (TKT-0002/TKT-0010).",
+          "$ref": "#/$defs/DynamicString"
+        },
         "style": {
           "description": "Inline CSS string applied to the host element (use sparingly; prefer variants).",
           "type": "string"
@@ -28070,6 +28083,11 @@
           "description": "Font weight role. Common values: thin, light, normal, medium, semibold, bold.",
           "$ref": "#/$defs/DynamicString"
         }
+      },
+      "patternProperties": {
+        "^data-": {
+          "description": "Arbitrary data-* attribute — a JS/CSS hook the transpiler passes through verbatim (TKT-0010); not modeled per-component."
+        }
       }
     },
     "Checkable": {
@@ -28189,6 +28207,32 @@
         }
       ]
     },
+    "DynamicObjectList": {
+      "description": "An array of plain objects (e.g. chart/table row records) that may be a literal, a path-bound reference, or the result of a FunctionCall. TKT-0010: split from DynamicStringList, which only ever accepted array-of-string — the wrong shape for JS-set collection props whose items are records.",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "path"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "$ref": "#/$defs/FunctionCall"
+        }
+      ]
+    },
     "DynamicString": {
       "description": "A string that may be a literal, a path-bound reference, or the result of a FunctionCall.",
       "oneOf": [