@mp3wizard/figma-console-mcp 1.27.2 → 1.28.2

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