@fragments-sdk/cli 0.9.1 → 0.10.1

package/src/core/index.ts

@@ -1,207 +1,5 @@
 /**
- * Browser-safe exports for @fragments-sdk/cli/core
- * For Node.js-only APIs (config, discovery, loader), import from '@fragments-sdk/cli' directly.
+ * @deprecated Import from '@fragments-sdk/core' directly.
+ * This re-export exists for backwards compatibility with '@fragments-sdk/cli/core'.
  */
-
-// Brand and default constants
-export { BRAND, DEFAULTS } from "./constants.js";
-export type { Brand, Defaults } from "./constants.js";
-
-// Types
-export type {
-  FragmentComponent,
-  FragmentMeta,
-  FragmentUsage,
-  PropType,
-  PropDefinition,
-  ControlType,
-  RelationshipType,
-  ComponentRelation,
-  VariantLoader,
-  PlayFunction,
-  PlayFunctionContext,
-  FragmentVariant,
-  FragmentDefinition,
-  FragmentsConfig,
-  SnippetPolicyConfig,
-  RegistryOptions,
-  CompiledFragment,
-  CompiledFragmentsFile,
-  BlockDefinition,
-  CompiledBlock,
-  RecipeDefinition, // @deprecated - use BlockDefinition
-  CompiledRecipe, // @deprecated - use CompiledBlock
-  // Contract and provenance types
-  FragmentContract,
-  FragmentGenerated,
-  // AI metadata type
-  AIMetadata,
-  // Screenshot types
-  ScreenshotConfig,
-  ServiceConfig,
-  Viewport,
-  Theme,
-  Screenshot,
-  ScreenshotMetadata,
-  DiffResult,
-  BoundingBox,
-  BaselineInfo,
-  Manifest,
-  VerifyRequest,
-  VerifyResult,
-  // Figma property mapping types
-  FigmaPropMapping,
-  FigmaStringMapping,
-  FigmaBooleanMapping,
-  FigmaEnumMapping,
-  FigmaInstanceMapping,
-  FigmaChildrenMapping,
-  FigmaTextContentMapping,
-  // Storybook filter configuration
-  StorybookFilterConfig,
-  // Token configuration
-  TokenConfig,
-  // Compiled token types
-  CompiledTokenEntry,
-  CompiledTokenData,
-} from "./types.js";
-
-// Performance presets
-export {
-  resolvePerformanceConfig,
-  classifyComplexity,
-  formatBytes,
-  budgetBar,
-  PRESET_NAMES,
-} from "./performance-presets.js";
-export type {
-  PerformanceBudgets,
-  PerformanceConfig,
-  ComplexityTier,
-  PerformanceData as PerfData,
-  PerformanceSummary as PerfSummary,
-} from "./performance-presets.js";
-
-// Token types
-export type {
-  TokenCategory,
-  DesignToken,
-  TokenRegistry,
-  TokenRegistryMeta,
-  EnhancedStyleDiffItem,
-  TokenFix,
-  TokenParseResult,
-  TokenParseError,
-  TokenMatchRequest,
-  TokenMatchResult,
-  TokenUsageSummary,
-} from "./token-types.js";
-
-// Schema validation (Zod is browser-safe)
-export {
-  fragmentMetaSchema,
-  fragmentUsageSchema,
-  propDefinitionSchema,
-  componentRelationSchema,
-  fragmentVariantSchema,
-  fragmentDefinitionSchema,
-  fragmentsConfigSchema,
-  figmaPropMappingSchema,
-  // Contract and provenance schemas
-  fragmentContractSchema,
-  fragmentGeneratedSchema,
-  fragmentBanSchema,
-  blockDefinitionSchema,
-  recipeDefinitionSchema, // @deprecated - use blockDefinitionSchema
-  // AI metadata schema
-  aiMetadataSchema,
-} from "./schema.js";
-
-// Main API
-export { defineFragment, compileFragment, defineBlock, compileBlock, defineRecipe, compileRecipe } from "./defineFragment.js";
-export type { InferProps } from "./defineFragment.js";
-
-// Story adapter (runtime conversion of Storybook modules)
-export {
-  storyModuleToFragment,
-  setPreviewConfig,
-  getPreviewConfig,
-  // Re-export @storybook/csf utilities
-  toId,
-  storyNameFromExport,
-  isExportStory,
-} from "./storyAdapter.js";
-export type {
-  StoryModule,
-  StoryMeta,
-  Story,
-  StoryArgType,
-  StoryContext,
-  Decorator,
-  Loader,
-  PreviewConfig,
-  CSF2Story,
-} from "./storyAdapter.js";
-
-// Storybook adapter filtering
-export {
-  checkStoryExclusion,
-  detectSubComponentPaths,
-  isForceIncluded,
-  isConfigExcluded,
-} from "./storyFilters.js";
-export type {
-  ExclusionReason,
-  ExclusionResult,
-  CheckStoryExclusionOpts,
-} from "./storyFilters.js";
-
-// Context generation for AI agents
-export { generateContext } from "./context.js";
-export type { ContextOptions, ContextResult } from "./context.js";
-
-// Figma property mapping DSL
-export { figma, isFigmaPropMapping, resolveFigmaMapping } from "./figma.js";
-
-// Fragment JSON types (for .fragment.json files)
-export type {
-  Fragment,
-  FragmentFigma,
-  FragmentUsage as FragmentJsonUsage,
-  FragmentDoNotItem,
-  FragmentPattern,
-  FragmentAccessibility,
-  FragmentRelated,
-  FragmentMeta as FragmentJsonMeta,
-  FragmentIndex,
-  FragmentRegistry,
-  RegistryComponentEntry,
-  RegistryPropEntry,
-  FragmentContextOptions,
-} from "./fragment-types.js";
-
-// Token parsing
-export { parseTokenFile } from "./token-parser.js";
-export type { ParsedToken, TokenParseOutput } from "./token-parser.js";
-
-// Composition analysis
-export { analyzeComposition } from "./composition.js";
-export type {
-  CompositionAnalysis,
-  CompositionWarning,
-  CompositionSuggestion,
-  CompositionGuideline,
-} from "./composition.js";
-
-// Shared preview runtime
-export {
-  executeVariantLoaders,
-  resolvePreviewRuntimeState,
-  usePreviewVariantRuntime,
-  PreviewVariantRuntime,
-} from "./preview-runtime.js";
-export type {
-  PreviewVariantLike,
-  PreviewRuntimeState,
-  PreviewRuntimeOptions,
-} from "./preview-runtime.js";
+export * from '@fragments-sdk/core';

package/src/core/loader.ts

@@ -2,8 +2,8 @@ import { writeFile, unlink } from 'node:fs/promises';
 import { dirname, basename, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { build, type Plugin } from 'esbuild';
-import type { FragmentDefinition } from './types.js';
-import { BRAND } from './constants.js';
+import { BRAND } from '@fragments-sdk/core';
+import type { FragmentDefinition } from '@fragments-sdk/core';
 
 // Inline implementation of defineFragment that will be injected into bundled files
 // This allows fragment files to work without @fragments/core being installed
@@ -53,6 +53,37 @@ function createFragmentsCoreShimPlugin(): Plugin {
 export async function loadFragmentFile(
   absolutePath: string
 ): Promise<FragmentDefinition | null> {
+  const unwrapFragmentExport = (
+    value: unknown
+  ): FragmentDefinition | null => {
+    if (!value) return null;
+
+    // Some CJS/ESM interop paths produce { default: fragment } wrappers.
+    // Prefer a shape that actually looks like a fragment definition.
+    const asObject = (v: unknown): Record<string, unknown> | null =>
+      v && typeof v === 'object' ? (v as Record<string, unknown>) : null;
+    const isFragmentLike = (v: unknown): boolean => {
+      const obj = asObject(v);
+      return !!obj && ('component' in obj || 'meta' in obj || 'variants' in obj);
+    };
+
+    if (isFragmentLike(value)) {
+      return value as FragmentDefinition;
+    }
+
+    const first = asObject(value)?.default;
+    if (isFragmentLike(first)) {
+      return first as FragmentDefinition;
+    }
+
+    const second = asObject(first)?.default;
+    if (isFragmentLike(second)) {
+      return second as FragmentDefinition;
+    }
+
+    return (value as FragmentDefinition) ?? null;
+  };
+
   const ext = absolutePath.split('.').pop()?.toLowerCase();
   const needsTransform = ext === 'tsx' || ext === 'ts' || ext === 'jsx';
 
@@ -60,24 +91,23 @@ export async function loadFragmentFile(
     // Plain JS file, import directly
     const fileUrl = pathToFileURL(absolutePath).href;
     const module = await import(fileUrl);
-    return module.default ?? null;
+    return unwrapFragmentExport(module.default ?? null);
   }
 
   // Bundle the file with all its local dependencies
   const sourceDir = dirname(absolutePath);
   const baseName = basename(absolutePath, `.${ext}`);
-  // Use .cjs extension to ensure CommonJS evaluation
-  const tempFile = join(sourceDir, `.${baseName}.fragments-temp-${Date.now()}.cjs`);
+  // Use .mjs and ESM output for compatibility with ESM-only dependencies.
+  const tempFile = join(sourceDir, `.${baseName}.fragments-temp-${Date.now()}.mjs`);
 
   try {
-    // Use esbuild to bundle the fragment file
-    // We inject a shim for @fragments-sdk/cli/core so it doesn't need to be installed
-    // Using CommonJS format to avoid ESM/CJS interop issues with node_modules
+    // Use esbuild to bundle the fragment file.
+    // We inject a shim for @fragments-sdk/cli/core so it doesn't need to be installed.
     await build({
       entryPoints: [absolutePath],
       outfile: tempFile,
       bundle: true,
-      format: 'cjs', // Use CommonJS to avoid ESM issues with lodash, etc.
+      format: 'esm',
       target: 'es2022',
       jsx: 'automatic',
       platform: 'node',
@@ -114,7 +144,7 @@ export async function loadFragmentFile(
 
     const fileUrl = pathToFileURL(tempFile).href;
     const module = await import(fileUrl);
-    return module.default ?? null;
+    return unwrapFragmentExport(module.default ?? null);
   } finally {
     // Clean up temp file
     try {

package/src/core/parser.ts

@@ -8,7 +8,7 @@
  */
 
 import ts from "typescript";
-import type { FragmentMeta, FragmentUsage, PropDefinition, AIMetadata, FragmentContract } from "./types.js";
+import type { FragmentMeta, FragmentUsage, PropDefinition, AIMetadata, FragmentContract } from '@fragments-sdk/core';
 
 /**
  * Parsed fragment metadata (extracted statically from AST)

package/src/core/previewLoader.ts

@@ -12,7 +12,7 @@
 
 import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";
-import type { PreviewConfig } from "./storyAdapter.js";
+import type { PreviewConfig } from '@fragments-sdk/core';
 
 /**
  * Possible file extensions and names for preview config

package/src/index.ts

@@ -44,10 +44,10 @@ export type { AnalyzeOptions, AnalyzeResult } from "./analyze.js";
 export { generateStaticViewer, generateViewerFromJson } from "./static-viewer.js";
 
 // Config type (used by generated fragments.config.ts)
-export type { FragmentsConfig } from "./core/types.js";
+export type { FragmentsConfig } from "./core/index.js";
 
 // Fragment definition API (used by generated .fragment.tsx files)
-export { defineFragment, defineBlock } from "./core/defineFragment.js";
+export { defineFragment, defineBlock } from "./core/index.js";
 
 // CLI Command metadata (for docs)
 export { CLI_COMMANDS, CLI_COMMAND_CATEGORIES } from "./cli-commands.js";

package/src/service/snippet-validation.test.ts

@@ -2,7 +2,7 @@ import { afterEach, describe, expect, it } from 'vitest';
 import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { tmpdir } from 'node:os';
-import type { FragmentsConfig } from '../core/types.js';
+import type { FragmentsConfig } from '../core/index.js';
 import { validateSnippetPolicy } from './snippet-validation.js';
 
 async function createTempProject(): Promise<string> {

package/src/service/snippet-validation.ts

@@ -2,8 +2,8 @@ import ts from 'typescript';
 import { readFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import type { FragmentsConfig, SnippetPolicyConfig } from '../core/types.js';
-import { BRAND } from '../core/constants.js';
+import type { FragmentsConfig, SnippetPolicyConfig } from '../core/index.js';
+import { BRAND } from '../core/index.js';
 import {
   discoverBlockFiles,
   discoverFragmentFiles,

package/src/viewer/__tests__/viewer-integration.test.ts

@@ -68,17 +68,11 @@ describe("@fragments-sdk/cli/core alias resolution", () => {
     expect(existsSync(corePath)).toBe(true);
   });
 
-  it("core/index.ts exports storyModuleToFragment", async () => {
+  it("core/index.ts re-exports from @fragments-sdk/core", async () => {
     const corePath = resolve(cliPackageRoot, "src/core/index.ts");
     const content = await readFile(corePath, "utf-8");
-    // The virtual module imports { storyModuleToFragment, setPreviewConfig }
-    expect(content).toContain("storyModuleToFragment");
-  });
-
-  it("core/index.ts exports setPreviewConfig", async () => {
-    const corePath = resolve(cliPackageRoot, "src/core/index.ts");
-    const content = await readFile(corePath, "utf-8");
-    expect(content).toContain("setPreviewConfig");
+    // After core extraction, cli/core is a thin re-export shim
+    expect(content).toContain("@fragments-sdk/core");
   });
 });
 

package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss

@@ -44,21 +44,16 @@
 // Preview area with subtle dotted grid pattern
 .previewPanel {
   position: relative;
-  min-height: 400px;
   padding: var(--fui-space-4);
   display: flex;
   flex-direction: column;
-  align-items: stretch;
+  align-items: center;
+  justify-content: center;
   background-color: var(--fui-bg-primary);
 
   // Subtle dotted grid pattern
   background-image: radial-gradient(circle, var(--fui-border) 1px, transparent 1px);
   background-size: 24px 24px;
-
-  > * {
-    width: 100%;
-    flex: 1;
-  }
 }
 
 // Code panel
@@ -116,7 +111,4 @@
     margin: 0;
   }
 
-  :global([class*="Tabs_panel"]) {
-    padding: 0;
-  }
 }

package/src/viewer/vendor/shared/src/VariantPreviewCard.tsx

@@ -52,7 +52,10 @@ export function VariantPreviewCard({
     .filter(Boolean)
     .join(' ');
 
-  const hasPreview = !!children;
+  // Use defaultTab as a signal: when 'preview' is requested, a preview IS expected
+  // even if children/isLoading haven't arrived yet (async hook still settling).
+  // Always use tabbed layout so code stays hidden in its tab.
+  const hasPreview = !!children || !!isLoading || defaultTab === 'preview';
   const hasCode = typeof code === 'string' && code.length > 0;
 
   // No preview, code only — render without tabs

package/src/viewer/vite-plugin.ts

@@ -1715,7 +1715,7 @@ async function generateFragmentsModule(
 
   // Compute sub-component map from story file paths (build-time)
   const storyOnlyFiles = fragmentFiles.filter(f => isStoryFile(f.relativePath));
-  const { detectSubComponentPaths: _detectSubs } = await import("../core/storyFilters.js");
+  const { detectSubComponentPaths: _detectSubs } = await import("../core/index.js");
   const subComponentMap = _detectSubs(storyOnlyFiles);
 
   // Group files by base component path to identify pairs

package/dist/chunk-AWYCDRPG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/discovery.ts"],"sourcesContent":["import { resolve, dirname, basename } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport fg from 'fast-glob';\nimport type { FragmentsConfig } from './types.js';\nimport { BRAND } from './constants.js';\n\nexport interface DiscoveredFile {\n  /** Absolute path to the file */\n  absolutePath: string;\n  /** Path relative to config directory */\n  relativePath: string;\n}\n\n/**\n * Discovered component with source file information\n */\nexport interface DiscoveredComponent {\n  /** Component name (e.g., \"Button\") */\n  name: string;\n  /** Absolute path to the component source file */\n  sourcePath: string;\n  /** Path relative to config directory */\n  relativePath: string;\n  /** Path to storybook file if found */\n  storyPath?: string;\n}\n\n/**\n * Discover block files (*.block.ts) under the config directory.\n * Also discovers legacy *.recipe.ts files for backward compatibility.\n */\nexport async function discoverBlockFiles(\n  configDir: string,\n  exclude?: string[]\n): Promise<DiscoveredFile[]> {\n  const patterns = [\n    `**/*${BRAND.blockFileExtension}`,\n    `**/*${BRAND.recipeFileExtension}`,\n  ];\n  const files = await fg(patterns, {\n    cwd: configDir,\n    ignore: exclude ?? ['**/node_modules/**', '**/dist/**'],\n    absolute: false,\n  });\n\n  return files.map((relativePath) => ({\n    relativePath,\n    absolutePath: resolve(configDir, relativePath),\n  }));\n}\n\n/**\n * @deprecated Use discoverBlockFiles instead\n */\nexport const discoverRecipeFiles = discoverBlockFiles;\n\n/**\n * Discover fragment files matching the config patterns\n */\nexport async function discoverFragmentFiles(\n  config: FragmentsConfig,\n  configDir: string\n): Promise<DiscoveredFile[]> {\n  const defaultExcludes = [\n    '**/*.test.stories.*',\n    '**/*.stories.test.*',\n    '**/*.test.story.*',\n    '**/*.story.test.*',\n  ];\n  const files = await fg(config.include, {\n    cwd: configDir,\n    ignore: [...defaultExcludes, ...(config.exclude ?? [])],\n    absolute: false,\n  });\n\n  return files.map((relativePath) => ({\n    relativePath,\n    absolutePath: resolve(configDir, relativePath),\n  }));\n}\n\n/**\n * Discover component files for coverage validation\n */\nexport async function discoverComponentFiles(\n  config: FragmentsConfig,\n  configDir: string\n): Promise<DiscoveredFile[]> {\n  if (!config.components || config.components.length === 0) {\n    return [];\n  }\n\n  const files = await fg(config.components, {\n    cwd: configDir,\n    ignore: [\n      ...(config.exclude ?? []),\n      // Exclude fragment files themselves\n      ...config.include,\n      // Exclude test files\n      '**/*.test.*',\n      '**/*.spec.*',\n      '**/__tests__/**',\n    ],\n    absolute: false,\n  });\n\n  return files.map((relativePath) => ({\n    relativePath,\n    absolutePath: resolve(configDir, relativePath),\n  }));\n}\n\n/**\n * Extract component name from file path\n */\nexport function extractComponentName(filePath: string): string {\n  // Handle index.tsx files - use parent directory name\n  const parts = filePath.replace(/\\\\/g, '/').split('/');\n  const fileName = parts[parts.length - 1];\n\n  if (fileName === 'index.tsx' || fileName === 'index.ts') {\n    return parts[parts.length - 2] ?? 'Unknown';\n  }\n\n  // Remove extension\n  return fileName.replace(/\\.(tsx?|jsx?)$/, '');\n}\n\n/**\n * Default patterns for component discovery\n */\nconst DEFAULT_COMPONENT_PATTERNS = [\n  'src/components/**/*.tsx',\n  'src/components/**/index.tsx',\n  'components/**/*.tsx',\n  'lib/components/**/*.tsx',\n  'packages/*/src/components/**/*.tsx',\n];\n\n/**\n * Patterns to exclude from component discovery\n */\nconst DEFAULT_EXCLUDE_PATTERNS = [\n  '**/*.test.*',\n  '**/*.spec.*',\n  '**/*.stories.*',\n  '**/*.story.*',\n  '**/__tests__/**',\n  '**/__mocks__/**',\n  '**/node_modules/**',\n  '**/dist/**',\n];\n\n/**\n * Discover components from source files\n *\n * This function finds React components by:\n * 1. Looking for TypeScript/TSX files in common component directories\n * 2. Filtering out test files, stories, and internal files\n * 3. Extracting component names from file names or directories\n */\nexport async function discoverComponentsFromSource(\n  configDir: string,\n  patterns?: string[],\n  exclude?: string[]\n): Promise<DiscoveredComponent[]> {\n  const searchPatterns = patterns && patterns.length > 0\n    ? patterns\n    : DEFAULT_COMPONENT_PATTERNS;\n\n  const excludePatterns = [\n    ...DEFAULT_EXCLUDE_PATTERNS,\n    ...(exclude ?? []),\n  ];\n\n  const files = await fg(searchPatterns, {\n    cwd: configDir,\n    ignore: excludePatterns,\n    absolute: false,\n  });\n\n  // Filter to only component-like files (start with uppercase)\n  const componentFiles = files.filter((file) => {\n    const name = extractComponentName(file);\n    return /^[A-Z]/.test(name);\n  });\n\n  // Find associated story files\n  const storyPatterns = [\n    '**/*.stories.tsx',\n    '**/*.stories.ts',\n    '**/*.story.tsx',\n    '**/*.story.ts',\n  ];\n\n  const storyFiles = await fg(storyPatterns, {\n    cwd: configDir,\n    ignore: ['**/node_modules/**', '**/dist/**'],\n    absolute: false,\n  });\n\n  const storyMap = new Map<string, string>();\n  for (const storyFile of storyFiles) {\n    const name = extractComponentName(storyFile.replace(/\\.stories?\\.(tsx?|jsx?)$/, '.tsx'));\n    storyMap.set(name, storyFile);\n  }\n\n  // Build discovered components\n  const components: DiscoveredComponent[] = [];\n\n  for (const file of componentFiles) {\n    const name = extractComponentName(file);\n    const absolutePath = resolve(configDir, file);\n\n    // Look for story file\n    const storyFile = storyMap.get(name);\n\n    components.push({\n      name,\n      sourcePath: absolutePath,\n      relativePath: file,\n      storyPath: storyFile ? resolve(configDir, storyFile) : undefined,\n    });\n  }\n\n  // Sort by name\n  components.sort((a, b) => a.name.localeCompare(b.name));\n\n  return components;\n}\n\n/**\n * Discover components from a barrel export file (index.ts)\n *\n * Parses the barrel file to find exported components.\n * This is useful for libraries that expose components through a single entry point.\n */\nexport async function discoverComponentsFromBarrel(\n  barrelPath: string,\n  configDir: string\n): Promise<DiscoveredComponent[]> {\n  const absoluteBarrelPath = resolve(configDir, barrelPath);\n\n  if (!existsSync(absoluteBarrelPath)) {\n    return [];\n  }\n\n  const content = await readFile(absoluteBarrelPath, 'utf-8');\n  const components: DiscoveredComponent[] = [];\n\n  // Match export statements like:\n  // export { Button } from './Button'\n  // export { Card, CardHeader } from './Card'\n  // export * from './Modal'\n  const exportRegex = /export\\s+(?:\\*|{([^}]+)})\\s+from\\s+['\"]([^'\"]+)['\"]/g;\n\n  let match;\n  while ((match = exportRegex.exec(content)) !== null) {\n    const exportedNames = match[1];\n    const importPath = match[2];\n\n    // Resolve the import path\n    const barrelDir = dirname(absoluteBarrelPath);\n    let resolvedPath = resolve(barrelDir, importPath);\n\n    // Add extension if needed\n    if (!resolvedPath.endsWith('.tsx') && !resolvedPath.endsWith('.ts')) {\n      if (existsSync(`${resolvedPath}.tsx`)) {\n        resolvedPath = `${resolvedPath}.tsx`;\n      } else if (existsSync(`${resolvedPath}.ts`)) {\n        resolvedPath = `${resolvedPath}.ts`;\n      } else if (existsSync(`${resolvedPath}/index.tsx`)) {\n        resolvedPath = `${resolvedPath}/index.tsx`;\n      } else if (existsSync(`${resolvedPath}/index.ts`)) {\n        resolvedPath = `${resolvedPath}/index.ts`;\n      }\n    }\n\n    if (!existsSync(resolvedPath)) {\n      continue;\n    }\n\n    if (exportedNames) {\n      // Named exports: { Button, Card }\n      const names = exportedNames.split(',').map((n) => n.trim().split(/\\s+as\\s+/)[0].trim());\n      for (const name of names) {\n        if (/^[A-Z]/.test(name)) {\n          const relativePath = resolvedPath.replace(configDir + '/', '');\n          components.push({\n            name,\n            sourcePath: resolvedPath,\n            relativePath,\n          });\n        }\n      }\n    } else {\n      // Star export: export * from './Component'\n      const name = extractComponentName(importPath);\n      if (/^[A-Z]/.test(name)) {\n        const relativePath = resolvedPath.replace(configDir + '/', '');\n        components.push({\n          name,\n          sourcePath: resolvedPath,\n          relativePath,\n        });\n      }\n    }\n  }\n\n  return components;\n}\n\n/**\n * Default glob patterns for discovering token files (SCSS/CSS with custom properties)\n */\nconst DEFAULT_TOKEN_PATTERNS = [\n  'src/**/tokens/**/_variables.scss',\n  'src/**/tokens/**/variables.scss',\n  'src/**/styles/**/variables.scss',\n  'src/**/styles/**/tokens.scss',\n  'src/**/styles/**/variables.css',\n  'src/**/theme/**/_variables.scss',\n  'src/**/theme/**/tokens.css',\n];\n\n/**\n * Discover token files (SCSS/CSS files containing CSS custom properties).\n * Uses config.tokens.include patterns if provided, otherwise falls back\n * to default patterns that match common project structures.\n */\nexport async function discoverTokenFiles(\n  configDir: string,\n  patterns?: string[],\n  exclude?: string[]\n): Promise<DiscoveredFile[]> {\n  const searchPatterns = patterns && patterns.length > 0\n    ? patterns\n    : DEFAULT_TOKEN_PATTERNS;\n\n  const files = await fg(searchPatterns, {\n    cwd: configDir,\n    ignore: exclude ?? ['**/node_modules/**', '**/dist/**'],\n    absolute: false,\n  });\n\n  return files.map((relativePath) => ({\n    relativePath,\n    absolutePath: resolve(configDir, relativePath),\n  }));\n}\n\n/**\n * Discover fragment files from installed packages that declare a \"fragments\" field\n * in their package.json. This allows consumer projects to see components from\n * installed packages (e.g. @fragments-sdk/ui) in the dev viewer.\n */\nexport async function discoverInstalledFragments(\n  projectRoot: string\n): Promise<DiscoveredFile[]> {\n  const pkgJsonPath = resolve(projectRoot, 'package.json');\n  if (!existsSync(pkgJsonPath)) return [];\n\n  const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n  const allDeps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };\n  const results: DiscoveredFile[] = [];\n\n  for (const depName of Object.keys(allDeps)) {\n    const depDir = resolve(projectRoot, 'node_modules', depName);\n    const depPkgPath = resolve(depDir, 'package.json');\n    if (!existsSync(depPkgPath)) continue;\n\n    const depPkg = JSON.parse(await readFile(depPkgPath, 'utf-8'));\n    if (!depPkg.fragments) continue;\n\n    // Package declares fragments — scan for source fragment files\n    const files = await fg(\n      [`src/**/*${BRAND.fileExtension}`, 'src/**/*.stories.tsx'],\n      { cwd: depDir, ignore: ['**/node_modules/**'], absolute: false }\n    );\n\n    for (const rel of files) {\n      results.push({\n        relativePath: `${depName}/${rel}`,\n        absolutePath: resolve(depDir, rel),\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Discover all components using multiple strategies\n */\nexport async function discoverAllComponents(\n  configDir: string,\n  options: {\n    patterns?: string[];\n    exclude?: string[];\n    barrelFiles?: string[];\n  } = {}\n): Promise<DiscoveredComponent[]> {\n  const componentsMap = new Map<string, DiscoveredComponent>();\n\n  // Discover from source files\n  const sourceComponents = await discoverComponentsFromSource(\n    configDir,\n    options.patterns,\n    options.exclude\n  );\n\n  for (const comp of sourceComponents) {\n    componentsMap.set(comp.name, comp);\n  }\n\n  // Discover from barrel files if specified\n  if (options.barrelFiles && options.barrelFiles.length > 0) {\n    for (const barrelFile of options.barrelFiles) {\n      const barrelComponents = await discoverComponentsFromBarrel(barrelFile, configDir);\n      for (const comp of barrelComponents) {\n        // Only add if not already found\n        if (!componentsMap.has(comp.name)) {\n          componentsMap.set(comp.name, comp);\n        }\n      }\n    }\n  }\n\n  return Array.from(componentsMap.values()).sort((a, b) => a.name.localeCompare(b.name));\n}\n"],"mappings":"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","names":[]}