@fragments-sdk/cli 0.7.0 → 0.7.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CompiledSegmentsFile } from '@fragments-sdk/context/types';
+import { CompiledFragmentsFile } from '@fragments-sdk/context/types';
 export { CLI_COMMANDS, CLI_COMMAND_CATEGORIES, CliCategoryInfo, CliCommandCategory, CliCommandDef, CliOptionDef } from '@fragments-sdk/context/cli-commands';
 
 /**
@@ -53,7 +53,7 @@ interface CIConfig {
  * Config file structure
  */
 interface FragmentsConfig {
-    /** Glob patterns for finding segment/fragment files */
+    /** Glob patterns for finding fragment/fragment files */
     include: string[];
     /** Glob patterns to exclude */
     exclude?: string[];
@@ -78,10 +78,6 @@ interface FragmentsConfig {
     /** CI pipeline configuration */
     ci?: CIConfig;
 }
-/**
- * @deprecated Use FragmentsConfig instead
- */
-type SegmentsConfig = FragmentsConfig;
 /**
  * Screenshot capture configuration
  */
@@ -156,7 +152,7 @@ declare function findConfigFile(startDir?: string): string | null;
  * Load and validate the config file
  */
 declare function loadConfig(configPath?: string): Promise<{
-    config: SegmentsConfig;
+    config: FragmentsConfig;
     configDir: string;
 }>;
 
@@ -167,13 +163,13 @@ interface DiscoveredFile {
     relativePath: string;
 }
 /**
- * Discover segment files matching the config patterns
+ * Discover fragment files matching the config patterns
  */
-declare function discoverSegmentFiles(config: SegmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
+declare function discoverFragmentFiles(config: FragmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
 /**
  * Discover component files for coverage validation
  */
-declare function discoverComponentFiles(config: SegmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
+declare function discoverComponentFiles(config: FragmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
 /**
  * Extract component name from file path
  */
@@ -194,22 +190,22 @@ interface ValidationWarning {
     message: string;
 }
 /**
- * Validate segment file schema
+ * Validate fragment file schema
  */
-declare function validateSchema(config: SegmentsConfig, configDir: string): Promise<ValidationResult>;
+declare function validateSchema(config: FragmentsConfig, configDir: string): Promise<ValidationResult>;
 /**
- * Validate coverage - ensure all components have segments
+ * Validate coverage - ensure all components have fragments
  */
-declare function validateCoverage(config: SegmentsConfig, configDir: string): Promise<ValidationResult>;
+declare function validateCoverage(config: FragmentsConfig, configDir: string): Promise<ValidationResult>;
 /**
  * Run all validations
  */
-declare function validateAll(config: SegmentsConfig, configDir: string): Promise<ValidationResult>;
+declare function validateAll(config: FragmentsConfig, configDir: string): Promise<ValidationResult>;
 
 interface BuildResult {
     success: boolean;
     outputPath: string;
-    segmentCount: number;
+    fragmentCount: number;
     errors: Array<{
         file: string;
         error: string;
@@ -225,7 +221,7 @@ interface BuildResult {
  * Uses AST parsing to extract metadata WITHOUT executing fragment files.
  * This means the build works without any project dependencies installed.
  */
-declare function buildSegments(config: SegmentsConfig, configDir: string): Promise<BuildResult>;
+declare function buildFragments(config: FragmentsConfig, configDir: string): Promise<BuildResult>;
 
 /**
  * Options for the screenshot command
@@ -263,12 +259,12 @@ interface ScreenshotResult {
 /**
  * Execute the screenshot command
  */
-declare function runScreenshotCommand(config: SegmentsConfig, configDir: string, options?: ScreenshotCommandOptions): Promise<ScreenshotResult>;
+declare function runScreenshotCommand(config: FragmentsConfig, configDir: string, options?: ScreenshotCommandOptions): Promise<ScreenshotResult>;
 
 /**
  * Analytics engine for design system insights.
  *
- * Analyzes compiled segments to provide:
+ * Analyzes compiled fragments to provide:
  * - Component inventory stats
  * - Documentation coverage
  * - Usage pattern insights
@@ -490,10 +486,10 @@ interface DiffCommandResult {
 /**
  * Execute the diff command
  */
-declare function runDiffCommand(config: SegmentsConfig, configDir: string, options?: DiffCommandOptions): Promise<DiffCommandResult>;
+declare function runDiffCommand(config: FragmentsConfig, configDir: string, options?: DiffCommandOptions): Promise<DiffCommandResult>;
 
 /**
- * CLI command: segments analyze
+ * CLI command: fragments analyze
  *
  * Analyzes the design system and generates an HTML report with:
  * - Component inventory
@@ -505,7 +501,7 @@ declare function runDiffCommand(config: SegmentsConfig, configDir: string, optio
 interface AnalyzeOptions {
     /** Output format */
     format?: "html" | "json" | "console";
-    /** Output file path (default: segments-report.html) */
+    /** Output file path (default: fragments-report.html) */
     output?: string;
     /** Open report in browser after generation */
     open?: boolean;
@@ -522,16 +518,16 @@ interface AnalyzeResult {
 /**
  * Run the analyze command
  */
-declare function runAnalyzeCommand(config: SegmentsConfig, configDir: string, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+declare function runAnalyzeCommand(config: FragmentsConfig, configDir: string, options?: AnalyzeOptions): Promise<AnalyzeResult>;
 
 /**
- * Generate a static HTML viewer for the segments.json file.
+ * Generate a static HTML viewer for the fragments.json file.
  * This viewer shows component documentation without needing to render actual components.
  */
-declare function generateStaticViewer(data: CompiledSegmentsFile): string;
+declare function generateStaticViewer(data: CompiledFragmentsFile): string;
 /**
- * Load segments.json and generate static viewer
+ * Load fragments.json and generate static viewer
  */
 declare function generateViewerFromJson(jsonPath: string): Promise<string>;
 
-export { type AnalyzeOptions, type AnalyzeResult, type BuildResult, type DiffCommandOptions, type DiffCommandResult, type DiscoveredFile, type ScreenshotCommandOptions, type ScreenshotResult, type ValidationError, type ValidationResult, type ValidationWarning, type VariantDiffResult, buildSegments, discoverComponentFiles, discoverSegmentFiles, extractComponentName, findConfigFile, generateStaticViewer, generateViewerFromJson, loadConfig, runAnalyzeCommand, runDiffCommand, runScreenshotCommand, validateAll, validateCoverage, validateSchema };
+export { type AnalyzeOptions, type AnalyzeResult, type BuildResult, type DiffCommandOptions, type DiffCommandResult, type DiscoveredFile, type ScreenshotCommandOptions, type ScreenshotResult, type ValidationError, type ValidationResult, type ValidationWarning, type VariantDiffResult, buildFragments, discoverComponentFiles, discoverFragmentFiles, extractComponentName, findConfigFile, generateStaticViewer, generateViewerFromJson, loadConfig, runAnalyzeCommand, runDiffCommand, runScreenshotCommand, validateAll, validateCoverage, validateSchema };

package/dist/index.js

@@ -1,27 +1,27 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
-  buildSegments,
+  buildFragments,
   runAnalyzeCommand,
   runDiffCommand,
   runScreenshotCommand,
   validateAll,
   validateCoverage,
   validateSchema
-} from "./chunk-7OPWMLOE.js";
-import "./chunk-NWQ4CJOQ.js";
+} from "./chunk-7KUSBMI4.js";
+import "./chunk-GKX2HPZ6.js";
 import {
   discoverComponentFiles,
-  discoverSegmentFiles,
+  discoverFragmentFiles,
   extractComponentName,
   findConfigFile,
   loadConfig
-} from "./chunk-CVXKXVOY.js";
+} from "./chunk-3T6QL7IY.js";
 import {
   generateStaticViewer,
   generateViewerFromJson
-} from "./chunk-RVRTRESS.js";
-import "./chunk-TJ34N7C7.js";
-import "./chunk-6JBGU74P.js";
+} from "./chunk-DQHWLAUV.js";
+import "./chunk-OOGTG5FM.js";
+import "./chunk-GHYYFAQN.js";
 
 // src/cli-commands.ts
 import {
@@ -31,9 +31,9 @@ import {
 export {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES,
-  buildSegments,
+  buildFragments,
   discoverComponentFiles,
-  discoverSegmentFiles,
+  discoverFragmentFiles,
   extractComponentName,
   findConfigFile,
   generateStaticViewer,

package/dist/{init-7CHRKQ7P.js → init-W72WBSU2.js}

@@ -1,8 +1,8 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
-import "./chunk-TJ34N7C7.js";
+import "./chunk-OOGTG5FM.js";
 import {
   BRAND
-} from "./chunk-6JBGU74P.js";
+} from "./chunk-GHYYFAQN.js";
 
 // src/commands/init.ts
 import { writeFile, mkdir, access } from "fs/promises";
@@ -331,7 +331,7 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
   console.log(pc.dim("\nCreating configuration...\n"));
   const includePaths = [
     `${componentPath}/**/*.fragment.tsx`,
-    `${componentPath}/**/*.segment.tsx`
+    `${componentPath}/**/*.fragment.tsx`
     // Legacy support
   ];
   const configPath = join(projectRoot, BRAND.configFile);
@@ -375,7 +375,7 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
   if (scenario === "components" && runScan) {
     console.log(pc.dim("\nGenerating documentation from source code...\n"));
     try {
-      const { scan } = await import("./scan-WY23TJCP.js");
+      const { scan } = await import("./scan-V54HWRDY.js");
       await scan({
         config: configPath,
         verbose: false
@@ -413,4 +413,4 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
 export {
   init
 };
-//# sourceMappingURL=init-7CHRKQ7P.js.map
+//# sourceMappingURL=init-W72WBSU2.js.map

package/dist/{init-7CHRKQ7P.js.map → init-W72WBSU2.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/init.ts"],"sourcesContent":["/**\n * fragments init - Smart interactive initialization\n *\n * Handles three scenarios:\n * 1. Stories found → Configure and load existing stories\n * 2. Components found (no stories) → Auto-generate documentation\n * 3. Fresh project → Guided setup with example component\n */\n\nimport { readFile, writeFile, mkdir, access } from \"node:fs/promises\";\nimport { resolve, join, relative } from \"node:path\";\nimport { spawn } from \"node:child_process\";\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\nimport fg from \"fast-glob\";\nimport { input, confirm, select } from \"@inquirer/prompts\";\n\nexport interface InitOptions {\n  /** Project root directory */\n  projectRoot?: string;\n  /** Force overwrite existing config */\n  force?: boolean;\n  /** Non-interactive mode - auto-detect and use defaults */\n  yes?: boolean;\n}\n\nexport interface InitResult {\n  success: boolean;\n  configPath?: string;\n  scenario: \"stories\" | \"components\" | \"fresh\";\n  storiesFound: number;\n  componentsFound: number;\n  errors: string[];\n}\n\ninterface DetectionResult {\n  storyFiles: string[];\n  componentFiles: string[];\n  hasConfig: boolean;\n  configPath: string | null;\n  suggestedComponentPath: string;\n}\n\n/**\n * Detect what exists in the project\n */\nasync function detectProject(projectRoot: string): Promise<DetectionResult> {\n  console.log(pc.dim(\"\\nScanning project...\\n\"));\n\n  // Check for existing config\n  const configPath = join(projectRoot, BRAND.configFile);\n  const legacyConfigPath = join(projectRoot, BRAND.legacyConfigFile);\n  let hasConfig = false;\n  let foundConfigPath: string | null = null;\n\n  try {\n    await access(configPath);\n    hasConfig = true;\n    foundConfigPath = configPath;\n  } catch {\n    try {\n      await access(legacyConfigPath);\n      hasConfig = true;\n      foundConfigPath = legacyConfigPath;\n    } catch {\n      // No config\n    }\n  }\n\n  // Scan for story files\n  const storyFiles = await fg(\n    [\"**/*.stories.tsx\", \"**/*.stories.ts\", \"**/*.stories.jsx\", \"**/*.stories.js\"],\n    {\n      cwd: projectRoot,\n      ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/build/**\", \"**/.storybook/**\"],\n    }\n  );\n\n  // Scan for component files (React components)\n  const componentFiles = await fg(\n    [\"**/components/**/*.tsx\", \"**/Components/**/*.tsx\", \"src/**/*.tsx\"],\n    {\n      cwd: projectRoot,\n      ignore: [\n        \"**/node_modules/**\",\n        \"**/dist/**\",\n        \"**/build/**\",\n        \"**/*.stories.*\",\n        \"**/*.test.*\",\n        \"**/*.spec.*\",\n        \"**/*.d.ts\",\n        \"**/index.tsx\", // Skip barrel files\n      ],\n    }\n  );\n\n  // Filter to likely component files (capitalized names, not utility files)\n  const likelyComponents = componentFiles.filter((f) => {\n    const fileName = f.split(\"/\").pop() || \"\";\n    return /^[A-Z]/.test(fileName) && !fileName.includes(\".styles\");\n  });\n\n  // Suggest component path based on what we found\n  let suggestedComponentPath = \"src/components\";\n  if (likelyComponents.length > 0) {\n    const firstComponent = likelyComponents[0];\n    const parts = firstComponent.split(\"/\");\n    const componentsIndex = parts.findIndex(\n      (p) => p.toLowerCase() === \"components\"\n    );\n    if (componentsIndex !== -1) {\n      suggestedComponentPath = parts.slice(0, componentsIndex + 1).join(\"/\");\n    }\n  }\n\n  return {\n    storyFiles,\n    componentFiles: likelyComponents,\n    hasConfig,\n    configPath: foundConfigPath,\n    suggestedComponentPath,\n  };\n}\n\n/**\n * Generate config file content\n */\nfunction generateConfig(options: {\n  includePaths: string[];\n  componentPaths: string[];\n  framework: string;\n}): string {\n  const includeStr = options.includePaths.map((p) => `    '${p}'`).join(\",\\n\");\n  const componentStr = options.componentPaths.map((p) => `    '${p}'`).join(\",\\n\");\n\n  return `import type { FragmentsConfig } from '@fragments-sdk/cli';\n\nconst config: FragmentsConfig = {\n  // Glob patterns for finding fragment/story files\n  include: [\n${includeStr}\n  ],\n\n  // Glob patterns to exclude\n  exclude: ['**/node_modules/**'],\n\n  // Glob patterns for finding component files (for auto-documentation)\n  components: [\n${componentStr}\n  ],\n\n  // Framework (react, vue, svelte)\n  framework: '${options.framework}',\n};\n\nexport default config;\n`;\n}\n\n/**\n * Generate example Button component\n */\nfunction generateExampleComponent(): string {\n  return `import React from 'react';\n\nexport interface ButtonProps {\n  /** Button label */\n  children: React.ReactNode;\n  /** Visual style variant */\n  variant?: 'primary' | 'secondary' | 'ghost';\n  /** Button size */\n  size?: 'sm' | 'md' | 'lg';\n  /** Disabled state */\n  disabled?: boolean;\n  /** Click handler */\n  onClick?: () => void;\n}\n\nexport function Button({\n  children,\n  variant = 'primary',\n  size = 'md',\n  disabled = false,\n  onClick,\n}: ButtonProps) {\n  const baseStyles = 'inline-flex items-center justify-center font-medium rounded-md transition-colors';\n\n  const variantStyles = {\n    primary: 'bg-blue-600 text-white hover:bg-blue-700',\n    secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',\n    ghost: 'bg-transparent text-gray-700 hover:bg-gray-100',\n  };\n\n  const sizeStyles = {\n    sm: 'px-3 py-1.5 text-sm',\n    md: 'px-4 py-2 text-base',\n    lg: 'px-6 py-3 text-lg',\n  };\n\n  return (\n    <button\n      className={\\`\\${baseStyles} \\${variantStyles[variant]} \\${sizeStyles[size]}\\`}\n      disabled={disabled}\n      onClick={onClick}\n    >\n      {children}\n    </button>\n  );\n}\n`;\n}\n\n/**\n * Generate example Button fragment file\n */\nfunction generateExampleFragment(): string {\n  return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli';\nimport { Button } from './Button';\n\nexport default defineFragment({\n  component: Button,\n\n  meta: {\n    name: 'Button',\n    description: 'Interactive button for triggering actions',\n    category: 'Actions',\n    status: 'stable',\n  },\n\n  usage: {\n    when: [\n      'Triggering an action (save, submit, delete)',\n      'Form submission',\n      'Opening dialogs or menus',\n    ],\n    whenNot: [\n      'Simple navigation (use Link)',\n      'Toggling state (use Switch)',\n    ],\n    guidelines: [\n      'Use Primary for the main action in a context',\n      'Only one Primary button per section',\n    ],\n  },\n\n  props: {\n    children: {\n      type: 'node',\n      required: true,\n      description: 'Button label content',\n    },\n    variant: {\n      type: 'enum',\n      values: ['primary', 'secondary', 'ghost'],\n      default: 'primary',\n      description: 'Visual style variant',\n    },\n    size: {\n      type: 'enum',\n      values: ['sm', 'md', 'lg'],\n      default: 'md',\n      description: 'Button size',\n    },\n  },\n\n  variants: [\n    {\n      name: 'Primary',\n      description: 'Default action button',\n      render: () => <Button variant=\"primary\">Save Changes</Button>,\n    },\n    {\n      name: 'Secondary',\n      description: 'Less prominent action',\n      render: () => <Button variant=\"secondary\">Cancel</Button>,\n    },\n    {\n      name: 'Ghost',\n      description: 'Minimal visual weight',\n      render: () => <Button variant=\"ghost\">Learn More</Button>,\n    },\n    {\n      name: 'Sizes',\n      description: 'Available size options',\n      render: () => (\n        <div style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>\n          <Button size=\"sm\">Small</Button>\n          <Button size=\"md\">Medium</Button>\n          <Button size=\"lg\">Large</Button>\n        </div>\n      ),\n    },\n  ],\n});\n`;\n}\n\n/**\n * Start the dev server\n */\nfunction startDevServer(projectRoot: string): void {\n  console.log(pc.dim(\"\\nStarting development server...\\n\"));\n\n  // Use process.platform to determine the correct command\n  const isWindows = process.platform === \"win32\";\n  const cmd = isWindows ? \"npx.cmd\" : \"npx\";\n\n  const child = spawn(cmd, [BRAND.cliCommand, \"dev\"], {\n    cwd: projectRoot,\n    stdio: \"inherit\",\n  });\n\n  child.on(\"error\", (err) => {\n    console.error(pc.red(\"Failed to start dev server:\"), err.message);\n  });\n}\n\n/**\n * Main init function - smart and interactive by default\n */\nexport async function init(options: InitOptions = {}): Promise<InitResult> {\n  const projectRoot = resolve(options.projectRoot || process.cwd());\n  const errors: string[] = [];\n\n  console.log(pc.cyan(`\\n✨ Welcome to ${BRAND.name}!\\n`));\n\n  // Step 1: Detect what exists\n  const detection = await detectProject(projectRoot);\n\n  // Check for existing config\n  if (detection.hasConfig && !options.force) {\n    console.log(pc.yellow(`⚠ Config already exists: ${BRAND.configFile}`));\n\n    if (!options.yes) {\n      const overwrite = await confirm({\n        message: \"Do you want to reinitialize? (This will overwrite your config)\",\n        default: false,\n      });\n\n      if (!overwrite) {\n        console.log(pc.dim(`\\nKeeping existing configuration. Run \\`${BRAND.cliCommand} dev\\` to start.\\n`));\n        return {\n          success: true,\n          scenario: \"stories\",\n          storiesFound: detection.storyFiles.length,\n          componentsFound: detection.componentFiles.length,\n          errors: [],\n        };\n      }\n    }\n  }\n\n  // Step 2: Determine scenario and show what we found\n  let scenario: \"stories\" | \"components\" | \"fresh\";\n\n  if (detection.storyFiles.length > 0) {\n    scenario = \"stories\";\n    console.log(pc.green(`✓ Found ${detection.storyFiles.length} Storybook story file(s)`));\n    console.log(pc.dim(`  ${detection.storyFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.storyFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.storyFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"Great news! \") +\n        \"Fragments can load your existing stories automatically.\"\n    );\n  } else if (detection.componentFiles.length > 0) {\n    scenario = \"components\";\n    console.log(pc.green(`✓ Found ${detection.componentFiles.length} component file(s)`));\n    console.log(pc.dim(`  ${detection.componentFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.componentFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.componentFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"No stories found, but that's fine! \") +\n        \"Fragments can auto-generate documentation from your TypeScript.\"\n    );\n  } else {\n    scenario = \"fresh\";\n    console.log(pc.yellow(\"No components or stories found.\"));\n    console.log();\n    console.log(pc.cyan(\"Let's create your first fragment!\"));\n  }\n\n  console.log();\n\n  // Step 3: Gather configuration (interactive unless --yes)\n  let componentPath = detection.suggestedComponentPath;\n  let runScan = scenario === \"components\";\n  let createExample = scenario === \"fresh\";\n  let startServer = true;\n\n  if (!options.yes) {\n    // Ask about component location\n    componentPath = await input({\n      message: \"Where are your components located?\",\n      default: detection.suggestedComponentPath,\n    });\n\n    if (scenario === \"components\") {\n      // For component-only projects, ask about scanning\n      runScan = await confirm({\n        message: \"Auto-generate documentation from TypeScript?\",\n        default: true,\n      });\n    } else {\n      // Fresh project - ask about example\n      createExample = await confirm({\n        message: \"Create an example Button component to get started?\",\n        default: true,\n      });\n    }\n\n    // Ask about starting the server\n    startServer = await confirm({\n      message: \"Start the viewer now?\",\n      default: true,\n    });\n  }\n\n  // Step 4: Create configuration\n  console.log(pc.dim(\"\\nCreating configuration...\\n\"));\n\n  // Build include patterns\n  // Note: Stories are loaded separately by the viewer, not via include patterns\n  const includePaths: string[] = [\n    `${componentPath}/**/*.fragment.tsx`,\n    `${componentPath}/**/*.segment.tsx`, // Legacy support\n  ];\n\n  // Create config file\n  const configPath = join(projectRoot, BRAND.configFile);\n  const configContent = generateConfig({\n    includePaths,\n    componentPaths: [`${componentPath}/**/*.tsx`],\n    framework: \"react\",\n  });\n\n  try {\n    await writeFile(configPath, configContent, \"utf-8\");\n    console.log(pc.green(`✓ Created ${BRAND.configFile}`));\n  } catch (e) {\n    errors.push(`Failed to create config: ${e}`);\n  }\n\n  // Step 5: Handle scenario-specific setup\n  if (scenario === \"fresh\" && createExample) {\n    // Create example component\n    const exampleDir = join(projectRoot, componentPath, \"Button\");\n\n    try {\n      await mkdir(exampleDir, { recursive: true });\n\n      // Write Button.tsx\n      await writeFile(\n        join(exampleDir, \"Button.tsx\"),\n        generateExampleComponent(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(`✓ Created ${relative(projectRoot, join(exampleDir, \"Button.tsx\"))}`)\n      );\n\n      // Write Button.fragment.tsx\n      await writeFile(\n        join(exampleDir, \"Button.fragment.tsx\"),\n        generateExampleFragment(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(\n          `✓ Created ${relative(projectRoot, join(exampleDir, \"Button.fragment.tsx\"))}`\n        )\n      );\n    } catch (e) {\n      errors.push(`Failed to create example component: ${e}`);\n    }\n  }\n\n  if (scenario === \"components\" && runScan) {\n    // Run scan to generate fragments.json\n    console.log(pc.dim(\"\\nGenerating documentation from source code...\\n\"));\n    try {\n      const { scan } = await import(\"./scan.js\");\n      await scan({\n        config: configPath,\n        verbose: false,\n      });\n    } catch (e) {\n      console.log(\n        pc.yellow(`Note: Auto-documentation will run when you start the dev server.`)\n      );\n    }\n  }\n\n  // Step 6: Show next steps or start server\n  if (errors.length === 0) {\n    console.log(pc.green(\"\\n✓ Setup complete!\\n\"));\n\n    if (startServer) {\n      const serverMessage =\n        scenario === \"stories\"\n          ? `Your ${detection.storyFiles.length} stories are loading...`\n          : scenario === \"components\"\n          ? `Your ${detection.componentFiles.length} components are being documented...`\n          : `Your first component is ready!`;\n\n      console.log(pc.cyan(serverMessage));\n      startDevServer(projectRoot);\n    } else {\n      console.log(pc.cyan(\"Next steps:\"));\n      console.log(`  1. Run ${pc.bold(`${BRAND.cliCommand} dev`)} to start the viewer`);\n      if (scenario === \"fresh\") {\n        console.log(`  2. Edit ${pc.bold(`${componentPath}/Button/Button.fragment.tsx`)}`);\n      }\n      console.log();\n    }\n  }\n\n  return {\n    success: errors.length === 0,\n    configPath: errors.length === 0 ? configPath : undefined,\n    scenario,\n    storiesFound: detection.storyFiles.length,\n    componentsFound: detection.componentFiles.length,\n    errors,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/commands/init.ts"],"sourcesContent":["/**\n * fragments init - Smart interactive initialization\n *\n * Handles three scenarios:\n * 1. Stories found → Configure and load existing stories\n * 2. Components found (no stories) → Auto-generate documentation\n * 3. Fresh project → Guided setup with example component\n */\n\nimport { readFile, writeFile, mkdir, access } from \"node:fs/promises\";\nimport { resolve, join, relative } from \"node:path\";\nimport { spawn } from \"node:child_process\";\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\nimport fg from \"fast-glob\";\nimport { input, confirm, select } from \"@inquirer/prompts\";\n\nexport interface InitOptions {\n  /** Project root directory */\n  projectRoot?: string;\n  /** Force overwrite existing config */\n  force?: boolean;\n  /** Non-interactive mode - auto-detect and use defaults */\n  yes?: boolean;\n}\n\nexport interface InitResult {\n  success: boolean;\n  configPath?: string;\n  scenario: \"stories\" | \"components\" | \"fresh\";\n  storiesFound: number;\n  componentsFound: number;\n  errors: string[];\n}\n\ninterface DetectionResult {\n  storyFiles: string[];\n  componentFiles: string[];\n  hasConfig: boolean;\n  configPath: string | null;\n  suggestedComponentPath: string;\n}\n\n/**\n * Detect what exists in the project\n */\nasync function detectProject(projectRoot: string): Promise<DetectionResult> {\n  console.log(pc.dim(\"\\nScanning project...\\n\"));\n\n  // Check for existing config\n  const configPath = join(projectRoot, BRAND.configFile);\n  const legacyConfigPath = join(projectRoot, BRAND.legacyConfigFile);\n  let hasConfig = false;\n  let foundConfigPath: string | null = null;\n\n  try {\n    await access(configPath);\n    hasConfig = true;\n    foundConfigPath = configPath;\n  } catch {\n    try {\n      await access(legacyConfigPath);\n      hasConfig = true;\n      foundConfigPath = legacyConfigPath;\n    } catch {\n      // No config\n    }\n  }\n\n  // Scan for story files\n  const storyFiles = await fg(\n    [\"**/*.stories.tsx\", \"**/*.stories.ts\", \"**/*.stories.jsx\", \"**/*.stories.js\"],\n    {\n      cwd: projectRoot,\n      ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/build/**\", \"**/.storybook/**\"],\n    }\n  );\n\n  // Scan for component files (React components)\n  const componentFiles = await fg(\n    [\"**/components/**/*.tsx\", \"**/Components/**/*.tsx\", \"src/**/*.tsx\"],\n    {\n      cwd: projectRoot,\n      ignore: [\n        \"**/node_modules/**\",\n        \"**/dist/**\",\n        \"**/build/**\",\n        \"**/*.stories.*\",\n        \"**/*.test.*\",\n        \"**/*.spec.*\",\n        \"**/*.d.ts\",\n        \"**/index.tsx\", // Skip barrel files\n      ],\n    }\n  );\n\n  // Filter to likely component files (capitalized names, not utility files)\n  const likelyComponents = componentFiles.filter((f) => {\n    const fileName = f.split(\"/\").pop() || \"\";\n    return /^[A-Z]/.test(fileName) && !fileName.includes(\".styles\");\n  });\n\n  // Suggest component path based on what we found\n  let suggestedComponentPath = \"src/components\";\n  if (likelyComponents.length > 0) {\n    const firstComponent = likelyComponents[0];\n    const parts = firstComponent.split(\"/\");\n    const componentsIndex = parts.findIndex(\n      (p) => p.toLowerCase() === \"components\"\n    );\n    if (componentsIndex !== -1) {\n      suggestedComponentPath = parts.slice(0, componentsIndex + 1).join(\"/\");\n    }\n  }\n\n  return {\n    storyFiles,\n    componentFiles: likelyComponents,\n    hasConfig,\n    configPath: foundConfigPath,\n    suggestedComponentPath,\n  };\n}\n\n/**\n * Generate config file content\n */\nfunction generateConfig(options: {\n  includePaths: string[];\n  componentPaths: string[];\n  framework: string;\n}): string {\n  const includeStr = options.includePaths.map((p) => `    '${p}'`).join(\",\\n\");\n  const componentStr = options.componentPaths.map((p) => `    '${p}'`).join(\",\\n\");\n\n  return `import type { FragmentsConfig } from '@fragments-sdk/cli';\n\nconst config: FragmentsConfig = {\n  // Glob patterns for finding fragment/story files\n  include: [\n${includeStr}\n  ],\n\n  // Glob patterns to exclude\n  exclude: ['**/node_modules/**'],\n\n  // Glob patterns for finding component files (for auto-documentation)\n  components: [\n${componentStr}\n  ],\n\n  // Framework (react, vue, svelte)\n  framework: '${options.framework}',\n};\n\nexport default config;\n`;\n}\n\n/**\n * Generate example Button component\n */\nfunction generateExampleComponent(): string {\n  return `import React from 'react';\n\nexport interface ButtonProps {\n  /** Button label */\n  children: React.ReactNode;\n  /** Visual style variant */\n  variant?: 'primary' | 'secondary' | 'ghost';\n  /** Button size */\n  size?: 'sm' | 'md' | 'lg';\n  /** Disabled state */\n  disabled?: boolean;\n  /** Click handler */\n  onClick?: () => void;\n}\n\nexport function Button({\n  children,\n  variant = 'primary',\n  size = 'md',\n  disabled = false,\n  onClick,\n}: ButtonProps) {\n  const baseStyles = 'inline-flex items-center justify-center font-medium rounded-md transition-colors';\n\n  const variantStyles = {\n    primary: 'bg-blue-600 text-white hover:bg-blue-700',\n    secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',\n    ghost: 'bg-transparent text-gray-700 hover:bg-gray-100',\n  };\n\n  const sizeStyles = {\n    sm: 'px-3 py-1.5 text-sm',\n    md: 'px-4 py-2 text-base',\n    lg: 'px-6 py-3 text-lg',\n  };\n\n  return (\n    <button\n      className={\\`\\${baseStyles} \\${variantStyles[variant]} \\${sizeStyles[size]}\\`}\n      disabled={disabled}\n      onClick={onClick}\n    >\n      {children}\n    </button>\n  );\n}\n`;\n}\n\n/**\n * Generate example Button fragment file\n */\nfunction generateExampleFragment(): string {\n  return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli';\nimport { Button } from './Button';\n\nexport default defineFragment({\n  component: Button,\n\n  meta: {\n    name: 'Button',\n    description: 'Interactive button for triggering actions',\n    category: 'Actions',\n    status: 'stable',\n  },\n\n  usage: {\n    when: [\n      'Triggering an action (save, submit, delete)',\n      'Form submission',\n      'Opening dialogs or menus',\n    ],\n    whenNot: [\n      'Simple navigation (use Link)',\n      'Toggling state (use Switch)',\n    ],\n    guidelines: [\n      'Use Primary for the main action in a context',\n      'Only one Primary button per section',\n    ],\n  },\n\n  props: {\n    children: {\n      type: 'node',\n      required: true,\n      description: 'Button label content',\n    },\n    variant: {\n      type: 'enum',\n      values: ['primary', 'secondary', 'ghost'],\n      default: 'primary',\n      description: 'Visual style variant',\n    },\n    size: {\n      type: 'enum',\n      values: ['sm', 'md', 'lg'],\n      default: 'md',\n      description: 'Button size',\n    },\n  },\n\n  variants: [\n    {\n      name: 'Primary',\n      description: 'Default action button',\n      render: () => <Button variant=\"primary\">Save Changes</Button>,\n    },\n    {\n      name: 'Secondary',\n      description: 'Less prominent action',\n      render: () => <Button variant=\"secondary\">Cancel</Button>,\n    },\n    {\n      name: 'Ghost',\n      description: 'Minimal visual weight',\n      render: () => <Button variant=\"ghost\">Learn More</Button>,\n    },\n    {\n      name: 'Sizes',\n      description: 'Available size options',\n      render: () => (\n        <div style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>\n          <Button size=\"sm\">Small</Button>\n          <Button size=\"md\">Medium</Button>\n          <Button size=\"lg\">Large</Button>\n        </div>\n      ),\n    },\n  ],\n});\n`;\n}\n\n/**\n * Start the dev server\n */\nfunction startDevServer(projectRoot: string): void {\n  console.log(pc.dim(\"\\nStarting development server...\\n\"));\n\n  // Use process.platform to determine the correct command\n  const isWindows = process.platform === \"win32\";\n  const cmd = isWindows ? \"npx.cmd\" : \"npx\";\n\n  const child = spawn(cmd, [BRAND.cliCommand, \"dev\"], {\n    cwd: projectRoot,\n    stdio: \"inherit\",\n  });\n\n  child.on(\"error\", (err) => {\n    console.error(pc.red(\"Failed to start dev server:\"), err.message);\n  });\n}\n\n/**\n * Main init function - smart and interactive by default\n */\nexport async function init(options: InitOptions = {}): Promise<InitResult> {\n  const projectRoot = resolve(options.projectRoot || process.cwd());\n  const errors: string[] = [];\n\n  console.log(pc.cyan(`\\n✨ Welcome to ${BRAND.name}!\\n`));\n\n  // Step 1: Detect what exists\n  const detection = await detectProject(projectRoot);\n\n  // Check for existing config\n  if (detection.hasConfig && !options.force) {\n    console.log(pc.yellow(`⚠ Config already exists: ${BRAND.configFile}`));\n\n    if (!options.yes) {\n      const overwrite = await confirm({\n        message: \"Do you want to reinitialize? (This will overwrite your config)\",\n        default: false,\n      });\n\n      if (!overwrite) {\n        console.log(pc.dim(`\\nKeeping existing configuration. Run \\`${BRAND.cliCommand} dev\\` to start.\\n`));\n        return {\n          success: true,\n          scenario: \"stories\",\n          storiesFound: detection.storyFiles.length,\n          componentsFound: detection.componentFiles.length,\n          errors: [],\n        };\n      }\n    }\n  }\n\n  // Step 2: Determine scenario and show what we found\n  let scenario: \"stories\" | \"components\" | \"fresh\";\n\n  if (detection.storyFiles.length > 0) {\n    scenario = \"stories\";\n    console.log(pc.green(`✓ Found ${detection.storyFiles.length} Storybook story file(s)`));\n    console.log(pc.dim(`  ${detection.storyFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.storyFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.storyFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"Great news! \") +\n        \"Fragments can load your existing stories automatically.\"\n    );\n  } else if (detection.componentFiles.length > 0) {\n    scenario = \"components\";\n    console.log(pc.green(`✓ Found ${detection.componentFiles.length} component file(s)`));\n    console.log(pc.dim(`  ${detection.componentFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.componentFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.componentFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"No stories found, but that's fine! \") +\n        \"Fragments can auto-generate documentation from your TypeScript.\"\n    );\n  } else {\n    scenario = \"fresh\";\n    console.log(pc.yellow(\"No components or stories found.\"));\n    console.log();\n    console.log(pc.cyan(\"Let's create your first fragment!\"));\n  }\n\n  console.log();\n\n  // Step 3: Gather configuration (interactive unless --yes)\n  let componentPath = detection.suggestedComponentPath;\n  let runScan = scenario === \"components\";\n  let createExample = scenario === \"fresh\";\n  let startServer = true;\n\n  if (!options.yes) {\n    // Ask about component location\n    componentPath = await input({\n      message: \"Where are your components located?\",\n      default: detection.suggestedComponentPath,\n    });\n\n    if (scenario === \"components\") {\n      // For component-only projects, ask about scanning\n      runScan = await confirm({\n        message: \"Auto-generate documentation from TypeScript?\",\n        default: true,\n      });\n    } else {\n      // Fresh project - ask about example\n      createExample = await confirm({\n        message: \"Create an example Button component to get started?\",\n        default: true,\n      });\n    }\n\n    // Ask about starting the server\n    startServer = await confirm({\n      message: \"Start the viewer now?\",\n      default: true,\n    });\n  }\n\n  // Step 4: Create configuration\n  console.log(pc.dim(\"\\nCreating configuration...\\n\"));\n\n  // Build include patterns\n  // Note: Stories are loaded separately by the viewer, not via include patterns\n  const includePaths: string[] = [\n    `${componentPath}/**/*.fragment.tsx`,\n    `${componentPath}/**/*.fragment.tsx`, // Legacy support\n  ];\n\n  // Create config file\n  const configPath = join(projectRoot, BRAND.configFile);\n  const configContent = generateConfig({\n    includePaths,\n    componentPaths: [`${componentPath}/**/*.tsx`],\n    framework: \"react\",\n  });\n\n  try {\n    await writeFile(configPath, configContent, \"utf-8\");\n    console.log(pc.green(`✓ Created ${BRAND.configFile}`));\n  } catch (e) {\n    errors.push(`Failed to create config: ${e}`);\n  }\n\n  // Step 5: Handle scenario-specific setup\n  if (scenario === \"fresh\" && createExample) {\n    // Create example component\n    const exampleDir = join(projectRoot, componentPath, \"Button\");\n\n    try {\n      await mkdir(exampleDir, { recursive: true });\n\n      // Write Button.tsx\n      await writeFile(\n        join(exampleDir, \"Button.tsx\"),\n        generateExampleComponent(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(`✓ Created ${relative(projectRoot, join(exampleDir, \"Button.tsx\"))}`)\n      );\n\n      // Write Button.fragment.tsx\n      await writeFile(\n        join(exampleDir, \"Button.fragment.tsx\"),\n        generateExampleFragment(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(\n          `✓ Created ${relative(projectRoot, join(exampleDir, \"Button.fragment.tsx\"))}`\n        )\n      );\n    } catch (e) {\n      errors.push(`Failed to create example component: ${e}`);\n    }\n  }\n\n  if (scenario === \"components\" && runScan) {\n    // Run scan to generate fragments.json\n    console.log(pc.dim(\"\\nGenerating documentation from source code...\\n\"));\n    try {\n      const { scan } = await import(\"./scan.js\");\n      await scan({\n        config: configPath,\n        verbose: false,\n      });\n    } catch (e) {\n      console.log(\n        pc.yellow(`Note: Auto-documentation will run when you start the dev server.`)\n      );\n    }\n  }\n\n  // Step 6: Show next steps or start server\n  if (errors.length === 0) {\n    console.log(pc.green(\"\\n✓ Setup complete!\\n\"));\n\n    if (startServer) {\n      const serverMessage =\n        scenario === \"stories\"\n          ? `Your ${detection.storyFiles.length} stories are loading...`\n          : scenario === \"components\"\n          ? `Your ${detection.componentFiles.length} components are being documented...`\n          : `Your first component is ready!`;\n\n      console.log(pc.cyan(serverMessage));\n      startDevServer(projectRoot);\n    } else {\n      console.log(pc.cyan(\"Next steps:\"));\n      console.log(`  1. Run ${pc.bold(`${BRAND.cliCommand} dev`)} to start the viewer`);\n      if (scenario === \"fresh\") {\n        console.log(`  2. Edit ${pc.bold(`${componentPath}/Button/Button.fragment.tsx`)}`);\n      }\n      console.log();\n    }\n  }\n\n  return {\n    success: errors.length === 0,\n    configPath: errors.length === 0 ? configPath : undefined,\n    scenario,\n    storiesFound: detection.storyFiles.length,\n    componentsFound: detection.componentFiles.length,\n    errors,\n  };\n}\n"],"mappings":"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","names":[]}