@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/page-log.d.ts

@@ -0,0 +1,94 @@
+/**
+ * issue #264 — the per-page edit LOG: durable, append-only work history so a
+ * later chat or a fresh subagent that touches a page knows WHY it was edited,
+ * what decisions were taken, and which operator answers shaped it — without
+ * dragging the originating chat's full transcript through its context.
+ *
+ * This is FACT (what happened), not learned BEHAVIOUR — so, unlike
+ * `site_ai_memory`, it is ungated: any actor appends directly. The shared
+ * Zod schemas here are the single source of truth for the `page_log.append`
+ * op input, the `log_page_edit` tool schema, and the `page_log.list` output.
+ * `formatPageLogBlock` renders the `## Page log` context block the AI reads
+ * before touching a page.
+ */
+import { z } from "zod";
+/**
+ * The kinds of log entry, in the order the AI should reach for them:
+ * - `edited` — a substantive content/module change was made.
+ * - `decision` — a design/structure call the AI made and its rationale.
+ * - `operator_answer` — an answer the operator gave that shaped the page.
+ * - `open_question` — something still unresolved a future turn must settle.
+ * - `rebuilt` — the page was rebuilt from scratch (e.g. migration rebuild).
+ * - `note` — anything else worth preserving for a future editor.
+ */
+export declare const pageLogEntryKinds: readonly ["edited", "decision", "operator_answer", "open_question", "rebuilt", "note"];
+export declare const pageLogEntryKindSchema: z.ZodEnum<{
+    decision: "decision";
+    edited: "edited";
+    operator_answer: "operator_answer";
+    open_question: "open_question";
+    rebuilt: "rebuilt";
+    note: "note";
+}>;
+export type PageLogEntryKind = (typeof pageLogEntryKinds)[number];
+/**
+ * Optional structured context beyond the one-line summary — an OBJECT, never
+ * a bare scalar or array, so the jsonb column stores queryable keys (chosen
+ * option, operator's exact words, affected module ids). Writes go through
+ * `jsonbParam()` in the op handler to avoid the double-encode trap (issue
+ * #68).
+ */
+export declare const pageLogDetailSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type PageLogDetail = z.infer<typeof pageLogDetailSchema>;
+/** Input shape shared by `page_log.append` and the `log_page_edit` tool. */
+export declare const pageLogAppendInputSchema: z.ZodObject<{
+    pageId: z.ZodString;
+    entryKind: z.ZodEnum<{
+        decision: "decision";
+        edited: "edited";
+        operator_answer: "operator_answer";
+        open_question: "open_question";
+        rebuilt: "rebuilt";
+        note: "note";
+    }>;
+    summary: z.ZodString;
+    detail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type PageLogAppendInput = z.infer<typeof pageLogAppendInputSchema>;
+/** One row as returned by `page_log.list`. */
+export declare const pageLogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    pageId: z.ZodString;
+    chatSessionId: z.ZodNullable<z.ZodString>;
+    actorKind: z.ZodEnum<{
+        system: "system";
+        human: "human";
+        ai: "ai";
+        plugin: "plugin";
+    }>;
+    entryKind: z.ZodEnum<{
+        decision: "decision";
+        edited: "edited";
+        operator_answer: "operator_answer";
+        open_question: "open_question";
+        rebuilt: "rebuilt";
+        note: "note";
+    }>;
+    summary: z.ZodString;
+    detail: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type PageLogEntry = z.infer<typeof pageLogEntrySchema>;
+/**
+ * Render the `## Page log` context block for a single page's recent entries
+ * (newest first). Returns `null` when there is nothing to show, so the
+ * caller omits the header entirely (CLAUDE.md §11 — render only when
+ * non-empty). Kept well under 2 KB: entries are capped and each summary is
+ * clamped, because the block rides in the system prompt on every turn that
+ * touches the page.
+ *
+ * @param entries page log rows, expected newest-first (as `page_log.list`
+ *   returns them). The renderer does not re-sort.
+ */
+export declare function formatPageLogBlock(entries: readonly PageLogEntry[]): string | null;
+//# sourceMappingURL=page-log.d.ts.map

package/dist/page-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-log.d.ts","sourceRoot":"","sources":["../src/page-log.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,wFAOpB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;EAA4B,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,wCAAoC,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAO1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;kBAepB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAS9D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAyBlF"}

package/dist/page-log.js

@@ -0,0 +1,111 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * issue #264 — the per-page edit LOG: durable, append-only work history so a
+ * later chat or a fresh subagent that touches a page knows WHY it was edited,
+ * what decisions were taken, and which operator answers shaped it — without
+ * dragging the originating chat's full transcript through its context.
+ *
+ * This is FACT (what happened), not learned BEHAVIOUR — so, unlike
+ * `site_ai_memory`, it is ungated: any actor appends directly. The shared
+ * Zod schemas here are the single source of truth for the `page_log.append`
+ * op input, the `log_page_edit` tool schema, and the `page_log.list` output.
+ * `formatPageLogBlock` renders the `## Page log` context block the AI reads
+ * before touching a page.
+ */
+import { z } from "zod";
+/**
+ * The kinds of log entry, in the order the AI should reach for them:
+ * - `edited` — a substantive content/module change was made.
+ * - `decision` — a design/structure call the AI made and its rationale.
+ * - `operator_answer` — an answer the operator gave that shaped the page.
+ * - `open_question` — something still unresolved a future turn must settle.
+ * - `rebuilt` — the page was rebuilt from scratch (e.g. migration rebuild).
+ * - `note` — anything else worth preserving for a future editor.
+ */
+export const pageLogEntryKinds = [
+    "edited",
+    "decision",
+    "operator_answer",
+    "open_question",
+    "rebuilt",
+    "note",
+];
+export const pageLogEntryKindSchema = z.enum(pageLogEntryKinds);
+/**
+ * Optional structured context beyond the one-line summary — an OBJECT, never
+ * a bare scalar or array, so the jsonb column stores queryable keys (chosen
+ * option, operator's exact words, affected module ids). Writes go through
+ * `jsonbParam()` in the op handler to avoid the double-encode trap (issue
+ * #68).
+ */
+export const pageLogDetailSchema = z.record(z.string(), z.unknown());
+/** Input shape shared by `page_log.append` and the `log_page_edit` tool. */
+export const pageLogAppendInputSchema = z
+    .object({
+    pageId: z.string().uuid(),
+    entryKind: pageLogEntryKindSchema,
+    summary: z.string().min(1).max(2000),
+    detail: pageLogDetailSchema.optional(),
+})
+    .strict();
+/** One row as returned by `page_log.list`. */
+export const pageLogEntrySchema = z
+    .object({
+    id: z.string().uuid(),
+    pageId: z.string().uuid(),
+    chatSessionId: z.string().uuid().nullable(),
+    actorKind: z.enum(["human", "ai", "plugin", "system"]),
+    entryKind: pageLogEntryKindSchema,
+    summary: z.string(),
+    detail: pageLogDetailSchema.nullable(),
+    // ISO datetime, not just any string: the value is `created_at` sliced to a
+    // date and rendered into the AI context block — a real contract catches
+    // drift (a raw pg timestamp, a number) at the op boundary instead of
+    // producing a garbled `## Page log` line.
+    createdAt: z.string().datetime(),
+})
+    .strict();
+const ACTOR_LABEL = {
+    human: "operator",
+    ai: "AI",
+    plugin: "plugin",
+    system: "system",
+};
+/**
+ * Render the `## Page log` context block for a single page's recent entries
+ * (newest first). Returns `null` when there is nothing to show, so the
+ * caller omits the header entirely (CLAUDE.md §11 — render only when
+ * non-empty). Kept well under 2 KB: entries are capped and each summary is
+ * clamped, because the block rides in the system prompt on every turn that
+ * touches the page.
+ *
+ * @param entries page log rows, expected newest-first (as `page_log.list`
+ *   returns them). The renderer does not re-sort.
+ */
+export function formatPageLogBlock(entries) {
+    if (entries.length === 0)
+        return null;
+    // Capped + clamped to stay comfortably under 2 KB: the block rides in the
+    // system prompt on every turn that touches the page.
+    const MAX_ENTRIES = 8;
+    const MAX_SUMMARY = 160;
+    const shown = entries.slice(0, MAX_ENTRIES);
+    const lines = [
+        "## Page log",
+        "",
+        "Prior work on THIS page — read it before you change the page so you build on settled decisions instead of re-litigating them. After a meaningful change, append your own entry with `log_page_edit`.",
+        "",
+    ];
+    for (const e of shown) {
+        const who = ACTOR_LABEL[e.actorKind] ?? e.actorKind;
+        const when = e.createdAt.slice(0, 10);
+        const summary = e.summary.length > MAX_SUMMARY ? `${e.summary.slice(0, MAX_SUMMARY - 3)}...` : e.summary;
+        lines.push(`- [${e.entryKind}] ${summary} (${who}, ${when})`);
+    }
+    if (entries.length > MAX_ENTRIES) {
+        const omitted = entries.length - MAX_ENTRIES;
+        lines.push(`- ${omitted} older ${omitted === 1 ? "entry" : "entries"} omitted.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=page-log.js.map

package/dist/page-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-log.js","sourceRoot":"","sources":["../src/page-log.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAGhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAGrE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACpC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACtC,2EAA2E;IAC3E,wEAAwE;IACxE,qEAAqE;IACrE,0CAA0C;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,WAAW,GAA8B;IAC7C,KAAK,EAAE,UAAU;IACjB,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,0EAA0E;IAC1E,qDAAqD;IACrD,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,MAAM,WAAW,GAAG,GAAG,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa;QACtB,aAAa;QACb,EAAE;QACF,sMAAsM;QACtM,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QACpD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3F,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,OAAO,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/preview-compose.d.ts

@@ -1,3 +1,5 @@
+import type { ModuleFieldKind } from "./content.js";
+import type { ThemeDocument } from "./themes.js";
 export interface ComposeModule {
     readonly moduleId: string;
     readonly slug: string;
@@ -5,6 +7,40 @@ export interface ComposeModule {
     readonly html: string;
     readonly css: string;
     readonly js: string;
+    /**
+     * v0.4.0 module-field schema, extended in #71 to carry `kind` so
+     * the shared template engine can dispatch text-list / link-list /
+     * module-list / module sections. `kind` is optional for back-compat
+     * with callers that haven't been updated; the engine treats absent
+     * kinds as primitives (the legacy compose-path behaviour).
+     *
+     * When present, the composer substitutes `{{name}}` placeholders
+     * in `html` with each field's `default` value before slot
+     * replacement — without this, modules created via the AI-authored
+     * extractor path (which mints `{{spantext}}` / `{{ctahref}}` etc.
+     * with declared defaults) ship raw placeholders to the browser,
+     * visible to visitors as literal `{{name}}` text.
+     *
+     * Per-placement overrides (content_instances.values) are applied
+     * here via the `contentValues` field below. The chat-branched
+     * preview path additionally walks nested-module refs in
+     * preview-render before reaching here.
+     */
+    readonly fields?: readonly {
+        name: string;
+        kind?: ModuleFieldKind;
+        default?: unknown;
+    }[];
+    /**
+     * PR #61 follow-up — per-placement content values from the bound
+     * `content_instances.values` jsonb. When present, the composer
+     * substitutes `{{name}}` placeholders with `contentValues[name]`
+     * BEFORE falling back to `fields[].default`. Without this, AI-
+     * authored modules that declare explicit fields (without a `default`)
+     * but rely on per-placement values shipped raw `{{name}}` text to
+     * visitors — the bug e2e-livedit's second Stage caught.
+     */
+    readonly contentValues?: Readonly<Record<string, unknown>>;
 }
 export interface ComposeBlock {
     readonly blockName: string;
@@ -30,12 +66,55 @@ export interface ComposeLanguageSelector {
         isCurrent: boolean;
     }>;
 }
+/**
+ * v0.11.0 — Theme context resolved by the preview op + static generator
+ * (#45 Phase 3). Carries the active theme's DTCG tokens jsonb plus the
+ * four asset URL resolutions (logo / logo-dark / favicon / social-share).
+ *
+ * The composer reads `tokens` to emit `<style data-source="theme">`;
+ * `assets` are surfaced for modules that want to reference theme-bound
+ * images (the dedicated `{{theme_logo_url}}` template binding lands in
+ * v0.11.x — see #45's "Out of scope"; v0.11.0 only surfaces the URLs).
+ */
+export interface ComposeThemeAsset {
+    readonly mediaId: string;
+    readonly url: string;
+}
+export interface ComposeTheme {
+    readonly tokens: ThemeDocument;
+    readonly assets: {
+        readonly logo: ComposeThemeAsset | null;
+        readonly logoDark: ComposeThemeAsset | null;
+        readonly favicon: ComposeThemeAsset | null;
+        readonly socialShare: ComposeThemeAsset | null;
+    };
+}
+/**
+ * issue #150 — self-hosted web fonts resolved by the caller (font
+ * resolver in admin-core; static generator + preview op thread the
+ * same shape so both surfaces load identical fonts). `css` is the
+ * @font-face block; `preloads` are woff2 URLs worth a
+ * `<link rel="preload">` (body/heading faces, capped upstream).
+ */
+export interface ComposeFonts {
+    readonly css: string;
+    readonly preloads: readonly string[];
+}
 export interface ComposeInput {
     readonly templateHtml: string;
     readonly templateCss: string;
     readonly blocks: readonly ComposeBlock[];
     readonly structuredSets?: ComposeStructuredSets;
     readonly languageSelector?: ComposeLanguageSelector;
+    /**
+     * v0.11.0 — active theme threaded through from the preview op + static
+     * generator. Undefined when no theme row exists OR when the caller
+     * hasn't been migrated to the new primitive yet (renderer no-ops in
+     * both cases, preserving legacy parity).
+     */
+    readonly theme?: ComposeTheme;
+    /** issue #150 — resolved web fonts; undefined = system stacks only. */
+    readonly fonts?: ComposeFonts;
 }
 export interface ComposeOutput {
     readonly html: string;

package/dist/preview-compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-compose.d.ts","sourceRoot":"","sources":["../src/preview-compose.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED;yEACyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAYD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA8DrE;AA2HD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAC5B,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMjF;AAkCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,GAAG,aAAa,CAwHlF"}
+{"version":3,"file":"preview-compose.d.ts","sourceRoot":"","sources":["../src/preview-compose.ts"],"names":[],"mappings":"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"}

package/dist/preview-compose.js

@@ -23,8 +23,13 @@
  * `<head>` skeleton lives. Sandboxing happens one layer up (preview iframe in
  * the admin; in P11, plugin Web Components inside Shadow DOM).
  */
+import { BASE_TECHNICAL_CSS } from "./base-css.js";
+import { NAV_FUNCTIONAL_CSS, NAV_TOGGLE_JS } from "./interactions.js";
 import { applySlotReplacements, extractInnerOfTopLevelContentSlot, listSlotNames, } from "./preview-scanner.js";
+import { stripCdataGuards } from "./strip-cdata.js";
 import { renderLanguageSelector } from "./structured-sets.js";
+import { renderTemplate } from "./template-engine.js";
+import { renderThemeCss as renderThemeCssFromTokens } from "./theme-render.js";
 const HEAD_CLOSE_RE = /<\/head\s*>/i;
 const BODY_CLOSE_RE = /<\/body\s*>/i;
 function injectBefore(source, marker, fragment) {
@@ -34,10 +39,30 @@ function injectBefore(source, marker, fragment) {
     const idx = m.index;
     return source.slice(0, idx) + fragment + source.slice(idx);
 }
+/**
+ * issue #150 — head fragment for resolved web fonts: preload links (the
+ * `crossorigin` attribute is REQUIRED for font preloads even same-origin,
+ * per the fetch spec's font-destination CORS rule) + the @font-face
+ * block. Empty css with no preloads → null (system-stack-only theme).
+ */
+function fontsHeadFragment(fonts) {
+    if (fonts === undefined)
+        return null;
+    const links = fonts.preloads
+        .map((href) => `<link rel="preload" as="font" type="font/woff2" crossorigin href="${href}">`)
+        .join("");
+    const style = fonts.css.trim().length > 0 ? `<style data-source="fonts">${fonts.css}</style>` : "";
+    const fragment = links + style;
+    return fragment.length > 0 ? fragment : null;
+}
 export function composePagePreview(input) {
     const contentByName = new Map();
     const allCss = [];
     const allJs = [];
+    // issue #160 — see composePageWithLayout.
+    let navRendered = false;
+    // issue #158 — same per-module dedup as composePageWithLayout.
+    const seenAssetModules = new Set();
     // Template CSS first so module CSS can override it via source-order specificity.
     if (input.templateCss.trim().length > 0)
         allCss.push(input.templateCss);
@@ -55,34 +80,53 @@ export function composePagePreview(input) {
             const langSelector = lookupLanguageSelector(m.slug, input);
             let baseHtml;
             if (navMenuItems !== null) {
+                navRendered = true;
                 baseHtml = renderNavMenuHtml(navMenuItems);
             }
             else if (langSelector !== null) {
                 baseHtml = langSelector;
             }
             else {
-                baseHtml = m.html;
+                baseHtml = applyFieldSubstitution(m.html, m.fields, m.contentValues, input.theme);
             }
             return tagModuleId(baseHtml, m.moduleId);
         });
         const html = renderedModuleHtml.join("\n");
         contentByName.set(block.blockName, html);
         for (const m of block.modules) {
+            if (seenAssetModules.has(m.moduleId))
+                continue;
+            seenAssetModules.add(m.moduleId);
             if (m.css.trim().length > 0)
                 allCss.push(m.css);
             if (m.js.trim().length > 0)
                 allJs.push(m.js);
         }
     }
+    if (navRendered) {
+        allCss.push(NAV_FUNCTIONAL_CSS);
+        allJs.push(NAV_TOGGLE_JS);
+    }
     const replaced = applySlotReplacements(input.templateHtml, { contentByName });
     let html = replaced.html;
-    // P6.7.5 — theme tokens become CSS custom properties on :root. Goes
-    // first so module CSS can `var(--color-primary)` and override.
-    const themeCss = renderThemeCss(input.structuredSets);
+    // issue #150 — @font-face + preloads before everything else so the
+    // browser discovers font URLs as early as possible.
+    const fontsFragment = fontsHeadFragment(input.fonts);
+    if (fontsFragment !== null) {
+        html = injectBefore(html, HEAD_CLOSE_RE, fontsFragment);
+    }
+    // v0.11.0 — theme tokens become CSS custom properties on :root + (when
+    // dark variants exist) :root.dark. Goes first so module CSS can
+    // `var(--color-primary)` and override. Pre-v0.11 read from
+    // structured_sets["theme/site"]; now reads the active themes row
+    // threaded through ComposeInput.theme.
+    const themeCss = renderThemeCss(input.theme);
     if (themeCss !== null) {
         const styleTag = `<style data-source="theme">${themeCss}</style>`;
         html = injectBefore(html, HEAD_CLOSE_RE, styleTag);
     }
+    // issue #151 — invisible technical baseline (see composePageWithLayout).
+    html = injectBefore(html, HEAD_CLOSE_RE, `<style data-source="base">${BASE_TECHNICAL_CSS}</style>`);
     if (allCss.length > 0) {
         const styleTag = `<style data-source="modules">\n${allCss.join("\n")}\n</style>`;
         html = injectBefore(html, HEAD_CLOSE_RE, styleTag);
@@ -176,7 +220,13 @@ function renderNavMenuHtml(items) {
         const o = it;
         return typeof o.label === "string" && typeof o.href === "string";
     });
-    return `<nav class="caelo-nav-menu"><ul>${safeItems.map(renderNavItem).join("")}</ul></nav>`;
+    // issue #160 — mobile-ready markup: toggle button (three functional
+    // bars via currentColor) + collapsible list. The functional CSS/JS
+    // ships once per page from ./interactions.ts when a nav rendered.
+    const toggle = '<button type="button" class="caelo-nav-toggle" aria-expanded="false" aria-label="Menu">' +
+        '<span class="caelo-nav-bar"></span><span class="caelo-nav-bar"></span><span class="caelo-nav-bar"></span>' +
+        "</button>";
+    return `<nav class="caelo-nav-menu" data-nav-open="false">${toggle}<ul>${safeItems.map(renderNavItem).join("")}</ul></nav>`;
 }
 function renderNavItem(item) {
     const target = item.target === "_blank" ? ' target="_blank" rel="noopener"' : "";
@@ -186,25 +236,76 @@ function renderNavItem(item) {
     return `<li><a href="${escapeAttr(item.href)}"${target}>${escapeText(item.label)}</a>${inner}</li>`;
 }
 /**
- * Render the theme/site set's tokens as `:root { --token: value; }` CSS.
- * Returns null when no theme is configured so the composer skips
- * injecting an empty <style> tag.
+ * v0.11.0 — Render the active theme's DTCG tokens as `:root { … }` (+
+ * optional `:root.dark { … }`) CSS. Returns null when no active theme
+ * is threaded through, so the composer skips injecting an empty
+ * `<style>` tag. The renderer itself lives in `theme-render.ts`; this
+ * wrapper exists so the composer's call site stays readable + the
+ * empty-tokens case (active row, `tokens={}`) emits a deterministic
+ * empty shell rather than skipping the tag (observable absence in
+ * DevTools, per #45's test-strategy "empty-active-theme" assertion).
  */
-function renderThemeCss(sets) {
-    if (!sets)
-        return null;
-    const items = sets.byKindSlug["theme/site"];
-    if (!items || items.length === 0)
-        return null;
-    const tokens = items.filter((it) => {
-        if (!it || typeof it !== "object")
-            return false;
-        const o = it;
-        return typeof o.token === "string" && typeof o.value === "string";
-    });
-    if (tokens.length === 0)
+function renderThemeCss(theme) {
+    if (!theme)
         return null;
-    return `:root{${tokens.map((t) => `--${t.token}: ${t.value};`).join("")}}`;
+    // Empty-tokens case: emit the shell so cascade ordering stays
+    // consistent (legacy "no theme/site row" case still returns null
+    // above so the tag is skipped entirely).
+    if (Object.keys(theme.tokens).length === 0)
+        return ":root{}";
+    return renderThemeCssFromTokens(theme.tokens);
+}
+/**
+ * Substitute `{{name}}` placeholders and `{{#name}}…{{/name}}`
+ * sections in module HTML. Thin wrapper around the shared template
+ * engine (#71); see `template-engine.ts` for the full substitution
+ * grammar and the loud-raw / failure-marker invariants.
+ *
+ * Compose is the no-DB path: nested-module field kinds (`module`,
+ * `module-list`) cannot be resolved here because the partial loader
+ * needs a DB walk to fetch nested content_instances. The engine
+ * emits a loud HTML comment for those refs so static-gen output is
+ * visible-broken (per CLAUDE.md §2) rather than silent-empty. The
+ * chat-branched preview path resolves nested refs via
+ * `preview-render.ts` BEFORE the substituted HTML reaches the
+ * composer, so this branch never trips for that path. Issue #70
+ * tracks pre-resolving in static-gen so the loud comment goes away
+ * there too.
+ *
+ * Both `fields` and `contentValues` are optional. Field `kind` is
+ * optional for back-compat with callers that haven't been updated;
+ * the engine treats absent kinds as primitives (the legacy
+ * compose-path behaviour).
+ */
+function applyFieldSubstitution(html, fields, contentValues, theme) {
+    // The substitution engine (renderTemplate) already unwraps CDATA
+    // guards; cover the no-op early-return path so a chrome module with no
+    // fields/values/theme is cleaned too.
+    if (!fields && !contentValues && !theme)
+        return stripCdataGuards(html);
+    const engineFields = (fields ?? []).map((f) => ({
+        name: f.name,
+        kind: f.kind ?? "text",
+        default: f.default,
+    }));
+    return renderTemplate({
+        html,
+        fields: engineFields,
+        contentValues,
+        // v0.11.1 (issue #76) — thread the active theme's asset URLs so
+        // module HTML carrying `{{theme_logo_url}}` etc. resolves. Unbound
+        // slots emit loud-raw + `theme-asset-unbound:<slot>` markers.
+        themeAssets: theme
+            ? {
+                logo: theme.assets.logo?.url ?? null,
+                logoDark: theme.assets.logoDark?.url ?? null,
+                favicon: theme.assets.favicon?.url ?? null,
+                socialShare: theme.assets.socialShare?.url ?? null,
+            }
+            : undefined,
+        // Compose path has no DB; pass no partials so module/module-list
+        // refs emit the loud HTML comment per CLAUDE.md §2.
+    }).html;
 }
 export function tagModuleId(html, moduleId) {
     if (!html)
@@ -284,6 +385,14 @@ export function composePageWithLayout(input) {
     // brittle and reads as a bug).
     const cssParts = [];
     const jsParts = [];
+    // issue #160 — set when any nav-menu module rendered; pulls the
+    // functional nav CSS/JS in exactly once per page.
+    let navRendered = false;
+    // issue #158 — a module placed N times contributes its CSS/JS ONCE
+    // (first occurrence wins; source order is otherwise preserved).
+    // Duplicate rule blocks made the cascade order-dependent and bloated
+    // every page the same module appeared on twice.
+    const seenAssetModules = new Set();
     if (input.layoutCss.trim().length > 0)
         cssParts.push(input.layoutCss);
     if (input.templateCss.trim().length > 0)
@@ -297,18 +406,22 @@ export function composePageWithLayout(input) {
             const langSelector = lookupLanguageSelector(m.slug, input);
             let baseHtml;
             if (navMenuItems !== null) {
+                navRendered = true;
                 baseHtml = renderNavMenuHtml(navMenuItems);
             }
             else if (langSelector !== null) {
                 baseHtml = langSelector;
             }
             else {
-                baseHtml = m.html;
+                baseHtml = applyFieldSubstitution(m.html, m.fields, m.contentValues, input.theme);
             }
             return tagModuleId(baseHtml, m.moduleId);
         });
         templateContentByName.set(block.blockName, renderedModuleHtml.join("\n"));
         for (const m of block.modules) {
+            if (seenAssetModules.has(m.moduleId))
+                continue;
+            seenAssetModules.add(m.moduleId);
             if (m.css.trim().length > 0)
                 cssParts.push(m.css);
             if (m.js.trim().length > 0)
@@ -333,33 +446,50 @@ export function composePageWithLayout(input) {
             const langSelector = lookupLanguageSelector(m.slug, input);
             let baseHtml;
             if (navMenuItems !== null) {
+                navRendered = true;
                 baseHtml = renderNavMenuHtml(navMenuItems);
             }
             else if (langSelector !== null) {
                 baseHtml = langSelector;
             }
             else {
-                baseHtml = m.html;
+                baseHtml = applyFieldSubstitution(m.html, m.fields, m.contentValues, input.theme);
             }
             return tagModuleId(baseHtml, m.moduleId);
         });
         layoutContentByName.set(block.blockName, renderedModuleHtml.join("\n"));
         for (const m of block.modules) {
+            if (seenAssetModules.has(m.moduleId))
+                continue;
+            seenAssetModules.add(m.moduleId);
             if (m.css.trim().length > 0)
                 cssParts.push(m.css);
             if (m.js.trim().length > 0)
                 jsParts.push(m.js);
         }
     }
+    if (navRendered) {
+        cssParts.push(NAV_FUNCTIONAL_CSS);
+        jsParts.push(NAV_TOGGLE_JS);
+    }
     // 3. Render the layout HTML, substituting all named slots.
     const replaced = applySlotReplacements(input.layoutHtml, {
         contentByName: layoutContentByName,
     });
     let html = replaced.html;
-    const themeCss = renderThemeCss(input.structuredSets);
+    // issue #150 — fonts first (URL discovery), then theme vars, then
+    // aggregated CSS; source order in <head> mirrors injection order.
+    const fontsFragment = fontsHeadFragment(input.fonts);
+    if (fontsFragment !== null) {
+        html = injectBefore(html, HEAD_CLOSE_RE, fontsFragment);
+    }
+    const themeCss = renderThemeCss(input.theme);
     if (themeCss !== null) {
         html = injectBefore(html, HEAD_CLOSE_RE, `<style data-source="theme">${themeCss}</style>`);
     }
+    // issue #151 — invisible technical baseline (reset only, zero design
+    // opinion); module CSS follows and overrides trivially.
+    html = injectBefore(html, HEAD_CLOSE_RE, `<style data-source="base">${BASE_TECHNICAL_CSS}</style>`);
     if (cssParts.length > 0) {
         html = injectBefore(html, HEAD_CLOSE_RE, `<style data-source="modules">\n${cssParts.join("\n")}\n</style>`);
     }