@mp3wizard/figma-console-mcp 1.27.2 → 1.29.1

package/dist/core/tokens/formatters/stubs.js

@@ -1,11 +1,13 @@
 /**
- * Shared NotImplementedError used by formatter stubs. DTCG JSON and CSS
- * custom properties are the fully-implemented formatters; everything else
- * is scaffolded and throws this error.
+ * Shared NotImplementedError used by formatter stubs. Most formatters are
+ * implemented end-to-end as of v1.28.0; this stub remains for niche targets
+ * (e.g. Less) that haven't drawn enough demand to warrant implementation.
  */
 export class FormatterNotImplementedError extends Error {
     constructor(formatName) {
-        super(`[figma-console-mcp] The ${formatName} formatter is scaffolded but not yet implemented. Fully implemented formats: 'dtcg' (canonical W3C JSON) and 'css-vars' (CSS custom properties with mode-aware selectors). For other targets, export to 'dtcg' and either consume the canonical JSON directly or convert it via a downstream tool — or open an issue with your styling stack to prioritize the format.`);
+        super(`[figma-console-mcp] The ${formatName} formatter is not implemented. ` +
+            `Currently supported formatters: dtcg, css-vars, tailwind-v4, tailwind-v3, scss, ts-module, json-flat, json-nested, style-dictionary-v3, tokens-studio. ` +
+            `If you need ${formatName} support, open an issue with your use case so we can prioritize it.`);
         this.name = "FormatterNotImplementedError";
     }
 }

package/dist/core/tokens/formatters/stubs.js.map

@@ -1 +1 @@
-{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/stubs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,UAAkB;QAC5B,KAAK,CACH,2BAA2B,UAAU,wWAAwW,CAC9Y,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/stubs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,UAAkB;QAC5B,KAAK,CACH,2BAA2B,UAAU,iCAAiC;YACpE,yJAAyJ;YACzJ,eAAe,UAAU,qEAAqE,CACjG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}

package/dist/core/tokens/formatters/style-dictionary-v3.d.ts

@@ -1,4 +1,45 @@
+/**
+ * Style Dictionary v3 source-format JSON formatter.
+ *
+ * SD v3 uses bare `value` / `type` fields (no `$` prefix, that's the DTCG
+ * convention SD v4 adopted). Output is structurally similar to DTCG but
+ * without the dollar signs, and groups have no special meta — just
+ * nested objects.
+ *
+ * Output shape:
+ *
+ *   {
+ *     "color": {
+ *       "primary": {
+ *         "value": "#4085F2",
+ *         "type": "color",
+ *         "comment": "Primary brand color"
+ *       },
+ *       "brand": {
+ *         "blue": { "value": "#0066FF", "type": "color" }
+ *       }
+ *     },
+ *     "spacing": {
+ *       "md": { "value": "16px", "type": "size" }
+ *     }
+ *   }
+ *
+ * SD v3 type names differ slightly from DTCG:
+ *
+ *   DTCG type    →  SD v3 type
+ *   ----------------------------
+ *   dimension    →  size (or spacing for spacing tokens)
+ *   color        →  color
+ *   fontFamily   →  string
+ *   fontWeight   →  number
+ *
+ * Aliases use SD v3's `{path.to.token}` syntax (same as DTCG, which copied
+ * it from SD).
+ *
+ * For back-compat with cbds-components / blocks / czi-edu / eddie-design-system
+ * which still use SD v3's bare-key source format.
+ */
 import type { TokenDocument } from "../types.js";
 import type { FormatOptions, FormatResult } from "./index.js";
-export declare function formatStyleDictionaryV3(_doc: TokenDocument, _opts: FormatOptions): FormatResult;
+export declare function formatStyleDictionaryV3(doc: TokenDocument, opts: FormatOptions): FormatResult;
 //# sourceMappingURL=style-dictionary-v3.d.ts.map

package/dist/core/tokens/formatters/style-dictionary-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style-dictionary-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/style-dictionary-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,aAAa,GACnB,YAAY,CAEd"}
+{"version":3,"file":"style-dictionary-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/style-dictionary-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAwB,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CA2Cd"}

package/dist/core/tokens/formatters/style-dictionary-v3.js

@@ -1,5 +1,208 @@
-import { FormatterNotImplementedError } from "./stubs.js";
-export function formatStyleDictionaryV3(_doc, _opts) {
-    throw new FormatterNotImplementedError("Style Dictionary v3");
+/**
+ * Style Dictionary v3 source-format JSON formatter.
+ *
+ * SD v3 uses bare `value` / `type` fields (no `$` prefix, that's the DTCG
+ * convention SD v4 adopted). Output is structurally similar to DTCG but
+ * without the dollar signs, and groups have no special meta — just
+ * nested objects.
+ *
+ * Output shape:
+ *
+ *   {
+ *     "color": {
+ *       "primary": {
+ *         "value": "#4085F2",
+ *         "type": "color",
+ *         "comment": "Primary brand color"
+ *       },
+ *       "brand": {
+ *         "blue": { "value": "#0066FF", "type": "color" }
+ *       }
+ *     },
+ *     "spacing": {
+ *       "md": { "value": "16px", "type": "size" }
+ *     }
+ *   }
+ *
+ * SD v3 type names differ slightly from DTCG:
+ *
+ *   DTCG type    →  SD v3 type
+ *   ----------------------------
+ *   dimension    →  size (or spacing for spacing tokens)
+ *   color        →  color
+ *   fontFamily   →  string
+ *   fontWeight   →  number
+ *
+ * Aliases use SD v3's `{path.to.token}` syntax (same as DTCG, which copied
+ * it from SD).
+ *
+ * For back-compat with cbds-components / blocks / czi-edu / eddie-design-system
+ * which still use SD v3's bare-key source format.
+ */
+export function formatStyleDictionaryV3(doc, opts) {
+    const warnings = [];
+    const files = [];
+    const splitByMode = opts.target.splitByMode ?? false;
+    const splitByCollection = opts.target.splitByCollection ?? false;
+    if (splitByMode && splitByCollection) {
+        for (const set of doc.sets) {
+            for (const mode of set.modes) {
+                files.push({
+                    path: filenameFor(opts, set, mode),
+                    content: renderSdJson([set], [mode], warnings),
+                });
+            }
+        }
+    }
+    else if (splitByMode) {
+        const allModes = new Set();
+        for (const set of doc.sets)
+            for (const m of set.modes)
+                allModes.add(m);
+        for (const mode of allModes) {
+            const sets = doc.sets.filter((s) => s.modes.includes(mode));
+            files.push({
+                path: filenameFor(opts, undefined, mode),
+                content: renderSdJson(sets, [mode], warnings),
+            });
+        }
+    }
+    else if (splitByCollection) {
+        for (const set of doc.sets) {
+            files.push({
+                path: filenameFor(opts, set),
+                content: renderSdJson([set], set.modes, warnings),
+            });
+        }
+    }
+    else {
+        const allModes = new Set();
+        for (const set of doc.sets)
+            for (const m of set.modes)
+                allModes.add(m);
+        files.push({
+            path: filenameFor(opts),
+            content: renderSdJson(doc.sets, [...allModes], warnings),
+        });
+    }
+    return { files, warnings };
+}
+function filenameFor(opts, set, mode) {
+    if (opts.target.filename)
+        return opts.target.filename;
+    const parts = [];
+    if (set)
+        parts.push(slugify(set.name));
+    if (mode)
+        parts.push(slugify(mode));
+    if (parts.length === 0)
+        parts.push("tokens");
+    return `${parts.join(".")}.sd.json`;
+}
+function slugify(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Map DTCG type names to SD v3 conventions.
+ */
+function sdTypeFor(token) {
+    const lower = token.path[0]?.toLowerCase() ?? "";
+    if (token.type === "dimension") {
+        if (lower.startsWith("spacing") || lower === "space")
+            return "spacing";
+        return "size";
+    }
+    if (token.type === "color")
+        return "color";
+    if (token.type === "fontFamily")
+        return "string";
+    if (token.type === "fontWeight")
+        return "number";
+    if (token.type === "duration")
+        return "time";
+    if (token.type === "number")
+        return "number";
+    if (token.type === "string")
+        return "string";
+    if (token.type === "boolean")
+        return "boolean";
+    // Composites / less-common types: pass through.
+    return token.type;
+}
+function renderSdJson(sets, modes, warnings) {
+    const tree = {};
+    const primaryMode = pickPrimaryMode(modes);
+    for (const set of sets) {
+        for (const token of set.tokens) {
+            // Filter to modes the file is supposed to cover.
+            const usableModes = modes.filter((m) => token.values[m]);
+            if (usableModes.length === 0)
+                continue;
+            // SD v3 has no native multi-mode encoding, so we pick the primary
+            // mode's value. If splitByMode is being used (single mode in this
+            // file), that primary will match the file's mode. Otherwise, the
+            // chosen primary is the first available.
+            const valueMode = usableModes.includes(primaryMode)
+                ? primaryMode
+                : usableModes[0];
+            const tokenValue = token.values[valueMode];
+            const sdValue = sdValueFor(tokenValue, token, warnings);
+            if (sdValue === undefined)
+                continue;
+            // Walk the path, creating nested groups.
+            let cursor = tree;
+            for (let i = 0; i < token.path.length - 1; i++) {
+                const segment = token.path[i];
+                if (!cursor[segment] || typeof cursor[segment] !== "object") {
+                    cursor[segment] = {};
+                }
+                cursor = cursor[segment];
+            }
+            const leafKey = token.path[token.path.length - 1];
+            const leaf = {
+                value: sdValue,
+                type: sdTypeFor(token),
+            };
+            if (token.description)
+                leaf.comment = token.description;
+            cursor[leafKey] = leaf;
+        }
+    }
+    return JSON.stringify(sortKeys(tree), null, 2) + "\n";
+}
+function pickPrimaryMode(modes) {
+    return modes.find((m) => /^(default|light|value)$/i.test(m)) ?? modes[0];
+}
+function sdValueFor(value, token, warnings) {
+    if (value.reference) {
+        const bare = value.reference.replace(/^\{|\}$/g, "");
+        if (bare.startsWith("__library:") || bare === "unknown") {
+            warnings.push(`Skipped ${token.path.join(".")} in Style Dictionary v3 — cross-library alias unresolved.`);
+            return undefined;
+        }
+        // SD v3 uses the same `{path.to.token}` alias syntax as DTCG.
+        return `{${bare}}`;
+    }
+    if (value.literal === undefined || value.literal === null)
+        return undefined;
+    if (typeof value.literal === "number" && token.type === "dimension") {
+        return `${value.literal}px`;
+    }
+    return value.literal;
+}
+function sortKeys(node) {
+    if (node === null || typeof node !== "object" || Array.isArray(node)) {
+        return node;
+    }
+    const obj = node;
+    const sorted = {};
+    const keys = Object.keys(obj).sort();
+    for (const k of keys)
+        sorted[k] = sortKeys(obj[k]);
+    return sorted;
 }
 //# sourceMappingURL=style-dictionary-v3.js.map

package/dist/core/tokens/formatters/style-dictionary-v3.js.map

@@ -1 +1 @@
-{"version":3,"file":"style-dictionary-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/style-dictionary-v3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,UAAU,uBAAuB,CACrC,IAAmB,EACnB,KAAoB;IAEpB,MAAM,IAAI,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"style-dictionary-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/style-dictionary-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,MAAM,UAAU,uBAAuB,CACrC,GAAkB,EAClB,IAAmB;IAEnB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAA0B,EAAE,CAAC;IAExC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;IACrD,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;IAEjE,IAAI,WAAW,IAAI,iBAAiB,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;oBAClC,OAAO,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;iBAC/C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI;YAAE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC;gBACxC,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC;gBAC5B,OAAO,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI;YAAE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAClB,IAAmB,EACnB,GAAc,EACd,IAAa;IAEb,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;AACtC,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC;SACL,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,KAAY;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/C,gDAAgD;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CACnB,IAAgB,EAChB,KAAe,EACf,QAAkB;IAElB,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC/B,iDAAiD;YACjD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEvC,kEAAkE;YAClE,kEAAkE;YAClE,iEAAiE;YACjE,yCAAyC;YACzC,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjD,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxD,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YAEpC,yCAAyC;YACzC,IAAI,MAAM,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC5D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACvB,CAAC;gBACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAA4B,CAAC;YACtD,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC;aACvB,CAAC;YACF,IAAI,KAAK,CAAC,WAAW;gBAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,KAAe;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CACjB,KAAiB,EACjB,KAAY,EACZ,QAAkB;IAElB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CACX,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,2DAA2D,CAC3F,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,8DAA8D;QAC9D,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5E,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpE,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAI,IAAO;IAC1B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAY,CAAC,CAAC;IAC9D,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/core/tokens/formatters/tailwind-v3.d.ts

@@ -1,4 +1,37 @@
+/**
+ * Tailwind v3 config formatter.
+ *
+ * Output shape:
+ *
+ *   // tailwind.tokens.js
+ *   module.exports = {
+ *     colors: {
+ *       primary: "#4085F2",
+ *       brand: { primary: "#FF00AA" }
+ *     },
+ *     spacing: {
+ *       md: "16px"
+ *     }
+ *   };
+ *
+ * Designed to be spread into `tailwind.config.js`:
+ *
+ *   const tokens = require('./src/styles/generated/tailwind.tokens.js');
+ *   module.exports = { theme: { extend: tokens } };
+ *
+ * Token-to-namespace mapping mirrors Tailwind v3's theme keys:
+ *
+ *   color/*       → colors.*
+ *   spacing/*     → spacing.*
+ *   font/*        → fontFamily.*
+ *   text/*        → fontSize.*
+ *   radius/*      → borderRadius.*
+ *
+ * Multi-mode tokens flatten to the primary mode (Tailwind v3 doesn't have
+ * a native multi-mode model — dark-mode variants come from `tailwindcss`'s
+ * `darkMode: 'class'` + separate CSS variable files).
+ */
 import type { TokenDocument } from "../types.js";
 import type { FormatOptions, FormatResult } from "./index.js";
-export declare function formatTailwindV3(_doc: TokenDocument, _opts: FormatOptions): FormatResult;
+export declare function formatTailwindV3(doc: TokenDocument, opts: FormatOptions): FormatResult;
 //# sourceMappingURL=tailwind-v3.d.ts.map

package/dist/core/tokens/formatters/tailwind-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tailwind-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,aAAa,GACnB,YAAY,CAEd"}
+{"version":3,"file":"tailwind-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAwB,MAAM,aAAa,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CA4Bd"}

package/dist/core/tokens/formatters/tailwind-v3.js

@@ -1,5 +1,238 @@
-import { FormatterNotImplementedError } from "./stubs.js";
-export function formatTailwindV3(_doc, _opts) {
-    throw new FormatterNotImplementedError("Tailwind v3 config");
+/**
+ * Tailwind v3 config formatter.
+ *
+ * Output shape:
+ *
+ *   // tailwind.tokens.js
+ *   module.exports = {
+ *     colors: {
+ *       primary: "#4085F2",
+ *       brand: { primary: "#FF00AA" }
+ *     },
+ *     spacing: {
+ *       md: "16px"
+ *     }
+ *   };
+ *
+ * Designed to be spread into `tailwind.config.js`:
+ *
+ *   const tokens = require('./src/styles/generated/tailwind.tokens.js');
+ *   module.exports = { theme: { extend: tokens } };
+ *
+ * Token-to-namespace mapping mirrors Tailwind v3's theme keys:
+ *
+ *   color/*       → colors.*
+ *   spacing/*     → spacing.*
+ *   font/*        → fontFamily.*
+ *   text/*        → fontSize.*
+ *   radius/*      → borderRadius.*
+ *
+ * Multi-mode tokens flatten to the primary mode (Tailwind v3 doesn't have
+ * a native multi-mode model — dark-mode variants come from `tailwindcss`'s
+ * `darkMode: 'class'` + separate CSS variable files).
+ */
+import { buildTokenIndex, resolveAliasChain } from "../alias-resolver.js";
+export function formatTailwindV3(doc, opts) {
+    const warnings = [];
+    const files = [];
+    const splitByCollection = opts.target.splitByCollection ?? false;
+    // Tailwind v3 config is consumed by Tailwind's build step, which needs
+    // literal values — no runtime alias resolution. Build a full-document
+    // token index so we can resolve alias chains at export time. Even when
+    // splitByCollection writes one file per set, aliases may target tokens
+    // in OTHER sets (e.g. semantic → primitives) so the index must span
+    // every set, not just the file's own.
+    const tokenIndex = buildTokenIndex(doc);
+    if (splitByCollection) {
+        for (const set of doc.sets) {
+            files.push({
+                path: filenameFor(opts, set),
+                content: renderConfigFile([set], opts, tokenIndex, warnings),
+            });
+        }
+    }
+    else {
+        files.push({
+            path: filenameFor(opts),
+            content: renderConfigFile(doc.sets, opts, tokenIndex, warnings),
+        });
+    }
+    return { files, warnings };
+}
+function filenameFor(opts, set) {
+    if (opts.target.filename)
+        return opts.target.filename;
+    if (set)
+        return `${slugify(set.name)}.tailwind.tokens.js`;
+    return "tailwind.tokens.js";
+}
+function slugify(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function jsKey(segment) {
+    if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(segment))
+        return segment;
+    return JSON.stringify(segment);
+}
+function renderConfigFile(sets, opts, tokenIndex, warnings) {
+    const lines = [];
+    lines.push("/**");
+    lines.push(" * Generated by figma-console-mcp — do not edit by hand.");
+    lines.push(" * Spread this into your tailwind.config.js theme.extend block:");
+    lines.push(" *");
+    lines.push(" *   const tokens = require('./path/to/this-file');");
+    lines.push(" *   module.exports = { theme: { extend: tokens } };");
+    lines.push(" */");
+    lines.push("");
+    // Group tokens by Tailwind theme namespace.
+    const namespaces = {};
+    for (const set of sets) {
+        const primaryMode = pickPrimaryMode(set.modes);
+        for (const token of set.tokens) {
+            const value = token.values[primaryMode];
+            if (!value)
+                continue;
+            const formattedValue = formatTokenValue(value, token, primaryMode, tokenIndex, warnings);
+            if (formattedValue === null)
+                continue;
+            const { namespace, subPath } = mapToNamespace(token);
+            if (!namespaces[namespace])
+                namespaces[namespace] = {};
+            writeIntoTree(namespaces[namespace], subPath, formattedValue);
+        }
+    }
+    lines.push("module.exports = {");
+    const namespaceEntries = Object.entries(namespaces).sort(([a], [b]) => a.localeCompare(b));
+    for (let i = 0; i < namespaceEntries.length; i++) {
+        const [ns, tree] = namespaceEntries[i];
+        lines.push(`  ${jsKey(ns)}: ${renderTree(tree, 1)}${i < namespaceEntries.length - 1 ? "," : ""}`);
+    }
+    lines.push("};");
+    lines.push("");
+    return lines.join("\n");
+}
+function pickPrimaryMode(modes) {
+    return modes.find((m) => /^(default|light|value)$/i.test(m)) ?? modes[0];
+}
+function mapToNamespace(token) {
+    const slug = token.path.map(slugify);
+    if (slug.length === 0)
+        return { namespace: "extend", subPath: [] };
+    // First-segment aliases that should be re-namespaced to Tailwind theme keys.
+    const NAMESPACE_MAP = {
+        color: "colors",
+        colors: "colors",
+        spacing: "spacing",
+        space: "spacing",
+        radius: "borderRadius",
+        "border-radius": "borderRadius",
+        rounded: "borderRadius",
+        font: "fontFamily",
+        "font-family": "fontFamily",
+        text: "fontSize",
+        "font-size": "fontSize",
+        "font-weight": "fontWeight",
+        shadow: "boxShadow",
+        "box-shadow": "boxShadow",
+        opacity: "opacity",
+        "z-index": "zIndex",
+        "line-height": "lineHeight",
+        leading: "lineHeight",
+        tracking: "letterSpacing",
+        "letter-spacing": "letterSpacing",
+    };
+    if (NAMESPACE_MAP[slug[0]]) {
+        return { namespace: NAMESPACE_MAP[slug[0]], subPath: slug.slice(1) };
+    }
+    // Heuristic by type when no first-segment match.
+    if (token.type === "color")
+        return { namespace: "colors", subPath: slug };
+    if (token.type === "dimension")
+        return { namespace: "spacing", subPath: slug };
+    if (token.type === "fontFamily")
+        return { namespace: "fontFamily", subPath: slug };
+    if (token.type === "fontWeight")
+        return { namespace: "fontWeight", subPath: slug };
+    // Anything else: dump under extend.{path}
+    return { namespace: "extend", subPath: slug };
+}
+function writeIntoTree(tree, path, value) {
+    if (path.length === 0)
+        return;
+    let cursor = tree;
+    for (let i = 0; i < path.length - 1; i++) {
+        const segment = path[i];
+        const next = cursor[segment];
+        if (!next || typeof next === "string") {
+            const newNode = {};
+            cursor[segment] = newNode;
+            cursor = newNode;
+        }
+        else {
+            cursor = next;
+        }
+    }
+    const leafKey = path[path.length - 1];
+    cursor[leafKey] = value;
+}
+function renderTree(tree, indent) {
+    const ind = "  ".repeat(indent);
+    const innerInd = "  ".repeat(indent + 1);
+    const entries = [];
+    const sortedKeys = Object.keys(tree).sort();
+    for (const key of sortedKeys) {
+        const value = tree[key];
+        const k = jsKey(key);
+        if (typeof value === "string") {
+            entries.push(`${innerInd}${k}: ${value}`);
+        }
+        else {
+            entries.push(`${innerInd}${k}: ${renderTree(value, indent + 1)}`);
+        }
+    }
+    if (entries.length === 0)
+        return "{}";
+    return `{\n${entries.join(",\n")},\n${ind}}`;
+}
+/**
+ * Format a token value as a JavaScript literal (quoted string for most
+ * things). Resolves alias chains to their literal target value via the
+ * document-wide token index — Tailwind v3 config is read at Tailwind's
+ * build time and needs concrete values (no runtime cascade).
+ *
+ * Returns null only for cross-library aliases or genuinely empty values,
+ * after emitting a warning explaining what got skipped.
+ */
+function formatTokenValue(value, token, mode, tokenIndex, warnings) {
+    let effective = value;
+    if (value.reference) {
+        effective = resolveAliasChain(value, mode, tokenIndex);
+        if (!effective) {
+            const bare = value.reference.replace(/^\{|\}$/g, "");
+            const reason = bare.startsWith("__library:") || bare === "unknown"
+                ? "cross-library alias"
+                : "alias target not found in any set";
+            warnings.push(`Skipped ${token.path.join(".")} in Tailwind v3 — ${reason}: ${value.reference}.`);
+            return null;
+        }
+    }
+    if (!effective || effective.literal === undefined || effective.literal === null) {
+        return null;
+    }
+    if (typeof effective.literal === "number") {
+        if (token.type === "dimension")
+            return JSON.stringify(`${effective.literal}px`);
+        return String(effective.literal);
+    }
+    if (typeof effective.literal === "string")
+        return JSON.stringify(effective.literal);
+    if (typeof effective.literal === "boolean")
+        return String(effective.literal);
+    // Composite: emit as JSON object literal
+    return JSON.stringify(effective.literal);
 }
 //# sourceMappingURL=tailwind-v3.js.map

package/dist/core/tokens/formatters/tailwind-v3.js.map

@@ -1 +1 @@
-{"version":3,"file":"tailwind-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,KAAoB;IAEpB,MAAM,IAAI,4BAA4B,CAAC,oBAAoB,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"tailwind-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v3.ts"],"names":[],"mappings":"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"}

package/dist/core/tokens/formatters/tailwind-v4.d.ts

@@ -1,4 +1,41 @@
+/**
+ * Tailwind v4 `@theme` block formatter.
+ *
+ * Tailwind v4 introduced CSS-first configuration: instead of a JS
+ * `tailwind.config.js`, you write tokens directly into your CSS with an
+ * `@theme inline { ... }` block. Tailwind processes that block to generate
+ * utility classes (`bg-primary`, `text-foreground`, etc.) at build time.
+ *
+ * Output shape:
+ *
+ *   @theme inline {
+ *     --color-primary: #4085F2;
+ *     --spacing-md: 16px;
+ *     --font-family-sans: "Inter", sans-serif;
+ *   }
+ *
+ *   .dark {
+ *     --color-primary: #5599FF;
+ *   }
+ *
+ * Token-to-Tailwind-namespace mapping follows the canonical Tailwind v4
+ * convention (see https://tailwindcss.com/docs/theme):
+ *
+ *   color/*       → --color-*       (maps to bg-*, text-*, border-*, etc.)
+ *   spacing/*     → --spacing-*
+ *   radius/*      → --radius-*      (maps to rounded-*)
+ *   font/*        → --font-*        (font-family namespace)
+ *   text/*        → --text-*        (font-size namespace)
+ *   font-weight/* → --font-weight-*
+ *   tracking/*    → --tracking-*
+ *   leading/*     → --leading-*
+ *   shadow/*      → --shadow-*
+ *
+ * Tokens that don't fit a known Tailwind namespace get emitted with their
+ * path verbatim (with prefix if configured). They're still valid CSS vars
+ * — they just don't generate Tailwind utility classes.
+ */
 import type { TokenDocument } from "../types.js";
 import type { FormatOptions, FormatResult } from "./index.js";
-export declare function formatTailwindV4(_doc: TokenDocument, _opts: FormatOptions): FormatResult;
+export declare function formatTailwindV4(doc: TokenDocument, opts: FormatOptions): FormatResult;
 //# sourceMappingURL=tailwind-v4.d.ts.map

package/dist/core/tokens/formatters/tailwind-v4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tailwind-v4.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,aAAa,GACnB,YAAY,CAEd"}
+{"version":3,"file":"tailwind-v4.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind-v4.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAwB,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CAiDd"}