@adia-ai/web-modules 0.7.12 → 0.7.13

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.7.13] — 2026-06-06
+
+### Fixed
+- **`./css/sheet` subpath export now resolves TS types.** Same fix as `@adia-ai/web-components` — added `web-modules.sheet.d.ts` + the `types` condition + the `.d.ts` to `files[]`.
+
+### Added
+- **`<embed-shell>` `/with-css` companion** (ADR-0030) — `import '@adia-ai/web-modules/shell/embed-shell/with-css'` registers the element + mounts its CSS in one line; completes the 5-shell `/with-css` family (was the lone shell missing it). (check:with-css-pairing.)
+
+### Docs
+- README CDN snippets refreshed: `@0.6` → `@0.7`.
+
 ## [0.7.12] — 2026-06-04
 
 ### Changed
@@ -967,7 +978,7 @@ import '@adia-ai/web-modules/theme/theme-panel.css';
 "./theme/*.css": "./theme/*/*.css"
 ```
 
-The pattern key `./<cluster>/*.css` captures the element name; the value's two `*` are both substituted with the captured name, resolving `<cluster>/<elem>.css` requests to `<cluster>/<elem>/<elem>.css` on disk. Existing JS subpath exports (`./<cluster>/*` → `./<cluster>/*/*.js`) are preserved unchanged — both can coexist because `.css` requests don't collide with bare-name `.js` requests. Driven by [consumer feedback](/Users/kimba/Projects/adia/color-app/docs/outbound/FEEDBACK-adia-packages.md) from Design Tokens Studio (claim #6, the only fully-correct item in their 8-claim audit).
+The pattern key `./<cluster>/*.css` captures the element name; the value's two `*` are both substituted with the captured name, resolving `<cluster>/<elem>.css` requests to `<cluster>/<elem>/<elem>.css` on disk. Existing JS subpath exports (`./<cluster>/*` → `./<cluster>/*/*.js`) are preserved unchanged — both can coexist because `.css` requests don't collide with bare-name `.js` requests. Driven by consumer feedback from Design Tokens Studio (claim #6, the only fully-correct item in their 8-claim audit).
 
 ### Documentation
 
@@ -978,7 +989,7 @@ The pattern key `./<cluster>/*.css` captures the element name; the value's two `
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.4` (14 yaml gap closures from corpus simplification arc), `@adia-ai/a2ui-runtime@0.4.4` (registry expansion +27 web-modules + renderer kebab-case fix), `@adia-ai/a2ui-compose@0.4.4` (composition-library rename + transpiler `<a>` → Link), `@adia-ai/a2ui-corpus@0.4.4` (corpus simplification arc §36–§51), `@adia-ai/a2ui-mcp@0.4.4` (`get_fragment` tool retirement). Source byte-identical to v0.4.3.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.4]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.4]`](../../CHANGELOG.md) for the cut narrative.
 ## [0.4.3] - 2026-05-11
 
 ### Documentation
@@ -1129,7 +1140,7 @@ Legacy authoring shapes (`<section data-chat-messages>`, `<chat-input-ui data-ch
 Legacy authoring shapes (`<aside data-sidebar="leading">`, `<dialog data-command>`, `<div data-resize>`, `[data-sidebar-toggle]`, `<aside-ui slot="leading">`) all still work identically. Mixed markup (some bespoke, some legacy) renders the same. Migration is opt-in.
 ## [0.3.3] - 2026-05-07
 
-**Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy).
+**Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`docs/specs/package-architecture.md` § 15](../../docs/specs/package-architecture.md#15-versioning-policy).
 
 ### Changed
 
@@ -1142,7 +1153,7 @@ Legacy authoring shapes (`<aside data-sidebar="leading">`, `<dialog data-command
 ## [0.3.2] - 2026-05-06
 
 **9-package lockstep patch cut to v0.3.2.** All lockstep members share
-one version per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy).
+one version per [`docs/specs/package-architecture.md` § 15](../../docs/specs/package-architecture.md#15-versioning-policy).
 Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 
 ### No source changes
@@ -1226,7 +1237,7 @@ _Nothing yet._
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages bump
 0.2.2 → 0.2.3 per
-[`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy).
+[`docs/specs/package-architecture.md` § 15](../../docs/specs/package-architecture.md#15-versioning-policy).
 Patch cut — no breaking changes.
 
 ### Changed

package/README.md

@@ -19,11 +19,11 @@ Since **v0.6.30**, both this package and `@adia-ai/web-components` ship pre-flat
 
 ```html
 <!-- CSS: all primitives + the shell tier you use -->
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.6/dist/web-components.min.css">
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/shell/admin-shell.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.7/dist/web-components.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/shell/admin-shell.min.css">
 
 <!-- JS: everything in one bundle (primitives + all 4 shells + a2ui-runtime; ~190 KB gzipped) -->
-<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/everything.min.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/everything.min.js"></script>
 
 <admin-shell mode="rounded borderless">
   <admin-sidebar slot="leading" resizable collapsible>
@@ -81,8 +81,8 @@ Since **v0.6.30**, both this package and `@adia-ai/web-components` ship pre-flat
 **Per-shell setup (advanced — only one shell tier loaded):**
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.6/dist/web-components.min.js"></script>
-<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/shell/admin-shell.min.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-components@0.7/dist/web-components.min.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/shell/admin-shell.min.js"></script>
 ```
 
 | Bundle | Path | Gzipped | Contents | When to use |
@@ -96,13 +96,13 @@ Since **v0.6.30**, both this package and `@adia-ai/web-components` ship pre-flat
 **Each shell needs its matching CSS** (the kitchen-sink example above loads only `admin-shell.min.css`). Mirror the JS path — swap the shell tier:
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/shell/admin-shell.min.css">
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/chat/chat-shell.min.css">
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/editor/editor-shell.min.css">
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.6/dist/simple/simple-shell.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/shell/admin-shell.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/chat/chat-shell.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/editor/editor-shell.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@adia-ai/web-modules@0.7/dist/simple/simple-shell.min.css">
 ```
 
-The `@0.6` range tracks the latest `0.6.x` patch (won't jump to a breaking `0.7`); pin an exact version (e.g. `@0.6.45`) for reproducible builds.
+The `@0.7` range tracks the latest `0.6.x` patch (won't jump to a breaking `0.8`); pin an exact version (e.g. `@0.7.13`) for reproducible builds.
 
 **Pick ONE bundle path.** Mixing `everything.min.js` with a separate `web-components.min.js` causes `customElements.define` to throw "name already defined". For CodePen the kitchen-sink path is correct.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-modules",
-  "version": "0.7.12",
+  "version": "0.7.13",
   "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": {
@@ -14,6 +14,7 @@
       "default": "./dist/web-modules.min.css"
     },
     "./css/sheet": {
+      "types": "./web-modules.sheet.d.ts",
       "import": "./dist/web-modules.sheet.js",
       "default": "./dist/web-modules.sheet.js"
     },
@@ -260,6 +261,7 @@
     "!generative/**/*.html",
     "index.js",
     "css-module.d.ts",
+    "web-modules.sheet.d.ts",
     "README.md",
     "CHANGELOG.md"
   ],

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

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for `embed-shell/with-css` — opt-in CSS-bundled companion.
+ *
+ * Side-effect-only module. Importing this registers the `<embed-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 './embed-shell.js';

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

@@ -0,0 +1,19 @@
+/**
+ * Opt-in `/with-css` companion for <embed-shell>.
+ *
+ * Side-effect-only module. Importing this:
+ *   1. Loads `./embed-shell.js` (registers the `<embed-shell>` custom element)
+ *   2. Side-effect-imports `./embed-shell.css` (mounts the shell's layout CSS)
+ *
+ * Consumer-facing entry point:
+ *   import '@adia-ai/web-modules/shell/embed-shell/with-css';
+ *
+ * This is the explicit CSS-policy carve-out documented in ADR-0030. The
+ * default subpath (`@adia-ai/web-modules/shell/embed-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 './embed-shell.js';
+import './embed-shell.css';

package/web-modules.sheet.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Type declarations for the `@adia-ai/web-modules/css/sheet` subpath — the
+ * constructable-`CSSStyleSheet` twin of `web-modules.min.css` (byte-identical to the
+ * CDN bundle), adopted via `document.adoptedStyleSheets`.
+ */
+export function constructSheet(): CSSStyleSheet | null;
+export default constructSheet;