@muloka/figma-console-mcp 0.1.0

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

@@ -0,0 +1,377 @@
+/**
+ * DTCG (Design Tokens Community Group) JSON formatter.
+ *
+ * Produces W3C-spec DTCG output (https://tr.designtokens.org/format/) with
+ * three nuances:
+ *
+ *   1. Multi-mode tokens. The DTCG v1 spec doesn't natively express modes;
+ *      we use a separate file per mode (driven by `splitByMode: true`) or a
+ *      single file with values keyed by mode under a vendor extension when
+ *      splitByMode is false. The split-file approach is the recommended
+ *      pattern in the broader DTCG community and is what Style Dictionary
+ *      v4, Tokens Studio, and Figma's announced native export all use.
+ *
+ *   2. $extensions["figma-console-mcp"]. We stash Figma variable IDs and
+ *      last-synced values here for non-destructive round-trip. Other DTCG
+ *      tools preserve $extensions verbatim.
+ *
+ *   3. Composite tokens (typography, shadow, gradient) emit DTCG's
+ *      structured $value form. Aliases emit `"$value": "{path.to.target}"`.
+ *
+ * This formatter is the canonical output — the format every other
+ * 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 = [];
+    // Figure out which sets and modes to emit, and how they map to files.
+    // Three layout strategies:
+    //   1. splitByMode + splitByCollection → one file per (set, mode) pair
+    //   2. splitByMode → one file per mode, all sets merged
+    //   3. splitByCollection → one file per set, all modes in one tree
+    //   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) {
+                const fileTokens = set.tokens
+                    .map((t) => projectTokenToMode(t, mode, warnings))
+                    .filter((t) => t !== null);
+                files.push({
+                    path: filenameFor(opts, set, mode),
+                    content: serializeAsDtcg({ sets: [{ ...set, modes: [mode], tokens: fileTokens }], meta: doc.meta }, warnings, dialect, mode),
+                });
+            }
+        }
+    }
+    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 fileSets = doc.sets
+                .filter((s) => s.modes.includes(mode))
+                .map((s) => ({
+                ...s,
+                modes: [mode],
+                tokens: s.tokens
+                    .map((t) => projectTokenToMode(t, mode, warnings))
+                    .filter((t) => t !== null),
+            }));
+            files.push({
+                path: filenameFor(opts, undefined, mode),
+                content: serializeAsDtcg({ sets: fileSets, meta: doc.meta }, warnings, dialect, mode),
+            });
+        }
+    }
+    else if (splitByCollection) {
+        for (const set of doc.sets) {
+            files.push({
+                path: filenameFor(opts, set),
+                content: serializeAsDtcg({ sets: [set], meta: doc.meta }, warnings, dialect),
+            });
+        }
+    }
+    else {
+        files.push({
+            path: filenameFor(opts),
+            content: serializeAsDtcg(doc, warnings, dialect),
+        });
+    }
+    return { files, warnings };
+}
+/**
+ * Project a token's values down to a single mode. Returns null if the token
+ * has no value for the requested mode (skip rather than emit a blank).
+ */
+function projectTokenToMode(token, mode, warnings) {
+    const value = token.values[mode];
+    if (!value) {
+        // Token wasn't defined for this mode. Could happen when sets share tokens
+        // but only some have multi-mode values. Skip silently — not an error.
+        return null;
+    }
+    return { ...token, values: { [mode]: value } };
+}
+/**
+ * Compute the output filename for a given (set?, mode?) tuple based on the
+ * target options.
+ */
+function filenameFor(opts, set, mode) {
+    // Caller-specified filename wins.
+    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(".")}.tokens.json`;
+}
+function slugify(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Serialize a TokenDocument as DTCG JSON. Returns a pretty-printed JSON string
+ * with stable key order so git diffs stay minimal across runs.
+ *
+ * When `fileMode` is provided (splitByMode output), it's stamped into
+ * document-level $extensions so the parser can recover which mode this
+ * 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, dialect, fileMode) {
+    // Build the nested DTCG group tree by walking every token's path and
+    // building groups along the way.
+    const tree = {};
+    // Document-level $extensions: stash file-level metadata (Figma file key,
+    // export timestamp, MCP version, optionally the file's mode for
+    // splitByMode output) so round-trip preserves it.
+    const mcpDocMeta = {};
+    if (doc.meta?.figmaFileKey)
+        mcpDocMeta.figmaFileKey = doc.meta.figmaFileKey;
+    if (doc.meta?.exportedAt)
+        mcpDocMeta.exportedAt = doc.meta.exportedAt;
+    if (doc.meta?.mcpVersion)
+        mcpDocMeta.mcpVersion = doc.meta.mcpVersion;
+    if (fileMode)
+        mcpDocMeta.fileMode = fileMode;
+    if (Object.keys(mcpDocMeta).length > 0) {
+        tree.$extensions = { [FIGMA_MCP_EXTENSION_KEY]: mcpDocMeta };
+    }
+    for (const set of doc.sets) {
+        // Each set lives under a top-level group named after the set. Set-level
+        // metadata (Figma collection ID, original name, etc.) goes in that
+        // group's $extensions so round-trip recovers the original name even
+        // after we slugify it for the JSON key.
+        const setKey = setKeyFor(set);
+        let setGroup = tree[setKey];
+        if (!setGroup) {
+            setGroup = {};
+            if (set.description)
+                setGroup.$description = set.description;
+            const mcpMeta = {};
+            if (set.meta?.figmaCollectionId) {
+                mcpMeta.figmaCollectionId = set.meta.figmaCollectionId;
+            }
+            // Always stash the original name when it differs from the slug — this
+            // is what makes diff matching work after round-trip.
+            if (set.name !== setKey) {
+                mcpMeta.originalName = set.name;
+            }
+            if (Object.keys(mcpMeta).length > 0) {
+                setGroup.$extensions = { [FIGMA_MCP_EXTENSION_KEY]: mcpMeta };
+            }
+            tree[setKey] = setGroup;
+        }
+        for (const token of set.tokens) {
+            writeTokenIntoTree(setGroup, token, set.modes, warnings, dialect, fileMode);
+        }
+    }
+    return JSON.stringify(sortKeys(tree), null, 2) + "\n";
+}
+/**
+ * Key used for the top-level set group in DTCG. We slugify the set name to
+ * keep it a valid JSON key under any consumer's expectations. The original
+ * (un-slugged) name is preserved in the set's $extensions so round-trip
+ * recovers it.
+ */
+function setKeyFor(set) {
+    return slugify(set.name);
+}
+/**
+ * Insert a token into the DTCG group tree at the right nested path.
+ * Creates intermediate groups as needed.
+ *
+ * Leaf/group name conflicts (a variable named "color" alongside
+ * "color/primary") are kept — the leaf is emitted under the reserved "@"
+ * key inside the group, flagged with `leafRemap: true` in its
+ * 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, dialect, fileMode) {
+    let cursor = root;
+    for (let i = 0; i < token.path.length - 1; i++) {
+        const segment = token.path[i];
+        let next = cursor[segment];
+        if (next && isToken(next)) {
+            // A leaf token already occupies this segment and we need a group
+            // here. Keep both: demote the existing leaf to the reserved "@" key
+            // inside the new group.
+            const conflictPath = token.path.slice(0, i + 1).join("/");
+            warnings.push(`Name conflict: "${conflictPath}" is both a token and a group (needed by "${token.path.join("/")}"). Kept both — the leaf token "${conflictPath}" was emitted under "${conflictPath}/@" and round-trips back to its original name.`);
+            const group = { "@": markLeafRemap(next) };
+            cursor[segment] = group;
+            next = group;
+        }
+        else if (!next) {
+            next = {};
+            cursor[segment] = next;
+        }
+        cursor = next;
+    }
+    const leafKey = token.path[token.path.length - 1];
+    const rendered = renderToken(token, setModes, warnings, dialect, fileMode);
+    const existing = cursor[leafKey];
+    if (existing &&
+        typeof existing === "object" &&
+        !isToken(existing)) {
+        // A group already exists at this name (some other token nests under
+        // it). Keep both: emit this leaf under the reserved "@" key.
+        const conflictPath = token.path.join("/");
+        warnings.push(`Name conflict: token "${conflictPath}" collides with the group "${conflictPath}" (created by tokens nested under it). Kept both — the leaf was emitted under "${conflictPath}/@" and round-trips back to its original name.`);
+        existing["@"] = markLeafRemap(rendered);
+        return;
+    }
+    cursor[leafKey] = rendered;
+}
+/**
+ * Flag a rendered leaf token as remapped under the reserved "@" key so the
+ * parser can strip that synthetic path segment on round-trip.
+ */
+function markLeafRemap(tok) {
+    const existing = tok.$extensions?.[FIGMA_MCP_EXTENSION_KEY] ?? {};
+    tok.$extensions ??= {};
+    tok.$extensions[FIGMA_MCP_EXTENSION_KEY] = { ...existing, leafRemap: true };
+    return tok;
+}
+function isToken(node) {
+    return "$value" in node;
+}
+/**
+ * Convert an internal Token to its DTCG-encoded leaf form.
+ *
+ * Single-mode token: emits `{ $value, $type, ... }`.
+ * Multi-mode token: emits the primary mode as `$value` and stashes BOTH the
+ * primary mode's name (`primaryMode`) and the remaining mode values
+ * (`modes`) under `$extensions["figma-console-mcp"]`, because vanilla DTCG
+ * doesn't have a native multi-mode encoding. The parser reads the same keys
+ * back, so a Light/Dark collection round-trips losslessly even without
+ * splitByMode. Callers who want one-file-per-mode should set splitByMode at
+ * the formatter level.
+ */
+function renderToken(token, setModes, warnings, dialect, fileMode) {
+    const result = {
+        $value: "",
+        $type: token.type,
+    };
+    if (token.description)
+        result.$description = token.description;
+    const modeKeys = Object.keys(token.values);
+    const isSingleMode = modeKeys.length === 1;
+    // 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, dialect);
+    const otherModes = {};
+    if (!isSingleMode) {
+        for (const m of modeKeys) {
+            if (m === primaryMode)
+                continue;
+            otherModes[m] = encodeValue(token.values[m], token, warnings, dialect);
+        }
+    }
+    // Preserve any pre-existing extensions (e.g. studio.tokens, our own metadata).
+    if (token.extensions) {
+        for (const [vendor, payload] of Object.entries(token.extensions)) {
+            if (vendor === FIGMA_MCP_EXTENSION_KEY) {
+                mergeExtension(result, vendor, payload);
+            }
+            else {
+                mergeExtension(result, vendor, payload);
+            }
+        }
+    }
+    // Mode round-trip metadata goes under OUR extension key (merged on top of
+    // any preserved figma-console-mcp payload so variableId etc. survive):
+    //   - `primaryMode` whenever the parser couldn't otherwise recover the
+    //     primary mode's name (i.e. it isn't covered by the file-level
+    //     fileMode stamp and isn't the "Default" fallback).
+    //   - `modes` with every non-primary mode's value for multi-mode tokens.
+    const needsPrimaryStash = primaryMode !== (fileMode ?? "Default");
+    const hasOtherModes = Object.keys(otherModes).length > 0;
+    if (needsPrimaryStash || hasOtherModes) {
+        const existing = result.$extensions?.[FIGMA_MCP_EXTENSION_KEY] ?? {};
+        mergeExtension(result, FIGMA_MCP_EXTENSION_KEY, {
+            ...existing,
+            primaryMode,
+            ...(hasOtherModes ? { modes: otherModes } : {}),
+        });
+    }
+    return result;
+}
+function encodeValue(value, token, warnings, dialect) {
+    if (!value) {
+        warnings.push(`Token ${token.path.join(".")} has no mode values — emitting empty string.`);
+        return "";
+    }
+    if (value.reference) {
+        return formatDtcgReference(value.reference.replace(/^\{|\}$/g, "").split("."));
+    }
+    if (value.literal === undefined) {
+        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) {
+    token.$extensions ??= {};
+    token.$extensions[key] = payload;
+}
+/**
+ * Recursively sort object keys for stable serialization (so git diffs only
+ * show meaningful changes). $-prefixed keys come first (DTCG convention),
+ * then alphabetical.
+ */
+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((a, b) => {
+        const aDollar = a.startsWith("$");
+        const bDollar = b.startsWith("$");
+        if (aDollar && !bDollar)
+            return -1;
+        if (!aDollar && bDollar)
+            return 1;
+        return a.localeCompare(b);
+    });
+    for (const k of keys)
+        sorted[k] = sortKeys(obj[k]);
+    return sorted;
+}
+//# sourceMappingURL=dtcg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/dtcg.ts"],"names":[],"mappings":"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"}

package/dist/core/tokens/formatters/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Formatter dispatcher. Each formatter converts our canonical internal
+ * TokenDocument into a specific output format (DTCG JSON, CSS custom
+ * properties, Tailwind v4 @theme, SCSS, etc.).
+ */
+import type { ExportFormat, TokenDocument } from "../types.js";
+import type { OutputTarget } from "../config.js";
+export interface FormatOptions {
+    /** Output target options merged from per-call args and tokens.config.json. */
+    target: OutputTarget;
+    /** Project root path. Resolves output filenames relative to this. */
+    projectRoot?: string;
+}
+export interface FormatResult {
+    /**
+     * Output files to write. Single-file formats return one entry; split formats
+     * (splitByMode, splitByCollection) return one per file.
+     */
+    files: Array<{
+        /** Relative path from the configured generated.dir or projectRoot. */
+        path: string;
+        /** UTF-8 content. */
+        content: string;
+    }>;
+    /** Format-specific warnings (e.g. "composite typography expanded to primitives"). */
+    warnings: string[];
+}
+export declare function format(doc: TokenDocument, options: FormatOptions): FormatResult;
+export type { ExportFormat };
+//# sourceMappingURL=index.d.ts.map

package/dist/core/tokens/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAajD,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,MAAM,EAAE,YAAY,CAAC;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;QACX,sEAAsE;QACtE,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,qFAAqF;IACrF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,MAAM,CACpB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,aAAa,GACrB,YAAY,CA+Bd;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Formatter dispatcher. Each formatter converts our canonical internal
+ * TokenDocument into a specific output format (DTCG JSON, CSS custom
+ * properties, Tailwind v4 @theme, SCSS, etc.).
+ */
+import { formatDtcg } from "./dtcg.js";
+import { formatTokensStudio } from "./tokens-studio.js";
+import { formatCssVars } from "./css-vars.js";
+import { formatTailwindV4 } from "./tailwind-v4.js";
+import { formatTailwindV3 } from "./tailwind-v3.js";
+import { formatScss } from "./scss.js";
+import { formatLess } from "./less.js";
+import { formatTsModule } from "./ts-module.js";
+import { formatJsonFlat, formatJsonNested } from "./json.js";
+import { formatStyleDictionaryV3 } from "./style-dictionary-v3.js";
+export function format(doc, options) {
+    switch (options.target.format) {
+        case "dtcg":
+            return formatDtcg(doc, options);
+        case "tokens-studio":
+            return formatTokensStudio(doc, options);
+        case "css-vars":
+            return formatCssVars(doc, options);
+        case "tailwind-v4":
+            return formatTailwindV4(doc, options);
+        case "tailwind-v3":
+            return formatTailwindV3(doc, options);
+        case "scss":
+            return formatScss(doc, options);
+        case "less":
+            return formatLess(doc, options);
+        case "ts-module":
+            return formatTsModule(doc, options);
+        case "json-flat":
+            return formatJsonFlat(doc, options);
+        case "json-nested":
+            return formatJsonNested(doc, options);
+        case "style-dictionary-v3":
+            return formatStyleDictionaryV3(doc, options);
+        default: {
+            const _exhaustive = options.target.format;
+            throw new Error(`[figma-console-mcp] Unknown export format: ${_exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAwBnE,MAAM,UAAU,MAAM,CACpB,GAAkB,EAClB,OAAsB;IAEtB,QAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,eAAe;YAClB,OAAO,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,KAAK,UAAU;YACb,OAAO,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,qBAAqB;YACxB,OAAO,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,8CAA8C,WAAW,EAAE,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/tokens/formatters/json.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Plain JSON formatters — flat and nested.
+ *
+ * These are dumps without the DTCG `$type`/`$value` envelope, for custom
+ * build scripts that just need a key-value map of resolved tokens.
+ *
+ * Flat shape:
+ *
+ *   {
+ *     "ds-color-primary": "#4085F2",
+ *     "ds-spacing-md": "16px",
+ *     "ds-color-bg--dark": "#0A0A0A"
+ *   }
+ *
+ * Multi-mode tokens flatten with `--<mode>` suffix (primary mode keeps
+ * the bare name; other modes get suffixed).
+ *
+ * Nested shape:
+ *
+ *   {
+ *     "color": {
+ *       "primary": "#4085F2",
+ *       "brand": { "primary": "#FF00AA" }
+ *     },
+ *     "spacing": { "md": "16px" }
+ *   }
+ *
+ * Multi-mode tokens become objects: `{ Light: "...", Dark: "..." }`.
+ *
+ * Aliases resolve to the literal value where possible; cross-library
+ * aliases get a `null` (caller can decide how to fill those in).
+ */
+import type { TokenDocument } from "../types.js";
+import type { FormatOptions, FormatResult } from "./index.js";
+export declare function formatJsonFlat(doc: TokenDocument, opts: FormatOptions): FormatResult;
+export declare function formatJsonNested(doc: TokenDocument, opts: FormatOptions): FormatResult;
+//# sourceMappingURL=json.d.ts.map

package/dist/core/tokens/formatters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAwB,MAAM,aAAa,CAAC;AAO9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CA0Bd;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CAuBd"}