@fragments-sdk/cli 0.9.0 → 0.10.0

package/dist/bin.js

@@ -12,17 +12,17 @@ import {
   validateCoverage,
   validateSchema,
   validateSnippets
-} from "./chunk-2JIKCJX3.js";
+} from "./chunk-ZDA3PLQ6.js";
 import {
   scan
-} from "./chunk-WI6SLMSO.js";
+} from "./chunk-CAMXG5HJ.js";
 import {
   loadConfig,
   loadFragmentFile
-} from "./chunk-CJEGT3WD.js";
+} from "./chunk-566BNPQZ.js";
 import {
   discoverFragmentFiles
-} from "./chunk-AWYCDRPG.js";
+} from "./chunk-WXSR2II7.js";
 import {
   FigmaClient,
   StorageManager,
@@ -38,25 +38,23 @@ import {
   renderAllComponentVariants,
   scanCodebase,
   shutdownSharedPool
-} from "./chunk-YMPGYEWK.js";
+} from "./chunk-D5PYOXEI.js";
+import "./chunk-D2CDBRNU.js";
 import {
+  BRAND,
   budgetBar,
   formatBytes,
   generateContext,
   resolvePerformanceConfig
-} from "./chunk-NGIMCIK2.js";
-import "./chunk-GOVI6COW.js";
-import {
-  BRAND
-} from "./chunk-EKLMXTWU.js";
+} from "./chunk-OQO55NKV.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
 import { Command } from "commander";
-import pc23 from "picocolors";
+import pc24 from "picocolors";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname4, join as join11 } from "path";
+import { dirname as dirname5, join as join12 } from "path";
 
 // src/commands/validate.ts
 import pc from "picocolors";
@@ -176,9 +174,20 @@ ${BRAND.name} Build
     }
     fragmentCount = result.fragmentCount;
     outputPath = result.outputPath;
-    console.log(pc2.green(`\u2713 Built ${result.fragmentCount} fragment(s)`));
-    console.log(pc2.dim(`  Output: ${result.outputPath}
+    if (result.fragmentCount === 0 && result.errors.length === 0) {
+      console.log(pc2.dim("No compilable fragment files found. Falling back to source scan...\n"));
+      const scanResult = await scan({
+        config: options.config,
+        output: options.output,
+        verbose: options.verbose
+      });
+      fragmentCount = scanResult.componentCount;
+      outputPath = scanResult.outputPath;
+    } else {
+      console.log(pc2.green(`\u2713 Built ${result.fragmentCount} fragment(s)`));
+      console.log(pc2.dim(`  Output: ${result.outputPath}
 `));
+    }
   }
   if (options.registry || options.registryOnly) {
     console.log(pc2.dim("Generating registry and context...\n"));
@@ -602,6 +611,7 @@ function parseMeta(content, filePath, warnings) {
     );
     if (importMatch) {
       result.componentImport = importMatch[1];
+      result.isDefaultImport = false;
     } else {
       const defaultImportMatch = content.match(
         new RegExp(
@@ -610,6 +620,7 @@ function parseMeta(content, filePath, warnings) {
       );
       if (defaultImportMatch) {
         result.componentImport = defaultImportMatch[1];
+        result.isDefaultImport = true;
       }
     }
   }
@@ -1199,6 +1210,7 @@ function convertToFragment(parsed) {
   const code = generateFragmentCode({
     componentName,
     componentImport: parsed.meta.componentImport,
+    isDefaultImport: parsed.meta.isDefaultImport,
     description: parsed.meta.description,
     category,
     tags: parsed.meta.tags,
@@ -1434,6 +1446,7 @@ function generateFragmentCode(options) {
   const {
     componentName,
     componentImport,
+    isDefaultImport,
     description,
     category,
     tags,
@@ -1461,8 +1474,9 @@ ${generated.skippedVariants.map((sv) => `      { name: "${escapeString(sv.name)}
   },
 `;
   }
+  const componentImportStatement = isDefaultImport ? `import ${componentName} from "${componentImport}";` : `import { ${componentName} } from "${componentImport}";`;
   return `import { defineFragment } from "@fragments-sdk/cli/core";
-import { ${componentName} } from "${componentImport}";
+${componentImportStatement}
 
 export default defineFragment({
   component: ${componentName},
@@ -1717,27 +1731,48 @@ async function runSetup(options = {}) {
       const sbConfig = await detectStorybookConfig(configDir);
       if (sbConfig) {
         log(pc6.dim(`   Found Storybook at ${sbConfig.configPath}`));
-        log(pc6.dim("   Converting stories to fragments...\n"));
-        const storyFiles = await discoverStoryFiles(configDir, sbConfig.storyPatterns);
-        if (storyFiles.length > 0) {
-          let converted = 0;
-          for (const storyFile of storyFiles) {
-            try {
-              const parsed = await parseStoryFile(storyFile);
-              const fragmentResult = convertToFragment(parsed);
-              await fs2.mkdir(path.dirname(fragmentResult.outputFile), { recursive: true });
-              await fs2.writeFile(fragmentResult.outputFile, fragmentResult.code);
-              converted++;
-            } catch {
+        const hasStoryPatterns = config.include.some((p) => p.includes(".stories."));
+        if (hasStoryPatterns) {
+          log(pc6.dim("   Stories included in config \u2014 viewer will load them directly\n"));
+          fragmentFiles = await discoverFragmentFiles(config, configDir);
+          if (fragmentFiles.length > 0) {
+            log(pc6.green(`   Found ${fragmentFiles.length} story/fragment file(s)`));
+          }
+        } else {
+          log(pc6.dim("   Converting stories to fragments...\n"));
+          const storyFiles = await discoverStoryFiles(configDir, sbConfig.storyPatterns);
+          if (storyFiles.length > 0) {
+            let converted = 0;
+            for (const storyFile of storyFiles) {
+              try {
+                const parsed = await parseStoryFile(storyFile);
+                const fragmentResult = convertToFragment(parsed);
+                await fs2.mkdir(path.dirname(fragmentResult.outputFile), { recursive: true });
+                await fs2.writeFile(fragmentResult.outputFile, fragmentResult.code);
+                converted++;
+              } catch {
+              }
             }
+            result.fragmentFilesCreated = converted;
+            log(pc6.green(`   Generated ${converted} fragment file(s)`));
+            fragmentFiles = await discoverFragmentFiles(config, configDir);
           }
-          result.fragmentFilesCreated = converted;
-          log(pc6.green(`   Generated ${converted} fragment file(s)`));
-          fragmentFiles = await discoverFragmentFiles(config, configDir);
         }
       } else {
         log(pc6.dim("   No Storybook config found"));
-        log(pc6.dim(`   Run ${pc6.cyan(`${BRAND.cliCommand} add <ComponentName>`)} to create your first fragment`));
+        log(pc6.dim("   Auto-scanning source code...\n"));
+        try {
+          const scanResult = await scan({
+            config: options.configPath,
+            verbose: false
+          });
+          if (scanResult.componentCount > 0) {
+            result.fragmentsBuilt = scanResult.componentCount;
+            log(pc6.green(`   Scanned ${scanResult.componentCount} component(s) from source`));
+          }
+        } catch {
+          log(pc6.dim(`   Run ${pc6.cyan(`${BRAND.cliCommand} scan`)} to generate documentation from source`));
+        }
       }
     } else if (fragmentFiles.length > 0) {
       log(pc6.green(`   Found ${fragmentFiles.length} fragment file(s)`));
@@ -1757,7 +1792,19 @@ ${reason} ${BRAND.outFile}...`));
               result.errors.push(`${err.file}: ${err.error}`);
             }
           }
-          log(pc6.green(`   Built ${buildResult.fragmentCount} fragment(s)`));
+          if (buildResult.fragmentCount > 0) {
+            log(pc6.green(`   Built ${buildResult.fragmentCount} fragment(s)`));
+          } else {
+            log(pc6.dim("   No compilable fragments found, falling back to source scan..."));
+            try {
+              const scanResult = await scan({ verbose: false });
+              if (scanResult.componentCount > 0) {
+                result.fragmentsBuilt = scanResult.componentCount;
+                log(pc6.green(`   Scanned ${scanResult.componentCount} component(s) from source`));
+              }
+            } catch {
+            }
+          }
         } catch (error) {
           result.errors.push(`Build failed: ${error instanceof Error ? error.message : "Unknown error"}`);
         }
@@ -1811,7 +1858,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-SBTJDMP7.js");
+  const { createDevServer } = await import("./viewer-DBEPYM3G.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -5738,9 +5785,362 @@ ${BRAND.name} Doctor
   return result;
 }
 
+// src/commands/setup.ts
+import { readFile as readFile9, writeFile as writeFile9, access as access4, mkdir as mkdir7 } from "fs/promises";
+import { join as join11, resolve as resolve9, dirname as dirname4 } from "path";
+import pc23 from "picocolors";
+async function fileExists(path) {
+  try {
+    await access4(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectFramework(root) {
+  if (await fileExists(join11(root, "app/layout.tsx")) || await fileExists(join11(root, "src/app/layout.tsx"))) {
+    return "nextjs-app";
+  }
+  if (await fileExists(join11(root, "pages/_app.tsx")) || await fileExists(join11(root, "pages/_app.ts"))) {
+    return "nextjs-pages";
+  }
+  if (await fileExists(join11(root, "next.config.ts")) || await fileExists(join11(root, "next.config.js")) || await fileExists(join11(root, "next.config.mjs"))) {
+    return "nextjs-app";
+  }
+  if (await fileExists(join11(root, "vite.config.ts")) || await fileExists(join11(root, "vite.config.js"))) {
+    return "vite";
+  }
+  return "unknown";
+}
+async function findEntryFile(root, framework) {
+  const candidates = [];
+  switch (framework) {
+    case "nextjs-app":
+      candidates.push(
+        "src/app/layout.tsx",
+        "app/layout.tsx",
+        "src/app/layout.ts",
+        "app/layout.ts"
+      );
+      break;
+    case "nextjs-pages":
+      candidates.push("pages/_app.tsx", "pages/_app.ts");
+      break;
+    case "vite":
+      candidates.push(
+        "src/main.tsx",
+        "src/main.ts",
+        "src/index.tsx",
+        "src/index.ts"
+      );
+      break;
+    default:
+      candidates.push(
+        "src/main.tsx",
+        "src/main.ts",
+        "src/index.tsx",
+        "src/index.ts",
+        "src/App.tsx",
+        "src/App.ts"
+      );
+  }
+  for (const candidate of candidates) {
+    if (await fileExists(join11(root, candidate))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+async function findNextConfig(root) {
+  const candidates = ["next.config.ts", "next.config.mjs", "next.config.js"];
+  for (const candidate of candidates) {
+    if (await fileExists(join11(root, candidate))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+async function addStylesImport(root, entryFile) {
+  const fullPath = join11(root, entryFile);
+  const content = await readFile9(fullPath, "utf-8");
+  if (content.includes("@fragments-sdk/ui/styles")) {
+    return { modified: false, message: `Styles already imported in ${entryFile}` };
+  }
+  const stylesImport = "import '@fragments-sdk/ui/styles';";
+  let newContent;
+  if (content.startsWith("'use client'") || content.startsWith('"use client"')) {
+    const directiveEnd = content.indexOf("\n") + 1;
+    newContent = content.slice(0, directiveEnd) + stylesImport + "\n" + content.slice(directiveEnd);
+  } else {
+    newContent = stylesImport + "\n" + content;
+  }
+  await writeFile9(fullPath, newContent, "utf-8");
+  return { modified: true, message: `Added styles import to ${entryFile}` };
+}
+async function addThemeProvider(root, entryFile, framework) {
+  const fullPath = join11(root, entryFile);
+  const content = await readFile9(fullPath, "utf-8");
+  if (content.includes("ThemeProvider")) {
+    return { modified: false, message: `ThemeProvider already present in ${entryFile}` };
+  }
+  if (framework === "nextjs-app") {
+    const providerImport = "import { ThemeProvider, TooltipProvider, ToastProvider } from '@fragments-sdk/ui';";
+    let newContent = content;
+    const importLines = content.split("\n");
+    let lastImportIdx = -1;
+    for (let i = 0; i < importLines.length; i++) {
+      if (importLines[i].startsWith("import ") || importLines[i].startsWith("import '") || importLines[i].startsWith('import "')) {
+        lastImportIdx = i;
+      }
+    }
+    if (lastImportIdx >= 0) {
+      importLines.splice(lastImportIdx + 1, 0, providerImport);
+      newContent = importLines.join("\n");
+    } else {
+      newContent = providerImport + "\n" + content;
+    }
+    if (!content.includes("suppressHydrationWarning")) {
+      await writeFile9(fullPath, newContent, "utf-8");
+      return {
+        modified: true,
+        message: `Added provider imports to ${entryFile}. Wrap your {children} with:
+    <ThemeProvider defaultMode="system"><TooltipProvider><ToastProvider>{children}</ToastProvider></TooltipProvider></ThemeProvider>
+    Add suppressHydrationWarning to your <html> tag`
+      };
+    }
+    await writeFile9(fullPath, newContent, "utf-8");
+    return { modified: true, message: `Added provider imports to ${entryFile}. Wrap {children} with ThemeProvider.` };
+  }
+  return { modified: false, message: "Manual ThemeProvider setup needed \u2014 see https://usefragments.com/getting-started#provider-setup" };
+}
+async function addTranspilePackages(root) {
+  const configFile = await findNextConfig(root);
+  if (!configFile) {
+    return { modified: false, message: "No next.config found" };
+  }
+  const fullPath = join11(root, configFile);
+  const content = await readFile9(fullPath, "utf-8");
+  if (content.includes("transpilePackages") && content.includes("@fragments-sdk/ui")) {
+    return { modified: false, message: `transpilePackages already configured in ${configFile}` };
+  }
+  if (content.includes("transpilePackages")) {
+    return {
+      modified: false,
+      message: `transpilePackages found in ${configFile} but missing '@fragments-sdk/ui'. Please add it manually.`
+    };
+  }
+  const patterns = [
+    // const nextConfig = { ... }
+    { search: /const\s+\w+\s*=\s*\{/, replacement: (match) => `${match}
+  transpilePackages: ['@fragments-sdk/ui'],` },
+    // module.exports = { ... }
+    { search: /module\.exports\s*=\s*\{/, replacement: (match) => `${match}
+  transpilePackages: ['@fragments-sdk/ui'],` },
+    // export default { ... }
+    { search: /export\s+default\s*\{/, replacement: (match) => `${match}
+  transpilePackages: ['@fragments-sdk/ui'],` }
+  ];
+  for (const pattern of patterns) {
+    if (pattern.search.test(content)) {
+      const newContent = content.replace(pattern.search, pattern.replacement);
+      await writeFile9(fullPath, newContent, "utf-8");
+      return { modified: true, message: `Added transpilePackages to ${configFile}` };
+    }
+  }
+  return {
+    modified: false,
+    message: `Could not auto-modify ${configFile}. Add transpilePackages: ['@fragments-sdk/ui'] manually.`
+  };
+}
+async function createScssSeeds(root, brand) {
+  const scssLocations = [
+    "src/app/globals.scss",
+    "app/globals.scss",
+    "src/styles/globals.scss",
+    "src/globals.scss",
+    "styles/globals.scss"
+  ];
+  for (const loc of scssLocations) {
+    const fullPath2 = join11(root, loc);
+    if (await fileExists(fullPath2)) {
+      const content = await readFile9(fullPath2, "utf-8");
+      if (content.includes("@fragments-sdk/ui/styles")) {
+        return { modified: false, message: `SCSS seeds already configured in ${loc}` };
+      }
+      const seedContent = generateScssSeedImport(brand);
+      const newContent = seedContent + "\n" + content;
+      await writeFile9(fullPath2, newContent, "utf-8");
+      return { modified: true, message: `Added SCSS seed import to ${loc}` };
+    }
+  }
+  const targetDir = await fileExists(join11(root, "src/app")) ? "src/app" : await fileExists(join11(root, "src")) ? "src/styles" : "styles";
+  const targetPath = join11(targetDir, "globals.scss");
+  const fullPath = join11(root, targetPath);
+  await mkdir7(dirname4(fullPath), { recursive: true });
+  await writeFile9(fullPath, generateScssSeedImport(brand), "utf-8");
+  return { modified: true, message: `Created ${targetPath} with SCSS seed configuration` };
+}
+async function setupMcpConfig(root) {
+  const mcpConfigPaths = [
+    ".cursor/mcp.json",
+    ".vscode/mcp.json"
+  ];
+  for (const configPath of mcpConfigPaths) {
+    const fullPath = join11(root, configPath);
+    if (await fileExists(fullPath)) {
+      try {
+        const content = await readFile9(fullPath, "utf-8");
+        const config = JSON.parse(content);
+        const servers = config.mcpServers || {};
+        const hasFragments = Object.values(servers).some((server) => {
+          const s = server;
+          return s.args?.some((arg) => arg.includes("@fragments-sdk/mcp"));
+        });
+        if (hasFragments) {
+          return { modified: false, message: `MCP server already configured in ${configPath}` };
+        }
+        servers.fragments = {
+          command: "npx",
+          args: ["@fragments-sdk/mcp"]
+        };
+        config.mcpServers = servers;
+        await writeFile9(fullPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        return { modified: true, message: `Added Fragments MCP server to ${configPath}` };
+      } catch {
+        return { modified: false, message: `Could not parse ${configPath}` };
+      }
+    }
+  }
+  const cursorDir = join11(root, ".cursor");
+  const cursorMcpPath = join11(cursorDir, "mcp.json");
+  await mkdir7(cursorDir, { recursive: true });
+  const mcpConfig = {
+    mcpServers: {
+      fragments: {
+        command: "npx",
+        args: ["@fragments-sdk/mcp"]
+      }
+    }
+  };
+  await writeFile9(cursorMcpPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
+  return { modified: true, message: "Created .cursor/mcp.json with Fragments MCP server" };
+}
+function generateScssSeedImport(brand) {
+  const brandColor = brand || "#0066ff";
+  return `@use '@fragments-sdk/ui/styles' with (
+  $fui-brand: ${brandColor},
+  $fui-neutral: "stone",
+  $fui-density: "default",
+  $fui-radius-style: "rounded"
+);
+`;
+}
+async function setup(options = {}) {
+  const root = resolve9(options.root ?? process.cwd());
+  const actions = [];
+  const errors = [];
+  console.log(pc23.cyan(`
+${BRAND.name} Setup
+`));
+  const framework = await detectFramework(root);
+  const frameworkLabel = framework === "nextjs-app" ? "Next.js (App Router)" : framework === "nextjs-pages" ? "Next.js (Pages Router)" : framework === "vite" ? "Vite" : "Unknown";
+  console.log(`  ${pc23.dim("Framework:")} ${frameworkLabel}`);
+  const entryFile = await findEntryFile(root, framework);
+  if (entryFile) {
+    console.log(`  ${pc23.dim("Entry:")} ${entryFile}`);
+  } else {
+    console.log(`  ${pc23.yellow("!")} Could not detect entry file`);
+  }
+  console.log();
+  if (entryFile) {
+    try {
+      const result = await addStylesImport(root, entryFile);
+      const icon = result.modified ? pc23.green("+") : pc23.dim("\xB7");
+      console.log(`  ${icon} ${result.message}`);
+      if (result.modified) actions.push(result.message);
+    } catch (error) {
+      const msg = `Failed to add styles import: ${error instanceof Error ? error.message : error}`;
+      console.log(`  ${pc23.red("\u2717")} ${msg}`);
+      errors.push(msg);
+    }
+  }
+  if (entryFile) {
+    try {
+      const result = await addThemeProvider(root, entryFile, framework);
+      const icon = result.modified ? pc23.green("+") : pc23.dim("\xB7");
+      console.log(`  ${icon} ${result.message}`);
+      if (result.modified) actions.push(result.message);
+    } catch (error) {
+      const msg = `Failed to add ThemeProvider: ${error instanceof Error ? error.message : error}`;
+      console.log(`  ${pc23.red("\u2717")} ${msg}`);
+      errors.push(msg);
+    }
+  }
+  if (framework === "nextjs-app" || framework === "nextjs-pages") {
+    try {
+      const result = await addTranspilePackages(root);
+      const icon = result.modified ? pc23.green("+") : pc23.dim("\xB7");
+      console.log(`  ${icon} ${result.message}`);
+      if (result.modified) actions.push(result.message);
+    } catch (error) {
+      const msg = `Failed to update next.config: ${error instanceof Error ? error.message : error}`;
+      console.log(`  ${pc23.red("\u2717")} ${msg}`);
+      errors.push(msg);
+    }
+  }
+  if (options.scss || options.brand) {
+    try {
+      const result = await createScssSeeds(root, options.brand);
+      const icon = result.modified ? pc23.green("+") : pc23.dim("\xB7");
+      console.log(`  ${icon} ${result.message}`);
+      if (result.modified) actions.push(result.message);
+    } catch (error) {
+      const msg = `Failed to create SCSS seeds: ${error instanceof Error ? error.message : error}`;
+      console.log(`  ${pc23.red("\u2717")} ${msg}`);
+      errors.push(msg);
+    }
+  }
+  if (options.mcp) {
+    try {
+      const result = await setupMcpConfig(root);
+      const icon = result.modified ? pc23.green("+") : pc23.dim("\xB7");
+      console.log(`  ${icon} ${result.message}`);
+      if (result.modified) actions.push(result.message);
+    } catch (error) {
+      const msg = `Failed to configure MCP: ${error instanceof Error ? error.message : error}`;
+      console.log(`  ${pc23.red("\u2717")} ${msg}`);
+      errors.push(msg);
+    }
+  }
+  console.log();
+  if (errors.length > 0) {
+    console.log(pc23.red(`  ${errors.length} error(s) occurred during setup`));
+  } else if (actions.length > 0) {
+    console.log(pc23.green(`  \u2713 Setup complete \u2014 ${actions.length} file(s) modified`));
+  } else {
+    console.log(pc23.green("  \u2713 Already configured \u2014 no changes needed"));
+  }
+  console.log();
+  console.log(pc23.dim("  Next steps:"));
+  if (!options.scss && !options.brand) {
+    console.log(pc23.dim("    \u2022 Run with --scss to add build-time theme seeds"));
+  }
+  if (!options.mcp) {
+    console.log(pc23.dim("    \u2022 Run with --mcp to configure AI tooling (MCP server)"));
+  }
+  console.log(pc23.dim("    \u2022 Run `fragments doctor` to verify your setup"));
+  console.log(pc23.dim("    \u2022 Visit https://usefragments.com/getting-started"));
+  console.log();
+  return {
+    success: errors.length === 0,
+    actions,
+    errors
+  };
+}
+
 // src/bin.ts
-var __dirname = dirname4(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync(join11(__dirname, "../package.json"), "utf-8"));
+var __dirname = dirname5(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync(join12(__dirname, "../package.json"), "utf-8"));
 var program = new Command();
 program.name(BRAND.cliCommand).description(`${BRAND.name} - Design system documentation and compliance tool`).version(pkg.version);
 program.command("validate").description("Validate fragment files").option("-c, --config <path>", "Path to config file").option("--schema", "Validate fragment schema only").option("--coverage", "Validate coverage only").option("--snippets", "Validate snippet/render policy only").option("--snippet-mode <mode>", "Override snippet policy mode (warn|error)").option("--component-start <name>", "Start component name for alphabetical snippet batch validation").option("--component-limit <n>", "Component count for alphabetical snippet batch validation", (value) => Number.parseInt(value, 10)).action(async (options) => {
@@ -5750,7 +6150,7 @@ program.command("validate").description("Validate fragment files").option("-c, -
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5770,7 +6170,7 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5789,7 +6189,7 @@ program.command("context").description("Generate AI-ready context for your desig
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5816,7 +6216,7 @@ program.command("ai").description("Generate context optimized for AI assistants
       }
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5824,7 +6224,7 @@ program.command("list").description("List all discovered fragment files").option
   try {
     await list(options);
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5832,7 +6232,7 @@ program.command("reset").description("Reset to initial state (delete all generat
   try {
     await reset(options);
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5846,7 +6246,7 @@ linkCommand.command("figma").argument("[figma-url]", "Figma file URL to link com
       variants: options.variants
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5861,7 +6261,7 @@ linkCommand.command("storybook").description("Bootstrap fragments from existing
       exclude: options.exclude
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5876,9 +6276,9 @@ program.command("dev").description("Start the development server with live compo
       skipBuild: options.skipBuild
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     if (error instanceof Error && error.stack) {
-      console.error(pc23.dim(error.stack));
+      console.error(pc24.dim(error.stack));
     }
     process.exit(1);
   }
@@ -5899,7 +6299,7 @@ program.command("screenshot").description("Capture screenshots of component vari
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5918,7 +6318,7 @@ program.command("diff").argument("[component]", "Component name to diff (optiona
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5937,8 +6337,8 @@ program.command("compare").argument("[component]", "Component name to compare").
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
-    console.log(pc23.dim(`
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.log(pc24.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     process.exit(1);
   }
@@ -5957,7 +6357,7 @@ program.command("analyze").description("Analyze design system and generate repor
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5976,7 +6376,7 @@ program.command("verify").argument("[component]", "Component name to verify (opt
     if (options.ci) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Verification failed" }));
     } else {
-      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -5993,7 +6393,7 @@ program.command("audit").description("Scan all fragments and show compliance met
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Audit failed" }));
     } else {
-      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6015,7 +6415,7 @@ program.command("a11y").description("Run accessibility checks on all component v
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "A11y check failed" }));
     } else {
-      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6038,7 +6438,7 @@ program.command("enhance").description("AI-powered documentation generation from
     if (options.format === "json") {
       console.log(JSON.stringify({ success: false, error: error instanceof Error ? error.message : "Enhance failed" }));
     } else {
-      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6059,7 +6459,7 @@ program.command("scan").description(`Zero-config ${BRAND.outFile} generation fro
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6072,7 +6472,7 @@ program.command("storygen").description("Generate Storybook stories from fragmen
       format: options.format
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6084,7 +6484,7 @@ program.command("metrics").argument("[component]", "Component name (optional, sh
       json: options.json
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6098,9 +6498,9 @@ program.command("baseline").description("Manage visual regression baselines").ar
       port: options.port
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     if (action === "update") {
-      console.log(pc23.dim(`
+      console.log(pc24.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     }
     process.exit(1);
@@ -6108,27 +6508,27 @@ Make sure the dev server is running: ${BRAND.cliCommand} dev`));
 });
 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-NSODM5VX.js");
+    const { generateViewerFromJson } = await import("./static-viewer-NUBFPKWH.js");
     const fs2 = await import("fs/promises");
     const path = await import("path");
     const inputPath = path.resolve(process.cwd(), options.input);
     const outputPath = path.resolve(process.cwd(), options.output);
-    console.log(pc23.cyan(`
+    console.log(pc24.cyan(`
 ${BRAND.name} Viewer Generator
 `));
     try {
       await fs2.access(inputPath);
     } catch {
-      console.log(pc23.red(`Error: ${options.input} not found.`));
-      console.log(pc23.dim(`
-Run ${pc23.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
+      console.log(pc24.red(`Error: ${options.input} not found.`));
+      console.log(pc24.dim(`
+Run ${pc24.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
 `));
       process.exit(1);
     }
-    console.log(pc23.dim(`Reading: ${options.input}`));
+    console.log(pc24.dim(`Reading: ${options.input}`));
     const html = await generateViewerFromJson(inputPath);
     await fs2.writeFile(outputPath, html);
-    console.log(pc23.green(`
+    console.log(pc24.green(`
 \u2713 Generated: ${options.output}
 `));
     if (options.open) {
@@ -6137,7 +6537,7 @@ Run ${pc23.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
       exec(`${openCmd} "${outputPath}"`);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6150,33 +6550,51 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
       component: options.component
     });
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.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({
+      root: options.root,
+      yes: options.yes,
+      brand: options.brand,
+      scss: options.scss,
+      mcp: options.mcp
+    });
+    if (!result.success) {
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("init").description("Initialize fragments in a project (interactive by default)").option("--force", "Overwrite existing config").option("-y, --yes", "Non-interactive mode - auto-detect and use defaults").action(async (options) => {
+program.command("init").description("Initialize fragments in a project (interactive by default)").option("--force", "Overwrite existing config").option("-y, --yes", "Non-interactive mode - auto-detect and use defaults").option("--scan <path>", "Scan a TypeScript component directory and generate fragment files").action(async (options) => {
   try {
-    const { init } = await import("./init-KSAAS7X3.js");
+    const { init } = await import("./init-Q53R5Q2T.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
-      yes: options.yes
+      yes: options.scan ? true : options.yes,
+      scan: options.scan
     });
     if (!result.success) {
-      console.error(pc23.red("\nInit failed with errors:"));
+      console.error(pc24.red("\nInit failed with errors:"));
       for (const error of result.errors) {
-        console.error(pc23.red(`  - ${error}`));
+        console.error(pc24.red(`  - ${error}`));
       }
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("tokens").description("Discover and list design tokens from CSS/SCSS 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-NIXSZRX7.js");
+    const { tokens } = await import("./tokens-DXEGYTOJ.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -6189,13 +6607,13 @@ program.command("tokens").description("Discover and list design tokens from CSS/
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.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-35OIMW4Y.js");
+    const { generate } = await import("./generate-BGKTKO6E.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -6203,11 +6621,11 @@ program.command("generate").description("Generate fragment files from component
       componentPattern: options.pattern
     });
     if (!result.success) {
-      console.error(pc23.red("\nGenerate completed with errors"));
+      console.error(pc24.red("\nGenerate completed with errors"));
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6215,7 +6633,7 @@ program.command("graph").description("Query the component relationship graph").a
   try {
     await graph(component, options);
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6233,14 +6651,14 @@ program.command("perf").description("Profile component bundle sizes and performa
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 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-RPWZAYSJ.js");
+    const { runTestCommand, listTests } = await import("./test-2CSOSS3B.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -6273,7 +6691,7 @@ program.command("test").description("Run interaction tests for fragments with pl
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6288,7 +6706,7 @@ program.command("doctor").description("Diagnose design system configuration issu
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });