@adia-ai/a2ui-corpus 0.3.4 → 0.3.6

package/catalog-a2ui_0_9.json

@@ -3692,6 +3692,239 @@
         "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": [
+          "ChatShell",
+          "ChatStatus",
+          "ChatThread",
+          "ChatComposer"
+        ],
+        "slots": {
+          "default": {
+            "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, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "chat-header": [
+            "titlebar",
+            "app-header",
+            "navbar"
+          ]
+        },
+        "tag": "chat-header",
+        "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",
@@ -3839,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": [
         {
@@ -3852,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
         }
@@ -3867,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 }."
-          }
-        },
-        "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"
-          },
-          {
-            "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": "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"
+          "sidebar-resize": {
+            "description": "Bubbles when an active pointer-drag releases.",
+            "detail": {
+              "name": "string",
+              "width": "number"
+            }
           },
-          {
-            "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"
+          "sidebar-toggle": {
+            "description": "Bubbles when sidebar collapses or expands.",
+            "detail": {
+              "expanded": "boolean",
+              "name": "string"
+            }
           }
-        ],
+        },
+        "examples": [],
         "keywords": [
-          "chat",
-          "message",
-          "messaging",
-          "sms",
-          "chatbot",
-          "conversation",
-          "ai-chat",
-          "messenger",
-          "assistant",
-          "copilot",
-          "gpt",
-          "llm",
-          "ai",
-          "bot",
-          "prompt",
-          "comment",
-          "support"
+          "chat-sidebar",
+          "chat-sidebar",
+          "conversation-history",
+          "chat-rail",
+          "sidebar",
+          "leading",
+          "trailing",
+          "inspector"
+        ],
+        "name": "ChatSidebar",
+        "related": [
+          "ChatShell",
+          "ChatComposer",
+          "ChatHeader",
+          "List",
+          "Nav"
         ],
-        "name": "UIChatThread",
-        "related": [],
         "slots": {
           "default": {
-            "description": "Default slot — primary child content."
+            "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, ready for interaction.",
+            "description": "Default, expanded.",
             "name": "idle"
-          }
-        ],
-        "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"
+          },
+          {
+            "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"
           ],
-          "sms": [
-            "chat",
-            "notification"
+          "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-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",
+          "thread",
+          "scroll-surface"
+        ],
+        "name": "ChatThread",
+        "related": [
+          "ChatShell",
+          "ChatEmpty",
+          "ChatComposer",
+          "ChatSidebar"
+        ],
+        "slots": {
+          "default": {
+            "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, 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": {
+          "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
@@ -5288,6 +5626,158 @@
         "version": 1
       }
     },
+    "EditorCanvas": {
+      "title": "EditorCanvas",
+      "description": "Module-tier editor canvas surface — replaces legacy <div data-canvas>\ninside <editor-shell> per ADR-0023. Owns scroll/zoom container\nsemantics, [empty] and [focused] reflected attributes, and a stable\ntarget for the host's content rendering pipeline.\n\nSits as the central content region inside <editor-shell>, between\nthe optional <editor-sidebar slot=\"leading\"> and <editor-sidebar\nslot=\"trailing\">. Authors compose <editor-canvas-empty> as an\noptional first child for the empty state; canvas content children\n(artboards, document body, etc.) are appended either statically or\ndynamically by the host.\n\nBackwards compat — <editor-shell> still recognizes the legacy\n<div data-canvas> shape via :is() selector. New code should prefer\n<editor-canvas>.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "EditorCanvas"
+        },
+        "empty": {
+          "description": "Reflected — set when zero non-<editor-canvas-empty> children.\nDrives the <editor-canvas-empty> visibility via parent CSS —\nno JS toggling needed.\n",
+          "type": "boolean",
+          "default": true
+        },
+        "focused": {
+          "description": "Reflected — set when canvas claims focus ownership (programmatic\n.focus() call or toolbar full-screen toggle).\n",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "container",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "editor-canvas",
+          "canvas",
+          "workspace",
+          "artboard",
+          "editor-surface"
+        ],
+        "name": "EditorCanvas",
+        "related": [
+          "EditorShell",
+          "EditorCanvasEmpty",
+          "EditorToolbar",
+          "EditorSidebar"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — canvas content (artboards, document body, blocks, etc.) plus an optional first <editor-canvas-empty> sibling for the empty state."
+          }
+        },
+        "states": [
+          {
+            "description": "Default canvas mode.",
+            "name": "idle"
+          },
+          {
+            "description": "Zero content children — empty state visible.",
+            "attribute": "empty",
+            "name": "empty"
+          },
+          {
+            "description": "Canvas is the focus surface.",
+            "attribute": "focused",
+            "name": "focused"
+          }
+        ],
+        "synonyms": {
+          "editor-canvas": [
+            "canvas",
+            "workspace",
+            "artboard",
+            "design-surface"
+          ]
+        },
+        "tag": "editor-canvas",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "EditorCanvasEmpty": {
+      "title": "EditorCanvasEmpty",
+      "description": "Module-tier editor canvas empty state. CSS-only — no behavior, no\nJS. Sits as the first child of <editor-canvas> as the empty state\nplaceholder. Visibility is driven by <editor-canvas>'s [empty]\nreflected attribute via CSS (no JS toggling) — when content arrives,\nthe parent canvas loses [empty] and CSS hides this stub.\n\nReplaces ad-hoc empty-state placement inside the legacy\n<div data-canvas> per ADR-0023.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "EditorCanvasEmpty"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "editor-canvas-empty",
+          "empty-state",
+          "placeholder",
+          "no-content",
+          "canvas-empty"
+        ],
+        "name": "EditorCanvasEmpty",
+        "related": [
+          "EditorShell",
+          "EditorCanvas",
+          "EmptyState"
+        ],
+        "slots": {
+          "default": {
+            "description": "Empty state content — typically <empty-state-ui> with a \"Create new...\" prompt or onboarding affordance."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, visible.",
+            "name": "idle"
+          },
+          {
+            "description": "Hidden via parent <editor-canvas>:not([empty]) selector.",
+            "name": "hidden"
+          }
+        ],
+        "synonyms": {
+          "editor-canvas-empty": [
+            "empty-state",
+            "placeholder",
+            "no-document"
+          ]
+        },
+        "tag": "editor-canvas-empty",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "EditorShell": {
       "title": "EditorShell",
       "description": "Behavior-only editor shell module for design-tool layouts. Author\nprovides the structural DOM — header (topbar), [data-editor-body] with\npane-ui children ([data-left], [data-right]), [data-canvas] for the\ncentral surface, and a footer (statusbar). editor-shell wires\nselect-ui[data-options] for JSON-parsed option lists.\n",
@@ -5359,6 +5849,260 @@
         "version": 1
       }
     },
+    "EditorSidebar": {
+      "title": "EditorSidebar",
+      "description": "Module-tier editor-cluster sidebar — wraps <pane-ui resizable>\n(the primitive that owns drag) and adds [collapsed] reflected\nstate, localStorage persistence (adia-editor-sidebar-{name}),\nand .toggle() / .collapse() / .expand() public API.\n\nSits inside <editor-shell> as slot=\"leading\" (navigator pane) or\nslot=\"trailing\" (inspector pane). Mirrors the cluster-namespace\nshape from <admin-sidebar> and <chat-sidebar>, but DELEGATES to\n<pane-ui> for resize rather than reimplementing it (per\nbespoke-shell-children skill §When NOT to promote — pane primitive\nalready owns this concern).\n\nThis is the FIRST bespoke shell child that delegates rather than\nduplicates a primitive's behavior. Pattern is: cluster-namespace +\nstate-as-attribute + persistence at the bespoke tier; physical\ndrag at the primitive tier.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "collapsed": {
+          "description": "Reflected — set when inner <pane-ui> width is at or below 96px snap threshold.",
+          "type": "boolean",
+          "default": false
+        },
+        "component": {
+          "const": "EditorSidebar"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {
+          "sidebar-toggle": {
+            "description": "Bubbles when .toggle() / .collapse() / .expand() is called.",
+            "detail": {
+              "expanded": "boolean",
+              "name": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "editor-sidebar",
+          "navigator-pane",
+          "inspector-pane",
+          "editor-rail",
+          "sidebar",
+          "leading",
+          "trailing"
+        ],
+        "name": "EditorSidebar",
+        "related": [
+          "EditorShell",
+          "EditorCanvas",
+          "Pane",
+          "AdminSidebar",
+          "ChatSidebar"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — the inner <pane-ui resizable> wrapper. Authors compose header / section / footer inside the pane as usual."
+          }
+        },
+        "states": [
+          {
+            "description": "Default expanded state.",
+            "name": "idle"
+          },
+          {
+            "description": "Inner pane is at or below the snap threshold.",
+            "attribute": "collapsed",
+            "name": "collapsed"
+          }
+        ],
+        "synonyms": {
+          "editor-sidebar": [
+            "navigator",
+            "inspector",
+            "editor-rail",
+            "side-panel"
+          ]
+        },
+        "tag": "editor-sidebar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "EditorStatusbar": {
+      "title": "EditorStatusbar",
+      "description": "Module-tier editor statusbar — bottom chrome bar inside\n<editor-shell>. CSS-only, no behavior, no JS. Holds save/sync\nstate, zoom indicator, cursor position, and tertiary actions\nvia slot vocabulary.\n\nReplaces the legacy <footer> with positional content per ADR-0023.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "EditorStatusbar"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "editor-statusbar",
+          "statusbar",
+          "bottom-bar",
+          "editor-footer"
+        ],
+        "name": "EditorStatusbar",
+        "related": [
+          "EditorShell",
+          "EditorToolbar",
+          "EditorCanvas"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default — ad-hoc inline content (legacy positional layout)."
+          },
+          "action": {
+            "description": "Trailing action cluster (e.g., toggle full-screen)."
+          },
+          "cursor": {
+            "description": "Cursor position / selection indicator."
+          },
+          "status": {
+            "description": "Save/sync state indicator."
+          },
+          "zoom": {
+            "description": "Zoom level indicator."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "editor-statusbar": [
+            "statusbar",
+            "footer-bar",
+            "bottom-bar"
+          ]
+        },
+        "tag": "editor-statusbar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "EditorToolbar": {
+      "title": "EditorToolbar",
+      "description": "Module-tier editor toolbar — replaces legacy <header> chrome bar\ninside <editor-shell> per ADR-0023. Owns the [full-screen] reflected\nattribute (set when host enters focus mode), click-bubble for\n[data-toolbar-action] buttons, and slot vocabulary routing.\n\nSits at the top of <editor-shell>. Authors compose actions + status\nvia slot vocabulary. The host (<editor-shell>) reads either\n<editor-toolbar> or <header> via :is() selector for backwards compat.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "EditorToolbar"
+        },
+        "fullScreen": {
+          "description": "Reflected — set when editor is in distraction-free / focus mode.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {
+          "toolbar-action": {
+            "description": "Bubbles when a child element with [data-toolbar-action] is clicked. Detail carries the action name from the clicked element's attribute.",
+            "detail": {
+              "name": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "editor-toolbar",
+          "editor-titlebar",
+          "editor-chrome",
+          "app-header",
+          "editor-actions"
+        ],
+        "name": "EditorToolbar",
+        "related": [
+          "EditorShell",
+          "EditorCanvas",
+          "EditorSidebar",
+          "EditorStatusbar"
+        ],
+        "slots": {
+          "title": {
+            "description": "Editor / document title cluster."
+          },
+          "default": {
+            "description": "Default — ad-hoc inline content (legacy positional layout)."
+          },
+          "action": {
+            "description": "Trailing action cluster (settings, share, more)."
+          },
+          "action-leading": {
+            "description": "Leading action cluster (back, switcher, undo/redo)."
+          },
+          "status": {
+            "description": "Status indicator (saving, dirty, synced, etc.)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default editor mode.",
+            "name": "idle"
+          },
+          {
+            "description": "Distraction-free / focus mode active.",
+            "attribute": "full-screen",
+            "name": "full-screen"
+          }
+        ],
+        "synonyms": {
+          "editor-toolbar": [
+            "editor-header",
+            "app-header",
+            "navbar",
+            "titlebar"
+          ]
+        },
+        "tag": "editor-toolbar",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Embed": {
       "title": "Embed",
       "description": "Responsive sandboxed iframe wrapper.",