@caelo-cms/shared 0.10.21 → 0.10.23

package/dist/theme-importers/tailwind.js

@@ -0,0 +1,218 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * v0.11.1 (issue #76) — Tailwind 4 `@theme { … }` block importer.
+ *
+ * Tailwind 4 defines theme tokens in a `@theme` (or `@theme inline`) at-rule:
+ *
+ *   @theme {
+ *     --color-primary: #ff6600;
+ *     --spacing-md: 1rem;
+ *     --font-sans: Inter, system-ui;
+ *   }
+ *
+ * The importer extracts each `--<namespace>-<rest>: <value>;` line from
+ * the brace pair and maps it onto a DTCG path via the inverse of
+ * `theme-render.ts`'s namespace table (`color.<rest>`, `spacing.<rest>`,
+ * etc.). The result is validated by `validateThemeTokens`.
+ *
+ * Deliberately forgiving — handles `@theme inline`, single-line / block
+ * comments, blank lines. Hard-fails (TailwindImportError) on calc() /
+ * nested at-rules so the operator gets a concrete fix-it message
+ * instead of silently-truncated output.
+ */
+import { isUnsafeKey } from "../safe-keys.js";
+import { validateThemeTokens } from "../themes.js";
+import { NotTailwindShape, TailwindImportError } from "../themes-errors.js";
+import { stripCssComments } from "./css-comments.js";
+export function importTailwind(body) {
+    const block = extractAtThemeBlock(body);
+    if (block === null) {
+        throw new NotTailwindShape();
+    }
+    const entries = parseCssVarBlock(block);
+    if (entries.length === 0) {
+        throw new NotTailwindShape("@theme block found but no `--name: value;` pairs inside");
+    }
+    const doc = mapEntriesToDtcg(entries);
+    return validateThemeTokens(doc);
+}
+/**
+ * Locate the body of the first `@theme` (or `@theme inline`) at-rule.
+ * Returns the contents inside the matching `{ … }` (no braces, no
+ * outer whitespace) or null when no block is present.
+ */
+function extractAtThemeBlock(body) {
+    const stripped = stripCssComments(body);
+    const match = /@theme\s+(?:inline\s+)?\{/i.exec(stripped);
+    if (!match)
+        return null;
+    const start = match.index + match[0].length;
+    let depth = 1;
+    let i = start;
+    while (i < stripped.length && depth > 0) {
+        const ch = stripped[i];
+        if (ch === "{")
+            depth += 1;
+        else if (ch === "}")
+            depth -= 1;
+        if (depth === 0)
+            break;
+        i += 1;
+    }
+    if (depth !== 0)
+        return null;
+    return stripped.slice(start, i);
+}
+function parseCssVarBlock(block) {
+    const entries = [];
+    // Split on `;` so each entry is one declaration. Skip empty
+    // fragments and any line that doesn't start with `--`.
+    for (const raw of block.split(";")) {
+        const line = raw.trim();
+        if (line.length === 0)
+            continue;
+        if (line.startsWith("//"))
+            continue;
+        if (!line.startsWith("--")) {
+            // Catch nested at-rules; the importer doesn't handle them.
+            if (line.startsWith("@")) {
+                throw new TailwindImportError("nested @-rule", line);
+            }
+            // Tolerate plain identifiers (`color-scheme: dark` etc.) — skip silently.
+            continue;
+        }
+        const colonIdx = line.indexOf(":");
+        if (colonIdx <= 0)
+            continue;
+        const name = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        if (value.length === 0)
+            continue;
+        if (/\bcalc\s*\(/i.test(value)) {
+            throw new TailwindImportError("calc()", line);
+        }
+        if (/\bvar\s*\(/i.test(value)) {
+            throw new TailwindImportError("var()", line);
+        }
+        entries.push({ name, value });
+    }
+    return entries;
+}
+/**
+ * Map each `--<namespace>-<rest>` entry to a DTCG group. The namespace
+ * table mirrors theme-render.ts's emit table inverted.
+ */
+function mapEntriesToDtcg(entries) {
+    const out = {};
+    for (const entry of entries) {
+        // Strip the leading `--` and split on the first hyphen.
+        const stripped = entry.name.slice(2);
+        const firstHyphen = stripped.indexOf("-");
+        if (firstHyphen <= 0)
+            continue; // no category prefix → skip
+        const ns = stripped.slice(0, firstHyphen);
+        const rest = stripped.slice(firstHyphen + 1);
+        let category;
+        let leafName;
+        let extraSubField = null;
+        switch (ns) {
+            case "color":
+                category = "color";
+                leafName = rest;
+                break;
+            case "spacing":
+                category = "spacing";
+                leafName = rest;
+                break;
+            case "radius":
+                category = "radius";
+                leafName = rest;
+                break;
+            case "shadow":
+                category = "shadow";
+                leafName = rest;
+                break;
+            case "breakpoint":
+                category = "breakpoint";
+                leafName = rest;
+                break;
+            case "duration":
+                category = "duration";
+                leafName = rest;
+                break;
+            case "ease":
+                category = "ease";
+                leafName = rest;
+                break;
+            case "font":
+                // --font-sans → typography.sans.fontFamily
+                category = "typography";
+                leafName = rest;
+                extraSubField = "fontFamily";
+                break;
+            case "text":
+                // --text-base → typography.base.fontSize
+                category = "typography";
+                leafName = rest;
+                extraSubField = "fontSize";
+                break;
+            default:
+                // Unknown namespace — bucket under its own root so the renderer
+                // still emits the var (forward-compat).
+                category = ns;
+                leafName = rest;
+        }
+        // `category` and `leafName` are derived from the imported CSS variable
+        // name, so a hostile token like `--__proto__-x` could otherwise pollute
+        // the prototype chain via `out[category]` / `group[leafName]` (CodeQL
+        // js/prototype-polluting-assignment). Skip the entry on any unsafe key.
+        if (isUnsafeKey(category) || isUnsafeKey(leafName))
+            continue;
+        if (!out[category])
+            out[category] = {};
+        const group = out[category] ?? {};
+        if (extraSubField !== null) {
+            // Typography composite: merge into the existing leaf's $value.
+            const existing = group[leafName];
+            const baseObj = existing && typeof existing === "object" && "$value" in existing
+                ? existing.$value
+                : {};
+            group[leafName] = {
+                $value: { ...baseObj, [extraSubField]: entry.value },
+                $type: "typography",
+            };
+        }
+        else {
+            // v0.11.1 (issue #76 Copilot review #4): if `leafName` looks like
+            // a Tailwind ramp suffix (`primary-50` … `primary-900`,
+            // `primary-DEFAULT`), nest it as `<group>.<stop>` so the result
+            // matches the OKLCh ramp's DTCG group shape. Without this,
+            // `--color-primary-50` would land at the flat key `color['primary-50']`
+            // and downstream ramp-aware logic (DEFAULT-alias resolver, the
+            // ColorEditor's color.primary swatch, the propose-create explicit-
+            // stop override path) wouldn't see the stops as a group.
+            const rampMatch = /^(.+)-(50|100|200|300|400|500|600|700|800|900|DEFAULT)$/.exec(leafName);
+            const tokenLeaf = {
+                $value: entry.value,
+                $type: category === "color" ? "color" : category === "duration" ? "duration" : "dimension",
+            };
+            if (rampMatch && category === "color") {
+                const [, baseName, stop] = rampMatch;
+                // `baseName` is the ramp prefix parsed from the token name; guard it
+                // before it becomes a `group[baseName]` assignment target. `stop` is
+                // a fixed enum (50…900|DEFAULT), so it needs no guard.
+                if (isUnsafeKey(baseName))
+                    continue;
+                if (!group[baseName] || typeof group[baseName] !== "object") {
+                    group[baseName] = {};
+                }
+                group[baseName][stop] = tokenLeaf;
+            }
+            else {
+                group[leafName] = tokenLeaf;
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=tailwind.js.map

package/dist/theme-importers/tailwind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind.js","sourceRoot":"","sources":["../../src/theme-importers/tailwind.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAsB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOrD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,gBAAgB,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CAAC,yDAAyD,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;aACtB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM;QACvB,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,4DAA4D;IAC5D,uDAAuD;IACvD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,2DAA2D;YAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YACvD,CAAC;YACD,0EAA0E;YAC1E,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,IAAI,CAAC;YAAE,SAAS;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAA+B;IACvD,MAAM,GAAG,GAA4C,EAAE,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,wDAAwD;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,WAAW,IAAI,CAAC;YAAE,SAAS,CAAC,4BAA4B;QAC5D,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAE7C,IAAI,QAAgB,CAAC;QACrB,IAAI,QAAgB,CAAC;QACrB,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,OAAO;gBACV,QAAQ,GAAG,OAAO,CAAC;gBACnB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,GAAG,SAAS,CAAC;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,QAAQ;gBACX,QAAQ,GAAG,QAAQ,CAAC;gBACpB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,QAAQ;gBACX,QAAQ,GAAG,QAAQ,CAAC;gBACpB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,YAAY;gBACf,QAAQ,GAAG,YAAY,CAAC;gBACxB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,UAAU;gBACb,QAAQ,GAAG,UAAU,CAAC;gBACtB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,GAAG,MAAM,CAAC;gBAClB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,MAAM;gBACT,2CAA2C;gBAC3C,QAAQ,GAAG,YAAY,CAAC;gBACxB,QAAQ,GAAG,IAAI,CAAC;gBAChB,aAAa,GAAG,YAAY,CAAC;gBAC7B,MAAM;YACR,KAAK,MAAM;gBACT,yCAAyC;gBACzC,QAAQ,GAAG,YAAY,CAAC;gBACxB,QAAQ,GAAG,IAAI,CAAC;gBAChB,aAAa,GAAG,UAAU,CAAC;gBAC3B,MAAM;YACR;gBACE,gEAAgE;gBAChE,wCAAwC;gBACxC,QAAQ,GAAG,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,uEAAuE;QACvE,wEAAwE;QACxE,sEAAsE;QACtE,wEAAwE;QACxE,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC;YAAE,SAAS;QAE7D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,OAAO,GACX,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,IAAI,QAAQ;gBAC9D,CAAC,CAAG,QAAgC,CAAC,MAAkC;gBACvE,CAAC,CAAC,EAAE,CAAC;YACT,KAAK,CAAC,QAAQ,CAAC,GAAG;gBAChB,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE;gBACpD,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,kEAAkE;YAClE,wDAAwD;YACxD,gEAAgE;YAChE,2DAA2D;YAC3D,wEAAwE;YACxE,+DAA+D;YAC/D,mEAAmE;YACnE,yDAAyD;YACzD,MAAM,SAAS,GAAG,yDAAyD,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3F,MAAM,SAAS,GAAG;gBAChB,MAAM,EAAE,KAAK,CAAC,KAAK;gBACnB,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;aAC3F,CAAC;YACF,IAAI,SAAS,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACtC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,SAAgD,CAAC;gBAC5E,qEAAqE;gBACrE,qEAAqE;gBACrE,uDAAuD;gBACvD,IAAI,WAAW,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC5D,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBACvB,CAAC;gBACA,KAAK,CAAC,QAAQ,CAA6B,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAoB,CAAC;AAC9B,CAAC"}

package/dist/theme-literal-binding.d.ts

@@ -0,0 +1,37 @@
+import type { ThemeDocument } from "./themes.js";
+export interface ThemeValueMap {
+    /** normalized color value → var name (first-declared wins). */
+    readonly colors: ReadonlyMap<string, string>;
+    /** exact gradient string (normalized whitespace) → var name. */
+    readonly gradients: ReadonlyMap<string, string>;
+    /** dimension value → var name (suggestion-only tier). */
+    readonly dimensions: ReadonlyMap<string, string>;
+}
+/**
+ * Parse the light-branch declarations the renderer emits for this
+ * document into value → var-name maps.
+ */
+export declare function buildThemeValueMap(tokens: ThemeDocument): ThemeValueMap;
+export interface LiteralBindingResult {
+    readonly css: string;
+    /** Applied rewrites: literal → var name, with occurrence counts. */
+    readonly rewrites: readonly {
+        from: string;
+        to: string;
+        count: number;
+    }[];
+    /** Dimension matches left in place (too ambiguous to auto-rewrite). */
+    readonly suggestions: readonly {
+        literal: string;
+        varName: string;
+    }[];
+}
+/**
+ * Rewrite color/gradient literals that equal theme token values to
+ * `var(--name)`. Longest-first (gradients before their stop colors) so
+ * a gradient binds as a whole instead of stop-by-stop.
+ */
+export declare function applyThemeLiteralBinding(css: string, tokens: ThemeDocument): LiteralBindingResult;
+/** Tool-result suffix describing what binding did. Null on no-op. */
+export declare function formatBindingReport(result: LiteralBindingResult): string | null;
+//# sourceMappingURL=theme-literal-binding.d.ts.map

package/dist/theme-literal-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-literal-binding.d.ts","sourceRoot":"","sources":["../src/theme-literal-binding.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CA8BvE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1E,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,oBAAoB,CA2CjG;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAkB/E"}

package/dist/theme-literal-binding.js

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * issue #164 slice 2 — mechanical token binding ("AI decides, code
+ * executes"). During Genesis materialisation the theme is created FROM
+ * the draft's palette, so module CSS copied from the draft contains
+ * literals that EQUAL theme token values. Hand-translating them to
+ * `var(--…)` is transcription work the model can get subtly wrong;
+ * this module does it mechanically:
+ *
+ *   - colors + gradients whose literal value equals an emitted token's
+ *     value are rewritten to `var(--name)` (unambiguous: the value IS
+ *     the token's value);
+ *   - dimension-ish matches (a `6rem` that equals `--spacing-2xl`) are
+ *     reported as SUGGESTIONS only — generic lengths are too ambiguous
+ *     to rewrite silently.
+ *
+ * The value map is parsed from `renderThemeCss` output so binding uses
+ * exactly what the renderer emits (aliases resolved, ramps included) —
+ * no second resolution path to drift.
+ */
+import { replaceCssGradients } from "./css-gradient-scan.js";
+import { renderThemeCss } from "./theme-render.js";
+const COLOR_LITERAL_RE = /#[0-9a-fA-F]{3,8}\b|(?:oklch|rgba?|hsla?|lab|lch|hwb)\([^()]*\)/g;
+const DIMENSION_VALUE_RE = /^-?\d+(\.\d+)?(rem|em|px|%)$/;
+function normalizeColor(v) {
+    return v.trim().toLowerCase();
+}
+function normalizeGradient(v) {
+    return v.trim().toLowerCase().replace(/\s+/g, " ");
+}
+/**
+ * Parse the light-branch declarations the renderer emits for this
+ * document into value → var-name maps.
+ */
+export function buildThemeValueMap(tokens) {
+    const css = renderThemeCss(tokens);
+    // Only the light branch: `.dark` overrides carry the same names.
+    const lightEnd = css.indexOf(".dark{");
+    const light = lightEnd === -1 ? css : css.slice(0, lightEnd);
+    const colors = new Map();
+    const gradients = new Map();
+    const dimensions = new Map();
+    // Regex-free declaration split (a `(--name):(value);` regex is the
+    // #113 polynomial shape on adversarial dash runs). The light block
+    // is `:root{--a:v;--b:v;}` — split on `;`, take name:value pairs.
+    for (const rawSeg of light.split(";")) {
+        const seg = rawSeg.slice(rawSeg.lastIndexOf("{") + 1);
+        const colon = seg.indexOf(":");
+        if (colon <= 0)
+            continue;
+        const name = seg.slice(0, colon).trim();
+        const value = seg.slice(colon + 1).trim();
+        if (!name.startsWith("--") || value.length === 0)
+            continue;
+        if (name.startsWith("--gradient-")) {
+            const key = normalizeGradient(value);
+            if (!gradients.has(key))
+                gradients.set(key, name);
+        }
+        else if (name.startsWith("--color-")) {
+            const key = normalizeColor(value);
+            if (!colors.has(key))
+                colors.set(key, name);
+        }
+        else if (DIMENSION_VALUE_RE.test(value)) {
+            if (!dimensions.has(value))
+                dimensions.set(value, name);
+        }
+    }
+    return { colors, gradients, dimensions };
+}
+/**
+ * Rewrite color/gradient literals that equal theme token values to
+ * `var(--name)`. Longest-first (gradients before their stop colors) so
+ * a gradient binds as a whole instead of stop-by-stop.
+ */
+export function applyThemeLiteralBinding(css, tokens) {
+    const map = buildThemeValueMap(tokens);
+    const counts = new Map();
+    let out = css;
+    out = replaceCssGradients(out, (literal) => {
+        const varName = map.gradients.get(normalizeGradient(literal));
+        if (varName === undefined)
+            return literal;
+        const entry = counts.get(literal) ?? { to: varName, count: 0 };
+        entry.count += 1;
+        counts.set(literal, entry);
+        return `var(${varName})`;
+    });
+    out = out.replace(COLOR_LITERAL_RE, (literal, offset) => {
+        // Never rewrite inside an already-produced var(...) fallback or a
+        // remaining gradient (a gradient that did NOT match stays literal
+        // by decision — rebinding its stops would half-tokenise it).
+        const before = out.slice(Math.max(0, offset - 64), offset);
+        if (/gradient\([^()]*$/i.test(before))
+            return literal;
+        const varName = map.colors.get(normalizeColor(literal));
+        if (varName === undefined)
+            return literal;
+        const entry = counts.get(literal) ?? { to: varName, count: 0 };
+        entry.count += 1;
+        counts.set(literal, entry);
+        return `var(${varName})`;
+    });
+    const suggestions = [];
+    const seen = new Set();
+    for (const m of out.matchAll(/-?\d+(?:\.\d+)?(?:rem|em|px|%)\b/g)) {
+        const literal = m[0];
+        if (seen.has(literal))
+            continue;
+        seen.add(literal);
+        const varName = map.dimensions.get(literal);
+        if (varName !== undefined)
+            suggestions.push({ literal, varName });
+    }
+    return {
+        css: out,
+        rewrites: [...counts.entries()].map(([from, e]) => ({ from, to: e.to, count: e.count })),
+        suggestions,
+    };
+}
+/** Tool-result suffix describing what binding did. Null on no-op. */
+export function formatBindingReport(result) {
+    const parts = [];
+    if (result.rewrites.length > 0) {
+        const total = result.rewrites.reduce((n, r) => n + r.count, 0);
+        parts.push(`🔗 bound ${total} literal(s) to theme vars: ${result.rewrites
+            .map((r) => `${r.from}→var(${r.to})${r.count > 1 ? `×${r.count}` : ""}`)
+            .join(", ")}`);
+    }
+    if (result.suggestions.length > 0) {
+        parts.push(`consider tokens for: ${result.suggestions
+            .map((s) => `${s.literal}≈var(${s.varName})`)
+            .join(", ")} (dimensions are never auto-rewritten)`);
+    }
+    return parts.length > 0 ? ` ${parts.join(". ")}.` : null;
+}
+//# sourceMappingURL=theme-literal-binding.js.map

package/dist/theme-literal-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-literal-binding.js","sourceRoot":"","sources":["../src/theme-literal-binding.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,gBAAgB,GAAG,kEAAkE,CAAC;AAC5F,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAW1D,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AACD,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,iEAAiE;IACjE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,mEAAmE;IACnE,mEAAmE;IACnE,kEAAkE;IAClE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,MAAqB;IACzE,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAC;IAChE,IAAI,GAAG,GAAG,GAAG,CAAC;IAEd,GAAG,GAAG,mBAAmB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3B,OAAO,OAAO,OAAO,GAAG,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAc,EAAE,EAAE;QAC9D,kEAAkE;QAClE,kEAAkE;QAClE,6DAA6D;QAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,OAAO,CAAC;QACtD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3B,OAAO,OAAO,OAAO,GAAG,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAA2C,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,SAAS;YAAE,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACxF,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,MAA4B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CACR,YAAY,KAAK,8BAA8B,MAAM,CAAC,QAAQ;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,wBAAwB,MAAM,CAAC,WAAW;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,OAAO,GAAG,CAAC;aAC5C,IAAI,CAAC,IAAI,CAAC,wCAAwC,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC"}

package/dist/theme-normalize.d.ts

@@ -0,0 +1,31 @@
+export type CanonicalPath = string;
+export interface NormalizeResult {
+    /**
+     * Map from canonical DTCG path (e.g. "color.primary") to the value
+     * the caller supplied. The ops layer rebuilds the DTCG leaf
+     * (`{$value: <value>, $type: <inferred>}`) from this.
+     */
+    readonly set: Record<CanonicalPath, unknown>;
+    /**
+     * Inferred `$type` per canonical path. The renderer also knows the
+     * category from the path prefix, but the ops layer uses this to set
+     * `$type` on the stored token.
+     */
+    readonly types: Record<CanonicalPath, "color" | "dimension" | "typography" | "shadow" | "duration" | "cubicBezier" | "gradient">;
+    /** Echo-back list for the AI tool's result content. */
+    readonly canonicalPaths: readonly CanonicalPath[];
+}
+/**
+ * Normalize a record of loose-name → value pairs into canonical DTCG
+ * paths. Throws `UnknownTokenName` on the first ambiguous entry so the
+ * AI gets a single concrete next-step rather than a wall of partial
+ * results.
+ */
+export declare function normalizeTokens(input: Record<string, unknown>): NormalizeResult;
+/**
+ * Closest-match suggestions for an unknown input. Cheap edit-distance
+ * over the canonical-paths set — good enough that the AI gets a useful
+ * "did you mean X?" without pulling a fuzzy-search dep.
+ */
+export declare function didYouMean(input: string): readonly string[];
+//# sourceMappingURL=theme-normalize.d.ts.map

package/dist/theme-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-normalize.d.ts","sourceRoot":"","sources":["../src/theme-normalize.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CACpB,aAAa,EACb,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAC1F,CAAC;IACF,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD;AA+JD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CA8D/E;AAoWD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAO3D"}