@fragments-sdk/cli 0.10.1 → 0.12.1

package/dist/{chunk-ZM4ZQZWZ.js → chunk-TPWGL2XS.js}

@@ -1,10 +1,10 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   loadConfig
-} from "./chunk-HRFUSSZI.js";
+} from "./chunk-AM4MRTMN.js";
 import {
   discoverAllComponents
-} from "./chunk-WXSR2II7.js";
+} from "./chunk-OQKMEFOS.js";
 import {
   convertToFragmentProps,
   extractPropsFromFile,
@@ -14,10 +14,10 @@ import {
   inferAllRelations,
   parseAllStories,
   scanCodebase
-} from "./chunk-D5PYOXEI.js";
+} from "./chunk-LVWFOLUZ.js";
 import {
   BRAND
-} from "./chunk-OQO55NKV.js";
+} from "./chunk-WFS63PCW.js";
 
 // src/commands/scan.ts
 import { writeFile, mkdir } from "fs/promises";
@@ -27,6 +27,8 @@ async function scan(options = {}) {
   const startTime = Date.now();
   const errors = [];
   const warnings = [];
+  const log = options.quiet ? (() => {
+  }) : console.log.bind(console);
   let configDir;
   let outputFile;
   let componentPatterns;
@@ -40,18 +42,18 @@ async function scan(options = {}) {
     outputFile = options.output || "fragments.json";
     componentPatterns = options.componentPatterns;
   }
-  console.log(pc.cyan(`
+  log(pc.cyan(`
 ${BRAND.name} Scan
 `));
-  console.log(pc.dim("Zero-config fragments.json generation from source code\n"));
-  console.log(pc.dim("Phase 1: Discovering components..."));
+  log(pc.dim("Zero-config fragments.json generation from source code\n"));
+  log(pc.dim("Phase 1: Discovering components..."));
   const components = await discoverAllComponents(configDir, {
     patterns: componentPatterns,
     exclude: ["**/*.test.*", "**/*.spec.*", "**/__tests__/**"],
     barrelFiles: options.barrelFiles
   });
   if (components.length === 0) {
-    console.log(pc.yellow("No components found. Check your patterns or config."));
+    log(pc.yellow("No components found. Check your patterns or config."));
     return {
       success: false,
       outputPath: resolve(configDir, outputFile),
@@ -64,16 +66,16 @@ ${BRAND.name} Scan
       warnings: []
     };
   }
-  console.log(pc.green(`  Found ${components.length} components`));
+  log(pc.green(`  Found ${components.length} components`));
   if (options.verbose) {
     for (const comp of components.slice(0, 10)) {
-      console.log(pc.dim(`    - ${comp.name}: ${comp.relativePath}`));
+      log(pc.dim(`    - ${comp.name}: ${comp.relativePath}`));
     }
     if (components.length > 10) {
-      console.log(pc.dim(`    ... and ${components.length - 10} more`));
+      log(pc.dim(`    ... and ${components.length - 10} more`));
     }
   }
-  console.log(pc.dim("\nPhase 2: Extracting props from TypeScript..."));
+  log(pc.dim("\nPhase 2: Extracting props from TypeScript..."));
   const propsMap = /* @__PURE__ */ new Map();
   const propsResults = /* @__PURE__ */ new Map();
   let propsExtracted = 0;
@@ -96,12 +98,12 @@ ${BRAND.name} Scan
       }
     }
   }
-  console.log(pc.green(`  Extracted props for ${propsExtracted} components`));
+  log(pc.green(`  Extracted props for ${propsExtracted} components`));
   let usageAnalysis;
   let usagesFound = 0;
   let allRelations = /* @__PURE__ */ new Map();
   if (!options.skipUsage) {
-    console.log(pc.dim("\nPhase 3: Scanning for usage patterns..."));
+    log(pc.dim("\nPhase 3: Scanning for usage patterns..."));
     const usageDir = options.usageDir || configDir;
     try {
       const componentNames = components.map((c) => c.name);
@@ -123,22 +125,22 @@ ${BRAND.name} Scan
         0
       );
       allRelations = inferAllRelations(usageAnalysis);
-      console.log(pc.green(`  Found ${usagesFound} usages across ${usageAnalysis.totalFiles} files`));
-      console.log(pc.green(`  Inferred relations for ${allRelations.size} components`));
+      log(pc.green(`  Found ${usagesFound} usages across ${usageAnalysis.totalFiles} files`));
+      log(pc.green(`  Inferred relations for ${allRelations.size} components`));
     } catch (e) {
       warnings.push({
         component: "*",
         warning: `Usage scanning failed: ${e instanceof Error ? e.message : String(e)}`
       });
-      console.log(pc.yellow(`  Usage scanning failed: ${e instanceof Error ? e.message : "unknown error"}`));
+      log(pc.yellow(`  Usage scanning failed: ${e instanceof Error ? e.message : "unknown error"}`));
     }
   } else {
-    console.log(pc.dim("\nPhase 3: Skipping usage analysis"));
+    log(pc.dim("\nPhase 3: Skipping usage analysis"));
   }
   const storiesMap = /* @__PURE__ */ new Map();
   let storiesParsed = 0;
   if (!options.skipStorybook) {
-    console.log(pc.dim("\nPhase 4: Parsing Storybook stories..."));
+    log(pc.dim("\nPhase 4: Parsing Storybook stories..."));
     try {
       const allStories = await parseAllStories(configDir);
       for (const [name, stories] of Object.entries(allStories)) {
@@ -147,18 +149,18 @@ ${BRAND.name} Scan
           storiesParsed++;
         }
       }
-      console.log(pc.green(`  Parsed stories for ${storiesParsed} components`));
+      log(pc.green(`  Parsed stories for ${storiesParsed} components`));
     } catch (e) {
       warnings.push({
         component: "*",
         warning: `Storybook parsing failed: ${e instanceof Error ? e.message : String(e)}`
       });
-      console.log(pc.yellow(`  Storybook parsing failed: ${e instanceof Error ? e.message : "unknown error"}`));
+      log(pc.yellow(`  Storybook parsing failed: ${e instanceof Error ? e.message : "unknown error"}`));
     }
   } else {
-    console.log(pc.dim("\nPhase 4: Skipping Storybook parsing"));
+    log(pc.dim("\nPhase 4: Skipping Storybook parsing"));
   }
-  console.log(pc.dim("\nPhase 5: Generating fragments..."));
+  log(pc.dim("\nPhase 5: Generating fragments..."));
   const fragments = {};
   for (const comp of components) {
     try {
@@ -187,32 +189,32 @@ ${BRAND.name} Scan
   };
   await writeFile(outputPath, JSON.stringify(output, null, 2));
   const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-  console.log(pc.dim("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(pc.green(`
+  log(pc.dim("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  log(pc.green(`
 \u2713 Generated fragments.json in ${elapsed}s`));
-  console.log(pc.dim(`  Output: ${relative(process.cwd(), outputPath)}`));
-  console.log(pc.dim(`  Components: ${Object.keys(fragments).length}`));
-  console.log(pc.dim(`  Props extracted: ${propsExtracted}`));
-  console.log(pc.dim(`  Usages found: ${usagesFound}`));
-  console.log(pc.dim(`  Relations inferred: ${allRelations.size}`));
-  console.log(pc.dim(`  Stories parsed: ${storiesParsed}`));
+  log(pc.dim(`  Output: ${relative(process.cwd(), outputPath)}`));
+  log(pc.dim(`  Components: ${Object.keys(fragments).length}`));
+  log(pc.dim(`  Props extracted: ${propsExtracted}`));
+  log(pc.dim(`  Usages found: ${usagesFound}`));
+  log(pc.dim(`  Relations inferred: ${allRelations.size}`));
+  log(pc.dim(`  Stories parsed: ${storiesParsed}`));
   if (warnings.length > 0) {
-    console.log(pc.yellow(`
+    log(pc.yellow(`
   ${warnings.length} warning(s)`));
     if (options.verbose) {
       for (const w of warnings) {
-        console.log(pc.dim(`    ${w.component}: ${w.warning}`));
+        log(pc.dim(`    ${w.component}: ${w.warning}`));
       }
     }
   }
   if (errors.length > 0) {
-    console.log(pc.red(`
+    log(pc.red(`
   ${errors.length} error(s)`));
     for (const e of errors) {
-      console.log(pc.dim(`    ${e.component}: ${e.error}`));
+      log(pc.dim(`    ${e.component}: ${e.error}`));
     }
   }
-  console.log();
+  log();
   return {
     success: errors.length === 0,
     outputPath,
@@ -368,4 +370,4 @@ function calculateConfidence(props, usageAnalysis, storyFile) {
 export {
   scan
 };
-//# sourceMappingURL=chunk-ZM4ZQZWZ.js.map
+//# sourceMappingURL=chunk-TPWGL2XS.js.map

package/dist/chunk-TPWGL2XS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/scan.ts"],"sourcesContent":["/**\n * fragments scan - Zero-config fragments.json generation from source code\n *\n * Automatically extracts component documentation by:\n * 1. Discovering components from source files and barrel exports\n * 2. Extracting props from TypeScript interfaces\n * 3. Scanning codebase for usage patterns\n * 4. Parsing Storybook stories for examples\n * 5. Inferring component relationships from usage data\n * 6. Generating complete fragments.json without manual documentation\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { resolve, join, dirname, relative } from \"node:path\";\nimport pc from \"picocolors\";\nimport {\n  BRAND,\n  type CompiledFragmentsFile,\n  type CompiledFragment,\n  type PropDefinition,\n} from \"../core/index.js\";\nimport {\n  loadConfig,\n  discoverAllComponents,\n  type DiscoveredComponent,\n} from \"../core/node.js\";\nimport {\n  scanCodebase,\n  extractPropsFromFile,\n  parseAllStories,\n  inferAllRelations,\n  generateComponentContext,\n  generateEnhancementSuggestions,\n  filterBoilerplate,\n  convertToFragmentProps,\n  type UsageAnalysis,\n  type ComponentRelation,\n  type PropsExtractionResult,\n  type ParsedStoryFile,\n} from \"../service/index.js\";\n\nexport interface ScanOptions {\n  /** Path to config file */\n  config?: string;\n  /** Output file path (default: fragments.json) */\n  output?: string;\n  /** Component patterns to scan */\n  componentPatterns?: string[];\n  /** Barrel export files to parse */\n  barrelFiles?: string[];\n  /** Directory to scan for usage patterns */\n  usageDir?: string;\n  /** Skip usage analysis */\n  skipUsage?: boolean;\n  /** Skip Storybook parsing */\n  skipStorybook?: boolean;\n  /** Verbose output */\n  verbose?: boolean;\n  /** Suppress all console output (for use as a sub-step) */\n  quiet?: boolean;\n}\n\nexport interface ScanResult {\n  success: boolean;\n  outputPath: string;\n  componentCount: number;\n  propsExtracted: number;\n  usagesFound: number;\n  relationsInferred: number;\n  storiesParsed: number;\n  errors: Array<{ component: string; error: string }>;\n  warnings: Array<{ component: string; warning: string }>;\n}\n\n/**\n * Scan codebase and generate fragments.json directly from source\n */\nexport async function scan(options: ScanOptions = {}): Promise<ScanResult> {\n  const startTime = Date.now();\n  const errors: Array<{ component: string; error: string }> = [];\n  const warnings: Array<{ component: string; warning: string }> = [];\n\n  // In quiet mode, suppress all console output\n  const log = options.quiet ? (() => {}) : console.log.bind(console);\n\n  // Load config or use defaults\n  let configDir: string;\n  let outputFile: string;\n  let componentPatterns: string[] | undefined;\n\n  try {\n    const loaded = await loadConfig(options.config);\n    configDir = loaded.configDir;\n    outputFile = options.output || loaded.config.outFile || \"fragments.json\";\n    componentPatterns = options.componentPatterns || loaded.config.components;\n  } catch {\n    // No config file, use defaults\n    configDir = process.cwd();\n    outputFile = options.output || \"fragments.json\";\n    componentPatterns = options.componentPatterns;\n  }\n\n  log(pc.cyan(`\\n${BRAND.name} Scan\\n`));\n  log(pc.dim(\"Zero-config fragments.json generation from source code\\n\"));\n\n  // Phase 1: Discover components\n  log(pc.dim(\"Phase 1: Discovering components...\"));\n  const components = await discoverAllComponents(configDir, {\n    patterns: componentPatterns,\n    exclude: [\"**/*.test.*\", \"**/*.spec.*\", \"**/__tests__/**\"],\n    barrelFiles: options.barrelFiles,\n  });\n\n  if (components.length === 0) {\n    log(pc.yellow(\"No components found. Check your patterns or config.\"));\n    return {\n      success: false,\n      outputPath: resolve(configDir, outputFile),\n      componentCount: 0,\n      propsExtracted: 0,\n      usagesFound: 0,\n      relationsInferred: 0,\n      storiesParsed: 0,\n      errors: [{ component: \"*\", error: \"No components found\" }],\n      warnings: [],\n    };\n  }\n\n  log(pc.green(`  Found ${components.length} components`));\n  if (options.verbose) {\n    for (const comp of components.slice(0, 10)) {\n      log(pc.dim(`    - ${comp.name}: ${comp.relativePath}`));\n    }\n    if (components.length > 10) {\n      log(pc.dim(`    ... and ${components.length - 10} more`));\n    }\n  }\n\n  // Phase 2: Extract props from TypeScript\n  log(pc.dim(\"\\nPhase 2: Extracting props from TypeScript...\"));\n  const propsMap = new Map<string, ReturnType<typeof convertToFragmentProps>>();\n  const propsResults = new Map<string, PropsExtractionResult>();\n  let propsExtracted = 0;\n\n  for (const comp of components) {\n    try {\n      const extraction = await extractPropsFromFile(comp.sourcePath, {\n        propsTypeName: `${comp.name}Props`,\n      });\n\n      propsResults.set(comp.name, extraction);\n\n      if (extraction.success && extraction.props.length > 0) {\n        propsMap.set(comp.name, convertToFragmentProps(extraction.props));\n        propsExtracted++;\n      }\n    } catch (e) {\n      if (options.verbose) {\n        warnings.push({\n          component: comp.name,\n          warning: `Props extraction failed: ${e instanceof Error ? e.message : String(e)}`,\n        });\n      }\n    }\n  }\n\n  log(pc.green(`  Extracted props for ${propsExtracted} components`));\n\n  // Phase 3: Scan for usage patterns\n  let usageAnalysis: UsageAnalysis | undefined;\n  let usagesFound = 0;\n  let allRelations = new Map<string, ComponentRelation[]>();\n\n  if (!options.skipUsage) {\n    log(pc.dim(\"\\nPhase 3: Scanning for usage patterns...\"));\n    const usageDir = options.usageDir || configDir;\n\n    try {\n      // Get component names for filtering\n      const componentNames = components.map((c) => c.name);\n\n      usageAnalysis = await scanCodebase({\n        rootDir: usageDir,\n        include: [\"**/*.tsx\", \"**/*.ts\", \"**/*.jsx\", \"**/*.js\"],\n        exclude: [\n          \"**/node_modules/**\",\n          \"**/dist/**\",\n          \"**/*.stories.*\",\n          \"**/*.test.*\",\n          \"**/*.spec.*\",\n        ],\n        componentNames,\n        useCache: true,\n      });\n\n      // Count total usages across all components\n      usagesFound = Object.values(usageAnalysis.components).reduce(\n        (sum, comp) => sum + comp.totalUsages,\n        0\n      );\n\n      // Infer relations\n      allRelations = inferAllRelations(usageAnalysis);\n      log(pc.green(`  Found ${usagesFound} usages across ${usageAnalysis.totalFiles} files`));\n      log(pc.green(`  Inferred relations for ${allRelations.size} components`));\n    } catch (e) {\n      warnings.push({\n        component: \"*\",\n        warning: `Usage scanning failed: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      log(pc.yellow(`  Usage scanning failed: ${e instanceof Error ? e.message : \"unknown error\"}`));\n    }\n  } else {\n    log(pc.dim(\"\\nPhase 3: Skipping usage analysis\"));\n  }\n\n  // Phase 4: Parse Storybook stories\n  const storiesMap = new Map<string, ParsedStoryFile>();\n  let storiesParsed = 0;\n\n  if (!options.skipStorybook) {\n    log(pc.dim(\"\\nPhase 4: Parsing Storybook stories...\"));\n\n    try {\n      const allStories = await parseAllStories(configDir);\n\n      for (const [name, stories] of Object.entries(allStories)) {\n        if (stories && stories.stories.length > 0) {\n          storiesMap.set(name, stories);\n          storiesParsed++;\n        }\n      }\n\n      log(pc.green(`  Parsed stories for ${storiesParsed} components`));\n    } catch (e) {\n      warnings.push({\n        component: \"*\",\n        warning: `Storybook parsing failed: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      log(pc.yellow(`  Storybook parsing failed: ${e instanceof Error ? e.message : \"unknown error\"}`));\n    }\n  } else {\n    log(pc.dim(\"\\nPhase 4: Skipping Storybook parsing\"));\n  }\n\n  // Phase 5: Generate fragments\n  log(pc.dim(\"\\nPhase 5: Generating fragments...\"));\n  const fragments: Record<string, CompiledFragment> = {};\n\n  for (const comp of components) {\n    try {\n      const fragment = generateFragmentFromData(\n        comp,\n        configDir,\n        propsMap.get(comp.name),\n        usageAnalysis?.components[comp.name],\n        allRelations.get(comp.name),\n        storiesMap.get(comp.name)\n      );\n\n      fragments[comp.name] = fragment;\n    } catch (e) {\n      errors.push({\n        component: comp.name,\n        error: e instanceof Error ? e.message : String(e),\n      });\n    }\n  }\n\n  // Write output\n  const outputPath = resolve(configDir, outputFile);\n  await mkdir(dirname(outputPath), { recursive: true });\n\n  const output: CompiledFragmentsFile = {\n    version: \"1.0.0\",\n    generatedAt: new Date().toISOString(),\n    fragments,\n  };\n\n  await writeFile(outputPath, JSON.stringify(output, null, 2));\n\n  const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);\n\n  // Summary\n  log(pc.dim(\"\\n────────────────────────────────────────\"));\n  log(pc.green(`\\n✓ Generated fragments.json in ${elapsed}s`));\n  log(pc.dim(`  Output: ${relative(process.cwd(), outputPath)}`));\n  log(pc.dim(`  Components: ${Object.keys(fragments).length}`));\n  log(pc.dim(`  Props extracted: ${propsExtracted}`));\n  log(pc.dim(`  Usages found: ${usagesFound}`));\n  log(pc.dim(`  Relations inferred: ${allRelations.size}`));\n  log(pc.dim(`  Stories parsed: ${storiesParsed}`));\n\n  if (warnings.length > 0) {\n    log(pc.yellow(`\\n  ${warnings.length} warning(s)`));\n    if (options.verbose) {\n      for (const w of warnings) {\n        log(pc.dim(`    ${w.component}: ${w.warning}`));\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    log(pc.red(`\\n  ${errors.length} error(s)`));\n    for (const e of errors) {\n      log(pc.dim(`    ${e.component}: ${e.error}`));\n    }\n  }\n\n  log();\n\n  return {\n    success: errors.length === 0,\n    outputPath,\n    componentCount: Object.keys(fragments).length,\n    propsExtracted,\n    usagesFound,\n    relationsInferred: allRelations.size,\n    storiesParsed,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Generate a CompiledFragment from extracted data\n */\nfunction generateFragmentFromData(\n  comp: DiscoveredComponent,\n  configDir: string,\n  props: Record<string, PropDefinition> | undefined,\n  usageAnalysis: UsageAnalysis[\"components\"][string] | undefined,\n  relations: ComponentRelation[] | undefined,\n  storyFile: ParsedStoryFile | undefined\n): CompiledFragment {\n  // Generate context for AI suggestions\n  const context = generateComponentContext(\n    comp.name,\n    usageAnalysis,\n    undefined, // No extracted docs yet\n    storyFile,\n    undefined, // No props extraction result (we have the converted props already)\n    relations\n  );\n\n  // Generate enhancement suggestions from context\n  const suggestions = generateEnhancementSuggestions(context);\n\n  // Filter boilerplate from suggestions\n  const when = filterBoilerplate(suggestions.suggestions.when);\n  const whenNot = filterBoilerplate(suggestions.suggestions.whenNot);\n\n  // Infer category from path\n  const category = inferCategory(comp.relativePath);\n\n  // Infer status from path\n  const status = inferStatus(comp.relativePath);\n\n  // Build variants from stories\n  const variants: CompiledFragment[\"variants\"] = [];\n  if (storyFile?.stories) {\n    for (const story of storyFile.stories) {\n      variants.push({\n        name: story.name,\n        description: story.description || `${story.displayName} variant`,\n        code: story.code,\n      });\n    }\n  }\n\n  // Build relations\n  const compiledRelations: CompiledFragment[\"relations\"] = [];\n  if (relations && relations.length > 0) {\n    for (const rel of relations.slice(0, 10)) {\n      compiledRelations.push({\n        component: rel.component,\n        relationship: rel.relationship,\n        note: `Appears together ${rel.frequency} times`,\n      });\n    }\n  }\n\n  // Generate description\n  const description = generateDescription(comp.name, props, usageAnalysis);\n\n  return {\n    filePath: comp.relativePath,\n    meta: {\n      name: comp.name,\n      description,\n      category,\n      status,\n    },\n    usage: {\n      when: when.length > 0 ? when : [`Use ${comp.name} for its intended purpose`],\n      whenNot: whenNot,\n    },\n    props: props || {},\n    relations: compiledRelations.length > 0 ? compiledRelations : undefined,\n    variants,\n    _generated: {\n      source: \"ai\",\n      sourceFile: comp.relativePath,\n      confidence: calculateConfidence(props, usageAnalysis, storyFile),\n      timestamp: new Date().toISOString(),\n    },\n  };\n}\n\n/**\n * Infer category from file path\n */\nfunction inferCategory(relativePath: string): string {\n  const parts = relativePath.toLowerCase().split(\"/\");\n\n  // Common category patterns\n  const categoryPatterns: Record<string, string[]> = {\n    \"Actions\": [\"button\", \"action\", \"cta\"],\n    \"Forms\": [\"form\", \"input\", \"select\", \"checkbox\", \"radio\", \"textarea\", \"field\"],\n    \"Layout\": [\"layout\", \"container\", \"grid\", \"flex\", \"stack\", \"box\", \"divider\", \"spacer\"],\n    \"Navigation\": [\"nav\", \"menu\", \"breadcrumb\", \"tab\", \"link\", \"pagination\"],\n    \"Feedback\": [\"alert\", \"toast\", \"notification\", \"message\", \"badge\", \"indicator\", \"progress\", \"spinner\", \"loading\"],\n    \"Data Display\": [\"table\", \"list\", \"card\", \"avatar\", \"stat\", \"timeline\", \"tree\"],\n    \"Overlays\": [\"modal\", \"dialog\", \"drawer\", \"popover\", \"tooltip\", \"dropdown\"],\n    \"Typography\": [\"text\", \"heading\", \"title\", \"label\", \"paragraph\"],\n    \"Media\": [\"image\", \"video\", \"icon\", \"avatar\"],\n  };\n\n  for (const [category, patterns] of Object.entries(categoryPatterns)) {\n    for (const pattern of patterns) {\n      if (parts.some((part) => part.includes(pattern))) {\n        return category;\n      }\n    }\n  }\n\n  // Check path structure for category\n  const componentIdx = parts.findIndex((p) => p === \"components\");\n  if (componentIdx !== -1 && parts.length > componentIdx + 1) {\n    const categoryPart = parts[componentIdx + 1];\n    return categoryPart.charAt(0).toUpperCase() + categoryPart.slice(1);\n  }\n\n  return \"Components\";\n}\n\n/**\n * Infer status from file path\n */\nfunction inferStatus(\n  relativePath: string\n): \"stable\" | \"beta\" | \"experimental\" | \"deprecated\" {\n  const lowerPath = relativePath.toLowerCase();\n\n  if (lowerPath.includes(\"/experimental/\") || lowerPath.includes(\"/labs/\")) {\n    return \"experimental\";\n  }\n  if (lowerPath.includes(\"/beta/\")) {\n    return \"beta\";\n  }\n  if (lowerPath.includes(\"/deprecated/\") || lowerPath.includes(\"/legacy/\")) {\n    return \"deprecated\";\n  }\n\n  return \"stable\";\n}\n\n/**\n * Generate component description\n */\nfunction generateDescription(\n  name: string,\n  props: Record<string, PropDefinition> | undefined,\n  usageAnalysis: UsageAnalysis[\"components\"][string] | undefined\n): string {\n  // Convert name to readable form\n  const words = name\n    .replace(/([A-Z])/g, \" $1\")\n    .trim()\n    .toLowerCase();\n\n  // Check props for hints\n  const hasOnClick = props && (\"onClick\" in props || \"onPress\" in props);\n  const hasValue = props && (\"value\" in props || \"defaultValue\" in props);\n  const hasChildren = props && \"children\" in props;\n  const hasHref = props && \"href\" in props;\n\n  // Check usage contexts\n  const topContext = usageAnalysis?.contexts[0]?.type;\n\n  if (hasHref) {\n    return `Navigational ${words} for linking to other pages or resources`;\n  }\n\n  if (hasOnClick && !hasValue) {\n    return `Interactive ${words} for triggering actions`;\n  }\n\n  if (hasValue) {\n    return `Form ${words} for user input`;\n  }\n\n  if (topContext && topContext !== \"unknown\") {\n    return `${words.charAt(0).toUpperCase() + words.slice(1)} commonly used in ${topContext} contexts`;\n  }\n\n  if (hasChildren) {\n    return `Container ${words} for composing UI`;\n  }\n\n  return `${words.charAt(0).toUpperCase() + words.slice(1)} component`;\n}\n\n/**\n * Calculate confidence score based on available data\n */\nfunction calculateConfidence(\n  props: Record<string, PropDefinition> | undefined,\n  usageAnalysis: UsageAnalysis[\"components\"][string] | undefined,\n  storyFile: ParsedStoryFile | undefined\n): number {\n  let confidence = 0;\n\n  // Props give +30 confidence\n  if (props && Object.keys(props).length > 0) {\n    confidence += 30;\n  }\n\n  // Usage data gives up to +40 confidence\n  if (usageAnalysis) {\n    if (usageAnalysis.totalUsages > 10) confidence += 40;\n    else if (usageAnalysis.totalUsages > 5) confidence += 30;\n    else if (usageAnalysis.totalUsages > 0) confidence += 20;\n  }\n\n  // Stories give +30 confidence\n  if (storyFile && storyFile.stories.length > 0) {\n    confidence += 30;\n  }\n\n  return Math.min(confidence, 100);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-OQO55NKV.js → chunk-WFS63PCW.js}

@@ -241,7 +241,13 @@ var fragmentContractSchema = z.object({
   a11yRules: z.array(z.string()).optional(),
   bans: z.array(fragmentBanSchema).optional(),
   scenarioTags: z.array(z.string()).optional(),
-  performanceBudget: z.number().positive().optional()
+  performanceBudget: z.number().positive().optional(),
+  compoundChildren: z.record(z.object({
+    required: z.boolean().optional(),
+    accepts: z.array(z.string()).optional(),
+    description: z.string().optional()
+  })).optional(),
+  canonicalUsage: z.array(z.string()).optional()
 });
 var fragmentGeneratedSchema = z.object({
   source: z.enum(["storybook", "manual", "ai"]),
@@ -314,14 +320,76 @@ var fragmentsConfigSchema = z.object({
     excludeSubComponents: z.boolean().optional()
   }).optional()
 });
+var compositionMetadataSchema = z.object({
+  pattern: z.enum(["compound", "simple", "controlled", "wrapper"]).optional(),
+  subComponents: z.array(z.string()).optional(),
+  requiredChildren: z.array(z.string()).optional(),
+  commonPatterns: z.array(z.string()).optional()
+});
+var fragmentProvenanceSchema = z.object({
+  source: z.enum(["storybook", "manual", "ai", "scan"]),
+  sourceFile: z.string().optional(),
+  confidence: z.number().min(0).max(1).optional(),
+  timestamp: z.string().datetime().optional(),
+  autoFields: z.array(z.string()).optional(),
+  humanFields: z.array(z.string()).optional()
+});
+var fragmentDefinitionV2Schema = z.object({
+  component: z.any(),
+  meta: fragmentMetaSchema,
+  guidance: fragmentUsageSchema,
+  props: z.record(propDefinitionSchema),
+  relations: z.array(componentRelationSchema).optional(),
+  examples: z.array(fragmentVariantSchema),
+  composition: compositionMetadataSchema.optional(),
+  contract: fragmentContractSchema.optional(),
+  _provenance: fragmentProvenanceSchema.optional()
+});
 var recipeDefinitionSchema = blockDefinitionSchema;
+function isV2Definition(def) {
+  return "guidance" in def || "examples" in def;
+}
+function normalizeToV1(def) {
+  let ai;
+  if (def.composition) {
+    ai = {
+      compositionPattern: def.composition.pattern,
+      subComponents: def.composition.subComponents,
+      requiredChildren: def.composition.requiredChildren,
+      commonPatterns: def.composition.commonPatterns
+    };
+  }
+  let generated;
+  if (def._provenance) {
+    generated = {
+      source: def._provenance.source === "scan" ? "ai" : def._provenance.source,
+      sourceFile: def._provenance.sourceFile,
+      confidence: def._provenance.confidence,
+      timestamp: def._provenance.timestamp
+    };
+  }
+  return {
+    component: def.component,
+    meta: def.meta,
+    usage: def.guidance,
+    props: def.props,
+    relations: def.relations,
+    variants: def.examples,
+    contract: def.contract,
+    ai,
+    _generated: generated
+  };
+}
 function defineFragment(definition) {
   if (process.env.NODE_ENV !== "production") {
-    const result = fragmentDefinitionSchema.safeParse(definition);
+    const v2 = isV2Definition(definition);
+    const schema = v2 ? fragmentDefinitionV2Schema : fragmentDefinitionSchema;
+    const result = schema.safeParse(definition);
     if (!result.success) {
+      const name = definition.meta?.name || "unknown";
       const errors = result.error.errors.map((e) => `  - ${e.path.join(".")}: ${e.message}`).join("\n");
       throw new Error(
-        `Invalid fragment definition for "${definition.meta?.name || "unknown"}":
+        `Invalid fragment definition for "${name}":
 ${errors}`
       );
     }
@@ -329,20 +397,22 @@ ${errors}`
   return definition;
 }
 function compileFragment(definition, filePath) {
+  const v1 = isV2Definition(definition) ? normalizeToV1(definition) : definition;
   return {
     filePath,
-    meta: definition.meta,
-    usage: definition.usage,
-    props: definition.props,
-    relations: definition.relations,
-    variants: definition.variants.map((v) => ({
+    meta: v1.meta,
+    usage: v1.usage,
+    props: v1.props,
+    relations: v1.relations,
+    variants: v1.variants.map((v) => ({
       name: v.name,
       description: v.description,
       code: v.code,
       figma: v.figma
     })),
-    contract: definition.contract,
-    _generated: definition._generated
+    contract: v1.contract,
+    ai: v1.ai,
+    _generated: v1._generated
   };
 }
 function defineBlock(definition) {
@@ -1379,7 +1449,11 @@ export {
   blockDefinitionSchema,
   fragmentDefinitionSchema,
   fragmentsConfigSchema,
+  compositionMetadataSchema,
+  fragmentProvenanceSchema,
+  fragmentDefinitionV2Schema,
   recipeDefinitionSchema,
+  normalizeToV1,
   defineFragment,
   compileFragment,
   defineBlock,
@@ -1407,4 +1481,4 @@ export {
   usePreviewVariantRuntime,
   PreviewVariantRuntime
 };
-//# sourceMappingURL=chunk-OQO55NKV.js.map
+//# sourceMappingURL=chunk-WFS63PCW.js.map