@obra-studio/figma-console-mcp 1.32.0

package/dist/core/tokens/formatters/ts-module.d.ts

@@ -0,0 +1,35 @@
+/**
+ * TypeScript module formatter.
+ *
+ * Output shape:
+ *
+ *   // tokens.ts
+ *   export const tokens = {
+ *     color: {
+ *       primary: "#4085F2",
+ *       brand: { primary: "#FF00AA" }
+ *     },
+ *     spacing: {
+ *       md: "16px"
+ *     }
+ *   } as const;
+ *
+ *   export type Tokens = typeof tokens;
+ *
+ * Multi-mode tokens emit as nested objects keyed by mode name:
+ *
+ *   export const tokens = {
+ *     mode: {
+ *       primary: { Light: "#FFFFFF", Dark: "#000000" }
+ *     }
+ *   } as const;
+ *
+ * Aliases get resolved at write time to the literal value (TypeScript
+ * can't natively express references). Cross-library aliases get emitted
+ * as `null` with a "TODO: cross-library alias unresolved" comment so
+ * consumers see the gap.
+ */
+import type { TokenDocument } from "../types.js";
+import type { FormatOptions, FormatResult } from "./index.js";
+export declare function formatTsModule(doc: TokenDocument, opts: FormatOptions): FormatResult;
+//# sourceMappingURL=ts-module.d.ts.map

package/dist/core/tokens/formatters/ts-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-module.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/ts-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAwB,MAAM,aAAa,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CA+Bd"}

package/dist/core/tokens/formatters/ts-module.js

@@ -0,0 +1,199 @@
+/**
+ * TypeScript module formatter.
+ *
+ * Output shape:
+ *
+ *   // tokens.ts
+ *   export const tokens = {
+ *     color: {
+ *       primary: "#4085F2",
+ *       brand: { primary: "#FF00AA" }
+ *     },
+ *     spacing: {
+ *       md: "16px"
+ *     }
+ *   } as const;
+ *
+ *   export type Tokens = typeof tokens;
+ *
+ * Multi-mode tokens emit as nested objects keyed by mode name:
+ *
+ *   export const tokens = {
+ *     mode: {
+ *       primary: { Light: "#FFFFFF", Dark: "#000000" }
+ *     }
+ *   } as const;
+ *
+ * Aliases get resolved at write time to the literal value (TypeScript
+ * can't natively express references). Cross-library aliases get emitted
+ * as `null` with a "TODO: cross-library alias unresolved" comment so
+ * consumers see the gap.
+ */
+import { buildTokenIndex, resolveAliasChain } from "../alias-resolver.js";
+export function formatTsModule(doc, opts) {
+    const warnings = [];
+    const files = [];
+    const splitByCollection = opts.target.splitByCollection ?? false;
+    // splitByMode doesn't make conceptual sense for a TypeScript module
+    // (the value is held in-memory at runtime, not selected by CSS cascade).
+    // TypeScript modules can't natively express alias references — runtime
+    // code reading tokens.color.X gets a string at runtime, no resolution
+    // logic. Build a document-wide token index so aliases resolve to their
+    // literal target at export time. The index spans every set even when
+    // splitByCollection writes single-set files, because aliases often
+    // cross set boundaries (semantic → primitives).
+    const tokenIndex = buildTokenIndex(doc);
+    if (splitByCollection) {
+        for (const set of doc.sets) {
+            files.push({
+                path: filenameFor(opts, set),
+                content: renderTsFile([set], opts, tokenIndex, warnings),
+            });
+        }
+    }
+    else {
+        files.push({
+            path: filenameFor(opts),
+            content: renderTsFile(doc.sets, opts, tokenIndex, warnings),
+        });
+    }
+    return { files, warnings };
+}
+function filenameFor(opts, set) {
+    if (opts.target.filename)
+        return opts.target.filename;
+    if (set)
+        return `${slugify(set.name)}.tokens.ts`;
+    return "tokens.ts";
+}
+function slugify(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Convert a path segment to a valid JS identifier or quoted-key form.
+ * Numeric leading chars, hyphens, etc. → quoted string key.
+ */
+function jsKey(segment) {
+    if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(segment))
+        return segment;
+    return JSON.stringify(segment);
+}
+function renderTsFile(sets, opts, tokenIndex, warnings) {
+    const prefix = opts.target.prefix ?? "";
+    const lines = [];
+    lines.push("/**");
+    lines.push(" * Generated by figma-console-mcp — do not edit by hand.");
+    lines.push(" * Regenerate with: figma_export_tokens (or your npm tokens:export script)");
+    lines.push(" */");
+    lines.push("");
+    const constName = prefix
+        ? `${prefix.replace(/-+$/, "").replace(/-(\w)/g, (_, c) => c.toUpperCase())}Tokens`
+        : "tokens";
+    // Build the nested object structure by walking each set's tokens.
+    const tree = {};
+    for (const set of sets) {
+        for (const token of set.tokens) {
+            writeTokenIntoTree(tree, token, set, tokenIndex, warnings);
+        }
+    }
+    lines.push(`export const ${constName} = ${renderTree(tree, 0)} as const;`);
+    lines.push("");
+    lines.push(`export type ${constName[0].toUpperCase()}${constName.slice(1)} = typeof ${constName};`);
+    lines.push("");
+    return lines.join("\n");
+}
+function writeTokenIntoTree(tree, token, set, tokenIndex, warnings) {
+    let cursor = tree;
+    for (let i = 0; i < token.path.length - 1; i++) {
+        const segment = token.path[i];
+        let next = cursor[segment];
+        if (!next || isLeaf(next)) {
+            next = {};
+            cursor[segment] = next;
+        }
+        cursor = next;
+    }
+    const leafKey = token.path[token.path.length - 1];
+    const isMulti = set.modes.length > 1;
+    const resolvedValues = {};
+    for (const [modeName, value] of Object.entries(token.values)) {
+        let effective = value;
+        if (value.reference) {
+            effective = resolveAliasChain(value, modeName, tokenIndex);
+            if (!effective) {
+                const bare = value.reference.replace(/^\{|\}$/g, "");
+                const reason = bare.startsWith("__library:") || bare === "unknown"
+                    ? "cross-library alias"
+                    : "alias target not found";
+                warnings.push(`Skipped ${token.path.join(".")} (mode "${modeName}") in TS module — ${reason}: ${value.reference}.`);
+                resolvedValues[modeName] = null;
+                continue;
+            }
+        }
+        if (!effective || effective.literal === undefined || effective.literal === null)
+            continue;
+        resolvedValues[modeName] = formatLiteral(effective.literal, token.type);
+    }
+    cursor[leafKey] = {
+        __leaf: true,
+        values: resolvedValues,
+        type: token.type,
+        isMultiMode: isMulti,
+        description: token.description,
+    };
+}
+function isLeaf(node) {
+    return node.__leaf === true;
+}
+function renderTree(tree, indent) {
+    const ind = "  ".repeat(indent);
+    const innerInd = "  ".repeat(indent + 1);
+    const entries = [];
+    for (const [key, value] of Object.entries(tree)) {
+        const k = jsKey(key);
+        if (isLeaf(value)) {
+            const leaf = value;
+            if (leaf.isMultiMode) {
+                // Emit as { Mode: value } object
+                const modeEntries = [];
+                for (const [m, v] of Object.entries(leaf.values)) {
+                    modeEntries.push(`${jsKey(m)}: ${renderValue(v)}`);
+                }
+                entries.push(`${innerInd}${k}: { ${modeEntries.join(", ")} }`);
+            }
+            else {
+                // Single-mode: emit value directly
+                const onlyValue = Object.values(leaf.values)[0];
+                entries.push(`${innerInd}${k}: ${renderValue(onlyValue)}`);
+            }
+        }
+        else {
+            entries.push(`${innerInd}${k}: ${renderTree(value, indent + 1)}`);
+        }
+    }
+    if (entries.length === 0)
+        return "{}";
+    return `{\n${entries.join(",\n")},\n${ind}}`;
+}
+function renderValue(v) {
+    if (v === null)
+        return "null /* TODO: cross-library alias unresolved */";
+    if (typeof v === "string")
+        return JSON.stringify(v);
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    return JSON.stringify(v);
+}
+function formatLiteral(value, type) {
+    if (typeof value === "number") {
+        if (type === "dimension")
+            return `${value}px`;
+        return value;
+    }
+    return value;
+}
+//# sourceMappingURL=ts-module.js.map

package/dist/core/tokens/formatters/ts-module.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Public surface of the token sync engine.
+ *
+ * Re-exports the canonical types, the parser/formatter dispatchers, the
+ * config loader, the alias resolver, and the Figma converter. External
+ * callers (tools, tests) should import from here rather than reaching into
+ * subdirectories.
+ */
+export type { Token, TokenDocument, TokenSet, TokenType, TokenValue, TokenDiff, FigmaMcpExtensions, SyncStrategy, ConflictResolution, ExportFormat, ImportFormat, TypographyValue, ShadowValue, GradientValue, GradientStop, BorderValue, TransitionValue, } from "./types.js";
+export { FIGMA_MCP_EXTENSION_KEY } from "./types.js";
+export { TokensConfigSchema, type TokensConfig, type OutputTarget, type LoadedTokensConfig, loadTokensConfig, findTokensConfig, DEFAULT_TOKENS_CONFIG, buildSuggestedScaffold, resolveOutputTargets, resolveConflictStrategy, } from "./config.js";
+export { ExportTokensInputSchema, ImportTokensInputSchema, ExportFormatSchema, ImportFormatSchema, SyncStrategySchema, ConflictResolutionSchema, type ExportTokensInput, type ImportTokensInput, } from "./schemas.js";
+export { parse, detectFormat, type ParseInput, type ParseResult, } from "./parsers/index.js";
+export { format, type FormatOptions, type FormatResult, } from "./formatters/index.js";
+export { buildTokenIndex, resolveReference, resolveAliasChain, validateAliases, formatDtcgReference, parseDtcgReference, } from "./alias-resolver.js";
+export { convertFigmaVariablesToDocument, type FigmaVariablesPayload, type ConvertOptions, type ConvertResult, } from "./figma-converter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,KAAK,EACL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/core/tokens/index.js

@@ -0,0 +1,16 @@
+/**
+ * Public surface of the token sync engine.
+ *
+ * Re-exports the canonical types, the parser/formatter dispatchers, the
+ * config loader, the alias resolver, and the Figma converter. External
+ * callers (tools, tests) should import from here rather than reaching into
+ * subdirectories.
+ */
+export { FIGMA_MCP_EXTENSION_KEY } from "./types.js";
+export { TokensConfigSchema, loadTokensConfig, findTokensConfig, DEFAULT_TOKENS_CONFIG, buildSuggestedScaffold, resolveOutputTargets, resolveConflictStrategy, } from "./config.js";
+export { ExportTokensInputSchema, ImportTokensInputSchema, ExportFormatSchema, ImportFormatSchema, SyncStrategySchema, ConflictResolutionSchema, } from "./schemas.js";
+export { parse, detectFormat, } from "./parsers/index.js";
+export { format, } from "./formatters/index.js";
+export { buildTokenIndex, resolveReference, resolveAliasChain, validateAliases, formatDtcgReference, parseDtcgReference, } from "./alias-resolver.js";
+export { convertFigmaVariablesToDocument, } from "./figma-converter.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EACL,kBAAkB,EAIlB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,MAAM,GAGP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,+BAA+B,GAIhC,MAAM,sBAAsB,CAAC"}

package/dist/core/tokens/parsers/css-vars.d.ts

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

package/dist/core/tokens/parsers/css-vars.d.ts.map

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

package/dist/core/tokens/parsers/css-vars.js

@@ -0,0 +1,5 @@
+import { TokenFormatNotImplementedError } from "./stubs.js";
+export function parseCssVars(_input) {
+    throw new TokenFormatNotImplementedError("CSS custom properties", "parser");
+}
+//# sourceMappingURL=css-vars.js.map

package/dist/core/tokens/parsers/css-vars.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * 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 type { ParseInput, ParseResult } from "./index.js";
+export declare function parseDtcg(input: ParseInput): ParseResult;
+//# sourceMappingURL=dtcg.d.ts.map

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

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

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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU1D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAY;IACpC,OAAO;IACP,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,KAAiB;IACzC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAE9B,oEAAoE;IACpE,0EAA0E;IAC1E,yEAAyE;IACzE,oDAAoD;IACpD,MAAM,IAAI,GAA0B,EAAE,CAAC;IACvC,IAAI,QAA4B,CAAC;IACjC,MAAM,OAAO,GAAI,IAAkB,CAAC,WAAW,CAAC;IAChD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;QAC1C,MAAM,OAAO,GAAI,OAAmC,CAAC,uBAAuB,CAAC,CAAC;QAC9E,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YAC1C,MAAM,CAAC,GAAG,OAAkC,CAAC;YAC7C,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;gBAAE,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;YAC3E,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;gBAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;YACrE,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;gBAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;YACrE,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBAAE,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;SAC3D;KACF;IAED,qEAAqE;IACrE,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAiB,CAAC,EAAE;QACjE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,mBAAmB;QACzD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YAC3C,QAAQ,CAAC,IAAI,CACX,oBAAoB,MAAM,8CAA8C,CACzE,CAAC;YACF,SAAS;SACV;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAoB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;KACzE;IAED,OAAO;QACL,QAAQ,EAAE;YACR,OAAO,EACL,uEAAuE;YACzE,IAAI;YACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACtD;QACD,cAAc,EAAE,MAAM;QACtB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAiB;IAClC,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;KAClC;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,IAAI,KAAK,CACb,gDACE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EACjD,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxD,CAAC;KACH;AACH,CAAC;AAED,SAAS,UAAU,CACjB,MAAc,EACd,OAAkB,EAClB,QAAkB,EAClB,QAAiB;IAEjB,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,sEAAsE;IACtE,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACnC,IAAI,iBAAqC,CAAC;IAC1C,IAAI,YAAgC,CAAC;IACrC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QACxC,MAAM,GAAG,GAAI,MAAkC,CAAC,uBAAuB,CAAC,CAAC;QACzE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAClC,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,IAAI,OAAO,CAAC,CAAC,iBAAiB,KAAK,QAAQ,EAAE;gBAC3C,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAAC;aACzC;YACD,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,EAAE;gBACtC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;aAC/B;SACF;KACF;IAED,0CAA0C;IAC1C,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,YAAY,IAAI,MAAM;QAC5B,WAAW,EACT,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAC7E,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChD,MAAM;QACN,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,IAAe,EACf,IAAc,EACd,aAAoC,EACpC,MAAe,EACf,KAAkB,EAClB,QAAkB,EAClB,QAAiB;IAEjB,yEAAyE;IACzE,sCAAsC;IACtC,MAAM,SAAS,GACb,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAkB,CAAC;QACvE,CAAC,CAAE,IAAI,CAAC,KAAmB;QAC3B,CAAC,CAAC,aAAa,CAAC;IAEpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YACvC,QAAQ,CAAC,IAAI,CACX,iCAAiC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CACvE,CAAC;YACF,SAAS;SACV;QAED,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,WAAW,CAAC,KAAkB,CAAC,EAAE;YACnC,MAAM,KAAK,GAAG,YAAY,CACxB,SAAS,EACT,KAAgC,EAChC,SAAS,EACT,QAAQ,EACR,QAAQ,CACT,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC/D;aAAM;YACL,SAAS,CACP,KAAkB,EAClB,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,CACT,CAAC;SACH;KACF;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAe;IAClC,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CACnB,IAAc,EACd,IAA6B,EAC7B,aAAoC,EACpC,QAAkB,EAClB,QAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,IAAI,IAAe,CAAC;IACpB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,OAAoB,CAAC,EAAE;QACvE,IAAI,GAAG,OAAoB,CAAC;KAC7B;SAAM,IAAI,aAAa,EAAE;QACxB,IAAI,GAAG,aAAa,CAAC;KACtB;SAAM;QACL,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,yDAAyD,IAAI,IAAI,CACzF,CAAC;KACH;IAED,MAAM,WAAW,GACf,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;IAC7B,MAAM,MAAM,GACV,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAC5B,CAAC,CAAG,GAA+B,CAAC,uBAAuB,CAE3C;QAChB,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,YAAY,GAAG,MAAM,EAAE,KAA4C,CAAC;IAE1E,0DAA0D;IAC1D,uEAAuE;IACvE,oEAAoE;IACpE,+BAA+B;IAC/B,sEAAsE;IACtE,MAAM,WAAW,GAAG,QAAQ,IAAI,SAAS,CAAC;IAC1C,MAAM,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,YAAY,EAAE;QAChB,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;YAChE,mEAAmE;YACnE,IAAI,QAAQ,KAAK,WAAW,EAAE;gBAC5B,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;aAC3C;SACF;KACF;IAED,iDAAiD;IACjD,IAAI,UAA+B,CAAC;IACpC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QAClC,UAAU,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAa,CAAC,EAAE;YAC7D,IACE,MAAM,KAAK,uBAAuB;gBAClC,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ,EAC3B;gBACA,qDAAqD;gBACrD,MAAM,OAAO,GAA4B,EAAE,GAAI,OAAkB,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC,KAAK,CAAC;gBACrB,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;oBAClC,UAAsC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;iBAC3D;aACF;iBAAM;gBACJ,UAAsC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;aAC3D;SACF;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,UAAU,GAAG,SAAS,CAAC;KAClE;IAED,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,QAAiB;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;QAChC,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE;YACX,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;SAChC;QACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;KAC9B;IACD,IACE,QAAQ,KAAK,IAAI;QACjB,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,QAAQ,KAAK,SAAS,EAC7B;QACA,OAAO,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;KACpC;IACD,mEAAmE;IACnE,OAAO,EAAE,OAAO,EAAE,QAAmC,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,QAAiB;IAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;QAChC,6EAA6E;QAC7E,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC;QACvD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC;QACvD,IAAI,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,WAAW,CAAC;QACpE,OAAO,QAAQ,CAAC;KACjB;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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"}