@tpitre/story-ui 2.2.0 → 2.3.0

package/dist/story-generator/componentRegistryGenerator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Component Registry Generator
+ *
+ * This module generates a component registry at build time.
+ * The registry imports all discovered components from the user's component library
+ * and makes them available for runtime JSX compilation in the production app.
+ */
+export interface ComponentRegistryEntry {
+    name: string;
+    importPath: string;
+    namedExport: boolean;
+}
+export interface ComponentRegistryConfig {
+    importPath: string;
+    components: ComponentRegistryEntry[];
+    additionalImports?: Array<{
+        path: string;
+        components: string[];
+    }>;
+}
+/**
+ * Generate the component registry configuration from discovered components
+ * Uses EnhancedComponentDiscovery for comprehensive component detection
+ * including external NPM packages like @mantine/core, @chakra-ui/react, etc.
+ */
+export declare function generateRegistryConfig(): Promise<ComponentRegistryConfig>;
+/**
+ * Synchronous version for backward compatibility
+ * Falls back to basic discovery if enhanced discovery fails
+ */
+export declare function generateRegistryConfigSync(): ComponentRegistryConfig;
+/**
+ * Generate the component registry TypeScript file content
+ */
+export declare function generateRegistryFileContent(registryConfig: ComponentRegistryConfig): string;
+/**
+ * Generate the component registry file and write it to disk
+ * Uses async EnhancedComponentDiscovery for comprehensive component detection
+ */
+export declare function generateComponentRegistry(outputPath: string): Promise<void>;
+/**
+ * Synchronous version for backward compatibility
+ */
+export declare function generateComponentRegistrySync(outputPath: string): void;
+/**
+ * Generate a minimal registry for development/testing
+ */
+export declare function generateMinimalRegistry(importPath: string, componentNames: string[], outputPath: string): void;
+//# sourceMappingURL=componentRegistryGenerator.d.ts.map

package/dist/story-generator/componentRegistryGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentRegistryGenerator.d.ts","sourceRoot":"","sources":["../../story-generator/componentRegistryGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CA6D/E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,uBAAuB,CA4BpE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,uBAAuB,GAAG,MAAM,CAyD3F;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAYtE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAkBN"}

package/dist/story-generator/componentRegistryGenerator.js

@@ -0,0 +1,205 @@
+/**
+ * Component Registry Generator
+ *
+ * This module generates a component registry at build time.
+ * The registry imports all discovered components from the user's component library
+ * and makes them available for runtime JSX compilation in the production app.
+ */
+import fs from 'fs';
+import path from 'path';
+import { loadUserConfig } from './configLoader.js';
+import { discoverComponents } from './componentDiscovery.js';
+import { EnhancedComponentDiscovery } from './enhancedComponentDiscovery.js';
+/**
+ * Generate the component registry configuration from discovered components
+ * Uses EnhancedComponentDiscovery for comprehensive component detection
+ * including external NPM packages like @mantine/core, @chakra-ui/react, etc.
+ */
+export async function generateRegistryConfig() {
+    const config = loadUserConfig();
+    // Use EnhancedComponentDiscovery for better external package support
+    const discovery = new EnhancedComponentDiscovery(config);
+    const enhancedComponents = await discovery.discoverAll();
+    // Group components by their source/import path
+    const componentsByPath = new Map();
+    for (const comp of enhancedComponents) {
+        // Determine the import path for this component
+        let importPath = config.importPath;
+        // If component has a specific source path (for NPM packages), use that
+        if (comp.source && comp.source.type === 'npm' && comp.source.path) {
+            importPath = comp.source.path;
+        }
+        const existing = componentsByPath.get(importPath) || [];
+        if (!existing.includes(comp.name)) {
+            existing.push(comp.name);
+        }
+        componentsByPath.set(importPath, existing);
+    }
+    // Convert to registry entries
+    const entries = [];
+    for (const [importPath, components] of componentsByPath) {
+        for (const compName of components) {
+            entries.push({
+                name: compName,
+                importPath,
+                namedExport: true,
+            });
+        }
+    }
+    // Add components from additionalImports (manual overrides)
+    if (config.additionalImports) {
+        for (const additionalImport of config.additionalImports) {
+            for (const compName of additionalImport.components) {
+                // Check if not already added
+                if (!entries.find(e => e.name === compName && e.importPath === additionalImport.path)) {
+                    entries.push({
+                        name: compName,
+                        importPath: additionalImport.path,
+                        namedExport: true,
+                    });
+                }
+            }
+        }
+    }
+    console.log(`📦 Registry config generated with ${entries.length} components from ${componentsByPath.size} source(s)`);
+    return {
+        importPath: config.importPath,
+        components: entries,
+        additionalImports: config.additionalImports,
+    };
+}
+/**
+ * Synchronous version for backward compatibility
+ * Falls back to basic discovery if enhanced discovery fails
+ */
+export function generateRegistryConfigSync() {
+    const config = loadUserConfig();
+    const discoveredComponents = discoverComponents(config);
+    const entries = discoveredComponents.map((comp) => ({
+        name: comp.name,
+        importPath: config.importPath,
+        namedExport: true,
+    }));
+    // Add components from additionalImports
+    if (config.additionalImports) {
+        for (const additionalImport of config.additionalImports) {
+            for (const compName of additionalImport.components) {
+                entries.push({
+                    name: compName,
+                    importPath: additionalImport.path,
+                    namedExport: true,
+                });
+            }
+        }
+    }
+    return {
+        importPath: config.importPath,
+        components: entries,
+        additionalImports: config.additionalImports,
+    };
+}
+/**
+ * Generate the component registry TypeScript file content
+ */
+export function generateRegistryFileContent(registryConfig) {
+    // Group components by import path
+    const componentsByPath = new Map();
+    for (const comp of registryConfig.components) {
+        const existingComponents = componentsByPath.get(comp.importPath) || [];
+        existingComponents.push(comp.name);
+        componentsByPath.set(comp.importPath, existingComponents);
+    }
+    // Generate import statements
+    const imports = [];
+    const registryEntries = [];
+    for (const [importPath, components] of componentsByPath) {
+        const uniqueComponents = [...new Set(components)];
+        imports.push(`import { ${uniqueComponents.join(', ')} } from '${importPath}';`);
+        registryEntries.push(...uniqueComponents);
+    }
+    // Generate the registry file
+    const content = `/**
+ * Component Registry
+ *
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * This file is generated at build time by story-ui
+ *
+ * It exports all components from your component library
+ * for use in the live preview renderer.
+ */
+
+import React from 'react';
+${imports.join('\n')}
+
+// Component registry - maps component names to their implementations
+export const componentRegistry: Record<string, React.ComponentType<any>> = {
+  ${registryEntries.map(name => `${name}`).join(',\n  ')},
+};
+
+// List of available component names
+export const availableComponents = ${JSON.stringify(registryEntries, null, 2)};
+
+// Export React for use in compiled code
+export { React };
+
+// Helper to get a component by name
+export function getComponent(name: string): React.ComponentType<any> | undefined {
+  return componentRegistry[name];
+}
+
+// Check if a component exists
+export function hasComponent(name: string): boolean {
+  return name in componentRegistry;
+}
+`;
+    return content;
+}
+/**
+ * Generate the component registry file and write it to disk
+ * Uses async EnhancedComponentDiscovery for comprehensive component detection
+ */
+export async function generateComponentRegistry(outputPath) {
+    const registryConfig = await generateRegistryConfig();
+    const content = generateRegistryFileContent(registryConfig);
+    // Ensure directory exists
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, content, 'utf-8');
+    console.log(`✅ Generated component registry with ${registryConfig.components.length} components`);
+    console.log(`   Output: ${outputPath}`);
+}
+/**
+ * Synchronous version for backward compatibility
+ */
+export function generateComponentRegistrySync(outputPath) {
+    const registryConfig = generateRegistryConfigSync();
+    const content = generateRegistryFileContent(registryConfig);
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, content, 'utf-8');
+    console.log(`✅ Generated component registry with ${registryConfig.components.length} components`);
+    console.log(`   Output: ${outputPath}`);
+}
+/**
+ * Generate a minimal registry for development/testing
+ */
+export function generateMinimalRegistry(importPath, componentNames, outputPath) {
+    const registryConfig = {
+        importPath,
+        components: componentNames.map(name => ({
+            name,
+            importPath,
+            namedExport: true,
+        })),
+    };
+    const content = generateRegistryFileContent(registryConfig);
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, content, 'utf-8');
+}

package/dist/story-generator/configLoader.d.ts

@@ -0,0 +1,33 @@
+import { StoryUIConfig } from '../story-ui.config.js';
+/**
+ * Loads Story UI configuration from the user's project
+ * Looks for story-ui.config.js in the current working directory
+ * Uses caching to prevent excessive loading
+ */
+export declare function loadUserConfig(): StoryUIConfig;
+/**
+ * Validates that the configuration has the necessary paths and components
+ */
+export declare function validateConfig(config: StoryUIConfig): {
+    isValid: boolean;
+    errors: string[];
+};
+/**
+ * Analyzes existing Storybook files to detect design system patterns
+ */
+export declare function analyzeExistingStories(projectRoot?: string): {
+    storyFiles: string[];
+    componentDirs: string[];
+    importPaths: string[];
+    componentPrefixes: string[];
+    layoutPatterns: string[];
+};
+/**
+ * Detects the Storybook framework being used
+ */
+export declare function detectStorybookFramework(dependencies: Record<string, string>): string;
+/**
+ * Auto-detects design system configuration by analyzing the project structure
+ */
+export declare function autoDetectDesignSystem(): Partial<StoryUIConfig> | null;
+//# sourceMappingURL=configLoader.d.ts.map

package/dist/story-generator/configLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.d.ts","sourceRoot":"","sources":["../../story-generator/configLoader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAuC,MAAM,uBAAuB,CAAC;AAO3F;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAkG9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsD5F;AA0DD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,GAAE,MAAsB,GAAG;IAC3E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAkGA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWrF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAqEtE"}

package/dist/story-generator/considerationsLoader.d.ts

@@ -0,0 +1,32 @@
+export interface AIConsiderations {
+    libraryName?: string;
+    importPath?: string;
+    description?: string;
+    corePrinciples?: string[];
+    componentRules?: Record<string, any>;
+    imports?: Record<string, any>;
+    patterns?: Record<string, any>;
+    dos?: string[];
+    donts?: string[];
+    specialConsiderations?: string[];
+    commonMistakes?: Array<{
+        issue: string;
+        wrong: string;
+        correct: string;
+        explanation: string;
+    }>;
+    aiInstructions?: {
+        general?: string[];
+        codeGeneration?: string[];
+        testing?: string[];
+    };
+}
+/**
+ * Loads AI considerations from a markdown or JSON file
+ */
+export declare function loadConsiderations(considerationsPath?: string): AIConsiderations | null;
+/**
+ * Converts considerations to prompt additions
+ */
+export declare function considerationsToPrompt(considerations: AIConsiderations): string;
+//# sourceMappingURL=considerationsLoader.d.ts.map

package/dist/story-generator/considerationsLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"considerationsLoader.d.ts","sourceRoot":"","sources":["../../story-generator/considerationsLoader.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAqCvF;AA+HD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,gBAAgB,GAAG,MAAM,CA6D/E"}

package/dist/story-generator/documentation-sources.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Documentation sources for design systems
+ * Provides fallback documentation when custom docs aren't available
+ */
+export interface DocumentationSource {
+    version?: string;
+    url?: string;
+    lastUpdated?: string;
+}
+/**
+ * Pre-bundled documentation for popular design systems
+ * Users should provide their own documentation in story-ui-docs/ directory for best results
+ */
+export declare const BUNDLED_DOCUMENTATION: Record<string, any>;
+/**
+ * Get documentation for a design system
+ * Falls back to bundled docs if no scraped docs exist
+ */
+export declare function getDocumentation(importPath: string): any;
+/**
+ * Check if a component is deprecated for a given design system
+ */
+export declare function isDeprecatedComponent(importPath: string, componentName: string): boolean;
+/**
+ * Get replacement suggestion for a deprecated component
+ */
+export declare function getComponentReplacement(importPath: string, componentName: string): string | null;
+//# sourceMappingURL=documentation-sources.d.ts.map

package/dist/story-generator/documentation-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-sources.d.ts","sourceRoot":"","sources":["../../story-generator/documentation-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAGrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAMxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAGxF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhG"}

package/dist/story-generator/documentationLoader.d.ts

@@ -0,0 +1,64 @@
+export interface DocumentationSource {
+    type: 'markdown' | 'json' | 'html' | 'txt';
+    path: string;
+    content: string;
+    category?: string;
+}
+export interface LoadedDocumentation {
+    sources: DocumentationSource[];
+    guidelines: string[];
+    tokens: Record<string, any>;
+    patterns: Record<string, string>;
+    components: Record<string, any>;
+}
+export declare class DocumentationLoader {
+    private docsDir;
+    private cache;
+    private lastModified;
+    constructor(projectRoot: string);
+    /**
+     * Check if documentation directory exists
+     */
+    hasDocumentation(): boolean;
+    /**
+     * Load all documentation from the directory
+     */
+    loadDocumentation(): Promise<LoadedDocumentation>;
+    /**
+     * Categorize file based on path and name
+     */
+    private categorizeFile;
+    /**
+     * Process a documentation source based on its type and category
+     */
+    private processSource;
+    /**
+     * Format documentation for AI prompt
+     */
+    formatForPrompt(docs: LoadedDocumentation): string;
+}
+/**
+ * Example directory structure:
+ *
+ * story-ui-docs/
+ * ├── README.md                    # Overview and getting started
+ * ├── guidelines/
+ * │   ├── accessibility.md         # Accessibility guidelines
+ * │   ├── responsive-design.md     # Responsive design rules
+ * │   └── brand-guidelines.md      # Brand usage
+ * ├── tokens/
+ * │   ├── colors.json             # Color tokens
+ * │   ├── spacing.md              # Spacing system
+ * │   ├── typography.json         # Typography tokens
+ * │   └── shadows.json            # Shadow tokens
+ * ├── components/
+ * │   ├── button.md               # Button documentation
+ * │   ├── form-fields.md          # Form component docs
+ * │   └── navigation.md           # Navigation patterns
+ * └── patterns/
+ *     ├── forms.md                # Form patterns
+ *     ├── cards.md                # Card layouts
+ *     ├── data-tables.md          # Table patterns
+ *     └── authentication.md       # Auth flow patterns
+ */
+//# sourceMappingURL=documentationLoader.d.ts.map

package/dist/story-generator/documentationLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentationLoader.d.ts","sourceRoot":"","sources":["../../story-generator/documentationLoader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,YAAY,CAAa;gBAErB,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAmFvD;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM;CA0BnD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/story-generator/dynamicPackageDiscovery.d.ts

@@ -0,0 +1,97 @@
+export interface RealPackageComponent {
+    name: string;
+    isComponent: boolean;
+    type: 'function' | 'class' | 'object' | 'unknown';
+    __componentPath?: string;
+}
+export interface PackageExports {
+    components: RealPackageComponent[];
+    allExports: string[];
+    packageVersion: string;
+}
+/**
+ * Dynamically discovers what components are actually available in an installed package
+ */
+export declare class DynamicPackageDiscovery {
+    private packageName;
+    private projectRoot;
+    constructor(packageName: string, projectRoot?: string);
+    /**
+     * Get the real exports from the installed package
+     */
+    getRealPackageExports(): Promise<PackageExports | null>;
+    /**
+     * Require the package safely
+     */
+    private requirePackage;
+    /**
+     * Determine if an export is likely a React component
+     */
+    private isLikelyComponent;
+    /**
+     * Check if a name indicates a utility export (not a component)
+     */
+    private isUtilityExport;
+    /**
+     * Check if a function looks like a React component
+     */
+    private looksLikeReactComponent;
+    /**
+     * Check if an object has component-like properties
+     */
+    private hasComponentLikeProperties;
+    /**
+     * Get the type of an export
+     */
+    private getExportType;
+    /**
+     * Get only the component names that should be used for story generation
+     */
+    getAvailableComponentNames(): Promise<string[]>;
+    /**
+     * Validate that a list of component names are actually available
+     */
+    validateComponentNames(componentNames: string[]): Promise<{
+        valid: string[];
+        invalid: string[];
+        suggestions: Map<string, string>;
+    }>;
+    /**
+     * Find a similar component name
+     */
+    private findSimilarComponent;
+    /**
+     * Alternative discovery method when package imports fail due to CSS
+     * Analyzes package.json exports and TypeScript definitions
+     */
+    private discoverFromPackageStructure;
+    /**
+     * Scan package subdirectories for components (e.g., antd/button, chakra-ui/input)
+     */
+    private scanComponentSubdirectories;
+    /**
+     * Extract component names from TypeScript declaration content
+     */
+    private extractComponentsFromTypings;
+    /**
+     * Check if a name looks like a React component
+     */
+    private isComponentName;
+    /**
+     * Extract component exports from package.json exports field
+     */
+    private extractExportsFromPackageJson;
+    /**
+     * Extract component declarations from TypeScript definition files
+     */
+    private extractExportsFromTypeDefinitions;
+}
+/**
+ * Create a dynamic discovery instance for a package
+ */
+export declare function createDynamicDiscovery(packageName: string, projectRoot?: string): DynamicPackageDiscovery;
+/**
+ * Quick function to get available components for a package
+ */
+export declare function getPackageComponents(packageName: string, projectRoot?: string): Promise<string[]>;
+//# sourceMappingURL=dynamicPackageDiscovery.d.ts.map

package/dist/story-generator/dynamicPackageDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicPackageDiscovery.d.ts","sourceRoot":"","sources":["../../story-generator/dynamicPackageDiscovery.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB;IAKpE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0G7D;;OAEG;YACW,cAAc;IAiD5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYrD;;OAEG;IACG,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IAyBF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA2CpC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiDnC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoCpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAyBrC;;OAEG;IACH,OAAO,CAAC,iCAAiC;CA+B1C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAEzG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvG"}

package/dist/story-generator/enhancedComponentDiscovery.d.ts

@@ -0,0 +1,125 @@
+import { DiscoveredComponent } from './componentDiscovery.js';
+import { StoryUIConfig } from '../story-ui.config.js';
+export interface ComponentSource {
+    type: 'npm' | 'local' | 'custom-elements' | 'typescript';
+    path: string;
+    patterns?: string[];
+}
+export interface EnhancedComponent extends DiscoveredComponent {
+    source: ComponentSource;
+    docUrl?: string;
+    examples?: string[];
+    dependencies?: string[];
+    isComposite?: boolean;
+}
+export declare class EnhancedComponentDiscovery {
+    private config;
+    private discoveredComponents;
+    private validateAvailableComponents;
+    constructor(config: StoryUIConfig);
+    /**
+     * Discover components from all available sources
+     * Priority: 1. Dynamic Discovery 2. Static Lists 3. Manual Config
+     */
+    discoverAll(): Promise<EnhancedComponent[]>;
+    /**
+     * Resolve naming conflicts between different sources
+     * Priority: Local > Manual Config > npm packages
+     */
+    private resolveComponentConflicts;
+    /**
+     * Log discovery summary for debugging
+     */
+    private logDiscoverySummary;
+    /**
+ * Get the project root directory from the config
+ */
+    private getProjectRoot;
+    /**
+     * Identify all potential component sources
+     */
+    private identifySources;
+    /**
+     * Auto-discovery removed - now handled by guided installation during init
+     * This function is kept for backward compatibility but does nothing
+     */
+    private addDesignSystemPackages;
+    /**
+     * Check if a package is likely to contain React components (not utilities, types, etc.)
+     */
+    private isLikelyComponentPackage;
+    /**
+   * Discover components from npm packages using dynamic runtime discovery
+   */
+    private discoverFromNpmPackage;
+    /**
+     * Get known components for popular design systems
+     * Returns a fallback list when dynamic discovery fails
+     */
+    private getKnownDesignSystemComponents;
+    /**
+     * Discover components from local files
+     */
+    private discoverFromLocalFiles;
+    /**
+     * Check if a file should be skipped (stories, tests, etc.)
+     */
+    private isNonComponentFile;
+    /**
+     * Check if a component should be skipped based on name or content
+     */
+    private shouldSkipComponent;
+    /**
+     * Find component files recursively
+     */
+    private findComponentFiles;
+    /**
+     * Extract component name from file
+     */
+    private extractComponentName;
+    /**
+     * Extract props from file content
+     */
+    private extractPropsFromFile;
+    /**
+     * Extract slots from content
+     */
+    private extractSlots;
+    /**
+     * Categorize component based on name and content
+     */
+    private categorizeComponent;
+    /**
+     * Discover from custom elements JSON
+     */
+    private discoverFromCustomElements;
+    /**
+     * Extract props from custom element declaration
+     */
+    private extractPropsFromDeclaration;
+    /**
+     * Discover from TypeScript definitions
+     */
+    private discoverFromTypeScript;
+    /**
+     * Apply manual component configurations
+     */
+    private applyManualConfigurations;
+    /**
+     * Validate that component names actually exist in the discovered package
+     */
+    validateComponentNames(componentNames: string[]): Promise<{
+        valid: string[];
+        invalid: string[];
+        suggestions: Map<string, string>;
+    }>;
+    /**
+     * Find a similar component name
+     */
+    private findSimilarComponent;
+    /**
+     * Get the available component names for validation
+     */
+    getAvailableComponentNames(): string[];
+}
+//# sourceMappingURL=enhancedComponentDiscovery.d.ts.map

package/dist/story-generator/enhancedComponentDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedComponentDiscovery.d.ts","sourceRoot":"","sources":["../../story-generator/enhancedComponentDiscovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,iBAAiB,GAAG,YAAY,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,oBAAoB,CAA6C;IACzE,OAAO,CAAC,2BAA2B,CAA0B;gBAEjD,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA2CjD;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAyCjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAWvB;;GAED;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6GvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6B9B;;KAEC;YACW,sBAAsB;IAsEpC;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAmJtC;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;YACW,0BAA0B;IAmCxC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;YACW,sBAAsB;IAMpC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4CjC;;OAEG;IACG,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IAwCF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;OAEG;IACH,0BAA0B,IAAI,MAAM,EAAE;CAMvC"}