@adia-ai/a2ui-corpus 0.6.49 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.7.0] — 2026-05-31
+
+### Changed — catalog regen (chevron→caret, FEEDBACK-90) + chunk re-harvest (docs-QA demo sweep)
+
+- `catalog-a2ui_0_9.json` regenerated — `table-ui`'s `row-expand` / `row-collapse` event descriptions now read "row's caret" (was "chevron"), propagated from the web-components yaml terminology sweep (ADR-0036 follow-up). Regen output of `npm run components`; no corpus-authoring change.
+- **Chunk corpus re-harvested** (284 chunks, 284 × 1536d embeddings) — 47 chunks absorbed real demo-markup changes from the docs-QA pass (field-ui in-chrome affordances moved onto input-ui slots, integration-card `side="right"` drawer fix, plan-picker tile cards, dead `size="sm"` swept off layout primitives across 68 sites). Both freshness gates green.
+
+## [0.6.50] — 2026-05-30
+
+### Changed — catalog regen for the `slot="caret"` vocabulary (ADR-0036)
+
+- **`catalog-a2ui_0_9.json` + `tree-item.a2ui.json` / `pane.a2ui.json` sidecars** regenerated after the `slot="chevron"` → `slot="caret"` rename in `tree-item-ui` / `pane-ui` (ADR-0036), so the generative catalog advertises the renamed disclosure slot. The chunk corpus was re-harvested (284 chunks) + re-embedded to confirm freshness — **no chunk content drift** (the caret indicator is auto-stamped, not authored in demo markup), so the committed chunk set is unchanged from [0.6.49].
+
 ## [0.6.49] — 2026-05-30
 
 ### Changed — corpus regen (card-ui slot sweep) + catalog `month` prop

package/catalog-a2ui_0_9.json

@@ -2527,14 +2527,6 @@
           "type": "string",
           "default": ""
         },
-        "name": {
-          "description": "Deprecated alias for `text` (logs a one-shot console warning; will be removed in a future release). New code should use `text=` instead.",
-          "type": "string",
-          "default": "",
-          "deprecated": true,
-          "deprecated_reason": "Use `text` instead. Will be removed in v0.6.0.",
-          "deprecated_since": "0.4.x"
-        },
         "shape": {
           "description": "Avatar shape",
           "type": "string",
@@ -2545,18 +2537,14 @@
           "default": "circle"
         },
         "size": {
-          "description": "Avatar size. Canonical scale (xs/sm/md/lg/xl); long-form aliases (small/medium/large/xlarge) accepted for back-compat.",
+          "description": "Avatar size — canonical scale.",
           "type": "string",
           "enum": [
             "xs",
             "sm",
             "md",
             "lg",
-            "xl",
-            "small",
-            "medium",
-            "large",
-            "xlarge"
+            "xl"
           ],
           "default": "md"
         },
@@ -3744,6 +3732,9 @@
           "Link"
         ],
         "slots": {
+          "icon-trailing": {
+            "description": "Trailing icon, after the label. Stamped from the `icon-trailing` prop, or slot a custom `<icon-ui slot=\"icon-trailing\">` directly (the consumer's element wins over the prop-stamped one). Sized to --content-height."
+          },
           "leading": {
             "description": "Icon container (start), sized to --content-height"
           },
@@ -4518,18 +4509,6 @@
           ],
           "default": "bar"
         },
-        "aspect": {
-          "description": "DEPRECATED (OD-CHART-02). Parents should size the chart directly (width/height on the enclosing card or container). Still honored for back-compat; emits a one-shot console.warn per instance when set.",
-          "type": "string",
-          "enum": [
-            "std",
-            "wide",
-            "square",
-            "tall"
-          ],
-          "default": "std",
-          "deprecated": true
-        },
         "color": {
           "description": "Color scheme",
           "type": "string",
@@ -4561,12 +4540,6 @@
           ],
           "default": "abbr"
         },
-        "heading": {
-          "description": "DEPRECATED (OD-CHART-02). Place chart titles in an enclosing card-ui's `<header><span slot=\"heading\">...</span></header>` instead. Still honored for back-compat; emits a one-shot console.warn per instance when set. Used as the chart's `aria-label` when no explicit label is provided.",
-          "type": "string",
-          "default": "",
-          "deprecated": true
-        },
         "hideAverage": {
           "description": "When true, suppress the overlaid average line",
           "type": "boolean",
@@ -10948,6 +10921,11 @@
           "type": "string",
           "default": "md"
         },
+        "minColumnWidth": {
+          "description": "Minimum track width for columns=\"auto-fit\"/\"auto-fill\" (any CSS length, e.g. \"240px\", \"16rem\"). Sets the minmax() floor so cards don't shrink below it before wrapping; unset uses the 12rem default. No effect on numeric columns.",
+          "type": "string",
+          "default": ""
+        },
         "rowGap": {
           "description": "Row gap override",
           "type": "string",
@@ -13556,11 +13534,12 @@
           "const": "Kbd"
         },
         "size": {
-          "description": "Sizing scale (compact tier — sm / md only).",
+          "description": "Sizing scale: sm, md (default), lg.",
           "type": "string",
           "enum": [
             "sm",
-            "md"
+            "md",
+            "lg"
           ],
           "default": ""
         }
@@ -16407,6 +16386,9 @@
           "default": {
             "description": "Spillover content revealed only when the card is checked — typically a follow-up form field (e.g. a textarea on an \"Other\" option, conditional inputs that depend on the selection). Aligns with the heading/description column; hidden via `display: none` when not checked."
           },
+          "action": {
+            "description": "CTA slot for `layout=\"tile\"` — a button-ui anchored to the card's bottom edge and stretched full-width, so a row of tile cards keeps their CTAs aligned regardless of body length (plan-picker-style pickers)."
+          },
           "heading": {
             "description": "Rich heading content. Overrides the `heading` attribute when present."
           },
@@ -17011,6 +16993,9 @@
           "text-area"
         ],
         "slots": {
+          "caret": {
+            "description": "Collapse caret inside the header. Auto-stamped as `<icon-ui slot=\"caret\" name=\"caret-right\">` (rotates on `[collapsed]`). Supply your own `slot=\"caret\"` child in the header to customize — adopt-or-stamp honors a declarative caret instead of stamping."
+          },
           "header": {
             "description": "Auto-created header element with label text and toggle arrow"
           }
@@ -20374,7 +20359,7 @@
           "default": false
         },
         "options": {
-          "description": "Option list. Array of {value, label, disabled?} or grouped {label, options: [...]}. Alternative to declarative <option> / <optgroup> children.",
+          "description": "Option list. Array of {value, label, disabled?, icon?, avatar?} or grouped {label, options: [...]}. Alternative to declarative <option> / <optgroup> children. Per-option icon/avatar render in the list AND reflect in the trigger's selected state.",
           "type": "array",
           "default": []
         },
@@ -21390,8 +21375,19 @@
       ],
       "properties": {
         "align": {
-          "description": "Alignment of stacked items",
+          "description": "Alignment of the layered children within the shared cell (maps to grid place-items). `center` (default) plus eight directional keywords.",
           "type": "string",
+          "enum": [
+            "center",
+            "top-left",
+            "top",
+            "top-right",
+            "left",
+            "right",
+            "bottom-left",
+            "bottom",
+            "bottom-right"
+          ],
           "default": "center"
         },
         "component": {
@@ -21462,6 +21458,11 @@
         }
       ],
       "properties": {
+        "bleed": {
+          "description": "Horizontal-bleed KPI layout. With a `slot=\"chart\"` child, the value / label / change stack on the left while the chart fills the right column at full height and bleeds to the card's top / right / bottom edges (the horizontal counterpart to a chart in a card `<section bleed>`). No effect without a chart slot.",
+          "type": "boolean",
+          "default": false
+        },
         "change": {
           "description": "Change indicator text (e.g. '+12%', '-3%')",
           "type": "string",
@@ -22882,7 +22883,7 @@
             }
           },
           "row-collapse": {
-            "description": "Fired when an already-expanded row's chevron is activated (collapses the row). Mirror of row-expand.",
+            "description": "Fired when an already-expanded row's caret is activated (collapses the row). Mirror of row-expand.",
             "detail": {
               "index": {
                 "description": "Row index in the underlying data array.",
@@ -22895,7 +22896,7 @@
             }
           },
           "row-expand": {
-            "description": "Fired when an expandable row's chevron is activated. detail.index is the row position; detail.row is the row data.",
+            "description": "Fired when an expandable row's caret is activated. detail.index is the row position; detail.row is the row data.",
             "detail": {
               "index": {
                 "description": "Row index in the underlying data array.",
@@ -26610,8 +26611,8 @@
           "--tree-bg-selected": {
             "description": "Background color when selected"
           },
-          "--tree-chevron-size": {
-            "description": "Size of the collapse chevron icon"
+          "--tree-caret-size": {
+            "description": "Size of the collapse caret icon"
           },
           "--tree-duration": {
             "description": "Transition duration"
@@ -26623,7 +26624,7 @@
             "description": "Primary text color"
           },
           "--tree-fg-muted": {
-            "description": "Muted text color (icons, chevrons)"
+            "description": "Muted text color (icons, carets)"
           },
           "--tree-focus-ring": {
             "description": "Focus ring box-shadow"
@@ -26719,6 +26720,12 @@
           "Accordion"
         ],
         "slots": {
+          "actions": {
+            "description": "Per-row action buttons (rename / add / overflow menu), right-aligned and hover-revealed. A declarative `slot=\"actions\"` child is adopted into the auto-stamped row (FEEDBACK-89), so it sits inline in the row rather than wrapping below it."
+          },
+          "caret": {
+            "description": "Override slot for the expand/collapse caret. Auto-stamped as `<icon-ui slot=\"caret\" name=\"caret-right\">` (rotates on `[open]`, hidden for leaf nodes). Supply your own `slot=\"caret\"` child to customize — adopt-or-stamp moves a declarative caret into the row."
+          },
           "icon": {
             "description": "Override the leading [icon] glyph with a custom slotted element (custom icon-ui, folder open/closed glyph, file-type marker). Mutually exclusive with the [icon] attribute — slot child wins."
           }

package/catalog-a2ui_0_9_rules.txt

@@ -571,6 +571,7 @@
 ## Select
 - Use <select-ui> for single-select with > 4 options or any list that benefits from a popover. Prefer <segmented-ui> / <radio-ui> when ≤ 4 visible options fit the row.
 - Compose options via native <option> / <optgroup> children — other tag names are silently ignored (per §225 v0.5.9) and warned once at runtime. Or set `.options` programmatically as an array of `{value, label, disabled?}` (grouped form: `{label, options:[…]}`).
+- Per-option visuals: give each <option> an `icon` (Phosphor name) or `avatar` (image URL) — `<option value="light" icon="sun">`. Each row renders its glyph in the list AND the trigger reflects the SELECTED option's icon/avatar (theme pickers, assignee/account switchers). `avatar` wins over `icon`; a host-level [icon]/[avatar] is the fallback when the selected option carries neither.
 - For dynamic option lists rendered inside <editor-shell>, set the JSON via the [data-options] attribute — <editor-shell>'s wireSelects() finds select-ui[data-options], JSON.parses the attribute, and assigns `.options` on connect. Useful for static-HTML toolbars where JS hydration would be awkward.
 - <select-ui> owns its own label / hint / error chrome (via [label] / [hint] / [error] props). Only wrap in <field-ui> when you need to share the field-chrome stack with sibling inputs in the same form row group.
 - Enable [searchable] for > 10 options; add [free-text] only when unmatched values are valid (tag entry, email-with-suggestion). Use [multiple searchable] for multi-select rather than authoring a separate multi-select primitive.
@@ -777,14 +778,14 @@
 - Provide a stable [value] attribute on every <tree-item-ui> that consumers will select. The `tree-select` event's detail.value is the identifier downstream code reads to know which node was picked.
 - Use [open] to pre-expand branch nodes on initial render. Do NOT set [selected] declaratively on more than one item — the parent <tree-ui> manages selection. The host listens for click / Enter / Space / ArrowRight (expand) / ArrowLeft (collapse) per WAI-ARIA tree-view APG.
 - Use [icon] (Phosphor name) for affordance (folder / file / component icons); use [badge] for counts or short status labels (§184 v0.5.5).
-- Nest further <tree-item-ui> in the default slot only — no <list-item-ui>, <nav-item-ui>, or arbitrary content inside a tree row. The chevron is auto-stamped when the row has nested tree-item-ui children.
+- Nest further <tree-item-ui> in the default slot only — no <list-item-ui>, <nav-item-ui>, or arbitrary content inside a tree row. The caret is auto-stamped when the row has nested tree-item-ui children.
 
 ## Tree
 - Use <tree-ui> only when data is hierarchical with arbitrary nesting AND a single selected node is meaningful. For flat lists use <list-ui>; for flat sidebar navigation use <nav-ui>; for one-level collapsible groups use <accordion-ui>.
 - Canonical mount: inside <editor-sidebar slot="leading"> → <pane-ui side="leading" resizable> → <section> → <tree-ui id="…"> as the structure / navigator pane of the three-pane editor shell. Pair with a <header> in the same pane (e.g. "Structure", "Layers", "Files").
 - Direct children of <tree-ui> MUST be <tree-item-ui>. No other element types in the default slot. <tree-ui> manages single-selection across the whole subtree and implements WAI-ARIA tree-view keyboard navigation (Arrow keys, Enter / Space, Home / End).
 - Listen for `tree-select` on the <tree-ui>, NOT on individual rows — selection is managed by the parent and bubbles once. Detail = {item, text, value, ctrlKey, metaKey, shiftKey}.
-- Per ADR-0027, <tree-ui> composes <icon-ui> (for chevrons) but does NOT auto-import its children. Consumer pages must explicitly import both <tree-ui> and <tree-item-ui>.
+- Per ADR-0027, <tree-ui> composes <icon-ui> (for carets) but does NOT auto-import its children. Consumer pages must explicitly import both <tree-ui> and <tree-item-ui>.
 
 ## Upload
 - File-upload input with drop zone + browse button. Form-associated; emits file-list change events.