@caelo-cms/shared 0.10.22 → 0.10.24

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"}

package/dist/genesis-inventory.js

@@ -0,0 +1,186 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * issue #164 — design-compiler stage 1: the deterministic INVENTORY.
+ *
+ * Compiler contract (epic #149): the AI decides, code executes and
+ * verifies. This module is the "code" half of the first stage — it
+ * parses a Genesis draft (complete single-file HTML) into a fact base
+ * of design values (colors with usage contexts, font families, size /
+ * spacing / radius histograms, gradients, shadows) plus a section
+ * outline. The AI reads the inventory and makes the DECISIONS (which
+ * literal becomes which token, what things are called); it never has
+ * to re-derive facts by eyeballing raw CSS, and the facts can't be
+ * hallucinated.
+ *
+ * Pure string analysis, linear scans, unambiguous regex classes
+ * (ReDoS-aware per issue #113 — drafts are AI-authored but the parser
+ * budget must hold on adversarial input too).
+ */
+import { scanCssGradients } from "./css-gradient-scan.js";
+/** Linear extraction of every <style> block's contents. */
+export function extractDraftCss(html) {
+    const parts = [];
+    const lower = html.toLowerCase();
+    let from = 0;
+    while (true) {
+        const open = lower.indexOf("<style", from);
+        if (open === -1)
+            break;
+        const openEnd = lower.indexOf(">", open);
+        if (openEnd === -1)
+            break;
+        const close = lower.indexOf("</style", openEnd);
+        if (close === -1)
+            break;
+        parts.push(html.slice(openEnd + 1, close));
+        from = close + 8;
+    }
+    return parts.join("\n");
+}
+const DECLARATION_RE = /([a-zA-Z-]+)\s*:\s*([^;{}]+)/g;
+const COLOR_LITERAL_RE = /#[0-9a-fA-F]{3,8}\b|(?:oklch|rgba?|hsla?|lab|lch|hwb)\([^()]*\)/g;
+const LENGTH_RE = /-?\d+(?:\.\d+)?(?:rem|em|px|vh|vw|ch|%)\b/g;
+const SPACING_PROPS = new Set([
+    "margin",
+    "margin-top",
+    "margin-bottom",
+    "margin-left",
+    "margin-right",
+    "margin-block",
+    "margin-inline",
+    "padding",
+    "padding-top",
+    "padding-bottom",
+    "padding-left",
+    "padding-right",
+    "padding-block",
+    "padding-inline",
+    "gap",
+    "row-gap",
+    "column-gap",
+]);
+const GENERIC_FONT_KEYWORDS = new Set([
+    "serif",
+    "sans-serif",
+    "monospace",
+    "cursive",
+    "fantasy",
+    "system-ui",
+    "ui-sans-serif",
+    "ui-serif",
+    "ui-monospace",
+]);
+function pushCount(map, key) {
+    map.set(key, (map.get(key) ?? 0) + 1);
+}
+function sortedByCount(map) {
+    return [...map.entries()].sort((a, z) => z[1] - a[1]).map(([k]) => k);
+}
+const OUTLINE_TAG_RE = /<(section|header|footer|main|nav|h1|h2|h3)\b[^>]*>/gi;
+const TAG_STRIP_RE = /<[^>]*>/g;
+/**
+ * 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 function inventoryGenesisDraft(html) {
+    const css = extractDraftCss(html);
+    const colorMeta = new Map();
+    const gradients = new Map();
+    const fontFamilies = new Map();
+    const fontSizes = new Map();
+    const spacing = new Map();
+    const radii = new Map();
+    const shadows = new Map();
+    for (const decl of css.matchAll(DECLARATION_RE)) {
+        const prop = (decl[1] ?? "").toLowerCase();
+        const value = (decl[2] ?? "").trim();
+        for (const g of scanCssGradients(value)) {
+            pushCount(gradients, g.literal);
+        }
+        // Colors inside gradients still count — a gradient stop color is a
+        // palette member the token map must name.
+        for (const c of value.matchAll(COLOR_LITERAL_RE)) {
+            const key = c[0].toLowerCase();
+            const meta = colorMeta.get(key) ?? { count: 0, properties: new Set() };
+            meta.count += 1;
+            meta.properties.add(prop);
+            colorMeta.set(key, meta);
+        }
+        if (prop === "font-family") {
+            for (const fam of value.split(",")) {
+                const clean = fam.trim().replace(/^["']|["']$/g, "");
+                // Generic keywords are fallback-chain noise, not palette
+                // members — the token map names real typefaces.
+                if (clean.length > 0 &&
+                    clean.length < 80 &&
+                    !GENERIC_FONT_KEYWORDS.has(clean.toLowerCase())) {
+                    pushCount(fontFamilies, clean);
+                }
+            }
+        }
+        else if (prop === "font-size") {
+            pushCount(fontSizes, value);
+        }
+        else if (SPACING_PROPS.has(prop)) {
+            for (const len of value.matchAll(LENGTH_RE))
+                pushCount(spacing, len[0]);
+        }
+        else if (prop === "border-radius") {
+            pushCount(radii, value);
+        }
+        else if (prop === "box-shadow" || prop === "text-shadow") {
+            pushCount(shadows, value);
+        }
+    }
+    const outline = [];
+    for (const m of html.matchAll(OUTLINE_TAG_RE)) {
+        if (outline.length >= 60)
+            break;
+        const tag = (m[1] ?? "").toLowerCase();
+        const start = (m.index ?? 0) + m[0].length;
+        const text = html
+            .slice(start, start + 400)
+            .replace(TAG_STRIP_RE, " ")
+            .replace(/\s+/g, " ")
+            .trim()
+            .slice(0, 80);
+        outline.push({ tag, text });
+    }
+    return {
+        colors: [...colorMeta.entries()]
+            .sort((a, z) => z[1].count - a[1].count)
+            .slice(0, 40)
+            .map(([value, meta]) => ({
+            value,
+            count: meta.count,
+            properties: [...meta.properties].sort(),
+        })),
+        gradients: sortedByCount(gradients).slice(0, 12),
+        fontFamilies: sortedByCount(fontFamilies).slice(0, 12),
+        fontSizes: sortedByCount(fontSizes).slice(0, 24),
+        spacingValues: sortedByCount(spacing).slice(0, 24),
+        radiusValues: sortedByCount(radii).slice(0, 12),
+        shadows: sortedByCount(shadows).slice(0, 12),
+        outline,
+    };
+}
+/** Compact, prompt-friendly rendering of the inventory. */
+export function formatGenesisInventory(inv) {
+    const lines = [];
+    lines.push(`Colors (${inv.colors.length}): ${inv.colors
+        .map((c) => `${c.value}×${c.count}[${c.properties.join("/")}]`)
+        .join(", ")}`);
+    if (inv.gradients.length > 0)
+        lines.push(`Gradients: ${inv.gradients.join(" | ")}`);
+    lines.push(`Font families: ${inv.fontFamilies.join(", ") || "(none declared)"}`);
+    lines.push(`Font sizes: ${inv.fontSizes.join(", ")}`);
+    lines.push(`Spacing values: ${inv.spacingValues.join(", ")}`);
+    if (inv.radiusValues.length > 0)
+        lines.push(`Radii: ${inv.radiusValues.join(", ")}`);
+    if (inv.shadows.length > 0)
+        lines.push(`Shadows: ${inv.shadows.join(" | ")}`);
+    lines.push(`Outline: ${inv.outline.map((o) => `<${o.tag}>${o.text ? ` ${o.text}` : ""}`).join(" → ")}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=genesis-inventory.js.map

package/dist/genesis-inventory.js.map

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

package/dist/genesis.d.ts

@@ -0,0 +1,102 @@
+/**
+ * issue #163 — Site Genesis shared shapes; issue #375 generalises the
+ * same draft loop to growth-time.
+ *
+ * Design-time is divergent: the AI drafts complete freeform HTML pages
+ * (one per design direction) and the operator picks one; the CMS
+ * structure is derived FROM that choice (#164's compiler). Growth-time
+ * reuses the identical draft → present → select → materialise loop at
+ * smaller scope: `page` and `module` drafts are FRAGMENTS bound to the
+ * site's `var(--…)` theme tokens, composed into the real theme shell
+ * only at view time (never an AI approximation of the theme — #375).
+ * These are the boundary schemas for the brief + the draft rows.
+ */
+import { z } from "zod";
+/**
+ * The structured Design Brief the discovery dialog produces. Every
+ * field optional — the AI fills what the conversation answered; the
+ * draft prompts degrade gracefully on gaps. Stored on
+ * `site_defaults.design_brief`.
+ */
+export declare const designBriefSchema: z.ZodObject<{
+    audience: z.ZodOptional<z.ZodString>;
+    moodWords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodString>;
+    industry: z.ZodOptional<z.ZodString>;
+    differentiators: z.ZodOptional<z.ZodString>;
+    imageryDirection: z.ZodOptional<z.ZodString>;
+    avoid: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DesignBrief = z.infer<typeof designBriefSchema>;
+/** Complete single-file drafts stay well under this (inline CSS only). */
+export declare const GENESIS_DRAFT_MAX_HTML_BYTES = 300000;
+export declare const genesisDraftStatus: z.ZodEnum<{
+    candidate: "candidate";
+    selected: "selected";
+    discarded: "discarded";
+}>;
+export type GenesisDraftStatus = z.infer<typeof genesisDraftStatus>;
+/** issue #199 — where a draft came from. */
+export declare const genesisDraftSourceKind: z.ZodEnum<{
+    genesis: "genesis";
+    byod_image: "byod_image";
+    byod_html: "byod_html";
+}>;
+export type GenesisDraftSourceKind = z.infer<typeof genesisDraftSourceKind>;
+/**
+ * issue #375 — what a draft covers. `site` is the Genesis case (a whole
+ * new design); `page` / `module` are growth-time variants of something
+ * that already exists.
+ */
+export declare const designDraftScope: z.ZodEnum<{
+    module: "module";
+    page: "page";
+    site: "site";
+}>;
+export type DesignDraftScope = z.infer<typeof designDraftScope>;
+/**
+ * issue #375 — how a draft's HTML is stored. `site` drafts are complete
+ * standalone documents (Genesis, unchanged); `page`/`module` drafts are
+ * fragments that only become a renderable document when composed with
+ * the site's real theme shell at view time — so a stored variant never
+ * freezes a stale copy of the theme.
+ */
+export declare const designDraftFormat: z.ZodEnum<{
+    document: "document";
+    fragment: "fragment";
+}>;
+export type DesignDraftFormat = z.infer<typeof designDraftFormat>;
+/** The stored format is fully determined by the scope (see the paired
+ *  DB CHECK constraint): `site` → standalone document, else fragment. */
+export declare function draftFormatForScope(scope: DesignDraftScope): DesignDraftFormat;
+/** Scope/target pairing rules shared by the op and the AI tool. */
+export declare const genesisAddDraftInput: z.ZodObject<{
+    direction: z.ZodString;
+    rationale: z.ZodDefault<z.ZodString>;
+    html: z.ZodString;
+    scope: z.ZodDefault<z.ZodEnum<{
+        module: "module";
+        page: "page";
+        site: "site";
+    }>>;
+    targetPageId: z.ZodOptional<z.ZodString>;
+    targetModuleId: z.ZodOptional<z.ZodString>;
+    variantSetId: z.ZodOptional<z.ZodString>;
+    sourceKind: z.ZodDefault<z.ZodEnum<{
+        genesis: "genesis";
+        byod_image: "byod_image";
+        byod_html: "byod_html";
+    }>>;
+    referenceAssetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type GenesisAddDraftInput = z.infer<typeof genesisAddDraftInput>;
+/**
+ * issue #199 — strip <script> blocks from operator-provided draft
+ * HTML. Defense in depth: drafts render inside sandbox="" iframes
+ * (scripts never execute there), but stored HTML flows onward into
+ * materialisation, so the boundary removes them outright. Linear
+ * scan per the #113 discipline; case-insensitive; unterminated
+ * script blocks drop everything to EOF (never leak half a script).
+ */
+export declare function sanitizeDraftHtml(html: string): string;
+//# sourceMappingURL=genesis.d.ts.map

package/dist/genesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis.d.ts","sourceRoot":"","sources":["../src/genesis.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;kBAWnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAEpD,eAAO,MAAM,kBAAkB;;;;EAAiD,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB;;;;EAAiD,CAAC;AACrF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;EAAqC,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;EAAmC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;yEACyE;AACzE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAE9E;AA+BD,mEAAmE;AACnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;kBA2B/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtD"}