@mp3wizard/figma-console-mcp 1.32.2 → 1.34.1

package/dist/cloudflare/core/tokens/formatters/tailwind-v4.js

@@ -35,9 +35,13 @@
  * path verbatim (with prefix if configured). They're still valid CSS vars
  * — they just don't generate Tailwind utility classes.
  */
+import { buildTokenIndex, referenceTargetPath } from "../alias-resolver.js";
 export function formatTailwindV4(doc, opts) {
     const warnings = [];
     const files = [];
+    // Whole-document index so set-qualified alias references resolve to the
+    // target token's own path when generating var(--...) names.
+    const tokenIndex = buildTokenIndex(doc, warnings);
     const splitByMode = opts.target.splitByMode ?? false;
     const splitByCollection = opts.target.splitByCollection ?? false;
     const prefix = opts.target.prefix ?? "";
@@ -46,7 +50,7 @@ export function formatTailwindV4(doc, opts) {
             for (const mode of set.modes) {
                 files.push({
                     path: filenameFor(opts, set, mode),
-                    content: renderTailwindFile(doc.sets.filter((s) => s.name === set.name), [mode], prefix, warnings),
+                    content: renderTailwindFile(doc.sets.filter((s) => s.name === set.name), [mode], prefix, tokenIndex, warnings),
                 });
             }
         }
@@ -59,7 +63,7 @@ export function formatTailwindV4(doc, opts) {
         for (const mode of allModes) {
             files.push({
                 path: filenameFor(opts, undefined, mode),
-                content: renderTailwindFile(doc.sets, [mode], prefix, warnings),
+                content: renderTailwindFile(doc.sets, [mode], prefix, tokenIndex, warnings),
             });
         }
     }
@@ -67,7 +71,7 @@ export function formatTailwindV4(doc, opts) {
         for (const set of doc.sets) {
             files.push({
                 path: filenameFor(opts, set),
-                content: renderTailwindFile([set], set.modes, prefix, warnings),
+                content: renderTailwindFile([set], set.modes, prefix, tokenIndex, warnings),
             });
         }
     }
@@ -79,7 +83,7 @@ export function formatTailwindV4(doc, opts) {
                 allModes.add(m);
         files.push({
             path: filenameFor(opts),
-            content: renderTailwindFile(doc.sets, [...allModes], prefix, warnings),
+            content: renderTailwindFile(doc.sets, [...allModes], prefix, tokenIndex, warnings),
         });
     }
     return { files, warnings };
@@ -110,7 +114,7 @@ function slugify(s) {
  * selectors (`.dark`, `[data-theme="..."]`) so the user can swap modes
  * at runtime.
  */
-function renderTailwindFile(sets, modes, prefix, warnings) {
+function renderTailwindFile(sets, modes, prefix, tokenIndex, warnings) {
     const lines = [];
     lines.push("/* Generated by figma-console-mcp — do not edit by hand */");
     lines.push("");
@@ -125,7 +129,7 @@ function renderTailwindFile(sets, modes, prefix, warnings) {
             const value = token.values[primaryMode];
             if (!value)
                 continue;
-            emitTailwindTokenLines(token, value, prefix, lines, warnings);
+            emitTailwindTokenLines(token, value, prefix, tokenIndex, lines, warnings);
         }
     }
     lines.push("}");
@@ -142,7 +146,7 @@ function renderTailwindFile(sets, modes, prefix, warnings) {
                 const value = token.values[mode];
                 if (!value)
                     continue;
-                emitTailwindTokenLines(token, value, prefix, lines, warnings);
+                emitTailwindTokenLines(token, value, prefix, tokenIndex, lines, warnings);
             }
         }
         lines.push("}");
@@ -160,7 +164,7 @@ function selectorFor(mode) {
  * Emit one or more CSS custom property declarations for a token, using
  * Tailwind v4's namespace conventions where possible.
  */
-function emitTailwindTokenLines(token, value, prefix, out, warnings) {
+function emitTailwindTokenLines(token, value, prefix, tokenIndex, out, warnings) {
     const cssName = `--${prefix}${pathToTailwindName(token.path, token.type)}`;
     if (value.reference) {
         // Cross-library alias: skip with a comment.
@@ -173,7 +177,8 @@ function emitTailwindTokenLines(token, value, prefix, out, warnings) {
             return;
         }
         // Local alias → var() reference using the same namespace mapping.
-        const refPath = bareRef.split(".");
+        // Resolve set-qualified references to the target token's own path.
+        const refPath = referenceTargetPath(value.reference, tokenIndex);
         const targetName = pathToTailwindName(refPath, token.type);
         out.push(`  ${cssName}: var(--${prefix}${targetName});`);
         return;

package/dist/cloudflare/core/tokens/formatters/tokens-studio.js

@@ -39,9 +39,13 @@
  *     and the figma-console-mcp metadata stamped onto it.
  */
 import { FIGMA_MCP_EXTENSION_KEY } from "../types.js";
+import { buildTokenIndex, referenceTargetPath } from "../alias-resolver.js";
 export function formatTokensStudio(doc, opts) {
     const warnings = [];
     const files = [];
+    // Whole-document index so set-qualified alias references resolve to the
+    // target token's own path (Tokens Studio references are set-relative).
+    const tokenIndex = buildTokenIndex(doc, warnings);
     // Track which (setName, mode) → filename pairs exist so $metadata + $themes
     // can reference them.
     const setNamesByMode = [];
@@ -53,7 +57,7 @@ export function formatTokensStudio(doc, opts) {
             setNamesByMode.push({ setName: fileSetName, mode, filename });
             files.push({
                 path: filename,
-                content: renderSetFile(set, mode, warnings),
+                content: renderSetFile(set, mode, tokenIndex, warnings),
             });
         }
     }
@@ -84,13 +88,13 @@ function slugify(s) {
  * Render a single set's tokens for a specific mode in Tokens Studio's
  * bare-key JSON format.
  */
-function renderSetFile(set, mode, warnings) {
+function renderSetFile(set, mode, tokenIndex, warnings) {
     const tree = {};
     for (const token of set.tokens) {
         const value = token.values[mode];
         if (!value)
             continue;
-        const tsValue = tsValueFor(value, token, warnings);
+        const tsValue = tsValueFor(value, token, tokenIndex, warnings);
         if (tsValue === undefined)
             continue;
         // Walk path creating nested groups.
@@ -212,14 +216,16 @@ function tsTypeFor(token) {
     }
     return token.type;
 }
-function tsValueFor(value, token, warnings) {
+function tsValueFor(value, token, tokenIndex, warnings) {
     if (value.reference) {
         const bare = value.reference.replace(/^\{|\}$/g, "");
         if (bare.startsWith("__library:") || bare === "unknown") {
             warnings.push(`Skipped ${token.path.join(".")} in Tokens Studio — cross-library alias unresolved.`);
             return undefined;
         }
-        return `{${bare}}`;
+        // Tokens Studio references are token-path based (no set qualifier) —
+        // resolve set-qualified references to the target token's own path.
+        return `{${referenceTargetPath(value.reference, tokenIndex).join(".")}}`;
     }
     if (value.literal === undefined || value.literal === null)
         return undefined;

package/dist/cloudflare/core/tokens/index.js

@@ -11,5 +11,6 @@ export { TokensConfigSchema, loadTokensConfig, findTokensConfig, DEFAULT_TOKENS_
 export { ExportTokensInputSchema, ImportTokensInputSchema, ExportFormatSchema, ImportFormatSchema, SyncStrategySchema, ConflictResolutionSchema, } from "./schemas.js";
 export { parse, detectFormat, } from "./parsers/index.js";
 export { format, } from "./formatters/index.js";
-export { buildTokenIndex, resolveReference, resolveAliasChain, validateAliases, formatDtcgReference, parseDtcgReference, } from "./alias-resolver.js";
+export { buildTokenIndex, buildTokenLookup, resolveReference, resolveAliasChain, validateAliases, formatDtcgReference, parseDtcgReference, referenceTargetPath, slugifySetName, } from "./alias-resolver.js";
 export { convertFigmaVariablesToDocument, } from "./figma-converter.js";
+export { canonicalizeTokenValueForComparison, colorLiteralToCanonicalHex, colorValueTo2025, dimensionLiteralTo2025, hexToRawRgba, stripRawColorFromValues, clamp01, } from "./dialect.js";

package/dist/cloudflare/core/tokens/parsers/dtcg.js

@@ -132,7 +132,14 @@ function walkGroup(node, path, inheritedType, tokens, modes, warnings, fileMode)
             warnings.push(`Non-group, non-token entry at ${[...path, key].join(".")}; skipping.`);
             continue;
         }
-        const childPath = [...path, key];
+        // Reserved "@" key: the formatter emits a leaf under "@" when its name
+        // collided with a group of the same name (leaf/group conflict). The
+        // `leafRemap` flag in our extension marks it; strip the synthetic "@"
+        // segment so the token gets its original path back.
+        const isRemappedLeaf = key === "@" &&
+            isLeafToken(value) &&
+            hasLeafRemapFlag(value);
+        const childPath = isRemappedLeaf ? [...path] : [...path, key];
         if (isLeafToken(value)) {
             const token = extractToken(childPath, value, groupType, warnings, fileMode);
             tokens.push(token);
@@ -147,6 +154,19 @@ function walkGroup(node, path, inheritedType, tokens, modes, warnings, fileMode)
 function isLeafToken(node) {
     return "$value" in node;
 }
+/**
+ * True when a leaf node carries the `leafRemap` marker our formatter sets
+ * on tokens emitted under the reserved "@" key (leaf/group name conflicts).
+ */
+function hasLeafRemapFlag(node) {
+    const ext = node.$extensions;
+    if (!ext || typeof ext !== "object")
+        return false;
+    const mcp = ext[FIGMA_MCP_EXTENSION_KEY];
+    if (!mcp || typeof mcp !== "object")
+        return false;
+    return mcp.leafRemap === true;
+}
 function extractToken(path, node, inheritedType, warnings, fileMode) {
     const rawType = node.$type;
     let type;
@@ -169,12 +189,15 @@ function extractToken(path, node, inheritedType, warnings, fileMode) {
         ? ext[FIGMA_MCP_EXTENSION_KEY]
         : undefined;
     const stashedModes = mcpExt?.modes;
+    const stashedPrimaryMode = typeof mcpExt?.primaryMode === "string" ? mcpExt.primaryMode : undefined;
     // Decide which mode name to assign to the primary $value.
     //   1. If the file declares a fileMode (splitByMode output), use that.
-    //   2. Otherwise fall back to "Default" — the parser can't know the
-    //      mode without that hint.
+    //   2. Otherwise use the token-level `primaryMode` our formatter stashes
+    //      in $extensions["figma-console-mcp"] (one-file-multi-mode output).
+    //   3. Otherwise fall back to "Default" — the parser can't know the
+    //      mode without a hint.
     // Then absorb any stashedModes (one-file-multi-mode output) verbatim.
-    const primaryMode = fileMode ?? "Default";
+    const primaryMode = fileMode ?? stashedPrimaryMode ?? "Default";
     values[primaryMode] = decodeValue(node.$value);
     if (stashedModes) {
         for (const [modeName, modeValue] of Object.entries(stashedModes)) {
@@ -192,9 +215,13 @@ function extractToken(path, node, inheritedType, warnings, fileMode) {
             if (vendor === FIGMA_MCP_EXTENSION_KEY &&
                 payload &&
                 typeof payload === "object") {
-                // Strip the "modes" we already absorbed into values.
+                // Strip transient round-trip markers we already absorbed:
+                // "modes"/"primaryMode" were folded into `values`, "leafRemap"
+                // was consumed when the "@" path segment got stripped.
                 const cleaned = { ...payload };
                 delete cleaned.modes;
+                delete cleaned.primaryMode;
+                delete cleaned.leafRemap;
                 if (Object.keys(cleaned).length > 0) {
                     extensions[vendor] = cleaned;
                 }

package/dist/cloudflare/core/tokens/schemas.js

@@ -88,6 +88,10 @@ export const ExportTokensInputSchema = z.object({
         .boolean()
         .optional()
         .describe("Emit one file per Figma collection. Default false. Useful when collections map to different runtime themes."),
+    dtcgDialect: z
+        .enum(["legacy", "2025"])
+        .optional()
+        .describe("DTCG dialect for dtcg/json-flat/json-nested outputs. legacy (default): hex-string colors, maximum compatibility (Style Dictionary v4, Tokens Studio). 2025: DTCG 2025.10 object colors/dimensions (Style Dictionary v5+). Other formats (css-vars, scss, tailwind, ts-module) render final code and ignore this option."),
     colorFormat: ColorFormatSchema.optional().describe("Color value format in the output. Default: 'hex'. Use 'oklch' for modern Tailwind v4 charts."),
     sizeUnit: SizeUnitSchema.optional().describe("Unit for dimension tokens. Default: 'rem' for web outputs, 'pt' for iOS, 'dp' for Android."),
     remBase: z