@mp3wizard/figma-console-mcp 1.23.1 → 1.27.2

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

@@ -0,0 +1,152 @@
+/**
+ * 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>;
+    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;
+    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;
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ElC,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"}

package/dist/core/tokens/schemas.js

@@ -0,0 +1,149 @@
+/**
+ * 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 const ExportFormatSchema = z.enum([
+    "dtcg",
+    "tokens-studio",
+    "css-vars",
+    "tailwind-v4",
+    "tailwind-v3",
+    "scss",
+    "less",
+    "ts-module",
+    "json-flat",
+    "json-nested",
+    "style-dictionary-v3",
+]);
+export const ImportFormatSchema = z.enum([
+    "auto",
+    "dtcg",
+    "tokens-studio",
+    "css-vars",
+    "tailwind-v4",
+    "tailwind-v3-config",
+    "scss",
+    "style-dictionary-v3",
+    "json-flat",
+    "json-nested",
+]);
+export const SyncStrategySchema = z.enum(["merge", "replace", "dry-run"]);
+export const ConflictResolutionSchema = z.enum([
+    "ask",
+    "figma-wins",
+    "code-wins",
+    "skip",
+]);
+const ColorFormatSchema = z.enum(["hex", "hex8", "rgba", "oklch", "hsl"]);
+const SizeUnitSchema = z.enum(["px", "rem", "pt", "dp"]);
+/**
+ * Schema for figma_export_tokens. Most fields are optional — the typical call
+ * is zero-arg, picking everything up from `tokens.config.json` autodiscovery.
+ */
+export const ExportTokensInputSchema = z.object({
+    scope: z
+        .enum(["file", "collection"])
+        .optional()
+        .describe("Whether to export the entire file's variables ('file', default) or just specific collections via collectionIds."),
+    collectionIds: z
+        .array(z.string())
+        .optional()
+        .describe("Specific Figma collection IDs to export. Required when scope is 'collection'. Use figma_get_variables to enumerate available collections."),
+    modes: z
+        .union([z.array(z.string()), z.literal("all")])
+        .optional()
+        .describe("Modes to include in the output. 'all' (default) exports every mode in every collection. Pass an array like ['Light', 'Dark'] to filter."),
+    format: ExportFormatSchema.optional().describe("Specific output format to emit. When omitted, formats come from tokens.config.json's generated.formats list. Common starting choices: 'dtcg' for the canonical JSON, 'css-vars' for runtime CSS custom properties, 'tailwind-v4' for Tailwind v4 @theme blocks."),
+    outputPath: z
+        .string()
+        .optional()
+        .describe("Filesystem path to write the output file(s) to. Relative paths resolve against the project root (the directory containing tokens.config.json) or cwd if no config. When omitted, the output is returned inline in the response (suitable for the AI to inspect or write via its own file tools)."),
+    configPath: z
+        .string()
+        .optional()
+        .describe("Explicit path to a tokens.config.json file. When omitted, the tool walks up from cwd looking for one — typical case is zero-arg."),
+    strategy: SyncStrategySchema.optional().describe("How to handle existing output files. 'merge' (default) diffs against current contents and writes only changed tokens, preserving code-only additions. 'replace' wipes and rewrites. 'dry-run' computes the diff and reports what would change without writing."),
+    prefix: z
+        .string()
+        .optional()
+        .describe("Prefix prepended to every output token name (e.g. 'ds-', 'al-'). Only affects formatters that emit named tokens — DTCG and JSON outputs use unmodified paths."),
+    resolveAliases: z
+        .boolean()
+        .optional()
+        .describe("If true, alias references are resolved to literal values in the output. Default is false for JSON formats (preserves alias semantics) and true for CSS/SCSS/Tailwind/etc. (which can't natively express aliases)."),
+    splitByMode: z
+        .boolean()
+        .optional()
+        .describe("Emit one file per mode (e.g. tokens-light.css, tokens-dark.css). Default false (single file with all modes)."),
+    splitByCollection: z
+        .boolean()
+        .optional()
+        .describe("Emit one file per Figma collection. Default false. Useful when collections map to different runtime themes."),
+    colorFormat: ColorFormatSchema.optional().describe("Color value format in the output. Default: 'hex'. Use 'oklch' for modern Tailwind v4 charts."),
+    sizeUnit: SizeUnitSchema.optional().describe("Unit for dimension tokens. Default: 'rem' for web outputs, 'pt' for iOS, 'dp' for Android."),
+    remBase: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Base font size in pixels for px→rem conversion. Default: 16."),
+});
+/**
+ * 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 const ImportTokensInputSchema = z
+    .object({
+    format: ImportFormatSchema.optional().describe("Format of the input payload. 'auto' (default) detects from payload shape or file extension. Pass an explicit format if auto-detection misfires."),
+    payload: z
+        .string()
+        .optional()
+        .describe("Single-file content to import. Use this for one-shot imports without setting up tokens.config.json. Mutually exclusive with `files` and `configPath`."),
+    files: z
+        .array(z.object({
+        path: z.string().describe("Relative or absolute filesystem path."),
+        content: z.string().describe("File contents."),
+    }))
+        .optional()
+        .describe("Multi-file import (used for Tokens Studio's split-set format, or for projects with many DTCG source files). Mutually exclusive with `payload` and `configPath`."),
+    configPath: z
+        .string()
+        .optional()
+        .describe("Explicit path to tokens.config.json. When omitted, the tool autodiscovers and uses the config's source.dir to find files. Mutually exclusive with `payload` and `files`."),
+    strategy: SyncStrategySchema.optional().describe("How to apply changes. 'merge' (default) diffs against current Figma state and applies only deltas, preserving Figma-only variables. 'replace' wipes the target collections and rewrites. 'dry-run' computes the diff and reports without touching Figma."),
+    collectionMapping: z
+        .record(z.string())
+        .optional()
+        .describe("Map input token set names to Figma collection names. Example: {'primitives': 'Primitive Tokens'}. When omitted, set names map 1:1 to collection names."),
+    modeMapping: z
+        .record(z.string())
+        .optional()
+        .describe("Map input mode names to Figma mode names. Useful when source uses 'light'/'dark' and Figma uses 'Light'/'Dark'. Defaults to 1:1 mapping with case preservation."),
+    prefix: z
+        .string()
+        .optional()
+        .describe("Prefix to strip from input token names on import. E.g. with prefix 'ds-', a token named '--ds-color-primary' becomes 'color/primary'."),
+    onConflict: ConflictResolutionSchema.optional().describe("How to resolve true two-sided conflicts (both Figma and code changed the same token since last sync). 'ask' (default) surfaces the conflict and writes nothing. 'figma-wins' / 'code-wins' apply the corresponding side. 'skip' leaves conflicted tokens alone but proceeds with the rest."),
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe("Shorthand for strategy: 'dry-run'. Computes the diff and returns a preview without applying any changes to Figma."),
+})
+    .refine((data) => {
+    // Exactly one of payload / files / configPath should be set (or none,
+    // which triggers tokens.config.json autodiscovery).
+    const sources = [data.payload, data.files, data.configPath].filter((x) => x !== undefined);
+    return sources.length <= 1;
+}, {
+    message: "Pass at most one of: payload, files, configPath. (Or none, to autodiscover tokens.config.json.)",
+});
+//# sourceMappingURL=schemas.js.map

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

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

package/dist/core/tokens/transforms/color.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Color value transforms. Convert between hex, hex8 (with alpha), rgba, oklch,
+ * and hsl representations. Stub — DTCG and CSS-vars output preserve source
+ * values; format-specific transforms will land alongside the Tailwind v4 /
+ * SCSS formatters.
+ */
+import type { Transform } from "./index.js";
+export declare const colorToFormat: Transform;
+//# sourceMappingURL=color.d.ts.map

package/dist/core/tokens/transforms/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,aAAa,EAAE,SAS3B,CAAC"}

package/dist/core/tokens/transforms/color.js

@@ -0,0 +1,13 @@
+/**
+ * Color value transforms. Convert between hex, hex8 (with alpha), rgba, oklch,
+ * and hsl representations. Stub — DTCG and CSS-vars output preserve source
+ * values; format-specific transforms will land alongside the Tailwind v4 /
+ * SCSS formatters.
+ */
+export const colorToFormat = (value, _token, _opts) => {
+    // Pass through. The DTCG and CSS-vars formatters don't need transforms —
+    // they preserve / format source values inline. Hex↔oklch↔rgba etc. will be
+    // implemented when format-specific output requires conversion.
+    return value;
+};
+//# sourceMappingURL=color.js.map

package/dist/core/tokens/transforms/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,aAAa,GAAc,CACtC,KAAiB,EACjB,MAAa,EACb,KAAuB,EACvB,EAAE;IACF,yEAAyE;IACzE,2EAA2E;IAC3E,+DAA+D;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Token-value transforms. Each transform is a pure function that takes a
+ * TokenValue (and an options bag) and returns a transformed TokenValue.
+ *
+ * Transforms are composable — formatters call them in a pipeline appropriate
+ * for the output format (e.g. CSS variables need px→rem and string color
+ * normalization; DTCG output skips transforms entirely since it preserves the
+ * source representation).
+ *
+ * Currently ships stubs that pass values through unchanged. The DTCG and
+ * CSS variables formatters don't need transforms because they handle their
+ * own value formatting inline. Transforms will be implemented when the
+ * Tailwind v4 / SCSS / TS module formatters land.
+ */
+import type { Token, TokenValue } from "../types.js";
+export interface TransformOptions {
+    /** Desired color output format. Defaults to "hex". */
+    colorFormat?: "hex" | "hex8" | "rgba" | "oklch" | "hsl";
+    /** Desired dimension unit. Defaults to "rem" for web. */
+    sizeUnit?: "px" | "rem" | "pt" | "dp";
+    /** Base font size for px↔rem conversion. Defaults to 16. */
+    remBase?: number;
+}
+export interface Transform {
+    /**
+     * Apply the transform to a single token value. Returns a new value
+     * (transforms are pure).
+     */
+    (value: TokenValue, token: Token, opts: TransformOptions): TokenValue;
+}
+/**
+ * Run a pipeline of transforms on a token's value(s). Iterates every mode
+ * and applies each transform in order.
+ */
+export declare function runTransforms(token: Token, transforms: Transform[], opts: TransformOptions): Token;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACxD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAAC;CACvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,SAAS,EAAE,EACvB,IAAI,EAAE,gBAAgB,GACrB,KAAK,CAUP"}

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

@@ -0,0 +1,30 @@
+/**
+ * Token-value transforms. Each transform is a pure function that takes a
+ * TokenValue (and an options bag) and returns a transformed TokenValue.
+ *
+ * Transforms are composable — formatters call them in a pipeline appropriate
+ * for the output format (e.g. CSS variables need px→rem and string color
+ * normalization; DTCG output skips transforms entirely since it preserves the
+ * source representation).
+ *
+ * Currently ships stubs that pass values through unchanged. The DTCG and
+ * CSS variables formatters don't need transforms because they handle their
+ * own value formatting inline. Transforms will be implemented when the
+ * Tailwind v4 / SCSS / TS module formatters land.
+ */
+/**
+ * Run a pipeline of transforms on a token's value(s). Iterates every mode
+ * and applies each transform in order.
+ */
+export function runTransforms(token, transforms, opts) {
+    const newValues = {};
+    for (const [mode, value] of Object.entries(token.values)) {
+        let result = value;
+        for (const transform of transforms) {
+            result = transform(result, token, opts);
+        }
+        newValues[mode] = result;
+    }
+    return { ...token, values: newValues };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAY,EACZ,UAAuB,EACvB,IAAsB;IAEtB,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACzC,CAAC"}

package/dist/core/tokens/transforms/size.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dimension/size value transforms. Convert px ↔ rem ↔ pt ↔ dp. Stub —
+ * to be implemented when Tailwind v4 / SCSS / TS formatters ship.
+ */
+import type { Transform } from "./index.js";
+export declare const sizeToUnit: Transform;
+//# sourceMappingURL=size.d.ts.map

package/dist/core/tokens/transforms/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/size.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,UAAU,EAAE,SAMxB,CAAC"}

package/dist/core/tokens/transforms/size.js

@@ -0,0 +1,8 @@
+/**
+ * Dimension/size value transforms. Convert px ↔ rem ↔ pt ↔ dp. Stub —
+ * to be implemented when Tailwind v4 / SCSS / TS formatters ship.
+ */
+export const sizeToUnit = (value, _token, _opts) => {
+    return value;
+};
+//# sourceMappingURL=size.js.map

package/dist/core/tokens/transforms/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../../../src/core/tokens/transforms/size.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,CAAC,MAAM,UAAU,GAAc,CACnC,KAAiB,EACjB,MAAa,EACb,KAAuB,EACvB,EAAE;IACF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}