tailwind-styled-v4 5.1.21 → 5.1.23

package/dist/tw.mjs

@@ -998,8 +998,8 @@ var require_command = __commonJS({
     init_esm_shims();
     var EventEmitter = __require("events").EventEmitter;
     var childProcess = __require("child_process");
-    var path32 = __require("path");
-    var fs17 = __require("fs");
+    var path34 = __require("path");
+    var fs19 = __require("fs");
     var process2 = __require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1931,11 +1931,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path32.resolve(baseDir, baseName);
-          if (fs17.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path32.extname(baseName))) return void 0;
+          const localBin = path34.resolve(baseDir, baseName);
+          if (fs19.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path34.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs17.existsSync(`${localBin}${ext}`)
+            (ext) => fs19.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1947,21 +1947,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs17.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs19.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path32.resolve(
-            path32.dirname(resolvedScriptPath),
+          executableDir = path34.resolve(
+            path34.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path32.basename(
+            const legacyName = path34.basename(
               this._scriptPath,
-              path32.extname(this._scriptPath)
+              path34.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1972,7 +1972,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path32.extname(executableFile));
+        launchWithNode = sourceExt.includes(path34.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2812,7 +2812,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path32.basename(filename, path32.extname(filename));
+        this._name = path34.basename(filename, path34.extname(filename));
         return this;
       }
       /**
@@ -2826,9 +2826,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path33) {
-        if (path33 === void 0) return this._executableDir;
-        this._executableDir = path33;
+      executableDir(path35) {
+        if (path35 === void 0) return this._executableDir;
+        this._executableDir = path35;
         return this;
       }
       /**
@@ -3346,9 +3346,9 @@ function createDebugLogger(namespace, label) {
     }
   };
 }
-function formatIssuePath(path32) {
-  if (!path32 || path32.length === 0) return "(root)";
-  return path32.map(
+function formatIssuePath(path34) {
+  if (!path34 || path34.length === 0) return "(root)";
+  return path34.map(
     (segment) => typeof segment === "symbol" ? segment.description ?? segment.toString() : String(segment)
   ).join(".");
 }
@@ -3464,8 +3464,8 @@ var init_src = __esm({
       /** Buat TwError dari ZodError — dukung shape Zod v3 (`errors`) dan v4 (`issues`). */
       static fromZod(err) {
         const first = err.issues?.[0] ?? err.errors?.[0];
-        const path32 = formatIssuePath(first?.path);
-        const message = first ? `${path32}: ${first.message}` : "Schema validation failed";
+        const path34 = formatIssuePath(first?.path);
+        const message = first ? `${path34}: ${first.message}` : "Schema validation failed";
         return new _TwError("validation", "SCHEMA_VALIDATION_FAILED", message, err);
       }
       static wrap(source, code, err) {
@@ -4021,12 +4021,12 @@ var init_schemas = __esm({
     "use strict";
     init_esm_shims();
     init_src();
-    formatIssuePath2 = (path32) => path32.length > 0 ? path32.map(
+    formatIssuePath2 = (path34) => path34.length > 0 ? path34.map(
       (segment) => typeof segment === "symbol" ? segment.description ?? segment.toString() : String(segment)
     ).join(".") : "<root>";
     formatIssues = (error) => error.issues.map((issue) => {
-      const path32 = formatIssuePath2(issue.path);
-      return `${path32}: ${issue.message}`;
+      const path34 = formatIssuePath2(issue.path);
+      return `${path34}: ${issue.message}`;
     }).join("; ");
     parseWithSchema = (schema, data, label) => {
       const parsed = schema.safeParse(data);
@@ -4631,7 +4631,7 @@ var init_schemas2 = __esm({
     "use strict";
     init_esm_shims();
     init_src();
-    formatIssuePath3 = (path32) => path32.length > 0 ? path32.map(
+    formatIssuePath3 = (path34) => path34.length > 0 ? path34.map(
       (segment) => typeof segment === "symbol" ? segment.description ?? segment.toString() : String(segment)
     ).join(".") : "<root>";
     isPlainObject = (value) => {
@@ -4640,8 +4640,8 @@ var init_schemas2 = __esm({
       return proto === Object.prototype || proto === null;
     };
     formatIssues2 = (error) => error.issues.map((issue) => {
-      const path32 = formatIssuePath3(issue.path);
-      return `${path32}: ${issue.message}`;
+      const path34 = formatIssuePath3(issue.path);
+      return `${path34}: ${issue.message}`;
     }).join("; ");
     parseWithSchema2 = (schema, data, label) => {
       const parsed = schema.safeParse(data);
@@ -6262,7 +6262,7 @@ var init_nativeBridge = __esm({
     "use strict";
     init_esm_shims();
     init_src();
-    _loadNative = (path32) => __require(path32);
+    _loadNative = (path34) => __require(path34);
     log3 = (...args) => {
       if (process.env.DEBUG?.includes("compiler:native")) {
         console.log("[compiler:native]", ...args);
@@ -6405,8 +6405,8 @@ var init_watch = __esm({
 });
 
 // packages/domain/compiler/src/routeGraph.ts
-import fs12 from "fs";
-import path25 from "path";
+import fs13 from "fs";
+import path26 from "path";
 var init_routeGraph = __esm({
   "packages/domain/compiler/src/routeGraph.ts"() {
     "use strict";
@@ -6414,9 +6414,35 @@ var init_routeGraph = __esm({
   }
 });
 
+// packages/domain/compiler/src/semanticComponentAnalyzer.ts
+var init_semanticComponentAnalyzer = __esm({
+  "packages/domain/compiler/src/semanticComponentAnalyzer.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
+// packages/domain/compiler/src/typeGeneratorFromMetadata.ts
+var init_typeGeneratorFromMetadata = __esm({
+  "packages/domain/compiler/src/typeGeneratorFromMetadata.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
+// packages/domain/compiler/src/typeGenerationPlugin.ts
+import fs14 from "fs";
+import path27 from "path";
+var init_typeGenerationPlugin = __esm({
+  "packages/domain/compiler/src/typeGenerationPlugin.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
 // packages/domain/compiler/src/index.ts
-import fs13 from "fs";
-import path26 from "path";
+import fs15 from "fs";
+import path28 from "path";
 import { createRequire as createRequire4 } from "module";
 var _require3, compileCssFromClasses;
 var init_src4 = __esm({
@@ -6431,6 +6457,9 @@ var init_src4 = __esm({
     init_redis();
     init_watch();
     init_routeGraph();
+    init_semanticComponentAnalyzer();
+    init_typeGeneratorFromMetadata();
+    init_typeGenerationPlugin();
     _require3 = createRequire4(
       typeof __require !== "undefined" ? typeof __filename !== "undefined" ? `file://${__filename}` : "file://unknown" : import.meta.url
     );
@@ -8737,12 +8766,289 @@ function printDoctorOutput(result, output) {
   );
 }
 
+// packages/infrastructure/cli/src/commands/figma.ts
+init_esm_shims();
+init_errors();
+import fs12 from "fs";
+import path24 from "path";
+
+// packages/infrastructure/cli/src/utils/figmaApi.ts
+init_esm_shims();
+async function figmaRequest(endpoint, options) {
+  const { token, fileKey } = options;
+  if (!token) {
+    throw new Error("FIGMA_TOKEN environment variable not set");
+  }
+  if (!fileKey) {
+    throw new Error("FIGMA_FILE_KEY environment variable not set");
+  }
+  const url = `https://api.figma.com/v1${endpoint.replace(":fileKey", fileKey)}`;
+  const res = await fetch(url, {
+    headers: { "X-Figma-Token": token }
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Figma API ${res.status}: ${body.slice(0, 200)}`);
+  }
+  return res.json();
+}
+function figmaColorToHex(color) {
+  const { r, g, b, a = 1 } = color;
+  const toHex = (v) => Math.round(v * 255).toString(16).padStart(2, "0");
+  const hex = `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+  return a < 1 ? `${hex}${toHex(a)}` : hex;
+}
+function figmaVariablesToTokens(variablesData) {
+  const tokens = {};
+  const { variables = {}, variableCollections = {} } = variablesData;
+  for (const [id, variable] of Object.entries(variables)) {
+    const collection = variableCollections?.[variable.variableCollectionId];
+    if (!collection) continue;
+    const modeId = Object.keys(variable.valuesByMode)[0];
+    const rawValue = variable.valuesByMode[modeId];
+    if (rawValue === void 0) continue;
+    const parts = variable.name.split("/").map(
+      (p) => p.toLowerCase().replace(/[^a-z0-9]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "")
+    );
+    let cursor = tokens;
+    for (let i = 0; i < parts.length - 1; i++) {
+      cursor[parts[i]] ??= {};
+      cursor = cursor[parts[i]];
+    }
+    const leafKey = parts[parts.length - 1];
+    if (variable.resolvedType === "COLOR") {
+      const token = {
+        $value: typeof rawValue === "object" && rawValue !== null && "r" in rawValue ? figmaColorToHex(rawValue) : String(rawValue),
+        $type: "color"
+      };
+      if (variable.description) token.$description = variable.description;
+      token._figmaId = id;
+      cursor[leafKey] = token;
+    } else if (variable.resolvedType === "FLOAT") {
+      cursor[leafKey] = {
+        $value: typeof rawValue === "number" ? `${rawValue}px` : String(rawValue),
+        $type: "dimension",
+        _figmaId: id
+      };
+    } else if (variable.resolvedType === "STRING") {
+      cursor[leafKey] = {
+        $value: String(rawValue),
+        $type: "other",
+        _figmaId: id
+      };
+    }
+  }
+  return tokens;
+}
+
+// packages/infrastructure/cli/src/utils/tokenUtils.ts
+init_esm_shims();
+function tokensToFigmaUpdates(tokens, existingVariables = {}) {
+  const updates = [];
+  function walk(obj, path34 = []) {
+    for (const [key, val] of Object.entries(obj)) {
+      if (typeof val === "object" && val !== null && "$value" in val) {
+        const tokenVal = val;
+        const name = path34.concat(key).map(
+          (p) => p.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("")
+        ).join("/");
+        const existing = Object.values(existingVariables).find(
+          (v) => v.name === name
+        );
+        if (existing) {
+          updates.push({
+            id: existing.id,
+            name,
+            value: tokenVal.$value,
+            type: tokenVal.$type
+          });
+        }
+      } else if (typeof val === "object" && val !== null && !("$type" in val)) {
+        walk(val, path34.concat(key));
+      }
+    }
+  }
+  walk(tokens);
+  return updates;
+}
+function flattenTokens(obj, prefix = "", target = {}) {
+  for (const [k, v] of Object.entries(obj)) {
+    const key = [prefix, k].filter(Boolean).join(".");
+    if (typeof v === "object" && v !== null && "$value" in v) {
+      const tokenVal = v;
+      target[key] = tokenVal.$value;
+    } else if (typeof v === "object" && v !== null && !("$type" in v)) {
+      flattenTokens(v, key, target);
+    }
+  }
+  return target;
+}
+function diffTokens(local, figma) {
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(local), ...Object.keys(figma)]);
+  const diffs = [];
+  for (const key of allKeys) {
+    if (local[key] !== figma[key]) {
+      diffs.push({
+        key,
+        local: local[key],
+        figma: figma[key]
+      });
+    }
+  }
+  return diffs;
+}
+
+// packages/infrastructure/cli/src/commands/figma.ts
+var figmaCommand = {
+  name: "figma",
+  async run(args, context) {
+    const cmd = args[0];
+    const isDryRun = args.includes("--dry-run");
+    const FIGMA_TOKEN = process.env.FIGMA_TOKEN;
+    const FIGMA_FILE_KEY = process.env.FIGMA_FILE_KEY;
+    const TOKEN_FILE = path24.join(context.cwd, "tokens.sync.json");
+    if (!cmd || cmd === "help") {
+      context.output.writeText(`Usage: tw figma <pull|push|diff> [--dry-run]
+
+Environment variables:
+  FIGMA_TOKEN    \u2014 Figma personal access token (figd_...)
+  FIGMA_FILE_KEY \u2014 Figma file key (from URL: figma.com/file/<KEY>/...)
+
+Commands:
+  pull           Import Figma variables \u2192 tokens.sync.json
+  push           Export tokens.sync.json \u2192 Figma variables
+  diff           Show differences between local and Figma
+
+Options:
+  --dry-run      Show what would change without writing`);
+      return;
+    }
+    if (cmd === "pull") {
+      if (!FIGMA_TOKEN || !FIGMA_FILE_KEY) {
+        throw new CliUsageError(
+          "Missing FIGMA_TOKEN or FIGMA_FILE_KEY\nSet environment variables and retry\n\nExample:\n  export FIGMA_TOKEN=figd_your_token_here\n  export FIGMA_FILE_KEY=abc123XYZ"
+        );
+      }
+      try {
+        const spinner = context.output.spinner();
+        spinner.start("Fetching Figma variables...");
+        const data = await figmaRequest("/files/:fileKey/variables/local", {
+          token: FIGMA_TOKEN,
+          fileKey: FIGMA_FILE_KEY
+        });
+        spinner.stop();
+        const tokens = figmaVariablesToTokens(data);
+        const variableCount = Object.values(data.variables ?? {}).length;
+        if (isDryRun) {
+          context.output.info("DRY RUN \u2014 would write:");
+          context.output.writeText(JSON.stringify({ version: 1, tokens }, null, 2));
+        } else {
+          let existing = { version: 1, tokens: {} };
+          if (fs12.existsSync(TOKEN_FILE)) {
+            try {
+              existing = JSON.parse(fs12.readFileSync(TOKEN_FILE, "utf8"));
+            } catch {
+            }
+          }
+          const merged = {
+            ...existing,
+            tokens: { ...existing.tokens, ...tokens },
+            figmaFileKey: FIGMA_FILE_KEY,
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            source: "figma"
+          };
+          fs12.writeFileSync(TOKEN_FILE, JSON.stringify(merged, null, 2) + "\n");
+          context.output.success(
+            `Pulled ${variableCount} variables from Figma \u2192 ${TOKEN_FILE}`
+          );
+        }
+      } catch (e) {
+        throw new CliUsageError(
+          `Pull failed: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+    } else if (cmd === "push") {
+      if (!FIGMA_TOKEN || !FIGMA_FILE_KEY) {
+        throw new CliUsageError("Missing FIGMA_TOKEN or FIGMA_FILE_KEY");
+      }
+      if (!fs12.existsSync(TOKEN_FILE)) {
+        throw new CliUsageError(
+          `${TOKEN_FILE} not found. Run 'tw sync init' first.`
+        );
+      }
+      try {
+        const local = JSON.parse(fs12.readFileSync(TOKEN_FILE, "utf8"));
+        const data = await figmaRequest("/files/:fileKey/variables/local", {
+          token: FIGMA_TOKEN,
+          fileKey: FIGMA_FILE_KEY
+        });
+        const updates = tokensToFigmaUpdates(local.tokens ?? {}, data.variables?.length ? Object.entries(data.variables ?? {}).reduce((acc, [id, v]) => ({ ...acc, [id]: { ...v, id } }), {}) : {});
+        if (isDryRun) {
+          context.output.info(
+            `DRY RUN \u2014 would update ${updates.length} variables in Figma:`
+          );
+          updates.forEach((u) => context.output.writeText(`  ${u.name}: ${u.value}`));
+        } else {
+          if (updates.length === 0) {
+            context.output.info("No matching variables to update");
+          } else {
+            context.output.success(`Updated ${updates.length} variables in Figma`);
+          }
+        }
+      } catch (e) {
+        throw new CliUsageError(
+          `Push failed: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+    } else if (cmd === "diff") {
+      if (!FIGMA_TOKEN || !FIGMA_FILE_KEY) {
+        throw new CliUsageError("Missing FIGMA_TOKEN or FIGMA_FILE_KEY");
+      }
+      if (!fs12.existsSync(TOKEN_FILE)) {
+        throw new CliUsageError("tokens.sync.json not found");
+      }
+      try {
+        const [local, figmaData] = await Promise.all([
+          JSON.parse(fs12.readFileSync(TOKEN_FILE, "utf8")),
+          figmaRequest("/files/:fileKey/variables/local", {
+            token: FIGMA_TOKEN,
+            fileKey: FIGMA_FILE_KEY
+          })
+        ]);
+        const figmaTokens = figmaVariablesToTokens(figmaData);
+        const figmaFlat = {};
+        const localFlat = {};
+        flattenTokens(local.tokens ?? {}, "", localFlat);
+        flattenTokens(figmaTokens, "", figmaFlat);
+        const diffs = diffTokens(localFlat, figmaFlat);
+        if (diffs.length === 0) {
+          context.output.success("No differences \u2014 local and Figma are in sync");
+        } else {
+          context.output.info(`${diffs.length} differences found:
+`);
+          diffs.forEach((d) => {
+            context.output.writeText(`  ${d.key}`);
+            context.output.writeText(`    local: ${d.local ?? "(missing)"}`);
+            context.output.writeText(`    figma: ${d.figma ?? "(missing)"}`);
+          });
+        }
+      } catch (e) {
+        throw new CliUsageError(
+          `Diff failed: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+    } else {
+      throw new CliUsageError(`Unknown command: ${cmd}`);
+    }
+  }
+};
+
 // packages/infrastructure/cli/src/commands/misc.ts
 init_esm_shims();
 init_errors();
 init_fs();
 init_json();
-import path24 from "path";
+import path25 from "path";
 import { parseArgs as parseNodeArgs9 } from "util";
 var testCommand = {
   name: "test",
@@ -8772,7 +9078,7 @@ var shareCommand = {
   name: "share",
   async run(args, context) {
     const name = args.find((arg) => !arg.startsWith("-")) ?? "component-name";
-    const manifestPath = path24.join(process.cwd(), ".tw-cache", "deploy-manifest.json");
+    const manifestPath = path25.join(process.cwd(), ".tw-cache", "deploy-manifest.json");
     const defaultManifest = {
       name,
       version: "0.1.0"
@@ -8858,14 +9164,14 @@ var isVersionOutdated = (currentVersion, latestVersion) => {
 };
 var resolveCurrentCliVersion = async (context) => {
   const candidates = [
-    path24.resolve(context.runtimeDir, "..", "package.json"),
-    path24.resolve(process.cwd(), "packages", "cli", "package.json"),
-    path24.resolve(process.cwd(), "package.json")
+    path25.resolve(context.runtimeDir, "..", "package.json"),
+    path25.resolve(process.cwd(), "packages", "cli", "package.json"),
+    path25.resolve(process.cwd(), "package.json")
   ];
   for (const candidate of candidates) {
     if (!await pathExists2(candidate)) continue;
     const pkg = await readJsonSafe(candidate);
-    const isCliPackage = pkg?.version && (pkg.name === CLI_PACKAGE_NAME || candidate.includes(`${path24.sep}packages${path24.sep}cli${path24.sep}`));
+    const isCliPackage = pkg?.version && (pkg.name === CLI_PACKAGE_NAME || candidate.includes(`${path25.sep}packages${path25.sep}cli${path25.sep}`));
     if (isCliPackage) return pkg.version ?? "0.0.0";
   }
   return "0.0.0";
@@ -9113,7 +9419,7 @@ init_errors();
 init_fs();
 init_json();
 init_src4();
-import path27 from "path";
+import path29 from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 var DEFAULT_TAILWIND_CSS2 = '@import "tailwindcss";\n';
 var DEFAULT_TW_CONFIG = `${JSON.stringify(
@@ -9140,8 +9446,8 @@ async function validateThemeConfig(cwd2) {
     const twConfigFiles = ["tailwind.config.ts", "tailwind.config.js", "tailwind.config.mjs"];
     let configPath = null;
     for (const file of twConfigFiles) {
-      if (await pathExists2(path27.join(cwd2, file))) {
-        configPath = path27.join(cwd2, file);
+      if (await pathExists2(path29.join(cwd2, file))) {
+        configPath = path29.join(cwd2, file);
         break;
       }
     }
@@ -9232,7 +9538,7 @@ function resolveCliEntry(scriptPath) {
 async function hasTailwindCssImport(cwd2) {
   const cssFiles = ["src/app/globals.css", "src/index.css", "src/style.css", "app/globals.css"];
   for (const file of cssFiles) {
-    const raw = await readFileSafe(path27.join(cwd2, file));
+    const raw = await readFileSafe(path29.join(cwd2, file));
     if (raw?.includes("tailwindcss")) return true;
   }
   return false;
@@ -9248,7 +9554,7 @@ async function hasSafelistSource(cwd2) {
     "app/globals.css"
   ];
   for (const file of cssFiles) {
-    const raw = await readFileSafe(path27.join(cwd2, file));
+    const raw = await readFileSafe(path29.join(cwd2, file));
     if (raw === null) continue;
     if (raw.includes("tw-classes")) return { found: true, cssFile: file };
     if (raw.includes("tailwindcss")) return { found: false, cssFile: file };
@@ -9256,8 +9562,8 @@ async function hasSafelistSource(cwd2) {
   return { found: false, cssFile: null };
 }
 async function applyTailwindInit(cwd2) {
-  await ensureFileSafe(path27.join(cwd2, "src", "tailwind.css"), DEFAULT_TAILWIND_CSS2);
-  await ensureFileSafe(path27.join(cwd2, "tailwind-styled.config.json"), DEFAULT_TW_CONFIG);
+  await ensureFileSafe(path29.join(cwd2, "src", "tailwind.css"), DEFAULT_TAILWIND_CSS2);
+  await ensureFileSafe(path29.join(cwd2, "tailwind-styled.config.json"), DEFAULT_TW_CONFIG);
 }
 function check(results, id, label, pass, message, fix) {
   results.push({ id, label, pass, message, fix });
@@ -9279,7 +9585,7 @@ async function runPreflightCli(rawArgs) {
     node.major >= 20 ? `Node ${node.full} OK` : `Node ${node.full} - requires >=20. Download: https://nodejs.org`,
     node.major < 20 ? "Install Node.js 20 LTS or newer from https://nodejs.org" : void 0
   );
-  const pkg = await readJsonSafe(path27.join(cwd2, "package.json"));
+  const pkg = await readJsonSafe(path29.join(cwd2, "package.json"));
   check(
     results,
     "package-json",
@@ -9313,7 +9619,7 @@ async function runPreflightCli(rawArgs) {
   }
   const twConfigFiles = ["tailwind.config.ts", "tailwind.config.js", "tailwind.config.mjs"];
   const twConfigChecks = await Promise.all(
-    twConfigFiles.map(async (file) => ({ file, exists: await pathExists2(path27.join(cwd2, file)) }))
+    twConfigFiles.map(async (file) => ({ file, exists: await pathExists2(path29.join(cwd2, file)) }))
   );
   const foundTwConfig = twConfigChecks.find((item) => item.exists)?.file ?? null;
   const hasCssConfig = await hasTailwindCssImport(cwd2);
@@ -9325,7 +9631,7 @@ async function runPreflightCli(rawArgs) {
     foundTwConfig ? `${foundTwConfig} found OK` : hasCssConfig ? "@import tailwindcss found in CSS OK" : "No Tailwind config found - run: tw init",
     "tw init"
   );
-  const oldConfig = await readJsonSafe(path27.join(cwd2, "tailwind.config.js")) ?? await readJsonSafe(path27.join(cwd2, "tailwind.config.ts"));
+  const oldConfig = await readJsonSafe(path29.join(cwd2, "tailwind.config.js")) ?? await readJsonSafe(path29.join(cwd2, "tailwind.config.ts"));
   if (oldConfig) {
     const hasOldJit = oldConfig.mode === "jit";
     const hasOldPurge = "purge" in oldConfig;
@@ -9349,7 +9655,7 @@ async function runPreflightCli(rawArgs) {
       validation.message
     );
   }
-  const hasTsConfig = await pathExists2(path27.join(cwd2, "tsconfig.json"));
+  const hasTsConfig = await pathExists2(path29.join(cwd2, "tsconfig.json"));
   check(
     results,
     "typescript",
@@ -9711,7 +10017,7 @@ init_esm_shims();
 init_errors();
 init_fs();
 init_json();
-import path28 from "path";
+import path30 from "path";
 import { parseArgs as parseNodeArgs11 } from "util";
 var storybookCommand = {
   name: "storybook",
@@ -9750,7 +10056,7 @@ var storybookCommand = {
     context.output.writeText(
       `[tw storybook] Tip: use --variants='{"size":["sm","lg"]}' to enumerate variant combinations`
     );
-    const localBin = path28.join(
+    const localBin = path30.join(
       process.cwd(),
       "node_modules",
       ".bin",
@@ -10937,10 +11243,10 @@ async function traceClass(className, options) {
 init_esm_shims();
 init_internal();
 init_src2();
-import fs14 from "fs";
-import path29 from "path";
+import fs16 from "fs";
+import path31 from "path";
 function toRelativePath(root, value) {
-  const relative = path29.relative(root, value);
+  const relative = path31.relative(root, value);
   return relative.length > 0 ? relative : ".";
 }
 function uniqueSorted(values) {
@@ -11009,7 +11315,7 @@ function tryCompileClasses(classes) {
   }
 }
 function traceSingleFile(filePath, root) {
-  const source = fs14.readFileSync(filePath, "utf8");
+  const source = fs16.readFileSync(filePath, "utf8");
   const classes = uniqueSorted(scanSource(source));
   const imports = extractImports(source);
   const compiled = tryCompileClasses(classes);
@@ -11040,7 +11346,7 @@ function traceDirectory(targetDir, root) {
   const imports = [];
   const importKeys = /* @__PURE__ */ new Set();
   const files = scanResult.files.filter((entry) => isScannableFile2(entry.file, DEFAULT_EXTENSIONS)).map((entry) => {
-    const source = fs14.readFileSync(entry.file, "utf8");
+    const source = fs16.readFileSync(entry.file, "utf8");
     const fileImports = extractImports(source);
     for (const fileImport of fileImports) {
       const key = `${fileImport.kind}:${fileImport.source}`;
@@ -11071,12 +11377,12 @@ function traceDirectory(targetDir, root) {
   };
 }
 async function traceTarget(target, options = {}) {
-  const root = path29.resolve(options.root ?? process.cwd());
-  const resolvedTarget = path29.resolve(root, target);
-  if (!fs14.existsSync(resolvedTarget)) {
+  const root = path31.resolve(options.root ?? process.cwd());
+  const resolvedTarget = path31.resolve(root, target);
+  if (!fs16.existsSync(resolvedTarget)) {
     throw new Error(`Trace target not found: ${resolvedTarget}`);
   }
-  const stat = fs14.statSync(resolvedTarget);
+  const stat = fs16.statSync(resolvedTarget);
   if (stat.isDirectory()) {
     return traceDirectory(resolvedTarget, root);
   }
@@ -11241,14 +11547,14 @@ function printClassTraceOutput(result, output) {
 init_esm_shims();
 var import_picocolors6 = __toESM(require_picocolors(), 1);
 init_output();
-import fs15 from "fs";
-import path30 from "path";
+import fs17 from "fs";
+import path32 from "path";
 async function runGenerateTypesCli(rawArgs) {
   const output = createCliOutput({ json: rawArgs.includes("--json") });
   const logger = createCliLogger({ output });
   const cwd2 = process.cwd();
   const outFile = rawArgs.find((a) => a.startsWith("--out="))?.slice(6) ?? "src/types/tailwind-styled.d.ts";
-  const outPath = path30.resolve(cwd2, outFile);
+  const outPath = path32.resolve(cwd2, outFile);
   output.writeText("");
   output.writeText(import_picocolors6.default.bold(import_picocolors6.default.cyan("  \u25C6 tw generate-types")));
   output.writeText(import_picocolors6.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
@@ -11284,12 +11590,12 @@ async function runGenerateTypesCli(rawArgs) {
   }
   output.writeText("");
   output.writeText(import_picocolors6.default.bold("  [2/2]") + import_picocolors6.default.cyan("  generate .d.ts"));
-  const outDir = path30.dirname(outPath);
-  if (!fs15.existsSync(outDir)) {
-    fs15.mkdirSync(outDir, { recursive: true });
+  const outDir = path32.dirname(outPath);
+  if (!fs17.existsSync(outDir)) {
+    fs17.mkdirSync(outDir, { recursive: true });
   }
-  fs15.writeFileSync(outPath, result.dtsContent, "utf-8");
-  logger.ok(path30.relative(cwd2, outPath));
+  fs17.writeFileSync(outPath, result.dtsContent, "utf-8");
+  logger.ok(path32.relative(cwd2, outPath));
   output.writeText("");
   output.writeText(import_picocolors6.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   output.writeText(import_picocolors6.default.bold(import_picocolors6.default.green("  \u2713 types generated")));
@@ -11300,11 +11606,11 @@ async function runGenerateTypesCli(rawArgs) {
 }
 async function loadNativeBinding2(cwd2) {
   const candidates = [
-    path30.join(cwd2, "native", "tailwind-styled-native.node"),
-    path30.join(cwd2, "node_modules", "tailwind-styled-v4", "native", "tailwind-styled-native.node")
+    path32.join(cwd2, "native", "tailwind-styled-native.node"),
+    path32.join(cwd2, "node_modules", "tailwind-styled-v4", "native", "tailwind-styled-native.node")
   ];
   for (const candidate of candidates) {
-    if (fs15.existsSync(candidate)) {
+    if (fs17.existsSync(candidate)) {
       try {
         return __require(candidate);
       } catch {
@@ -11322,8 +11628,8 @@ import { parseArgs as parseNodeArgs14 } from "util";
 // packages/infrastructure/cli/src/utils/whyService.ts
 init_esm_shims();
 init_internal();
-import fs16 from "fs";
-import path31 from "path";
+import fs18 from "fs";
+import path33 from "path";
 init_src2();
 function extractVariantChain(usage) {
   const segments = normalizeScannedClass(usage).split(":").filter(Boolean);
@@ -11371,7 +11677,7 @@ async function whyClass(className, options) {
   for (const file of scanResult.files) {
     const source = (() => {
       try {
-        return fs16.readFileSync(file.file, "utf8");
+        return fs18.readFileSync(file.file, "utf8");
       } catch {
         return "";
       }
@@ -11385,7 +11691,7 @@ async function whyClass(className, options) {
           className
         ]);
         usedIn.push({
-          file: path31.relative(root, file.file) || path31.basename(file.file),
+          file: path33.relative(root, file.file) || path33.basename(file.file),
           line: location.line,
           column: location.column,
           usage: normalizeScannedClass(fileClass)
@@ -11692,6 +11998,12 @@ function buildMainProgram(context) {
       );
     });
   });
+  const figmaTopLevel = program2.command("figma").description("Figma design token sync");
+  ["pull", "push", "diff"].forEach((subcommand) => {
+    figmaTopLevel.command(`${subcommand} [args...]`).description(`Figma ${subcommand}`).allowUnknownOption(true).action(async (args) => {
+      await figmaCommand.run(contextArgs([subcommand, ...toVariadic(args)], context), context);
+    });
+  });
   program2.command("test").description("Test shortcut wrapper").option("--watch", "Watch mode").action(async (...actionArgs) => {
     const options = actionCommand(actionArgs).opts();
     const args = [];