@adia-ai/a2ui-corpus 0.6.46 → 0.6.48

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.48] — 2026-05-29
+
+### Changed — corpus re-harvest for the v0.6.48 release window
+
+- **`chunks/` (284 chunks) + `chunks/_index.json`** — full re-harvest absorbing the v0.6.48 window (foundation-styles reorg + the library-wide demo consolidation sweep + the date-range-picker fix). 433 chunk instances parsed → 284 unique.
+- **`chunk-embeddings.json`** — re-embedded all 284 chunks (text-embedding-3-small, 1536d, ~8.2 MB).
+- **`catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt`** — regenerated from the current component yaml set.
+
+## [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)

package/catalog-a2ui_0_9.json

@@ -3701,10 +3701,7 @@
             "solid",
             "outline",
             "ghost",
-            "primary",
-            "secondary",
-            "soft",
-            "current"
+            "primary"
           ],
           "default": "solid"
         }
@@ -4261,17 +4258,14 @@
           "default": ""
         },
         "variant": {
-          "description": "Visual style. `outline` is an alias for `outlined`; `flat` removes shadow; `soft`/`primary` apply tinted surfaces.",
+          "description": "Visual style. `outlined` (alias `outline`) draws a border with no shadow; `filled` uses a tinted canvas surface; `ghost` drops border + shadow.",
           "type": "string",
           "enum": [
             "default",
             "outlined",
             "outline",
             "filled",
-            "ghost",
-            "flat",
-            "soft",
-            "primary"
+            "ghost"
           ],
           "default": "default"
         }
@@ -11215,6 +11209,8 @@
             "accent",
             "success",
             "warning",
+            "danger",
+            "info",
             "data-ramp"
           ],
           "default": "data-ramp"
@@ -18394,6 +18390,97 @@
         "version": 1
       }
     },
+    "Preview": {
+      "title": "Preview",
+      "description": "Live code + render in one frame, from a single source. Wrap any authored AdiaUI markup: the same HTML renders LIVE in a stage and appears beside (or below) it as escaped, syntax-highlighted, copyable source via a nested <code-ui>. The code can never drift from the render — it IS the render's source. Batteries-included + HTML-first by construction: write one block of HTML, no inline styles, no JS wiring, and both panes appear. Use it for every component/recipe example so the primary snippet is always real, copyable HTML shown next to the working component.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "codeFirst": {
+          "description": "Show the code pane before (above / left of) the render pane. Default is render-first.",
+          "type": "boolean",
+          "default": false
+        },
+        "component": {
+          "const": "Preview"
+        },
+        "language": {
+          "description": "Language hint forwarded to the nested <code-ui> for syntax highlighting. Demos are HTML, so this defaults to `html`.",
+          "type": "string",
+          "default": "html"
+        },
+        "layout": {
+          "description": "Pane arrangement. Defaults to `split` — render and code side-by-side in a responsive 2-column grid that collapses to stacked on narrow widths (a bare `<preview-ui>` stamps `layout=\"split\"` on connect). Use `stack` to force the render stacked above the code; the docs auto-apply `stack` to wide self-framing demos (card / shell / table) that read cramped at half width. The `rows` attribute is a separate gallery mode and overrides this.",
+          "type": "string",
+          "enum": [
+            "split",
+            "stack"
+          ],
+          "default": ""
+        },
+        "rows": {
+          "description": "Gallery mode — treat each direct child as a SEPARATE example and lay each out as its own `[render | code]` row (live sample left, its own source right), stacked with dividers. Without `rows`, the whole slotted markup is one render + one code block. An optional `data-preview-label` on a child surfaces a caption above that row's sample.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "display",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "preview",
+          "example",
+          "demo",
+          "code-preview",
+          "live-preview",
+          "playground",
+          "codepen"
+        ],
+        "name": "UIPreview",
+        "related": [
+          "Code",
+          "Card"
+        ],
+        "slots": {
+          "default": {
+            "description": "The authored markup to preview. Captured verbatim on connect: re-parsed into the live render stage AND shown literally in the code pane. Any valid AdiaUI HTML — one element or many siblings."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "status": "stable",
+        "synonyms": {
+          "preview": [
+            "example",
+            "demo",
+            "sandbox",
+            "live-preview"
+          ]
+        },
+        "tag": "preview-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Progress": {
       "title": "Progress",
       "description": "Progress indicator with bar (default) or spinner variant. Value < 0 marks indeterminate state showing animated activity instead of a fill. Use inside <progress-row-ui> for labeled task lists or standalone for global loading indicators; for percent-complete inline displays use <stat-ui> instead.",
@@ -18416,16 +18503,11 @@
           "default": null
         },
         "variant": {
-          "description": "Display variant. Structural values (bar, spinner) set the render mode; semantic values (primary/success/warning/danger/info) set the fill color. Prefer the `color` global attribute for color; variant-as-color accepted for back-compat with older exemplars.",
+          "description": "Render mode — `bar` (default) or `spinner`. For fill color set the `--progress-fill` token (defaults to `--a-accent`); there is no variant-as-color (use the token).",
           "type": "string",
           "enum": [
             "bar",
-            "spinner",
-            "primary",
-            "success",
-            "warning",
-            "danger",
-            "info"
+            "spinner"
           ],
           "default": "bar"
         }
@@ -18622,11 +18704,9 @@
           "type": "string",
           "enum": [
             "default",
-            "accent",
             "success",
             "warning",
-            "danger",
-            "info"
+            "danger"
           ],
           "default": "default"
         }
@@ -20334,13 +20414,11 @@
           "default": ""
         },
         "variant": {
-          "description": "Visual variant — default chrome, `outline` for bordered, `ghost` for inline.",
+          "description": "Visual variant — `default` chrome or `ghost` for inline.",
           "type": "string",
           "enum": [
             "default",
-            "outline",
-            "ghost",
-            "soft"
+            "ghost"
           ],
           "default": "default"
         }
@@ -23597,13 +23675,10 @@
           "default": ""
         },
         "variant": {
-          "description": "Visual variant — default underline strip, `pills` for filled pill tabs, `underline` (explicit).",
+          "description": "Visual variant — `default` (underline strip) or `bordered`.",
           "type": "string",
           "enum": [
             "default",
-            "pills",
-            "underline",
-            "segmented",
             "bordered"
           ],
           "default": "default"

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.
@@ -494,6 +495,11 @@
 - [trigger="hover"] is for non-essential disclosure only — never use it for popovers containing inputs, destructive actions, or anything the user must interact with via keyboard. Default [trigger="click"] for everything interactive.
 - Do NOT nest <modal-ui> or <drawer-ui> inside slot="content"; popovers are non-modal anchored surfaces, not dialog hosts. Stacking dialog surfaces inside a popover breaks focus management.
 
+## Preview
+- Use <preview-ui> to demonstrate ANY component or recipe — wrap the example markup once; it shows the live component and its copyable HTML source together. Prefer it over a bare <code-ui> snippet (which shows code but no render) or a bare rendered sample (which shows output but no copyable HTML).
+- Author the slotted markup as plain AdiaUI HTML with attributes only — no inline `style=`, no `<script>` wiring. If a sample needs inline styles to look right, the component is missing an attribute; fix the component, not the demo.
+- Side-by-side ([layout="split"]) is the default. Set [layout="stack"] for wide self-framing examples (a full card / shell / table reads cramped at half width). Use [code-first] when the code is the teaching point and the render is confirmation.
+
 ## ProgressRow
 - Labeled progress row — composes a label + <progress-ui> + optional value display in one horizontal row.
 - For standalone progress bars without a row context use <progress-ui> directly.