@muloka/figma-console-mcp 0.1.0

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,15 @@
+/**
+ * Shared NotImplementedError for parser stubs.
+ *
+ * Only DTCG is implemented as a parser today — that's the canonical
+ * round-trip format for `figma_import_tokens`. Other parsers are
+ * scaffolding for potential future import-source support; the way to get
+ * tokens INTO Figma now is via DTCG JSON (you can generate that JSON from
+ * any source with your own tooling). The export side (Figma → code) is
+ * fully covered for all 10 formats — see formatters/stubs.ts for that
+ * surface.
+ */
+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;;;;;;;;;;GAUG;AAEH,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,WAAW;CAQ7D"}

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

@@ -0,0 +1,21 @@
+/**
+ * Shared NotImplementedError for parser stubs.
+ *
+ * Only DTCG is implemented as a parser today — that's the canonical
+ * round-trip format for `figma_import_tokens`. Other parsers are
+ * scaffolding for potential future import-source support; the way to get
+ * tokens INTO Figma now is via DTCG JSON (you can generate that JSON from
+ * any source with your own tooling). The export side (Figma → code) is
+ * fully covered for all 10 formats — see formatters/stubs.ts for that
+ * surface.
+ */
+export class TokenFormatNotImplementedError extends Error {
+    constructor(formatName, kind) {
+        const guidance = kind === "parser"
+            ? `Only the DTCG parser is implemented today. To import tokens into Figma from ${formatName}, convert to DTCG JSON first (or open an issue if you need direct ${formatName} import support).`
+            : `Implemented formatters: dtcg, css-vars, tailwind-v4, tailwind-v3, scss, ts-module, json-flat, json-nested, style-dictionary-v3, tokens-studio. If you need ${formatName}, open an issue with your use case.`;
+        super(`[figma-console-mcp] The ${formatName} ${kind} is not implemented. ${guidance}`);
+        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;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAAY,UAAkB,EAAE,IAA4B;QAC1D,MAAM,QAAQ,GACZ,IAAI,KAAK,QAAQ;YACf,CAAC,CAAC,+EAA+E,UAAU,qEAAqE,UAAU,mBAAmB;YAC7L,CAAC,CAAC,8JAA8J,UAAU,qCAAqC,CAAC;QACpN,KAAK,CAAC,2BAA2B,UAAU,IAAI,IAAI,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QACvF,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"}

package/dist/core/tokens/schemas.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Zod schemas for the figma_export_tokens and figma_import_tokens MCP tools.
+ *
+ * Kept in a dedicated file because they're the AI-facing surface of the token
+ * sync engine — the descriptions matter for prompt comprehension, and they
+ * need to stay in sync with `src/core/tokens/types.ts` (the internal model).
+ */
+import { z } from "zod";
+/**
+ * Output format enum mirrors `ExportFormat` from `./types.ts`. Listed in the
+ * same priority order — DTCG and Tokens Studio first as the canonical JSON
+ * outputs, then CSS-family formats, then code modules, then back-compat.
+ */
+export declare const ExportFormatSchema: z.ZodEnum<["dtcg", "tokens-studio", "css-vars", "tailwind-v4", "tailwind-v3", "scss", "less", "ts-module", "json-flat", "json-nested", "style-dictionary-v3"]>;
+export declare const ImportFormatSchema: z.ZodEnum<["auto", "dtcg", "tokens-studio", "css-vars", "tailwind-v4", "tailwind-v3-config", "scss", "style-dictionary-v3", "json-flat", "json-nested"]>;
+export declare const SyncStrategySchema: z.ZodEnum<["merge", "replace", "dry-run"]>;
+export declare const ConflictResolutionSchema: z.ZodEnum<["ask", "figma-wins", "code-wins", "skip"]>;
+/**
+ * Schema for figma_export_tokens. Most fields are optional — the typical call
+ * is zero-arg, picking everything up from `tokens.config.json` autodiscovery.
+ */
+export declare const ExportTokensInputSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<["file", "collection"]>>;
+    collectionIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    modes: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodLiteral<"all">]>>;
+    format: z.ZodOptional<z.ZodEnum<["dtcg", "tokens-studio", "css-vars", "tailwind-v4", "tailwind-v3", "scss", "less", "ts-module", "json-flat", "json-nested", "style-dictionary-v3"]>>;
+    outputPath: z.ZodOptional<z.ZodString>;
+    configPath: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodOptional<z.ZodEnum<["merge", "replace", "dry-run"]>>;
+    prefix: z.ZodOptional<z.ZodString>;
+    resolveAliases: z.ZodOptional<z.ZodBoolean>;
+    splitByMode: z.ZodOptional<z.ZodBoolean>;
+    splitByCollection: z.ZodOptional<z.ZodBoolean>;
+    dtcgDialect: z.ZodOptional<z.ZodEnum<["legacy", "2025"]>>;
+    colorFormat: z.ZodOptional<z.ZodEnum<["hex", "hex8", "rgba", "oklch", "hsl"]>>;
+    sizeUnit: z.ZodOptional<z.ZodEnum<["px", "rem", "pt", "dp"]>>;
+    remBase: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "tailwind-v3" | "scss" | "less" | "ts-module" | "json-flat" | "json-nested" | "style-dictionary-v3" | undefined;
+    resolveAliases?: boolean | undefined;
+    outputPath?: string | undefined;
+    modes?: string[] | "all" | undefined;
+    prefix?: string | undefined;
+    splitByMode?: boolean | undefined;
+    splitByCollection?: boolean | undefined;
+    dtcgDialect?: "legacy" | "2025" | undefined;
+    colorFormat?: "hex" | "hex8" | "rgba" | "oklch" | "hsl" | undefined;
+    sizeUnit?: "px" | "rem" | "pt" | "dp" | undefined;
+    remBase?: number | undefined;
+    configPath?: string | undefined;
+    scope?: "collection" | "file" | undefined;
+    collectionIds?: string[] | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+}, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "tailwind-v3" | "scss" | "less" | "ts-module" | "json-flat" | "json-nested" | "style-dictionary-v3" | undefined;
+    resolveAliases?: boolean | undefined;
+    outputPath?: string | undefined;
+    modes?: string[] | "all" | undefined;
+    prefix?: string | undefined;
+    splitByMode?: boolean | undefined;
+    splitByCollection?: boolean | undefined;
+    dtcgDialect?: "legacy" | "2025" | undefined;
+    colorFormat?: "hex" | "hex8" | "rgba" | "oklch" | "hsl" | undefined;
+    sizeUnit?: "px" | "rem" | "pt" | "dp" | undefined;
+    remBase?: number | undefined;
+    configPath?: string | undefined;
+    scope?: "collection" | "file" | undefined;
+    collectionIds?: string[] | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+}>;
+export type ExportTokensInput = z.infer<typeof ExportTokensInputSchema>;
+/**
+ * Schema for figma_import_tokens. Mirrors export's shape on the inverse
+ * direction: instead of producing files, this consumes payloads or files and
+ * pushes the diff to Figma.
+ */
+export declare const ImportTokensInputSchema: z.ZodEffects<z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<["auto", "dtcg", "tokens-studio", "css-vars", "tailwind-v4", "tailwind-v3-config", "scss", "style-dictionary-v3", "json-flat", "json-nested"]>>;
+    payload: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        path: string;
+    }, {
+        content: string;
+        path: string;
+    }>, "many">>;
+    configPath: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodOptional<z.ZodEnum<["merge", "replace", "dry-run"]>>;
+    collectionMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    modeMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    prefix: z.ZodOptional<z.ZodString>;
+    onConflict: z.ZodOptional<z.ZodEnum<["ask", "figma-wins", "code-wins", "skip"]>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "scss" | "json-flat" | "json-nested" | "style-dictionary-v3" | "auto" | "tailwind-v3-config" | undefined;
+    payload?: string | undefined;
+    prefix?: string | undefined;
+    configPath?: string | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+    files?: {
+        content: string;
+        path: string;
+    }[] | undefined;
+    collectionMapping?: Record<string, string> | undefined;
+    modeMapping?: Record<string, string> | undefined;
+    onConflict?: "ask" | "figma-wins" | "code-wins" | "skip" | undefined;
+    dryRun?: boolean | undefined;
+}, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "scss" | "json-flat" | "json-nested" | "style-dictionary-v3" | "auto" | "tailwind-v3-config" | undefined;
+    payload?: string | undefined;
+    prefix?: string | undefined;
+    configPath?: string | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+    files?: {
+        content: string;
+        path: string;
+    }[] | undefined;
+    collectionMapping?: Record<string, string> | undefined;
+    modeMapping?: Record<string, string> | undefined;
+    onConflict?: "ask" | "figma-wins" | "code-wins" | "skip" | undefined;
+    dryRun?: boolean | undefined;
+}>, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "scss" | "json-flat" | "json-nested" | "style-dictionary-v3" | "auto" | "tailwind-v3-config" | undefined;
+    payload?: string | undefined;
+    prefix?: string | undefined;
+    configPath?: string | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+    files?: {
+        content: string;
+        path: string;
+    }[] | undefined;
+    collectionMapping?: Record<string, string> | undefined;
+    modeMapping?: Record<string, string> | undefined;
+    onConflict?: "ask" | "figma-wins" | "code-wins" | "skip" | undefined;
+    dryRun?: boolean | undefined;
+}, {
+    format?: "dtcg" | "tokens-studio" | "css-vars" | "tailwind-v4" | "scss" | "json-flat" | "json-nested" | "style-dictionary-v3" | "auto" | "tailwind-v3-config" | undefined;
+    payload?: string | undefined;
+    prefix?: string | undefined;
+    configPath?: string | undefined;
+    strategy?: "replace" | "merge" | "dry-run" | undefined;
+    files?: {
+        content: string;
+        path: string;
+    }[] | undefined;
+    collectionMapping?: Record<string, string> | undefined;
+    modeMapping?: Record<string, string> | undefined;
+    onConflict?: "ask" | "figma-wins" | "code-wins" | "skip" | undefined;
+    dryRun?: boolean | undefined;
+}>;
+export type ImportTokensInput = z.infer<typeof ImportTokensInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/core/tokens/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/core/tokens/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gKAY7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,0JAW7B,CAAC;AAEH,eAAO,MAAM,kBAAkB,4CAA0C,CAAC;AAE1E,eAAO,MAAM,wBAAwB,uDAKnC,CAAC;AAKH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgFlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwEjC,CAAC;AAEJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}