@fragments-sdk/cli 0.14.3 → 0.15.0

package/dist/chunk-QCN35LJU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service/enhance/codebase-scanner.ts","../src/service/enhance/aggregator.ts","../src/service/enhance/cache.ts"],"sourcesContent":["/**\n * Full Codebase Scanner\n *\n * Scans entire codebase for component usage patterns with caching and progress.\n */\n\nimport fg from \"fast-glob\";\nimport { readFile } from \"node:fs/promises\";\nimport { relative, resolve, dirname, basename } from \"node:path\";\nimport type {\n  ScanOptions,\n  ScanProgress,\n  UsageAnalysis,\n  ComponentImport,\n  ComponentUsage,\n  FileChanges,\n  AnalysisCache,\n} from \"./types.js\";\nimport { scanFile } from \"./scanner.js\";\nimport { aggregateAllUsages } from \"./aggregator.js\";\nimport {\n  loadCache,\n  saveCache,\n  createEmptyCache,\n  computeFileHash,\n  isFileCached,\n  updateCacheFile,\n  removeCacheFile,\n  getCachedFile,\n  detectFileChanges,\n  getCacheStats,\n} from \"./cache.js\";\n\n/**\n * Default patterns for files to scan\n */\nconst DEFAULT_INCLUDE = [\n  \"**/*.tsx\",\n  \"**/*.ts\",\n  \"**/*.jsx\",\n  \"**/*.js\",\n];\n\n/**\n * Default patterns for files to exclude\n */\nconst DEFAULT_EXCLUDE = [\n  \"**/node_modules/**\",\n  \"**/dist/**\",\n  \"**/build/**\",\n  \"**/.next/**\",\n  \"**/coverage/**\",\n  \"**/__tests__/**\",\n  \"**/*.test.*\",\n  \"**/*.spec.*\",\n  \"**/*.stories.*\",\n  \"**/*.fragment.*\",\n  \"**/storybook-static/**\",\n];\n\n/**\n * Scan entire codebase for component usages\n */\nexport async function scanCodebase(\n  options: ScanOptions\n): Promise<UsageAnalysis> {\n  const {\n    rootDir,\n    include = DEFAULT_INCLUDE,\n    exclude = DEFAULT_EXCLUDE,\n    componentNames,\n    useCache = true,\n    onProgress,\n  } = options;\n\n  const absoluteRoot = resolve(rootDir);\n\n  // Load or create cache\n  let cache: AnalysisCache | null = null;\n  if (useCache) {\n    cache = await loadCache(absoluteRoot);\n  }\n  if (!cache) {\n    cache = createEmptyCache(absoluteRoot);\n  }\n\n  // Discover all files\n  onProgress?.({\n    current: 0,\n    total: 0,\n    currentFile: \"\",\n    phase: \"discovering\",\n  });\n\n  const files = await fg(include, {\n    cwd: absoluteRoot,\n    ignore: exclude,\n    absolute: true,\n    onlyFiles: true,\n  });\n\n  const totalFiles = files.length;\n\n  // Track components to find (if specific ones provided)\n  const trackedComponents = componentNames\n    ? new Set(componentNames)\n    : undefined;\n\n  // Collect all imports and usages\n  const allImports: ComponentImport[] = [];\n  const allUsages: ComponentUsage[] = [];\n  const errorFiles: string[] = [];\n  const componentSources = new Map<string, string>();\n\n  // Process files\n  for (let i = 0; i < files.length; i++) {\n    const filePath = files[i];\n    const relativePath = relative(absoluteRoot, filePath);\n\n    onProgress?.({\n      current: i + 1,\n      total: totalFiles,\n      currentFile: relativePath,\n      phase: \"scanning\",\n    });\n\n    try {\n      // Read file content for hash\n      const content = await readFile(filePath, \"utf-8\");\n      const fileHash = computeFileHash(content);\n\n      // Check cache\n      const cachedEntry = getCachedFile(cache, filePath);\n      if (cachedEntry && cachedEntry.hash === fileHash) {\n        // Use cached results\n        allImports.push(...cachedEntry.imports);\n        allUsages.push(...cachedEntry.usages);\n\n        // Track component sources from imports\n        for (const imp of cachedEntry.imports) {\n          if (!componentSources.has(imp.componentName)) {\n            const sourceFile = resolveImportSource(filePath, imp.source);\n            if (sourceFile) {\n              componentSources.set(imp.componentName, sourceFile);\n            }\n          }\n        }\n        continue;\n      }\n\n      // Scan file\n      const { imports, usages } = await scanFile(filePath, trackedComponents);\n\n      // Update cache\n      updateCacheFile(cache, filePath, fileHash, imports, usages);\n\n      allImports.push(...imports);\n      allUsages.push(...usages);\n\n      // Track component sources\n      for (const imp of imports) {\n        if (!componentSources.has(imp.componentName)) {\n          const sourceFile = resolveImportSource(filePath, imp.source);\n          if (sourceFile) {\n            componentSources.set(imp.componentName, sourceFile);\n          }\n        }\n      }\n    } catch (error) {\n      errorFiles.push(relativePath);\n      console.warn(`Error scanning ${relativePath}:`, (error as Error).message);\n    }\n  }\n\n  // Save cache\n  if (useCache) {\n    await saveCache(absoluteRoot, cache);\n  }\n\n  // Aggregate results\n  onProgress?.({\n    current: totalFiles,\n    total: totalFiles,\n    currentFile: \"\",\n    phase: \"aggregating\",\n  });\n\n  const analysis = aggregateAllUsages(allUsages, allImports, componentSources);\n  analysis.rootDir = absoluteRoot;\n  analysis.totalFiles = totalFiles;\n  analysis.errorFiles = errorFiles;\n\n  return analysis;\n}\n\n/**\n * Perform incremental scan for changed files only\n */\nexport async function incrementalScan(\n  rootDir: string,\n  changes: FileChanges,\n  existingCache: AnalysisCache,\n  onProgress?: (progress: ScanProgress) => void\n): Promise<{ analysis: UsageAnalysis; cache: AnalysisCache }> {\n  const absoluteRoot = resolve(rootDir);\n  const cache = { ...existingCache, files: { ...existingCache.files } };\n\n  // Remove deleted files from cache\n  for (const filePath of changes.deleted) {\n    removeCacheFile(cache, filePath);\n  }\n\n  // Files to scan (added + modified)\n  const filesToScan = [...changes.added, ...changes.modified];\n  const totalFiles = filesToScan.length;\n\n  const allImports: ComponentImport[] = [];\n  const allUsages: ComponentUsage[] = [];\n  const errorFiles: string[] = [];\n  const componentSources = new Map<string, string>();\n\n  // First, collect unchanged file data from cache\n  for (const filePath of changes.unchanged) {\n    const cachedEntry = getCachedFile(cache, filePath);\n    if (cachedEntry) {\n      allImports.push(...cachedEntry.imports);\n      allUsages.push(...cachedEntry.usages);\n\n      for (const imp of cachedEntry.imports) {\n        if (!componentSources.has(imp.componentName)) {\n          const sourceFile = resolveImportSource(filePath, imp.source);\n          if (sourceFile) {\n            componentSources.set(imp.componentName, sourceFile);\n          }\n        }\n      }\n    }\n  }\n\n  // Scan changed files\n  for (let i = 0; i < filesToScan.length; i++) {\n    const filePath = filesToScan[i];\n    const relativePath = relative(absoluteRoot, filePath);\n\n    onProgress?.({\n      current: i + 1,\n      total: totalFiles,\n      currentFile: relativePath,\n      phase: \"scanning\",\n    });\n\n    try {\n      const content = await readFile(filePath, \"utf-8\");\n      const fileHash = computeFileHash(content);\n\n      const { imports, usages } = await scanFile(filePath);\n\n      updateCacheFile(cache, filePath, fileHash, imports, usages);\n\n      allImports.push(...imports);\n      allUsages.push(...usages);\n\n      for (const imp of imports) {\n        if (!componentSources.has(imp.componentName)) {\n          const sourceFile = resolveImportSource(filePath, imp.source);\n          if (sourceFile) {\n            componentSources.set(imp.componentName, sourceFile);\n          }\n        }\n      }\n    } catch (error) {\n      errorFiles.push(relativePath);\n    }\n  }\n\n  // Save updated cache\n  await saveCache(absoluteRoot, cache);\n\n  // Aggregate\n  const analysis = aggregateAllUsages(allUsages, allImports, componentSources);\n  analysis.rootDir = absoluteRoot;\n  analysis.totalFiles = changes.unchanged.length + filesToScan.length;\n  analysis.errorFiles = errorFiles;\n\n  return { analysis, cache };\n}\n\n/**\n * Resolve import source to absolute file path\n */\nfunction resolveImportSource(\n  importingFile: string,\n  source: string\n): string | null {\n  // Skip node_modules imports\n  if (!source.startsWith(\".\") && !source.startsWith(\"/\")) {\n    return null;\n  }\n\n  const importDir = dirname(importingFile);\n\n  // Try common extensions\n  const extensions = [\"\", \".tsx\", \".ts\", \".jsx\", \".js\", \"/index.tsx\", \"/index.ts\"];\n  for (const ext of extensions) {\n    const fullPath = resolve(importDir, source + ext);\n    // We don't check if file exists here for performance\n    // The source path is mainly for reference\n    if (ext === \"\" && source.endsWith(\".tsx\")) {\n      return fullPath;\n    }\n    if (ext) {\n      return resolve(importDir, source) + ext;\n    }\n  }\n\n  return resolve(importDir, source);\n}\n\n/**\n * Get scan statistics for display\n */\nexport function getScanStats(analysis: UsageAnalysis): {\n  totalFiles: number;\n  totalComponents: number;\n  totalUsages: number;\n  topComponents: { name: string; usages: number }[];\n} {\n  const totalUsages = Object.values(analysis.components).reduce(\n    (sum, c) => sum + c.totalUsages,\n    0\n  );\n\n  const topComponents = Object.values(analysis.components)\n    .map((c) => ({ name: c.name, usages: c.totalUsages }))\n    .sort((a, b) => b.usages - a.usages)\n    .slice(0, 10);\n\n  return {\n    totalFiles: analysis.totalFiles,\n    totalComponents: analysis.totalComponents,\n    totalUsages,\n    topComponents,\n  };\n}\n\n/**\n * Export for quick check if cache exists and is valid\n */\nexport async function hasCachedAnalysis(rootDir: string): Promise<boolean> {\n  const cache = await loadCache(resolve(rootDir));\n  if (!cache) return false;\n  const stats = getCacheStats(cache);\n  return stats.totalFiles > 0;\n}\n\n// Re-export types and utilities\nexport { loadCache, getCacheStats, detectFileChanges } from \"./cache.js\";\n","/**\n * Usage Pattern Aggregator\n *\n * Aggregates component usages into patterns for AI analysis.\n */\n\nimport type {\n  ComponentUsage,\n  ComponentImport,\n  ComponentAnalysis,\n  UsagePattern,\n  FileContext,\n  UsageAnalysis,\n} from \"./types.js\";\n\n/**\n * Aggregate usages for a single component into patterns\n */\nexport function aggregateComponentUsages(\n  componentName: string,\n  sourceFile: string,\n  usages: ComponentUsage[],\n  imports: ComponentImport[]\n): ComponentAnalysis {\n  // Count unique files\n  const uniqueFiles = new Set(usages.map((u) => u.filePath));\n\n  // Group usages by prop pattern\n  const patternMap = new Map<string, UsagePattern>();\n\n  for (const usage of usages) {\n    // Create a key from static props (sorted for consistency)\n    const propKey = createPropKey(usage.props.static);\n\n    const existing = patternMap.get(propKey);\n    if (existing) {\n      existing.count++;\n      if (!existing.files.includes(usage.filePath)) {\n        existing.files.push(usage.filePath);\n      }\n      if (existing.sampleContexts.length < 3) {\n        existing.sampleContexts.push(usage.context);\n      }\n    } else {\n      patternMap.set(propKey, {\n        props: { ...usage.props.static },\n        count: 1,\n        files: [usage.filePath],\n        sampleContexts: [usage.context],\n      });\n    }\n  }\n\n  // Sort patterns by frequency\n  const patterns = Array.from(patternMap.values()).sort(\n    (a, b) => b.count - a.count\n  );\n\n  // Classify file contexts\n  const contextMap = new Map<FileContext, { count: number; files: string[] }>();\n\n  for (const usage of usages) {\n    const context = classifyFileContext(usage.filePath, usage.context);\n    const existing = contextMap.get(context);\n    if (existing) {\n      existing.count++;\n      if (!existing.files.includes(usage.filePath)) {\n        existing.files.push(usage.filePath);\n      }\n    } else {\n      contextMap.set(context, { count: 1, files: [usage.filePath] });\n    }\n  }\n\n  // Convert to sorted array\n  const contexts = Array.from(contextMap.entries())\n    .map(([type, data]) => ({ type, ...data }))\n    .sort((a, b) => b.count - a.count);\n\n  return {\n    name: componentName,\n    sourceFile,\n    totalUsages: usages.length,\n    uniqueFiles: uniqueFiles.size,\n    patterns,\n    contexts,\n    usages,\n    imports,\n  };\n}\n\n/**\n * Aggregate all usages across the codebase\n */\nexport function aggregateAllUsages(\n  usages: ComponentUsage[],\n  imports: ComponentImport[],\n  componentSources: Map<string, string>\n): UsageAnalysis {\n  // Group usages by component\n  const usagesByComponent = new Map<string, ComponentUsage[]>();\n  for (const usage of usages) {\n    const existing = usagesByComponent.get(usage.componentName) ?? [];\n    existing.push(usage);\n    usagesByComponent.set(usage.componentName, existing);\n  }\n\n  // Group imports by component\n  const importsByComponent = new Map<string, ComponentImport[]>();\n  for (const imp of imports) {\n    const existing = importsByComponent.get(imp.componentName) ?? [];\n    existing.push(imp);\n    importsByComponent.set(imp.componentName, existing);\n  }\n\n  // Build component analyses\n  const components: Record<string, ComponentAnalysis> = {};\n  const allComponentNames = new Set([\n    ...usagesByComponent.keys(),\n    ...importsByComponent.keys(),\n  ]);\n\n  for (const componentName of allComponentNames) {\n    const componentUsages = usagesByComponent.get(componentName) ?? [];\n    const componentImports = importsByComponent.get(componentName) ?? [];\n    const sourceFile = componentSources.get(componentName) ?? \"unknown\";\n\n    components[componentName] = aggregateComponentUsages(\n      componentName,\n      sourceFile,\n      componentUsages,\n      componentImports\n    );\n  }\n\n  // Collect unique files\n  const allFiles = new Set<string>();\n  for (const usage of usages) {\n    allFiles.add(usage.filePath);\n  }\n  for (const imp of imports) {\n    allFiles.add(imp.filePath);\n  }\n\n  return {\n    timestamp: new Date().toISOString(),\n    rootDir: \"\", // Will be set by caller\n    totalFiles: allFiles.size,\n    totalComponents: Object.keys(components).length,\n    components,\n    errorFiles: [], // Will be populated by scanner\n  };\n}\n\n/**\n * Create a stable key from props for pattern grouping\n */\nfunction createPropKey(props: Record<string, string | boolean | number>): string {\n  const entries = Object.entries(props).sort(([a], [b]) => a.localeCompare(b));\n  return entries.map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(\"|\");\n}\n\n/**\n * Classify file context based on path and content\n */\nfunction classifyFileContext(filePath: string, context: string): FileContext {\n  const lowerPath = filePath.toLowerCase();\n  const lowerContext = context.toLowerCase();\n\n  // Check path patterns first\n  if (\n    lowerPath.includes(\"/modal\") ||\n    lowerPath.includes(\"modal.\") ||\n    lowerContext.includes(\"<modal\")\n  ) {\n    return \"modal\";\n  }\n\n  if (\n    lowerPath.includes(\"/dialog\") ||\n    lowerPath.includes(\"dialog.\") ||\n    lowerContext.includes(\"<dialog\")\n  ) {\n    return \"dialog\";\n  }\n\n  if (\n    lowerPath.includes(\"/form\") ||\n    lowerPath.includes(\"form.\") ||\n    lowerContext.includes(\"<form\") ||\n    lowerContext.includes(\"onsubmit\")\n  ) {\n    return \"form\";\n  }\n\n  if (\n    lowerPath.includes(\"/page\") ||\n    lowerPath.includes(\"pages/\") ||\n    lowerPath.includes(\"/routes/\")\n  ) {\n    return \"page\";\n  }\n\n  if (\n    lowerPath.includes(\"/layout\") ||\n    lowerPath.includes(\"layout.\") ||\n    lowerPath.includes(\"/layouts/\")\n  ) {\n    return \"layout\";\n  }\n\n  if (\n    lowerPath.includes(\"/card\") ||\n    lowerPath.includes(\"card.\") ||\n    lowerContext.includes(\"<card\")\n  ) {\n    return \"card\";\n  }\n\n  if (\n    lowerPath.includes(\"/table\") ||\n    lowerPath.includes(\"table.\") ||\n    lowerContext.includes(\"<table\") ||\n    lowerContext.includes(\"<tr\")\n  ) {\n    return \"table\";\n  }\n\n  if (\n    lowerPath.includes(\"/list\") ||\n    lowerPath.includes(\"list.\") ||\n    lowerContext.includes(\"<ul\") ||\n    lowerContext.includes(\"<ol\") ||\n    lowerContext.includes(\"<li\")\n  ) {\n    return \"list\";\n  }\n\n  if (\n    lowerPath.includes(\"/nav\") ||\n    lowerPath.includes(\"navigation\") ||\n    lowerContext.includes(\"<nav\")\n  ) {\n    return \"navigation\";\n  }\n\n  if (\n    lowerPath.includes(\"/header\") ||\n    lowerPath.includes(\"header.\") ||\n    lowerContext.includes(\"<header\")\n  ) {\n    return \"header\";\n  }\n\n  if (\n    lowerPath.includes(\"/footer\") ||\n    lowerPath.includes(\"footer.\") ||\n    lowerContext.includes(\"<footer\")\n  ) {\n    return \"footer\";\n  }\n\n  if (\n    lowerPath.includes(\"/sidebar\") ||\n    lowerPath.includes(\"sidebar.\") ||\n    lowerContext.includes(\"<aside\")\n  ) {\n    return \"sidebar\";\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Find common prop combinations across usages\n */\nexport function findCommonPropCombinations(\n  usages: ComponentUsage[],\n  minOccurrences: number = 3\n): { props: string[]; count: number }[] {\n  const combinations = new Map<string, number>();\n\n  for (const usage of usages) {\n    // Get all prop names (static and dynamic)\n    const allProps = [\n      ...Object.keys(usage.props.static),\n      ...usage.props.dynamic,\n    ].sort();\n\n    // Generate all combinations of 2+ props\n    for (let size = 2; size <= Math.min(allProps.length, 4); size++) {\n      for (const combo of combinations_k(allProps, size)) {\n        const key = combo.join(\",\");\n        combinations.set(key, (combinations.get(key) ?? 0) + 1);\n      }\n    }\n  }\n\n  // Filter and sort by frequency\n  return Array.from(combinations.entries())\n    .filter(([, count]) => count >= minOccurrences)\n    .map(([key, count]) => ({ props: key.split(\",\"), count }))\n    .sort((a, b) => b.count - a.count);\n}\n\n/**\n * Generate k-combinations of an array\n */\nfunction* combinations_k<T>(arr: T[], k: number): Generator<T[]> {\n  if (k === 0) {\n    yield [];\n    return;\n  }\n  if (arr.length < k) return;\n\n  for (let i = 0; i <= arr.length - k; i++) {\n    for (const combo of combinations_k(arr.slice(i + 1), k - 1)) {\n      yield [arr[i], ...combo];\n    }\n  }\n}\n\n/**\n * Component relationship with frequency data\n */\nexport interface ComponentRelation {\n  /** Related component name */\n  component: string;\n  /** Type of relationship */\n  relationship: \"parent\" | \"sibling\" | \"child\";\n  /** How often this relationship occurs */\n  frequency: number;\n  /** Sample files where this relationship occurs */\n  sampleFiles: string[];\n}\n\n/**\n * Infer component relationships from usage patterns\n *\n * Analyzes parent/sibling relationships from actual usage data:\n * - parent: Components that contain this component (from parentElement)\n * - sibling: Components that appear alongside this component in the same parent\n */\nexport function inferRelations(\n  componentName: string,\n  analysis: ComponentAnalysis,\n  allAnalyses: Record<string, ComponentAnalysis>\n): ComponentRelation[] {\n  const relations: ComponentRelation[] = [];\n  const parentCounts = new Map<string, { count: number; files: string[] }>();\n  const siblingCounts = new Map<string, { count: number; files: string[] }>();\n\n  // Count parent relationships\n  for (const usage of analysis.usages) {\n    if (usage.parentElement && usage.parentElement !== \"div\" && usage.parentElement !== \"span\") {\n      const parent = usage.parentElement;\n      const existing = parentCounts.get(parent);\n      if (existing) {\n        existing.count++;\n        if (!existing.files.includes(usage.filePath)) {\n          existing.files.push(usage.filePath);\n        }\n      } else {\n        parentCounts.set(parent, { count: 1, files: [usage.filePath] });\n      }\n    }\n  }\n\n  // Infer sibling relationships: other components used in the same files\n  const filesWithThisComponent = new Set(analysis.usages.map((u) => u.filePath));\n\n  for (const [otherName, otherAnalysis] of Object.entries(allAnalyses)) {\n    if (otherName === componentName) continue;\n\n    // Count how many files have both components\n    let sharedFiles = 0;\n    const sharedFileList: string[] = [];\n\n    for (const usage of otherAnalysis.usages) {\n      if (filesWithThisComponent.has(usage.filePath)) {\n        if (!sharedFileList.includes(usage.filePath)) {\n          sharedFiles++;\n          sharedFileList.push(usage.filePath);\n        }\n      }\n    }\n\n    // Only include if they appear together frequently\n    if (sharedFiles >= 3) {\n      siblingCounts.set(otherName, {\n        count: sharedFiles,\n        files: sharedFileList.slice(0, 5),\n      });\n    }\n  }\n\n  // Convert to relations array (parents)\n  for (const [parent, data] of parentCounts) {\n    // Only include meaningful parent relationships (count >= 2)\n    if (data.count >= 2) {\n      relations.push({\n        component: parent,\n        relationship: \"parent\",\n        frequency: data.count,\n        sampleFiles: data.files.slice(0, 3),\n      });\n    }\n  }\n\n  // Convert to relations array (siblings)\n  for (const [sibling, data] of siblingCounts) {\n    relations.push({\n      component: sibling,\n      relationship: \"sibling\",\n      frequency: data.count,\n      sampleFiles: data.files.slice(0, 3),\n    });\n  }\n\n  // Sort by frequency\n  relations.sort((a, b) => b.frequency - a.frequency);\n\n  return relations;\n}\n\n/**\n * Infer relations for all components in the analysis\n */\nexport function inferAllRelations(\n  analysis: UsageAnalysis\n): Map<string, ComponentRelation[]> {\n  const allRelations = new Map<string, ComponentRelation[]>();\n\n  for (const [componentName, componentAnalysis] of Object.entries(analysis.components)) {\n    const relations = inferRelations(componentName, componentAnalysis, analysis.components);\n    if (relations.length > 0) {\n      allRelations.set(componentName, relations);\n    }\n  }\n\n  return allRelations;\n}\n\n/**\n * Summarize patterns for AI prompt\n */\nexport function summarizePatternsForPrompt(\n  analysis: ComponentAnalysis,\n  maxPatterns: number = 10,\n  maxContexts: number = 5\n): string {\n  const lines: string[] = [];\n\n  lines.push(`## ${analysis.name}`);\n  lines.push(`Total usages: ${analysis.totalUsages} across ${analysis.uniqueFiles} files`);\n  lines.push(\"\");\n\n  // Top patterns\n  lines.push(\"### Usage Patterns (by frequency)\");\n  const topPatterns = analysis.patterns.slice(0, maxPatterns);\n  for (const pattern of topPatterns) {\n    const propsStr = Object.entries(pattern.props)\n      .map(([k, v]) => `${k}=${JSON.stringify(v)}`)\n      .join(\", \");\n    lines.push(`- ${propsStr || \"(no props)\"}: ${pattern.count} usages in ${pattern.files.length} files`);\n  }\n  lines.push(\"\");\n\n  // File contexts\n  lines.push(\"### File Contexts\");\n  const topContexts = analysis.contexts.slice(0, maxContexts);\n  for (const ctx of topContexts) {\n    lines.push(`- ${ctx.type}: ${ctx.count} usages`);\n  }\n  lines.push(\"\");\n\n  // Sample code contexts (one per pattern)\n  lines.push(\"### Sample Usages\");\n  for (const pattern of topPatterns.slice(0, 3)) {\n    if (pattern.sampleContexts[0]) {\n      lines.push(\"```tsx\");\n      lines.push(pattern.sampleContexts[0].trim());\n      lines.push(\"```\");\n      lines.push(\"\");\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n","/**\n * Analysis Cache Layer\n *\n * Caches file analysis results to enable fast incremental updates.\n */\n\nimport { readFile, writeFile, stat } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { createHash } from \"node:crypto\";\nimport { join, dirname } from \"node:path\";\nimport { mkdir } from \"node:fs/promises\";\nimport type {\n  AnalysisCache,\n  FileCacheEntry,\n  FileChanges,\n  ComponentImport,\n  ComponentUsage,\n  CACHE_VERSION,\n} from \"./types.js\";\n\nconst CURRENT_CACHE_VERSION = 1;\nconst CACHE_FILENAME = \"analysis-cache.json\";\n\n/**\n * Get the cache file path for a project\n */\nexport function getCachePath(rootDir: string): string {\n  return join(rootDir, \".fragments\", CACHE_FILENAME);\n}\n\n/**\n * Load cache from disk\n * Returns null if cache doesn't exist or is invalid\n */\nexport async function loadCache(rootDir: string): Promise<AnalysisCache | null> {\n  const cachePath = getCachePath(rootDir);\n\n  if (!existsSync(cachePath)) {\n    return null;\n  }\n\n  try {\n    const content = await readFile(cachePath, \"utf-8\");\n    const cache = JSON.parse(content) as AnalysisCache;\n\n    // Validate version\n    if (cache.version !== CURRENT_CACHE_VERSION) {\n      console.warn(\n        `Cache version mismatch: expected ${CURRENT_CACHE_VERSION}, got ${cache.version}. Invalidating cache.`\n      );\n      return null;\n    }\n\n    // Validate root dir matches\n    if (cache.rootDir !== rootDir) {\n      console.warn(`Cache root mismatch. Invalidating cache.`);\n      return null;\n    }\n\n    return cache;\n  } catch (error) {\n    console.warn(`Failed to load cache: ${(error as Error).message}`);\n    return null;\n  }\n}\n\n/**\n * Save cache to disk\n */\nexport async function saveCache(\n  rootDir: string,\n  cache: AnalysisCache\n): Promise<void> {\n  const cachePath = getCachePath(rootDir);\n  const cacheDir = dirname(cachePath);\n\n  // Ensure .fragments directory exists\n  if (!existsSync(cacheDir)) {\n    await mkdir(cacheDir, { recursive: true });\n  }\n\n  cache.updatedAt = new Date().toISOString();\n  await writeFile(cachePath, JSON.stringify(cache, null, 2));\n}\n\n/**\n * Create a new empty cache\n */\nexport function createEmptyCache(rootDir: string): AnalysisCache {\n  const now = new Date().toISOString();\n  return {\n    version: CURRENT_CACHE_VERSION,\n    createdAt: now,\n    updatedAt: now,\n    rootDir,\n    files: {},\n  };\n}\n\n/**\n * Compute content hash for a file\n */\nexport function computeFileHash(content: string): string {\n  return createHash(\"md5\").update(content).digest(\"hex\");\n}\n\n/**\n * Compute file hash from disk\n */\nexport async function computeFileHashFromDisk(\n  filePath: string\n): Promise<string> {\n  const content = await readFile(filePath, \"utf-8\");\n  return computeFileHash(content);\n}\n\n/**\n * Check if a file is cached and unchanged\n */\nexport function isFileCached(\n  cache: AnalysisCache,\n  filePath: string,\n  currentHash: string\n): boolean {\n  const entry = cache.files[filePath];\n  if (!entry) return false;\n  return entry.hash === currentHash;\n}\n\n/**\n * Get cached data for a file\n */\nexport function getCachedFile(\n  cache: AnalysisCache,\n  filePath: string\n): FileCacheEntry | null {\n  return cache.files[filePath] ?? null;\n}\n\n/**\n * Update cache with results for a file\n */\nexport function updateCacheFile(\n  cache: AnalysisCache,\n  filePath: string,\n  hash: string,\n  imports: ComponentImport[],\n  usages: ComponentUsage[]\n): void {\n  cache.files[filePath] = {\n    hash,\n    timestamp: new Date().toISOString(),\n    imports,\n    usages,\n  };\n}\n\n/**\n * Remove a file from cache\n */\nexport function removeCacheFile(cache: AnalysisCache, filePath: string): void {\n  delete cache.files[filePath];\n}\n\n/**\n * Invalidate cache entries for specific files\n */\nexport function invalidateCache(\n  cache: AnalysisCache,\n  filePaths: string[]\n): void {\n  for (const filePath of filePaths) {\n    delete cache.files[filePath];\n  }\n}\n\n/**\n * Detect file changes by comparing current files to cache\n */\nexport async function detectFileChanges(\n  cache: AnalysisCache,\n  currentFiles: string[],\n  getFileHash: (filePath: string) => Promise<string>\n): Promise<FileChanges> {\n  const changes: FileChanges = {\n    added: [],\n    modified: [],\n    deleted: [],\n    unchanged: [],\n  };\n\n  const currentFileSet = new Set(currentFiles);\n  const cachedFileSet = new Set(Object.keys(cache.files));\n\n  // Check for added and modified files\n  for (const filePath of currentFiles) {\n    const entry = cache.files[filePath];\n\n    if (!entry) {\n      changes.added.push(filePath);\n    } else {\n      const currentHash = await getFileHash(filePath);\n      if (currentHash !== entry.hash) {\n        changes.modified.push(filePath);\n      } else {\n        changes.unchanged.push(filePath);\n      }\n    }\n  }\n\n  // Check for deleted files\n  for (const cachedFile of cachedFileSet) {\n    if (!currentFileSet.has(cachedFile)) {\n      changes.deleted.push(cachedFile);\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Get all cached imports\n */\nexport function getAllCachedImports(cache: AnalysisCache): ComponentImport[] {\n  const imports: ComponentImport[] = [];\n  for (const entry of Object.values(cache.files)) {\n    imports.push(...entry.imports);\n  }\n  return imports;\n}\n\n/**\n * Get all cached usages\n */\nexport function getAllCachedUsages(cache: AnalysisCache): ComponentUsage[] {\n  const usages: ComponentUsage[] = [];\n  for (const entry of Object.values(cache.files)) {\n    usages.push(...entry.usages);\n  }\n  return usages;\n}\n\n/**\n * Get cache statistics\n */\nexport function getCacheStats(cache: AnalysisCache): {\n  totalFiles: number;\n  totalImports: number;\n  totalUsages: number;\n  cacheAge: string;\n} {\n  let totalImports = 0;\n  let totalUsages = 0;\n\n  for (const entry of Object.values(cache.files)) {\n    totalImports += entry.imports.length;\n    totalUsages += entry.usages.length;\n  }\n\n  const ageMs = Date.now() - new Date(cache.updatedAt).getTime();\n  const ageMinutes = Math.round(ageMs / 60000);\n  const cacheAge =\n    ageMinutes < 60\n      ? `${ageMinutes} minutes ago`\n      : ageMinutes < 1440\n        ? `${Math.round(ageMinutes / 60)} hours ago`\n        : `${Math.round(ageMinutes / 1440)} days ago`;\n\n  return {\n    totalFiles: Object.keys(cache.files).length,\n    totalImports,\n    totalUsages,\n    cacheAge,\n  };\n}\n"],"mappings":"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","names":["readFile","dirname","readFile","dirname"]}

package/dist/chunk-T47OLCSF.js

@@ -0,0 +1,36 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+
+// src/shared/project-fields.ts
+function projectFields(obj, fields) {
+  if (!fields || fields.length === 0) return obj;
+  const result = {};
+  for (const field of fields) {
+    const parts = field.split(".");
+    let source = obj;
+    let target = result;
+    for (let i = 0; i < parts.length; i++) {
+      const part = parts[i];
+      const isLast = i === parts.length - 1;
+      if (source === null || source === void 0 || typeof source !== "object") {
+        break;
+      }
+      const sourceObj = source;
+      const value = sourceObj[part];
+      if (isLast) {
+        target[part] = value;
+      } else {
+        if (!(part in target)) {
+          target[part] = {};
+        }
+        target = target[part];
+        source = value;
+      }
+    }
+  }
+  return result;
+}
+
+export {
+  projectFields
+};
+//# sourceMappingURL=chunk-T47OLCSF.js.map

package/dist/chunk-T47OLCSF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/project-fields.ts"],"sourcesContent":["/**\n * Extract specific fields from an object using dot notation paths.\n * E.g., projectFields(obj, ['meta.name', 'usage.when']) returns { meta: { name: ... }, usage: { when: ... } }\n *\n * @param obj - The source object to extract fields from\n * @param fields - Array of field paths (supports dot notation for nested fields)\n * @returns A new object containing only the requested fields\n */\nexport function projectFields<T extends Record<string, unknown>>(\n  obj: T,\n  fields: string[],\n): Partial<T> {\n  if (!fields || fields.length === 0) return obj;\n\n  const result: Record<string, unknown> = {};\n\n  for (const field of fields) {\n    const parts = field.split('.');\n    let source: unknown = obj;\n    let target = result;\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i];\n      const isLast = i === parts.length - 1;\n\n      if (source === null || source === undefined || typeof source !== 'object') {\n        break;\n      }\n\n      const sourceObj = source as Record<string, unknown>;\n      const value = sourceObj[part];\n\n      if (isLast) {\n        target[part] = value;\n      } else {\n        if (!(part in target)) {\n          target[part] = {};\n        }\n        target = target[part] as Record<string, unknown>;\n        source = value;\n      }\n    }\n  }\n\n  return result as Partial<T>;\n}\n"],"mappings":";;;AAQO,SAAS,cACd,KACA,QACY;AACZ,MAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO;AAE3C,QAAM,SAAkC,CAAC;AAEzC,aAAW,SAAS,QAAQ;AAC1B,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,QAAI,SAAkB;AACtB,QAAI,SAAS;AAEb,aAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,YAAM,OAAO,MAAM,CAAC;AACpB,YAAM,SAAS,MAAM,MAAM,SAAS;AAEpC,UAAI,WAAW,QAAQ,WAAW,UAAa,OAAO,WAAW,UAAU;AACzE;AAAA,MACF;AAEA,YAAM,YAAY;AAClB,YAAM,QAAQ,UAAU,IAAI;AAE5B,UAAI,QAAQ;AACV,eAAO,IAAI,IAAI;AAAA,MACjB,OAAO;AACL,YAAI,EAAE,QAAQ,SAAS;AACrB,iBAAO,IAAI,IAAI,CAAC;AAAA,QAClB;AACA,iBAAS,OAAO,IAAI;AACpB,iBAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}