@adia-ai/web-modules 0.6.21 → 0.6.22

package/shell/admin-shell/css/admin-shell.templates.css

@@ -182,13 +182,24 @@ admin-page-body > iframe {
   }
 }
 
-/* Tighten the content gutter when the article is genuinely narrow. */
+/* Tighten the content gutter at medium width (tablet / narrow desktop). */
+@container page-content (max-width: 768px) {
+  admin-page-header > :is(header, header-ui),
+  admin-page-body > :is(section, section-ui) {
+    padding-inline: var(--a-space-8);
+  }
+  admin-page-body > :is(section, section-ui) {
+    padding-block: var(--a-space-8);
+  }
+}
+
+/* Tighten further when the article is genuinely narrow (phone). */
 @container page-content (max-width: 480px) {
   admin-page-header > :is(header, header-ui),
   admin-page-body > :is(section, section-ui) {
-    padding-inline: var(--a-space-4);
+    padding-inline: var(--a-space-6);
   }
   admin-page-body > :is(section, section-ui) {
-    padding-block: var(--a-space-4);
+    padding-block: var(--a-space-6);
   }
 }

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/AdminSidebar.json",
   "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",
+  "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 per ADR-0023. The legacy shape was\nretired in v0.4.0 per ADR-0024 and is no longer recognized.\n",
   "type": "object",
   "allOf": [
     {

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

@@ -5,9 +5,8 @@ slot="leading" or slot="trailing". Authors compose chrome bars + content
 inside via slot vocabulary.
 
 This is the bespoke web-component replacement for the legacy
-<aside data-sidebar> shape. <admin-shell> still recognizes the legacy
-shape via :is() selector for backwards compat. New code should prefer
-<admin-sidebar>.
+<aside data-sidebar> shape per ADR-0023. The legacy shape was
+retired in v0.4.0 per ADR-0024 and is no longer recognized.
 
  *
  * @see https://ui-kit.exe.xyz/site/components/admin-sidebar

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

@@ -12,9 +12,8 @@ description: |
   inside via slot vocabulary.
 
   This is the bespoke web-component replacement for the legacy
-  <aside data-sidebar> shape. <admin-shell> still recognizes the legacy
-  shape via :is() selector for backwards compat. New code should prefer
-  <admin-sidebar>.
+  <aside data-sidebar> shape per ADR-0023. The legacy shape was
+  retired in v0.4.0 per ADR-0024 and is no longer recognized.
 
 props:
   collapsed:
@@ -115,6 +114,10 @@ a2ui:
       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.
+    - rule: '[resizable] attribute enables drag-resize via internal <pane-ui resizable>; persists collapsed/width to localStorage under adia-sidebar-* keys.'
+      reason: 'Resize + persistence behavior.'
+    - rule: 'For non-resizable static rails (fixed-width nav), omit [resizable]; the same primitive serves both modes.'
+      reason: 'Single primitive, two modes.'
 
 keywords:
   - admin-sidebar

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/AdminStatusbar.json",
   "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",
+  "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 per ADR-0023. The\nlegacy shape was retired in v0.4.0 per ADR-0024 and is no longer\nrecognized; new code uses <admin-statusbar> for shell-tier chrome\n(use <footer-ui> for primitive containers like Card / Drawer /\nModal).\n",
   "type": "object",
   "allOf": [
     {

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

@@ -11,8 +11,11 @@ description: |
   clusters via slot vocabulary), conventionally used for read-only
   status — connection state, sync indicator, footer metadata.
 
-  Replaces legacy <footer-ui> usage at shell-tier. Both still work per
-  ADR-0023 backwards-compat.
+  Replaces legacy <footer-ui> usage at shell-tier per ADR-0023. The
+  legacy shape was retired in v0.4.0 per ADR-0024 and is no longer
+  recognized; new code uses <admin-statusbar> for shell-tier chrome
+  (use <footer-ui> for primitive containers like Card / Drawer /
+  Modal).
 
 props: {}
 
@@ -55,6 +58,10 @@ a2ui:
       <admin-entity-item slot="heading"> rather than separate slot="icon" +
       slot="heading" children — the wrapper collapses the name + badge
       together inside a collapsible <admin-sidebar>, keeping the avatar.
+    - rule: 'All slots optional; common pattern is [slot="heading"] + [slot="action"] only. Empty admin-statusbar renders zero-height (no visual chrome).'
+      reason: 'Cardinality — fully optional content.'
+    - rule: 'Sits at slot="footer" of <admin-shell>, <admin-content>, or <admin-sidebar>; do not place inside <admin-page slot="footer"> (use raw <footer-ui> there).'
+      reason: 'Shell-tier vs page-tier boundary.'
 
 keywords:
   - admin-statusbar

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/AdminTopbar.json",
   "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",
+  "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 per ADR-0023.\nThe legacy shape was retired in v0.4.0 per ADR-0024 and is no\nlonger recognized; new code uses <admin-topbar> for shell-tier\nchrome bars (use <header-ui> for primitive containers like Card /\nDrawer / Modal).\n",
   "type": "object",
   "allOf": [
     {

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

@@ -11,10 +11,11 @@ description: |
   region. Provides the canonical icon + heading + description +
   action-clusters layout via slot vocabulary.
 
-  Replaces the legacy <header-ui> usage at shell-tier. Both still work
-  per ADR-0023 backwards-compat; new code should prefer <admin-topbar>
-  for shell-tier chrome bars (use <header-ui> for primitive containers
-  like Card / Drawer / Modal).
+  Replaces the legacy <header-ui> usage at shell-tier per ADR-0023.
+  The legacy shape was retired in v0.4.0 per ADR-0024 and is no
+  longer recognized; new code uses <admin-topbar> for shell-tier
+  chrome bars (use <header-ui> for primitive containers like Card /
+  Drawer / Modal).
 
 props: {}
 
@@ -62,6 +63,10 @@ a2ui:
       rather than separate slot="icon" + slot="heading" children. The
       wrapper keeps the icon and label as one unit so they truncate and
       collapse together inside a collapsible <admin-sidebar>.
+    - rule: 'All slots optional; common pattern is [slot="heading"] + [slot="action"] only. Empty admin-topbar renders zero-height (no visual chrome).'
+      reason: 'Cardinality — fully optional content.'
+    - rule: 'Sits at slot="header" of <admin-shell>, <admin-content>, or <admin-sidebar>; do not place inside <admin-page slot="header"> (use <admin-page-header> there).'
+      reason: 'Shell-tier vs page-tier boundary.'
 
 keywords:
   - admin-topbar

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

@@ -36,6 +36,10 @@ a2ui:
     - >-
       simple-content is the article surface inside simple-shell. Use
       for primary page body. Sibling to <simple-hero> (optional).
+    - rule: 'CSS-only — do not import its JS module (there isn''t one); does not need an `import` in shell HTML.'
+      reason: 'CSS-only primitives don''t need JS-side registration.'
+    - rule: 'For multi-page apps with chrome (nav, topbar, command palette) use <admin-shell-ui> with <admin-content> instead.'
+      reason: 'Surface decision rule — simple vs admin.'
 
 keywords:
   - simple-content

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

@@ -39,6 +39,10 @@ a2ui:
       simple-hero is the optional top strip inside simple-shell. Use
       for marketing splashes, error-page reassurance text, or single-
       flow page intros. Always followed by <simple-content> for body.
+    - rule: 'Three named slots: heading (large title), lede (supporting subtitle), actions (button cluster). All optional but order is fixed.'
+      reason: 'Slot contract.'
+    - rule: 'CSS-only — sibling to <simple-content> inside <simple-shell>. Do not nest hero inside content or vice versa.'
+      reason: 'Composition discipline.'
 
 keywords:
   - simple-hero

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

@@ -59,6 +59,10 @@ a2ui:
       Compose with <simple-hero> (optional top hero strip) and
       <simple-content> (main article body). Both are CSS-only structural
       children — no JS, no state.
+    - rule: '[centered] reflected attribute centers content vertically; [full-bleed] drops the max-width constraint on <simple-content> children. Both optional, default unset.'
+      reason: 'Layout-mode knobs.'
+    - rule: 'For multi-page apps with chrome (nav, topbar, command palette) use <admin-shell> instead; simple-shell has zero chrome.'
+      reason: 'Simple vs admin decision rule.'
 
 keywords:
   - simple-shell