npm - @caelo-cms/shared - Versions diffs - 0.10.22 → 0.10.23 - Mend

@caelo-cms/shared 0.10.22 → 0.10.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (241) hide show

package/dist/ai-tools.d.ts +290 -214
package/dist/ai-tools.d.ts.map +1 -1
package/dist/ai-tools.js +341 -264
package/dist/ai-tools.js.map +1 -1
package/dist/auth-forms.d.ts.map +1 -1
package/dist/auth-forms.js +4 -1
package/dist/auth-forms.js.map +1 -1
package/dist/base-css.d.ts +24 -0
package/dist/base-css.d.ts.map +1 -0
package/dist/base-css.js +28 -0
package/dist/base-css.js.map +1 -0
package/dist/build-page.d.ts +330 -0
package/dist/build-page.d.ts.map +1 -0
package/dist/build-page.js +282 -0
package/dist/build-page.js.map +1 -0
package/dist/content.d.ts +322 -9
package/dist/content.d.ts.map +1 -1
package/dist/content.js +354 -11
package/dist/content.js.map +1 -1
package/dist/css-gradient-scan.d.ts +14 -0
package/dist/css-gradient-scan.d.ts.map +1 -0
package/dist/css-gradient-scan.js +81 -0
package/dist/css-gradient-scan.js.map +1 -0
package/dist/css-var-scan.d.ts +56 -0
package/dist/css-var-scan.d.ts.map +1 -0
package/dist/css-var-scan.js +97 -0
package/dist/css-var-scan.js.map +1 -0
package/dist/design-manifest.d.ts +36 -0
package/dist/design-manifest.d.ts.map +1 -0
package/dist/design-manifest.js +90 -0
package/dist/design-manifest.js.map +1 -0
package/dist/fonts.d.ts +89 -0
package/dist/fonts.d.ts.map +1 -0
package/dist/fonts.js +241 -0
package/dist/fonts.js.map +1 -0
package/dist/genesis-inventory.d.ts +32 -0
package/dist/genesis-inventory.d.ts.map +1 -0
package/dist/genesis-inventory.js +186 -0
package/dist/genesis-inventory.js.map +1 -0
package/dist/genesis.d.ts +62 -0
package/dist/genesis.d.ts.map +1 -0
package/dist/genesis.js +78 -0
package/dist/genesis.js.map +1 -0
package/dist/i18n.d.ts +44 -1
package/dist/i18n.d.ts.map +1 -1
package/dist/i18n.js +72 -6
package/dist/i18n.js.map +1 -1
package/dist/index.d.ts +27 -0
package/dist/index.d.ts.map +1 -1
package/dist/index.js +27 -0
package/dist/index.js.map +1 -1
package/dist/interactions.d.ts +23 -0
package/dist/interactions.d.ts.map +1 -0
package/dist/interactions.js +44 -0
package/dist/interactions.js.map +1 -0
package/dist/media.d.ts +101 -16
package/dist/media.d.ts.map +1 -1
package/dist/media.js +126 -15
package/dist/media.js.map +1 -1
package/dist/page-log.d.ts +94 -0
package/dist/page-log.d.ts.map +1 -0
package/dist/page-log.js +111 -0
package/dist/page-log.js.map +1 -0
package/dist/preview-compose.d.ts +79 -0
package/dist/preview-compose.d.ts.map +1 -1
package/dist/preview-compose.js +155 -25
package/dist/preview-compose.js.map +1 -1
package/dist/proposal-status.d.ts +40 -0
package/dist/proposal-status.d.ts.map +1 -0
package/dist/proposal-status.js +34 -0
package/dist/proposal-status.js.map +1 -0
package/dist/responsive-images.d.ts +64 -0
package/dist/responsive-images.d.ts.map +1 -0
package/dist/responsive-images.js +98 -0
package/dist/responsive-images.js.map +1 -0
package/dist/safe-keys.d.ts +9 -0
package/dist/safe-keys.d.ts.map +1 -0
package/dist/safe-keys.js +20 -0
package/dist/safe-keys.js.map +1 -0
package/dist/seo.d.ts +8 -0
package/dist/seo.d.ts.map +1 -1
package/dist/seo.js +3 -1
package/dist/seo.js.map +1 -1
package/dist/skills.d.ts +14 -68
package/dist/skills.d.ts.map +1 -1
package/dist/skills.js +19 -113
package/dist/skills.js.map +1 -1
package/dist/strip-cdata.d.ts +7 -0
package/dist/strip-cdata.d.ts.map +1 -0
package/dist/strip-cdata.js +48 -0
package/dist/strip-cdata.js.map +1 -0
package/dist/structured-sets.d.ts +6 -16
package/dist/structured-sets.d.ts.map +1 -1
package/dist/structured-sets.js +5 -16
package/dist/structured-sets.js.map +1 -1
package/dist/subagents.d.ts +105 -3
package/dist/subagents.d.ts.map +1 -1
package/dist/subagents.js +224 -41
package/dist/subagents.js.map +1 -1
package/dist/template-engine.d.ts +85 -0
package/dist/template-engine.d.ts.map +1 -0
package/dist/template-engine.js +403 -0
package/dist/template-engine.js.map +1 -0
package/dist/theme-importers/auto-detect.d.ts +26 -0
package/dist/theme-importers/auto-detect.d.ts.map +1 -0
package/dist/theme-importers/auto-detect.js +42 -0
package/dist/theme-importers/auto-detect.js.map +1 -0
package/dist/theme-importers/css-comments.d.ts +12 -0
package/dist/theme-importers/css-comments.d.ts.map +1 -0
package/dist/theme-importers/css-comments.js +15 -0
package/dist/theme-importers/css-comments.js.map +1 -0
package/dist/theme-importers/dtcg.d.ts +46 -0
package/dist/theme-importers/dtcg.d.ts.map +1 -0
package/dist/theme-importers/dtcg.js +111 -0
package/dist/theme-importers/dtcg.js.map +1 -0
package/dist/theme-importers/loose.d.ts +3 -0
package/dist/theme-importers/loose.d.ts.map +1 -0
package/dist/theme-importers/loose.js +76 -0
package/dist/theme-importers/loose.js.map +1 -0
package/dist/theme-importers/shadcn.d.ts +24 -0
package/dist/theme-importers/shadcn.d.ts.map +1 -0
package/dist/theme-importers/shadcn.js +135 -0
package/dist/theme-importers/shadcn.js.map +1 -0
package/dist/theme-importers/style-dictionary.d.ts +17 -0
package/dist/theme-importers/style-dictionary.d.ts.map +1 -0
package/dist/theme-importers/style-dictionary.js +125 -0
package/dist/theme-importers/style-dictionary.js.map +1 -0
package/dist/theme-importers/tailwind.d.ts +3 -0
package/dist/theme-importers/tailwind.d.ts.map +1 -0
package/dist/theme-importers/tailwind.js +218 -0
package/dist/theme-importers/tailwind.js.map +1 -0
package/dist/theme-literal-binding.d.ts +37 -0
package/dist/theme-literal-binding.d.ts.map +1 -0
package/dist/theme-literal-binding.js +138 -0
package/dist/theme-literal-binding.js.map +1 -0
package/dist/theme-normalize.d.ts +31 -0
package/dist/theme-normalize.d.ts.map +1 -0
package/dist/theme-normalize.js +587 -0
package/dist/theme-normalize.js.map +1 -0
package/dist/theme-ramp.d.ts +55 -0
package/dist/theme-ramp.d.ts.map +1 -0
package/dist/theme-ramp.js +149 -0
package/dist/theme-ramp.js.map +1 -0
package/dist/theme-render.d.ts +105 -0
package/dist/theme-render.d.ts.map +1 -0
package/dist/theme-render.js +441 -0
package/dist/theme-render.js.map +1 -0
package/dist/themes-errors.d.ts +109 -0
package/dist/themes-errors.d.ts.map +1 -0
package/dist/themes-errors.js +170 -0
package/dist/themes-errors.js.map +1 -0
package/dist/themes.d.ts +343 -0
package/dist/themes.d.ts.map +1 -0
package/dist/themes.js +697 -0
package/dist/themes.js.map +1 -0
package/dist/version.d.ts +7 -4
package/dist/version.d.ts.map +1 -1
package/dist/version.js +6 -3
package/dist/version.js.map +1 -1
package/package.json +10 -2
package/src/__tests__/redos-hardening.test.ts +160 -0
package/src/ai-tools-add-module-modes.test.ts +106 -0
package/src/ai-tools-position.test.ts +134 -0
package/src/ai-tools.test.ts +81 -0
package/src/ai-tools.ts +1179 -0
package/src/auth-forms.ts +36 -0
package/src/base-css.ts +30 -0
package/src/build-page.test.ts +228 -0
package/src/build-page.ts +319 -0
package/src/cap-failures.ts +67 -0
package/src/content.test.ts +170 -0
package/src/content.ts +620 -0
package/src/context.ts +43 -0
package/src/css-gradient-scan.ts +88 -0
package/src/css-var-scan.test.ts +96 -0
package/src/css-var-scan.ts +144 -0
package/src/derive-module-type.test.ts +80 -0
package/src/design-manifest.ts +93 -0
package/src/fonts.test.ts +157 -0
package/src/fonts.ts +296 -0
package/src/genesis-inventory.test.ts +86 -0
package/src/genesis-inventory.ts +215 -0
package/src/genesis-sanitize.test.ts +35 -0
package/src/genesis.ts +87 -0
package/src/i18n.test.ts +274 -0
package/src/i18n.ts +269 -0
package/src/index.test.ts +10 -0
package/src/index.ts +59 -0
package/src/interactions.ts +48 -0
package/src/logger.ts +147 -0
package/src/media.test.ts +160 -0
package/src/media.ts +355 -0
package/src/page-log.test.ts +163 -0
package/src/page-log.ts +124 -0
package/src/preview-compose.test.ts +602 -0
package/src/preview-compose.ts +709 -0
package/src/preview-scanner.test.ts +96 -0
package/src/preview-scanner.ts +214 -0
package/src/proposal-status.test.ts +69 -0
package/src/proposal-status.ts +40 -0
package/src/responsive-images.test.ts +104 -0
package/src/responsive-images.ts +151 -0
package/src/result.ts +29 -0
package/src/safe-keys.ts +21 -0
package/src/seo.test.ts +234 -0
package/src/seo.ts +261 -0
package/src/skills.ts +48 -0
package/src/snapshots.test.ts +80 -0
package/src/snapshots.ts +81 -0
package/src/strip-cdata.test.ts +41 -0
package/src/strip-cdata.ts +50 -0
package/src/structured-sets.ts +180 -0
package/src/subagents.test.ts +262 -0
package/src/subagents.ts +432 -0
package/src/template-engine.test.ts +379 -0
package/src/template-engine.ts +520 -0
package/src/theme-gradient.test.ts +92 -0
package/src/theme-importers/__tests__/proto-pollution.test.ts +54 -0
package/src/theme-importers/auto-detect.ts +84 -0
package/src/theme-importers/css-comments.ts +15 -0
package/src/theme-importers/dtcg.ts +106 -0
package/src/theme-importers/loose.ts +76 -0
package/src/theme-importers/shadcn.ts +133 -0
package/src/theme-importers/style-dictionary.ts +125 -0
package/src/theme-importers/tailwind.ts +217 -0
package/src/theme-literal-binding.test.ts +71 -0
package/src/theme-literal-binding.ts +159 -0
package/src/theme-motion.test.ts +115 -0
package/src/theme-normalize-envelope.test.ts +43 -0
package/src/theme-normalize-gradient.test.ts +135 -0
package/src/theme-normalize.ts +661 -0
package/src/theme-ramp.ts +187 -0
package/src/theme-render-sanitize.test.ts +45 -0
package/src/theme-render.test.ts +119 -0
package/src/theme-render.ts +487 -0
package/src/theme-shadow.test.ts +56 -0
package/src/themes-errors.ts +199 -0
package/src/themes.ts +842 -0
package/src/translation.test.ts +160 -0
package/src/translation.ts +295 -0
package/src/version.ts +66 -0

package/src/preview-compose.test.ts ADDED Viewed

@@ -0,0 +1,602 @@
+// SPDX-License-Identifier: MPL-2.0
+import { describe, expect, it } from "bun:test";
+import {
+  ComposeError,
+  composePagePreview,
+  composePageWithLayout,
+  tagModuleId,
+} from "./preview-compose.js";
+const blankModule = {
+  moduleId: "00000000-0000-0000-0000-000000000000",
+  slug: "blank",
+  displayName: "Blank",
+  html: "",
+  css: "",
+  js: "",
+};
+describe("composePagePreview", () => {
+  it("inlines module HTML into named slots and stamps CSS/JS into head/body", () => {
+    const out = composePagePreview({
+      templateHtml: `<!doctype html><html><head><title>T</title></head><body><caelo-slot name="content">x</caelo-slot></body></html>`,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              ...blankModule,
+              html: "<p>HELLO</p>",
+              css: "p { color: red; }",
+              js: "console.log('hi');",
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(
+      `<caelo-slot name="content"><p data-caelo-module-id="00000000-0000-0000-0000-000000000000">HELLO</p></caelo-slot>`,
+    );
+    expect(out.html).toContain(`<style data-source="modules">`);
+    expect(out.html).toContain(`p { color: red; }`);
+    expect(out.html).toContain(`<script defer data-source="modules">`);
+    expect(out.html).toContain(`console.log('hi');`);
+    // CSS appears before </head>; JS before </body>.
+    expect(out.html.indexOf(`<style data-source="modules">`)).toBeLessThan(
+      out.html.indexOf("</head>"),
+    );
+    expect(out.html.indexOf(`<script defer data-source="modules">`)).toBeLessThan(
+      out.html.indexOf("</body>"),
+    );
+  });
+  it("orders modules within a block by array order", () => {
+    const out = composePagePreview({
+      templateHtml: `<body><caelo-slot name="x">_</caelo-slot></body>`,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "x",
+          modules: [
+            { ...blankModule, html: "<p>A</p>" },
+            { ...blankModule, html: "<p>B</p>" },
+          ],
+        },
+      ],
+    });
+    // Both modules use the same blank moduleId so the data-attr collides;
+    // ordering is what matters here. Just assert both are present in
+    // sequence with the expected separator.
+    expect(out.html).toMatch(
+      /<p data-caelo-module-id="[^"]+">A<\/p>\n<p data-caelo-module-id="[^"]+">B<\/p>/,
+    );
+  });
+  it("emits template CSS before module CSS so module rules win on tie specificity", () => {
+    const out = composePagePreview({
+      templateHtml: `<head></head><body></body>`,
+      templateCss: "body { color: blue; }",
+      blocks: [
+        {
+          blockName: "x",
+          modules: [{ ...blankModule, css: "body { color: red; }" }],
+        },
+      ],
+    });
+    const cssBlock = out.html.match(/<style data-source="modules">[\s\S]*?<\/style>/)?.[0] ?? "";
+    expect(cssBlock.indexOf("color: blue")).toBeLessThan(cssBlock.indexOf("color: red"));
+  });
+  it("omits the style tag entirely when no module/template CSS exists", () => {
+    const out = composePagePreview({
+      templateHtml: `<head></head><body><caelo-slot name="x">_</caelo-slot></body>`,
+      templateCss: "",
+      blocks: [{ blockName: "x", modules: [{ ...blankModule, html: "<p>x</p>" }] }],
+    });
+    expect(out.html).not.toContain(`<style data-source="modules">`);
+    expect(out.html).not.toContain(`<script defer data-source="modules">`);
+  });
+  it("records missing slot names when the template has unfilled slots", () => {
+    const out = composePagePreview({
+      templateHtml: `<body><caelo-slot name="missing">_</caelo-slot></body>`,
+      templateCss: "",
+      blocks: [],
+    });
+    expect(out.missingSlots).toEqual(["missing"]);
+  });
+});
+describe("tagModuleId (P6.7 live-edit overlay support)", () => {
+  it("adds data-caelo-module-id to the first opening tag", () => {
+    expect(tagModuleId("<p>hello</p>", "abc-123")).toBe(
+      `<p data-caelo-module-id="abc-123">hello</p>`,
+    );
+  });
+  it("is idempotent — re-running on tagged HTML is a no-op", () => {
+    const once = tagModuleId("<p>x</p>", "id-1");
+    expect(tagModuleId(once, "id-1")).toBe(once);
+  });
+  it("only tags the FIRST opening tag — siblings stay untouched", () => {
+    const out = tagModuleId("<p>a</p><p>b</p>", "id-1");
+    expect(out).toBe(`<p data-caelo-module-id="id-1">a</p><p>b</p>`);
+  });
+  it("tolerates leading whitespace + comments before the first tag", () => {
+    const out = tagModuleId("  <!-- hi -->\n<div>x</div>", "id-9");
+    expect(out).toContain(`<div data-caelo-module-id="id-9">x</div>`);
+  });
+  it("returns unchanged when there is no opening tag (pure text)", () => {
+    expect(tagModuleId("plain text", "id-1")).toBe("plain text");
+  });
+  it("preserves existing attributes on the first tag", () => {
+    expect(tagModuleId(`<h1 class="hero" id="x">A</h1>`, "id-7")).toBe(
+      `<h1 class="hero" id="x" data-caelo-module-id="id-7">A</h1>`,
+    );
+  });
+});
+describe("composePagePreview substitutes {{name}} placeholders with field defaults", () => {
+  // PR #61 follow-up: before this, modules with `{{name}}` placeholders
+  // and a declared `fields[]` shipped raw to the browser via the
+  // static-generator path (visitors saw literal `{{spantext}}` /
+  // `{{ctahref}}` text). The substitution lives in compose so both the
+  // preview-iframe path and the static-gen path agree on the default
+  // floor. Per-placement overrides (content_instances.values) still
+  // happen in preview-render, not here.
+  const slot = `<body><caelo-slot name="content">_</caelo-slot></body>`;
+  it("fills declared {{name}} placeholders with each field's default", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-x",
+              slug: "hero",
+              displayName: "Hero",
+              html: '<h1>{{heading}}</h1><a href="{{ctahref}}">{{ctalabel}}</a>',
+              css: "",
+              js: "",
+              fields: [
+                { name: "heading", default: "Welcome to Caelo" },
+                { name: "ctahref", default: "/get-started" },
+                { name: "ctalabel", default: "Get started" },
+              ],
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(">Welcome to Caelo</h1>");
+    expect(out.html).toContain('<a href="/get-started">Get started</a>');
+    // No raw `{{name}}` residue in the body.
+    expect(out.html).not.toMatch(/\{\{[a-z]/i);
+  });
+  it("contentValues override field defaults (per-placement wins)", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-z",
+              slug: "hero",
+              displayName: "Hero",
+              html: "<h1>{{heading}}</h1>",
+              css: "",
+              js: "",
+              fields: [{ name: "heading", default: "Default headline" }],
+              contentValues: { heading: "Per-placement headline" },
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(">Per-placement headline</h1>");
+    expect(out.html).not.toContain("Default headline");
+  });
+  it("contentValues without a matching field still substitute (values are authoritative)", () => {
+    // AI-authored explicit fields without defaults rely on
+    // contentValues being the source of truth — the bug e2e-livedit's
+    // second Stage hit before this commit (issue #70).
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-w",
+              slug: "brand",
+              displayName: "Brand",
+              html: '<a href="{{brand_href}}">{{brand_name}}</a>',
+              css: "",
+              js: "",
+              fields: [{ name: "brand_href" }, { name: "brand_name" }],
+              contentValues: { brand_href: "/", brand_name: "Caelo" },
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain('<a href="/" data-caelo-module-id="mod-w">Caelo</a>');
+    expect(out.html).not.toMatch(/\{\{brand/);
+  });
+  it("leaves unknown {{name}} as raw placeholder (no-fallbacks per CLAUDE.md §2)", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-y",
+              slug: "broken",
+              displayName: "Broken",
+              html: "<p>{{declared}} and {{undeclared}}</p>",
+              css: "",
+              js: "",
+              fields: [{ name: "declared", default: "OK" }],
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(">OK and {{undeclared}}</p>");
+  });
+});
+describe("composePagePreview list-iteration via shared template engine (#71)", () => {
+  // PR #71 / Plan B — the compose path now routes through the shared
+  // template engine and gains text-list / link-list / module-list
+  // section support. The fixtures below are the AC verbatim shapes;
+  // failures here imply the static-generator is leaking raw mustache
+  // markers to visitors again (the bug #71 closes).
+  const slot = `<body><caelo-slot name="content">_</caelo-slot></body>`;
+  it("AC #1 — link-list iterates per element inside composed page", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-nav",
+              slug: "header",
+              displayName: "Header",
+              html: '<nav>{{#nav_items}}<a href="{{href}}">{{label}}</a>{{/nav_items}}</nav>',
+              css: "",
+              js: "",
+              fields: [{ name: "nav_items", kind: "link-list" }],
+              contentValues: {
+                nav_items: [
+                  { label: "Docs", href: "/docs" },
+                  { label: "Blog", href: "/blog" },
+                ],
+              },
+            },
+          ],
+        },
+      ],
+    });
+    // Outermost element is tagged with data-caelo-module-id; assert
+    // the section iterated and that no raw markers leaked into the
+    // composed HTML.
+    expect(out.html).toContain('<a href="/docs">Docs</a>');
+    expect(out.html).toContain('<a href="/blog">Blog</a>');
+    expect(out.html).not.toMatch(/\{\{[#/]/);
+    expect(out.html).not.toMatch(/\{\{label/);
+    expect(out.html).not.toMatch(/\{\{href/);
+    expect(out.html).toContain('data-caelo-module-id="mod-nav"');
+  });
+  it("AC #2 — text-list iterates {{.}} per element inside composed page", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-tags",
+              slug: "tags",
+              displayName: "Tags",
+              html: "<ul>{{#tags}}<li>{{.}}</li>{{/tags}}</ul>",
+              css: "",
+              js: "",
+              fields: [{ name: "tags", kind: "text-list" }],
+              contentValues: { tags: ["a", "b", "c"] },
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain("<li>a</li><li>b</li><li>c</li>");
+    expect(out.html).not.toMatch(/\{\{[#/]/);
+    expect(out.html).toContain('data-caelo-module-id="mod-tags"');
+  });
+  it("AC #3 — unknown {{#unknown}}…{{/unknown}} stays as raw markers in composed output", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-broken",
+              slug: "broken",
+              displayName: "Broken",
+              html: "<p>{{#unknown}}x{{/unknown}}</p>",
+              css: "",
+              js: "",
+              fields: [],
+            },
+          ],
+        },
+      ],
+    });
+    // Raw markers preserved (no silent swallow) so the operator sees
+    // the broken template in DevTools, per CLAUDE.md §2.
+    expect(out.html).toContain("{{#unknown}}x{{/unknown}}");
+  });
+  it("AC #4 (compose-path posture) — module-list emits loud HTML comment, never raw markers", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              moduleId: "mod-cards",
+              slug: "cards",
+              displayName: "Cards",
+              html: "<ul>{{#cards}}<li>x</li>{{/cards}}</ul>",
+              css: "",
+              js: "",
+              fields: [{ name: "cards", kind: "module-list" }],
+              contentValues: {
+                cards: [{ moduleId: "child-mod", contentInstanceId: "child-ci" }],
+              },
+            },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(
+      "<!-- caelo:module-list cards needs recursive renderer (compose path) -->",
+    );
+    expect(out.html).not.toMatch(/\{\{[#/]/);
+  });
+});
+describe("composePagePreview tags every module's outermost element", () => {
+  const slot = `<body><caelo-slot name="content">_</caelo-slot></body>`;
+  it("threads the moduleId through the composed output", () => {
+    const out = composePagePreview({
+      templateHtml: slot,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            { moduleId: "mod-a", slug: "a", displayName: "A", html: "<p>1</p>", css: "", js: "" },
+            { moduleId: "mod-b", slug: "b", displayName: "B", html: "<p>2</p>", css: "", js: "" },
+          ],
+        },
+      ],
+    });
+    expect(out.html).toContain(`<p data-caelo-module-id="mod-a">1</p>`);
+    expect(out.html).toContain(`<p data-caelo-module-id="mod-b">2</p>`);
+  });
+});
+describe("composePageWithLayout", () => {
+  const layoutHtml = `<!doctype html><html><head></head><body><header><caelo-slot name="header">_</caelo-slot></header><main><caelo-slot name="content">_</caelo-slot></main></body></html>`;
+  const templateHtml = `<body><caelo-slot name="content">_</caelo-slot></body>`;
+  it("aggregates CSS in layout → template → modules order", () => {
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "/* TPL */",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [
+            {
+              ...blankModule,
+              moduleId: "11111111-1111-1111-1111-111111111111",
+              html: "<p>x</p>",
+              css: "/* MOD */",
+            },
+          ],
+        },
+      ],
+      layoutHtml,
+      layoutCss: "/* LAYOUT */",
+      layoutBlocks: [],
+      layoutSlug: "test",
+    });
+    const css = out.html.slice(
+      out.html.indexOf(`<style data-source="modules">`),
+      out.html.indexOf("</style>", out.html.indexOf(`<style data-source="modules">`)),
+    );
+    const layoutIdx = css.indexOf("/* LAYOUT */");
+    const tplIdx = css.indexOf("/* TPL */");
+    const modIdx = css.indexOf("/* MOD */");
+    expect(layoutIdx).toBeGreaterThanOrEqual(0);
+    expect(tplIdx).toBeGreaterThan(layoutIdx);
+    expect(modIdx).toBeGreaterThan(tplIdx);
+  });
+  it("injects fonts (preloads + @font-face) before the theme style (issue #150)", () => {
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "",
+      blocks: [],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+      fonts: {
+        css: "@font-face{font-family:\"Poppins\";src:url(/_assets/fonts/poppins/aa.woff2) format('woff2');}",
+        preloads: ["/_assets/fonts/poppins/aa.woff2"],
+      },
+    });
+    expect(out.html).toContain('<style data-source="fonts">');
+    // Font preloads MUST carry crossorigin even same-origin (fetch spec
+    // font-destination CORS rule) or the browser double-downloads.
+    expect(out.html).toContain(
+      '<link rel="preload" as="font" type="font/woff2" crossorigin href="/_assets/fonts/poppins/aa.woff2">',
+    );
+    const headEnd = out.html.indexOf("</head>");
+    expect(out.html.indexOf('<style data-source="fonts">')).toBeLessThan(headEnd);
+  });
+  it("omits the fonts fragment entirely for system-stack-only themes (issue #150)", () => {
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "",
+      blocks: [],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+      fonts: { css: "", preloads: [] },
+    });
+    expect(out.html).not.toContain('data-source="fonts"');
+    expect(out.html).not.toContain('rel="preload"');
+  });
+  it("renders a responsive nav with once-per-page functional assets (issue #160)", () => {
+    const navModule = {
+      ...blankModule,
+      moduleId: "33333333-3333-4333-8333-333333333303",
+      slug: "nav-menu-header",
+      html: "<nav>replaced</nav>",
+    };
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "",
+      blocks: [{ blockName: "content", modules: [navModule, navModule] }],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+      structuredSets: {
+        byKindSlug: { "nav-menu/header": [{ label: "Docs", href: "/docs" }] },
+      },
+    });
+    expect(out.html).toContain('class="caelo-nav-toggle"');
+    expect(out.html).toContain('aria-expanded="false"');
+    expect(out.html).toContain('data-nav-open="false"');
+    // Functional assets exactly once, even with two nav placements.
+    expect(out.html.split("caelo-nav-toggle{display:none").length - 1).toBe(1);
+    expect(out.html.split("data-nav-open','false'").length - 1).toBe(1);
+    // Zero aesthetics in the functional css: no colors beyond currentColor.
+    expect(out.html).not.toMatch(/caelo-nav-toggle\{[^}]*#[0-9a-f]{3}/i);
+  });
+  it("injects the invisible technical baseline between theme and modules (issue #151)", () => {
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "/* TPL */",
+      blocks: [],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+    });
+    const base = out.html.indexOf('<style data-source="base">');
+    const modules = out.html.indexOf('<style data-source="modules">');
+    expect(base).toBeGreaterThan(-1);
+    expect(out.html).toContain("box-sizing:border-box");
+    expect(base).toBeLessThan(modules); // module CSS overrides the floor
+    // Zero design opinion: no colors, no font sizes, no type scale.
+    const baseBlock = out.html.slice(base, out.html.indexOf("</style>", base));
+    expect(baseBlock).not.toMatch(/#[0-9a-f]{3}|font-size|color:|rem\b/i);
+  });
+  it("emits a twice-placed module's CSS/JS exactly once (issue #158)", () => {
+    const shared = {
+      ...blankModule,
+      moduleId: "22222222-2222-4222-8222-222222222202",
+      html: "<p>x</p>",
+      css: "/* SHARED-CSS */",
+      js: "/* SHARED-JS */",
+    };
+    const out = composePageWithLayout({
+      templateHtml,
+      templateCss: "",
+      blocks: [
+        { blockName: "content", modules: [shared, shared] },
+        { blockName: "header", modules: [shared] },
+      ],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+    });
+    expect(out.html.split("/* SHARED-CSS */").length - 1).toBe(1);
+    expect(out.html.split("/* SHARED-JS */").length - 1).toBe(1);
+  });
+  it("throws ComposeError when the layout lacks a content slot", () => {
+    expect(() =>
+      composePageWithLayout({
+        templateHtml,
+        templateCss: "",
+        blocks: [],
+        layoutHtml: `<!doctype html><html><body><header>chrome</header></body></html>`,
+        layoutCss: "",
+        layoutBlocks: [],
+        layoutSlug: "broken",
+      }),
+    ).toThrow(ComposeError);
+  });
+  it("peels a body-wrapping <caelo-slot name='content'> with single-quote attrs", () => {
+    // Single-quote attribute would have failed the previous regex peel
+    // and produced a nested <caelo-slot> in the output. With the
+    // parser-based peel, the wrapping slot is removed and the inner
+    // <p>BODY</p> lands directly in the layout's content slot.
+    const out = composePageWithLayout({
+      templateHtml: `<body><caelo-slot name='content'>_</caelo-slot></body>`,
+      templateCss: "",
+      blocks: [
+        {
+          blockName: "content",
+          modules: [{ ...blankModule, html: "<p>BODY</p>" }],
+        },
+      ],
+      layoutHtml,
+      layoutCss: "",
+      layoutBlocks: [],
+      layoutSlug: "test",
+    });
+    expect(out.html).toContain("<p");
+    expect(out.html).toContain(">BODY</p>");
+    // Exactly one caelo-slot[name=content] in output (the layout's own).
+    const matches = out.html.match(/caelo-slot[^>]*name=["']content["']/g) ?? [];
+    expect(matches.length).toBe(1);
+  });
+});