@fragments-sdk/cli 0.14.3 → 0.15.1

package/dist/chunk-ONUP6Z4W.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  findConfigFile,\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\";\nimport { getGeneratorVersion } from '@fragments-sdk/compiler';\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        componentName: comp.name,\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  const generatorVersion = await getGeneratorVersion();\n  const buildInputs = components\n    .map((component) => relative(configDir, component.sourcePath).split(\"\\\\\").join(\"/\"))\n    .sort();\n  const configPath = options.config ? resolve(process.cwd(), options.config) : findConfigFile(configDir);\n  if (configPath) {\n    buildInputs.push(relative(configDir, configPath).split(\"\\\\\").join(\"/\"));\n    buildInputs.sort();\n  }\n\n  const output: CompiledFragmentsFile = {\n    version: \"1.0.0\",\n    generatedAt: new Date().toISOString(),\n    generatorVersion,\n    buildInputs,\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-QCN35LJU.js

@@ -0,0 +1,630 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import {
+  scanFile
+} from "./chunk-7DZC4YEV.js";
+
+// src/service/enhance/codebase-scanner.ts
+import fg from "fast-glob";
+import { readFile as readFile2 } from "fs/promises";
+import { relative, resolve, dirname as dirname2 } from "path";
+
+// src/service/enhance/aggregator.ts
+function aggregateComponentUsages(componentName, sourceFile, usages, imports) {
+  const uniqueFiles = new Set(usages.map((u) => u.filePath));
+  const patternMap = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const propKey = createPropKey(usage.props.static);
+    const existing = patternMap.get(propKey);
+    if (existing) {
+      existing.count++;
+      if (!existing.files.includes(usage.filePath)) {
+        existing.files.push(usage.filePath);
+      }
+      if (existing.sampleContexts.length < 3) {
+        existing.sampleContexts.push(usage.context);
+      }
+    } else {
+      patternMap.set(propKey, {
+        props: { ...usage.props.static },
+        count: 1,
+        files: [usage.filePath],
+        sampleContexts: [usage.context]
+      });
+    }
+  }
+  const patterns = Array.from(patternMap.values()).sort(
+    (a, b) => b.count - a.count
+  );
+  const contextMap = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const context = classifyFileContext(usage.filePath, usage.context);
+    const existing = contextMap.get(context);
+    if (existing) {
+      existing.count++;
+      if (!existing.files.includes(usage.filePath)) {
+        existing.files.push(usage.filePath);
+      }
+    } else {
+      contextMap.set(context, { count: 1, files: [usage.filePath] });
+    }
+  }
+  const contexts = Array.from(contextMap.entries()).map(([type, data]) => ({ type, ...data })).sort((a, b) => b.count - a.count);
+  return {
+    name: componentName,
+    sourceFile,
+    totalUsages: usages.length,
+    uniqueFiles: uniqueFiles.size,
+    patterns,
+    contexts,
+    usages,
+    imports
+  };
+}
+function aggregateAllUsages(usages, imports, componentSources) {
+  const usagesByComponent = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const existing = usagesByComponent.get(usage.componentName) ?? [];
+    existing.push(usage);
+    usagesByComponent.set(usage.componentName, existing);
+  }
+  const importsByComponent = /* @__PURE__ */ new Map();
+  for (const imp of imports) {
+    const existing = importsByComponent.get(imp.componentName) ?? [];
+    existing.push(imp);
+    importsByComponent.set(imp.componentName, existing);
+  }
+  const components = {};
+  const allComponentNames = /* @__PURE__ */ new Set([
+    ...usagesByComponent.keys(),
+    ...importsByComponent.keys()
+  ]);
+  for (const componentName of allComponentNames) {
+    const componentUsages = usagesByComponent.get(componentName) ?? [];
+    const componentImports = importsByComponent.get(componentName) ?? [];
+    const sourceFile = componentSources.get(componentName) ?? "unknown";
+    components[componentName] = aggregateComponentUsages(
+      componentName,
+      sourceFile,
+      componentUsages,
+      componentImports
+    );
+  }
+  const allFiles = /* @__PURE__ */ new Set();
+  for (const usage of usages) {
+    allFiles.add(usage.filePath);
+  }
+  for (const imp of imports) {
+    allFiles.add(imp.filePath);
+  }
+  return {
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    rootDir: "",
+    // Will be set by caller
+    totalFiles: allFiles.size,
+    totalComponents: Object.keys(components).length,
+    components,
+    errorFiles: []
+    // Will be populated by scanner
+  };
+}
+function createPropKey(props) {
+  const entries = Object.entries(props).sort(([a], [b]) => a.localeCompare(b));
+  return entries.map(([k, v]) => `${k}=${JSON.stringify(v)}`).join("|");
+}
+function classifyFileContext(filePath, context) {
+  const lowerPath = filePath.toLowerCase();
+  const lowerContext = context.toLowerCase();
+  if (lowerPath.includes("/modal") || lowerPath.includes("modal.") || lowerContext.includes("<modal")) {
+    return "modal";
+  }
+  if (lowerPath.includes("/dialog") || lowerPath.includes("dialog.") || lowerContext.includes("<dialog")) {
+    return "dialog";
+  }
+  if (lowerPath.includes("/form") || lowerPath.includes("form.") || lowerContext.includes("<form") || lowerContext.includes("onsubmit")) {
+    return "form";
+  }
+  if (lowerPath.includes("/page") || lowerPath.includes("pages/") || lowerPath.includes("/routes/")) {
+    return "page";
+  }
+  if (lowerPath.includes("/layout") || lowerPath.includes("layout.") || lowerPath.includes("/layouts/")) {
+    return "layout";
+  }
+  if (lowerPath.includes("/card") || lowerPath.includes("card.") || lowerContext.includes("<card")) {
+    return "card";
+  }
+  if (lowerPath.includes("/table") || lowerPath.includes("table.") || lowerContext.includes("<table") || lowerContext.includes("<tr")) {
+    return "table";
+  }
+  if (lowerPath.includes("/list") || lowerPath.includes("list.") || lowerContext.includes("<ul") || lowerContext.includes("<ol") || lowerContext.includes("<li")) {
+    return "list";
+  }
+  if (lowerPath.includes("/nav") || lowerPath.includes("navigation") || lowerContext.includes("<nav")) {
+    return "navigation";
+  }
+  if (lowerPath.includes("/header") || lowerPath.includes("header.") || lowerContext.includes("<header")) {
+    return "header";
+  }
+  if (lowerPath.includes("/footer") || lowerPath.includes("footer.") || lowerContext.includes("<footer")) {
+    return "footer";
+  }
+  if (lowerPath.includes("/sidebar") || lowerPath.includes("sidebar.") || lowerContext.includes("<aside")) {
+    return "sidebar";
+  }
+  return "unknown";
+}
+function findCommonPropCombinations(usages, minOccurrences = 3) {
+  const combinations = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const allProps = [
+      ...Object.keys(usage.props.static),
+      ...usage.props.dynamic
+    ].sort();
+    for (let size = 2; size <= Math.min(allProps.length, 4); size++) {
+      for (const combo of combinations_k(allProps, size)) {
+        const key = combo.join(",");
+        combinations.set(key, (combinations.get(key) ?? 0) + 1);
+      }
+    }
+  }
+  return Array.from(combinations.entries()).filter(([, count]) => count >= minOccurrences).map(([key, count]) => ({ props: key.split(","), count })).sort((a, b) => b.count - a.count);
+}
+function* combinations_k(arr, k) {
+  if (k === 0) {
+    yield [];
+    return;
+  }
+  if (arr.length < k) return;
+  for (let i = 0; i <= arr.length - k; i++) {
+    for (const combo of combinations_k(arr.slice(i + 1), k - 1)) {
+      yield [arr[i], ...combo];
+    }
+  }
+}
+function inferRelations(componentName, analysis, allAnalyses) {
+  const relations = [];
+  const parentCounts = /* @__PURE__ */ new Map();
+  const siblingCounts = /* @__PURE__ */ new Map();
+  for (const usage of analysis.usages) {
+    if (usage.parentElement && usage.parentElement !== "div" && usage.parentElement !== "span") {
+      const parent = usage.parentElement;
+      const existing = parentCounts.get(parent);
+      if (existing) {
+        existing.count++;
+        if (!existing.files.includes(usage.filePath)) {
+          existing.files.push(usage.filePath);
+        }
+      } else {
+        parentCounts.set(parent, { count: 1, files: [usage.filePath] });
+      }
+    }
+  }
+  const filesWithThisComponent = new Set(analysis.usages.map((u) => u.filePath));
+  for (const [otherName, otherAnalysis] of Object.entries(allAnalyses)) {
+    if (otherName === componentName) continue;
+    let sharedFiles = 0;
+    const sharedFileList = [];
+    for (const usage of otherAnalysis.usages) {
+      if (filesWithThisComponent.has(usage.filePath)) {
+        if (!sharedFileList.includes(usage.filePath)) {
+          sharedFiles++;
+          sharedFileList.push(usage.filePath);
+        }
+      }
+    }
+    if (sharedFiles >= 3) {
+      siblingCounts.set(otherName, {
+        count: sharedFiles,
+        files: sharedFileList.slice(0, 5)
+      });
+    }
+  }
+  for (const [parent, data] of parentCounts) {
+    if (data.count >= 2) {
+      relations.push({
+        component: parent,
+        relationship: "parent",
+        frequency: data.count,
+        sampleFiles: data.files.slice(0, 3)
+      });
+    }
+  }
+  for (const [sibling, data] of siblingCounts) {
+    relations.push({
+      component: sibling,
+      relationship: "sibling",
+      frequency: data.count,
+      sampleFiles: data.files.slice(0, 3)
+    });
+  }
+  relations.sort((a, b) => b.frequency - a.frequency);
+  return relations;
+}
+function inferAllRelations(analysis) {
+  const allRelations = /* @__PURE__ */ new Map();
+  for (const [componentName, componentAnalysis] of Object.entries(analysis.components)) {
+    const relations = inferRelations(componentName, componentAnalysis, analysis.components);
+    if (relations.length > 0) {
+      allRelations.set(componentName, relations);
+    }
+  }
+  return allRelations;
+}
+function summarizePatternsForPrompt(analysis, maxPatterns = 10, maxContexts = 5) {
+  const lines = [];
+  lines.push(`## ${analysis.name}`);
+  lines.push(`Total usages: ${analysis.totalUsages} across ${analysis.uniqueFiles} files`);
+  lines.push("");
+  lines.push("### Usage Patterns (by frequency)");
+  const topPatterns = analysis.patterns.slice(0, maxPatterns);
+  for (const pattern of topPatterns) {
+    const propsStr = Object.entries(pattern.props).map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(", ");
+    lines.push(`- ${propsStr || "(no props)"}: ${pattern.count} usages in ${pattern.files.length} files`);
+  }
+  lines.push("");
+  lines.push("### File Contexts");
+  const topContexts = analysis.contexts.slice(0, maxContexts);
+  for (const ctx of topContexts) {
+    lines.push(`- ${ctx.type}: ${ctx.count} usages`);
+  }
+  lines.push("");
+  lines.push("### Sample Usages");
+  for (const pattern of topPatterns.slice(0, 3)) {
+    if (pattern.sampleContexts[0]) {
+      lines.push("```tsx");
+      lines.push(pattern.sampleContexts[0].trim());
+      lines.push("```");
+      lines.push("");
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/service/enhance/cache.ts
+import { readFile, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import { createHash } from "crypto";
+import { join, dirname } from "path";
+import { mkdir } from "fs/promises";
+var CURRENT_CACHE_VERSION = 1;
+var CACHE_FILENAME = "analysis-cache.json";
+function getCachePath(rootDir) {
+  return join(rootDir, ".fragments", CACHE_FILENAME);
+}
+async function loadCache(rootDir) {
+  const cachePath = getCachePath(rootDir);
+  if (!existsSync(cachePath)) {
+    return null;
+  }
+  try {
+    const content = await readFile(cachePath, "utf-8");
+    const cache = JSON.parse(content);
+    if (cache.version !== CURRENT_CACHE_VERSION) {
+      console.warn(
+        `Cache version mismatch: expected ${CURRENT_CACHE_VERSION}, got ${cache.version}. Invalidating cache.`
+      );
+      return null;
+    }
+    if (cache.rootDir !== rootDir) {
+      console.warn(`Cache root mismatch. Invalidating cache.`);
+      return null;
+    }
+    return cache;
+  } catch (error) {
+    console.warn(`Failed to load cache: ${error.message}`);
+    return null;
+  }
+}
+async function saveCache(rootDir, cache) {
+  const cachePath = getCachePath(rootDir);
+  const cacheDir = dirname(cachePath);
+  if (!existsSync(cacheDir)) {
+    await mkdir(cacheDir, { recursive: true });
+  }
+  cache.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeFile(cachePath, JSON.stringify(cache, null, 2));
+}
+function createEmptyCache(rootDir) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    version: CURRENT_CACHE_VERSION,
+    createdAt: now,
+    updatedAt: now,
+    rootDir,
+    files: {}
+  };
+}
+function computeFileHash(content) {
+  return createHash("md5").update(content).digest("hex");
+}
+function getCachedFile(cache, filePath) {
+  return cache.files[filePath] ?? null;
+}
+function updateCacheFile(cache, filePath, hash, imports, usages) {
+  cache.files[filePath] = {
+    hash,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    imports,
+    usages
+  };
+}
+function removeCacheFile(cache, filePath) {
+  delete cache.files[filePath];
+}
+async function detectFileChanges(cache, currentFiles, getFileHash) {
+  const changes = {
+    added: [],
+    modified: [],
+    deleted: [],
+    unchanged: []
+  };
+  const currentFileSet = new Set(currentFiles);
+  const cachedFileSet = new Set(Object.keys(cache.files));
+  for (const filePath of currentFiles) {
+    const entry = cache.files[filePath];
+    if (!entry) {
+      changes.added.push(filePath);
+    } else {
+      const currentHash = await getFileHash(filePath);
+      if (currentHash !== entry.hash) {
+        changes.modified.push(filePath);
+      } else {
+        changes.unchanged.push(filePath);
+      }
+    }
+  }
+  for (const cachedFile of cachedFileSet) {
+    if (!currentFileSet.has(cachedFile)) {
+      changes.deleted.push(cachedFile);
+    }
+  }
+  return changes;
+}
+function getCacheStats(cache) {
+  let totalImports = 0;
+  let totalUsages = 0;
+  for (const entry of Object.values(cache.files)) {
+    totalImports += entry.imports.length;
+    totalUsages += entry.usages.length;
+  }
+  const ageMs = Date.now() - new Date(cache.updatedAt).getTime();
+  const ageMinutes = Math.round(ageMs / 6e4);
+  const cacheAge = ageMinutes < 60 ? `${ageMinutes} minutes ago` : ageMinutes < 1440 ? `${Math.round(ageMinutes / 60)} hours ago` : `${Math.round(ageMinutes / 1440)} days ago`;
+  return {
+    totalFiles: Object.keys(cache.files).length,
+    totalImports,
+    totalUsages,
+    cacheAge
+  };
+}
+
+// src/service/enhance/codebase-scanner.ts
+var DEFAULT_INCLUDE = [
+  "**/*.tsx",
+  "**/*.ts",
+  "**/*.jsx",
+  "**/*.js"
+];
+var DEFAULT_EXCLUDE = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/.next/**",
+  "**/coverage/**",
+  "**/__tests__/**",
+  "**/*.test.*",
+  "**/*.spec.*",
+  "**/*.stories.*",
+  "**/*.fragment.*",
+  "**/storybook-static/**"
+];
+async function scanCodebase(options) {
+  const {
+    rootDir,
+    include = DEFAULT_INCLUDE,
+    exclude = DEFAULT_EXCLUDE,
+    componentNames,
+    useCache = true,
+    onProgress
+  } = options;
+  const absoluteRoot = resolve(rootDir);
+  let cache = null;
+  if (useCache) {
+    cache = await loadCache(absoluteRoot);
+  }
+  if (!cache) {
+    cache = createEmptyCache(absoluteRoot);
+  }
+  onProgress?.({
+    current: 0,
+    total: 0,
+    currentFile: "",
+    phase: "discovering"
+  });
+  const files = await fg(include, {
+    cwd: absoluteRoot,
+    ignore: exclude,
+    absolute: true,
+    onlyFiles: true
+  });
+  const totalFiles = files.length;
+  const trackedComponents = componentNames ? new Set(componentNames) : void 0;
+  const allImports = [];
+  const allUsages = [];
+  const errorFiles = [];
+  const componentSources = /* @__PURE__ */ new Map();
+  for (let i = 0; i < files.length; i++) {
+    const filePath = files[i];
+    const relativePath = relative(absoluteRoot, filePath);
+    onProgress?.({
+      current: i + 1,
+      total: totalFiles,
+      currentFile: relativePath,
+      phase: "scanning"
+    });
+    try {
+      const content = await readFile2(filePath, "utf-8");
+      const fileHash = computeFileHash(content);
+      const cachedEntry = getCachedFile(cache, filePath);
+      if (cachedEntry && cachedEntry.hash === fileHash) {
+        allImports.push(...cachedEntry.imports);
+        allUsages.push(...cachedEntry.usages);
+        for (const imp of cachedEntry.imports) {
+          if (!componentSources.has(imp.componentName)) {
+            const sourceFile = resolveImportSource(filePath, imp.source);
+            if (sourceFile) {
+              componentSources.set(imp.componentName, sourceFile);
+            }
+          }
+        }
+        continue;
+      }
+      const { imports, usages } = await scanFile(filePath, trackedComponents);
+      updateCacheFile(cache, filePath, fileHash, imports, usages);
+      allImports.push(...imports);
+      allUsages.push(...usages);
+      for (const imp of imports) {
+        if (!componentSources.has(imp.componentName)) {
+          const sourceFile = resolveImportSource(filePath, imp.source);
+          if (sourceFile) {
+            componentSources.set(imp.componentName, sourceFile);
+          }
+        }
+      }
+    } catch (error) {
+      errorFiles.push(relativePath);
+      console.warn(`Error scanning ${relativePath}:`, error.message);
+    }
+  }
+  if (useCache) {
+    await saveCache(absoluteRoot, cache);
+  }
+  onProgress?.({
+    current: totalFiles,
+    total: totalFiles,
+    currentFile: "",
+    phase: "aggregating"
+  });
+  const analysis = aggregateAllUsages(allUsages, allImports, componentSources);
+  analysis.rootDir = absoluteRoot;
+  analysis.totalFiles = totalFiles;
+  analysis.errorFiles = errorFiles;
+  return analysis;
+}
+async function incrementalScan(rootDir, changes, existingCache, onProgress) {
+  const absoluteRoot = resolve(rootDir);
+  const cache = { ...existingCache, files: { ...existingCache.files } };
+  for (const filePath of changes.deleted) {
+    removeCacheFile(cache, filePath);
+  }
+  const filesToScan = [...changes.added, ...changes.modified];
+  const totalFiles = filesToScan.length;
+  const allImports = [];
+  const allUsages = [];
+  const errorFiles = [];
+  const componentSources = /* @__PURE__ */ new Map();
+  for (const filePath of changes.unchanged) {
+    const cachedEntry = getCachedFile(cache, filePath);
+    if (cachedEntry) {
+      allImports.push(...cachedEntry.imports);
+      allUsages.push(...cachedEntry.usages);
+      for (const imp of cachedEntry.imports) {
+        if (!componentSources.has(imp.componentName)) {
+          const sourceFile = resolveImportSource(filePath, imp.source);
+          if (sourceFile) {
+            componentSources.set(imp.componentName, sourceFile);
+          }
+        }
+      }
+    }
+  }
+  for (let i = 0; i < filesToScan.length; i++) {
+    const filePath = filesToScan[i];
+    const relativePath = relative(absoluteRoot, filePath);
+    onProgress?.({
+      current: i + 1,
+      total: totalFiles,
+      currentFile: relativePath,
+      phase: "scanning"
+    });
+    try {
+      const content = await readFile2(filePath, "utf-8");
+      const fileHash = computeFileHash(content);
+      const { imports, usages } = await scanFile(filePath);
+      updateCacheFile(cache, filePath, fileHash, imports, usages);
+      allImports.push(...imports);
+      allUsages.push(...usages);
+      for (const imp of imports) {
+        if (!componentSources.has(imp.componentName)) {
+          const sourceFile = resolveImportSource(filePath, imp.source);
+          if (sourceFile) {
+            componentSources.set(imp.componentName, sourceFile);
+          }
+        }
+      }
+    } catch (error) {
+      errorFiles.push(relativePath);
+    }
+  }
+  await saveCache(absoluteRoot, cache);
+  const analysis = aggregateAllUsages(allUsages, allImports, componentSources);
+  analysis.rootDir = absoluteRoot;
+  analysis.totalFiles = changes.unchanged.length + filesToScan.length;
+  analysis.errorFiles = errorFiles;
+  return { analysis, cache };
+}
+function resolveImportSource(importingFile, source) {
+  if (!source.startsWith(".") && !source.startsWith("/")) {
+    return null;
+  }
+  const importDir = dirname2(importingFile);
+  const extensions = ["", ".tsx", ".ts", ".jsx", ".js", "/index.tsx", "/index.ts"];
+  for (const ext of extensions) {
+    const fullPath = resolve(importDir, source + ext);
+    if (ext === "" && source.endsWith(".tsx")) {
+      return fullPath;
+    }
+    if (ext) {
+      return resolve(importDir, source) + ext;
+    }
+  }
+  return resolve(importDir, source);
+}
+function getScanStats(analysis) {
+  const totalUsages = Object.values(analysis.components).reduce(
+    (sum, c) => sum + c.totalUsages,
+    0
+  );
+  const topComponents = Object.values(analysis.components).map((c) => ({ name: c.name, usages: c.totalUsages })).sort((a, b) => b.usages - a.usages).slice(0, 10);
+  return {
+    totalFiles: analysis.totalFiles,
+    totalComponents: analysis.totalComponents,
+    totalUsages,
+    topComponents
+  };
+}
+async function hasCachedAnalysis(rootDir) {
+  const cache = await loadCache(resolve(rootDir));
+  if (!cache) return false;
+  const stats = getCacheStats(cache);
+  return stats.totalFiles > 0;
+}
+
+export {
+  aggregateComponentUsages,
+  aggregateAllUsages,
+  findCommonPropCombinations,
+  inferRelations,
+  inferAllRelations,
+  summarizePatternsForPrompt,
+  loadCache,
+  saveCache,
+  createEmptyCache,
+  computeFileHash,
+  detectFileChanges,
+  getCacheStats,
+  scanCodebase,
+  incrementalScan,
+  getScanStats,
+  hasCachedAnalysis
+};
+//# sourceMappingURL=chunk-QCN35LJU.js.map