@adia-ai/web-modules 0.8.40 → 0.8.42

package/shell/admin-page-footer/admin-page-footer.yaml

@@ -34,6 +34,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminPage
   rules:
     - >-
       admin-page-footer is the sticky bottom band of <admin-page>,

package/shell/admin-page-header/admin-page-header.a2ui.json

@@ -22,6 +22,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "AdminPage"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -33,6 +36,7 @@
       "page-band"
     ],
     "name": "AdminPageHeader",
+    "parts": {},
     "related": [
       "AdminPage",
       "AdminPageBody",

package/shell/admin-page-header/admin-page-header.yaml

@@ -32,6 +32,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminPage
   rules:
     - >-
       admin-page-header is the sticky top band of <admin-page>.

package/shell/admin-scroll/admin-scroll.a2ui.json

@@ -22,6 +22,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "AdminContent"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -33,6 +36,7 @@
       "scroll-container"
     ],
     "name": "AdminScroll",
+    "parts": {},
     "related": [
       "AdminShell",
       "AdminContent",

package/shell/admin-scroll/admin-scroll.yaml

@@ -32,6 +32,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminContent
   rules:
     - >-
       admin-scroll is the bespoke replacement for the legacy <section>

package/shell/admin-shell/admin-shell.a2ui.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://adiaui.dev/a2ui/v0_9/components/AppShell.json",
-  "title": "AppShell",
-  "description": "Behavior-only application shell. Canonical authoring shape uses\ncluster-namespaced bespoke children — <admin-topbar> at the top,\n<admin-sidebar slot=\"leading|trailing\"> rails, <admin-content> for\nthe main content region, <admin-command> for the Cmd+K palette, and\noptional <admin-statusbar> at the bottom. The shell wires sidebar\ntoggle forwarding, command-palette triggers, and the ResizeObserver\nthat drives responsive sidebar collapse; each bespoke child owns\nits own resize / collapse / open state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<aside data-sidebar>, <dialog\ndata-command>, [data-resize], <aside-ui slot=>, <span data-spacer>,\n<div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
+  "$id": "https://adiaui.dev/a2ui/v0_9/components/AdminShell.json",
+  "title": "AdminShell",
+  "description": "Behavior-only application shell. Canonical authoring shape uses\ncluster-namespaced bespoke children — <admin-topbar> at the top,\n<admin-sidebar slot=\"leading|trailing\"> rails, <admin-content> for\nthe main content region, <admin-command> for the Cmd+K palette, and\noptional <admin-statusbar> at the bottom. The shell wires sidebar\ntoggle forwarding, command-palette triggers, and the ResizeObserver\nthat drives responsive sidebar collapse; each bespoke child owns\nits own resize / collapse / open state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<aside data-sidebar>, <dialog\ndata-command>, [data-sidebar-resize], <aside-ui slot=>, <span data-spacer>,\n<div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
   "type": "object",
   "allOf": [
     {
@@ -14,7 +14,7 @@
   ],
   "properties": {
     "component": {
-      "const": "AppShell"
+      "const": "AdminShell"
     },
     "mode": {
       "description": "Layout variant — space-separated token set. Recognized tokens:\n  rounded     — softens content-surface edges (border-radius from --page-content-radius)\n  borderless  — removes outer chrome borders (content dividers persist)\nThe CSS uses `mode~=\"<token>\"` attribute selectors, so multiple\ntokens combine additively (\"rounded borderless\" = both).\n\nDefault since v0.6.13: \"rounded borderless\". A bare `<admin-shell>`\nwith no `mode` attribute auto-promotes to this pair on connect.\nAuthor-supplied `mode` attributes (including the empty string\n`mode=\"\"` for flat bordered chrome) are respected verbatim.\n",
@@ -27,6 +27,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "Surface"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -63,6 +66,7 @@
       "nav"
     ],
     "name": "AdminShell",
+    "parts": {},
     "related": [
       "Nav",
       "NavGroup",

package/shell/admin-shell/admin-shell.d.ts

@@ -10,7 +10,7 @@ its own resize / collapse / open state-as-attribute semantics per
 ADR-0023.
 
 Legacy data-attribute shapes (<aside data-sidebar>, <dialog
-data-command>, [data-resize], <aside-ui slot=>, <span data-spacer>,
+data-command>, [data-sidebar-resize], <aside-ui slot=>, <span data-spacer>,
 <div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no
 longer recognized. Consumers must use the bespoke vocabulary.
 

package/shell/admin-shell/admin-shell.yaml

@@ -2,7 +2,7 @@ $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: AdminShell
 tag: admin-shell
 status: stable
-component: AppShell
+component: AdminShell
 category: layout
 version: 1
 description: |
@@ -17,7 +17,7 @@ description: |
   ADR-0023.
 
   Legacy data-attribute shapes (<aside data-sidebar>, <dialog
-  data-command>, [data-resize], <aside-ui slot=>, <span data-spacer>,
+  data-command>, [data-sidebar-resize], <aside-ui slot=>, <span data-spacer>,
   <div data-actions>) were RETIRED in v0.4.0 per ADR-0024 and are no
   longer recognized. Consumers must use the bespoke vocabulary.
 
@@ -98,6 +98,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - Surface
   rules:
     - >-
       admin-shell takes bespoke admin-* children only. The canonical
@@ -119,7 +121,7 @@ a2ui:
     - >-
       Legacy data-attribute shapes were retired in v0.4.0 per ADR-0024.
       Do not author <aside data-sidebar>, <dialog data-command>,
-      [data-resize], <aside-ui slot=>, <span data-spacer>, or
+      [data-sidebar-resize], <aside-ui slot=>, <span data-spacer>, or
       <div data-actions> inside admin-shell.
 
 keywords: [app-shell, shell, layout, admin, dashboard, sidebar, nav]

package/shell/admin-shell/css/admin-shell.bespoke.css

@@ -201,7 +201,7 @@ admin-sidebar[slot="trailing"] {
 }
 
 /* Resize handle */
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > [data-resize] {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > :is([data-resize], [data-sidebar-resize]) {
   position: absolute;
   top: 0;
   bottom: 0;
@@ -211,10 +211,10 @@ admin-sidebar[slot="trailing"] {
   user-select: none;
 }
 
-admin-sidebar[slot="leading"] > [data-resize] { right: -3px; }
-admin-sidebar[slot="trailing"] > [data-resize] { left: -3px; }
+admin-sidebar[slot="leading"] > :is([data-resize], [data-sidebar-resize]) { right: -3px; }
+admin-sidebar[slot="trailing"] > :is([data-resize], [data-sidebar-resize]) { left: -3px; }
 
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > [data-resize]:hover {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > :is([data-resize], [data-sidebar-resize]):hover {
   background: var(--page-sidebar-resize-accent);
   opacity: 0.5;
 }
@@ -223,7 +223,7 @@ admin-sidebar[resizing] {
   transition: none;
 }
 
-admin-sidebar[resizing] > [data-resize] {
+admin-sidebar[resizing] > :is([data-resize], [data-sidebar-resize]) {
   background: var(--page-sidebar-resize-accent);
   opacity: 0.8;
 }

package/shell/admin-shell/css/admin-shell.helpers.css

@@ -26,14 +26,19 @@ admin-shell [data-actions] {
 
 /* ── Form layout helpers ── */
 
-/* 2-column grid (default), 3-column with data-grid="3" */
-admin-shell [data-grid] {
+/* 2-column grid (default), 3-column with data-layout-grid="3" */
+/* Rename-wave compat (docs/ops/plan/plan-090-rename-wave.md W1):
+   `data-layout-grid` is the current name; `data-grid` still dual-reads
+   until the 0.9.0 cut (W3). No JS reads this attribute, so there is no
+   deprecation warn to hang here — the migration guide + adia-lint advisory
+   are the signal (plan-090's own recorded honest limit). */
+admin-shell :is([data-grid], [data-layout-grid]) {
   display: grid;
   grid-template-columns: 1fr 1fr;
   gap: var(--page-grid-gap);
 }
 
-admin-shell [data-grid="3"] {
+admin-shell :is([data-grid="3"], [data-layout-grid="3"]) {
   grid-template-columns: 1fr 1fr 1fr;
 }
 

package/shell/admin-shell/css/admin-shell.sidebar.css

@@ -30,7 +30,7 @@
 /* ── Resize handle ──
    6px invisible hit area straddling the sidebar edge.
    Accent color on hover/drag. */
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > [data-resize] {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > :is([data-resize], [data-sidebar-resize]) {
   position: absolute;
   top: 0;
   bottom: 0;
@@ -41,19 +41,19 @@
   z-index: 3; /* above the content island's sticky bands (z 1) and sidebar chrome (z 2) — the grabber is a transient affordance and reads on top of shell chrome (gh#513) */
 }
 
-admin-sidebar[slot="leading"] > [data-resize] { right: -3px; }
-admin-sidebar[slot="trailing"] > [data-resize] { left: -3px; }
+admin-sidebar[slot="leading"] > :is([data-resize], [data-sidebar-resize]) { right: -3px; }
+admin-sidebar[slot="trailing"] > :is([data-resize], [data-sidebar-resize]) { left: -3px; }
 
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > [data-resize]:hover {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"]) > :is([data-resize], [data-sidebar-resize]):hover {
   background: var(--page-sidebar-resize-accent);
 }
 
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"])[data-resizing] > [data-resize] {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"])[resizing] > :is([data-resize], [data-sidebar-resize]) {
   background: var(--page-sidebar-resize-accent);
 }
 
 /* During drag: disable transition + text selection */
-:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"])[data-resizing] {
+:is(admin-sidebar[slot="leading"], admin-sidebar[slot="trailing"])[resizing] {
   user-select: none;
   transition: none;
 }

package/shell/admin-sidebar/admin-sidebar.a2ui.json

@@ -37,7 +37,7 @@
       "default": ""
     },
     "resizable": {
-      "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-resize] element as the drag handle.\n",
+      "description": "Opts in to drag-to-resize behavior. Author supplies a child\n[data-sidebar-resize] element as the drag handle.\n",
       "type": "boolean",
       "default": false
     },
@@ -52,6 +52,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "AdminShell"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -84,6 +87,7 @@
       "nav"
     ],
     "name": "AdminSidebar",
+    "parts": {},
     "related": [
       "AdminShell",
       "AdminCommand",

package/shell/admin-sidebar/admin-sidebar.d.ts

@@ -49,7 +49,7 @@ with the same slot.
  */
   name: string;
   /** Opts in to drag-to-resize behavior. Author supplies a child
-[data-resize] element as the drag handle.
+[data-sidebar-resize] element as the drag handle.
  */
   resizable: boolean;
   /** Reflected — set during an active pointer-drag on the resize handle.

package/shell/admin-sidebar/admin-sidebar.js

@@ -29,8 +29,10 @@
  *   sidebar-toggle  — bubbles. detail: { name, expanded }
  *   sidebar-resize  — bubbles. detail: { name, width }
  *
- * The drag handle is conventional: a child `[data-resize]` element.
- * Authors may provide a custom one, or omit (no resize affordance).
+ * The drag handle is conventional: a child `[data-sidebar-resize]` element
+ * (`[data-resize]` still works — deprecated, dual-read compat shim, removed
+ * in 0.9.0: docs/ops/plan/plan-090-rename-wave.md). Authors may provide a
+ * custom one, or omit (no resize affordance).
  *
  * Backwards compat: <admin-shell> still recognizes the legacy
  * `<aside data-sidebar="leading">` shape via :is() selector. New
@@ -59,6 +61,11 @@ class AdminSidebar extends UIElement {
   // handle — one-shot per element so re-renders stay quiet. GC-friendly.
   static #warnedNoHandle = new WeakSet();
 
+  // Rename-wave compat (docs/ops/plan/plan-090-rename-wave.md W1): one-shot
+  // deprecation warn per element when the legacy `[data-resize]` name is the
+  // one that resolved the handle. Same GC-friendly WeakSet pattern as above.
+  static #warnedOldResizeName = new WeakSet();
+
   // The width the sidebar had before being collapsed — used for restore.
   // Map keyed by sidebar name allows multiple sidebars on one host.
   #previousExpandedWidth = '';
@@ -166,19 +173,34 @@ class AdminSidebar extends UIElement {
   // ── Resize drag handle ──
 
   #setupResizeHandle() {
-    const handle = this.querySelector(':scope > [data-resize]');
+    // Rename-wave compat (plan-090 W1): `[data-sidebar-resize]` is the
+    // current name; `[data-resize]` still dual-reads until the 0.9.0 cut
+    // (W3), warning once per element when it's the name that resolved.
+    let handle = this.querySelector(':scope > [data-sidebar-resize]');
+    if (!handle) {
+      handle = this.querySelector(':scope > [data-resize]');
+      if (handle && !AdminSidebar.#warnedOldResizeName.has(this)) {
+        AdminSidebar.#warnedOldResizeName.add(this);
+        // eslint-disable-next-line no-console
+        console.warn(
+          '[admin-sidebar] `[data-resize]` is deprecated and removed in ' +
+          '0.9.0 — rename the drag-handle child to `[data-sidebar-resize]`.',
+          this,
+        );
+      }
+    }
     if (!handle) {
       // FEEDBACK-17: `resizable` opts in to drag-resize but relies on an
-      // author-supplied `[data-resize]` child. A silent return left authors
-      // with a no-op `resizable` attribute and zero diagnostic signal.
+      // author-supplied `[data-sidebar-resize]` child. A silent return left
+      // authors with a no-op `resizable` attribute and zero diagnostic signal.
       if (!AdminSidebar.#warnedNoHandle.has(this)) {
         AdminSidebar.#warnedNoHandle.add(this);
         // eslint-disable-next-line no-console
         console.warn(
-          '[admin-sidebar] `resizable` is set but no `[data-resize]` child ' +
-          'was found. Add `<div data-resize></div>` as a direct child to ' +
-          'enable drag-to-resize. (Unlike `collapsible`, `resizable` requires ' +
-          'this author-supplied handle.)',
+          '[admin-sidebar] `resizable` is set but no `[data-sidebar-resize]` ' +
+          'child was found. Add `<div data-sidebar-resize></div>` as a direct ' +
+          'child to enable drag-to-resize. (Unlike `collapsible`, `resizable` ' +
+          'requires this author-supplied handle.)',
           this,
         );
       }

package/shell/admin-sidebar/admin-sidebar.yaml

@@ -37,7 +37,7 @@ props:
   resizable:
     description: |
       Opts in to drag-to-resize behavior. Author supplies a child
-      [data-resize] element as the drag handle.
+      [data-sidebar-resize] element as the drag handle.
     type: boolean
     default: false
     reflect: true
@@ -105,6 +105,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminShell
   rules:
     - >-
       admin-sidebar is the bespoke replacement for legacy

package/shell/admin-statusbar/admin-statusbar.a2ui.json

@@ -22,6 +22,11 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "AdminShell",
+      "AdminContent",
+      "AdminSidebar"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -35,6 +40,7 @@
       "status-line"
     ],
     "name": "AdminStatusbar",
+    "parts": {},
     "related": [
       "AdminShell",
       "AdminContent",

package/shell/admin-statusbar/admin-statusbar.yaml

@@ -49,6 +49,10 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminShell
+    - AdminContent
+    - AdminSidebar
   rules:
     - >-
       admin-statusbar replaces <footer-ui> at shell-tier. Same slot

package/shell/admin-topbar/admin-topbar.a2ui.json

@@ -22,6 +22,11 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "AdminShell",
+      "AdminContent",
+      "AdminSidebar"
+    ],
     "anti_patterns": [],
     "category": "layout",
     "composes": [],
@@ -35,6 +40,7 @@
       "shell-header"
     ],
     "name": "AdminTopbar",
+    "parts": {},
     "related": [
       "AdminShell",
       "AdminContent",

package/shell/admin-topbar/admin-topbar.yaml

@@ -53,6 +53,10 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - AdminShell
+    - AdminContent
+    - AdminSidebar
   rules:
     - >-
       admin-topbar replaces <header-ui> at shell-tier — use it for

package/shell/embed-shell/embed-shell.a2ui.json

@@ -54,6 +54,7 @@
       "app-shell"
     ],
     "name": "EmbedShell",
+    "parts": {},
     "related": [
       "AdminShell",
       "Frame",

package/simple/simple-content/simple-content.a2ui.json

@@ -22,6 +22,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "SimpleShell"
+    ],
     "anti_patterns": [],
     "category": "shells",
     "composes": [],
@@ -37,6 +40,7 @@
       "marketing-body"
     ],
     "name": "SimpleContent",
+    "parts": {},
     "related": [
       "SimpleShell",
       "SimpleHero"

package/simple/simple-content/simple-content.yaml

@@ -33,6 +33,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - SimpleShell
   rules:
     - >-
       simple-content is the article surface inside simple-shell. Use

package/simple/simple-hero/simple-hero.a2ui.json

@@ -22,6 +22,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "SimpleShell"
+    ],
     "anti_patterns": [],
     "category": "shells",
     "composes": [],
@@ -37,6 +40,7 @@
       "page-title"
     ],
     "name": "SimpleHero",
+    "parts": {},
     "related": [
       "SimpleShell",
       "SimpleContent"

package/simple/simple-hero/simple-hero.yaml

@@ -35,6 +35,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - SimpleShell
   rules:
     - >-
       simple-hero is the optional top strip inside simple-shell. Use

package/simple/simple-shell/simple-shell.a2ui.json

@@ -32,6 +32,9 @@
   ],
   "unevaluatedProperties": false,
   "x-adiaui": {
+    "allowedParents": [
+      "Surface"
+    ],
     "anti_patterns": [],
     "category": "shells",
     "composes": [],
@@ -47,6 +50,7 @@
       "minimal-shell"
     ],
     "name": "SimpleShell",
+    "parts": {},
     "related": [
       "SimpleHero",
       "SimpleContent",

package/simple/simple-shell/simple-shell.yaml

@@ -50,6 +50,8 @@ states:
 traits: []
 
 a2ui:
+  allowedParents:
+    - Surface
   rules:
     - >-
       simple-shell is the bespoke shell for thin / minimal page surfaces.

package/theme/theme-panel/theme-panel.a2ui.json

@@ -141,6 +141,7 @@
       "skin"
     ],
     "name": "ThemePanel",
+    "parts": {},
     "related": [
       "Popover",
       "Button",