@adia-ai/web-modules 0.6.7 → 0.6.9

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.6.9] — 2026-05-21
+
+### Documentation
+- **`README.md` — new "Cross-package convenience subpaths" subsection.** Documents the `generative` cross-package subpath (`@adia-ai/web-modules/generative`) that re-exports generative-UI primitives from `@adia-ai/a2ui-runtime`. Surfaces a doc-path that previously required reading the package.json `exports` map to discover. Closes claims-ui FEEDBACK-08 (`generative` subpath was undocumented; per-cluster Clusters table at `README.md:71-79` already covered the 5 internal clusters but did not list cross-package convenience subpaths).
+
+## [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
@@ -68,6 +78,17 @@ elements with state-as-attribute semantics) per [ADR-0023](../../.brain/adrs/002
 | `runtime` | `<gen-root>`, `<a2ui-root>` | — | Render roots that turn JSON or gen-UI intents into live DOM. |
 | `theme` | — (controls-only) | `<theme-panel>` (JS-bearing); 1 child total | Appearance-preferences control surface — `[data-theme]` named themes, `--a-density` / `--a-radius-k` parametric overrides, `color-scheme` light/dark, opt-in `[persist]`. Drops into any consumer's `<popover-ui slot="content">` topbar. Spec: [`docs/specs/theme-panel-module.md`](../../docs/specs/theme-panel-module.md). |
 
+### Cross-package convenience subpaths
+
+`generative` is not a web-modules cluster — it's a convenience barrel
+that pulls in two `@adia-ai/web-components` primitives needed by every
+generative-UI surface. Subpath listed here so consumers don't have to
+hunt for it:
+
+| Subpath | Registers | Notes |
+|---|---|---|
+| `@adia-ai/web-modules/generative` | `<canvas-ui>`, `<a2ui-root>` | Cross-package — these live in `@adia-ai/web-components` but compose so frequently for generative UI that we ship the registration barrel here. Per ADR-0027, primitives that compose cross-package are not in the default catalog barrel; `generative` is the explicit opt-in. |
+
 Future clusters on the strategic horizon: `data` (kanban, filters,
 table-toolbar), `agent` (agent-trace, reasoning panels).
 
@@ -77,6 +98,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 +111,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.9",
   "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": {