@adia-ai/a2ui-corpus 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -19,6 +19,35 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.5.5] - 2026-05-14
+
+### Added — §176 (v0.5.5) — six new sub-component catalog entries
+
+Six sibling yamls authored under the v0.5.4 §172 scanner pattern (parent-folder co-located):
+
+- `list/list-item.yaml` (3 props: icon, text, description)
+- `avatar/avatar-group.yaml` (2 props: max, size)
+- `accordion/accordion-item.yaml` (2 props: text, open)
+- `timeline/timeline-item.yaml` (8 props: text, description, time, duration, icon, variant, status, spinner)
+- `action-list/action-item.yaml` (5 props: icon, text, value, variant, disabled)
+- `tabs/tab.yaml` (4 props: text, value, icon, disabled)
+
+These describe co-located sub-component classes that previously existed as registered custom elements (e.g. `UIListItem` from `list/class.js`) without their own catalog entry — surfaced as the §175 baseline-orphan class. Now LLM-driven generation has access to per-prop signatures for sub-components.
+
+Catalog: **125 → 131 components** (+6).
+
+### Changed — corpus re-harvested
+
+230 chunks re-harvested against the updated transpiler. **9 chunks improved** with restored Tab/ActionItem/AvatarGroup/ChatInput props that the transpiler previously dropped (same architectural class as v0.5.4 §163/§164 catalog→transpiler drift fix — applied at finer grain on newly-authored sub-components). `chunk-embeddings.json` rebuilt (230 × 1536-dim, 6,632 KB).
+
+### Added — §184 (v0.5.5, peer FEEDBACK-08) — tree-item catalog entry
+
+Seventh sibling yaml: `packages/web-components/components/tree/tree-item.yaml`. `UITreeItem` is no longer an orphan class; has its own catalog entry, `.d.ts`, and `.a2ui.json` sidecar.
+
+Catalog after §184: **132 components**.
+
+Commits `443365913` + `30025e51e` (peer). See root CHANGELOG and journal §176/§184 for full context.
+
 ## [0.5.4] - 2026-05-14
 
 ### Changed — §164 re-harvest 230 chunks against §163-fixed transpiler; +2,920 LOC restored prop fidelity (v0.5.4)

package/catalog-a2ui_0_9.json

@@ -265,6 +265,115 @@
         "version": 1
       }
     },
+    "AccordionItem": {
+      "title": "AccordionItem",
+      "description": "Child of <accordion-ui>. One collapsible section with header + body. Use inside <accordion-ui> only.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AccordionItem"
+        },
+        "open": {
+          "description": "Whether the section is expanded.",
+          "type": "boolean",
+          "default": false
+        },
+        "text": {
+          "description": "Header text — the clickable label that toggles the section.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIAccordionItem",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "accordion-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ActionItem": {
+      "title": "ActionItem",
+      "description": "Child of <action-list-ui>. One actionable row — icon + label, forwards activation to the parent action-list.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ActionItem"
+        },
+        "disabled": {
+          "description": "Disables click + keyboard activation; aria-disabled is set.",
+          "type": "boolean",
+          "default": false
+        },
+        "icon": {
+          "description": "Leading icon name (Phosphor).",
+          "type": "string"
+        },
+        "text": {
+          "description": "Action label.",
+          "type": "string"
+        },
+        "value": {
+          "description": "Identifier passed to the action-list change/activate handlers.",
+          "type": "string"
+        },
+        "variant": {
+          "description": "Visual variant (default | accent | danger).",
+          "type": "string",
+          "default": "default"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIActionItem",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "action-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ActionList": {
       "title": "ActionList",
       "description": "Inline list of command actions with keyboard navigation. Fires action event when an item is clicked or activated via keyboard.",
@@ -2147,7 +2256,10 @@
         "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": ""
+          "default": "",
+          "deprecated": true,
+          "deprecated_reason": "Use `text` instead. Will be removed in v0.6.0.",
+          "deprecated_since": "0.4.x"
         },
         "shape": {
           "description": "Avatar shape",
@@ -2329,6 +2441,54 @@
         "version": 1
       }
     },
+    "AvatarGroup": {
+      "title": "AvatarGroup",
+      "description": "Cluster of overlapping <avatar-ui> children. Stacks the first `max` avatars with a negative inline-start margin; if more children are present, renders a +N overflow indicator.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AvatarGroup"
+        },
+        "max": {
+          "description": "Maximum avatars to show before the +N overflow indicator.",
+          "type": "number",
+          "default": 5
+        },
+        "size": {
+          "description": "Forwards to each child <avatar-ui> (xs|sm|md|lg|xl). Empty uses the per-avatar size.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIAvatarGroup",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "avatar-group-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Badge": {
       "title": "Badge",
       "description": "Inline pill-shaped badge/tag. Text rendered via CSS attr().",
@@ -3436,7 +3596,8 @@
             "square",
             "tall"
           ],
-          "default": "std"
+          "default": "std",
+          "deprecated": true
         },
         "color": {
           "description": "Color scheme",
@@ -3467,7 +3628,8 @@
         "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": ""
+          "default": "",
+          "deprecated": true
         },
         "hideAverage": {
           "description": "When true, suppress the overlaid average line",
@@ -8993,6 +9155,57 @@
         "version": 1
       }
     },
+    "ListItem": {
+      "title": "ListItem",
+      "description": "Child of <list-ui>. One list item with optional icon + text + description, plus arbitrary slotted content (cards, rows). Use inside <list-ui> only.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "description": {
+          "description": "Secondary line below the primary text. Subtle color.",
+          "type": "string"
+        },
+        "component": {
+          "const": "ListItem"
+        },
+        "icon": {
+          "description": "Optional leading icon name (Phosphor).",
+          "type": "string"
+        },
+        "text": {
+          "description": "Primary text. Renders as semibold inline body.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UIListItem",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "list-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Menu": {
       "title": "Menu",
       "description": "Dropdown action menu with roving focus and keyboard navigation. Uses Popover API.",
@@ -12235,6 +12448,11 @@
           "type": "boolean",
           "default": false
         },
+        "hint": {
+          "description": "§184 (v0.5.5, FEEDBACK-08 §7): small caption rendered beneath the select. Sets `aria-describedby` on the host so screen readers announce it as a description (distinct from `aria-label`, which comes from `label`). Does not conflict with the in-component `label`.",
+          "type": "string",
+          "default": ""
+        },
         "icon": {
           "description": "Leading icon name rendered inside the trigger",
           "type": "string",
@@ -12779,6 +12997,11 @@
           "type": "string",
           "default": ""
         },
+        "hint": {
+          "description": "§184 (v0.5.5, FEEDBACK-08 §7): small caption rendered beneath the slider track. Sets `aria-describedby` on the host so screen readers announce it as a description (distinct from `aria-label`, which comes from `label`). Does not conflict with the in-component `label`. Use for semantic clarifications a `<field-ui>` wrapper would be overkill for.",
+          "type": "string",
+          "default": ""
+        },
         "label": {
           "description": "Label text above the slider",
           "type": "string",
@@ -12809,6 +13032,11 @@
           "type": "string",
           "default": ""
         },
+        "throttle": {
+          "description": "§184 (v0.5.5, FEEDBACK-08 §4): when > 0, debounce the `input` event by this many milliseconds. Value updates + visual feedback remain immediate; only event dispatch accumulates. Pending input flushes BEFORE `change` so consumers always see input→…→input→change ordering. throttle=\"0\" (default) preserves the pre-§184 every-pointer-move-fires-input behavior. Common values: 50-100ms for palette regen / shader compile / large list reflow.",
+          "type": "number",
+          "default": 0
+        },
         "value": {
           "description": "Current slider value",
           "type": "number",
@@ -13999,6 +14227,62 @@
         "version": 1
       }
     },
+    "Tab": {
+      "title": "Tab",
+      "description": "Child of <tabs-ui>. One tab panel — the tab BUTTON is rendered by the parent from this child's text/icon. Wraps panel content as light DOM.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "Tab"
+        },
+        "disabled": {
+          "description": "Whether the tab is selectable.",
+          "type": "boolean",
+          "default": false
+        },
+        "icon": {
+          "description": "Optional leading icon name (Phosphor) for the tab button.",
+          "type": "string"
+        },
+        "text": {
+          "description": "Tab button label (rendered by parent <tabs-ui>).",
+          "type": "string"
+        },
+        "value": {
+          "description": "Stable id for the tab. Parent uses this to coordinate active state.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "navigation",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UITab",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "tab-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Table": {
       "title": "Table",
       "description": "Data table with sorting, selection, pagination, search, column resize, keyboard nav, cell types, and CSV export. CSS grid + ARIA grid roles.",
@@ -15563,6 +15847,80 @@
         "version": 1
       }
     },
+    "TimelineItem": {
+      "title": "TimelineItem",
+      "description": "Child of <timeline-ui>. One step in a sequenced reasoning/process timeline. Used heavily by <agent-reasoning-ui> + <agent-trace-ui>.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "description": {
+          "description": "Subtitle below the label.",
+          "type": "string"
+        },
+        "component": {
+          "const": "TimelineItem"
+        },
+        "duration": {
+          "description": "Elapsed time (e.g. \"1.2s\", \"340ms\").",
+          "type": "string"
+        },
+        "icon": {
+          "description": "Optional leading icon name (Phosphor).",
+          "type": "string"
+        },
+        "spinner": {
+          "description": "Show a spinner instead of the icon while status=pending.",
+          "type": "boolean",
+          "default": false
+        },
+        "status": {
+          "description": "Lifecycle state (idle | pending | done | failed).",
+          "type": "string",
+          "default": "idle"
+        },
+        "text": {
+          "description": "Primary step label.",
+          "type": "string"
+        },
+        "time": {
+          "description": "Absolute timestamp (HH:MM or ISO).",
+          "type": "string"
+        },
+        "variant": {
+          "description": "Visual variant (default | accent | success | warning | danger).",
+          "type": "string",
+          "default": "default"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UITimelineItem",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "timeline-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Toast": {
       "title": "Toast",
       "description": "Notification popup with auto-dismiss. Animated enter/exit.",
@@ -16435,6 +16793,21 @@
           "--tree-actions-gap": {
             "description": "Gap between action icons"
           },
+          "--tree-badge-bg": {
+            "description": "Background color for the trailing badge (§184)."
+          },
+          "--tree-badge-fg": {
+            "description": "Foreground color for the trailing badge (§184)."
+          },
+          "--tree-badge-px": {
+            "description": "Inline padding for the trailing badge (§184)."
+          },
+          "--tree-badge-radius": {
+            "description": "Border radius for the trailing badge (§184)."
+          },
+          "--tree-badge-size": {
+            "description": "Font size for the trailing badge (§184)."
+          },
           "--tree-bg-hover": {
             "description": "Background color on hover"
           },
@@ -16485,6 +16858,69 @@
         "version": 1
       }
     },
+    "TreeItem": {
+      "title": "TreeItem",
+      "description": "Child of <tree-ui>. One tree row with optional icon + text + trailing badge, plus nested tree-item-ui children for the collapsible hierarchy. Use inside <tree-ui> only.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "badge": {
+          "description": "Optional trailing badge text (count, label, etc.). Renders muted + small + right-aligned alongside the row, mirroring the nav-item-ui badge API. When empty, the badge slot stays empty.\n\nAdded in §184 (v0.5.5, FEEDBACK-08 §1).",
+          "type": "string"
+        },
+        "component": {
+          "const": "TreeItem"
+        },
+        "icon": {
+          "description": "Optional leading icon name (Phosphor).",
+          "type": "string"
+        },
+        "open": {
+          "description": "When true, the item's children render expanded. Single-instance state; the parent `<tree-ui>` toggles this on click + Enter/Space + ArrowRight/ArrowLeft per tree-view APG.",
+          "type": "boolean"
+        },
+        "selected": {
+          "description": "Reflects the currently-selected item. Exactly one tree-item is selected per `<tree-ui>` parent (managed by the parent).",
+          "type": "boolean"
+        },
+        "text": {
+          "description": "Primary text rendered in the row.",
+          "type": "string"
+        },
+        "value": {
+          "description": "Stable value emitted in `tree-select` event detail.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "data",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [],
+        "name": "UITreeItem",
+        "related": [],
+        "slots": {},
+        "states": [],
+        "synonyms": {},
+        "tag": "tree-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Upload": {
       "title": "Upload",
       "description": "File upload with drag-and-drop. Uses showOpenFilePicker with input[type=file] fallback. Form-associated.",