@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/template-engine.js

@@ -0,0 +1,403 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * Shared template engine for AI-authored module HTML. Consolidates the
+ * no-DB `applyFieldSubstitution` in `preview-compose.ts` and the
+ * DB-aware `substituteWithRecursion` in `preview-render.ts` into a
+ * single engine built on `mustache.js` (Plan B per issue #71).
+ *
+ * Grammar (a Mustache subset — see CMS_REQUIREMENTS §3.1 / §5):
+ *   {{name}}                  — primitive substitution
+ *   {{#name}}…inner…{{/name}}  — section: ITERATES over a list field
+ *                                 (text-list / link-list / module-list);
+ *                                 for a SCALAR (text/image/…) or single
+ *                                 `module` field it is a CONDITIONAL —
+ *                                 the block renders once when the field
+ *                                 has a value, and is dropped when empty
+ *                                 (never a kind-mismatch — that used to
+ *                                 silently drop real scalar content)
+ *   {{>name}}                 — single nested module reference
+ *                                 (module field kind)
+ *
+ * Substitution priority for {{name}}:
+ *   1. contentValues[name]    — per-placement value
+ *   2. fields[name].default   — module-level default
+ *   3. raw `{{name}}` left in place  (CLAUDE.md §2 — no fallbacks pre-1.0,
+ *                                     so broken templates stay visible)
+ *
+ * Loud-raw invariant: an unknown `{{name}}` / `{{#name}}` / `{{>name}}`
+ * (no matching declared field) is left as raw text in the output, not
+ * silenced. Mustache's "unknown → empty string" default is overridden
+ * by a sentinel pre-scan + post-substitute pass that re-injects the
+ * original Mustache source after rendering. See plan §2 risk #2.
+ *
+ * Failure markers preserved verbatim from the legacy preview-render
+ * for `missingSlots`: `field-not-declared:<name>`,
+ * `kind-mismatch:<name> expected=<…> actual=<kind>`,
+ * `text-list-malformed:<name>[<i>]`, `link-list-malformed:<name>[<i>]`,
+ * `module-list-malformed:<name>[<i>]`, `module-ref-malformed:<name>`.
+ * v0.11.1 (issue #76): `theme-asset-unbound:<slot>` for the four
+ * `{{theme_<slot>_url}}` placeholders when the active theme's asset
+ * slot isn't bound.
+ * The chat-runner diag pass + editor missing-content surface read
+ * these literal strings; any rename is a silent regression for them.
+ *
+ * No HTML escaping. Module HTML substitutes raw — modules are the
+ * place raw HTML lives (CMS_REQUIREMENTS §3.1). Auto-escape would
+ * silently break every <a href="{{url}}"> in the catalog. The
+ * `Mustache.escape` override at module load is the public Mustache
+ * configuration knob; the engine module is the sole workspace
+ * importer of mustache so the singleton mutation is scoped in
+ * effect.
+ *
+ * Partials are caller-supplied (sync `Record<string, string>`). The
+ * compose path passes an empty map (no DB) — module / module-list
+ * refs become loud HTML comments so static-gen output is visible-
+ * broken instead of silent-empty. The preview-render path
+ * pre-resolves each nested ref via its existing RenderResolver walk
+ * (depth-limit + cycle-detection live there, untouched) and supplies
+ * the rendered HTML as a partial.
+ */
+import Mustache from "mustache";
+import { MODULE_FIELD_SECTION_KINDS } from "./content.js";
+import { stripCdataGuards } from "./strip-cdata.js";
+// Override Mustache's default HTML escape — module HTML substitutes
+// raw. The engine module is the only workspace importer of mustache,
+// so the singleton mutation is scoped in effect. Plan §2 risk #1: the
+// {{href}} test pins this; any leak of the default escape fails.
+Mustache.escape = (s) => (s === null || s === undefined ? "" : String(s));
+// Field names per the v0.4.0 + v0.12.0 grammar: lowercase ASCII +
+// digits + underscores. Case-insensitive primitive matching (the AI
+// sometimes camelCases the placeholder when extracting from existing
+// HTML) is handled below via lowercased view lookup. Whitespace
+// between `{{` and the sigil (#, >, /) is permitted to match the
+// Mustache spec — an extractor that pretty-prints AI-authored HTML
+// shouldn't silently break section / partial dispatch.
+// The section body uses a "tempered dot" — `(?:(?!CLOSE)[\s\S])*` — instead
+// of a lazy `[\s\S]*?`. The lazy form makes the engine try, then backtrack,
+// the close-tag match at every interior position, which is O(n²) on
+// unclosed/large input (CodeQL js/polynomial-redos). The tempered form
+// consumes one character only when the close tag does not start there, so
+// there is a single unambiguous path. The capture stops at the first close
+// tag for the captured name, exactly as the lazy form did — same output.
+const SECTION_RE = /\{\{\s*#\s*([a-z][a-z0-9_]*)\s*\}\}((?:(?!\{\{\s*\/\s*\1\s*\}\})[\s\S])*)\{\{\s*\/\s*\1\s*\}\}/g;
+const PARTIAL_RE = /\{\{\s*>\s*([a-z][a-z0-9_]*)\s*\}\}/g;
+const PRIMITIVE_RE = /\{\{\s*([a-zA-Z][a-zA-Z0-9_]*)\s*\}\}/g;
+// Section-dispatch kinds (the engine's `{{#name}}` operand). Imported
+// from content.ts so new list-shaped kinds wire through automatically
+// when the canonical declaration is extended.
+const SECTION_KINDS = new Set(MODULE_FIELD_SECTION_KINDS);
+// v0.11.1 (issue #76) — the four theme-asset substitutions the engine
+// resolves from `RenderTemplateInput.themeAssets`. Keys are the
+// `{{name}}` placeholders module authors write; the table maps them
+// back to the asset slot on the ComposeTheme.assets aggregate.
+const THEME_ASSET_KEY_TO_SLOT = {
+    theme_logo_url: "logo",
+    theme_logo_dark_url: "logoDark",
+    theme_favicon_url: "favicon",
+    theme_social_share_url: "socialShare",
+};
+const THEME_ASSET_KEYS = Object.keys(THEME_ASSET_KEY_TO_SLOT);
+function isNestedRef(v) {
+    return (typeof v === "object" &&
+        v !== null &&
+        typeof v.moduleId === "string" &&
+        typeof v.contentInstanceId === "string");
+}
+/**
+ * Render a `caelo:missing` HTML comment carrying a failure reason.
+ * The shape (`<!-- caelo:missing reason=<…> -->`) is part of the
+ * public failure-marker contract — the chat-runner diag pass reads
+ * the comment text out of rendered HTML, and the editor's missing-
+ * content surface highlights it for the operator. Exported so the
+ * DB-aware preview-render path (`packages/admin-core/src/ops/content/
+ * preview-render.ts`) emits the exact same shape without redeclaring.
+ */
+export function caeloMissingComment(reason) {
+    return `<!-- caelo:missing reason=${reason} -->`;
+}
+const comment = caeloMissingComment;
+/**
+ * Render `html` against `contentValues` + `fields` + `partials`,
+ * returning the substituted HTML plus a structured `missingSlots`
+ * channel. Pure / sync / no IO.
+ *
+ * @example
+ * // AC #1 fixture (issue #71). Iterates a link-list field per element.
+ * renderTemplate({
+ *   html: '<nav>{{#nav_items}}<a href="{{href}}">{{label}}</a>{{/nav_items}}</nav>',
+ *   fields: [{ name: 'nav_items', kind: 'link-list' }],
+ *   contentValues: {
+ *     nav_items: [
+ *       { label: 'Docs', href: '/docs' },
+ *       { label: 'Blog', href: '/blog' },
+ *     ],
+ *   },
+ * });
+ * // → {
+ * //     html: '<nav><a href="/docs">Docs</a><a href="/blog">Blog</a></nav>',
+ * //     missingSlots: [],
+ * //   }
+ *
+ * @see {@link TemplateField} for the field shape (name + kind + optional default).
+ * @see {@link ./content.js#MODULE_FIELD_KINDS} for the canonical kind union.
+ * @see {@link ./content.js#MODULE_FIELD_SECTION_KINDS} for the kinds the engine
+ *      iterates via `{{#name}}` (text-list / link-list / module-list).
+ */
+export function renderTemplate(input) {
+    const missing = [];
+    const fieldByName = new Map();
+    for (const f of input.fields)
+        fieldByName.set(f.name, f);
+    const cvs = input.contentValues ?? {};
+    const partials = input.partials ?? {};
+    // Sentinels survive Mustache.render untouched (they contain no
+    // `{{` `}}`), then get restored to the original Mustache source
+    // after render — the loud-raw invariant. The prefix carries a
+    // per-call UUID so the sentinel string is unguessable from the
+    // outside: a module author who pastes the literal `__CAELO_TPL_…__`
+    // pattern into their HTML can't break loud-raw restore by
+    // intercepting the sentinel for a known-key sentinel — they would
+    // have to guess the UUID minted at render time.
+    const sentinels = new Map();
+    const sentinelPrefix = `__CAELO_TPL_${globalThis.crypto.randomUUID()}_`;
+    const mkSentinel = (original) => {
+        const key = `${sentinelPrefix}${sentinels.size}__`;
+        sentinels.set(key, original);
+        return key;
+    };
+    // 0. Defensively unwrap XHTML-style CDATA guards the model sometimes
+    //    emits around inline <style>/<script> — they otherwise survive the
+    //    byte-preserving compose path and leak a stray `]]>` into the page.
+    //    Store-time normalization (modules.create/update) cleans new
+    //    modules; this covers any already-stored HTML + the deploy render.
+    const sourceHtml = stripCdataGuards(input.html);
+    // 1. {{#name}}…{{/name}} sections.
+    let html = sourceHtml.replace(SECTION_RE, (match, name, inner) => renderSection(match, name, inner, fieldByName, cvs, partials, missing, mkSentinel));
+    // 2. {{>name}} single partials.
+    html = html.replace(PARTIAL_RE, (match, name) => renderPartialRef(match, name, fieldByName, cvs, partials, missing, mkSentinel));
+    // 3. {{name}} primitives. Pre-rewrite to canonical lowercase form
+    //    so the (lowercased) view picks them up regardless of source
+    //    casing. Unknowns become sentinels for loud-raw.
+    const declaredFieldNames = new Set();
+    for (const f of input.fields) {
+        declaredFieldNames.add(f.name);
+        declaredFieldNames.add(f.name.toLowerCase());
+    }
+    const view = {};
+    for (const [k, v] of Object.entries(cvs)) {
+        view[k.toLowerCase()] = v === null || v === undefined ? "" : v;
+    }
+    for (const f of input.fields) {
+        const lower = f.name.toLowerCase();
+        if (lower in view)
+            continue;
+        if (SECTION_KINDS.has(f.kind) || f.kind === "module")
+            continue;
+        if (f.default !== undefined && f.default !== null)
+            view[lower] = f.default;
+    }
+    // v0.11.1 (issue #76) — pre-populate four theme-asset substitutions
+    // when the caller supplied `themeAssets`. `contentValues` already
+    // populated `view` above so any per-placement override wins (per
+    // §S19's "contentValues take precedence" invariant). Unbound slots
+    // (null) DON'T land in the view — they fall through to the loud-raw
+    // path below, but mark themselves with `theme-asset-unbound:<slot>`
+    // so the failure marker disambiguates from `field-not-declared`.
+    const themeAssetKeys = THEME_ASSET_KEYS;
+    const themeAssetSlotByKey = THEME_ASSET_KEY_TO_SLOT;
+    const themeAssets = input.themeAssets;
+    if (themeAssets) {
+        for (const key of themeAssetKeys) {
+            const slot = themeAssetSlotByKey[key];
+            const url = themeAssets[slot];
+            if (typeof url === "string" && url.length > 0 && !(key in view)) {
+                view[key] = url;
+            }
+        }
+    }
+    html = html.replace(PRIMITIVE_RE, (match, name) => {
+        const lower = name.toLowerCase();
+        if (lower in view)
+            return `{{${lower}}}`;
+        // v0.11.1 (issue #76) — theme-asset placeholder with no bound URL.
+        // Use a dedicated marker so the failure surface disambiguates from
+        // the generic field-not-declared marker.
+        if (lower in themeAssetSlotByKey) {
+            const slot = themeAssetSlotByKey[lower];
+            missing.push(`theme-asset-unbound:${slot}`);
+            return mkSentinel(match);
+        }
+        // No value + no default: leave raw (CLAUDE.md §2). Track in
+        // missingSlots only when the field isn't declared at all —
+        // declared-but-empty is the operator's responsibility (still
+        // authoring), not a system-side gap callers should warn about.
+        if (!declaredFieldNames.has(name) && !declaredFieldNames.has(lower)) {
+            missing.push(`field-not-declared:${name}`);
+        }
+        return mkSentinel(match);
+    });
+    // 4. Render. The view holds only lowercase keys; sentinels survive
+    //    untouched; sections + partials are already pre-substituted.
+    const rendered = Mustache.render(html, view);
+    // 5. Restore loud-raw sentinels.
+    let final = rendered;
+    for (const [sentinel, original] of sentinels) {
+        final = final.split(sentinel).join(original);
+    }
+    return { html: final, missingSlots: missing };
+}
+function renderSection(match, name, inner, fields, cvs, partials, missing, mkSentinel) {
+    const field = fields.get(name);
+    if (!field) {
+        missing.push(`field-not-declared:${name}`);
+        return mkSentinel(match);
+    }
+    if (field.kind === "module-list") {
+        return renderModuleList(name, field, cvs, partials, missing);
+    }
+    if (field.kind === "text-list") {
+        return renderTextList(name, inner, field, cvs, missing);
+    }
+    if (field.kind === "link-list") {
+        return renderLinkList(name, inner, field, cvs, missing);
+    }
+    // Any NON-list field used as a `{{#name}}…{{/name}}` section is a
+    // CONDITIONAL (Mustache semantics): render the inner block once when the
+    // field has a present, non-empty value; drop it when empty. This is what
+    // makes `{{#subtitle}}<p>{{subtitle}}</p>{{/subtitle}}` wrap a scalar
+    // text/image field — previously a scalar in a section fell through to
+    // `kind-mismatch` and SILENTLY DROPPED real content (headings, body copy,
+    // an image, a single nested module). `{{name}}` inside the block resolves
+    // in the later primitive pass (a `module` field's `{{>name}}` in the
+    // partial pass); `{{.}}`/`{{item}}` are substituted here for parity with
+    // the *-list renderers. An empty conditional is intentional, not
+    // "missing" — nothing is pushed to `missing`.
+    return renderConditionalSection(name, inner, field, cvs);
+}
+/**
+ * Render a `{{#name}}…{{/name}}` section over a scalar/module field as a
+ * Mustache conditional: the block once when the value is present, else "".
+ */
+function renderConditionalSection(name, inner, field, cvs) {
+    const raw = Object.hasOwn(cvs, name) ? cvs[name] : field.default;
+    if (!isPresentSectionValue(raw))
+        return "";
+    const value = scalarSectionString(raw);
+    return value.length > 0 ? inner.replace(/\{\{\s*(?:\.|item)\s*\}\}/g, () => value) : inner;
+}
+/**
+ * Mustache-style truthiness for a conditional section value. Empty string,
+ * null/undefined, `false`, and an empty array/object are absent; everything
+ * else (incl. a numeric 0 — a real content value, not a control flag) is
+ * present.
+ */
+function isPresentSectionValue(raw) {
+    if (raw === undefined || raw === null || raw === false)
+        return false;
+    if (typeof raw === "string")
+        return raw.trim().length > 0;
+    if (typeof raw === "number")
+        return !Number.isNaN(raw);
+    if (Array.isArray(raw))
+        return raw.length > 0;
+    if (typeof raw === "object")
+        return Object.keys(raw).length > 0;
+    return true;
+}
+/** String form for `{{.}}`/`{{item}}` inside a scalar conditional. Objects
+ *  (module refs / image objects) render through `{{name}}`/`{{>name}}`, not
+ *  `{{.}}`, so they stringify to "". */
+function scalarSectionString(raw) {
+    if (typeof raw === "string")
+        return raw;
+    if (typeof raw === "number" || typeof raw === "boolean")
+        return String(raw);
+    return "";
+}
+function renderTextList(name, inner, field, cvs, missing) {
+    const raw = Object.hasOwn(cvs, name) ? cvs[name] : field.default;
+    if (!Array.isArray(raw))
+        return "";
+    const parts = [];
+    for (let i = 0; i < raw.length; i += 1) {
+        const el = raw[i];
+        if (typeof el !== "string" && typeof el !== "number" && typeof el !== "boolean") {
+            missing.push(`text-list-malformed:${name}[${i}]`);
+            parts.push(comment(`text-list-malformed ${name}[${i}]`));
+            continue;
+        }
+        const value = String(el);
+        parts.push(inner.replace(/\{\{\s*(?:\.|item)\s*\}\}/g, () => value));
+    }
+    return parts.join("");
+}
+function renderLinkList(name, inner, field, cvs, missing) {
+    const raw = Object.hasOwn(cvs, name) ? cvs[name] : field.default;
+    if (!Array.isArray(raw))
+        return "";
+    const parts = [];
+    for (let i = 0; i < raw.length; i += 1) {
+        const el = raw[i];
+        if (typeof el !== "object" ||
+            el === null ||
+            typeof el.label !== "string" ||
+            typeof el.href !== "string") {
+            missing.push(`link-list-malformed:${name}[${i}]`);
+            parts.push(comment(`link-list-malformed ${name}[${i}]`));
+            continue;
+        }
+        const { label, href } = el;
+        parts.push(inner.replace(/\{\{\s*label\s*\}\}/g, () => label).replace(/\{\{\s*href\s*\}\}/g, () => href));
+    }
+    return parts.join("");
+}
+function renderModuleList(name, field, cvs, partials, missing) {
+    const raw = Object.hasOwn(cvs, name) ? cvs[name] : field.default;
+    if (!Array.isArray(raw))
+        return "";
+    const parts = [];
+    for (let i = 0; i < raw.length; i += 1) {
+        const el = raw[i];
+        if (!isNestedRef(el)) {
+            missing.push(`module-list-malformed:${name}[${i}]`);
+            parts.push(comment(`module-list-malformed ${name}[${i}]`));
+            continue;
+        }
+        const partialKey = `${name}__${i}`;
+        const partialHtml = partials[partialKey];
+        if (partialHtml === undefined) {
+            // Compose path: no DB → no partials → loud comment so
+            // operators see the gap. The preview-render path always
+            // supplies a partial (or routes a structured failure marker
+            // through it from renderInner), so this branch is the
+            // static-gen escape hatch until #70 lands.
+            parts.push(`<!-- caelo:module-list ${name} needs recursive renderer (compose path) -->`);
+            continue;
+        }
+        parts.push(partialHtml);
+    }
+    return parts.join("");
+}
+function renderPartialRef(match, name, fields, cvs, partials, missing, mkSentinel) {
+    const field = fields.get(name);
+    if (!field) {
+        missing.push(`field-not-declared:${name}`);
+        return mkSentinel(match);
+    }
+    if (field.kind !== "module") {
+        const reason = `kind-mismatch:${name} expected=module actual=${field.kind}`;
+        missing.push(reason);
+        return comment(reason);
+    }
+    const ref = cvs[name];
+    if (!isNestedRef(ref)) {
+        missing.push(`module-ref-malformed:${name}`);
+        return comment(`module-ref-malformed ${name}`);
+    }
+    const partialHtml = partials[name];
+    if (partialHtml === undefined) {
+        return `<!-- caelo:module ${name} needs recursive renderer (compose path) -->`;
+    }
+    return partialHtml;
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/template-engine.js.map

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

package/dist/theme-importers/auto-detect.d.ts

@@ -0,0 +1,26 @@
+/**
+ * v0.11.1 (issue #76) — theme import format auto-detection chain.
+ *
+ * Tries each importer in priority order:
+ *
+ *   1. DTCG (most specific: `$value` leaves)
+ *   2. Style Dictionary (`value` leaves)
+ *   3. Tailwind 4 (`@theme { … }` block)
+ *   4. shadcn (`:root { … }` CSS variables)
+ *   5. Loose key-value (`{looseName: value}` JSON object)
+ *
+ * The first importer that doesn't throw a "shape" rejection wins.
+ * "Hard" parse errors (e.g. TailwindImportError for calc()) surface
+ * verbatim — they signal the input WAS that format but unparseable.
+ *
+ * Returns `{format, tokens}` so the caller's tool result can echo the
+ * detected format back to the AI for next-turn awareness.
+ */
+import type { ThemeDocument } from "../themes.js";
+export type DetectedFormat = "dtcg" | "style-dictionary" | "tailwind" | "shadcn" | "loose";
+export interface AutoDetectResult {
+    readonly format: DetectedFormat;
+    readonly tokens: ThemeDocument;
+}
+export declare function autoDetectAndImport(body: string): AutoDetectResult;
+//# sourceMappingURL=auto-detect.d.ts.map

package/dist/theme-importers/auto-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-detect.d.ts","sourceRoot":"","sources":["../../src/theme-importers/auto-detect.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAelD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAqBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqBlE"}

package/dist/theme-importers/auto-detect.js

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: MPL-2.0
+import { NoImporterMatched, NotDtcgShape, NotLooseShape, NotShadcnShape, NotStyleDictionaryShape, NotTailwindShape, } from "../themes-errors.js";
+import { importDtcg } from "./dtcg.js";
+import { importLoose } from "./loose.js";
+import { importShadcn } from "./shadcn.js";
+import { importStyleDictionary } from "./style-dictionary.js";
+import { importTailwind } from "./tailwind.js";
+const CHAIN = [
+    { format: "dtcg", importer: importDtcg, fallThroughOn: [NotDtcgShape] },
+    {
+        format: "style-dictionary",
+        importer: importStyleDictionary,
+        fallThroughOn: [NotStyleDictionaryShape],
+    },
+    { format: "tailwind", importer: importTailwind, fallThroughOn: [NotTailwindShape] },
+    { format: "shadcn", importer: importShadcn, fallThroughOn: [NotShadcnShape] },
+    { format: "loose", importer: importLoose, fallThroughOn: [NotLooseShape] },
+];
+export function autoDetectAndImport(body) {
+    const attempts = [];
+    for (const def of CHAIN) {
+        try {
+            const tokens = def.importer(body);
+            return { format: def.format, tokens };
+        }
+        catch (e) {
+            const isFallThrough = def.fallThroughOn.some((cls) => e instanceof cls);
+            if (!isFallThrough) {
+                // Hard error: the input WAS in this format but the importer
+                // can't handle it. Surface verbatim so the operator/AI gets a
+                // concrete fix-it.
+                throw e;
+            }
+            attempts.push({
+                format: def.format,
+                reason: e instanceof Error ? (e.message.split("\n")[0] ?? "rejected") : "rejected",
+            });
+        }
+    }
+    throw new NoImporterMatched(attempts);
+}
+//# sourceMappingURL=auto-detect.js.map

package/dist/theme-importers/auto-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-detect.js","sourceRoot":"","sources":["../../src/theme-importers/auto-detect.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAsBnC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgB/C,MAAM,KAAK,GAA2B;IACpC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,YAAY,CAAC,EAAE;IACvE;QACE,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,qBAAqB;QAC/B,aAAa,EAAE,CAAC,uBAAuB,CAAC;KACzC;IACD,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,gBAAgB,CAAC,EAAE;IACnF,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE;IAC7E,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,aAAa,CAAC,EAAE;CAC3E,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAA8C,EAAE,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;YACxE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,4DAA4D;gBAC5D,8DAA8D;gBAC9D,mBAAmB;gBACnB,MAAM,CAAC,CAAC;YACV,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU;aACnF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/theme-importers/css-comments.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Strip `/* … *\/` block comments from a CSS string.
+ *
+ * The body uses a "tempered dot" (`(?:(?!\*\/)[\s\S])*`) rather than a lazy
+ * `[\s\S]*?`: the lazy form backtracks O(n²) on an unterminated comment in
+ * untrusted theme CSS (CodeQL js/polynomial-redos). The tempered form has a
+ * single unambiguous match path and stops at the first `*\/`, so the output
+ * is identical to the lazy form on valid CSS. Single-sourced here so the two
+ * theme importers (tailwind, shadcn) cannot drift to a vulnerable variant.
+ */
+export declare function stripCssComments(css: string): string;
+//# sourceMappingURL=css-comments.d.ts.map

package/dist/theme-importers/css-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-comments.d.ts","sourceRoot":"","sources":["../../src/theme-importers/css-comments.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/theme-importers/css-comments.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * Strip `/* … *\/` block comments from a CSS string.
+ *
+ * The body uses a "tempered dot" (`(?:(?!\*\/)[\s\S])*`) rather than a lazy
+ * `[\s\S]*?`: the lazy form backtracks O(n²) on an unterminated comment in
+ * untrusted theme CSS (CodeQL js/polynomial-redos). The tempered form has a
+ * single unambiguous match path and stops at the first `*\/`, so the output
+ * is identical to the lazy form on valid CSS. Single-sourced here so the two
+ * theme importers (tailwind, shadcn) cannot drift to a vulnerable variant.
+ */
+export function stripCssComments(css) {
+    return css.replace(/\/\*(?:(?!\*\/)[\s\S])*\*\//g, "");
+}
+//# sourceMappingURL=css-comments.js.map

package/dist/theme-importers/css-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-comments.js","sourceRoot":"","sources":["../../src/theme-importers/css-comments.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/theme-importers/dtcg.d.ts

@@ -0,0 +1,46 @@
+/**
+ * v0.11.0 — DTCG (W3C Design Tokens Format) import / export for the
+ * `themes` primitive (#45 Phase 7 slice 1).
+ *
+ * The full format-auto-detect (Style Dictionary / Tailwind 4 @theme /
+ * shadcn `:root` / loose key-value) is v0.11.2 — see the follow-up
+ * comment §4 on #45. This slice ships the DTCG side only so design
+ * tooling (Figma, Tokens Studio, Style Dictionary) round-trips cleanly
+ * from day one.
+ *
+ * The shape we accept IS the same shape `themes.tokens` jsonb carries,
+ * because `themes.ts`'s Zod schema mirrors DTCG. So `importDtcg` is
+ * essentially `JSON.parse + validateThemeTokens`; `exportDtcg` returns
+ * the stored tokens jsonb after stable-stringification. The wrappers
+ * exist so we have explicit entry points to grow Style-Dictionary /
+ * Tailwind / shadcn / loose parsers next to in v0.11.2 without
+ * widening `themes.ts`.
+ */
+import { type Theme, type ThemeDocument } from "../themes.js";
+/**
+ * Parse a DTCG JSON document into a validated tokens tree. Three
+ * failure surfaces:
+ *
+ *   1. Malformed JSON         → `DTCG parse failed: <SyntaxError msg>`
+ *   2. Valid JSON, no `$value` anywhere → `NotDtcgShape` (round-2
+ *      opt §2: pre-Zod sniff for the common case where the operator
+ *      pastes a Tailwind / Style Dictionary / Figma export and the
+ *      AI sees a deeply-nested Zod path mismatch instead of a clear
+ *      "this isn't DTCG" hint).
+ *   3. Valid JSON, has $value leaves, but Zod rejects something → the
+ *      ZodError surfaces verbatim (per-token path mismatch, missing
+ *      composite sub-field, etc.).
+ */
+export declare function importDtcg(body: string): ThemeDocument;
+/**
+ * Emit a stable DTCG JSON document for the given theme. Keys are
+ * sorted alphabetically at every nesting level so the output is
+ * byte-for-byte deterministic — Style Dictionary / Tokens Studio diff
+ * cleanly under git.
+ *
+ * Only `tokens` is exported; asset URLs and the `is_active` flag are
+ * Caelo-specific and have no DTCG representation. Operators bind
+ * assets through `set_theme_asset`, not through an exported JSON file.
+ */
+export declare function exportDtcg(theme: Pick<Theme, "tokens">): string;
+//# sourceMappingURL=dtcg.d.ts.map

package/dist/theme-importers/dtcg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg.d.ts","sourceRoot":"","sources":["../../src/theme-importers/dtcg.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,aAAa,EAAuB,MAAM,cAAc,CAAC;AAGnF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAYtD;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,CAE/D"}