@fragments-sdk/cli 0.15.0 → 0.15.1

package/dist/bin.js

@@ -1,43 +1,26 @@
 #!/usr/bin/env node
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import {
+  setup
+} from "./chunk-BJE3425I.js";
 import {
   scan
-} from "./chunk-CZD3AD4Q.js";
+} from "./chunk-ONUP6Z4W.js";
 import {
   createAIClient,
   detectProvider,
   getApiKey
 } from "./chunk-SXTKFDCR.js";
 import {
-  setup
-} from "./chunk-BJE3425I.js";
-import {
-  buildFragments,
-  buildFragmentsDir,
-  measureBundleSizes,
-  resolveComponentSourcePath,
   runAnalyzeCommand,
   runDiffCommand,
   runScreenshotCommand,
-  toPerformanceData,
   validateAll,
   validateCoverage,
   validateDrift,
   validateSchema,
   validateSnippets
-} from "./chunk-7WHVW72L.js";
-import {
-  createComponentExtractor
-} from "./chunk-MN3TJ3D5.js";
-import {
-  discoverFragmentFiles,
-  loadConfig,
-  loadFragmentFile,
-  parseFragmentFile
-} from "./chunk-65WSVDV5.js";
-import {
-  projectFields
-} from "./chunk-T47OLCSF.js";
+} from "./chunk-5JF26E55.js";
 import {
   FigmaClient,
   StorageManager,
@@ -51,28 +34,38 @@ import {
   parseAllStories,
   renderAllComponentVariants,
   shutdownSharedPool
-} from "./chunk-XJQ5BIWI.js";
+} from "./chunk-6SQPP47U.js";
+import {
+  projectFields
+} from "./chunk-T47OLCSF.js";
 import "./chunk-D2CDBRNU.js";
+import {
+  discoverFragmentFiles,
+  loadConfig,
+  loadFragmentFile,
+  parseFragmentFile
+} from "./chunk-HQ6A6DTV.js";
 import {
   BRAND,
   budgetBar,
+  classifyComplexity,
   formatBytes,
   generateContext,
   resolvePerformanceConfig
 } from "./chunk-32LIWN2P.js";
+import "./chunk-MHIBEEW4.js";
 import {
   getScanStats,
   scanCodebase
 } from "./chunk-QCN35LJU.js";
 import "./chunk-7DZC4YEV.js";
-import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
 import { Command } from "commander";
 import pc26 from "picocolors";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname5, join as join11 } from "path";
+import { dirname as dirname6, join as join12 } from "path";
 
 // src/commands/validate.ts
 import pc from "picocolors";
@@ -168,6 +161,7 @@ function printDriftReport(result) {
 
 // src/commands/build.ts
 import pc2 from "picocolors";
+import { buildFragments, buildFragmentsDir, getFragmentsJsonStatus } from "@fragments-sdk/compiler";
 async function build(options = {}) {
   if (options.fromSource) {
     console.log(pc2.cyan(`
@@ -202,6 +196,50 @@ ${BRAND.name} Build
   let registryPath;
   let contextPath;
   if (!options.registryOnly) {
+    const status = await getFragmentsJsonStatus(config, configDir, {
+      output: config.outFile,
+      configPath: options.config
+    });
+    if (options.check) {
+      if (status.missing || status.stale) {
+        const message = status.missing ? `${BRAND.outFile} is missing` : `${BRAND.outFile} is stale${status.reason ? ` (${status.reason})` : ""}`;
+        console.log(pc2.red(`\u2717 ${message}
+`));
+        errors.push({
+          file: status.outputPath,
+          error: message
+        });
+        return {
+          success: false,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+      console.log(pc2.green(`\u2713 ${BRAND.outFile} is up to date`));
+      console.log(pc2.dim(`  Output: ${status.outputPath}
+`));
+      if (!options.registry) {
+        return {
+          success: true,
+          fragmentCount: Object.keys(status.data?.fragments ?? {}).length,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+    }
+    if (options.ifNeeded && !status.missing && !status.stale) {
+      console.log(pc2.green(`\u2713 ${BRAND.outFile} is up to date`));
+      console.log(pc2.dim(`  Output: ${status.outputPath}
+`));
+      if (!options.registry) {
+        return {
+          success: true,
+          fragmentCount: Object.keys(status.data?.fragments ?? {}).length,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+    }
     console.log(pc2.dim("Compiling fragments...\n"));
     const result = await buildFragments(config, configDir);
     if (result.errors.length > 0) {
@@ -277,6 +315,7 @@ ${BRAND.name} Build
 import { readFile } from "fs/promises";
 import { resolve } from "path";
 import pc3 from "picocolors";
+import { buildFragments as buildFragments2 } from "@fragments-sdk/compiler";
 async function context(options = {}) {
   const {
     format = "markdown",
@@ -293,7 +332,7 @@ async function context(options = {}) {
     fragments = Object.values(data.fragments);
   } else {
     const { config, configDir } = await loadConfig(options.config);
-    const result = await buildFragments(config, configDir);
+    const result = await buildFragments2(config, configDir);
     if (result.errors.length > 0 && result.fragmentCount === 0) {
       console.error(pc3.red("Error: No fragments found. Run `fragments build` first or fix errors."));
       return { success: false, tokenEstimate: 0 };
@@ -5488,13 +5527,259 @@ ${BRAND.name} Components (${fragments.length})
 // src/commands/perf.ts
 import pc21 from "picocolors";
 import { readFile as readFile10, writeFile as writeFile8 } from "fs/promises";
-import { resolve as resolve10 } from "path";
+import { resolve as resolve11 } from "path";
+
+// src/core/bundle-measurer.ts
+import { build as build2 } from "esbuild";
+import { gzipSync } from "zlib";
+import { resolve as resolve10, dirname as dirname4, join as join10, basename } from "path";
+import { existsSync as existsSync3 } from "fs";
+function resolveEntryPoint(fragmentFilePath, configDir) {
+  const absPath = resolve10(configDir, fragmentFilePath);
+  const dir = dirname4(absPath);
+  const candidates = ["index.tsx", "index.ts", "index.jsx", "index.js"];
+  for (const candidate of candidates) {
+    const path = join10(dir, candidate);
+    if (existsSync3(path)) return path;
+  }
+  return null;
+}
+function labelForPath(filePath) {
+  const lastNmIdx = filePath.lastIndexOf("node_modules/");
+  if (lastNmIdx >= 0) {
+    const afterNm = filePath.slice(lastNmIdx + "node_modules/".length);
+    if (afterNm.startsWith("@")) {
+      const parts = afterNm.split("/");
+      return parts.slice(0, 2).join("/");
+    }
+    return afterNm.split("/")[0];
+  }
+  const componentsIdx = filePath.indexOf("components/");
+  if (componentsIdx >= 0) {
+    const afterComponents = filePath.slice(componentsIdx + "components/".length);
+    const componentName = afterComponents.split("/")[0];
+    return componentName;
+  }
+  const srcIdx = filePath.indexOf("src/");
+  if (srcIdx >= 0) return filePath.slice(srcIdx);
+  return filePath;
+}
+function groupImportsByDirectDep(metafile, entryPoint) {
+  const inputs = metafile.inputs;
+  const outputKey = Object.keys(metafile.outputs)[0];
+  const outputMeta = outputKey ? metafile.outputs[outputKey] : void 0;
+  if (!outputMeta?.inputs) return [];
+  const bytesMap = /* @__PURE__ */ new Map();
+  for (const [path, info] of Object.entries(outputMeta.inputs)) {
+    if (info.bytesInOutput > 0) {
+      bytesMap.set(path, info.bytesInOutput);
+    }
+  }
+  let entryKey;
+  for (const key of Object.keys(inputs)) {
+    if (key === entryPoint || entryPoint.endsWith(key) || key.endsWith(basename(entryPoint))) {
+      const entryDir = dirname4(entryPoint);
+      if (key.includes(basename(entryDir))) {
+        entryKey = key;
+        break;
+      }
+    }
+  }
+  if (!entryKey) {
+    const entryBasename = basename(dirname4(entryPoint));
+    for (const key of Object.keys(inputs)) {
+      if (key.includes(`/${entryBasename}/index.`)) {
+        entryKey = key;
+        break;
+      }
+    }
+  }
+  if (!entryKey || !inputs[entryKey]) {
+    return groupByPackage(bytesMap);
+  }
+  const directImports = inputs[entryKey].imports.map((imp) => imp.path).filter((p) => inputs[p]);
+  const claimed = /* @__PURE__ */ new Set();
+  claimed.add(entryKey);
+  const groupMap = /* @__PURE__ */ new Map();
+  for (const directPath of directImports) {
+    if (claimed.has(directPath)) continue;
+    const queue = [directPath];
+    const reachable = /* @__PURE__ */ new Set();
+    while (queue.length > 0) {
+      const current = queue.pop();
+      if (reachable.has(current) || claimed.has(current)) continue;
+      reachable.add(current);
+      claimed.add(current);
+      const entry = inputs[current];
+      if (entry?.imports) {
+        for (const imp of entry.imports) {
+          if (inputs[imp.path] && !claimed.has(imp.path)) {
+            queue.push(imp.path);
+          }
+        }
+      }
+    }
+    let totalBytes = 0;
+    for (const path of reachable) {
+      totalBytes += bytesMap.get(path) ?? 0;
+    }
+    if (totalBytes > 0) {
+      const label = labelForPath(directPath);
+      const existing = groupMap.get(label);
+      if (existing) {
+        existing.bytes += totalBytes;
+      } else {
+        const entry = { path: label, bytes: totalBytes };
+        groupMap.set(label, entry);
+      }
+    }
+  }
+  const entryLabel = labelForPath(entryKey);
+  const selfLabel = entryLabel + " (self)";
+  let selfBytes = bytesMap.get(entryKey) ?? 0;
+  const siblingGroup = groupMap.get(entryLabel);
+  if (siblingGroup) {
+    selfBytes += siblingGroup.bytes;
+    groupMap.delete(entryLabel);
+  }
+  if (selfBytes > 0) {
+    groupMap.set(selfLabel, { path: selfLabel, bytes: selfBytes });
+  }
+  let unclaimedBytes = 0;
+  for (const [path, bytes] of bytesMap) {
+    if (!claimed.has(path)) unclaimedBytes += bytes;
+  }
+  if (unclaimedBytes > 0) {
+    groupMap.set("(other)", { path: "(other)", bytes: unclaimedBytes });
+  }
+  return [...groupMap.values()].sort((a, b) => b.bytes - a.bytes);
+}
+function groupByPackage(bytesMap) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const [path, bytes] of bytesMap) {
+    const label = labelForPath(path);
+    const key = label.includes("/") && !label.startsWith("components/") ? label.split("/").slice(0, label.startsWith("@") ? 2 : 1).join("/") : label;
+    groups.set(key, (groups.get(key) ?? 0) + bytes);
+  }
+  return [...groups.entries()].map(([path, bytes]) => ({ path, bytes })).sort((a, b) => b.bytes - a.bytes);
+}
+async function measureSingleComponent(entryPoint, name) {
+  const result = await build2({
+    entryPoints: [entryPoint],
+    bundle: true,
+    write: false,
+    minify: true,
+    metafile: true,
+    format: "esm",
+    target: "es2020",
+    platform: "browser",
+    treeShaking: true,
+    external: [
+      "react",
+      "react-dom",
+      "react/jsx-runtime",
+      "react/jsx-dev-runtime",
+      // Optional peer deps — excluded from measurement
+      "recharts",
+      "shiki",
+      "react-day-picker",
+      "@tanstack/react-table",
+      "date-fns",
+      "@base-ui-components/*",
+      "@base-ui/react/*"
+    ],
+    loader: {
+      ".scss": "empty",
+      ".css": "empty",
+      ".svg": "empty",
+      ".png": "empty",
+      ".jpg": "empty",
+      ".gif": "empty",
+      ".woff": "empty",
+      ".woff2": "empty",
+      ".ttf": "empty",
+      ".eot": "empty"
+    },
+    logLevel: "silent"
+  });
+  const output = result.outputFiles[0];
+  const rawBytes = output.contents.byteLength;
+  const gzipBytes = gzipSync(output.contents).byteLength;
+  const imports = result.metafile ? groupImportsByDirectDep(result.metafile, entryPoint) : void 0;
+  return { name, rawBytes, gzipBytes, imports };
+}
+async function measureBundleSizes(fragments, configDir, options = {}) {
+  const concurrency = options.concurrency ?? 4;
+  const measurements = /* @__PURE__ */ new Map();
+  const errors = [];
+  const start = Date.now();
+  const entries = [];
+  for (const [name, fragment] of Object.entries(fragments)) {
+    const entryPoint = resolveEntryPoint(fragment.filePath, configDir);
+    if (entryPoint) {
+      entries.push({ name, entryPoint });
+    } else {
+      errors.push({
+        name,
+        error: `Could not resolve entry point from ${fragment.filePath}`
+      });
+    }
+  }
+  let completed = 0;
+  for (let i = 0; i < entries.length; i += concurrency) {
+    const batch = entries.slice(i, i + concurrency);
+    const results = await Promise.allSettled(
+      batch.map(
+        ({ name, entryPoint }) => measureSingleComponent(entryPoint, name)
+      )
+    );
+    for (let j = 0; j < results.length; j++) {
+      const result = results[j];
+      const { name } = batch[j];
+      completed++;
+      if (result.status === "fulfilled") {
+        measurements.set(name, result.value);
+      } else {
+        errors.push({
+          name,
+          error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+        });
+      }
+      options.onProgress?.(completed, entries.length, name);
+    }
+  }
+  return {
+    measurements,
+    errors,
+    elapsed: Date.now() - start
+  };
+}
+function toPerformanceData(measurement, config, contractBudget) {
+  const budget = contractBudget ?? config.budgets.bundleSize;
+  const budgetPercent = Math.round(measurement.gzipBytes / budget * 100);
+  const imports = measurement.imports?.slice(0, 10).map((imp) => ({
+    path: imp.path,
+    bytes: imp.bytes,
+    percent: Math.round(imp.bytes / measurement.rawBytes * 100)
+  }));
+  return {
+    bundleSize: measurement.gzipBytes,
+    rawSize: measurement.rawBytes,
+    complexity: classifyComplexity(measurement.gzipBytes),
+    budgetPercent,
+    overBudget: budgetPercent > 100,
+    measuredAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...imports && imports.length > 0 ? { imports } : {}
+  };
+}
+
+// src/commands/perf.ts
 async function perf(options) {
   const { config: configPath, json, component, concurrency, detail } = options;
   const shouldWrite = options.write !== false;
   const { config, configDir } = await loadConfig(configPath);
   const perfConfig = resolvePerformanceConfig(config.performance ?? "standard");
-  const outFile = resolve10(configDir, config.outFile ?? BRAND.outFile);
+  const outFile = resolve11(configDir, config.outFile ?? BRAND.outFile);
   let data;
   try {
     data = JSON.parse(await readFile10(outFile, "utf-8"));
@@ -5638,14 +5923,15 @@ ${pc21.bold("Summary")}`);
 
 // src/commands/doctor.ts
 import { readFile as readFile11, access as access3 } from "fs/promises";
-import { join as join10, resolve as resolve11 } from "path";
+import { join as join11, resolve as resolve12 } from "path";
 import pc22 from "picocolors";
-var VALID_NEUTRALS = ["stone", "ice", "earth", "sand", "fire"];
+import { NEUTRAL_PALETTES } from "@fragments-sdk/viewer/docs-data";
+var VALID_NEUTRALS = NEUTRAL_PALETTES.map((p) => p.name);
 var VALID_DENSITIES = ["compact", "default", "relaxed"];
 var VALID_RADII = ["sharp", "subtle", "default", "rounded", "pill"];
 async function checkPackageInstalled(root) {
   try {
-    const pkgPath = join10(root, "package.json");
+    const pkgPath = join11(root, "package.json");
     const content = await readFile11(pkgPath, "utf-8");
     const pkg2 = JSON.parse(content);
     const allDeps = { ...pkg2.dependencies, ...pkg2.devDependencies };
@@ -5688,7 +5974,7 @@ async function checkStylesImport(root) {
   ];
   for (const pattern of entryPatterns) {
     try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
+      const content = await readFile11(join11(root, pattern), "utf-8");
       if (content.includes("@fragments-sdk/ui/styles")) {
         return {
           name: "Styles import",
@@ -5717,7 +6003,7 @@ async function checkStylesImport(root) {
   ];
   for (const pattern of scssPatterns) {
     try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
+      const content = await readFile11(join11(root, pattern), "utf-8");
       if (content.includes("@fragments-sdk/ui/styles")) {
         return {
           name: "Styles import",
@@ -5749,7 +6035,7 @@ async function checkThemeProvider(root) {
   ];
   for (const pattern of providerPatterns) {
     try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
+      const content = await readFile11(join11(root, pattern), "utf-8");
       if (content.includes("ThemeProvider")) {
         if (content.includes("defaultTheme=") || content.includes("defaultTheme =")) {
           return {
@@ -5787,7 +6073,7 @@ async function checkScssSeeds(root) {
   ];
   for (const pattern of scssPatterns) {
     try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
+      const content = await readFile11(join11(root, pattern), "utf-8");
       if (!content.includes("@fragments-sdk/ui/styles")) continue;
       const standalonePattern = /^\$fui-\w+:\s*.+;$/m;
       if (standalonePattern.test(content) && !content.includes("@use")) {
@@ -5858,7 +6144,7 @@ async function checkScssSeeds(root) {
 async function checkPeerDeps(root) {
   const checks = [];
   try {
-    const pkgPath = join10(root, "package.json");
+    const pkgPath = join11(root, "package.json");
     const content = await readFile11(pkgPath, "utf-8");
     const pkg2 = JSON.parse(content);
     const allDeps = { ...pkg2.dependencies, ...pkg2.devDependencies };
@@ -5916,7 +6202,7 @@ async function checkMcpConfig(root) {
   ];
   for (const configPath of mcpConfigPaths) {
     try {
-      const fullPath = join10(root, configPath);
+      const fullPath = join11(root, configPath);
       const content = await readFile11(fullPath, "utf-8");
       const config = JSON.parse(content);
       const servers = config.mcpServers || config.servers || {};
@@ -5943,7 +6229,7 @@ async function checkMcpConfig(root) {
 }
 async function checkTypeScript(root) {
   try {
-    const tsconfigPath = join10(root, "tsconfig.json");
+    const tsconfigPath = join11(root, "tsconfig.json");
     await access3(tsconfigPath);
     return {
       name: "TypeScript",
@@ -5959,7 +6245,7 @@ async function checkTypeScript(root) {
   }
 }
 async function doctor(options = {}) {
-  const root = resolve11(options.root ?? process.cwd());
+  const root = resolve12(options.root ?? process.cwd());
   const checks = [];
   if (!options.json) {
     console.log(pc22.cyan(`
@@ -6014,6 +6300,8 @@ ${BRAND.name} Doctor
 // src/commands/sync.ts
 import pc23 from "picocolors";
 import { readFile as readFile12, writeFile as writeFile9 } from "fs/promises";
+import { resolveComponentSourcePath } from "@fragments-sdk/extract";
+import { createComponentExtractor } from "@fragments-sdk/extract";
 async function sync(options = {}) {
   const { config, configDir } = await loadConfig(options.config);
   console.log(pc23.cyan(`
@@ -6251,18 +6539,65 @@ ${BRAND.name} Governance Check
 }
 async function governInit(options = {}) {
   const { writeFile: writeFile11 } = await import("fs/promises");
-  const { resolve: resolve14 } = await import("path");
+  const { existsSync: existsSync4 } = await import("fs");
+  const { resolve: resolve15 } = await import("path");
   const { generateConfigTemplate } = await import("@fragments-sdk/govern");
-  const outputPath = resolve14(options.output ?? "fragments.config.ts");
-  const template = generateConfigTemplate();
+  const { findTailwindConfig } = await import("./token-normalizer-TEPOVBPV.js");
+  const cwd = process.cwd();
+  const detected = {
+    tokenIncludes: [],
+    projectType: "unknown"
+  };
+  const tailwindPath = findTailwindConfig(cwd);
+  if (tailwindPath) {
+    const { relative: relative9 } = await import("path");
+    detected.tokenIncludes.push(relative9(cwd, tailwindPath));
+    detected.projectType = "tailwind";
+    console.log(pc24.dim(`  Detected Tailwind config: ${detected.tokenIncludes[0]}`));
+  }
+  if (detected.tokenIncludes.length === 0) {
+    const candidates = [
+      "src/styles/tokens.scss",
+      "src/styles/variables.scss",
+      "src/styles/theme.scss",
+      "src/tokens.css",
+      "src/styles/tokens.css",
+      "src/styles/variables.css",
+      "styles/tokens.scss",
+      "styles/variables.scss",
+      "tokens.json",
+      "src/tokens.json"
+    ];
+    for (const candidate of candidates) {
+      if (existsSync4(resolve15(cwd, candidate))) {
+        detected.tokenIncludes.push(candidate);
+        detected.projectType = candidate.endsWith(".scss") ? "scss" : candidate.endsWith(".json") ? "dtcg" : "css";
+        console.log(pc24.dim(`  Detected token source: ${candidate}`));
+      }
+    }
+  }
+  if (detected.tokenIncludes.length === 0) {
+    console.log(pc24.dim("  No token sources auto-detected. You can add them manually."));
+  }
+  const outputPath = resolve15(options.output ?? "fragments.config.ts");
+  const template = generateConfigTemplate({ tokenIncludes: detected.tokenIncludes });
   await writeFile11(outputPath, template, "utf-8");
-  console.log(pc24.green(`\u2713 Created ${outputPath}
+  console.log(pc24.green(`
+\u2713 Created ${outputPath}
 `));
+  if (detected.tokenIncludes.length > 0) {
+    console.log(
+      pc24.dim(`  Token sources configured: ${detected.tokenIncludes.join(", ")}`)
+    );
+  }
+  console.log(
+    pc24.dim("  Run ") + pc24.cyan("fragments govern scan") + pc24.dim(" to check your project.\n")
+  );
 }
 async function governConnect() {
   const { readFile: readFile14, writeFile: writeFile11, appendFile } = await import("fs/promises");
-  const { existsSync: existsSync3 } = await import("fs");
-  const { resolve: resolve14 } = await import("path");
+  const { existsSync: existsSync4 } = await import("fs");
+  const { resolve: resolve15 } = await import("path");
   const { platform } = await import("os");
   const { exec } = await import("child_process");
   const { password, confirm } = await import("@inquirer/prompts");
@@ -6330,9 +6665,9 @@ async function governConnect() {
     default: true
   });
   if (saveToEnv) {
-    const envPath = resolve14(".env");
+    const envPath = resolve15(".env");
     const envEntry = `FRAGMENTS_API_KEY=${apiKey.trim()}`;
-    if (existsSync3(envPath)) {
+    if (existsSync4(envPath)) {
       const envContent = await readFile14(envPath, "utf-8");
       if (envContent.includes("FRAGMENTS_API_KEY=")) {
         const updated = envContent.replace(
@@ -6360,8 +6695,8 @@ ${envEntry}
         console.log(pc24.green(`  \u2713 Added FRAGMENTS_URL to .env`));
       }
     }
-    const gitignorePath = resolve14(".gitignore");
-    if (existsSync3(gitignorePath)) {
+    const gitignorePath = resolve15(".gitignore");
+    if (existsSync4(gitignorePath)) {
       const gitignore = await readFile14(gitignorePath, "utf-8");
       if (!gitignore.split("\n").some((line) => line.trim() === ".env")) {
         await appendFile(gitignorePath, "\n.env\n", "utf-8");
@@ -6429,11 +6764,13 @@ ${BRAND.name} Governance Report
 // src/commands/migrate-contract.ts
 import pc25 from "picocolors";
 import fg4 from "fast-glob";
-import { resolve as resolve13 } from "path";
+import { resolve as resolve14 } from "path";
 
 // src/migrate/fragment-to-contract.ts
 import { readFile as readFile13, writeFile as writeFile10 } from "fs/promises";
-import { resolve as resolve12, dirname as dirname4, relative as relative8 } from "path";
+import { resolve as resolve13, dirname as dirname5, relative as relative8 } from "path";
+import { createComponentExtractor as createComponentExtractor2 } from "@fragments-sdk/extract";
+import { resolveComponentSourcePath as resolveComponentSourcePath2 } from "@fragments-sdk/extract";
 function compilePropsSummaryFromExtracted(props) {
   return Object.entries(props).filter(([, p]) => p.source === "local").map(([name, prop]) => {
     let summary = name + ": ";
@@ -6470,7 +6807,7 @@ function compilePropsSummaryFromDocs(props) {
 }
 async function migrateFragmentToContract(fragmentPath, configDir, options) {
   const warnings = [];
-  const absFragmentPath = resolve12(fragmentPath);
+  const absFragmentPath = resolve13(fragmentPath);
   const content = await readFile13(absFragmentPath, "utf-8");
   const parsed = parseFragmentFile(content, fragmentPath);
   warnings.push(...parsed.warnings);
@@ -6478,10 +6815,10 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
     throw new Error(`Fragment file ${fragmentPath} has no meta.name`);
   }
   let extractedMeta = null;
-  const extractor = createComponentExtractor(options?.tsconfigPath);
+  const extractor = createComponentExtractor2(options?.tsconfigPath);
   try {
     const componentExportName = parsed.componentName ?? parsed.meta.name;
-    const componentSourcePath = resolveComponentSourcePath(
+    const componentSourcePath = resolveComponentSourcePath2(
       absFragmentPath,
       parsed.componentImport
     );
@@ -6497,7 +6834,7 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
   }
   let sourcePath;
   if (parsed.componentImport) {
-    const absSource = resolveComponentSourcePath(absFragmentPath, parsed.componentImport);
+    const absSource = resolveComponentSourcePath2(absFragmentPath, parsed.componentImport);
     if (absSource) {
       sourcePath = relative8(configDir, absSource);
     } else {
@@ -6505,8 +6842,8 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
       warnings.push(`Could not resolve component source path: ${parsed.componentImport}`);
     }
   } else {
-    const fragDir = dirname4(absFragmentPath);
-    sourcePath = relative8(configDir, resolve12(fragDir, "index.tsx"));
+    const fragDir = dirname5(absFragmentPath);
+    sourcePath = relative8(configDir, resolve13(fragDir, "index.tsx"));
     warnings.push("No component import found; assuming ./index.tsx");
   }
   const exportName = parsed.componentName ?? parsed.meta.name;
@@ -6622,7 +6959,7 @@ async function migrateContract(options) {
   let migrated = 0;
   let failed = 0;
   let totalWarnings = 0;
-  const tsconfigPath = options.tsconfig ? resolve13(options.tsconfig) : void 0;
+  const tsconfigPath = options.tsconfig ? resolve14(options.tsconfig) : void 0;
   for (const file of files) {
     try {
       const result = await migrateFragmentToContract(file, configDir, {
@@ -6655,8 +6992,8 @@ async function migrateContract(options) {
 }
 
 // src/bin.ts
-var __dirname = dirname5(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync(join11(__dirname, "../package.json"), "utf-8"));
+var __dirname = dirname6(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync(join12(__dirname, "../package.json"), "utf-8"));
 var EXPERIMENTAL = process.env.FRAGMENTS_EXPERIMENTAL === "1";
 var program = new Command();
 program.name(BRAND.cliCommand).description(`${BRAND.name} - Design system documentation and compliance tool`).version(pkg.version);
@@ -6687,7 +7024,7 @@ program.command("sync").description("Auto-update fragment files from component s
     process.exit(1);
   }
 });
-program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAND.dataDir}/ directory`).option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path").option("--registry", `Also generate ${BRAND.dataDir}/${BRAND.registryFile} and ${BRAND.contextFile}`).option("--registry-only", `Only generate ${BRAND.dataDir}/ directory (skip ${BRAND.outFile})`).option("--from-source", "Build from source code (zero-config, no fragment files needed)").option("--skip-usage", "Skip usage analysis when building from source").option("--skip-storybook", "Skip Storybook parsing when building from source").option("-v, --verbose", "Verbose output").action(async (options) => {
+program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAND.dataDir}/ directory`).option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path").option("--registry", `Also generate ${BRAND.dataDir}/${BRAND.registryFile} and ${BRAND.contextFile}`).option("--registry-only", `Only generate ${BRAND.dataDir}/ directory (skip ${BRAND.outFile})`).option("--from-source", "Build from source code (zero-config, no fragment files needed)").option("--if-needed", `Skip rebuilding when ${BRAND.outFile} is already fresh`).option("--check", `Check whether ${BRAND.outFile} is fresh and exit non-zero if it is stale`).option("--skip-usage", "Skip usage analysis when building from source").option("--skip-storybook", "Skip Storybook parsing when building from source").option("-v, --verbose", "Verbose output").action(async (options) => {
   try {
     const result = await build({
       config: options.config,
@@ -6695,6 +7032,8 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       registry: options.registry,
       registryOnly: options.registryOnly,
       fromSource: options.fromSource,
+      ifNeeded: options.ifNeeded,
+      check: options.check,
       skipUsage: options.skipUsage,
       skipStorybook: options.skipStorybook,
       verbose: options.verbose
@@ -7039,7 +7378,7 @@ Make sure a dev server is running on the expected port.`));
 });
 program.command("view").description(`Generate a static HTML viewer for ${BRAND.outFile}`).option("-i, --input <path>", `Path to ${BRAND.outFile}`, BRAND.outFile).option("-o, --output <path>", "Output HTML file path", BRAND.viewerHtmlFile).option("--open", "Open in browser after generation").action(async (options) => {
   try {
-    const { generateViewerFromJson } = await import("./static-viewer-63PG6FWY.js");
+    const { generateViewerFromJson } = await import("./static-viewer-7QIBQZRC.js");
     const fs2 = await import("fs/promises");
     const path = await import("path");
     const inputPath = path.resolve(process.cwd(), options.input);
@@ -7085,6 +7424,30 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
     process.exit(1);
   }
 });
+program.command("create").argument("[name]", "Project name").description("Create a new project with Fragments UI and your custom theme").option("-t, --template <template>", "Framework template (nextjs, vite)", "nextjs").option("--pm <manager>", "Package manager (npm, pnpm, yarn, bun)").option("--theme <encoded>", "Encoded theme string").option("--preset <id>", "Theme preset ID from usefragments.com/create").option("--brand <color>", "Brand color hex (e.g., #6366f1)").option("--scss", "Use SCSS output (installs sass)").option("--mcp", "Configure MCP server for AI tooling").option("-y, --yes", "Skip interactive prompts").option("--no-git", "Skip git initialization").action(async (name, options) => {
+  try {
+    const { create } = await import("./create-IH4R45GE.js");
+    const result = await create({
+      name,
+      template: options.template,
+      packageManager: options.pm,
+      theme: options.theme,
+      preset: options.preset,
+      brand: options.brand,
+      scss: options.scss,
+      mcp: options.mcp,
+      yes: options.yes,
+      noGit: !options.git
+    });
+    if (!result.success) {
+      if (result.error) console.error(pc26.red(`Error: ${result.error}`));
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.command("setup").description("Configure @fragments-sdk/ui in a consumer project (styles, providers, Next.js config)").option("--root <dir>", "Project root directory", process.cwd()).option("-y, --yes", "Skip interactive prompts").option("--brand <color>", "Brand color hex (e.g., #6366f1)").option("--scss", "Create SCSS seed file for build-time theming").option("--mcp", "Configure MCP server for AI tooling").action(async (options) => {
   try {
     const result = await setup({
@@ -7116,7 +7479,7 @@ initCmd.action(async (options) => {
 `));
         process.exit(1);
       }
-      const { initCloud } = await import("./init-cloud-MQ6GRJAZ.js");
+      const { initCloud } = await import("./init-cloud-3DNKPWFB.js");
       await initCloud({
         url: options.cloudUrl,
         port: options.port ? Number(options.port) : void 0,
@@ -7125,7 +7488,7 @@ initCmd.action(async (options) => {
       });
       return;
     }
-    const { init } = await import("./init-HGSM35XA.js");
+    const { init } = await import("./init-SSGUSP7Z.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -7154,7 +7517,7 @@ initCmd.action(async (options) => {
 });
 program.command("snapshot").description("Run visual snapshot tests per component variant").option("-p, --port <port>", "Port of running dev server (skips starting one)").option("--update", "Update existing snapshots instead of comparing").option("--component <name>", "Filter to a specific component").option("--spec <path>", "Path to snapshot spec file").option("--ci", "CI mode - exit 1 on mismatch").action(async (options) => {
   try {
-    const { snapshot } = await import("./snapshot-KQEQ6XHL.js");
+    const { snapshot } = await import("./snapshot-WIJMEIFT.js");
     const result = await snapshot({
       port: options.port,
       update: options.update,
@@ -7173,7 +7536,7 @@ program.command("snapshot").description("Run visual snapshot tests per component
 var tokensCmd = program.command("tokens").description("Design token discovery, listing, and generation");
 tokensCmd.command("list", { isDefault: true }).description("Discover and list design tokens from CSS/SCSS/DTCG files").option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--categories", "Group tokens by category").option("--theme <theme>", "Filter by theme name").option("--category <category>", "Filter by category (color, spacing, typography, etc.)").option("--verbose", "Show all tokens (no truncation)").action(async (options) => {
   try {
-    const { tokens } = await import("./tokens-6GYKDV6U.js");
+    const { tokens } = await import("./tokens-NZWFQIAB.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -7192,7 +7555,7 @@ tokensCmd.command("list", { isDefault: true }).description("Discover and list de
 });
 tokensCmd.command("generate").description("Generate CSS, SCSS, Tailwind, or Figma output from a DTCG .tokens.json file").requiredOption("--from <path>", "Path to DTCG .tokens.json source file").requiredOption("--format <formats>", "Output formats (comma-separated: css, scss, tailwind, figma)").option("--out <dir>", "Output directory (default: same directory as source)").option("--prefix <prefix>", "Token name prefix").option("--selector <selector>", "CSS selector for custom properties (default: :root)").option("--verbose", "Verbose output").action(async (options) => {
   try {
-    const { tokensGenerate } = await import("./tokens-generate-VTZV5EEW.js");
+    const { tokensGenerate } = await import("./tokens-generate-5JQSJ27E.js");
     await tokensGenerate({
       from: options.from,
       format: options.format,
@@ -7206,9 +7569,23 @@ tokensCmd.command("generate").description("Generate CSS, SCSS, Tailwind, or Figm
     process.exit(1);
   }
 });
+tokensCmd.command("push").description("Push code tokens to Fragments Cloud for drift comparison").option("-c, --config <path>", "Path to fragments config file").option("--tailwind-v4 <path>", "Path to Tailwind v4 CSS file with @theme block").option("--dry-run", "Parse and display tokens without pushing").option("--verbose", "Show detailed output").action(async (options) => {
+  try {
+    const { tokensPush } = await import("./tokens-push-HY3KO36V.js");
+    await tokensPush({
+      config: options.config,
+      tailwindV4: options.tailwindV4,
+      dryRun: options.dryRun,
+      verbose: options.verbose
+    });
+  } catch (error) {
+    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.command("generate").description("Generate fragment files from component source code").argument("[component]", "Specific component name to generate (optional)").option("--force", "Overwrite existing fragment files").option("--pattern <glob>", "Pattern for component files", "src/components/**/*.tsx").action(async (component, options) => {
   try {
-    const { generate } = await import("./generate-A4FP5426.js");
+    const { generate } = await import("./generate-PVOLUAAC.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -7291,7 +7668,7 @@ program.command("perf").description("Profile component bundle sizes and performa
 program.command("test").description("Run interaction tests for fragments with play functions").option("-c, --config <path>", "Path to config file").option("--component <name>", "Filter by component name").option("--tags <tags>", "Filter by tags (comma-separated)").option("--grep <pattern>", "Filter by variant name pattern").option("--exclude <pattern>", "Exclude tests matching pattern").option("--parallel <count>", "Number of parallel browser contexts", parseInt, 4).option("--timeout <ms>", "Timeout per test in milliseconds", parseInt, 3e4).option("--retries <count>", "Number of retries for failed tests", parseInt, 0).option("--bail", "Stop on first failure").option("--browser <name>", "Browser to use (chromium, firefox, webkit)", "chromium").option("--headed", "Run in headed mode (show browser)").option("--a11y", "Run accessibility checks with axe-core").option("--visual", "Capture screenshots for visual regression").option("--update-snapshots", "Update visual snapshots").option("--watch", "Watch mode - re-run on file changes").option("--reporters <names>", "Reporters to use (console, junit, json)", "console").option("-o, --output <dir>", "Output directory for results", "./test-results").option("--server-url <url>", "URL of running dev server (skips starting server)").option("-p, --port <port>", "Port for dev server", parseInt, 6006).option("--ci", "CI mode - non-interactive, exit with code 1 on failure").option("--list", "List available tests without running them").action(async (options) => {
   try {
     const { config, configDir } = await loadConfig(options.config);
-    const { runTestCommand, listTests } = await import("./test-UQYUCZIS.js");
+    const { runTestCommand, listTests } = await import("./test-64Z5BKBA.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -7392,7 +7769,7 @@ governCmd.command("connect").description("Connect your project to the Fragments
 });
 governCmd.command("scan").description("Scan JSX/TSX codebase for governance violations").option("-d, --dir <path>", "Root directory (default: auto-detect)").option("-c, --config <path>", "Path to govern.config.ts").option("-f, --format <format>", "Output format: summary, json, sarif", "summary").option("-q, --quiet", "Suppress non-error output").action(async (options) => {
   try {
-    const { governScan } = await import("./govern-scan-UCBZR6D6.js");
+    const { governScan } = await import("./govern-scan-OYFZYOQW.js");
     const { exitCode } = await governScan({
       dir: options.dir,
       config: options.config,
@@ -7407,7 +7784,7 @@ governCmd.command("scan").description("Scan JSX/TSX codebase for governance viol
 });
 governCmd.command("watch").description("Watch JSX/TSX files and re-check on changes").option("-d, --dir <path>", "Root directory (default: auto-detect)").option("-c, --config <path>", "Path to govern.config.ts").option("-q, --quiet", "Suppress non-error output").option("--debounce <ms>", "Debounce interval in ms", "300").action(async (options) => {
   try {
-    const { governWatch } = await import("./govern-scan-UCBZR6D6.js");
+    const { governWatch } = await import("./govern-scan-OYFZYOQW.js");
     await governWatch({
       dir: options.dir,
       config: options.config,
@@ -7419,5 +7796,20 @@ governCmd.command("watch").description("Watch JSX/TSX files and re-check on chan
     process.exit(1);
   }
 });
+governCmd.command("push-contracts").description("Push component contracts to Fragments Cloud").option("-i, --input <path>", "Path to fragments.json (default: ./fragments.json)").option("--url <url>", "Fragments Cloud URL").option("--api-key <key>", "API key (default: FRAGMENTS_API_KEY env var)").option("-q, --quiet", "Suppress non-error output").action(async (options) => {
+  try {
+    const { pushContracts } = await import("./push-contracts-WY32TFP6.js");
+    const { exitCode } = await pushContracts({
+      input: options.input,
+      url: options.url,
+      apiKey: options.apiKey,
+      quiet: options.quiet
+    });
+    process.exit(exitCode);
+  } catch (error) {
+    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
 program.parse();
 //# sourceMappingURL=bin.js.map