@adia-ai/a2ui-corpus 0.5.3 → 0.5.5

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",
@@ -4118,6 +4280,162 @@
         "version": 1
       }
     },
+    "ChatInput": {
+      "title": "ChatInput",
+      "description": "Composable chat input bar — a self-contained chat-message composer\nthat stamps its OWN inner structure (textarea + model picker + send\nbutton) when authored as a bare `<chat-input-ui>` tag.\n\nIMPORTANT (closes the 2026-05-14 redundant-send-button class): the\ncomponent stamps a built-in send button (paper-plane-right icon,\nprimary variant). DO NOT add a separate Button sibling for \"send\" —\nthe user gets two send buttons. The submit event fires on Enter or\nsend-button click; `detail` is `{ text, model }`.\n\nInner stamped structure (default):\n  <chat-input-ui>\n    <textarea-ui placeholder=\"Type a message...\" rows=\"1\"></textarea-ui>\n    <div slot=\"toolbar\">\n      <select-ui slot=\"model\" placeholder=\"Model\">...</select-ui>\n      <button-ui icon=\"paper-plane-right\" variant=\"primary\" slot=\"send\"></button-ui>\n    </div>\n  </chat-input-ui>\n\nLayout:\n  ┌──────────────────────────────────┐\n  │  textarea (grows vertically)     │\n  ├──────────────────────────────────┤\n  │  [model ▾]           [⏎ send]   │  ← toolbar (model picker + built-in send)\n  └──────────────────────────────────┘\n\nComposite wrapper, not a form field itself. The inner textarea-ui\nis form-associated via UIFormElement and submits through the parent\nform. `chat-input-ui`'s `disabled` / `placeholder` props propagate\nto the inner textarea.\n\nFor module-tier composer surfaces (slot vocabulary for file attach,\nautocomplete, trailing/leading controls), wrap inside\n`<chat-composer>` — see ChatComposer for the module-tier shape.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatInput"
+        },
+        "disabled": {
+          "description": "Disable the entire input. Textarea becomes contenteditable=false;\nsend button disabled.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "loading": {
+          "description": "In-flight / streaming state. Send button disabled, submit events\nsuppressed, but textarea stays editable so the user can draft a\nfollow-up while the model is still responding.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "model": {
+          "description": "Currently selected model value (reflected, two-way with inner\n`<select-ui slot=\"model\">`). Empty when no model picker is shown.\n",
+          "type": "string",
+          "default": ""
+        },
+        "models": {
+          "description": "JSON array of model options for the inner model picker —\n[{value, label}] or [{label, options: [...]}] groups. Empty array\nhides the model picker.\n",
+          "type": "array",
+          "default": []
+        },
+        "placeholder": {
+          "description": "Textarea placeholder. Defaults to \"Type a message...\".",
+          "type": "string",
+          "default": "Type a message..."
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [
+          {
+            "description": "Adding a separate Button(primary) sibling next to ChatInput for \"send\". The component stamps its own send button (paper-plane-right icon). Two send buttons render side-by-side, confusing users."
+          },
+          {
+            "description": "Stamping a Select next to ChatInput for model picker. The component has a built-in model picker driven by the `models` prop. Set `models=[{value, label}, ...]` instead of stamping a separate Select."
+          },
+          {
+            "description": "Wrapping ChatInput inside <field-ui label=\"...\"> for label association. ChatInput is a composite container, not a form field. For a labeled composer surface, use <chat-composer> + slot label markup."
+          }
+        ],
+        "category": "agent",
+        "composes": [],
+        "events": {
+          "submit": {
+            "description": "Fires when the user presses Enter (without Shift) in the textarea OR clicks the built-in send button. The composer suppresses submission while `[loading]` is set.",
+            "detail": {
+              "model": {
+                "description": "Currently selected model value (empty if no model picker).",
+                "type": "string"
+              },
+              "text": {
+                "description": "Submitted message text from the inner textarea.",
+                "type": "string"
+              }
+            }
+          }
+        },
+        "examples": [
+          {
+            "description": "Minimal chat input — placeholder, no model picker. Sits inside a chat shell footer.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"ChatInput\", \"placeholder\": \"Ask me anything...\"}\n]",
+            "name": "basic-chat-input"
+          },
+          {
+            "description": "Chat input with model selection. The `models` prop drives the built-in model picker — DO NOT add a separate Select sibling.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Type a message...\",\n    \"model\": \"claude-opus-4-7\",\n    \"models\": [\n      {\"value\": \"claude-opus-4-7\", \"label\": \"Claude Opus 4.7\"},\n      {\"value\": \"claude-haiku-4-5\", \"label\": \"Claude Haiku 4.5\"},\n      {\"value\": \"claude-sonnet-4-5\", \"label\": \"Claude Sonnet 4.5\"}\n    ]\n  }\n]",
+            "name": "chat-input-with-models"
+          },
+          {
+            "description": "Streaming response state. `[loading]` reflects on the host; send button disables; textarea stays editable so the user can draft a follow-up while the LLM is responding.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Drafting follow-up while streaming...\",\n    \"loading\": true\n  }\n]",
+            "name": "chat-input-loading-state"
+          },
+          {
+            "description": "Full chat shell — header + thread + ChatInput in the footer. Note: ChatInput is the sole footer child; no separate send button.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"ChatShell\", \"children\": [\"header\", \"thread\", \"input\"]},\n  {\"id\": \"header\", \"component\": \"ChatHeader\", \"title\": \"Chat\"},\n  {\"id\": \"thread\", \"component\": \"ChatThread\"},\n  {\"id\": \"input\", \"component\": \"ChatInput\", \"placeholder\": \"Send a message...\"}\n]",
+            "name": "chat-shell-with-chat-input"
+          }
+        ],
+        "keywords": [
+          "chat-input",
+          "chat",
+          "message-input",
+          "composer",
+          "send-message",
+          "conversation",
+          "prompt",
+          "submit"
+        ],
+        "name": "UIChatInput",
+        "related": [
+          "ChatShell",
+          "ChatThread",
+          "ChatComposer",
+          "ChatHeader",
+          "TextArea",
+          "Input"
+        ],
+        "slots": {
+          "model": {
+            "description": "Override slot for the model picker. Most authors should NOT override this — set the `models` prop instead."
+          },
+          "send": {
+            "description": "Override slot for the send button only. The default stamped send button has `[icon=\"paper-plane-right\"] [variant=\"primary\"]`. Most authors should NOT override this — the built-in send button IS the send control. Adding a separate Button sibling for \"send\" duplicates this functionality."
+          },
+          "toolbar": {
+            "description": "Override slot for the entire toolbar row (model picker + send button). Most authors should NOT override this — the built-in toolbar handles model selection + send. Use this only when custom toolbar layout is required."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, accepting input. Send button enabled when textarea has content.",
+            "name": "idle"
+          },
+          {
+            "description": "Input fully disabled (typically during initial form setup).",
+            "attribute": "disabled",
+            "name": "disabled"
+          },
+          {
+            "description": "LLM is responding. Send button disabled + submit events suppressed, but textarea stays editable for follow-up drafts.",
+            "attribute": "loading",
+            "name": "loading"
+          }
+        ],
+        "synonyms": {
+          "message-input": [
+            "conversation-input",
+            "prompt-input",
+            "send-bar"
+          ]
+        },
+        "tag": "chat-input-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ChatShell": {
       "title": "ChatShell",
       "description": "Behavior-only chat orchestrator (LLM-streaming module). Author supplies the\nDOM structure via [data-chat-messages], [data-chat-input], [data-chat-empty],\n[data-chat-status] elements; chat-shell wires message streaming, markdown\nrendering, code-block upgrades, and an LLM integration path via proxy-url\n(or via external submit).\n",
@@ -6739,21 +7057,104 @@
         "max": {
           "description": "Cap on simultaneously visible items per lane",
           "type": "number",
-          "default": 5
+          "default": 5
+        },
+        "position": {
+          "description": "Lane the feed renders into",
+          "type": "string",
+          "enum": [
+            "top-left",
+            "top-center",
+            "top-right",
+            "bottom-left",
+            "bottom-center",
+            "bottom-right",
+            "inline"
+          ],
+          "default": "bottom-right"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "container",
+        "composes": [
+          "button-ui",
+          "feed-item-ui"
+        ],
+        "events": {
+          "close": {
+            "description": "Fired on per-item dismissal (manual close, swipe, or auto-timeout). Bubbles."
+          }
+        },
+        "examples": [],
+        "keywords": [],
+        "name": "UIFeedContainer",
+        "related": [],
+        "slots": {},
+        "states": {},
+        "synonyms": {},
+        "tag": "feed-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "FeedItem": {
+      "title": "FeedItem",
+      "description": "Atomic feed entry inside a `<feed-ui>` lane. Three dismiss policies are inferred from the prop shape — auto-fade (duration > 0 + no action), sticky-dismissible (duration null/0), action-required (duration null/0 + action; future phase). Posted via `UIFeed.post()` rather than authored directly.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "FeedItem"
+        },
+        "dismissible": {
+          "description": "Render an x close button (default true for sticky, false for auto-fade)",
+          "type": "boolean",
+          "default": false
+        },
+        "duration": {
+          "description": "Auto-fade timer in ms; null/0 = sticky (requires user input)",
+          "type": "number",
+          "default": 4000
         },
-        "position": {
-          "description": "Lane the feed renders into",
+        "heading": {
+          "description": "Optional emphasis line above text",
+          "type": "string",
+          "default": ""
+        },
+        "icon": {
+          "description": "Optional leading icon name",
+          "type": "string",
+          "default": ""
+        },
+        "text": {
+          "description": "Body copy",
+          "type": "string",
+          "default": ""
+        },
+        "variant": {
+          "description": "Semantic variant",
           "type": "string",
           "enum": [
-            "top-left",
-            "top-center",
-            "top-right",
-            "bottom-left",
-            "bottom-center",
-            "bottom-right",
-            "inline"
+            "default",
+            "info",
+            "success",
+            "warning",
+            "danger"
           ],
-          "default": "bottom-right"
+          "default": "default"
         }
       },
       "required": [
@@ -6762,24 +7163,25 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "container",
-        "composes": [
-          "button-ui",
-          "feed-item-ui"
-        ],
+        "category": "feedback",
+        "composes": [],
         "events": {
           "close": {
-            "description": "Fired on per-item dismissal (manual close, swipe, or auto-timeout). Bubbles."
+            "description": "Fired after the item finishes its exit animation"
           }
         },
         "examples": [],
         "keywords": [],
-        "name": "UIFeedContainer",
+        "name": "UIFeedItem",
         "related": [],
-        "slots": {},
+        "slots": {
+          "body": {
+            "description": "Default content slot (also accepts the `text` / `heading` props)"
+          }
+        },
         "states": {},
         "synonyms": {},
-        "tag": "feed-ui",
+        "tag": "feed-item-ui",
         "tokens": {},
         "traits": [],
         "version": 1
@@ -8753,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.",
@@ -11995,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",
@@ -12539,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",
@@ -12569,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",
@@ -13759,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.",
@@ -15323,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.",
@@ -16195,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"
           },
@@ -16245,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.",