figma-console-mcp 1.33.2 → 1.34.0

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

@@ -19,11 +19,12 @@
  *      structured $value form. Aliases emit `"$value": "{path.to.target}"`.
  *
  * This formatter is the canonical output — the format every other
- * formatter (CSS variables today, Tailwind/SCSS/etc. in future minor
- * versions) ultimately derives from.
+ * formatter (CSS variables, Tailwind v4/v3, SCSS, TS module, JSON
+ * flat/nested, Style Dictionary v3, Tokens Studio) ultimately derives from.
  */
 import { FIGMA_MCP_EXTENSION_KEY } from "../types.js";
 import { formatDtcgReference } from "../alias-resolver.js";
+import { colorValueTo2025, dimensionLiteralTo2025, } from "../dialect.js";
 export function formatDtcg(doc, opts) {
     const warnings = [];
     const files = [];
@@ -35,6 +36,9 @@ export function formatDtcg(doc, opts) {
     //   4. neither → one file with everything
     const splitByMode = opts.target.splitByMode ?? false;
     const splitByCollection = opts.target.splitByCollection ?? false;
+    // Value-encoding dialect. 'legacy' (default) is byte-identical to the
+    // historical output; '2025' opts into DTCG 2025.10 object colors/dimensions.
+    const dialect = opts.target.dtcgDialect ?? "legacy";
     if (splitByMode && splitByCollection) {
         for (const set of doc.sets) {
             for (const mode of set.modes) {
@@ -43,7 +47,7 @@ export function formatDtcg(doc, opts) {
                     .filter((t) => t !== null);
                 files.push({
                     path: filenameFor(opts, set, mode),
-                    content: serializeAsDtcg({ sets: [{ ...set, modes: [mode], tokens: fileTokens }], meta: doc.meta }, warnings, mode),
+                    content: serializeAsDtcg({ sets: [{ ...set, modes: [mode], tokens: fileTokens }], meta: doc.meta }, warnings, dialect, mode),
                 });
             }
         }
@@ -65,7 +69,7 @@ export function formatDtcg(doc, opts) {
             }));
             files.push({
                 path: filenameFor(opts, undefined, mode),
-                content: serializeAsDtcg({ sets: fileSets, meta: doc.meta }, warnings, mode),
+                content: serializeAsDtcg({ sets: fileSets, meta: doc.meta }, warnings, dialect, mode),
             });
         }
     }
@@ -73,14 +77,14 @@ export function formatDtcg(doc, opts) {
         for (const set of doc.sets) {
             files.push({
                 path: filenameFor(opts, set),
-                content: serializeAsDtcg({ sets: [set], meta: doc.meta }, warnings),
+                content: serializeAsDtcg({ sets: [set], meta: doc.meta }, warnings, dialect),
             });
         }
     }
     else {
         files.push({
             path: filenameFor(opts),
-            content: serializeAsDtcg(doc, warnings),
+            content: serializeAsDtcg(doc, warnings, dialect),
         });
     }
     return { files, warnings };
@@ -131,7 +135,7 @@ function slugify(s) {
  * file represents — otherwise the parser sees only `$value` literals and
  * labels them "Default", which breaks round-trip diffs on multi-mode files.
  */
-function serializeAsDtcg(doc, warnings, fileMode) {
+function serializeAsDtcg(doc, warnings, dialect, fileMode) {
     // Build the nested DTCG group tree by walking every token's path and
     // building groups along the way.
     const tree = {};
@@ -176,7 +180,7 @@ function serializeAsDtcg(doc, warnings, fileMode) {
             tree[setKey] = setGroup;
         }
         for (const token of set.tokens) {
-            writeTokenIntoTree(setGroup, token, set.modes, warnings, fileMode);
+            writeTokenIntoTree(setGroup, token, set.modes, warnings, dialect, fileMode);
         }
     }
     return JSON.stringify(sortKeys(tree), null, 2) + "\n";
@@ -200,7 +204,7 @@ function setKeyFor(set) {
  * figma-console-mcp $extensions so the parser can restore the original
  * name on round-trip. A warning names both sides of the conflict.
  */
-function writeTokenIntoTree(root, token, setModes, warnings, fileMode) {
+function writeTokenIntoTree(root, token, setModes, warnings, dialect, fileMode) {
     let cursor = root;
     for (let i = 0; i < token.path.length - 1; i++) {
         const segment = token.path[i];
@@ -222,7 +226,7 @@ function writeTokenIntoTree(root, token, setModes, warnings, fileMode) {
         cursor = next;
     }
     const leafKey = token.path[token.path.length - 1];
-    const rendered = renderToken(token, setModes, warnings, fileMode);
+    const rendered = renderToken(token, setModes, warnings, dialect, fileMode);
     const existing = cursor[leafKey];
     if (existing &&
         typeof existing === "object" &&
@@ -261,7 +265,7 @@ function isToken(node) {
  * splitByMode. Callers who want one-file-per-mode should set splitByMode at
  * the formatter level.
  */
-function renderToken(token, setModes, warnings, fileMode) {
+function renderToken(token, setModes, warnings, dialect, fileMode) {
     const result = {
         $value: "",
         $type: token.type,
@@ -273,13 +277,13 @@ function renderToken(token, setModes, warnings, fileMode) {
     // Pick the primary mode: the set's first mode when the token has a value
     // for it, otherwise the token's first mode.
     const primaryMode = setModes[0] in token.values ? setModes[0] : modeKeys[0];
-    result.$value = encodeValue(token.values[primaryMode], token, warnings);
+    result.$value = encodeValue(token.values[primaryMode], token, warnings, dialect);
     const otherModes = {};
     if (!isSingleMode) {
         for (const m of modeKeys) {
             if (m === primaryMode)
                 continue;
-            otherModes[m] = encodeValue(token.values[m], token, warnings);
+            otherModes[m] = encodeValue(token.values[m], token, warnings, dialect);
         }
     }
     // Preserve any pre-existing extensions (e.g. studio.tokens, our own metadata).
@@ -311,7 +315,7 @@ function renderToken(token, setModes, warnings, fileMode) {
     }
     return result;
 }
-function encodeValue(value, token, warnings) {
+function encodeValue(value, token, warnings, dialect) {
     if (!value) {
         warnings.push(`Token ${token.path.join(".")} has no mode values — emitting empty string.`);
         return "";
@@ -323,6 +327,23 @@ function encodeValue(value, token, warnings) {
         warnings.push(`Token ${token.path.join(".")} has neither literal nor reference — emitting empty string.`);
         return "";
     }
+    // DTCG 2025.10 dialect: colors emit the object form (components from the
+    // converter's full-precision rawColor floats, hex kept as the interop
+    // courtesy field); dimension-typed bare numbers emit { value, unit: "px" }.
+    // duration already emits { value, unit: "ms" } in both dialects. Anything
+    // the encoders don't recognize keeps the legacy rendering.
+    if (dialect === "2025") {
+        if (token.type === "color") {
+            const encoded = colorValueTo2025(value);
+            if (encoded)
+                return encoded;
+        }
+        else if (token.type === "dimension") {
+            const encoded = dimensionLiteralTo2025(value.literal);
+            if (encoded)
+                return encoded;
+        }
+    }
     return value.literal;
 }
 function mergeExtension(token, key, payload) {

package/dist/cloudflare/core/tokens/formatters/json.js

@@ -31,11 +31,13 @@
  * aliases get a `null` (caller can decide how to fill those in).
  */
 import { buildTokenIndex, resolveAliasChain } from "../alias-resolver.js";
+import { colorValueTo2025, dimensionLiteralTo2025, } from "../dialect.js";
 export function formatJsonFlat(doc, opts) {
     const warnings = [];
     const files = [];
     const splitByCollection = opts.target.splitByCollection ?? false;
     const prefix = opts.target.prefix ?? "";
+    const dialect = opts.target.dtcgDialect ?? "legacy";
     // Plain JSON has no native alias mechanism — resolve aliases to their
     // literal target so consumers get usable values, not opaque `{ref}` strings.
     const tokenIndex = buildTokenIndex(doc);
@@ -43,14 +45,14 @@ export function formatJsonFlat(doc, opts) {
         for (const set of doc.sets) {
             files.push({
                 path: filenameFor(opts, set, "flat"),
-                content: renderFlat([set], prefix, tokenIndex, warnings),
+                content: renderFlat([set], prefix, tokenIndex, warnings, dialect),
             });
         }
     }
     else {
         files.push({
             path: filenameFor(opts, undefined, "flat"),
-            content: renderFlat(doc.sets, prefix, tokenIndex, warnings),
+            content: renderFlat(doc.sets, prefix, tokenIndex, warnings, dialect),
         });
     }
     return { files, warnings };
@@ -59,19 +61,20 @@ export function formatJsonNested(doc, opts) {
     const warnings = [];
     const files = [];
     const splitByCollection = opts.target.splitByCollection ?? false;
+    const dialect = opts.target.dtcgDialect ?? "legacy";
     const tokenIndex = buildTokenIndex(doc);
     if (splitByCollection) {
         for (const set of doc.sets) {
             files.push({
                 path: filenameFor(opts, set, "nested"),
-                content: renderNested([set], tokenIndex, warnings),
+                content: renderNested([set], tokenIndex, warnings, dialect),
             });
         }
     }
     else {
         files.push({
             path: filenameFor(opts, undefined, "nested"),
-            content: renderNested(doc.sets, tokenIndex, warnings),
+            content: renderNested(doc.sets, tokenIndex, warnings, dialect),
         });
     }
     return { files, warnings };
@@ -92,7 +95,7 @@ function slugify(s) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }
-function renderFlat(sets, prefix, tokenIndex, warnings) {
+function renderFlat(sets, prefix, tokenIndex, warnings, dialect) {
     const out = {};
     for (const set of sets) {
         const primaryMode = pickPrimaryMode(set.modes);
@@ -102,7 +105,7 @@ function renderFlat(sets, prefix, tokenIndex, warnings) {
                 const key = modeName === primaryMode
                     ? baseName
                     : `${baseName}--${slugify(modeName)}`;
-                const resolved = resolveValue(value, token, modeName, tokenIndex, warnings);
+                const resolved = resolveValue(value, token, modeName, tokenIndex, warnings, dialect);
                 if (resolved !== undefined)
                     out[key] = resolved;
             }
@@ -112,7 +115,7 @@ function renderFlat(sets, prefix, tokenIndex, warnings) {
     const sorted = Object.fromEntries(Object.entries(out).sort(([a], [b]) => a.localeCompare(b)));
     return JSON.stringify(sorted, null, 2) + "\n";
 }
-function renderNested(sets, tokenIndex, warnings) {
+function renderNested(sets, tokenIndex, warnings, dialect) {
     const out = {};
     for (const set of sets) {
         const isMultiMode = set.modes.length > 1;
@@ -131,7 +134,7 @@ function renderNested(sets, tokenIndex, warnings) {
             if (isMultiMode) {
                 const modeValues = {};
                 for (const [modeName, value] of Object.entries(token.values)) {
-                    const resolved = resolveValue(value, token, modeName, tokenIndex, warnings);
+                    const resolved = resolveValue(value, token, modeName, tokenIndex, warnings, dialect);
                     if (resolved !== undefined)
                         modeValues[modeName] = resolved;
                 }
@@ -140,7 +143,7 @@ function renderNested(sets, tokenIndex, warnings) {
             else {
                 const [onlyModeName, onlyValue] = Object.entries(token.values)[0] ?? [];
                 if (onlyValue) {
-                    const resolved = resolveValue(onlyValue, token, onlyModeName, tokenIndex, warnings);
+                    const resolved = resolveValue(onlyValue, token, onlyModeName, tokenIndex, warnings, dialect);
                     if (resolved !== undefined)
                         cursor[leafKey] = resolved;
                 }
@@ -152,7 +155,7 @@ function renderNested(sets, tokenIndex, warnings) {
 function pickPrimaryMode(modes) {
     return modes.find((m) => /^(default|light|value)$/i.test(m)) ?? modes[0];
 }
-function resolveValue(value, token, mode, tokenIndex, warnings) {
+function resolveValue(value, token, mode, tokenIndex, warnings, dialect) {
     let effective = value;
     if (value.reference) {
         effective = resolveAliasChain(value, mode, tokenIndex);
@@ -168,6 +171,21 @@ function resolveValue(value, token, mode, tokenIndex, warnings) {
     if (!effective || effective.literal === undefined || effective.literal === null) {
         return undefined;
     }
+    // DTCG 2025.10 dialect (opt-in): colors emit the object form, dimensions
+    // emit { value, unit: "px" }. Legacy (default) keeps hex strings and
+    // "16px" strings — byte-identical to historical output.
+    if (dialect === "2025") {
+        if (token.type === "color") {
+            const encoded = colorValueTo2025(effective);
+            if (encoded)
+                return encoded;
+        }
+        else if (token.type === "dimension") {
+            const encoded = dimensionLiteralTo2025(effective.literal);
+            if (encoded)
+                return encoded;
+        }
+    }
     if (typeof effective.literal === "number") {
         if (token.type === "dimension")
             return `${effective.literal}px`;

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, referenceTargetPath, slugifySetName, } 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/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