@muloka/figma-console-mcp 0.1.0

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

@@ -0,0 +1,339 @@
+/**
+ * CSS custom properties formatter.
+ *
+ * Converts a TokenDocument to one or more CSS files containing `:root { ... }`
+ * (and optionally per-mode selectors like `.dark { ... }`). The first
+ * "real" non-DTCG output, completing the canonical-to-runtime pipeline.
+ *
+ * Behavior:
+ *   - Each token becomes a CSS custom property. Path joined with `-`,
+ *     optionally prefixed. `color/primary` → `--color-primary`.
+ *   - Aliases resolve to `var(--target-token)` so CSS cascading still works.
+ *   - Composite tokens (typography, shadow) expand into multiple primitive
+ *     custom properties since CSS doesn't natively express composites.
+ *   - Single-mode tokens go in `:root`.
+ *   - Multi-mode tokens emit per-mode selectors. Heuristic: a mode named
+ *     `Light`/`Default` becomes `:root`; `Dark` becomes `.dark` (Tailwind
+ *     convention); other modes become `[data-theme="<name>"]`.
+ *   - splitByMode emits one file per mode with just that mode's values.
+ *   - splitByCollection emits one file per set.
+ */
+import { buildTokenIndex, referenceTargetPath } from "../alias-resolver.js";
+export function formatCssVars(doc, opts) {
+    const warnings = [];
+    const files = [];
+    // Index over the WHOLE document (not per-file subsets) so set-qualified
+    // alias references ({set-slug.path}) resolve to their target token's own
+    // path when generating var(--...) names.
+    const tokenIndex = buildTokenIndex(doc, warnings);
+    const splitByMode = opts.target.splitByMode ?? false;
+    const splitByCollection = opts.target.splitByCollection ?? false;
+    const prefix = opts.target.prefix ?? "";
+    if (splitByMode && splitByCollection) {
+        // One file per (set, mode) pair.
+        for (const set of doc.sets) {
+            for (const mode of set.modes) {
+                files.push({
+                    path: filenameFor(opts, set, mode),
+                    content: renderSingleSelector(doc.sets.filter((s) => s.name === set.name), mode, selectorFor(mode), prefix, tokenIndex, warnings),
+                });
+            }
+        }
+    }
+    else if (splitByMode) {
+        // One file per mode, all sets combined under that mode's selector.
+        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 setsWithMode = doc.sets.filter((s) => s.modes.includes(mode));
+            files.push({
+                path: filenameFor(opts, undefined, mode),
+                content: renderSingleSelector(setsWithMode, mode, selectorFor(mode), prefix, tokenIndex, warnings),
+            });
+        }
+    }
+    else if (splitByCollection) {
+        // One file per set, all modes combined as separate selectors within.
+        for (const set of doc.sets) {
+            files.push({
+                path: filenameFor(opts, set),
+                content: renderMultiSelector([set], prefix, tokenIndex, warnings),
+            });
+        }
+    }
+    else {
+        // Single file with everything.
+        files.push({
+            path: filenameFor(opts),
+            content: renderMultiSelector(doc.sets, prefix, tokenIndex, warnings),
+        });
+    }
+    return { files, warnings };
+}
+function filenameFor(opts, set, mode) {
+    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(".")}.css`;
+}
+function slugify(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Map a mode name to a CSS selector. Conventional defaults that match what
+ * most CSS frameworks expect:
+ *   - Default / Light / Value → `:root` (the document root, runs always)
+ *   - Dark → `.dark` (matches Tailwind's darkMode: "class" config)
+ *   - anything else → `[data-theme="<name>"]` (general escape hatch)
+ */
+function selectorFor(mode) {
+    const lower = mode.toLowerCase();
+    if (lower === "default" || lower === "light" || lower === "value") {
+        return ":root";
+    }
+    if (lower === "dark") {
+        return ".dark";
+    }
+    return `[data-theme="${slugify(mode)}"]`;
+}
+/**
+ * Render all tokens across the given sets under a single selector. Used when
+ * one file holds one mode's worth of vars (splitByMode output).
+ */
+function renderSingleSelector(sets, mode, selector, prefix, tokenIndex, warnings) {
+    const lines = [];
+    lines.push(`/* Generated by figma-console-mcp — do not edit by hand */`);
+    lines.push(`${selector} {`);
+    for (const set of sets) {
+        for (const token of set.tokens) {
+            const value = token.values[mode];
+            if (!value)
+                continue;
+            emitTokenLines(token, value, prefix, tokenIndex, lines, warnings);
+        }
+    }
+    lines.push(`}`);
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Render multiple sets across multiple modes in one file. Each mode gets its
+ * own selector block.
+ */
+function renderMultiSelector(sets, prefix, tokenIndex, warnings) {
+    const lines = [];
+    lines.push(`/* Generated by figma-console-mcp — do not edit by hand */`);
+    // Collect all (mode, selector) pairs across all sets.
+    const modeToSelector = new Map();
+    for (const set of sets) {
+        for (const mode of set.modes) {
+            if (!modeToSelector.has(mode)) {
+                modeToSelector.set(mode, selectorFor(mode));
+            }
+        }
+    }
+    for (const [mode, selector] of modeToSelector) {
+        lines.push(`${selector} {`);
+        for (const set of sets) {
+            if (!set.modes.includes(mode))
+                continue;
+            for (const token of set.tokens) {
+                const value = token.values[mode];
+                if (!value)
+                    continue;
+                emitTokenLines(token, value, prefix, tokenIndex, lines, warnings);
+            }
+        }
+        lines.push(`}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Emit one or more CSS custom property declarations for a single token.
+ * Primitives emit one line; composite tokens (typography, shadow) expand
+ * into multiple lines.
+ */
+function emitTokenLines(token, value, prefix, tokenIndex, out, warnings) {
+    // Every path segment must be a valid CSS identifier — slugify each to
+    // normalize spaces, dots, and other special characters that show up in
+    // real Figma variable names (e.g. "tailwind colors/purple/50").
+    const cssName = `--${prefix}${pathToCssName(token.path)}`;
+    if (value.reference) {
+        // Detect the cross-library alias sentinel ({__library:VariableID:...}).
+        // Emitting var() for these produces broken CSS — the target doesn't
+        // live in this file's variable set. Emit a clear comment that names
+        // the original library variable ID instead, so the user can decide
+        // how to handle it (manual literal, library import, etc.).
+        const bareRef = value.reference.replace(/^\{|\}$/g, "");
+        const libMatch = bareRef.match(/^__library:(.+)$/);
+        if (libMatch || bareRef === "unknown") {
+            const originalId = libMatch ? libMatch[1] : "unknown";
+            warnings.push(`Skipped ${token.path.join(".")} in CSS — references cross-library variable ${originalId}.`);
+            out.push(`  /* ${cssName}: skipped — cross-library alias to ${originalId} */`);
+            return;
+        }
+        // Alias → var(--other) so CSS cascading semantics are preserved.
+        // Resolve set-qualified references ({set-slug.path}) to the target
+        // token's own path via the index (the target's declaration is named
+        // from its path, without the set qualifier); bare/unresolvable refs
+        // fall back to the raw reference path. Either way the segments go
+        // through the same slugify treatment as the source.
+        const refPath = referenceTargetPath(value.reference, tokenIndex);
+        const targetCssName = pathToCssName(refPath);
+        out.push(`  ${cssName}: var(--${prefix}${targetCssName});`);
+        return;
+    }
+    if (value.literal === undefined || value.literal === null) {
+        warnings.push(`Token ${token.path.join(".")} has no value — emitting nothing.`);
+        return;
+    }
+    // Composite tokens — expand into multiple primitive vars.
+    if (token.type === "typography" && typeof value.literal === "object") {
+        const t = value.literal;
+        for (const subField of ["fontFamily", "fontSize", "fontWeight", "lineHeight", "letterSpacing"]) {
+            if (t[subField] !== undefined) {
+                out.push(`  ${cssName}-${kebab(subField)}: ${formatCssValue(t[subField], token.type)};`);
+            }
+        }
+        return;
+    }
+    if (token.type === "shadow" && typeof value.literal === "object") {
+        const shadowCss = renderShadow(value.literal);
+        if (shadowCss) {
+            out.push(`  ${cssName}: ${shadowCss};`);
+        }
+        else {
+            warnings.push(`Token ${token.path.join(".")} has an unparseable shadow value — skipping.`);
+        }
+        return;
+    }
+    // Primitives.
+    out.push(`  ${cssName}: ${formatCssValue(value.literal, token.type)};`);
+}
+function kebab(s) {
+    return s.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+/**
+ * Convert a path array to a CSS-safe custom property name. Each segment is
+ * slugified (lowercase, non-alphanumerics → hyphens) before joining.
+ *
+ * Examples:
+ *   ["color", "primary"]                  → "color-primary"
+ *   ["tailwind colors", "purple", "50"]   → "tailwind-colors-purple-50"
+ *   ["UI", "background-default"]          → "ui-background-default"
+ */
+function pathToCssName(path) {
+    return path.map((seg) => slugify(seg)).join("-");
+}
+/**
+ * Render a primitive value as a CSS literal.
+ *   - Numbers gain a "px" suffix when the token type is `dimension`.
+ *   - Color-typed strings pass through (hex, oklch, rgba, hsl).
+ *   - fontFamily-typed strings get quoted (multi-word family names are
+ *     invalid CSS otherwise — e.g. "Geist Mono" must be `"Geist Mono"`).
+ *   - Plain string tokens get quoted too, since CSS treats unquoted
+ *     identifiers as keywords. Strings that look like a CSS color or unit
+ *     stay unquoted.
+ *   - Booleans render as their string form.
+ */
+function formatCssValue(value, type) {
+    if (typeof value === "number") {
+        if (type === "dimension")
+            return `${value}px`;
+        return String(value);
+    }
+    if (typeof value === "string") {
+        // Color-typed values are always pre-formatted CSS color literals.
+        if (type === "color")
+            return value;
+        // fontFamily and plain strings need quoting unless they look like a
+        // CSS-safe identifier with no special characters. Quote conservatively
+        // — over-quoting is fine, under-quoting breaks the cascade.
+        if (type === "fontFamily" || type === "string") {
+            return needsQuoting(value) ? JSON.stringify(value) : value;
+        }
+        // Dimensions and other types: pass through (already formatted upstream).
+        return value;
+    }
+    if (typeof value === "boolean")
+        return String(value);
+    return JSON.stringify(value);
+}
+/**
+ * Returns true if a string value needs to be wrapped in CSS quotes. Multi-word
+ * values, values with special characters, or values that aren't pure
+ * alphanumeric identifiers all need quoting.
+ */
+function needsQuoting(s) {
+    // Anything that already has quotes is fine.
+    if (/^["']/.test(s))
+        return false;
+    // Pure-numeric or unit-bearing values don't need quotes (they're not
+    // identifiers).
+    if (/^[\d.]+([a-z%]+)?$/.test(s))
+        return false;
+    // CSS keyword identifiers (single word, alphanumerics + hyphen only).
+    if (/^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(s)) {
+        // Reserved CSS keywords that shouldn't be quoted (the user may have
+        // legitimately written e.g. "inherit", "currentColor", "transparent").
+        const cssKeywords = new Set([
+            "inherit",
+            "initial",
+            "unset",
+            "revert",
+            "currentColor",
+            "transparent",
+            "none",
+            "auto",
+        ]);
+        if (cssKeywords.has(s))
+            return false;
+        // Any other single identifier — for font-family this is OK unquoted
+        // ("Inter" works) but it's safer to quote for clarity. Keep unquoted
+        // to match the more common convention.
+        return false;
+    }
+    // Multi-word, special chars, etc. → quote.
+    return true;
+}
+function renderShadow(shadow) {
+    if (Array.isArray(shadow)) {
+        return shadow
+            .map((s) => renderShadow(s))
+            .filter(Boolean)
+            .join(", ");
+    }
+    if (!shadow || typeof shadow !== "object")
+        return null;
+    const s = shadow;
+    const inset = s.inset ? "inset " : "";
+    const x = withPx(s.offsetX);
+    const y = withPx(s.offsetY);
+    const blur = withPx(s.blur);
+    const spread = s.spread !== undefined ? ` ${withPx(s.spread)}` : "";
+    const color = s.color;
+    if (!x || !y || !blur || typeof color !== "string")
+        return null;
+    return `${inset}${x} ${y} ${blur}${spread} ${color}`;
+}
+function withPx(v) {
+    if (typeof v === "number")
+        return `${v}px`;
+    if (typeof v === "string")
+        return v;
+    return "";
+}
+//# sourceMappingURL=css-vars.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * 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 type { TokenDocument } from "../types.js";
+import type { FormatOptions, FormatResult } from "./index.js";
+export declare function formatDtcg(doc: TokenDocument, opts: FormatOptions): FormatResult;
+//# sourceMappingURL=dtcg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/dtcg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB9D,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,YAAY,CAmEd"}