@adia-ai/a2ui-corpus 0.6.45 → 0.6.47

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.47] — 2026-05-29
+
+### Changed — chunk re-harvest absorbing card `[grow]` attribute
+
+- **Chunks re-harvested 2026-05-29T05:22Z** — 284 chunks / 433 instances. Absorbs the `card.yaml` rule additions for `[grow]` section behavior.
+- **`catalog-a2ui_0_9_rules.txt`** regenerated with `[grow]` documentation rule.
+- **`chunk-embeddings.json`** regenerated (8.19 MB; semantic-retrieval parity for updated corpus).
+
+## [0.6.46] — 2026-05-29
+
+### Changed — chunk re-harvest absorbing DX sweep (bleed fixes + slot docs + token corrections)
+
+- **Chunks re-harvested 2026-05-29T05:07Z** — 284 chunks / 433 instances. The harvest absorbs the full DX sweep from v0.6.45 → v0.6.46: spurious `bleed` removed from catalog page-shell sources (`chat-page`, `doc-editor`, `gallery-page`, `kanban-page`); corrected token references (`--ui-border` → `--a-border`, `--a-text-muted` → `--a-fg-muted`) in chunk-source files; stale `--ui-primary` doc-prose updated.
+- **`chunk-embeddings.json` regenerated** — 8.19 MB (284 × 1536-d; content-driven re-embed for accurate semantic retrieval).
+- **`catalog-a2ui_0_9.json`** — regenerated absorbing `card.yaml` / `header.yaml` / `footer.yaml` slot additions (`icon`, `heading`, `description`, `action-leading`, `media`).
+
 ## [0.6.45] — 2026-05-29
 
 ### Maintenance

package/catalog-a2ui_0_9.json

@@ -4323,19 +4323,22 @@
         ],
         "slots": {
           "description": {
-            "description": "Optional descriptive text beneath the heading. Renders in the header slot at body-subtle typography. Use for short metadata lines (timestamp, author, status sentence)."
+            "description": "Secondary metadata — grid row 2 beneath the heading inside `<header>`, or a period/caption line beneath a metric inside `<footer>` (e.g. \"Jan – Mar 2024\"). Also accepts bare `<p>` / `<small>` / body-variant `<text-ui>` as direct children without slot=\"description\". Triggers space-between layout in the footer when combined with slot=\"action\"."
           },
           "action": {
-            "description": "Trailing action cluster in the header (e.g. icon-buttons, menu trigger, more-options). Aligns to the header's flex-end edge."
+            "description": "Trailing control cluster inside `<header>` (icon-buttons, menu trigger, more-options) or the primary action cluster inside `<footer>` (e.g. Save, Confirm). Aligns to the flex-end edge in both contexts. Pair with slot=\"action-leading\" for dual-cluster footers."
           },
           "action-leading": {
-            "description": "Leading action cluster in the header (e.g. back button, switcher, breadcrumb-context). Aligns to the header's flex-start edge, before the icon/heading column."
+            "description": "Leading control cluster — inline-start edge of the header or footer. In the header: back button, breadcrumb context, or workspace switcher, before the icon/heading column. In the footer: secondary action (e.g. Back) opposite the primary cluster."
           },
           "heading": {
-            "description": "Card title. Renders in the header slot with title typography. Typically a short noun phrase or document/object name."
+            "description": "Primary title — grid row 1 inside `<header>`, or the prominent metric value inside `<footer>` (trend-stat / KPI pattern). Also accepts bare `<h1>`–`<h6>` tags as direct children without slot=\"heading\". A slot=\"heading\" wrapper can contain inline badges or metadata alongside the title text."
           },
           "icon": {
-            "description": "Optional leading icon for the card header (status / brand / type marker). Renders next to the heading. Use `<icon-ui name=\"…\">` or any inline icon element."
+            "description": "Leading icon for the card header — status, brand, or type marker. Placed in column 1 of the 3-column header grid when present; heading + description shift to column 2. Use `<icon-ui name=\"…\">`, `<avatar-ui>`, or any inline icon element as a DIRECT child of the `<header>` with slot=\"icon\" (not inside a wrapper — direct-child only, per the :has(> [slot=\"icon\"]) gate)."
+          },
+          "media": {
+            "description": "Full-bleed media region — placed before the first `<header>` or `<section>` as the card's hero image / video / illustration slot. Stretches edge-to-edge (negative margin equal to the card's inset); first-child `[slot=\"media\"]` gets zero border-radius on the top corners so it sits flush with the card border."
           }
         },
         "states": [
@@ -10797,8 +10800,20 @@
           "table"
         ],
         "slots": {
+          "description": {
+            "description": "Caption or period text rendered beneath slot=\"heading\" — small, muted. Triggers space-between layout when combined with slot=\"action\". Also accepts bare <p> / <small> elements as direct children without slot=\"description\"."
+          },
           "default": {
-            "description": "Default slot — primary child content."
+            "description": "Default slot — primary child content. Typically flat <button-ui> children laid out by the `justify` prop. Prefer flat children; a nested <row-ui> double-applies layout and breaks the chrome's gap."
+          },
+          "action": {
+            "description": "Trailing action cluster — self-aligns to the inline-end edge of the footer. Pair with slot=\"action-leading\" for dual-cluster footers (e.g. Back on the left, Save on the right). Activated by card-ui, drawer-ui, and modal-ui @scope rules."
+          },
+          "action-leading": {
+            "description": "Leading action cluster — self-aligns to the inline-start edge of the footer. Typically a Back or secondary action that needs to sit opposite the primary cluster. Activated by drawer-ui @scope; also works in card-ui footers via the same slot selector."
+          },
+          "heading": {
+            "description": "Metric or period label — rendered prominently at the leading edge of the footer chrome (e.g. \"$12.4k\" / \"Jan – Mar 2024\"). When present the parent's @scope switches to a heading + description layout. Pairs with slot=\"description\" for a caption line below the value (trend-stat footer pattern). Activated by card-ui and drawer-ui @scope rules."
           }
         },
         "states": [
@@ -11124,11 +11139,20 @@
           "alert"
         ],
         "slots": {
+          "description": {
+            "description": "Secondary metadata — grid row 2 beneath the heading, spanning the heading and action columns. Also accepts bare <p> / <small> / body-variant <text-ui> as direct children without slot=\"description\". Renders muted + small."
+          },
           "default": {
-            "description": "Default slot — primary child content."
+            "description": "Default slot — primary child content. When no named slot= attributes are used, all children flow here as a block. Most card/drawer/modal usages prefer the named vocabulary below so the parent's @scope grid activates."
           },
           "action": {
-            "description": "Action region — buttons or badges on the right."
+            "description": "Trailing control cluster — placed in the last column of the parent container's header grid. Use for icon-buttons, menu triggers, or badge/button combinations. The first [slot=\"action\"] child pushes itself to the grid's end; subsequent siblings flow with gap."
+          },
+          "heading": {
+            "description": "Primary title — grid row 1 of the header grid. Also accepts bare <h1>–<h6> tags as direct children without slot=\"heading\". Renders at title weight + size per the parent's @scope. A slot=\"heading\" wrapper element can contain inline badges or metadata alongside the title text."
+          },
+          "icon": {
+            "description": "Leading icon column — placed in column 1 of the parent container's header grid (card-ui / drawer-ui / modal-ui / page-ui). Use <icon-ui name=\"...\">, <avatar-ui>, or any inline icon element. The grid activates only when this slot is present; without it the heading spans the full width."
           }
         },
         "states": [

package/catalog-a2ui_0_9_rules.txt

@@ -132,6 +132,7 @@
 - Heading slot accepts inline badges/metadata: <span slot="heading"><text-ui strong>Title</text-ui><badge-ui text="New" variant="accent"></badge-ui></span> renders title + badge on one row.
 - Description slot also accepts bare <p> or <small> elements as siblings of the heading — they participate in the grid's row 2 without needing slot="description".
 - Multiple <section> siblings are allowed and stack vertically. [bleed] on a section removes its margin for edge-to-edge content (tables, charts); [padding] adds a canvas-scrim background for hero regions.
+- [grow] on a section makes it fill the card's remaining height (flex:1 — same semantics as col-ui[grow]/row-ui[grow]). The card becomes a flex column so the section absorbs the leftover space after the header/footer. Requires the card to have a definite height (inline height, grid row track, or flex parent) — a content-sized card has nothing to fill. Combine with [bleed] for edge-to-edge fill: <section bleed grow>. A <chart-ui> directly inside a <section bleed> auto-grows without [grow] (zero-config convenience for the common chart case).
 - Footer with a [slot="description"] + [slot="action"] pair triggers justify-content: space-between — useful for a "Last saved …" note on the left and a Save/Cancel button group on the right.
 - Do NOT substitute <card-ui> for shell/page containers. <admin-page>, <admin-content>, and <page-ui> own routed page layout; <card-ui> is a localized bordered surface that lives INSIDE them. For overlays use <modal-ui> (centered) or <drawer-ui> (edge-anchored) — both share the same 4-stub <header>/<section>/<footer> vocabulary.
 - Use [raw] when a parent already owns the surface chrome (e.g. an auth screen centred on the viewport — see apps/user-flow/auth). Use [elevation] 0–3 for shadow depth; [variant="ghost"|"flat"] to remove shadow without removing structure. [draggable] emits a drag-end event; only enable on cards meant to move.