@adia-ai/web-modules 0.6.7 → 0.6.8

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.6.8] — 2026-05-20
+
+### Fixed
+- **`chat/chat-shell/chat-shell.js` — monorepo-absolute import broke the full barrel (claims-ui F-001, P0).** A single line at `chat-shell.js:4` imported `'/packages/web-components/components/code/code.js'`. The leading-`/` form resolves inside the AdiaUI monorepo (Vite roots at workspace) but breaks the full `@adia-ai/web-modules` barrel for every npm consumer with `Module not found`. Every sibling file in `web-modules/` (10 hits across chat/editor/theme/shell) used the correct `../../../web-components/...` relative form; this one line was the outlier and shipped across multiple releases. Fix: 1-char rewrite to the sibling pattern. Consumers using only the per-cluster subpaths (`@adia-ai/web-modules/shell`, `/chat`, `/editor`) were not affected; this fix restores the full-barrel `import '@adia-ai/web-modules'` entry point.
+
+### Docs
+- **README.md — ⚠️ Required CSS callouts (claims-ui F-006).** Added prominent warnings above the §Import: CSS and §Quick start sections naming the four shell tags (`admin-shell`, `chat-shell`, `editor-shell`, `simple-shell`) and describing the unstyled-stacked-divs failure mode that follows from forgetting the per-cluster CSS import. The CSS imports were already listed in both sections, but at the same volume as the JS imports — these callouts shift signal weight, not content. Paired with the new skill §CSSPolicy section (skill v2.4.2) which codifies the normative explicit-CSS-import policy uniformly across primitives + shells.
+
 ## [0.6.7] — 2026-05-19
 
 ### Added

package/README.md

@@ -35,6 +35,16 @@ import '@adia-ai/web-modules/runtime';           // gen-root + a2ui-root
 
 ## Import: CSS (since v0.4.5)
 
+> ⚠️ **Required — shell layouts depend on this CSS.** Shell JS modules
+> (`admin-shell`, `chat-shell`, `editor-shell`, `simple-shell`) do **not**
+> self-import their layout CSS. Omitting the matching `*.css` import for
+> any shell you use renders that shell as **unstyled stacked `<div>`
+> elements** with no console error — sidebars stack above content,
+> topbar/statusbar fall off the viewport grid, nothing throws. This is
+> the #1 cold-start silent-failure mode reported by external consumers.
+> If your shell looks like a vertical list of blocks, you missed a line
+> below.
+
 CSS imports use the package specifier — the package's `exports` map resolves `.css` requests to the per-element stylesheet on disk:
 
 ```js
@@ -77,6 +87,10 @@ See [`bespoke-shell-children` skill](../../.agents/skills/bespoke-shell-children
 
 ESM-only — bundlers (Vite, esbuild, webpack 5+, Rollup) resolve `import` statements for both `.js` and `.css`; in plain HTML, use `<script type="module">` for JS and `<link>` for CSS.
 
+> ⚠️ **Both JS AND CSS imports are required per cluster.** Importing only
+> the JS gives you registered tags but no layout. See [Import: CSS](#import-css-since-v045)
+> above for the failure mode.
+
 ```js
 // JS — register every primitive + the clusters you compose with
 import '@adia-ai/web-components';        // primitives + nav family
@@ -86,7 +100,7 @@ import '@adia-ai/web-modules/editor';    // editor-shell + bespoke children
 import '@adia-ai/web-modules/runtime';   // gen-root, a2ui-root (needs @adia-ai/a2ui-runtime)
 import '@adia-ai/web-modules/theme';     // theme-panel (appearance prefs)
 
-// CSS — one stylesheet per cluster you use
+// CSS — one stylesheet per cluster you use (REQUIRED — see callout above)
 import '@adia-ai/web-components/css';              // every primitive's CSS
 import '@adia-ai/web-modules/shell/admin-shell.css';
 import '@adia-ai/web-modules/chat/chat-shell.css';

package/chat/chat-shell/chat-shell.js

@@ -1,7 +1,7 @@
 import { UIElement } from '../../../web-components/core/element.js';
 import { renderMarkdown } from '../../../web-components/core/markdown.js';
 import { streamChat } from '../../../llm/index.js';
-import '/packages/web-components/components/code/code.js';
+import '../../../web-components/components/code/code.js';
 
 function escapeHTML(s) {
   return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-modules",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "AdiaUI composite custom elements \u2014 shell, chat, editor, runtime clusters built from @adia-ai/web-components primitives. Subpath exports per cluster.",
   "type": "module",
   "exports": {