@adia-ai/a2ui-corpus 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -9,7 +9,150 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 ## [Unreleased]
 
-_Nothing yet._
+## [0.0.3] - 2026-04-28
+
+Same-day extension after `0.0.2` shipped. Adds the **gen-UI training-chunk
+corpus** — 702 unique chunks (852 instances) harvested from `data-chunk`-marked
+elements across `site/pages/*` and the corpus exemplars. Pure-data addition;
+existing pattern/fragment/composition surface unchanged.
+
+### Added (gen-UI chunks)
+
+- **`chunks/<name>.json`** × 702 — one record per chunk; carries
+  `name`, `kind` (`block` | `panel` | `page`), `primary` (outer tag),
+  `slots[]` (named regions for compositional reasoning), `nested[]`
+  (child chunk names), `attrs` (indexed for retrieval), `html`
+  (bounding HTML, descendants intact), `source` (original file path),
+  `captured_at`. Multi-instance reusable slot chunks
+  (e.g. `auth-card-header`, `reg-step-header`) carry an `instances`
+  array — one entry per page where the chunk appears.
+- **`chunks/_index.json`** — aggregate index (metadata only, no HTML)
+  for fast lookup. Records total counts, by-kind tallies, per-chunk
+  pages + slot names + nested-chunk references.
+- **852 chunk instances** across ~150 distinct pages (70 template +
+  82 component primitive + 16 pattern). Coverage:
+  `block=844, panel=7, page=1`.
+
+### Added (companion tooling — not in tarball)
+
+- `scripts/build/harvest-chunks.mjs` (repo root) — walks site/pages
+  + corpus exemplars; depth-tracked HTML parser; writes per-chunk
+  records + aggregate index. Wired into
+  `packages/a2ui/corpus/scripts/run-pipeline.mjs` Step 1.
+- `packages/a2ui/corpus/scripts/chunk-library.js` — in-memory loader
+  for the chunk corpus; powers the new MCP retrieval tools (consumed
+  by `@adia-ai/a2ui-mcp@0.0.2`).
+- `npm run harvest:chunks` / `harvest:chunks:dry` — pipeline scripts.
+
+### Convention reference
+
+- Spec: [`docs/specs/genui-chunk-marker.md`](../../../docs/specs/genui-chunk-marker.md)
+  (Draft v0.1.0) — three attributes (`data-chunk`, `data-chunk-kind`,
+  `data-chunk-slot`); naming conventions per cluster; visual marker
+  rules; harvester contract.
+- Inventory: [`docs/specs/genui-chunk-inventory-001.md`](../../../docs/specs/genui-chunk-inventory-001.md)
+  — full list with intent labels + review status.
+
+## [0.0.2] - 2026-04-27
+
+Three-day batch since `0.0.1`. Catalog regenerated against the
+Phase 6 web-components surface (status enum, button `[color]` axis,
+canonical event names); four new dashboard / data patterns; nine
+prose exemplars purged of inline styles; auth-login + cta exemplars
+migrated to canonical field-ui wrapping; three superseded fragments
+removed. Pure-data package — no executable code change.
+
+### Added (patterns)
+
+- **`patterns/data/chart-card-with-trend-footer.{json,yaml}`** —
+  card-ui composition with chart in body and trend-stat footer
+  (KPI delta + sparkline). Dashboard pattern.
+- **`patterns/data/chart-grid-with-kpis.{json,yaml}`** — grid-ui
+  layout pattern with KPI cards above and chart-ui beneath, the
+  canonical "dashboard above the fold" shape.
+- **`patterns/data/chart-with-filter-pills.{json,yaml}`** —
+  chart-ui composed with row-ui of filter pills above (segmented-ui
+  / tag-ui mix), the standard chart-with-toolbar shape.
+- **`patterns/data/stat-with-sparkline.{json,yaml}`** — atomic
+  KPI stat pattern with inline sparkline. Used as the building
+  block for `chart-card-with-trend-footer`.
+
+### Added (authoring infrastructure)
+
+- **`exemplars/_shell.css`** — shared body-shell + decoration-class
+  stylesheet linked from the corpus exemplar root. Codifies the
+  "no inline styles in exemplars" rule documented in the project
+  CLAUDE.md / AGENTS.md. New exemplars link this file from their
+  `index.html` and rely on `col-ui` / `row-ui` / `grid-ui` for
+  layout instead of `<style>` blocks or `style="…"` attributes.
+
+### Changed (catalog)
+
+- **`catalog-a2ui_0_9.json`** rebuilt against the v0.0.20 / v0.0.21
+  web-components yaml surface. Diff includes:
+  - `status` enum on `timeline-item-ui` / `stepper-item-ui` /
+    `pipeline-status-ui` (replaces the prior multi-Boolean shape).
+  - `[color]` enum on `button-ui` (`default | accent | info |
+    success | warning | danger`), `variant` simplified to
+    style-only.
+  - Canonical event names — `submit` on `chat-ui` (was
+    `chat-submit`), `toggle` on `chart-legend-ui` (was
+    `legend-toggle`), `change` on `swiper-ui` (was `slide-change`).
+  - `error` variant alias dropped from `toast-ui` / `alert-ui` /
+    `tag-ui` enums.
+  - `agent-trace-ui` `[collapsed]` (was `[open]`).
+  - `field-ui` `error` prop removed from props list.
+  - `table-toolbar-ui` opt-out attribute names — `noFilter` /
+    `noSort` / `noColumns` / `noSearch`.
+- **`patterns/_components.json:3020`** — `timeline-item-ui`
+  children-snippet migrated `completed active` → `status="completed"`.
+  The snippet feeds the LLM bridge; the legacy form would have
+  caused gen-ui to suggest deprecated attributes when generating
+  timelines.
+- **`patterns/_index.json`** regenerated to reflect the four new
+  data patterns and a few keyword refinements.
+
+### Changed (exemplars)
+
+- **9 prose exemplars** (`prose/auth-login`, `prose/cta`,
+  `prose/feature-grid`, `prose/footer`, `prose/hero`,
+  `prose/pricing`, `prose/steps`, `prose/testimonials`) and
+  **`ui/auth-login`** purged of inline `<style>` blocks and
+  `style="…"` attributes. Width constraints come from `setup.js`
+  setting `--page-content-max-width` via
+  `setProperty`; layout from `col-ui` / `row-ui` / `grid-ui`;
+  asymmetric ratios from `[columns]` + `[span]`. Shadow + decoration
+  surface lifted to `_shell.css`.
+- **`exemplars/prose/auth-login/index.html` + `exemplars/ui/auth-login/index.html`** —
+  `<check-ui label="…">` migrated to canonical
+  `<field-ui inline label="…"><check-ui name="…"></field-ui>`
+  wrapping. 5 call sites total (Remember me, Trust this device,
+  Terms agreement). Each migrated checkbox now serializes with a
+  stable form key (`name="remember"` / `name="trust_device"` /
+  `name="terms"`).
+- **`exemplars/prose/cta/`** — `acme-logo` icon (fictitious; not
+  in `@phosphor-icons/core`) replaced with `hexagon` across 3
+  files: `index.html:21`, `a2ui.json:102`,
+  `chunks/prose-cta-card-1.json:65`. Cleared the
+  `Icon "acme-logo" not found in registry` warning that fired on
+  every render.
+
+### Removed (fragments)
+
+- **`fragments/content/chart-legend.json`** — superseded by the
+  `<chart-legend-ui>` primitive that landed in the web-components
+  package. Inline-rendering the legend as a fragment is no longer
+  the canonical path.
+- **`fragments/form/rating-row.{json,yaml}`** — superseded by
+  the `<rating-ui>` primitive's first-class API (label + value
+  + max + readonly all on the host element).
+
+### Verification
+
+- `node scripts/build/components.mjs --verify` — `clean — 96 files up-to-date`.
+- Catalog hash matches the rebuild script's deterministic output.
+- Pattern index reverse-lookup test: every `_index.json` ref
+  resolves to an existing pattern file.
 
 ---
 
@@ -65,25 +208,7 @@ Domain breakdown:
 - display, container: 3 each
 - settings, data-display, input: 1 each
 
-## [Unreleased]
-
-### Added
-- Pipeline re-run produced 70 newly ingested patterns (net library total: 215).
-
-### Changed
-- `patterns/layout/cookie-consent.{json,yaml}` renamed to `patterns/layout/consent-banner.{json,yaml}` (and the pattern's `name` field flipped `cookie-consent` → `consent-banner`). The old filename triggered common adblock / content-blocker filter lists (EasyList, uBlock), which blocked the Vite raw-import request with `ERR_BLOCKED_BY_CONTENT_BLOCKER` when the pattern library loaded in the browser. Filename was the URL segment the blocker matched — renaming the URL path is the fix. Keywords still include `cookie` / `gdpr` / `privacy` so retrieval continues to land on this pattern for those queries. Cascaded through `patterns/_index.json` (11 refs in the `related`/etc. graph + the main entry) and `pattern-embeddings.json` (single `"name"` key). Length-preserving rename (both strings are 14 chars) so byte offsets in the embeddings file are unchanged.
-- `patterns/_components.json` — `Footer.tag`, `Header.tag`, `Section.tag` updated from `*-n` → `*-ui` post-rename. `Nav.tag` deliberately kept as `nav-n` (sanctioned exception).
-- `patterns/_schema.json` — role enum `nav-item-n` → `nav-item`.
-- `fragments/content/icon-text-row.json` — purpose tag `nav-item-n` → `nav-item`.
-- `scripts/extract.js` — removed redundant `nav-group-n` / `nav-item-n` map entries (no parent `NavGroup`/`NavItem` in canonical A2UI registry). `nav-n` kept.
-- All `.a2ui.json` sidecars regenerated via `scripts/build-components.mjs` to reflect yaml cleanup across the component library — `catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt` rebuilt.
-
-### Verification
-- `node scripts/build-components.mjs --verify` — clean, 91 files up-to-date.
-
----
-
-## [0.1.0] — internal baseline (unreleased)
+## [0.1.0] — internal baseline (pre-public, predates 0.0.1)
 
 Initial version at the time the monorepo was established. Contains:
 

package/README.md

@@ -6,8 +6,8 @@ fixtures. Pure data plus the scripts that maintain it. No runtime.
 
 > The pipeline reads this package; this package never reads the pipeline.
 > See [`@adia-ai/a2ui-compose`](../compose) for engine code,
-> [`@adia-ai/web-components`](../web-components) for UI atoms,
-> [`@adia-ai/a2ui-utils`](../a2ui/utils) for the A2UI runtime (renderer,
+> [`@adia-ai/web-components`](../../web-components) for UI atoms,
+> [`@adia-ai/a2ui-utils`](../utils) for the A2UI runtime (renderer,
 > registry, streams, wiring),
 > [`@adia-ai/a2ui-mcp`](../mcp) for the MCP server.