{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://adiaui.dev/a2ui/v0_9/adiaui_catalog.json", "catalogId": "https://adiaui.dev/a2ui/v0_9/adiaui_catalog.json", "title": "AdiaUI Catalog", "description": "AdiaUI component catalog. A2UI protocol v0.9. Freestanding — all common-type references are inlined into `$defs` so this document can be loaded directly into an LLM prompt with no network fetches.", "components": { "A2UIRoot": { "title": "A2UIRoot", "description": "A2UI protocol surface. Connects to a stream source (SSE, WebSocket, JSONL, MCP) and renders A2UI messages as AdiaUI components via the `@adia-ai/a2ui-utils` renderer.", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "active": { "description": "True while the stream is connected and receiving messages.", "type": "boolean", "default": false }, "batch": { "description": "Batch renderer updates via requestAnimationFrame for large fan-in.", "type": "boolean", "default": false }, "component": { "const": "A2UIRoot" }, "doc": { "description": "Author-driven mode — set to an array of A2UI messages and the renderer resets + replays them. No network/transport involvement. Setting to a new array triggers a full re-render. Use this for editors, previews, tests, and any static-doc authoring loop. When both `src` and `doc` are set, `doc` wins (the stream is not opened). Pass as a JS property; not reflected to an attribute.", "type": "array" }, "loading": { "description": "True while the stream is connecting.", "type": "boolean", "default": false }, "src": { "description": "Stream source URL (endpoint for SSE/WebSocket, file path for JSONL, tool-call target for MCP).", "type": "string", "default": "" }, "transport": { "description": "Stream transport to use.", "type": "string", "enum": [ "sse", "ws", "websocket", "jsonl", "mcp" ], "default": "sse" } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "container", "composes": [], "events": { "a2ui-action": { "description": "Fired when a child element with [data-action] is clicked. detail: { name, sourceComponentId, context }" }, "a2ui-closed": { "description": "Fired when the stream ends." }, "a2ui-connected": { "description": "Fired when the stream is established." }, "a2ui-error": { "description": "Fired when the stream errors. detail: { error }" }, "a2ui-message": { "description": "Fired for each A2UI message received. detail: { message }" }, "doc-replaced": { "description": "Fired after a full doc reset + replay in author-driven mode. detail: { count }" } }, "examples": [], "keywords": [ "a2ui", "protocol", "renderer", "stream", "surface", "sse", "websocket", "jsonl", "mcp" ], "name": "A2UIRoot", "related": [ "canvas", "inspector" ], "slots": { "default": { "description": "The rendered surface. Children are stamped by the A2UI renderer." } }, "states": [ { "description": "Default, ready to connect.", "name": "idle" }, { "description": "Stream is connecting.", "name": "loading" }, { "description": "Stream is connected and receiving messages.", "name": "active" } ], "status": "stable", "synonyms": { "a2ui-root": [ "a2ui-canvas-host", "a2ui-mount", "doc-root" ] }, "tag": "a2ui-root", "tokens": {}, "traits": [], "version": 1 } }, "Accordion": { "title": "Accordion", "description": "Accordion container managing single or multiple open states across\na collection of children. Each item carries its\nown [open] reflected state; the accordion host coordinates exclusive\nopening when [multiple] is unset (default single-open mode). Use\ninside settings pages, FAQ blocks, or any progressive-disclosure\npattern where one-level collapsible groups suffice — for arbitrary\nhierarchy use ; for in-page view switching use .\n", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "component": { "const": "Accordion" }, "multiple": { "description": "Allow multiple panels to be open simultaneously", "type": "boolean", "default": false } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "container", "composes": [ "icon-ui" ], "events": { "toggle": { "description": "Fired when the accordion panel opens or closes (single-pane accordion-ui dispatch — multi-pane group emits the same event per child).", "detail": { "open": { "description": "New open state of the panel.", "type": "boolean" } } } }, "examples": [ { "description": "Settings panel with accordion sections for profile, notifications, and privacy configuration.", "a2ui": "[\n {\n \"id\": \"root\",\n \"component\": \"Card\",\n \"children\": [\n \"hdr\",\n \"body\",\n \"ftr\"\n ]\n },\n {\n \"id\": \"hdr\",\n \"component\": \"Header\",\n \"slots\": {\n \"heading\": \"Settings\",\n \"description\": \"Manage your account preferences and configuration.\"\n }\n },\n {\n \"id\": \"body\",\n \"component\": \"Section\",\n \"children\": [\n \"accordion\"\n ]\n },\n {\n \"id\": \"accordion\",\n \"component\": \"Accordion\",\n \"attrs\": {\n \"type\": \"multiple\"\n },\n \"children\": [\n \"sec-profile\",\n \"sec-notifications\",\n \"sec-privacy\"\n ]\n },\n {\n \"id\": \"sec-profile\",\n \"component\": \"AccordionItem\",\n \"attrs\": {\n \"text\": \"Profile\",\n \"icon\": \"user\"\n },\n \"children\": [\n \"profile-form\"\n ]\n },\n {\n \"id\": \"profile-form\",\n \"component\": \"Column\",\n \"attrs\": {\n \"gap\": \"md\"\n },\n \"children\": [\n \"profile-name\",\n \"profile-email\",\n \"profile-bio\"\n ]\n },\n {\n \"id\": \"profile-name\",\n \"component\": \"Input\",\n \"attrs\": {\n \"label\": \"Display Name\",\n \"placeholder\": \"Enter your name\",\n \"value\": \"Jane Doe\"\n }\n },\n {\n \"id\": \"profile-email\",\n \"component\": \"Input\",\n \"attrs\": {\n \"label\": \"Email\",\n \"type\": \"email\",\n \"placeholder\": \"you@example.com\",\n \"value\": \"jane@example.com\"\n }\n },\n {\n \"id\": \"profile-bio\",\n \"component\": \"TextArea\",\n \"attrs\": {\n \"label\": \"Bio\",\n \"placeholder\": \"Tell us about yourself\",\n \"rows\": 3\n }\n },\n {\n \"id\": \"sec-notifications\",\n \"component\": \"AccordionItem\",\n \"attrs\": {\n \"text\": \"Notifications\",\n \"icon\": \"bell\"\n },\n \"children\": [\n \"notif-options\"\n ]\n },\n {\n \"id\": \"notif-options\",\n \"component\": \"Column\",\n \"attrs\": {\n \"gap\": \"md\"\n },\n \"children\": [\n \"notif-email\",\n \"notif-push\",\n \"notif-marketing\"\n ]\n },\n {\n \"id\": \"notif-email\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"notif-email-label\",\n \"notif-email-toggle\"\n ]\n },\n {\n \"id\": \"notif-email-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Email notifications\"\n },\n {\n \"id\": \"notif-email-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": true\n }\n },\n {\n \"id\": \"notif-push\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"notif-push-label\",\n \"notif-push-toggle\"\n ]\n },\n {\n \"id\": \"notif-push-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Push notifications\"\n },\n {\n \"id\": \"notif-push-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": true\n }\n },\n {\n \"id\": \"notif-marketing\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"notif-marketing-label\",\n \"notif-marketing-toggle\"\n ]\n },\n {\n \"id\": \"notif-marketing-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Marketing emails\"\n },\n {\n \"id\": \"notif-marketing-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": false\n }\n },\n {\n \"id\": \"sec-privacy\",\n \"component\": \"AccordionItem\",\n \"attrs\": {\n \"text\": \"Privacy\",\n \"icon\": \"lock\"\n },\n \"children\": [\n \"privacy-options\"\n ]\n },\n {\n \"id\": \"privacy-options\",\n \"component\": \"Column\",\n \"attrs\": {\n \"gap\": \"md\"\n },\n \"children\": [\n \"priv-profile-vis\",\n \"priv-activity\",\n \"priv-data\"\n ]\n },\n {\n \"id\": \"priv-profile-vis\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"priv-profile-label\",\n \"priv-profile-toggle\"\n ]\n },\n {\n \"id\": \"priv-profile-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Public profile\"\n },\n {\n \"id\": \"priv-profile-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": true\n }\n },\n {\n \"id\": \"priv-activity\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"priv-activity-label\",\n \"priv-activity-toggle\"\n ]\n },\n {\n \"id\": \"priv-activity-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Show activity status\"\n },\n {\n \"id\": \"priv-activity-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": false\n }\n },\n {\n \"id\": \"priv-data\",\n \"component\": \"Row\",\n \"attrs\": {\n \"justify\": \"between\",\n \"align\": \"center\"\n },\n \"children\": [\n \"priv-data-label\",\n \"priv-data-toggle\"\n ]\n },\n {\n \"id\": \"priv-data-label\",\n \"component\": \"Text\",\n \"attrs\": {\n \"variant\": \"body\"\n },\n \"content\": \"Allow analytics collection\"\n },\n {\n \"id\": \"priv-data-toggle\",\n \"component\": \"Toggle\",\n \"attrs\": {\n \"checked\": true\n }\n },\n {\n \"id\": \"ftr\",\n \"component\": \"Footer\",\n \"children\": [\n \"save-btn\"\n ]\n },\n {\n \"id\": \"save-btn\",\n \"component\": \"Button\",\n \"attrs\": {\n \"variant\": \"primary\"\n },\n \"content\": \"Save Changes\"\n }\n]", "name": "accordion-settings" }, { "description": "Frequently asked questions presented in an accordion layout with expandable question/answer items.", "a2ui": "[\n {\n \"id\": \"root\",\n \"component\": \"Card\",\n \"children\": [\n \"hdr\",\n \"body\"\n ]\n },\n {\n \"id\": \"hdr\",\n \"component\": \"Header\",\n \"children\": [\n \"title\",\n \"desc\"\n ]\n },\n {\n \"id\": \"title\",\n \"component\": \"Text\",\n \"slot\": \"heading\",\n \"variant\": \"section\",\n \"textContent\": \"Frequently Asked Questions\"\n },\n {\n \"id\": \"desc\",\n \"component\": \"Text\",\n \"slot\": \"description\",\n \"variant\": \"caption\",\n \"textContent\": \"Find answers to common questions about our platform.\"\n },\n {\n \"id\": \"body\",\n \"component\": \"Section\",\n \"children\": [\n \"col-wrap\"\n ]\n },\n {\n \"id\": \"accordion\",\n \"component\": \"Accordion\",\n \"children\": [\n \"q1\",\n \"q2\",\n \"q3\",\n \"q4\",\n \"q5\"\n ]\n },\n {\n \"id\": \"q1\",\n \"component\": \"AccordionItem\",\n \"text\": \"What is included in the free plan?\",\n \"children\": [\n \"a1\"\n ]\n },\n {\n \"id\": \"a1\",\n \"component\": \"Text\",\n \"variant\": \"body\",\n \"textContent\": \"The free plan includes up to 3 projects, 1 GB of storage, and access to community support forums.\"\n },\n {\n \"id\": \"q2\",\n \"component\": \"AccordionItem\",\n \"text\": \"Can I upgrade or downgrade at any time?\",\n \"children\": [\n \"a2\"\n ]\n },\n {\n \"id\": \"a2\",\n \"component\": \"Text\",\n \"variant\": \"body\",\n \"textContent\": \"Yes, you can change your plan at any time. When upgrading, you'll be charged a prorated amount.\"\n },\n {\n \"id\": \"q3\",\n \"component\": \"AccordionItem\",\n \"text\": \"How does billing work for teams?\",\n \"children\": [\n \"a3\"\n ]\n },\n {\n \"id\": \"a3\",\n \"component\": \"Text\",\n \"variant\": \"body\",\n \"textContent\": \"Team billing is per-seat. You're charged for each active team member on a monthly or annual basis.\"\n },\n {\n \"id\": \"q4\",\n \"component\": \"AccordionItem\",\n \"text\": \"Do you offer refunds?\",\n \"children\": [\n \"a4\"\n ]\n },\n {\n \"id\": \"a4\",\n \"component\": \"Text\",\n \"variant\": \"body\",\n \"textContent\": \"We offer a full refund within 30 days of purchase. After 30 days, we provide prorated refunds for annual plans.\"\n },\n {\n \"id\": \"q5\",\n \"component\": \"AccordionItem\",\n \"text\": \"Is my data secure?\",\n \"children\": [\n \"a5\"\n ]\n },\n {\n \"id\": \"a5\",\n \"component\": \"Text\",\n \"variant\": \"body\",\n \"textContent\": \"We use AES-256 encryption at rest, TLS 1.3 in transit, and are SOC 2 Type II certified.\"\n },\n {\n \"id\": \"col-wrap\",\n \"component\": \"Column\",\n \"children\": [\n \"accordion\"\n ],\n \"gap\": \"4\"\n }\n]", "name": "faq-accordion" } ], "keywords": [ "accordion", "options", "faq", "questions", "help", "support", "knowledge-base", "collapse", "expand" ], "name": "UIAccordion", "related": [ "accordion-item", "input", "text-area", "toggle", "button" ], "slots": { "default": { "description": "accordion-item-ui children" } }, "states": [ { "description": "Default, ready for interaction.", "name": "idle" } ], "status": "stable", "synonyms": { "accordion": [ "accordion", "faq", "settings" ], "collapse": [ "accordion", "faq", "drawer" ], "expand": [ "accordion", "faq", "drawer" ], "faq": [ "faq", "accordion" ], "help": [ "faq", "accordion", "tooltip" ], "knowledge-base": [ "faq", "accordion" ], "options": [ "settings", "radio", "segmented", "accordion" ], "questions": [ "faq", "accordion" ], "support": [ "faq", "accordion", "chat" ] }, "tag": "accordion-ui", "tokens": {}, "traits": [], "version": 1 } }, "AccordionItem": { "title": "AccordionItem", "description": "Child of . One collapsible section with header + body. Use inside 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": { "toggle": { "description": "Fired when the section opens or closes.", "detail": { "open": { "description": "New open state.", "type": "boolean" } } } }, "examples": [], "keywords": [ "accordion-item", "collapsible", "disclosure", "expand", "collapse-row", "section-toggle" ], "name": "UIAccordionItem", "related": [ "Accordion", "Card" ], "slots": { "action": { "description": "§206 (v0.5.7): action buttons inside a custom header (e.g. Copy /\nDownload / settings). Children placed at `[slot=\"action\"]` (or\n`[slot=\"actions\"]`, or marked `[data-no-toggle]`) are excluded from\nthe toggle-on-click cascade — clicking them fires their own handler\nwithout also toggling the section." }, "body": { "description": "The section's collapsible content. Renders below the header; hidden when `[open]` is unset. Author-fills with prose, lists, embedded forms, or any rich markup the panel needs." }, "header": { "description": "Custom header content. By default `[text]` renders as a plain header\nlabel, but a `[slot=\"header\"]` override lets consumers author rich\nheaders (icon + title + action buttons + caret)." } }, "states": [], "status": "stable", "synonyms": { "accordion-item": [ "collapsible-row", "disclosure-row", "expansion-panel", "expander" ] }, "tag": "accordion-item-ui", "tokens": {}, "traits": [], "version": 1 } }, "ActionItem": { "title": "ActionItem", "description": "Child of . 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": [ "action-item", "command-row", "inline-action", "list-action", "action-list-row" ], "name": "UIActionItem", "related": [ "ActionList", "MenuItem", "Button" ], "slots": { "icon": { "description": "Override the [icon] glyph with a custom slotted element (custom icon-ui, image, avatar). Mutually exclusive with the [icon] attribute — slot child wins." } }, "states": [], "status": "stable", "synonyms": { "action-item": [ "command-item", "inline-command", "action-row" ] }, "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.", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "component": { "const": "ActionList" } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "navigation", "composes": [ "icon-ui" ], "events": { "action": { "description": "Fired on action.", "detail": { "item": { "description": "The triggering list-item element.", "type": "object" }, "text": { "description": "Item text content or [text] attribute.", "type": "string" }, "value": { "description": "Item value attribute (preferred over text for stable IDs).", "type": "string" } } } }, "examples": [ { "description": "Basic ActionList 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\": \"ActionList\"\n }\n]", "name": "basic-action-list" } ], "keywords": [ "actionlist", "action-list", "action", "list" ], "name": "UIActionList", "related": [ "ActionItem", "Menu", "Button" ], "slots": { "default": { "description": "Holds the list's `` children (the action items)." } }, "states": [ { "description": "Default, ready for interaction.", "name": "idle" } ], "status": "stable", "synonyms": { "action-list": [ "command-list", "action-rows", "command-rows" ] }, "tag": "action-list-ui", "tokens": {}, "traits": [], "version": 1 } }, "AdminCommand": { "title": "AdminCommand", "description": "Module-tier command palette wrapper — wraps a native and the\ninner . Owns the keyboard shortcut listener, focus\nmanagement, and dismiss handlers. Reflects [open].\n\nSits inside as a direct child. The host wires\n[data-command-trigger] elements to .show() via lookup.\n\nThis is the bespoke web-component replacement for the legacy\n shape per ADR-0023. The legacy shape was\nretired in v0.4.0 per ADR-0024 and is no longer recognized.\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", "composes": [], "events": { "command-select": { "description": "Forwarded from the inner 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 (and any other content inside the dialog). Authors typically place exactly one ." } }, "states": [ { "description": "Default, palette closed.", "name": "idle" }, { "description": "Dialog is showing; first input has focus.", "attribute": "open", "name": "open" } ], "status": "stable", "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 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
element\ninside admin-shell per ADR-0023. The legacy shape was retired in\nv0.4.0 per ADR-0024 and is no longer recognized.\n", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "component": { "const": "AdminContent" } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "layout", "composes": [], "events": {}, "examples": [], "keywords": [ "admin-content", "main", "center-column", "workspace" ], "name": "AdminContent", "related": [ "AdminShell", "AdminSidebar", "AdminTopbar", "AdminStatusbar", "AdminScroll", "AdminPage" ], "slots": { "default": { "description": "Default content — typically , an wrapping content, and an optional ." }, "footer": { "description": "Bottom chrome bar — typically ." }, "header": { "description": "Top chrome bar — typically ." } }, "states": [ { "description": "Default, the only state.", "name": "idle" } ], "status": "stable", "synonyms": { "main": [ "content", "center", "workspace" ] }, "tag": "admin-content", "tokens": {}, "traits": [], "version": 1 } }, "AdminEntityItem": { "title": "AdminEntityItem", "description": "Module-tier shell identity row. CSS-only — no behavior, no JS.\nA composable icon + label + badge unit: a leading icon (or avatar),\na truncating label, and an optional trailing badge that travel\ntogether as one slottable element.\n\nUse it wherever a shell surface shows an entity identity — workspace\nidentity in an , user identity in an\n, the leading item of a breadcrumb, a flyout header,\nor a user row. Inside a collapsible the label and\nbadge hide when the rail collapses; the icon survives — so the same\nmarkup works expanded and collapsed without authoring two shapes.\n\nGeometry mirrors 's trigger row: [slot=\"icon\"] is fixed\n(like [slot=\"leading\"]), [slot=\"label\"] flexes + truncates (like\n[slot=\"display\"]), [slot=\"badge\"] is fixed trailing (like\n[slot=\"caret\"]).\n", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "component": { "const": "AdminEntityItem" } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "layout", "composes": [], "events": {}, "examples": [], "keywords": [ "admin-entity-item", "entity-item", "identity-row", "workspace-identity", "user-identity", "icon-label-badge" ], "name": "AdminEntityItem", "related": [ "AdminTopbar", "AdminStatusbar", "AdminSidebar", "Select", "Badge", "Icon" ], "slots": { "default": { "description": "Default content — unslotted children flow inline. Prefer the named slots for the canonical icon + label + badge composition." }, "badge": { "description": "Optional trailing chip — environment (staging / beta) or role badge. Fixed width. Hidden when a collapsible sidebar collapses." }, "icon": { "description": "Leading visual — wrap an glyph in (canonical: , mirrors the [slot=\"icon\"] convention so the entity icon visually aligns with a column of nav-item icons beneath in the same sidebar). For an avatar, place directly — img gets a circular crop and avatar sizing (no wrapper needed). Fixed width; survives sidebar collapse." }, "label": { "description": "Primary text. Flexes to fill the remaining width and truncates with an ellipsis. Hidden when a collapsible sidebar collapses." } }, "states": [ { "description": "Default, the only state.", "name": "idle" } ], "status": "stable", "synonyms": { "entity-item": [ "identity-row", "entity-row", "identity-item" ] }, "tag": "admin-entity-item", "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: + + optional footer.\n\nReplaces the legacy
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", "composes": [], "events": {}, "examples": [], "keywords": [ "admin-page", "page-content", "container-query-host" ], "name": "AdminPage", "related": [ "AdminShell", "AdminContent", "AdminScroll", "AdminPageHeader", "AdminPageBody" ], "slots": { "default": { "description": "Default — typically + ." }, "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" } ], "status": "stable", "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 . Owns full-width\nscroll sizing; wraps an inner or raw
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", "composes": [], "events": {}, "examples": [], "keywords": [ "admin-page-body", "page-body", "centered-body" ], "name": "AdminPageBody", "related": [ "AdminPage", "AdminPageHeader", "Section" ], "slots": { "default": { "description": "Default — typically or
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" } ], "status": "stable", "synonyms": { "page-body": [ "content-body", "document-body" ] }, "tag": "admin-page-body", "tokens": {}, "traits": [], "version": 1 } }, "AdminPageFooter": { "title": "AdminPageFooter", "description": "Module-tier page-footer band. CSS-only — no behavior, no JS.\nSticky BOTTOM band inside — the bottom-anchored\ncounterpart of . Owns full-width concerns\n(sticky position, border-top, background); wraps an inner\n for the centered reading column (max-width, gutter,\nrhythm). Use for persistent page-level chrome — a save / action\nbar, pagination, or legal strip. For shell-tier status chrome\nspanning the whole shell, use instead.\n", "type": "object", "allOf": [ { "$ref": "#/$defs/ComponentCommon" }, { "$ref": "#/$defs/CatalogComponentCommon" } ], "properties": { "component": { "const": "AdminPageFooter" } }, "required": [ "component" ], "unevaluatedProperties": false, "x-adiaui": { "anti_patterns": [], "category": "layout", "composes": [], "events": {}, "examples": [], "keywords": [ "admin-page-footer", "page-footer", "sticky-footer", "save-bar", "action-bar" ], "name": "AdminPageFooter", "related": [ "AdminPage", "AdminPageHeader", "AdminPageBody", "AdminStatusbar", "Footer" ], "slots": { "default": { "description": "Default — with footer content (actions, meta, pagination, legal). Raw