@fragments-sdk/cli 0.2.2

package/dist/index.js

@@ -0,0 +1,41 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import {
+  buildSegments,
+  runAnalyzeCommand,
+  runDiffCommand,
+  runScreenshotCommand,
+  validateAll,
+  validateCoverage,
+  validateSchema
+} from "./chunk-4FDQSGKX.js";
+import "./chunk-MUZ6CM66.js";
+import {
+  discoverComponentFiles,
+  discoverSegmentFiles,
+  extractComponentName,
+  findConfigFile,
+  loadConfig
+} from "./chunk-OAENNG3G.js";
+import {
+  generateStaticViewer,
+  generateViewerFromJson
+} from "./chunk-BSCG3IP7.js";
+import "./chunk-LY2CFFPY.js";
+import "./chunk-XHNKNI6J.js";
+export {
+  buildSegments,
+  discoverComponentFiles,
+  discoverSegmentFiles,
+  extractComponentName,
+  findConfigFile,
+  generateStaticViewer,
+  generateViewerFromJson,
+  loadConfig,
+  runAnalyzeCommand,
+  runDiffCommand,
+  runScreenshotCommand,
+  validateAll,
+  validateCoverage,
+  validateSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/init-EMVI47QG.js

@@ -0,0 +1,416 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import "./chunk-LY2CFFPY.js";
+import {
+  BRAND
+} from "./chunk-XHNKNI6J.js";
+
+// src/commands/init.ts
+import { writeFile, mkdir, access } from "fs/promises";
+import { resolve, join, relative } from "path";
+import { spawn } from "child_process";
+import pc from "picocolors";
+import fg from "fast-glob";
+import { input, confirm } from "@inquirer/prompts";
+async function detectProject(projectRoot) {
+  console.log(pc.dim("\nScanning project...\n"));
+  const configPath = join(projectRoot, BRAND.configFile);
+  const legacyConfigPath = join(projectRoot, BRAND.legacyConfigFile);
+  let hasConfig = false;
+  let foundConfigPath = null;
+  try {
+    await access(configPath);
+    hasConfig = true;
+    foundConfigPath = configPath;
+  } catch {
+    try {
+      await access(legacyConfigPath);
+      hasConfig = true;
+      foundConfigPath = legacyConfigPath;
+    } catch {
+    }
+  }
+  const storyFiles = await fg(
+    ["**/*.stories.tsx", "**/*.stories.ts", "**/*.stories.jsx", "**/*.stories.js"],
+    {
+      cwd: projectRoot,
+      ignore: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.storybook/**"]
+    }
+  );
+  const componentFiles = await fg(
+    ["**/components/**/*.tsx", "**/Components/**/*.tsx", "src/**/*.tsx"],
+    {
+      cwd: projectRoot,
+      ignore: [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/*.stories.*",
+        "**/*.test.*",
+        "**/*.spec.*",
+        "**/*.d.ts",
+        "**/index.tsx"
+        // Skip barrel files
+      ]
+    }
+  );
+  const likelyComponents = componentFiles.filter((f) => {
+    const fileName = f.split("/").pop() || "";
+    return /^[A-Z]/.test(fileName) && !fileName.includes(".styles");
+  });
+  let suggestedComponentPath = "src/components";
+  if (likelyComponents.length > 0) {
+    const firstComponent = likelyComponents[0];
+    const parts = firstComponent.split("/");
+    const componentsIndex = parts.findIndex(
+      (p) => p.toLowerCase() === "components"
+    );
+    if (componentsIndex !== -1) {
+      suggestedComponentPath = parts.slice(0, componentsIndex + 1).join("/");
+    }
+  }
+  return {
+    storyFiles,
+    componentFiles: likelyComponents,
+    hasConfig,
+    configPath: foundConfigPath,
+    suggestedComponentPath
+  };
+}
+function generateConfig(options) {
+  const includeStr = options.includePaths.map((p) => `    '${p}'`).join(",\n");
+  const componentStr = options.componentPaths.map((p) => `    '${p}'`).join(",\n");
+  return `import type { FragmentsConfig } from '@fragments/core';
+
+const config: FragmentsConfig = {
+  // Glob patterns for finding fragment/story files
+  include: [
+${includeStr}
+  ],
+
+  // Glob patterns to exclude
+  exclude: ['**/node_modules/**'],
+
+  // Glob patterns for finding component files (for auto-documentation)
+  components: [
+${componentStr}
+  ],
+
+  // Framework (react, vue, svelte)
+  framework: '${options.framework}',
+};
+
+export default config;
+`;
+}
+function generateExampleComponent() {
+  return `import React from 'react';
+
+export interface ButtonProps {
+  /** Button label */
+  children: React.ReactNode;
+  /** Visual style variant */
+  variant?: 'primary' | 'secondary' | 'ghost';
+  /** Button size */
+  size?: 'sm' | 'md' | 'lg';
+  /** Disabled state */
+  disabled?: boolean;
+  /** Click handler */
+  onClick?: () => void;
+}
+
+export function Button({
+  children,
+  variant = 'primary',
+  size = 'md',
+  disabled = false,
+  onClick,
+}: ButtonProps) {
+  const baseStyles = 'inline-flex items-center justify-center font-medium rounded-md transition-colors';
+
+  const variantStyles = {
+    primary: 'bg-blue-600 text-white hover:bg-blue-700',
+    secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',
+    ghost: 'bg-transparent text-gray-700 hover:bg-gray-100',
+  };
+
+  const sizeStyles = {
+    sm: 'px-3 py-1.5 text-sm',
+    md: 'px-4 py-2 text-base',
+    lg: 'px-6 py-3 text-lg',
+  };
+
+  return (
+    <button
+      className={\`\${baseStyles} \${variantStyles[variant]} \${sizeStyles[size]}\`}
+      disabled={disabled}
+      onClick={onClick}
+    >
+      {children}
+    </button>
+  );
+}
+`;
+}
+function generateExampleFragment() {
+  return `import React from 'react';
+import { defineFragment } from '@fragments/core';
+import { Button } from './Button';
+
+export default defineFragment({
+  component: Button,
+
+  meta: {
+    name: 'Button',
+    description: 'Interactive button for triggering actions',
+    category: 'Actions',
+    status: 'stable',
+  },
+
+  usage: {
+    when: [
+      'Triggering an action (save, submit, delete)',
+      'Form submission',
+      'Opening dialogs or menus',
+    ],
+    whenNot: [
+      'Simple navigation (use Link)',
+      'Toggling state (use Switch)',
+    ],
+    guidelines: [
+      'Use Primary for the main action in a context',
+      'Only one Primary button per section',
+    ],
+  },
+
+  props: {
+    children: {
+      type: 'node',
+      required: true,
+      description: 'Button label content',
+    },
+    variant: {
+      type: 'enum',
+      values: ['primary', 'secondary', 'ghost'],
+      default: 'primary',
+      description: 'Visual style variant',
+    },
+    size: {
+      type: 'enum',
+      values: ['sm', 'md', 'lg'],
+      default: 'md',
+      description: 'Button size',
+    },
+  },
+
+  variants: [
+    {
+      name: 'Primary',
+      description: 'Default action button',
+      render: () => <Button variant="primary">Save Changes</Button>,
+    },
+    {
+      name: 'Secondary',
+      description: 'Less prominent action',
+      render: () => <Button variant="secondary">Cancel</Button>,
+    },
+    {
+      name: 'Ghost',
+      description: 'Minimal visual weight',
+      render: () => <Button variant="ghost">Learn More</Button>,
+    },
+    {
+      name: 'Sizes',
+      description: 'Available size options',
+      render: () => (
+        <div style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>
+          <Button size="sm">Small</Button>
+          <Button size="md">Medium</Button>
+          <Button size="lg">Large</Button>
+        </div>
+      ),
+    },
+  ],
+});
+`;
+}
+function startDevServer(projectRoot) {
+  console.log(pc.dim("\nStarting development server...\n"));
+  const isWindows = process.platform === "win32";
+  const cmd = isWindows ? "npx.cmd" : "npx";
+  const child = spawn(cmd, [BRAND.cliCommand, "dev"], {
+    cwd: projectRoot,
+    stdio: "inherit"
+  });
+  child.on("error", (err) => {
+    console.error(pc.red("Failed to start dev server:"), err.message);
+  });
+}
+async function init(options = {}) {
+  const projectRoot = resolve(options.projectRoot || process.cwd());
+  const errors = [];
+  console.log(pc.cyan(`
+\u2728 Welcome to ${BRAND.name}!
+`));
+  const detection = await detectProject(projectRoot);
+  if (detection.hasConfig && !options.force) {
+    console.log(pc.yellow(`\u26A0 Config already exists: ${BRAND.configFile}`));
+    if (!options.yes) {
+      const overwrite = await confirm({
+        message: "Do you want to reinitialize? (This will overwrite your config)",
+        default: false
+      });
+      if (!overwrite) {
+        console.log(pc.dim(`
+Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
+`));
+        return {
+          success: true,
+          scenario: "stories",
+          storiesFound: detection.storyFiles.length,
+          componentsFound: detection.componentFiles.length,
+          errors: []
+        };
+      }
+    }
+  }
+  let scenario;
+  if (detection.storyFiles.length > 0) {
+    scenario = "stories";
+    console.log(pc.green(`\u2713 Found ${detection.storyFiles.length} Storybook story file(s)`));
+    console.log(pc.dim(`  ${detection.storyFiles.slice(0, 3).join("\n  ")}`));
+    if (detection.storyFiles.length > 3) {
+      console.log(pc.dim(`  ... and ${detection.storyFiles.length - 3} more`));
+    }
+    console.log();
+    console.log(
+      pc.cyan("Great news! ") + "Fragments can load your existing stories automatically."
+    );
+  } else if (detection.componentFiles.length > 0) {
+    scenario = "components";
+    console.log(pc.green(`\u2713 Found ${detection.componentFiles.length} component file(s)`));
+    console.log(pc.dim(`  ${detection.componentFiles.slice(0, 3).join("\n  ")}`));
+    if (detection.componentFiles.length > 3) {
+      console.log(pc.dim(`  ... and ${detection.componentFiles.length - 3} more`));
+    }
+    console.log();
+    console.log(
+      pc.cyan("No stories found, but that's fine! ") + "Fragments can auto-generate documentation from your TypeScript."
+    );
+  } else {
+    scenario = "fresh";
+    console.log(pc.yellow("No components or stories found."));
+    console.log();
+    console.log(pc.cyan("Let's create your first fragment!"));
+  }
+  console.log();
+  let componentPath = detection.suggestedComponentPath;
+  let runScan = scenario === "components";
+  let createExample = scenario === "fresh";
+  let startServer = true;
+  if (!options.yes) {
+    componentPath = await input({
+      message: "Where are your components located?",
+      default: detection.suggestedComponentPath
+    });
+    if (scenario === "components") {
+      runScan = await confirm({
+        message: "Auto-generate documentation from TypeScript?",
+        default: true
+      });
+    } else {
+      createExample = await confirm({
+        message: "Create an example Button component to get started?",
+        default: true
+      });
+    }
+    startServer = await confirm({
+      message: "Start the viewer now?",
+      default: true
+    });
+  }
+  console.log(pc.dim("\nCreating configuration...\n"));
+  const includePaths = [
+    `${componentPath}/**/*.fragment.tsx`,
+    `${componentPath}/**/*.segment.tsx`
+    // Legacy support
+  ];
+  const configPath = join(projectRoot, BRAND.configFile);
+  const configContent = generateConfig({
+    includePaths,
+    componentPaths: [`${componentPath}/**/*.tsx`],
+    framework: "react"
+  });
+  try {
+    await writeFile(configPath, configContent, "utf-8");
+    console.log(pc.green(`\u2713 Created ${BRAND.configFile}`));
+  } catch (e) {
+    errors.push(`Failed to create config: ${e}`);
+  }
+  if (scenario === "fresh" && createExample) {
+    const exampleDir = join(projectRoot, componentPath, "Button");
+    try {
+      await mkdir(exampleDir, { recursive: true });
+      await writeFile(
+        join(exampleDir, "Button.tsx"),
+        generateExampleComponent(),
+        "utf-8"
+      );
+      console.log(
+        pc.green(`\u2713 Created ${relative(projectRoot, join(exampleDir, "Button.tsx"))}`)
+      );
+      await writeFile(
+        join(exampleDir, "Button.fragment.tsx"),
+        generateExampleFragment(),
+        "utf-8"
+      );
+      console.log(
+        pc.green(
+          `\u2713 Created ${relative(projectRoot, join(exampleDir, "Button.fragment.tsx"))}`
+        )
+      );
+    } catch (e) {
+      errors.push(`Failed to create example component: ${e}`);
+    }
+  }
+  if (scenario === "components" && runScan) {
+    console.log(pc.dim("\nGenerating documentation from source code...\n"));
+    try {
+      const { scan } = await import("./scan-4YPRF7FV.js");
+      await scan({
+        config: configPath,
+        verbose: false
+      });
+    } catch (e) {
+      console.log(
+        pc.yellow(`Note: Auto-documentation will run when you start the dev server.`)
+      );
+    }
+  }
+  if (errors.length === 0) {
+    console.log(pc.green("\n\u2713 Setup complete!\n"));
+    if (startServer) {
+      const serverMessage = scenario === "stories" ? `Your ${detection.storyFiles.length} stories are loading...` : scenario === "components" ? `Your ${detection.componentFiles.length} components are being documented...` : `Your first component is ready!`;
+      console.log(pc.cyan(serverMessage));
+      startDevServer(projectRoot);
+    } else {
+      console.log(pc.cyan("Next steps:"));
+      console.log(`  1. Run ${pc.bold(`${BRAND.cliCommand} dev`)} to start the viewer`);
+      if (scenario === "fresh") {
+        console.log(`  2. Edit ${pc.bold(`${componentPath}/Button/Button.fragment.tsx`)}`);
+      }
+      console.log();
+    }
+  }
+  return {
+    success: errors.length === 0,
+    configPath: errors.length === 0 ? configPath : void 0,
+    scenario,
+    storiesFound: detection.storyFiles.length,
+    componentsFound: detection.componentFiles.length,
+    errors
+  };
+}
+export {
+  init
+};
+//# sourceMappingURL=init-EMVI47QG.js.map

package/dist/init-EMVI47QG.js.map

@@ -0,0 +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/core';\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/core';\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":[]}

package/dist/mcp-bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node