@fragments-sdk/cli 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -1,205 +1,5 @@
-/**
- * Metadata about the component
- */
-interface SegmentMeta {
-    /** Component display name */
-    name: string;
-    /** Brief description of the component's purpose */
-    description: string;
-    /** Category for organizing components (e.g., "actions", "forms", "layout") */
-    category: string;
-    /** Optional tags for additional categorization */
-    tags?: string[];
-    /** Component status */
-    status?: "stable" | "beta" | "deprecated" | "experimental";
-    /** Version when component was introduced */
-    since?: string;
-    /** Figma frame URL for design verification */
-    figma?: string;
-    /** Figma property mappings (how Figma props map to code props) */
-    figmaProps?: Record<string, FigmaPropMapping>;
-}
-/**
- * Figma property mapping types - describes how a Figma property maps to code
- */
-type FigmaPropMapping = FigmaStringMapping | FigmaBooleanMapping | FigmaEnumMapping | FigmaInstanceMapping | FigmaChildrenMapping | FigmaTextContentMapping;
-/** Maps a Figma text property to a string prop */
-interface FigmaStringMapping {
-    __type: 'figma-string';
-    figmaProperty: string;
-}
-/** Maps a Figma boolean property to a boolean prop (with optional value mapping) */
-interface FigmaBooleanMapping {
-    __type: 'figma-boolean';
-    figmaProperty: string;
-    valueMapping?: {
-        true: unknown;
-        false: unknown;
-    };
-}
-/** Maps a Figma variant property to an enum prop */
-interface FigmaEnumMapping {
-    __type: 'figma-enum';
-    figmaProperty: string;
-    valueMapping: Record<string, unknown>;
-}
-/** References a nested Figma component instance */
-interface FigmaInstanceMapping {
-    __type: 'figma-instance';
-    figmaProperty: string;
-}
-/** Renders children from Figma layer names */
-interface FigmaChildrenMapping {
-    __type: 'figma-children';
-    layers: string[];
-}
-/** Extracts text content from a Figma text layer */
-interface FigmaTextContentMapping {
-    __type: 'figma-text-content';
-    layer: string;
-}
-/**
- * Usage guidelines for AI agents and developers
- */
-interface SegmentUsage {
-    /** When to use this component */
-    when: string[];
-    /** When NOT to use this component (with alternatives) */
-    whenNot: string[];
-    /** Additional usage guidelines and best practices */
-    guidelines?: string[];
-    /** Accessibility considerations */
-    accessibility?: string[];
-}
-/**
- * Prop type definitions
- */
-type PropType = {
-    type: "string";
-    pattern?: string;
-} | {
-    type: "number";
-    min?: number;
-    max?: number;
-} | {
-    type: "boolean";
-} | {
-    type: "enum";
-    values: readonly string[];
-} | {
-    type: "function";
-    signature?: string;
-} | {
-    type: "node";
-} | {
-    type: "element";
-} | {
-    type: "object";
-    shape?: Record<string, PropDefinition>;
-} | {
-    type: "array";
-    items?: PropType;
-} | {
-    type: "union";
-    types: PropType[];
-} | {
-    type: "custom";
-    typescript: string;
-};
-/**
- * Storybook control types for UI rendering
- */
-type ControlType = "text" | "number" | "range" | "boolean" | "select" | "multi-select" | "radio" | "inline-radio" | "check" | "inline-check" | "object" | "file" | "color" | "date";
-/**
- * Definition for a single prop
- */
-interface PropDefinition {
-    /** The prop type */
-    type: PropType["type"];
-    /** For enum types, the allowed values */
-    values?: readonly string[];
-    /** Default value if not provided */
-    default?: unknown;
-    /** Description of what this prop does */
-    description: string;
-    /** Whether this prop is required */
-    required?: boolean;
-    /** Usage constraints for AI agents */
-    constraints?: string[];
-    /** Additional type details for complex types */
-    typeDetails?: Omit<PropType, "type">;
-    /** Original Storybook control type for UI rendering (e.g., "color", "date", "range") */
-    controlType?: ControlType;
-    /** Control options (e.g., min/max for range, presetColors for color) */
-    controlOptions?: {
-        min?: number;
-        max?: number;
-        step?: number;
-        presetColors?: string[];
-    };
-}
-/**
- * Relationship types between components
- */
-type RelationshipType = "alternative" | "sibling" | "parent" | "child" | "composition";
-/**
- * Relationship to another component
- */
-interface ComponentRelation {
-    /** Name of the related component */
-    component: string;
-    /** Type of relationship */
-    relationship: RelationshipType;
-    /** Explanation of the relationship */
-    note: string;
-}
-/**
- * Agent-optimized contract metadata
- * Provides compact, structured data for AI code generation
- */
-interface SegmentContract {
-    /** Short prop descriptions for agents (e.g., "variant: primary|secondary (required)") */
-    propsSummary?: string[];
-    /** Accessibility rule IDs for lookup in glossary (e.g., "A11Y_BTN_LABEL") */
-    a11yRules?: string[];
-    /** Banned patterns in codebase - triggers warnings during code review */
-    bans?: Array<{
-        /** Pattern to match (regex string or literal) */
-        pattern: string;
-        /** Message explaining why this pattern is banned and what to use instead */
-        message: string;
-    }>;
-    /** Scenario tags for use-case matching (e.g., "form.submit", "navigation.primary") */
-    scenarioTags?: string[];
-}
-/**
- * Provenance tracking for generated segments
- * Helps distinguish human-authored from machine-generated content
- */
-interface SegmentGenerated {
-    /** Source of this segment definition */
-    source: "storybook" | "manual" | "ai";
-    /** Original source file (e.g., "Button.stories.tsx") */
-    sourceFile?: string;
-    /** Confidence score from 0-1 (how reliable the extraction was) */
-    confidence?: number;
-    /** ISO timestamp when this was generated */
-    timestamp?: string;
-}
-/**
- * AI-specific metadata for playground context generation
- * Provides hints for AI code generation about component composition
- */
-interface AIMetadata {
-    /** How this component is composed with others */
-    compositionPattern?: "compound" | "simple" | "controlled";
-    /** Sub-component names (without parent prefix, e.g., "Header" not "Card.Header") */
-    subComponents?: string[];
-    /** Sub-components that must be present for valid composition */
-    requiredChildren?: string[];
-    /** Common usage patterns as JSX strings for AI reference */
-    commonPatterns?: string[];
-}
+import { CompiledSegmentsFile } from '@fragments-sdk/context/types';
+
 /**
  * Registry generation options
  */
@@ -345,89 +145,6 @@ interface BoundingBox {
     width: number;
     height: number;
 }
-/**
- * Compiled segment data (JSON-serializable for AI consumption)
- */
-interface CompiledSegment {
-    /** File path relative to project root */
-    filePath: string;
-    /** Component metadata */
-    meta: SegmentMeta;
-    /** Usage guidelines */
-    usage: SegmentUsage;
-    /** Props documentation (without render functions) */
-    props: Record<string, PropDefinition>;
-    /** Component relationships */
-    relations?: ComponentRelation[];
-    /** Variant names and descriptions (without render functions) */
-    variants: Array<{
-        name: string;
-        description: string;
-        code?: string;
-        figma?: string;
-        /** Args/props used to render this variant (for code generation) */
-        args?: Record<string, unknown>;
-    }>;
-    /** Agent-optimized contract metadata */
-    contract?: SegmentContract;
-    /** AI-specific metadata for playground context generation */
-    ai?: AIMetadata;
-    /** Provenance tracking (for generated segments) */
-    _generated?: SegmentGenerated;
-}
-/**
- * Compiled block data (JSON-serializable for AI consumption)
- */
-interface CompiledBlock {
-    filePath: string;
-    name: string;
-    description: string;
-    category: string;
-    components: string[];
-    code: string;
-    tags?: string[];
-}
-/**
- * A single token entry in the compiled output
- */
-interface CompiledTokenEntry {
-    /** CSS variable name (e.g., "--fui-color-accent") */
-    name: string;
-    /** Description from inline comment */
-    description?: string;
-}
-/**
- * Compiled token data stored in fragments.json
- */
-interface CompiledTokenData {
-    /** Detected variable prefix (e.g., "--fui-") */
-    prefix: string;
-    /** Total number of tokens */
-    total: number;
-    /** Tokens grouped by category */
-    categories: Record<string, CompiledTokenEntry[]>;
-}
-/**
- * The compiled segments.json structure
- */
-interface CompiledSegmentsFile {
-    /** Version of the schema */
-    version: string;
-    /** When this file was generated */
-    generatedAt: string;
-    /** Package name for import statements (read from package.json at build time) */
-    packageName?: string;
-    /** All compiled segments indexed by component name */
-    segments: Record<string, CompiledSegment>;
-    /** All compiled blocks indexed by block name */
-    blocks?: Record<string, CompiledBlock>;
-    /** Design tokens (CSS custom properties) extracted from style files */
-    tokens?: CompiledTokenData;
-    /**
-     * @deprecated Use blocks instead
-     */
-    recipes?: Record<string, CompiledBlock>;
-}
 
 /**
  * Find the config file in the current directory or parent directories.

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   validateAll,
   validateCoverage,
   validateSchema
-} from "./chunk-UXRGD3DM.js";
+} from "./chunk-U4GQ2JTD.js";
 import "./chunk-IOJE35DZ.js";
 import {
   discoverComponentFiles,
@@ -20,7 +20,7 @@ import {
   generateStaticViewer,
   generateViewerFromJson
 } from "./chunk-2DJH4F4P.js";
-import "./chunk-B2TQKOLW.js";
+import "./chunk-V7YLRR4C.js";
 import "./chunk-ICAIQ57V.js";
 export {
   buildSegments,

package/dist/{init-EOA7TTOR.js → init-NION5S3M.js}

@@ -1,5 +1,5 @@
 import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-import "./chunk-B2TQKOLW.js";
+import "./chunk-V7YLRR4C.js";
 import {
   BRAND
 } from "./chunk-ICAIQ57V.js";
@@ -79,7 +79,7 @@ async function detectProject(projectRoot) {
 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';
+  return `import type { FragmentsConfig } from '@fragments-sdk/cli';
 
 const config: FragmentsConfig = {
   // Glob patterns for finding fragment/story files
@@ -153,7 +153,7 @@ export function Button({
 }
 function generateExampleFragment() {
   return `import React from 'react';
-import { defineFragment } from '@fragments/core';
+import { defineFragment } from '@fragments-sdk/cli';
 import { Button } from './Button';
 
 export default defineFragment({
@@ -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-YN4LUDKY.js");
+      const { scan } = await import("./scan-ESEXV7LF.js");
       await scan({
         config: configPath,
         verbose: false
@@ -413,4 +413,4 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
 export {
   init
 };
-//# sourceMappingURL=init-EOA7TTOR.js.map
+//# sourceMappingURL=init-NION5S3M.js.map

package/dist/init-NION5S3M.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-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":";;;;;;;AASA,SAAmB,WAAW,OAAO,cAAc;AACnD,SAAS,SAAS,MAAM,gBAAgB;AACxC,SAAS,aAAa;AACtB,OAAO,QAAQ;AAEf,OAAO,QAAQ;AACf,SAAS,OAAO,eAAuB;AA+BvC,eAAe,cAAc,aAA+C;AAC1E,UAAQ,IAAI,GAAG,IAAI,yBAAyB,CAAC;AAG7C,QAAM,aAAa,KAAK,aAAa,MAAM,UAAU;AACrD,QAAM,mBAAmB,KAAK,aAAa,MAAM,gBAAgB;AACjE,MAAI,YAAY;AAChB,MAAI,kBAAiC;AAErC,MAAI;AACF,UAAM,OAAO,UAAU;AACvB,gBAAY;AACZ,sBAAkB;AAAA,EACpB,QAAQ;AACN,QAAI;AACF,YAAM,OAAO,gBAAgB;AAC7B,kBAAY;AACZ,wBAAkB;AAAA,IACpB,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,aAAa,MAAM;AAAA,IACvB,CAAC,oBAAoB,mBAAmB,oBAAoB,iBAAiB;AAAA,IAC7E;AAAA,MACE,KAAK;AAAA,MACL,QAAQ,CAAC,sBAAsB,cAAc,eAAe,kBAAkB;AAAA,IAChF;AAAA,EACF;AAGA,QAAM,iBAAiB,MAAM;AAAA,IAC3B,CAAC,0BAA0B,0BAA0B,cAAc;AAAA,IACnE;AAAA,MACE,KAAK;AAAA,MACL,QAAQ;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,QAAM,mBAAmB,eAAe,OAAO,CAAC,MAAM;AACpD,UAAM,WAAW,EAAE,MAAM,GAAG,EAAE,IAAI,KAAK;AACvC,WAAO,SAAS,KAAK,QAAQ,KAAK,CAAC,SAAS,SAAS,SAAS;AAAA,EAChE,CAAC;AAGD,MAAI,yBAAyB;AAC7B,MAAI,iBAAiB,SAAS,GAAG;AAC/B,UAAM,iBAAiB,iBAAiB,CAAC;AACzC,UAAM,QAAQ,eAAe,MAAM,GAAG;AACtC,UAAM,kBAAkB,MAAM;AAAA,MAC5B,CAAC,MAAM,EAAE,YAAY,MAAM;AAAA,IAC7B;AACA,QAAI,oBAAoB,IAAI;AAC1B,+BAAyB,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,KAAK,GAAG;AAAA,IACvE;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,EACF;AACF;AAKA,SAAS,eAAe,SAIb;AACT,QAAM,aAAa,QAAQ,aAAa,IAAI,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,KAAK;AAC3E,QAAM,eAAe,QAAQ,eAAe,IAAI,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,KAAK;AAE/E,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKP,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQV,YAAY;AAAA;AAAA;AAAA;AAAA,gBAIE,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA;AAKjC;AAKA,SAAS,2BAAmC;AAC1C,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+CT;AAKA,SAAS,0BAAkC;AACzC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgFT;AAKA,SAAS,eAAe,aAA2B;AACjD,UAAQ,IAAI,GAAG,IAAI,oCAAoC,CAAC;AAGxD,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,MAAM,YAAY,YAAY;AAEpC,QAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,YAAY,KAAK,GAAG;AAAA,IAClD,KAAK;AAAA,IACL,OAAO;AAAA,EACT,CAAC;AAED,QAAM,GAAG,SAAS,CAAC,QAAQ;AACzB,YAAQ,MAAM,GAAG,IAAI,6BAA6B,GAAG,IAAI,OAAO;AAAA,EAClE,CAAC;AACH;AAKA,eAAsB,KAAK,UAAuB,CAAC,GAAwB;AACzE,QAAM,cAAc,QAAQ,QAAQ,eAAe,QAAQ,IAAI,CAAC;AAChE,QAAM,SAAmB,CAAC;AAE1B,UAAQ,IAAI,GAAG,KAAK;AAAA,oBAAkB,MAAM,IAAI;AAAA,CAAK,CAAC;AAGtD,QAAM,YAAY,MAAM,cAAc,WAAW;AAGjD,MAAI,UAAU,aAAa,CAAC,QAAQ,OAAO;AACzC,YAAQ,IAAI,GAAG,OAAO,iCAA4B,MAAM,UAAU,EAAE,CAAC;AAErE,QAAI,CAAC,QAAQ,KAAK;AAChB,YAAM,YAAY,MAAM,QAAQ;AAAA,QAC9B,SAAS;AAAA,QACT,SAAS;AAAA,MACX,CAAC;AAED,UAAI,CAAC,WAAW;AACd,gBAAQ,IAAI,GAAG,IAAI;AAAA,wCAA2C,MAAM,UAAU;AAAA,CAAoB,CAAC;AACnG,eAAO;AAAA,UACL,SAAS;AAAA,UACT,UAAU;AAAA,UACV,cAAc,UAAU,WAAW;AAAA,UACnC,iBAAiB,UAAU,eAAe;AAAA,UAC1C,QAAQ,CAAC;AAAA,QACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,MAAI;AAEJ,MAAI,UAAU,WAAW,SAAS,GAAG;AACnC,eAAW;AACX,YAAQ,IAAI,GAAG,MAAM,gBAAW,UAAU,WAAW,MAAM,0BAA0B,CAAC;AACtF,YAAQ,IAAI,GAAG,IAAI,KAAK,UAAU,WAAW,MAAM,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;AACxE,QAAI,UAAU,WAAW,SAAS,GAAG;AACnC,cAAQ,IAAI,GAAG,IAAI,aAAa,UAAU,WAAW,SAAS,CAAC,OAAO,CAAC;AAAA,IACzE;AACA,YAAQ,IAAI;AACZ,YAAQ;AAAA,MACN,GAAG,KAAK,cAAc,IACpB;AAAA,IACJ;AAAA,EACF,WAAW,UAAU,eAAe,SAAS,GAAG;AAC9C,eAAW;AACX,YAAQ,IAAI,GAAG,MAAM,gBAAW,UAAU,eAAe,MAAM,oBAAoB,CAAC;AACpF,YAAQ,IAAI,GAAG,IAAI,KAAK,UAAU,eAAe,MAAM,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;AAC5E,QAAI,UAAU,eAAe,SAAS,GAAG;AACvC,cAAQ,IAAI,GAAG,IAAI,aAAa,UAAU,eAAe,SAAS,CAAC,OAAO,CAAC;AAAA,IAC7E;AACA,YAAQ,IAAI;AACZ,YAAQ;AAAA,MACN,GAAG,KAAK,qCAAqC,IAC3C;AAAA,IACJ;AAAA,EACF,OAAO;AACL,eAAW;AACX,YAAQ,IAAI,GAAG,OAAO,iCAAiC,CAAC;AACxD,YAAQ,IAAI;AACZ,YAAQ,IAAI,GAAG,KAAK,mCAAmC,CAAC;AAAA,EAC1D;AAEA,UAAQ,IAAI;AAGZ,MAAI,gBAAgB,UAAU;AAC9B,MAAI,UAAU,aAAa;AAC3B,MAAI,gBAAgB,aAAa;AACjC,MAAI,cAAc;AAElB,MAAI,CAAC,QAAQ,KAAK;AAEhB,oBAAgB,MAAM,MAAM;AAAA,MAC1B,SAAS;AAAA,MACT,SAAS,UAAU;AAAA,IACrB,CAAC;AAED,QAAI,aAAa,cAAc;AAE7B,gBAAU,MAAM,QAAQ;AAAA,QACtB,SAAS;AAAA,QACT,SAAS;AAAA,MACX,CAAC;AAAA,IACH,OAAO;AAEL,sBAAgB,MAAM,QAAQ;AAAA,QAC5B,SAAS;AAAA,QACT,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAGA,kBAAc,MAAM,QAAQ;AAAA,MAC1B,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAGA,UAAQ,IAAI,GAAG,IAAI,+BAA+B,CAAC;AAInD,QAAM,eAAyB;AAAA,IAC7B,GAAG,aAAa;AAAA,IAChB,GAAG,aAAa;AAAA;AAAA,EAClB;AAGA,QAAM,aAAa,KAAK,aAAa,MAAM,UAAU;AACrD,QAAM,gBAAgB,eAAe;AAAA,IACnC;AAAA,IACA,gBAAgB,CAAC,GAAG,aAAa,WAAW;AAAA,IAC5C,WAAW;AAAA,EACb,CAAC;AAED,MAAI;AACF,UAAM,UAAU,YAAY,eAAe,OAAO;AAClD,YAAQ,IAAI,GAAG,MAAM,kBAAa,MAAM,UAAU,EAAE,CAAC;AAAA,EACvD,SAAS,GAAG;AACV,WAAO,KAAK,4BAA4B,CAAC,EAAE;AAAA,EAC7C;AAGA,MAAI,aAAa,WAAW,eAAe;AAEzC,UAAM,aAAa,KAAK,aAAa,eAAe,QAAQ;AAE5D,QAAI;AACF,YAAM,MAAM,YAAY,EAAE,WAAW,KAAK,CAAC;AAG3C,YAAM;AAAA,QACJ,KAAK,YAAY,YAAY;AAAA,QAC7B,yBAAyB;AAAA,QACzB;AAAA,MACF;AACA,cAAQ;AAAA,QACN,GAAG,MAAM,kBAAa,SAAS,aAAa,KAAK,YAAY,YAAY,CAAC,CAAC,EAAE;AAAA,MAC/E;AAGA,YAAM;AAAA,QACJ,KAAK,YAAY,qBAAqB;AAAA,QACtC,wBAAwB;AAAA,QACxB;AAAA,MACF;AACA,cAAQ;AAAA,QACN,GAAG;AAAA,UACD,kBAAa,SAAS,aAAa,KAAK,YAAY,qBAAqB,CAAC,CAAC;AAAA,QAC7E;AAAA,MACF;AAAA,IACF,SAAS,GAAG;AACV,aAAO,KAAK,uCAAuC,CAAC,EAAE;AAAA,IACxD;AAAA,EACF;AAEA,MAAI,aAAa,gBAAgB,SAAS;AAExC,YAAQ,IAAI,GAAG,IAAI,kDAAkD,CAAC;AACtE,QAAI;AACF,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO,oBAAW;AACzC,YAAM,KAAK;AAAA,QACT,QAAQ;AAAA,QACR,SAAS;AAAA,MACX,CAAC;AAAA,IACH,SAAS,GAAG;AACV,cAAQ;AAAA,QACN,GAAG,OAAO,kEAAkE;AAAA,MAC9E;AAAA,IACF;AAAA,EACF;AAGA,MAAI,OAAO,WAAW,GAAG;AACvB,YAAQ,IAAI,GAAG,MAAM,4BAAuB,CAAC;AAE7C,QAAI,aAAa;AACf,YAAM,gBACJ,aAAa,YACT,QAAQ,UAAU,WAAW,MAAM,4BACnC,aAAa,eACb,QAAQ,UAAU,eAAe,MAAM,wCACvC;AAEN,cAAQ,IAAI,GAAG,KAAK,aAAa,CAAC;AAClC,qBAAe,WAAW;AAAA,IAC5B,OAAO;AACL,cAAQ,IAAI,GAAG,KAAK,aAAa,CAAC;AAClC,cAAQ,IAAI,YAAY,GAAG,KAAK,GAAG,MAAM,UAAU,MAAM,CAAC,sBAAsB;AAChF,UAAI,aAAa,SAAS;AACxB,gBAAQ,IAAI,aAAa,GAAG,KAAK,GAAG,aAAa,6BAA6B,CAAC,EAAE;AAAA,MACnF;AACA,cAAQ,IAAI;AAAA,IACd;AAAA,EACF;AAEA,SAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B,YAAY,OAAO,WAAW,IAAI,aAAa;AAAA,IAC/C;AAAA,IACA,cAAc,UAAU,WAAW;AAAA,IACnC,iBAAiB,UAAU,eAAe;AAAA,IAC1C;AAAA,EACF;AACF;","names":[]}

package/dist/mcp-bin.js

@@ -2,7 +2,7 @@
 import { createRequire } from 'module'; const require = createRequire(import.meta.url);
 import {
   generateContext
-} from "./chunk-B2TQKOLW.js";
+} from "./chunk-V7YLRR4C.js";
 import {
   BRAND,
   DEFAULTS
@@ -57,7 +57,7 @@ var _service = null;
 async function getService() {
   if (!_service) {
     try {
-      _service = await import("./service-2T26CBWE.js");
+      _service = await import("./service-RWUMZ3EW.js");
     } catch {
       throw new Error(
         "Visual tools require playwright. Install it with: npm install playwright"
@@ -152,6 +152,28 @@ function getWorkspaceDirs(rootDir) {
   }
   return dirs;
 }
+function resolveDepPackageJson(localRequire, depName) {
+  try {
+    return localRequire.resolve(`${depName}/package.json`);
+  } catch {
+  }
+  try {
+    const mainPath = localRequire.resolve(depName);
+    let dir = dirname(mainPath);
+    while (true) {
+      const candidate = join(dir, "package.json");
+      if (existsSync(candidate)) {
+        const pkg = JSON.parse(readFileSync(candidate, "utf-8"));
+        if (pkg.name === depName) return candidate;
+      }
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  } catch {
+  }
+  return null;
+}
 function findFragmentsInDeps(dir, found) {
   const pkgJsonPath = join(dir, "package.json");
   if (!existsSync(pkgJsonPath)) return;
@@ -164,7 +186,8 @@ function findFragmentsInDeps(dir, found) {
     const localRequire = createRequire(join(dir, "noop.js"));
     for (const depName of Object.keys(allDeps)) {
       try {
-        const depPkgPath = localRequire.resolve(`${depName}/package.json`);
+        const depPkgPath = resolveDepPackageJson(localRequire, depName);
+        if (!depPkgPath) continue;
         const depPkg = JSON.parse(readFileSync(depPkgPath, "utf-8"));
         if (depPkg.fragments) {
           const fragmentsPath = join(dirname(depPkgPath), depPkg.fragments);