@adia-ai/web-modules 0.6.8 → 0.6.10

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.6.10] — 2026-05-21
+
+### Added
+- **4 shell `/with-css` opt-in companion subpaths (claims-ui FB-06 closure, P0 UX).** Closes the cold-start UX cliff originally surfaced by claims-ui FEEDBACK-06 (consumer imports `<admin-shell>` JS, forgets the matching CSS import, sees unstyled stacked `<div>` elements with no error). The CSS-policy review at `.brain/notes/claims-ui-css-policy-answer-2026-05-20.md` confirmed the explicit-import contract is correct AS A DEFAULT (preserves tree-shake, gives cascade control + theme layering, predictable across Vite versions); this slice ships the named carve-out. Consumer-facing API (new — v0.6.10):
+  ```js
+  // Default subpath — unchanged (explicit-import contract; tree-shake friendly)
+  import '@adia-ai/web-modules/shell/admin-shell';
+  import '@adia-ai/web-modules/shell/admin-shell.css';
+
+  // Opt-in /with-css companion — one import, JS + CSS bundled
+  import '@adia-ai/web-modules/shell/admin-shell/with-css';
+  ```
+  Available for all 4 shells: `shell/admin-shell`, `chat/chat-shell`, `editor/editor-shell`, `simple/simple-shell`. Each `with-css.js` module is a 2-import side-effect-only file (`import './<shell>.js'; import './<shell>.css';`). Exports map gains 4 new cluster-specific subpath patterns (`./shell/*/with-css`, `./chat/*/with-css`, `./editor/*/with-css`, `./simple/*/with-css`) — each with `types` / `import` / `default` conditions, so TypeScript consumers get parity-typing across both forms. Paired CI gate `check:with-css-pairing` (regression block at PR time): every shell with paired `.js` + `.css` must have a canonical 2-import `with-css.js` companion AND a matching exports-map entry. Architectural rationale: ADR-0030 (`.brain/adrs/0030-shell-with-css-opt-in-carve-out.md`) — single named carve-out, default policy intact, no behavior change for existing consumers. Skill v2.7.0 ride-along documents the opt-in form in §CSSPolicy + §Setup.
+
+## [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

package/README.md

@@ -78,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).
 

package/chat/chat-shell/with-css.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for `chat-shell/with-css` — opt-in CSS-bundled companion.
+ *
+ * Side-effect-only module. Importing this registers the `<chat-shell>`
+ * custom element AND side-effect-imports its layout CSS.
+ *
+ * Per ADR-0030 (shell `/with-css` opt-in carve-out, v0.6.10). The
+ * canonical class type is re-exported here so consumers using the
+ * `/with-css` companion don't lose typing parity with the default
+ * subpath.
+ */
+
+export * from './chat-shell.js';

package/chat/chat-shell/with-css.js

@@ -0,0 +1,16 @@
+/**
+ * Opt-in `/with-css` companion for <chat-shell>.
+ *
+ * Side-effect-only module. Importing this:
+ *   1. Loads `./chat-shell.js` (registers the `<chat-shell>` custom element)
+ *   2. Side-effect-imports `./chat-shell.css` (mounts the shell's layout CSS)
+ *
+ * Consumer-facing entry point:
+ *   import '@adia-ai/web-modules/chat/chat-shell/with-css';
+ *
+ * Explicit CSS-policy carve-out per ADR-0030. See sibling file
+ * `packages/web-modules/shell/admin-shell/with-css.js` for the full
+ * rationale.
+ */
+import './chat-shell.js';
+import './chat-shell.css';

package/editor/editor-shell/with-css.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for `editor-shell/with-css` — opt-in CSS-bundled companion.
+ *
+ * Side-effect-only module. Importing this registers the `<editor-shell>`
+ * custom element AND side-effect-imports its layout CSS.
+ *
+ * Per ADR-0030 (shell `/with-css` opt-in carve-out, v0.6.10). The
+ * canonical class type is re-exported here so consumers using the
+ * `/with-css` companion don't lose typing parity with the default
+ * subpath.
+ */
+
+export * from './editor-shell.js';

package/editor/editor-shell/with-css.js

@@ -0,0 +1,16 @@
+/**
+ * Opt-in `/with-css` companion for <editor-shell>.
+ *
+ * Side-effect-only module. Importing this:
+ *   1. Loads `./editor-shell.js` (registers the `<editor-shell>` custom element)
+ *   2. Side-effect-imports `./editor-shell.css` (mounts the shell's layout CSS)
+ *
+ * Consumer-facing entry point:
+ *   import '@adia-ai/web-modules/editor/editor-shell/with-css';
+ *
+ * Explicit CSS-policy carve-out per ADR-0030. See sibling file
+ * `packages/web-modules/shell/admin-shell/with-css.js` for the full
+ * rationale.
+ */
+import './editor-shell.js';
+import './editor-shell.css';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-modules",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "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": {
@@ -19,6 +19,11 @@
       "import": "./shell/*/*.js",
       "default": "./shell/*/*.js"
     },
+    "./shell/*/with-css": {
+      "types": "./shell/*/with-css.d.ts",
+      "import": "./shell/*/with-css.js",
+      "default": "./shell/*/with-css.js"
+    },
     "./shell/*.css": "./shell/*/*.css",
     "./shell/*/*.css": "./shell/*/*.css",
     "./shell/*/css/*.css": "./shell/*/css/*.css",
@@ -32,6 +37,11 @@
       "import": "./chat/*/*.js",
       "default": "./chat/*/*.js"
     },
+    "./chat/*/with-css": {
+      "types": "./chat/*/with-css.d.ts",
+      "import": "./chat/*/with-css.js",
+      "default": "./chat/*/with-css.js"
+    },
     "./chat/*.css": "./chat/*/*.css",
     "./chat/*/*.css": "./chat/*/*.css",
     "./chat/*/css/*.css": "./chat/*/css/*.css",
@@ -50,6 +60,11 @@
       "import": "./editor/*/*.js",
       "default": "./editor/*/*.js"
     },
+    "./editor/*/with-css": {
+      "types": "./editor/*/with-css.d.ts",
+      "import": "./editor/*/with-css.js",
+      "default": "./editor/*/with-css.js"
+    },
     "./editor/*.css": "./editor/*/*.css",
     "./editor/*/*.css": "./editor/*/*.css",
     "./editor/*/css/*.css": "./editor/*/css/*.css",
@@ -63,6 +78,11 @@
       "import": "./simple/*/*.js",
       "default": "./simple/*/*.js"
     },
+    "./simple/*/with-css": {
+      "types": "./simple/*/with-css.d.ts",
+      "import": "./simple/*/with-css.js",
+      "default": "./simple/*/with-css.js"
+    },
     "./simple/*.css": "./simple/*/*.css",
     "./simple/*/*.css": "./simple/*/*.css",
     "./simple/*/css/*.css": "./simple/*/css/*.css",

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

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for `admin-shell/with-css` — opt-in CSS-bundled companion.
+ *
+ * Side-effect-only module. Importing this registers the `<admin-shell>`
+ * custom element AND side-effect-imports its layout CSS.
+ *
+ * Per ADR-0030 (shell `/with-css` opt-in carve-out, v0.6.10). The
+ * canonical class type is re-exported here so consumers using the
+ * `/with-css` companion don't lose typing parity with the default
+ * subpath.
+ */
+
+export * from './admin-shell.js';

package/shell/admin-shell/with-css.js

@@ -0,0 +1,19 @@
+/**
+ * Opt-in `/with-css` companion for <admin-shell>.
+ *
+ * Side-effect-only module. Importing this:
+ *   1. Loads `./admin-shell.js` (registers the `<admin-shell>` custom element)
+ *   2. Side-effect-imports `./admin-shell.css` (mounts the shell's layout CSS)
+ *
+ * Consumer-facing entry point:
+ *   import '@adia-ai/web-modules/shell/admin-shell/with-css';
+ *
+ * This is the explicit CSS-policy carve-out documented in ADR-0030. The
+ * default subpath (`@adia-ai/web-modules/shell/admin-shell`) preserves
+ * the explicit-import contract; this `/with-css` companion is the named
+ * opt-in for consumers who prefer one-line cold-start over tree-shake.
+ *
+ * Pairs verified at CI by `scripts/release/check-with-css-pairing.mjs`.
+ */
+import './admin-shell.js';
+import './admin-shell.css';

package/simple/simple-shell/with-css.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for `simple-shell/with-css` — opt-in CSS-bundled companion.
+ *
+ * Side-effect-only module. Importing this registers the `<simple-shell>`
+ * custom element AND side-effect-imports its layout CSS.
+ *
+ * Per ADR-0030 (shell `/with-css` opt-in carve-out, v0.6.10). The
+ * canonical class type is re-exported here so consumers using the
+ * `/with-css` companion don't lose typing parity with the default
+ * subpath.
+ */
+
+export * from './simple-shell.js';

package/simple/simple-shell/with-css.js

@@ -0,0 +1,16 @@
+/**
+ * Opt-in `/with-css` companion for <simple-shell>.
+ *
+ * Side-effect-only module. Importing this:
+ *   1. Loads `./simple-shell.js` (registers the `<simple-shell>` custom element)
+ *   2. Side-effect-imports `./simple-shell.css` (mounts the shell's layout CSS)
+ *
+ * Consumer-facing entry point:
+ *   import '@adia-ai/web-modules/simple/simple-shell/with-css';
+ *
+ * Explicit CSS-policy carve-out per ADR-0030. See sibling file
+ * `packages/web-modules/shell/admin-shell/with-css.js` for the full
+ * rationale.
+ */
+import './simple-shell.js';
+import './simple-shell.css';