@adia-ai/a2ui-corpus 0.6.47 → 0.6.49

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.49] — 2026-05-30
+
+### Changed — corpus regen (card-ui slot sweep) + catalog `month` prop
+
+- **Chunk corpus** (284 chunks) absorbs the card-ui header slot sweep + `nav-group-ui` fixes across admin-dashboard + 5 catalog patterns (committed upstream in the demo-slot-sweep arc). `chunk-embeddings.json` in sync.
+- **`catalog-a2ui_0_9.json`** — regenerated to add the `month` prop on the calendar primitive (`YYYY-MM` displayed-month hint; date-range-picker uses it to show its end pane one month ahead of the start). Matches `calendar-grid.yaml`.
+
+## [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

package/catalog-a2ui_0_9.json

@@ -3701,10 +3701,7 @@
             "solid",
             "outline",
             "ghost",
-            "primary",
-            "secondary",
-            "soft",
-            "current"
+            "primary"
           ],
           "default": "solid"
         }
@@ -3861,6 +3858,11 @@
           "type": "string",
           "default": ""
         },
+        "month": {
+          "description": "Displayed month (YYYY-MM) used when no value is selected — shows a specific month independent of selection. A selected value always takes precedence. Used by date-range-picker to show its end pane one month ahead of the start.",
+          "type": "string",
+          "default": ""
+        },
         "rangeEnd": {
           "description": "End of a date range (ISO YYYY-MM-DD). See `rangeStart` for the full contract.",
           "type": "string",
@@ -4261,17 +4263,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 +11214,8 @@
             "accent",
             "success",
             "warning",
+            "danger",
+            "info",
             "data-ramp"
           ],
           "default": "data-ramp"
@@ -18394,6 +18395,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 +18508,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 +18709,9 @@
           "type": "string",
           "enum": [
             "default",
-            "accent",
             "success",
             "warning",
-            "danger",
-            "info"
+            "danger"
           ],
           "default": "default"
         }
@@ -20334,13 +20419,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 +23680,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

@@ -495,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.