@mp3wizard/figma-console-mcp 1.25.1 → 1.27.2

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

@@ -0,0 +1,254 @@
+/**
+ * DTCG (Design Tokens Community Group) JSON parser.
+ *
+ * Reads DTCG-spec JSON (https://tr.designtokens.org/format/) and produces our
+ * canonical internal TokenDocument. Designed for non-destructive round-trip:
+ * a document serialized by `formatDtcg` then parsed back through this module
+ * is equal to the original (modulo key ordering, which the formatter sorts
+ * for stable diffs).
+ *
+ * Handles:
+ *   - Group nesting with arbitrary depth
+ *   - $value / $type / $description / $extensions on leaf tokens
+ *   - Alias references: `"$value": "{path.to.token}"`
+ *   - Group-level $type inheritance per the DTCG spec (tokens without their
+ *     own $type inherit from their nearest ancestor group that has one)
+ *   - Our $extensions["figma-console-mcp"] metadata for round-trip ID preservation
+ *   - Multi-mode tokens stashed in $extensions.modes by our formatter
+ */
+import { FIGMA_MCP_EXTENSION_KEY } from "../types.js";
+import { parseDtcgReference } from "../alias-resolver.js";
+const DTCG_TYPES = new Set([
+    "color",
+    "dimension",
+    "fontFamily",
+    "fontWeight",
+    "duration",
+    "cubicBezier",
+    "number",
+    "string",
+    "boolean",
+    "shadow",
+    "typography",
+    "gradient",
+    "border",
+    "transition",
+    "strokeStyle",
+]);
+export function parseDtcg(input) {
+    const warnings = [];
+    const root = parseJson(input);
+    // Document-level $extensions: pull out our MCP metadata if present.
+    // `fileMode` is the critical piece for splitByMode round-trip — when set,
+    // every token in the file represents that mode's value, so we label them
+    // accordingly instead of falling back to "Default".
+    const meta = {};
+    let fileMode;
+    const rootExt = root.$extensions;
+    if (rootExt && typeof rootExt === "object") {
+        const mcpMeta = rootExt[FIGMA_MCP_EXTENSION_KEY];
+        if (mcpMeta && typeof mcpMeta === "object") {
+            const m = mcpMeta;
+            if (typeof m.figmaFileKey === "string")
+                meta.figmaFileKey = m.figmaFileKey;
+            if (typeof m.exportedAt === "string")
+                meta.exportedAt = m.exportedAt;
+            if (typeof m.mcpVersion === "string")
+                meta.mcpVersion = m.mcpVersion;
+            if (typeof m.fileMode === "string")
+                fileMode = m.fileMode;
+        }
+    }
+    // Each top-level group is a TokenSet. Walk it to extract its tokens.
+    const sets = [];
+    for (const [setKey, setNode] of Object.entries(root)) {
+        if (setKey.startsWith("$"))
+            continue; // $extensions etc.
+        if (!setNode || typeof setNode !== "object") {
+            warnings.push(`Top-level entry "${setKey}" is not a group; skipping. Expected object.`);
+            continue;
+        }
+        sets.push(extractSet(setKey, setNode, warnings, fileMode));
+    }
+    return {
+        document: {
+            $schema: "https://figma-console-mcp.southleft.com/schemas/dtcg-extended-v1.json",
+            sets,
+            meta: Object.keys(meta).length > 0 ? meta : undefined,
+        },
+        detectedFormat: "dtcg",
+        warnings,
+    };
+}
+function parseJson(input) {
+    try {
+        return JSON.parse(input.payload);
+    }
+    catch (err) {
+        throw new Error(`[figma-console-mcp] Failed to parse DTCG JSON${input.sourcePath ? ` at ${input.sourcePath}` : ""}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function extractSet(setKey, setNode, warnings, fileMode) {
+    const tokens = [];
+    const modes = new Set();
+    // Set-level metadata pulled from $extensions["figma-console-mcp"]. We
+    // recover the original (un-slugified) set name from `originalName` so
+    // round-trip matching works even after slugification.
+    const setExt = setNode.$extensions;
+    let figmaCollectionId;
+    let originalName;
+    if (setExt && typeof setExt === "object") {
+        const mcp = setExt[FIGMA_MCP_EXTENSION_KEY];
+        if (mcp && typeof mcp === "object") {
+            const m = mcp;
+            if (typeof m.figmaCollectionId === "string") {
+                figmaCollectionId = m.figmaCollectionId;
+            }
+            if (typeof m.originalName === "string") {
+                originalName = m.originalName;
+            }
+        }
+    }
+    // Walk the set's tree, collecting tokens.
+    walkGroup(setNode, [], undefined, tokens, modes, warnings, fileMode);
+    return {
+        name: originalName ?? setKey,
+        description: typeof setNode.$description === "string" ? setNode.$description : undefined,
+        modes: modes.size > 0 ? [...modes] : ["Default"],
+        tokens,
+        meta: figmaCollectionId ? { figmaCollectionId } : undefined,
+    };
+}
+function walkGroup(node, path, inheritedType, tokens, modes, warnings, fileMode) {
+    // Group-level $type provides inheritance for descendant tokens that lack
+    // their own $type, per the DTCG spec.
+    const groupType = typeof node.$type === "string" && DTCG_TYPES.has(node.$type)
+        ? node.$type
+        : inheritedType;
+    for (const [key, value] of Object.entries(node)) {
+        if (key.startsWith("$"))
+            continue;
+        if (!value || typeof value !== "object") {
+            warnings.push(`Non-group, non-token entry at ${[...path, key].join(".")}; skipping.`);
+            continue;
+        }
+        const childPath = [...path, key];
+        if (isLeafToken(value)) {
+            const token = extractToken(childPath, value, groupType, warnings, fileMode);
+            tokens.push(token);
+            for (const mode of Object.keys(token.values))
+                modes.add(mode);
+        }
+        else {
+            walkGroup(value, childPath, groupType, tokens, modes, warnings, fileMode);
+        }
+    }
+}
+function isLeafToken(node) {
+    return "$value" in node;
+}
+function extractToken(path, node, inheritedType, warnings, fileMode) {
+    const rawType = node.$type;
+    let type;
+    if (typeof rawType === "string" && DTCG_TYPES.has(rawType)) {
+        type = rawType;
+    }
+    else if (inheritedType) {
+        type = inheritedType;
+    }
+    else {
+        type = inferType(node.$value);
+        warnings.push(`Token ${path.join(".")} has no $type and no group $type inherited; inferred "${type}".`);
+    }
+    const description = typeof node.$description === "string" ? node.$description : undefined;
+    // Detect multi-mode stashed in $extensions.{FIGMA_MCP_EXTENSION_KEY}.modes
+    // (placed there by our own formatter for one-file-multi-mode output).
+    const values = {};
+    const ext = node.$extensions;
+    const mcpExt = ext && typeof ext === "object"
+        ? ext[FIGMA_MCP_EXTENSION_KEY]
+        : undefined;
+    const stashedModes = mcpExt?.modes;
+    // 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.
+    // Then absorb any stashedModes (one-file-multi-mode output) verbatim.
+    const primaryMode = fileMode ?? "Default";
+    values[primaryMode] = decodeValue(node.$value);
+    if (stashedModes) {
+        for (const [modeName, modeValue] of Object.entries(stashedModes)) {
+            // Don't overwrite the primary if a stashed entry collides with it.
+            if (modeName !== primaryMode) {
+                values[modeName] = decodeValue(modeValue);
+            }
+        }
+    }
+    // Preserve all other vendor extensions verbatim.
+    let extensions;
+    if (ext && typeof ext === "object") {
+        extensions = {};
+        for (const [vendor, payload] of Object.entries(ext)) {
+            if (vendor === FIGMA_MCP_EXTENSION_KEY &&
+                payload &&
+                typeof payload === "object") {
+                // Strip the "modes" we already absorbed into values.
+                const cleaned = { ...payload };
+                delete cleaned.modes;
+                if (Object.keys(cleaned).length > 0) {
+                    extensions[vendor] = cleaned;
+                }
+            }
+            else {
+                extensions[vendor] = payload;
+            }
+        }
+        if (Object.keys(extensions).length === 0)
+            extensions = undefined;
+    }
+    return {
+        path,
+        type,
+        description,
+        values,
+        extensions,
+    };
+}
+/**
+ * Convert a DTCG $value to our internal TokenValue. Detects alias references
+ * (strings of the form `{path.to.token}`) and unwraps them into TokenValue.reference.
+ */
+function decodeValue(rawValue) {
+    if (typeof rawValue === "string") {
+        const refPath = parseDtcgReference(rawValue);
+        if (refPath) {
+            return { reference: rawValue };
+        }
+        return { literal: rawValue };
+    }
+    if (rawValue === null ||
+        typeof rawValue === "number" ||
+        typeof rawValue === "boolean") {
+        return { literal: rawValue ?? "" };
+    }
+    // Composite values (typography, shadow, etc.) — preserve verbatim.
+    return { literal: rawValue };
+}
+function inferType(rawValue) {
+    if (typeof rawValue === "string") {
+        // Heuristics: color-ish strings → color; px/rem/em → dimension; else string.
+        if (/^#[0-9a-f]{3,8}$/i.test(rawValue))
+            return "color";
+        if (/^(rgb|hsl|oklch)/i.test(rawValue))
+            return "color";
+        if (/^[\d.]+(px|rem|em|pt|dp)$/i.test(rawValue))
+            return "dimension";
+        return "string";
+    }
+    if (typeof rawValue === "number")
+        return "number";
+    if (typeof rawValue === "boolean")
+        return "boolean";
+    return "string";
+}
+//# sourceMappingURL=dtcg.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Parser dispatcher. Each parser converts an input format into our canonical
+ * internal TokenDocument model.
+ */
+import type { ImportFormat, TokenDocument } from "../types.js";
+export interface ParseInput {
+    /** Raw text content of the source file. */
+    payload: string;
+    /** Optional file path — used for auto-detection by extension and for error messages. */
+    sourcePath?: string;
+}
+export interface ParseResult {
+    document: TokenDocument;
+    /** Format the parser used (resolved from 'auto' when applicable). */
+    detectedFormat: Exclude<ImportFormat, "auto">;
+    /** Non-fatal warnings to surface to the user (unknown $type, etc.). */
+    warnings: string[];
+}
+/**
+ * Parse a payload using the given format. When format is 'auto', sniffs the
+ * payload to pick the right parser.
+ */
+export declare function parse(format: ImportFormat, input: ParseInput): ParseResult;
+/**
+ * Sniff the payload to determine its format. Order matters — earlier checks
+ * are higher-priority signals.
+ *
+ *  1. JSON content with DTCG markers ($value/$type at any depth)
+ *  2. JSON content with Tokens Studio markers ($themes.json or $metadata)
+ *  3. JSON content with Style Dictionary v3 markers (bare value/type)
+ *  4. Tailwind v4 `@theme` block
+ *  5. CSS custom properties (`:root { --foo: bar; }`)
+ *  6. SCSS variables (`$foo: bar;`)
+ *  7. File extension as a last-resort hint
+ */
+export declare function detectFormat(input: ParseInput): Exclude<ImportFormat, "auto">;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAW/D,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9C,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,CA0B1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAsC7E"}

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

@@ -0,0 +1,139 @@
+/**
+ * Parser dispatcher. Each parser converts an input format into our canonical
+ * internal TokenDocument model.
+ */
+import { parseDtcg } from "./dtcg.js";
+import { parseTokensStudio } from "./tokens-studio.js";
+import { parseCssVars } from "./css-vars.js";
+import { parseTailwindV4 } from "./tailwind-v4.js";
+import { parseTailwindV3Config } from "./tailwind-v3.js";
+import { parseScss } from "./scss.js";
+import { parseStyleDictionaryV3 } from "./style-dictionary-v3.js";
+import { parseJsonFlat, parseJsonNested } from "./json.js";
+/**
+ * Parse a payload using the given format. When format is 'auto', sniffs the
+ * payload to pick the right parser.
+ */
+export function parse(format, input) {
+    const resolved = format === "auto" ? detectFormat(input) : format;
+    switch (resolved) {
+        case "dtcg":
+            return parseDtcg(input);
+        case "tokens-studio":
+            return parseTokensStudio(input);
+        case "css-vars":
+            return parseCssVars(input);
+        case "tailwind-v4":
+            return parseTailwindV4(input);
+        case "tailwind-v3-config":
+            return parseTailwindV3Config(input);
+        case "scss":
+            return parseScss(input);
+        case "style-dictionary-v3":
+            return parseStyleDictionaryV3(input);
+        case "json-flat":
+            return parseJsonFlat(input);
+        case "json-nested":
+            return parseJsonNested(input);
+        default: {
+            const _exhaustive = resolved;
+            throw new Error(`[figma-console-mcp] Unknown import format: ${_exhaustive}`);
+        }
+    }
+}
+/**
+ * Sniff the payload to determine its format. Order matters — earlier checks
+ * are higher-priority signals.
+ *
+ *  1. JSON content with DTCG markers ($value/$type at any depth)
+ *  2. JSON content with Tokens Studio markers ($themes.json or $metadata)
+ *  3. JSON content with Style Dictionary v3 markers (bare value/type)
+ *  4. Tailwind v4 `@theme` block
+ *  5. CSS custom properties (`:root { --foo: bar; }`)
+ *  6. SCSS variables (`$foo: bar;`)
+ *  7. File extension as a last-resort hint
+ */
+export function detectFormat(input) {
+    const trimmed = input.payload.trim();
+    // JSON-shape sniffing
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (hasDtcgMarkers(parsed))
+                return "dtcg";
+            if (hasTokensStudioMarkers(parsed))
+                return "tokens-studio";
+            if (hasStyleDictionaryV3Markers(parsed))
+                return "style-dictionary-v3";
+            if (looksFlat(parsed))
+                return "json-flat";
+            return "json-nested";
+        }
+        catch {
+            // Not actually JSON — fall through to text sniffing.
+        }
+    }
+    // Tailwind v4: presence of `@theme` directive
+    if (trimmed.includes("@theme"))
+        return "tailwind-v4";
+    // CSS custom properties
+    if (/--[a-z][a-z0-9_-]*\s*:/i.test(trimmed))
+        return "css-vars";
+    // SCSS variables
+    if (/^\s*\$[a-z][a-z0-9_-]*\s*:/im.test(trimmed))
+        return "scss";
+    // File extension fallback
+    if (input.sourcePath) {
+        if (input.sourcePath.endsWith(".css"))
+            return "css-vars";
+        if (input.sourcePath.endsWith(".scss"))
+            return "scss";
+        if (input.sourcePath.endsWith(".json"))
+            return "json-nested";
+    }
+    throw new Error(`[figma-console-mcp] Unable to auto-detect format for ${input.sourcePath ?? "payload"}. Pass an explicit format to figma_import_tokens.`);
+}
+function hasDtcgMarkers(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    for (const key of Object.keys(obj)) {
+        const val = obj[key];
+        if (key === "$value" || key === "$type")
+            return true;
+        if (val && typeof val === "object" && hasDtcgMarkers(val))
+            return true;
+    }
+    return false;
+}
+function hasTokensStudioMarkers(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    const top = obj;
+    // Tokens Studio's signature: presence of $themes or $metadata at the root,
+    // or selectedTokenSets nested inside the document.
+    return ("$themes" in top ||
+        "$metadata" in top ||
+        JSON.stringify(top).includes("selectedTokenSets"));
+}
+function hasStyleDictionaryV3Markers(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    // SD v3 uses bare "value" and "type" fields (no $ prefix) on leaf nodes.
+    for (const val of Object.values(obj)) {
+        if (val && typeof val === "object") {
+            const inner = val;
+            if ("value" in inner && ("type" in inner || typeof inner.value !== "object")) {
+                return true;
+            }
+            if (hasStyleDictionaryV3Markers(val))
+                return true;
+        }
+    }
+    return false;
+}
+function looksFlat(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    return Object.values(obj).every((v) => typeof v !== "object" || v === null);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseJsonFlat(_input: ParseInput): ParseResult;
+export declare function parseJsonNested(_input: ParseInput): ParseResult;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAE7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAE/D"}

package/dist/core/tokens/parsers/json.js

@@ -0,0 +1,8 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseJsonFlat(_input) {
+    throw new TokenFormatNotImplementedError("flat JSON", "parser");
+}
+export function parseJsonNested(_input) {
+    throw new TokenFormatNotImplementedError("nested JSON", "parser");
+}
+//# sourceMappingURL=json.js.map

package/dist/core/tokens/parsers/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,MAAM,IAAI,8BAA8B,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,MAAM,IAAI,8BAA8B,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/tokens/parsers/scss.d.ts

@@ -0,0 +1,3 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseScss(_input: ParseInput): ParseResult;
+//# sourceMappingURL=scss.d.ts.map

package/dist/core/tokens/parsers/scss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scss.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/scss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAEzD"}

package/dist/core/tokens/parsers/scss.js

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseScss(_input) {
+    throw new TokenFormatNotImplementedError("SCSS variables", "parser");
+}
+//# sourceMappingURL=scss.js.map

package/dist/core/tokens/parsers/scss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scss.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/scss.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,MAAM,IAAI,8BAA8B,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC"}

package/dist/core/tokens/parsers/stubs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared NotImplementedError for parsers/formatters that are scaffolded but
+ * not yet implemented. DTCG round-trip is the canonical fully-implemented
+ * path; CSS variables is also fully implemented as a formatter output.
+ * Everything else returns a helpful error pointing the user at the canonical
+ * format.
+ */
+export declare class TokenFormatNotImplementedError extends Error {
+    constructor(formatName: string, kind: "parser" | "formatter");
+}
+//# sourceMappingURL=stubs.d.ts.map

package/dist/core/tokens/parsers/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,WAAW;CAM7D"}

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

@@ -0,0 +1,14 @@
+/**
+ * Shared NotImplementedError for parsers/formatters that are scaffolded but
+ * not yet implemented. DTCG round-trip is the canonical fully-implemented
+ * path; CSS variables is also fully implemented as a formatter output.
+ * Everything else returns a helpful error pointing the user at the canonical
+ * format.
+ */
+export class TokenFormatNotImplementedError extends Error {
+    constructor(formatName, kind) {
+        super(`[figma-console-mcp] The ${formatName} ${kind} is scaffolded but not yet implemented. Fully implemented: DTCG JSON (parser + formatter) and CSS custom properties (formatter only). For now, export to 'dtcg' as the canonical format and either consume the JSON directly or convert downstream — or open an issue with your use case to prioritize this format.`);
+        this.name = "TokenFormatNotImplementedError";
+    }
+}
+//# sourceMappingURL=stubs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAAY,UAAkB,EAAE,IAA4B;QAC1D,KAAK,CACH,2BAA2B,UAAU,IAAI,IAAI,qTAAqT,CACnW,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseStyleDictionaryV3(_input: ParseInput): ParseResult;
+//# sourceMappingURL=style-dictionary-v3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style-dictionary-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/style-dictionary-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAEtE"}

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

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseStyleDictionaryV3(_input) {
+    throw new TokenFormatNotImplementedError("Style Dictionary v3", "parser");
+}
+//# sourceMappingURL=style-dictionary-v3.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style-dictionary-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/style-dictionary-v3.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CAAC,MAAkB;IACvD,MAAM,IAAI,8BAA8B,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseTailwindV3Config(_input: ParseInput): ParseResult;
+//# sourceMappingURL=tailwind-v3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-v3.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tailwind-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAErE"}

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

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseTailwindV3Config(_input) {
+    throw new TokenFormatNotImplementedError("Tailwind v3 config", "parser");
+}
+//# sourceMappingURL=tailwind-v3.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-v3.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tailwind-v3.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,MAAM,IAAI,8BAA8B,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseTailwindV4(_input: ParseInput): ParseResult;
+//# sourceMappingURL=tailwind-v4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-v4.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tailwind-v4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAE/D"}

package/dist/core/tokens/parsers/tailwind-v4.js

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseTailwindV4(_input) {
+    throw new TokenFormatNotImplementedError("Tailwind v4 @theme", "parser");
+}
+//# sourceMappingURL=tailwind-v4.js.map

package/dist/core/tokens/parsers/tailwind-v4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-v4.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tailwind-v4.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,MAAM,IAAI,8BAA8B,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC"}

package/dist/core/tokens/parsers/tokens-studio.d.ts

@@ -0,0 +1,3 @@
+import type { ParseInput, ParseResult } from "./index.js";
+export declare function parseTokensStudio(_input: ParseInput): ParseResult;
+//# sourceMappingURL=tokens-studio.d.ts.map

package/dist/core/tokens/parsers/tokens-studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens-studio.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tokens-studio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAEjE"}

package/dist/core/tokens/parsers/tokens-studio.js

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseTokensStudio(_input) {
+    throw new TokenFormatNotImplementedError("Tokens Studio", "parser");
+}
+//# sourceMappingURL=tokens-studio.js.map

package/dist/core/tokens/parsers/tokens-studio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens-studio.js","sourceRoot":"","sources":["../../../../src/core/tokens/parsers/tokens-studio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,IAAI,8BAA8B,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AACtE,CAAC"}