@adia-ai/web-modules 0.6.30 → 0.6.32

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.6.32] — 2026-05-23
+
+### Fixed (P0) — `[data-col]` / `[data-row]` / `[data-grid]` global CSS collision closed
+
+- **`admin-shell.helpers.css`** — five bare attribute selectors (`[data-col]`, `[data-row]`,
+  `[data-grid]`, `[data-actions]`, `[data-spacer]`) were global in the published CSS,
+  matching ANY element on pages that loaded `admin-shell.min.css`. In Safari/WebKit,
+  `display: flex` forced on `<th data-col="…">` table headers broke the table formatting
+  context (thead rendered as a left sidebar; tbody rendered to its right). The selectors
+  are now prefixed with `admin-shell` so they only apply inside `<admin-shell>` descendants.
+  `@scope` was not viable — the admin-shell build pipeline emits 0 `@scope` blocks.
+  File: `shell/admin-shell/css/admin-shell.helpers.css`.
+
+### Fixed (P0) — `everything.min.js` CDN bundle now registers all 95+ primitives; `dist/` bundles rebuilt
+
+- **`packages/web-modules/everything.js`** — new CDN entry point that imports
+  `@adia-ai/web-components` first (registers all primitives via `defineIfFree`) then
+  re-exports all shell clusters. Previously `everything.min.js` was built from
+  `index.js` (shells-only); primitives like `search-ui`, `select-ui`, `field-ui` were
+  never registered, causing a hard `TypeError` crash on any primitive `.value` access.
+  `everything.min.js` now 1.04 MB (+316 KB = primitives). Filed as FB-51.
+  File: `packages/web-modules/everything.js`.
+- **`dist/everything.min.js`** and **`dist/shell/admin-shell.min.css`** rebuilt to pick up the
+  CSS helpers scoping fix and the new primitives entry point. Files: `dist/everything.min.js`,
+  `dist/shell/admin-shell.min.css`, `dist/shell/admin-shell.min.js`.
+
+### Documentation — anatomy sections added to `chat/`, `editor/`, `runtime/`, `simple/`, `theme/` example pages
+
+- Example pages across all web-modules clusters were updated with canonical `data-property`
+  vocabulary sections (slots, keyboard, css-vars, a2ui, related) by `scripts/docs/anatomy-sweep.mjs`.
+  Files: `chat/**/*.examples.html`, `editor/**/*.examples.html`, `runtime/**/*.examples.html`,
+  `simple/**/*.examples.html`, `theme/**/*.examples.html`.
+
+## [0.6.31] — 2026-05-23
+
+### Fixed — `admin-shell.examples` taming CSS inlined (docs site render fix)
+
+- **`shell/admin-shell/admin-shell.examples.html`** — the docs router at `/site/components/admin-shell` loads this `.examples.html` directly (via `template: "doc"` in `site/sitemap.json`); it does NOT load the wrapper `admin-shell.html` with its inline `<style>` block. Net effect: the `.sidebar-gallery`, `.shell-states`, `.ad-switcher`, `.ad-menu`, `.ad-brand-logo` classes were never styled on the docs site, so the demo `<admin-shell>` instances rendered with their default `position:fixed` full-viewport layout — overlapping the docs page chrome. Fix: inline the taming CSS (~110 lines from `admin-shell.html` lines 42-151) into `admin-shell.examples.html` at the top. Matches the precedent set by `editor-shell.examples.html` + `responsive-shell-sidebar.examples.html` which both inline demo-specific CSS. Not tarball-affecting (`!shell/**/*.examples.html` exclusion in `files:`) — docs-surface only, but `ui-kit.exe.xyz/site/components/admin-shell` reflects the fix.
+
+### Documentation — README CDN example uses canonical hierarchy
+
+- **`README.md`** — the CDN "Kitchen-sink one-tag setup" example replaced the broken stub `<admin-sidebar><!-- nav --></admin-sidebar>` with the full canonical hierarchy: `<admin-sidebar slot="leading" resizable collapsible>` containing `<admin-topbar slot="header"><span slot="heading">My App</span></admin-topbar>` + `<section-ui><nav-ui><nav-item-ui icon="…" text="…"/></nav-ui></section-ui>` + `<div data-resize></div>`; `<admin-content>` containing `<admin-topbar>` (breadcrumb) + `<admin-scroll><admin-page><admin-page-header><header><div><h1>+<div data-actions></div></div><p></header></admin-page-header><admin-page-body><button-ui/></admin-page-body></admin-page></admin-scroll></admin-content>`. Trailing HTML comment block teaches the canonical rules inline: `<nav-ui>+<nav-item-ui>` for sidebar nav (NOT `<menu-ui>`), `<admin-topbar slot="header">` inside `<admin-sidebar>`, `<admin-statusbar slot="footer">` inside `<admin-sidebar>`, `<admin-scroll>` wraps `<admin-page>` inside `<admin-content>`, `<admin-page-header>` wraps an inner `<header>` with `<div><h1>+<div data-actions></div></div><p>` (add `data-flush` on `<header>` to drop bottom border). README ships in npm tarball — consumers reading via npmjs.com see the canonical pattern.
+
 ## [0.6.30] — 2026-05-23
 
 ### Added — JS bundles + `./everything` kitchen-sink export (CDN / CodePen)

package/README.md

@@ -26,11 +26,56 @@ Since **v0.6.30**, both this package and `@adia-ai/web-components` ship pre-flat
 <script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6.30/dist/everything.min.js"></script>
 
 <admin-shell mode="rounded borderless">
-  <admin-sidebar><!-- nav --></admin-sidebar>
+  <admin-sidebar slot="leading" resizable collapsible>
+    <admin-topbar slot="header">
+      <span slot="heading">My App</span>
+    </admin-topbar>
+    <section-ui>
+      <nav-ui>
+        <nav-item-ui icon="house" text="Home" selected></nav-item-ui>
+        <nav-item-ui icon="gear" text="Settings"></nav-item-ui>
+      </nav-ui>
+    </section-ui>
+    <div data-resize></div>
+  </admin-sidebar>
   <admin-content>
-    <button-ui variant="primary" text="Click me"></button-ui>
+    <admin-topbar>
+      <breadcrumb-ui><span>Dashboard</span></breadcrumb-ui>
+    </admin-topbar>
+    <admin-scroll>
+      <admin-page>
+        <admin-page-header>
+          <header>
+            <div>
+              <h1>Dashboard</h1>
+              <div data-actions>
+                <button-ui text="Share" variant="outline" size="sm"></button-ui>
+              </div>
+            </div>
+            <p>Welcome back.</p>
+          </header>
+        </admin-page-header>
+        <admin-page-body>
+          <button-ui variant="primary" text="Click me"></button-ui>
+        </admin-page-body>
+      </admin-page>
+    </admin-scroll>
   </admin-content>
 </admin-shell>
+
+<!--
+  Canonical admin-shell hierarchy (matches ui-kit.exe.xyz/site/index.html):
+  - <nav-ui> + <nav-item-ui> is THE primitive pair for sidebar navigation.
+  - <menu-ui> / <menu-item-ui> are for popover action menus (dropdowns), NOT for nav.
+  - <admin-topbar slot="header"> goes inside <admin-sidebar> (workspace switcher / brand).
+  - <admin-statusbar slot="footer"> goes inside <admin-sidebar> (user switcher / sign-in).
+  - <admin-scroll> wraps <admin-page> inside <admin-content>.
+  - <admin-page-header> wraps an inner <header> with <div><h1>+<div data-actions></div></div><p>.
+    The <div data-actions> slot is right-aligned for page-level action buttons.
+    Use <header data-flush> to drop the bottom border.
+  Reference: https://ui-kit.exe.xyz/site/examples/admin-dashboard +
+             https://github.com/adiahealth/gen-ui-kit/blob/main/site/templates/settings.html
+-->
 ```
 
 **Per-shell setup (advanced — only one shell tier loaded):**

package/chat/chat-composer/chat-composer.a2ui.json

@@ -80,6 +80,7 @@
         "name": "disabled"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "composer": [
         "message-input",

package/chat/chat-composer/chat-composer.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatComposer
 tag: chat-composer
+status: stable
 component: ChatComposer
 category: input
 version: 1

package/chat/chat-empty/chat-empty.a2ui.json

@@ -54,6 +54,7 @@
         "name": "hidden"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chat-empty": [
         "empty-state",

package/chat/chat-empty/chat-empty.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatEmpty
 tag: chat-empty
+status: stable
 component: ChatEmpty
 category: feedback
 version: 1

package/chat/chat-header/chat-header.a2ui.json

@@ -63,6 +63,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chat-header": [
         "titlebar",

package/chat/chat-header/chat-header.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatHeader
 tag: chat-header
+status: stable
 component: ChatHeader
 category: layout
 version: 1

package/chat/chat-shell/chat-shell.a2ui.json

@@ -144,6 +144,7 @@
         "name": "streaming"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chat": [
         "conversation",

package/chat/chat-shell/chat-shell.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatShell
 tag: chat-shell
+status: stable
 component: ChatShell
 category: container
 version: 1

package/chat/chat-sidebar/chat-sidebar.a2ui.json

@@ -117,6 +117,7 @@
         "name": "resizing"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "collapsed": [
         "minimized",

package/chat/chat-sidebar/chat-sidebar.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatSidebar
 tag: chat-sidebar
+status: stable
 component: ChatSidebar
 category: layout
 version: 1

package/chat/chat-status/chat-status.a2ui.json

@@ -50,6 +50,7 @@
         "name": "idle"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "chat-status": [
         "connection-indicator",

package/chat/chat-status/chat-status.yaml

@@ -2,6 +2,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatStatus
 tag: chat-status
+status: stable
 component: ChatStatus
 category: feedback
 version: 1

package/chat/chat-thread/chat-thread.a2ui.json

@@ -72,6 +72,7 @@
         "name": "empty"
       }
     ],
+    "status": "stable",
     "synonyms": {
       "message-list": [
         "messages",

package/chat/chat-thread/chat-thread.yaml

@@ -1,6 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
 name: ChatThread
 tag: chat-thread
+status: stable
 component: ChatThread
 category: container
 version: 1