@adia-ai/a2ui-corpus 0.3.3 → 0.3.5

package/catalog-a2ui_0_9.json

@@ -317,6 +317,725 @@
         "version": 1
       }
     },
+    "AdminCommand": {
+      "title": "AdminCommand",
+      "description": "Module-tier command palette wrapper — wraps a native <dialog> and the\ninner <command-ui>. Owns the keyboard shortcut listener, focus\nmanagement, and dismiss handlers. Reflects [open].\n\nSits inside <admin-shell> as a direct child. The host wires\n[data-command-trigger] elements to <admin-command>.show() via lookup.\n\nThis is the bespoke web-component replacement for the legacy\n<dialog data-command> shape. <admin-shell> still recognizes the\nlegacy shape via :is() selector. New code should prefer <admin-command>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminCommand"
+        },
+        "no-shortcut": {
+          "description": "Opts out of the keyboard listener entirely. Use when the host\nwires its own shortcut handling, or when the palette should be\nmouse-only.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "open": {
+          "description": "Reflected — set while the dialog is showing. Synced with both\nprogrammatic .show()/.hide() and native dialog close events\n(esc key, backdrop click).\n",
+          "type": "boolean",
+          "default": false
+        },
+        "shortcut": {
+          "description": "Keyboard shortcut binding. \"cmd+k\" responds only on Mac\n(metaKey); \"ctrl+k\" responds only when ctrlKey; \"both\" (default)\nresponds to either, which is the canonical AdiaUI behavior for\ncross-platform Cmd+K affordance.\n",
+          "type": "string",
+          "enum": [
+            "both",
+            "cmd+k",
+            "ctrl+k"
+          ],
+          "default": "both"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "interaction",
+        "events": {
+          "command-select": {
+            "description": "Forwarded from the inner <command-ui> when an option is chosen. Detail mirrors the inner event's detail.",
+            "detail": {
+              "value": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "admin-command",
+          "command-palette",
+          "palette",
+          "cmd-k",
+          "keyboard-shortcut",
+          "quickaction"
+        ],
+        "name": "AdminCommand",
+        "related": [
+          "AdminShell",
+          "AdminSidebar",
+          "Command"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default slot — the inner <command-ui> (and any other content inside the dialog). Authors typically place exactly one <command-ui placeholder=\"…\">."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, palette closed.",
+            "name": "idle"
+          },
+          {
+            "description": "Dialog is showing; first input has focus.",
+            "attribute": "open",
+            "name": "open"
+          }
+        ],
+        "synonyms": {
+          "cmd-k": [
+            "ctrl-k",
+            "command-shortcut"
+          ],
+          "command-palette": [
+            "palette",
+            "quick-action",
+            "omnibox"
+          ]
+        },
+        "tag": "admin-command",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminContent": {
+      "title": "AdminContent",
+      "description": "Module-tier shell main-column container. CSS-only — no behavior, no\nJS. Sits inside <admin-shell> as the center column between leading\nand trailing sidebars. Authors compose chrome bars + scroll surface\nvia slot vocabulary.\n\nThis is the bespoke replacement for the legacy raw <main> element\ninside admin-shell. Both shapes still render correctly per ADR-0023\nPhase 1 backwards-compat; new code should prefer <admin-content>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminContent"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-content",
+          "main",
+          "center-column",
+          "workspace"
+        ],
+        "name": "AdminContent",
+        "related": [
+          "AdminShell",
+          "AdminSidebar",
+          "AdminTopbar",
+          "AdminStatusbar",
+          "AdminScroll",
+          "AdminPage"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default content — typically <admin-topbar slot=\"header\">, an <admin-scroll> wrapping content, and an optional <admin-statusbar slot=\"footer\">."
+          },
+          "footer": {
+            "description": "Bottom chrome bar — typically <admin-statusbar>."
+          },
+          "header": {
+            "description": "Top chrome bar — typically <admin-topbar>."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "main": [
+            "content",
+            "center",
+            "workspace"
+          ]
+        },
+        "tag": "admin-content",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminPage": {
+      "title": "AdminPage",
+      "description": "Module-tier page wrapper. CSS-only — no behavior, no JS. Provides\nthe page-content-root container query (named `page-content`) so\ndescendants can adapt to available content width (sidebars expanded\nvs collapsed) instead of viewport width. Stamps the sticky-band\nlayout: <admin-page-header> + <admin-page-body> + optional footer.\n\nReplaces the legacy <article data-content-root> shape per ADR-0023.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminPage"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-page",
+          "page-content",
+          "container-query-host"
+        ],
+        "name": "AdminPage",
+        "related": [
+          "AdminShell",
+          "AdminContent",
+          "AdminScroll",
+          "AdminPageHeader",
+          "AdminPageBody"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — typically <admin-page-header> + <admin-page-body>."
+          },
+          "body": {
+            "description": "Centered reading column (alternate slot for the body band)."
+          },
+          "footer": {
+            "description": "Sticky bottom band."
+          },
+          "header": {
+            "description": "Sticky top band (alternate slot for the header band)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "page-content": [
+            "content-area",
+            "content-root",
+            "document-region"
+          ]
+        },
+        "tag": "admin-page",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminPageBody": {
+      "title": "AdminPageBody",
+      "description": "Module-tier page-body band. CSS-only — no behavior, no JS.\nScrollable centered body inside <admin-page>. Owns full-width\nscroll sizing; wraps an inner <section-ui> or raw <section> for\nthe centered reading column.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminPageBody"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-page-body",
+          "page-body",
+          "centered-body"
+        ],
+        "name": "AdminPageBody",
+        "related": [
+          "AdminPage",
+          "AdminPageHeader",
+          "Section"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — typically <section-ui> or <section> with the page content. Full-bleed content (iframes, split panes) can sit directly here to opt out of the centered column."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "page-body": [
+            "content-body",
+            "document-body"
+          ]
+        },
+        "tag": "admin-page-body",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminPageHeader": {
+      "title": "AdminPageHeader",
+      "description": "Module-tier page-header band. CSS-only — no behavior, no JS.\nSticky top band inside <admin-page>. Owns full-width concerns\n(sticky position, border-bottom, background); wraps an inner\n<header-ui> or raw <header> for the centered reading column\n(max-width, gutter, rhythm).\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminPageHeader"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-page-header",
+          "sticky-header",
+          "page-band"
+        ],
+        "name": "AdminPageHeader",
+        "related": [
+          "AdminPage",
+          "AdminPageBody",
+          "Header"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — typically <header-ui> or <header> with title + actions."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "sticky-header": [
+            "page-titlebar",
+            "top-band"
+          ]
+        },
+        "tag": "admin-page-header",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminScroll": {
+      "title": "AdminScroll",
+      "description": "Module-tier shell scroll surface. CSS-only — no behavior, no JS.\nSits inside <admin-content> as the central scrollable region.\nSingle-axis scroll (vertical), scroll-contained so wheel/touch\nevents don't propagate to the document.\n\nReplaces the legacy <section> child of <main> at shell-tier per\nADR-0023.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminScroll"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-scroll",
+          "scroll-region",
+          "scroll-container"
+        ],
+        "name": "AdminScroll",
+        "related": [
+          "AdminShell",
+          "AdminContent",
+          "AdminPage"
+        ],
+        "slots": {
+          "default": {
+            "description": "Scrollable content — typically <admin-page> wrapping the page-tier sticky bands + body."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "scroll-region": [
+            "scroll-area",
+            "viewport-content"
+          ]
+        },
+        "tag": "admin-scroll",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminSidebar": {
+      "title": "AdminSidebar",
+      "description": "Module-tier shell sidebar — owns resize, snap-to-collapsed, persistence,\nand the [collapsed] reflected attribute. Sits inside <admin-shell> as\nslot=\"leading\" or slot=\"trailing\". Authors compose chrome bars + content\ninside via slot vocabulary.\n\nThis is the bespoke web-component replacement for the legacy\n<aside data-sidebar> shape. <admin-shell> still recognizes the legacy\nshape via :is() selector for backwards compat. New code should prefer\n<admin-sidebar>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "collapsed": {
+          "description": "Reflected — set when the sidebar's measured width is at or below\n96px. Consumers query this to style \"collapsed mode\" without\nduplicating threshold math.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "collapsible": {
+          "description": "Opts in to programmatic collapse — toggle button wiring + the\n.toggle() / .collapse() / .expand() public methods.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "component": {
+          "const": "AdminSidebar"
+        },
+        "min-width": {
+          "description": "Optional override for the snap-floor width. Defaults to reading\nCSS min-width via getComputedStyle.\n",
+          "type": "string",
+          "default": ""
+        },
+        "name": {
+          "description": "Identifier for localStorage namespacing. Defaults to slot value\n(\"leading\" or \"trailing\"). Override when running multiple sidebars\nwith the same slot.\n",
+          "type": "string",
+          "default": ""
+        },
+        "resizable": {
+          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-resize] element as the drag handle.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "resizing": {
+          "description": "Reflected — set during an active pointer-drag on the resize handle.\nUseful for suppressing transitions while dragging.\n",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {
+          "sidebar-resize": {
+            "description": "Bubbles when an active pointer-drag releases.",
+            "detail": {
+              "name": "string",
+              "width": "number"
+            }
+          },
+          "sidebar-toggle": {
+            "description": "Bubbles when sidebar collapses or expands.",
+            "detail": {
+              "expanded": "boolean",
+              "name": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "admin-sidebar",
+          "sidebar",
+          "aside",
+          "rail",
+          "panel",
+          "leading",
+          "trailing",
+          "inspector",
+          "nav"
+        ],
+        "name": "AdminSidebar",
+        "related": [
+          "AdminShell",
+          "AdminCommand",
+          "Aside",
+          "Nav",
+          "NavGroup",
+          "NavItem"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default content — typically a <nav-ui> for navigation, or a list / tree for the trailing inspector pattern."
+          },
+          "footer": {
+            "description": "Bottom chrome bar (user select, status indicator, etc.)."
+          },
+          "header": {
+            "description": "Top chrome bar (workspace select, breadcrumb, etc.)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, expanded.",
+            "name": "idle"
+          },
+          {
+            "description": "Sidebar width is at or below the snap threshold; CSS container queries flip child layout to icon-only mode.",
+            "attribute": "collapsed",
+            "name": "collapsed"
+          },
+          {
+            "description": "Active pointer-drag in progress.",
+            "attribute": "resizing",
+            "name": "resizing"
+          }
+        ],
+        "synonyms": {
+          "collapsed": [
+            "minimized",
+            "narrow",
+            "icon-only"
+          ],
+          "sidebar": [
+            "aside",
+            "rail",
+            "panel"
+          ]
+        },
+        "tag": "admin-sidebar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminStatusbar": {
+      "title": "AdminStatusbar",
+      "description": "Module-tier shell bottom chrome bar. CSS-only — no behavior, no JS.\nSame shape as <admin-topbar> (icon + heading + description + action\nclusters via slot vocabulary), conventionally used for read-only\nstatus — connection state, sync indicator, footer metadata.\n\nReplaces legacy <footer-ui> usage at shell-tier. Both still work per\nADR-0023 backwards-compat.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminStatusbar"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-statusbar",
+          "statusbar",
+          "footer-bar",
+          "app-footer",
+          "status-line"
+        ],
+        "name": "AdminStatusbar",
+        "related": [
+          "AdminShell",
+          "AdminContent",
+          "AdminTopbar",
+          "Footer"
+        ],
+        "slots": {
+          "description": {
+            "description": "Secondary metadata."
+          },
+          "default": {
+            "description": "Default content — status text or inline children."
+          },
+          "action": {
+            "description": "Trailing control cluster."
+          },
+          "action-leading": {
+            "description": "Leading control cluster."
+          },
+          "heading": {
+            "description": "Primary label."
+          },
+          "icon": {
+            "description": "Leading glyph (icon-ui or img)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "statusbar": [
+            "status-line",
+            "footer-bar",
+            "app-footer"
+          ]
+        },
+        "tag": "admin-statusbar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "AdminTopbar": {
+      "title": "AdminTopbar",
+      "description": "Module-tier shell top chrome bar. CSS-only — no behavior, no JS.\nSits at the top of <admin-content>, <admin-sidebar>, or any chrome\nregion. Provides the canonical icon + heading + description +\naction-clusters layout via slot vocabulary.\n\nReplaces the legacy <header-ui> usage at shell-tier. Both still work\nper ADR-0023 backwards-compat; new code should prefer <admin-topbar>\nfor shell-tier chrome bars (use <header-ui> for primitive containers\nlike Card / Drawer / Modal).\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminTopbar"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-topbar",
+          "topbar",
+          "chrome-bar",
+          "app-header",
+          "shell-header"
+        ],
+        "name": "AdminTopbar",
+        "related": [
+          "AdminShell",
+          "AdminContent",
+          "AdminSidebar",
+          "AdminStatusbar",
+          "Header"
+        ],
+        "slots": {
+          "description": {
+            "description": "Secondary metadata. Muted + smaller font."
+          },
+          "default": {
+            "description": "Default content — typically a breadcrumb, page title, or ad-hoc inline children. Use named slots for canonical clusters."
+          },
+          "action": {
+            "description": "Trailing control cluster (buttons, menus, etc.). The first [slot=\"action\"] child pushes itself + siblings to the end; subsequent siblings flow with gap."
+          },
+          "action-leading": {
+            "description": "Leading control cluster (back button, menu trigger, etc.). Pairs with [slot=\"action\"] for dual-cluster chrome."
+          },
+          "heading": {
+            "description": "Primary label. Medium-weight + strong fg."
+          },
+          "icon": {
+            "description": "Leading glyph (icon-ui or img). Muted color, flex-aligned."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "topbar": [
+            "appbar",
+            "app-header",
+            "header-bar",
+            "navbar"
+          ]
+        },
+        "tag": "admin-topbar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "AgentArtifact": {
       "title": "AgentArtifact",
       "description": "Inline container for structured agent artifacts (A2UI, JSON, tickets).",
@@ -1166,16 +1885,6 @@
           {
             "description": "Default, interactive shell.",
             "name": "idle"
-          },
-          {
-            "description": "Leading sidebar is collapsed; content expands.",
-            "attribute": "data-sidebar-leading-collapsed",
-            "name": "collapsed-leading"
-          },
-          {
-            "description": "Trailing sidebar (inspector) is collapsed.",
-            "attribute": "data-sidebar-trailing-collapsed",
-            "name": "collapsed-trailing"
           }
         ],
         "synonyms": {
@@ -2943,41 +3652,274 @@
           "graph",
           "visualization"
         ],
-        "name": "UIChartLegend",
+        "name": "UIChartLegend",
+        "related": [
+          "chart",
+          "badge",
+          "heatmap"
+        ],
+        "slots": {
+          "default": {
+            "description": "Normally empty — the primitive renders its own rows. Authors who want fully custom markup can provide their own children with [data-row] and [data-key] attributes; the primitive won't wipe them if [items] is empty and [for] is unset."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "Rows are <button>s. Default unless [static].",
+            "name": "interactive"
+          },
+          {
+            "description": "Rows are <span>s. No click handler, no toggle affordance.",
+            "name": "static"
+          }
+        ],
+        "synonyms": {
+          "chart": [
+            "chart-legend",
+            "legend"
+          ],
+          "legend": [
+            "chart-legend"
+          ]
+        },
+        "tag": "chart-legend-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ChatComposer": {
+      "title": "ChatComposer",
+      "description": "Module-tier chat composer wrapper — replaces legacy <chat-input-ui\ndata-chat-input> direct child of <chat-shell> per ADR-0023.\nForwards submit events as 'composer-submit', propagates [disabled]\nto the inner input, provides slot vocabulary for future composer\nsurfaces (file attach, autocomplete, model picker).\n\nSits inside <chat-shell> as the input region (typically inside or\nalongside the footer). Authors place an inner <chat-input-ui>\n(or input-ui / textarea-ui) as the primary input.\n\nBackwards compat — <chat-shell> still recognizes the legacy\n<chat-input-ui data-chat-input> shape via :is() selector. New\ncode should prefer <chat-composer>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatComposer"
+        },
+        "disabled": {
+          "description": "Reflected — set by the host while streaming, or by application\ncode. Propagated to the inner input element automatically.\n",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "input",
+        "events": {
+          "composer-submit": {
+            "description": "Bubbles when the inner input fires its 'submit' event. Detail mirrors the inner event's detail (typically text + model).",
+            "detail": {
+              "model": "string",
+              "text": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "chat-composer",
+          "chat-input",
+          "composer",
+          "message-input",
+          "conversation-input"
+        ],
+        "name": "ChatComposer",
+        "related": [
+          "ChatShell",
+          "ChatThread",
+          "ChatInput",
+          "Input",
+          "Textarea"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — primary input child (typically <chat-input-ui> or <input-ui submit-on-enter>)."
+          },
+          "attach": {
+            "description": "Future — attachment trigger button (paperclip icon to upload)."
+          },
+          "leading": {
+            "description": "Leading controls — autocomplete trigger, voice input, etc."
+          },
+          "trailing": {
+            "description": "Trailing controls — model picker, send button override, etc."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, accepting input.",
+            "name": "idle"
+          },
+          {
+            "description": "Input is disabled (typically during LLM streaming).",
+            "attribute": "disabled",
+            "name": "disabled"
+          }
+        ],
+        "synonyms": {
+          "composer": [
+            "message-input",
+            "chat-input",
+            "conversation-input"
+          ]
+        },
+        "tag": "chat-composer",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ChatEmpty": {
+      "title": "ChatEmpty",
+      "description": "Module-tier chat empty state. CSS-only — no behavior, no JS. Sits\nas the first child of <chat-thread> as the empty state placeholder.\nVisibility is driven by <chat-thread>'s [empty] reflected attribute\nvia CSS (no JS toggling needed) — when messages arrive, the parent\nthread loses [empty] and CSS hides this stub.\n\nReplaces the legacy <empty-state-ui data-chat-empty> child of the\nmessages container per ADR-0023. Both shapes still work via\nbackwards compat; new code should prefer <chat-empty>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatEmpty"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "chat-empty",
+          "empty-state",
+          "placeholder",
+          "no-messages"
+        ],
+        "name": "ChatEmpty",
+        "related": [
+          "ChatShell",
+          "ChatThread",
+          "EmptyState"
+        ],
+        "slots": {
+          "default": {
+            "description": "Empty state content — typically an icon + heading + description. Authors compose with <empty-state-ui> as a child, or supply inline content directly."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, visible.",
+            "name": "idle"
+          },
+          {
+            "description": "Hidden via parent <chat-thread>:not([empty]) selector.",
+            "name": "hidden"
+          }
+        ],
+        "synonyms": {
+          "chat-empty": [
+            "empty-state",
+            "placeholder",
+            "no-conversations"
+          ]
+        },
+        "tag": "chat-empty",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ChatHeader": {
+      "title": "ChatHeader",
+      "description": "Module-tier chat header chrome bar. CSS-only — no behavior, no JS.\nSits at the top of <chat-shell> or inside a <chat-sidebar>. Holds\nthe chat name, status indicator, and action clusters via slot\nvocabulary.\n\nReplaces the legacy <header> with [data-chat-name] / [data-chat-status]\ndata-attribute children. Both shapes still work per ADR-0023 backwards\ncompat; new code should prefer <chat-header> with <chat-status> as\na slotted child.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatHeader"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "chat-header",
+          "chat-titlebar",
+          "chrome-bar",
+          "app-header"
+        ],
+        "name": "ChatHeader",
         "related": [
-          "chart",
-          "badge",
-          "heatmap"
+          "ChatShell",
+          "ChatStatus",
+          "ChatThread",
+          "ChatComposer"
         ],
         "slots": {
           "default": {
-            "description": "Normally empty — the primitive renders its own rows. Authors who want fully custom markup can provide their own children with [data-row] and [data-key] attributes; the primitive won't wipe them if [items] is empty and [for] is unset."
+            "description": "Default — typically [slot=\"name\"] + [slot=\"status\"] children, or ad-hoc inline content."
+          },
+          "action": {
+            "description": "Trailing control cluster (settings, share, clear conversation)."
+          },
+          "action-leading": {
+            "description": "Leading control cluster (back button, conversation switcher)."
+          },
+          "name": {
+            "description": "Primary chat label (model name, conversation title, etc.)."
+          },
+          "status": {
+            "description": "Status indicator — typically <chat-status> showing connection / streaming state."
           }
         },
         "states": [
           {
-            "description": "Default, ready for interaction.",
+            "description": "Default, the only state.",
             "name": "idle"
-          },
-          {
-            "description": "Rows are <button>s. Default unless [static].",
-            "name": "interactive"
-          },
-          {
-            "description": "Rows are <span>s. No click handler, no toggle affordance.",
-            "name": "static"
           }
         ],
         "synonyms": {
-          "chart": [
-            "chart-legend",
-            "legend"
-          ],
-          "legend": [
-            "chart-legend"
+          "chat-header": [
+            "titlebar",
+            "app-header",
+            "navbar"
           ]
         },
-        "tag": "chart-legend-ui",
+        "tag": "chat-header",
         "tokens": {},
         "traits": [],
         "version": 1
@@ -3130,9 +4072,9 @@
         "version": 1
       }
     },
-    "ChatThread": {
-      "title": "ChatThread",
-      "description": "Minimal chat-thread container.",
+    "ChatSidebar": {
+      "title": "ChatSidebar",
+      "description": "Module-tier chat-cluster sidebar — owns resize, snap-to-collapsed,\npersistence, and the [collapsed] reflected attribute. Sits inside\n<chat-shell> as slot=\"leading\" (conversation history rail) or\nslot=\"trailing\" (artifacts/citations panel). Mirrors the admin-sidebar\nshape — same 4 concerns, cluster-namespaced for the chat family.\n\nThis is the chat-cluster equivalent of <admin-sidebar> per ADR-0023.\n<chat-shell> doesn't currently have a legacy sidebar shape (chat is\ntypically a single-pane experience), so <chat-sidebar> is purely\nforward-looking — for chat apps that want conversation-history or\ninspector rails.\n",
       "type": "object",
       "allOf": [
         {
@@ -3143,11 +4085,36 @@
         }
       ],
       "properties": {
+        "collapsed": {
+          "description": "Reflected — set when the sidebar's measured width is at or below\n96px. Consumers query this to style \"collapsed mode\" without\nduplicating threshold math.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "collapsible": {
+          "description": "Opts in to programmatic collapse — toggle button wiring + the\n.toggle() / .collapse() / .expand() public methods.\n",
+          "type": "boolean",
+          "default": false
+        },
         "component": {
-          "const": "ChatThread"
+          "const": "ChatSidebar"
         },
-        "streaming": {
-          "description": "Component property: streaming.",
+        "min-width": {
+          "description": "Optional override for the snap-floor width. Defaults to reading\nCSS min-width via getComputedStyle.\n",
+          "type": "string",
+          "default": ""
+        },
+        "name": {
+          "description": "Identifier for localStorage namespacing. Defaults to slot value\n(\"leading\" or \"trailing\"). Override when running multiple sidebars\nwith the same slot.\n",
+          "type": "string",
+          "default": ""
+        },
+        "resizable": {
+          "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-resize] element as the drag handle.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "resizing": {
+          "description": "Reflected — set during an active pointer-drag on the resize handle.\nUseful for suppressing transitions while dragging.\n",
           "type": "boolean",
           "default": false
         }
@@ -3158,152 +4125,232 @@
       "unevaluatedProperties": false,
       "x-adiaui": {
         "anti_patterns": [],
-        "category": "agent",
+        "category": "layout",
         "events": {
-          "submit": {
-            "description": "Fired when the user submits a chat message via Enter or send button. Detail: { text, model }."
+          "sidebar-resize": {
+            "description": "Bubbles when an active pointer-drag releases.",
+            "detail": {
+              "name": "string",
+              "width": "number"
+            }
+          },
+          "sidebar-toggle": {
+            "description": "Bubbles when sidebar collapses or expands.",
+            "detail": {
+              "expanded": "boolean",
+              "name": "string"
+            }
           }
         },
-        "examples": [
-          {
-            "description": "Basic Chat usage",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"Chat\"\n  }\n]",
-            "name": "basic-chat"
+        "examples": [],
+        "keywords": [
+          "chat-sidebar",
+          "chat-sidebar",
+          "conversation-history",
+          "chat-rail",
+          "sidebar",
+          "leading",
+          "trailing",
+          "inspector"
+        ],
+        "name": "ChatSidebar",
+        "related": [
+          "ChatShell",
+          "ChatComposer",
+          "ChatHeader",
+          "List",
+          "Nav"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default content — typically a <nav-ui> for navigation, or a list / tree for the trailing inspector pattern."
+          },
+          "footer": {
+            "description": "Bottom chrome bar (user select, status indicator, etc.)."
           },
+          "header": {
+            "description": "Top chrome bar (workspace select, breadcrumb, etc.)."
+          }
+        },
+        "states": [
           {
-            "description": "Chat transcript with user and assistant messages; role attribute styles turns.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Chat\",\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"role\": \"user\",\n    \"textContent\": \"What's the capital of France?\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"role\": \"assistant\",\n    \"textContent\": \"The capital of France is Paris.\"\n  }\n]",
-            "name": "basic"
+            "description": "Default, expanded.",
+            "name": "idle"
           },
           {
-            "description": "Chat with streaming cursor on an in-progress assistant message.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Chat\",\n    \"streaming\": true,\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"role\": \"user\",\n    \"textContent\": \"Explain black holes briefly.\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"role\": \"assistant\",\n    \"streaming\": true,\n    \"textContent\": \"A black hole is a region of spacetime where gravity is so strong that\"\n  }\n]",
-            "name": "streaming"
+            "description": "Sidebar width is at or below the snap threshold; CSS container queries flip child layout to icon-only mode.",
+            "attribute": "collapsed",
+            "name": "collapsed"
           },
           {
-            "description": "Chat transcript composed with ChatInput for a full conversation surface.",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Column\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"chat\",\n      \"input\"\n    ]\n  },\n  {\n    \"id\": \"chat\",\n    \"component\": \"Chat\",\n    \"children\": [\n      \"m1\",\n      \"m2\"\n    ]\n  },\n  {\n    \"id\": \"m1\",\n    \"component\": \"Text\",\n    \"role\": \"user\",\n    \"textContent\": \"Give me a short haiku about the ocean.\"\n  },\n  {\n    \"id\": \"m2\",\n    \"component\": \"Text\",\n    \"role\": \"assistant\",\n    \"textContent\": \"Waves whisper secrets — the tide retreats then returns, carrying the moon.\"\n  },\n  {\n    \"id\": \"input\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Type a message...\"\n  }\n]",
-            "name": "with-input"
+            "description": "Active pointer-drag in progress.",
+            "attribute": "resizing",
+            "name": "resizing"
           }
         ],
+        "synonyms": {
+          "collapsed": [
+            "minimized",
+            "narrow",
+            "icon-only"
+          ],
+          "sidebar": [
+            "aside",
+            "rail",
+            "panel"
+          ]
+        },
+        "tag": "chat-sidebar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ChatStatus": {
+      "title": "ChatStatus",
+      "description": "Module-tier chat status indicator. CSS-only — no behavior, no JS.\nConveys connection / streaming state via inline content. Typically\nslotted into <chat-header slot=\"status\"> or used inline.\n\nReplaces the legacy <span data-chat-status> shape per ADR-0023.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatStatus"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "events": {},
+        "examples": [],
         "keywords": [
-          "chat",
-          "message",
-          "messaging",
-          "sms",
-          "chatbot",
+          "chat-status",
+          "status-indicator",
+          "connection-status",
+          "streaming-indicator"
+        ],
+        "name": "ChatStatus",
+        "related": [
+          "ChatShell",
+          "ChatHeader",
+          "ChatThread"
+        ],
+        "slots": {
+          "default": {
+            "description": "Status content — text, icon, dot indicator, etc. Authors set content directly; the host (chat-shell) updates innerText during streaming via legacy [data-chat-status] selector OR via querySelector('chat-status') for the bespoke shape."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "chat-status": [
+            "connection-indicator",
+            "streaming-status"
+          ]
+        },
+        "tag": "chat-status",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "ChatThread": {
+      "title": "ChatThread",
+      "description": "Module-tier chat message thread container — replaces legacy\n<section data-chat-messages> per ADR-0023. Owns scroll-to-bottom\non new message (with user-scroll-up suspension), [streaming] and\n[empty] reflected attributes, and a stable target for the host's\nmessage rendering pipeline.\n\nSits inside <chat-shell> as the central scroll surface. Authors\ncompose <chat-empty> as an optional first child for the empty\nstate; message children are appended dynamically by the host.\n\nBackwards compat — <chat-shell> still recognizes the legacy\n<section data-chat-messages> shape via :is() selector. New code\nshould prefer <chat-thread>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatThread"
+        },
+        "empty": {
+          "description": "Reflected — set when zero message children. Drives the\n<chat-empty> visibility via CSS — no JS toggling needed.\n",
+          "type": "boolean",
+          "default": true
+        },
+        "streaming": {
+          "description": "Reflected — set by the host while an LLM response is streaming.\nConsumers can style streaming-mode (e.g. cursor blink) via\n:has(chat-thread[streaming]) or attribute selectors.\n",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "container",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "chat-thread",
+          "message-list",
           "conversation",
-          "ai-chat",
-          "messenger",
-          "assistant",
-          "copilot",
-          "gpt",
-          "llm",
-          "ai",
-          "bot",
-          "prompt",
-          "comment",
-          "support"
+          "thread",
+          "scroll-surface"
+        ],
+        "name": "ChatThread",
+        "related": [
+          "ChatShell",
+          "ChatEmpty",
+          "ChatComposer",
+          "ChatSidebar"
         ],
-        "name": "UIChatThread",
-        "related": [],
         "slots": {
           "default": {
-            "description": "Default slot — primary child content."
+            "description": "Default — message children (typically appended dynamically by <chat-shell>'s rendering pipeline) plus an optional first <chat-empty> sibling for the empty state."
           }
         },
         "states": [
           {
-            "description": "Default, ready for interaction.",
+            "description": "Default, no streaming.",
             "name": "idle"
+          },
+          {
+            "description": "Host is actively streaming an LLM response.",
+            "attribute": "streaming",
+            "name": "streaming"
+          },
+          {
+            "description": "Zero message children — empty state visible.",
+            "attribute": "empty",
+            "name": "empty"
           }
         ],
         "synonyms": {
-          "ai": [
-            "chat",
-            "streaming",
-            "response",
-            "command"
-          ],
-          "ai-chat": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "assistant": [
-            "chat",
-            "streaming",
-            "response",
-            "command"
-          ],
-          "bot": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "chatbot": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "comment": [
-            "social",
-            "post",
-            "chat"
-          ],
-          "conversation": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "copilot": [
-            "chat",
-            "streaming",
-            "response",
-            "command"
-          ],
-          "gpt": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "llm": [
-            "chat",
-            "streaming",
-            "response"
-          ],
-          "message": [
-            "chat",
-            "notification",
-            "toast",
-            "alert"
-          ],
-          "messaging": [
-            "chat",
-            "notification",
-            "streaming"
-          ],
-          "messenger": [
-            "chat",
-            "streaming"
-          ],
-          "prompt": [
-            "chat",
-            "streaming",
-            "command",
-            "palette"
-          ],
-          "sms": [
-            "chat",
-            "notification"
+          "message-list": [
+            "messages",
+            "message-stream"
           ],
-          "support": [
-            "faq",
-            "accordion",
-            "chat"
+          "thread": [
+            "conversation",
+            "dialogue",
+            "chat-log",
+            "transcript"
           ]
         },
-        "tag": "chat-thread-ui",
+        "tag": "chat-thread",
         "tokens": {},
         "traits": [],
         "version": 1