@fragments-sdk/cli 0.15.0 → 0.15.2

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/{codebase-scanner-VOTPXRYW.js → codebase-scanner-MQHUZC2G.js}

@@ -9,7 +9,6 @@ import {
   scanCodebase
 } from "./chunk-QCN35LJU.js";
 import "./chunk-7DZC4YEV.js";
-import "./chunk-Z7EY4VHE.js";
 export {
   detectFileChanges,
   getCacheStats,
@@ -19,4 +18,4 @@ export {
   loadCache,
   scanCodebase
 };
-//# sourceMappingURL=codebase-scanner-VOTPXRYW.js.map
+//# sourceMappingURL=codebase-scanner-MQHUZC2G.js.map

package/dist/{converter-JLINP7CJ.js → converter-7XM3Y6NJ.js}

@@ -1,5 +1,4 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
-import "./chunk-Z7EY4VHE.js";
 
 // src/service/enhance/converter.ts
 import { relative } from "path";
@@ -31,4 +30,4 @@ function mergeProps(usage) {
 export {
   usagesToSpec
 };
-//# sourceMappingURL=converter-JLINP7CJ.js.map
+//# sourceMappingURL=converter-7XM3Y6NJ.js.map

package/dist/{converter-JLINP7CJ.js.map → converter-7XM3Y6NJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/service/enhance/converter.ts"],"sourcesContent":["/**\n * Converter — transforms scanner output (ComponentUsage[]) to governance engine input (UISpec)\n *\n * Bridge between the codebase scanner (Babel AST analysis) and the govern engine.\n * Each file's usages become a UISpec with one UINode per component usage.\n */\n\nimport { relative } from 'node:path';\nimport type { ComponentUsage } from './types.js';\nimport type { UISpec, UINode } from '@fragments-sdk/govern';\n\n/**\n * Convert a list of component usages from a single file into a UISpec\n * suitable for the governance engine.\n *\n * Each ComponentUsage becomes a UINode:\n *   - id: `${relativePath}:${line}:${column}` (unique, traceable back to source)\n *   - type: componentName (e.g. \"Button\", \"Card.Header\")\n *   - props: merged static + dynamic markers + spread markers\n */\nexport function usagesToSpec(\n  usages: ComponentUsage[],\n  filePath: string,\n  rootDir: string,\n): UISpec {\n  const relativePath = relative(rootDir, filePath);\n\n  const nodes: UINode[] = usages.map((usage) => ({\n    id: `${relativePath}:${usage.line}:${usage.column}`,\n    type: usage.componentName,\n    props: mergeProps(usage),\n  }));\n\n  return {\n    nodes,\n    metadata: {\n      agent: 'scan',\n      timestamp: new Date().toISOString(),\n    },\n  };\n}\n\n/**\n * Merge static props, dynamic prop markers, and spread markers into\n * a single Record<string, unknown> for the UINode.\n */\nfunction mergeProps(usage: ComponentUsage): Record<string, unknown> {\n  const props: Record<string, unknown> = { ...usage.props.static };\n\n  // Mark dynamic props so governance rules can see them\n  for (const name of usage.props.dynamic) {\n    props[name] = '(dynamic)';\n  }\n\n  // Mark spread props\n  for (const name of usage.props.spreads) {\n    props[`...${name}`] = true;\n  }\n\n  return props;\n}\n"],"mappings":";;;;AAOA,SAAS,gBAAgB;AAalB,SAAS,aACd,QACA,UACA,SACQ;AACR,QAAM,eAAe,SAAS,SAAS,QAAQ;AAE/C,QAAM,QAAkB,OAAO,IAAI,CAAC,WAAW;AAAA,IAC7C,IAAI,GAAG,YAAY,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM;AAAA,IACjD,MAAM,MAAM;AAAA,IACZ,OAAO,WAAW,KAAK;AAAA,EACzB,EAAE;AAEF,SAAO;AAAA,IACL;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAAA,EACF;AACF;AAMA,SAAS,WAAW,OAAgD;AAClE,QAAM,QAAiC,EAAE,GAAG,MAAM,MAAM,OAAO;AAG/D,aAAW,QAAQ,MAAM,MAAM,SAAS;AACtC,UAAM,IAAI,IAAI;AAAA,EAChB;AAGA,aAAW,QAAQ,MAAM,MAAM,SAAS;AACtC,UAAM,MAAM,IAAI,EAAE,IAAI;AAAA,EACxB;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/service/enhance/converter.ts"],"sourcesContent":["/**\n * Converter — transforms scanner output (ComponentUsage[]) to governance engine input (UISpec)\n *\n * Bridge between the codebase scanner (Babel AST analysis) and the govern engine.\n * Each file's usages become a UISpec with one UINode per component usage.\n */\n\nimport { relative } from 'node:path';\nimport type { ComponentUsage } from './types.js';\nimport type { UISpec, UINode } from '@fragments-sdk/govern';\n\n/**\n * Convert a list of component usages from a single file into a UISpec\n * suitable for the governance engine.\n *\n * Each ComponentUsage becomes a UINode:\n *   - id: `${relativePath}:${line}:${column}` (unique, traceable back to source)\n *   - type: componentName (e.g. \"Button\", \"Card.Header\")\n *   - props: merged static + dynamic markers + spread markers\n */\nexport function usagesToSpec(\n  usages: ComponentUsage[],\n  filePath: string,\n  rootDir: string,\n): UISpec {\n  const relativePath = relative(rootDir, filePath);\n\n  const nodes: UINode[] = usages.map((usage) => ({\n    id: `${relativePath}:${usage.line}:${usage.column}`,\n    type: usage.componentName,\n    props: mergeProps(usage),\n  }));\n\n  return {\n    nodes,\n    metadata: {\n      agent: 'scan',\n      timestamp: new Date().toISOString(),\n    },\n  };\n}\n\n/**\n * Merge static props, dynamic prop markers, and spread markers into\n * a single Record<string, unknown> for the UINode.\n */\nfunction mergeProps(usage: ComponentUsage): Record<string, unknown> {\n  const props: Record<string, unknown> = { ...usage.props.static };\n\n  // Mark dynamic props so governance rules can see them\n  for (const name of usage.props.dynamic) {\n    props[name] = '(dynamic)';\n  }\n\n  // Mark spread props\n  for (const name of usage.props.spreads) {\n    props[`...${name}`] = true;\n  }\n\n  return props;\n}\n"],"mappings":";;;AAOA,SAAS,gBAAgB;AAalB,SAAS,aACd,QACA,UACA,SACQ;AACR,QAAM,eAAe,SAAS,SAAS,QAAQ;AAE/C,QAAM,QAAkB,OAAO,IAAI,CAAC,WAAW;AAAA,IAC7C,IAAI,GAAG,YAAY,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM;AAAA,IACjD,MAAM,MAAM;AAAA,IACZ,OAAO,WAAW,KAAK;AAAA,EACzB,EAAE;AAEF,SAAO;AAAA,IACL;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAAA,EACF;AACF;AAMA,SAAS,WAAW,OAAgD;AAClE,QAAM,QAAiC,EAAE,GAAG,MAAM,MAAM,OAAO;AAG/D,aAAW,QAAQ,MAAM,MAAM,SAAS;AACtC,UAAM,IAAI,IAAI;AAAA,EAChB;AAGA,aAAW,QAAQ,MAAM,MAAM,SAAS;AACtC,UAAM,MAAM,IAAI,EAAE,IAAI;AAAA,EACxB;AAEA,SAAO;AACT;","names":[]}

package/dist/core/index.js

@@ -76,7 +76,6 @@ import {
   toId,
   usePreviewVariantRuntime
 } from "../chunk-32LIWN2P.js";
-import "../chunk-Z7EY4VHE.js";
 export {
   BRAND,
   DEFAULTS,