@adia-ai/a2ui-corpus 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -19,6 +19,23 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.3.4] - 2026-05-07
+
+### Changed
+
+- **Component catalog regenerated** — 100 → 107 yamls (+7 from new admin-* CSS-only structural children added in `@adia-ai/web-modules`). `catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt` regenerated by `scripts/build/components.mjs`.
+
+- **New catalog entries** for the bespoke shell-tier family per ADR-0023:
+  - `AdminSidebar` (admin-sidebar) — JS-bearing
+  - `AdminCommand` (admin-command) — JS-bearing
+  - `AdminContent` / `AdminTopbar` / `AdminStatusbar` / `AdminScroll` / `AdminPage` / `AdminPageHeader` / `AdminPageBody` — CSS-only structural
+
+The catalog is consumed by `@adia-ai/a2ui-retrieval` for protocol-vocabulary composition. Composers (zettel, chunk-zettel) now have addressable entries for shell sub-regions instead of falling back to chunk-name retrieval.
+
+### No source changes
+
+Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.3. The only change is the regenerated catalog manifest.
+
 ## [0.3.3] - 2026-05-07
 
 **Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).

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": {

package/catalog-a2ui_0_9_rules.txt

@@ -25,6 +25,35 @@
 ## GenRoot
 - gen-root is an integration shell. Prefer admin-shell for admin UIs; use gen-root only for chat+canvas tooling.
 
+## AdminCommand
+- admin-command wraps a native <dialog>; the inner <command-ui> is the actual palette. Keyboard shortcut defaults to both Cmd+K (mac) and Ctrl+K (other) — the AdiaUI convention.
+- Place admin-command as a direct child of admin-shell, NOT inside a sidebar or main column. The host coordinates triggers ([data-command-trigger]) by reaching across siblings.
+
+## AdminContent
+- admin-content is the bespoke replacement for raw <main> inside admin-shell. CSS-only; the shell's css/main.css selectors target both shapes via :is(main, admin-content).
+
+## AdminPageBody
+- admin-page-body is the centered body band of <admin-page>. Wraps an inner <section-ui> for centered reading-column rhythm; can host full-bleed content directly to opt out.
+
+## AdminPageHeader
+- admin-page-header is the sticky top band of <admin-page>. Wraps an inner <header-ui> for centered reading-column rhythm.
+
+## AdminPage
+- admin-page is the bespoke replacement for <article data-content-root>. Provides the page-content named container query so descendants can use @container page-content (max-width: 720px) etc.
+
+## AdminScroll
+- admin-scroll is the bespoke replacement for the legacy <section> child of <main> inside admin-shell. Single child convention — typically wraps an <admin-page> for sticky-band layout.
+
 ## AppShell
 - admin-shell is a behavior wrapper; its children are native HTML landmarks (aside, main, header). Don't wrap them in col-ui/row-ui — app-shell.css handles grid layout based on [data-sidebar] attributes.
 
+## AdminSidebar
+- admin-sidebar is the bespoke replacement for legacy <aside data-sidebar>. Use slot="leading" or slot="trailing" to position. Add resizable + collapsible attributes to opt in to interactive behaviors.
+- For chrome bars inside the sidebar, prefer <admin-topbar slot="header"> and <admin-statusbar slot="footer"> over raw <header-ui> / <footer-ui> when authoring shell-tier markup.
+
+## AdminStatusbar
+- admin-statusbar replaces <footer-ui> at shell-tier. Same slot vocabulary as <admin-topbar>; visual treatment differs (the shell css applies a top-border instead of bottom).
+
+## AdminTopbar
+- admin-topbar replaces <header-ui> at shell-tier — use it for chrome bars inside admin-shell, admin-content, admin-sidebar. Use <header-ui> for primitive containers (Card / Drawer / Modal).
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-corpus",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "type": "module",
   "description": "AdiaUI A2UI training corpus \u2014 patterns, fragments, compositions, exemplars, eval fixtures, feedback, gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
   "exports": {