@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/css-var-scan.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: MPL-2.0
+const VAR_REFERENCE_RE = /var\(\s*(--[a-zA-Z0-9_-]+)\s*(,)?/g;
+const VAR_DEFINITION_RE = /(?:^|[{;\s])(--[a-zA-Z0-9_-]+)\s*:/g;
+/** Extract every `var(--x[, fallback])` reference (deduped by name+fallback). */
+export function extractCssVarReferences(css) {
+    const seen = new Map();
+    for (const m of css.matchAll(VAR_REFERENCE_RE)) {
+        const name = m[1] ?? "";
+        const hasFallback = m[2] === ",";
+        const key = `${name}|${hasFallback}`;
+        if (!seen.has(key))
+            seen.set(key, { name, hasFallback });
+    }
+    return [...seen.values()];
+}
+/** Custom properties DEFINED in the CSS (`--x: value;`). */
+export function extractCssVarDefinitions(css) {
+    const out = new Set();
+    for (const m of css.matchAll(VAR_DEFINITION_RE)) {
+        out.add(m[1] ?? "");
+    }
+    return out;
+}
+/** Levenshtein distance, small-string use only (var names). */
+function editDistance(a, b) {
+    const prev = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j++)
+        prev[j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        let diag = prev[0];
+        prev[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const tmp = prev[j];
+            prev[j] = Math.min(prev[j] + 1, prev[j - 1] + 1, diag + (a[i - 1] === b[j - 1] ? 0 : 1));
+            diag = tmp;
+        }
+    }
+    return prev[b.length];
+}
+/**
+ * Report `var()` references that neither the theme emits nor the
+ * bundle itself defines, with a nearest-match suggestion so the fix is
+ * one edit, not a research task (CLAUDE.md §11: AI-actionable).
+ */
+export function scanCssVars(input) {
+    const known = new Set(input.knownVars);
+    for (const def of extractCssVarDefinitions(input.css))
+        known.add(def);
+    const unknown = [];
+    const reported = new Set();
+    for (const ref of extractCssVarReferences(input.css)) {
+        if (known.has(ref.name) || reported.has(ref.name))
+            continue;
+        reported.add(ref.name);
+        let best = null;
+        let bestDist = Number.POSITIVE_INFINITY;
+        for (const candidate of known) {
+            const d = editDistance(ref.name, candidate);
+            if (d < bestDist) {
+                bestDist = d;
+                best = candidate;
+            }
+        }
+        const threshold = Math.max(2, Math.floor(ref.name.length * 0.4));
+        unknown.push({
+            name: ref.name,
+            hasFallback: ref.hasFallback,
+            suggestion: best !== null && bestDist <= threshold ? best : null,
+        });
+    }
+    return unknown;
+}
+/**
+ * Marker for the preview op's missing-content surface — same
+ * convention as `theme-asset-unbound:<slot>` / `theme-font-unresolvable`.
+ */
+export function unknownCssVarMarker(name) {
+    return `unknown-css-var:${name}`;
+}
+/**
+ * One-line, AI-actionable warning for authoring-tool results. Returns
+ * null when nothing is unknown (no noise on clean writes).
+ */
+export function formatUnknownCssVarWarning(unknown) {
+    if (unknown.length === 0)
+        return null;
+    const parts = unknown.map((u) => {
+        const hint = u.suggestion !== null ? ` (did you mean \`${u.suggestion}\`?)` : "";
+        const fallback = u.hasFallback
+            ? " — its hardcoded fallback is what visitors will see, detached from the theme"
+            : " — the declaration is invalid and the property won't apply";
+        return `\`${u.name}\`${hint}${fallback}`;
+    });
+    return (`⚠️ Unknown CSS vars (the active theme does not emit them): ${parts.join("; ")}. ` +
+        "Use the exact names from the `## Theme` inventory, or define the custom property in this CSS if it's intentional.");
+}
+//# sourceMappingURL=css-var-scan.js.map

package/dist/css-var-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-var-scan.js","sourceRoot":"","sources":["../src/css-var-scan.ts"],"names":[],"mappings":"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"}

package/dist/design-manifest.d.ts

@@ -0,0 +1,36 @@
+/**
+ * issue #165 — the Design Manifest: a generated, versioned description
+ * of THIS site's design system (epic #149, growth-time convergence).
+ *
+ * The operator requirement is asymmetric: pages of the SAME site share
+ * one visual line, while different sites are free to look nothing
+ * alike. A global stylesheet solves the first at the cost of the
+ * second; the per-site manifest solves both — it captures what this
+ * site's tokens/patterns MEAN so the AI converges toward its own
+ * design, not a Caelo default.
+ *
+ * Written at Genesis materialisation (or curated later via chat);
+ * rendered as the `## Design system` system-prompt block.
+ */
+import { z } from "zod";
+export declare const designManifestPattern: z.ZodObject<{
+    name: z.ZodString;
+    moduleType: z.ZodOptional<z.ZodString>;
+    spec: z.ZodString;
+}, z.core.$strict>;
+export declare const designManifestSchema: z.ZodObject<{
+    tokenRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    typography: z.ZodOptional<z.ZodString>;
+    rhythm: z.ZodOptional<z.ZodString>;
+    patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        moduleType: z.ZodOptional<z.ZodString>;
+        spec: z.ZodString;
+    }, z.core.$strict>>>;
+    imagery: z.ZodOptional<z.ZodString>;
+    avoid: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DesignManifest = z.infer<typeof designManifestSchema>;
+/** Render the `## Design system` prompt block. Null when empty. */
+export declare function formatDesignSystemBlock(manifest: DesignManifest | null): string | null;
+//# sourceMappingURL=design-manifest.d.ts.map

package/dist/design-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-manifest.d.ts","sourceRoot":"","sources":["../src/design-manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;kBASvB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAYtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA8CtF"}

package/dist/design-manifest.js

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * issue #165 — the Design Manifest: a generated, versioned description
+ * of THIS site's design system (epic #149, growth-time convergence).
+ *
+ * The operator requirement is asymmetric: pages of the SAME site share
+ * one visual line, while different sites are free to look nothing
+ * alike. A global stylesheet solves the first at the cost of the
+ * second; the per-site manifest solves both — it captures what this
+ * site's tokens/patterns MEAN so the AI converges toward its own
+ * design, not a Caelo default.
+ *
+ * Written at Genesis materialisation (or curated later via chat);
+ * rendered as the `## Design system` system-prompt block.
+ */
+import { z } from "zod";
+export const designManifestPattern = z
+    .object({
+    /** Pattern name the AI reasons in ("hero", "card grid", "cta band"). */
+    name: z.string().min(1).max(80),
+    /** Stable module `type` implementing it — reuse target (#159 place mode). */
+    moduleType: z.string().max(64).optional(),
+    /** One-line spec: what makes this pattern THIS site's version of it. */
+    spec: z.string().min(1).max(500),
+})
+    .strict();
+export const designManifestSchema = z
+    .object({
+    /** `--color-primary` → "CTAs and links only" — usage semantics per var. */
+    tokenRoles: z.record(z.string().min(3).max(64), z.string().min(1).max(300)).optional(),
+    /** Scale ratio, casing, measure rules. */
+    typography: z.string().min(1).max(1000).optional(),
+    /** Section padding, container width, grid gaps. */
+    rhythm: z.string().min(1).max(1000).optional(),
+    patterns: z.array(designManifestPattern).max(24).optional(),
+    imagery: z.string().min(1).max(500).optional(),
+    avoid: z.string().min(1).max(500).optional(),
+})
+    .strict();
+/** Render the `## Design system` prompt block. Null when empty. */
+export function formatDesignSystemBlock(manifest) {
+    if (manifest === null)
+        return null;
+    const lines = [
+        "## Design system",
+        "",
+        "THIS site's own design language — derived from the chosen design. Every module you author or restyle conforms to it unless the operator explicitly asks to break the line. Reuse the pattern's module type (place mode) before minting lookalikes.",
+        "",
+    ];
+    let hasContent = false;
+    const roles = manifest.tokenRoles ?? {};
+    const roleEntries = Object.entries(roles);
+    if (roleEntries.length > 0) {
+        hasContent = true;
+        lines.push("Token roles:");
+        for (const [token, role] of roleEntries.slice(0, 24))
+            lines.push(`- \`${token}\` — ${role}`);
+        lines.push("");
+    }
+    if (manifest.typography) {
+        hasContent = true;
+        lines.push(`Typography: ${manifest.typography}`, "");
+    }
+    if (manifest.rhythm) {
+        hasContent = true;
+        lines.push(`Rhythm: ${manifest.rhythm}`, "");
+    }
+    if (manifest.patterns && manifest.patterns.length > 0) {
+        hasContent = true;
+        lines.push("Patterns:");
+        for (const p of manifest.patterns) {
+            lines.push(`- **${p.name}**${p.moduleType ? ` (module type \`${p.moduleType}\`)` : ""} — ${p.spec}`);
+        }
+        lines.push("");
+    }
+    if (manifest.imagery) {
+        hasContent = true;
+        lines.push(`Imagery: ${manifest.imagery}`, "");
+    }
+    if (manifest.avoid) {
+        hasContent = true;
+        lines.push(`Never: ${manifest.avoid}`, "");
+    }
+    if (!hasContent)
+        return null;
+    while (lines[lines.length - 1] === "")
+        lines.pop();
+    return lines.join("\n");
+}
+//# sourceMappingURL=design-manifest.js.map

package/dist/design-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-manifest.js","sourceRoot":"","sources":["../src/design-manifest.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,6EAA6E;IAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,2EAA2E;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,0CAA0C;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAClD,mDAAmD;IACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CAAC,QAA+B;IACrE,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAa;QACtB,kBAAkB;QAClB,EAAE;QACF,oPAAoP;QACpP,EAAE;KACH,CAAC;IACF,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CACzF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,UAAU,GAAG,IAAI,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/fonts.d.ts

@@ -0,0 +1,89 @@
+/**
+ * issue #150 — web-font resolution primitives.
+ *
+ * Theme typography tokens name font families (`--font-heading:
+ * "Poppins"`), but until #150 nothing delivered the font files to
+ * rendered pages — every site silently fell back to system fonts, the
+ * exact silent-degradation CLAUDE.md §2 forbids. These pure helpers are
+ * the shared half of the fix: extract the families a theme actually
+ * uses, classify system stacks (nothing to deliver) vs web fonts
+ * (self-hosted at deploy — hotlinking fonts.googleapis.com is both a
+ * GDPR liability, LG München I 3 O 17493/20, and a third-party request
+ * on the critical path), and build/parse the CSS involved.
+ *
+ * Network + disk live in `@caelo-cms/admin-core`'s font resolver; the
+ * static generator and the preview op share that resolver so preview
+ * and production render the same `@font-face` set (parity contract,
+ * apps/static-generator/src/generate.ts).
+ */
+import type { ThemeDocument } from "./themes.js";
+/** One family the theme needs delivered, with the weights it uses. */
+export interface FontRequest {
+    /** Primary family name, unquoted (`Poppins`), first entry of the stack. */
+    readonly family: string;
+    /** Distinct numeric weights, ascending. Always non-empty. */
+    readonly weights: readonly number[];
+    /** Typography token names that reference the family (`body`, `heading`). */
+    readonly roles: readonly string[];
+}
+/** A single @font-face declaration parsed from a fonts-CSS payload. */
+export interface ParsedFontFace {
+    readonly family: string;
+    readonly style: string;
+    readonly weight: string;
+    readonly unicodeRange: string | null;
+    /** Remote woff2 URL as served by the fonts source. */
+    readonly srcUrl: string;
+}
+/** A parsed face whose bytes now live at a self-hosted public URL. */
+export interface ResolvedFontFace extends Omit<ParsedFontFace, "srcUrl"> {
+    readonly publicUrl: string;
+}
+/** True when the family resolves locally on visitors' machines. */
+export declare function isSystemFontFamily(family: string): boolean;
+/**
+ * Walk `typography.*` composites and collect every non-system family
+ * with the weights the theme declares for it. Alias entries (`$value`
+ * as `{other.token}` string) are skipped — they point at a concrete
+ * composite that is collected on its own.
+ *
+ * Only the FIRST family of a declared stack is requested: the rest of
+ * the stack is the author's fallback chain, which by definition is not
+ * delivered.
+ */
+export declare function extractThemeFontRequests(tokens: ThemeDocument): FontRequest[];
+/** css2 request URL for one family (woff2 negotiated via the UA header). */
+export declare function googleFontsCssUrl(request: FontRequest): string;
+/**
+ * Parse a fonts-CSS payload (css2 response shape) into face records.
+ * Faces without a woff2/woff URL are dropped; a payload yielding zero
+ * faces is the caller's loud-failure signal, not a silent empty set.
+ * Oversized payloads short-circuit to [] for the same loud path —
+ * a legitimate css2 response is orders of magnitude smaller.
+ */
+export declare function parseFontsCss(cssText: string): ParsedFontFace[];
+/**
+ * Emit self-hosted @font-face CSS. `font-display: swap` always — text
+ * must render in the fallback while the woff2 loads.
+ */
+export declare function buildFontFaceCss(faces: readonly ResolvedFontFace[]): string;
+/**
+ * Pick the faces worth a `<link rel="preload">`: one per family — the
+ * latin, normal-style face at the lowest declared weight (the body-copy
+ * face; heavier display cuts arrive via normal loading). Capped at two
+ * families so the preload budget stays sane on multi-family themes.
+ */
+export declare function selectPreloadFaces(faces: readonly ResolvedFontFace[]): ResolvedFontFace[];
+/**
+ * Structured marker for a family that could not be resolved. Lands in
+ * `missingSlots` (preview, soft) or a thrown deploy error (hard) — the
+ * same loud-signal convention as `theme-asset-unbound:<slot>`.
+ */
+export declare function fontUnresolvableMarker(family: string): string;
+/**
+ * Filesystem/URL-safe slug for a family name. Shared between the font
+ * resolver (writes `<cacheDir>/<slug>/…`) and the admin serve route
+ * (reads the same path from the URL) so the two can't drift.
+ */
+export declare function fontFamilySlug(family: string): string;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAqDD,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,EAAE,CAiC7E;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAI9D;AAmBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAyB/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAW3E;AAOD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAezF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/fonts.js

@@ -0,0 +1,241 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * Families that ship with operating systems — nothing to download, no
+ * @font-face to emit. Generic CSS keywords included. Lowercased for
+ * case-insensitive membership tests.
+ */
+const SYSTEM_FONT_FAMILIES = new Set([
+    // Generic keywords + UI stacks
+    "serif",
+    "sans-serif",
+    "monospace",
+    "cursive",
+    "fantasy",
+    "system-ui",
+    "ui-sans-serif",
+    "ui-serif",
+    "ui-monospace",
+    "ui-rounded",
+    "-apple-system",
+    "blinkmacsystemfont",
+    // Cross-platform classics
+    "arial",
+    "arial black",
+    "helvetica",
+    "helvetica neue",
+    "georgia",
+    "times",
+    "times new roman",
+    "courier",
+    "courier new",
+    "verdana",
+    "tahoma",
+    "trebuchet ms",
+    "impact",
+    "palatino",
+    "garamond",
+    // Platform UI/mono staples browsers resolve locally
+    "segoe ui",
+    "sf pro",
+    "sf pro text",
+    "sf pro display",
+    "sf mono",
+    "sfmono-regular",
+    "menlo",
+    "monaco",
+    "consolas",
+    "lucida console",
+    "lucida sans",
+].map((f) => f.toLowerCase()));
+/** True when the family resolves locally on visitors' machines. */
+export function isSystemFontFamily(family) {
+    return SYSTEM_FONT_FAMILIES.has(family.trim().toLowerCase());
+}
+/** Strip quotes + whitespace from one family in a font stack. */
+function cleanFamilyName(raw) {
+    return raw
+        .trim()
+        .replace(/^["']|["']$/g, "")
+        .trim();
+}
+const KEYWORD_WEIGHTS = {
+    normal: 400,
+    bold: 700,
+    // Relative keywords have no absolute value; anchor to the common pair
+    // so the request still covers a usable range.
+    lighter: 300,
+    bolder: 700,
+};
+const DEFAULT_WEIGHTS = [400, 700];
+/**
+ * Walk `typography.*` composites and collect every non-system family
+ * with the weights the theme declares for it. Alias entries (`$value`
+ * as `{other.token}` string) are skipped — they point at a concrete
+ * composite that is collected on its own.
+ *
+ * Only the FIRST family of a declared stack is requested: the rest of
+ * the stack is the author's fallback chain, which by definition is not
+ * delivered.
+ */
+export function extractThemeFontRequests(tokens) {
+    const typography = tokens.typography;
+    if (typography === undefined || typography === null || typeof typography !== "object") {
+        return [];
+    }
+    const byFamily = new Map();
+    for (const [role, entry] of Object.entries(typography)) {
+        if (entry === null || typeof entry !== "object")
+            continue;
+        const value = entry.$value;
+        if (value === null || typeof value !== "object")
+            continue; // alias or malformed
+        const composite = value;
+        if (typeof composite.fontFamily !== "string")
+            continue;
+        const primary = cleanFamilyName(composite.fontFamily.split(",")[0] ?? "");
+        if (primary === "" || isSystemFontFamily(primary))
+            continue;
+        const bucket = byFamily.get(primary) ?? { weights: new Set(), roles: [] };
+        if (typeof composite.fontWeight === "number") {
+            bucket.weights.add(composite.fontWeight);
+        }
+        else if (typeof composite.fontWeight === "string") {
+            const mapped = KEYWORD_WEIGHTS[composite.fontWeight];
+            if (mapped !== undefined)
+                bucket.weights.add(mapped);
+        }
+        bucket.roles.push(role);
+        byFamily.set(primary, bucket);
+    }
+    return [...byFamily.entries()].map(([family, b]) => ({
+        family,
+        weights: b.weights.size > 0
+            ? [...b.weights].sort((a, z) => a - z)
+            : [...DEFAULT_WEIGHTS],
+        roles: b.roles,
+    }));
+}
+/** css2 request URL for one family (woff2 negotiated via the UA header). */
+export function googleFontsCssUrl(request) {
+    const family = encodeURIComponent(request.family).replace(/%20/g, "+");
+    const weights = request.weights.join(";");
+    return `https://fonts.googleapis.com/css2?family=${family}:wght@${weights}&display=swap`;
+}
+/**
+ * `[^{}]*` (not `[^}]*`): the char class excluding BOTH braces makes the
+ * pattern unambiguous — on adversarial payloads full of unclosed
+ * `@font-face{` starts, a failed match aborts at the next `{` instead of
+ * rescanning to end-of-input per start position (the polynomial-ReDoS
+ * shape CodeQL flags; this file parses remotely-served CSS).
+ */
+const FONT_FACE_BLOCK_RE = /@font-face\s*\{([^{}]*)\}/g;
+/** css2 responses are ~10–50 KB; anything past this is not a fonts CSS. */
+const MAX_FONTS_CSS_BYTES = 1_000_000;
+function declValue(block, prop) {
+    const m = new RegExp(`${prop}\\s*:\\s*([^;]+);`, "i").exec(block);
+    return m ? (m[1] ?? "").trim() : null;
+}
+/**
+ * Parse a fonts-CSS payload (css2 response shape) into face records.
+ * Faces without a woff2/woff URL are dropped; a payload yielding zero
+ * faces is the caller's loud-failure signal, not a silent empty set.
+ * Oversized payloads short-circuit to [] for the same loud path —
+ * a legitimate css2 response is orders of magnitude smaller.
+ */
+export function parseFontsCss(cssText) {
+    if (cssText.length > MAX_FONTS_CSS_BYTES)
+        return [];
+    const faces = [];
+    for (const m of cssText.matchAll(FONT_FACE_BLOCK_RE)) {
+        const block = m[1] ?? "";
+        const familyRaw = declValue(block, "font-family");
+        const src = declValue(block, "src");
+        if (familyRaw === null || src === null)
+            continue;
+        // Capture the whole url(...) argument with an unambiguous class,
+        // then check the extension in code — `[^)]+\.woff2?` is the classic
+        // ambiguous-suffix polynomial pattern.
+        const urlMatch = /url\(([^()]*)\)/i.exec(src);
+        if (!urlMatch)
+            continue;
+        const srcUrl = (urlMatch[1] ?? "").trim().replace(/^["']|["']$/g, "");
+        const lower = srcUrl.toLowerCase();
+        if (!(lower.endsWith(".woff2") || lower.endsWith(".woff")))
+            continue;
+        faces.push({
+            family: cleanFamilyName(familyRaw),
+            style: declValue(block, "font-style") ?? "normal",
+            weight: declValue(block, "font-weight") ?? "400",
+            unicodeRange: declValue(block, "unicode-range"),
+            srcUrl,
+        });
+    }
+    return faces;
+}
+/**
+ * Emit self-hosted @font-face CSS. `font-display: swap` always — text
+ * must render in the fallback while the woff2 loads.
+ */
+export function buildFontFaceCss(faces) {
+    return faces
+        .map((f) => {
+        const range = f.unicodeRange !== null ? `unicode-range:${f.unicodeRange};` : "";
+        return (`@font-face{font-family:${JSON.stringify(f.family)};` +
+            `font-style:${f.style};font-weight:${f.weight};font-display:swap;` +
+            `src:url(${f.publicUrl}) format('woff2');${range}}`);
+    })
+        .join("\n");
+}
+/** Latin-subset heuristic: css2 marks it with a range starting U+0000. */
+function isLatinFace(f) {
+    return f.unicodeRange === null || f.unicodeRange.toLowerCase().includes("u+0000");
+}
+/**
+ * Pick the faces worth a `<link rel="preload">`: one per family — the
+ * latin, normal-style face at the lowest declared weight (the body-copy
+ * face; heavier display cuts arrive via normal loading). Capped at two
+ * families so the preload budget stays sane on multi-family themes.
+ */
+export function selectPreloadFaces(faces) {
+    const byFamily = new Map();
+    for (const f of faces) {
+        if (f.style !== "normal" || !isLatinFace(f))
+            continue;
+        const list = byFamily.get(f.family) ?? [];
+        list.push(f);
+        byFamily.set(f.family, list);
+    }
+    const picks = [];
+    for (const list of byFamily.values()) {
+        list.sort((a, z) => Number.parseInt(a.weight, 10) - Number.parseInt(z.weight, 10));
+        const first = list[0];
+        if (first !== undefined)
+            picks.push(first);
+    }
+    return picks.slice(0, 2);
+}
+/**
+ * Structured marker for a family that could not be resolved. Lands in
+ * `missingSlots` (preview, soft) or a thrown deploy error (hard) — the
+ * same loud-signal convention as `theme-asset-unbound:<slot>`.
+ */
+export function fontUnresolvableMarker(family) {
+    return `theme-font-unresolvable:${family}`;
+}
+/**
+ * Filesystem/URL-safe slug for a family name. Shared between the font
+ * resolver (writes `<cacheDir>/<slug>/…`) and the admin serve route
+ * (reads the same path from the URL) so the two can't drift.
+ */
+export function fontFamilySlug(family) {
+    // After the collapse pass, dash RUNS no longer exist — at most one
+    // leading + one trailing dash remain, so the trim pattern needs no
+    // quantifier (a `-+$` here is the polynomial-ReDoS shape on
+    // adversarial all-dash input; this runs on library-supplied strings).
+    return family
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"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"}

package/dist/genesis-inventory.d.ts

@@ -0,0 +1,32 @@
+/** One distinct color literal with where/how often the draft uses it. */
+export interface ColorUsage {
+    readonly value: string;
+    readonly count: number;
+    /** Distinct declaration properties using it (background, color, …). */
+    readonly properties: readonly string[];
+}
+export interface GenesisDraftInventory {
+    readonly colors: readonly ColorUsage[];
+    readonly gradients: readonly string[];
+    readonly fontFamilies: readonly string[];
+    readonly fontSizes: readonly string[];
+    readonly spacingValues: readonly string[];
+    readonly radiusValues: readonly string[];
+    readonly shadows: readonly string[];
+    /** Ordered structural outline of the body (tag + text snippet). */
+    readonly outline: readonly {
+        tag: string;
+        text: string;
+    }[];
+}
+/** Linear extraction of every <style> block's contents. */
+export declare function extractDraftCss(html: string): string;
+/**
+ * Build the inventory. Caps guard pathological drafts: the boundary
+ * already limits draft size (GENESIS_DRAFT_MAX_HTML_BYTES), and each
+ * result list is truncated to what a decision-maker can actually use.
+ */
+export declare function inventoryGenesisDraft(html: string): GenesisDraftInventory;
+/** Compact, prompt-friendly rendering of the inventory. */
+export declare function formatGenesisInventory(inv: GenesisDraftInventory): string;
+//# sourceMappingURL=genesis-inventory.d.ts.map

package/dist/genesis-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-inventory.d.ts","sourceRoot":"","sources":["../src/genesis-inventory.ts"],"names":[],"mappings":"AAsBA,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD;AAiDD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAkFzE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAiBzE"}