@tpitre/story-ui 2.1.5 → 2.3.0

package/dist/mcp-server/sessionManager.js

@@ -0,0 +1,125 @@
+export class SessionManager {
+    constructor() {
+        this.sessions = new Map();
+        this.currentStoryId = null;
+    }
+    static getInstance() {
+        if (!SessionManager.instance) {
+            SessionManager.instance = new SessionManager();
+        }
+        return SessionManager.instance;
+    }
+    /**
+     * Track a newly generated story in the current session
+     */
+    trackStory(sessionId, story) {
+        const sessionStories = this.sessions.get(sessionId) || [];
+        // Extract keywords from prompt and title for smart matching
+        const keywords = this.extractKeywords(story.prompt + ' ' + story.title);
+        const sessionStory = {
+            ...story,
+            timestamp: new Date(),
+            keywords
+        };
+        sessionStories.push(sessionStory);
+        this.sessions.set(sessionId, sessionStories);
+        this.currentStoryId = story.id;
+        console.error(`[SessionManager] Tracked story: ${story.title} (${story.id}) for session ${sessionId}`);
+    }
+    /**
+     * Get the current story being discussed
+     */
+    getCurrentStory(sessionId) {
+        const stories = this.sessions.get(sessionId) || [];
+        if (this.currentStoryId) {
+            return stories.find(s => s.id === this.currentStoryId) || null;
+        }
+        // Return the most recent story if no current story is set
+        return stories[stories.length - 1] || null;
+    }
+    /**
+     * Find a story by context (keywords in the user's message)
+     */
+    findStoryByContext(sessionId, userMessage) {
+        const stories = this.sessions.get(sessionId) || [];
+        if (stories.length === 0)
+            return null;
+        const messageKeywords = this.extractKeywords(userMessage.toLowerCase());
+        // Score each story based on keyword matches
+        const scoredStories = stories.map(story => {
+            const score = story.keywords.filter(keyword => messageKeywords.some(msgKeyword => msgKeyword.includes(keyword) || keyword.includes(msgKeyword))).length;
+            return { story, score };
+        });
+        // Sort by score and recency
+        scoredStories.sort((a, b) => {
+            if (a.score !== b.score)
+                return b.score - a.score;
+            return b.story.timestamp.getTime() - a.story.timestamp.getTime();
+        });
+        // Return the best match if it has any keyword matches
+        if (scoredStories[0].score > 0) {
+            this.currentStoryId = scoredStories[0].story.id;
+            console.error(`[SessionManager] Found story by context: ${scoredStories[0].story.title} (score: ${scoredStories[0].score})`);
+            return scoredStories[0].story;
+        }
+        return null;
+    }
+    /**
+     * Get all stories in the current session
+     */
+    getSessionStories(sessionId) {
+        return this.sessions.get(sessionId) || [];
+    }
+    /**
+     * Set the current story being discussed
+     */
+    setCurrentStory(sessionId, storyId) {
+        const stories = this.sessions.get(sessionId) || [];
+        if (stories.some(s => s.id === storyId)) {
+            this.currentStoryId = storyId;
+            console.error(`[SessionManager] Set current story to: ${storyId}`);
+        }
+    }
+    /**
+     * Clear session data (for cleanup)
+     */
+    clearSession(sessionId) {
+        this.sessions.delete(sessionId);
+        if (this.currentStoryId) {
+            this.currentStoryId = null;
+        }
+    }
+    /**
+     * Extract meaningful keywords from text
+     */
+    extractKeywords(text) {
+        // Remove common words and extract meaningful terms
+        const commonWords = new Set([
+            'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+            'of', 'with', 'by', 'from', 'up', 'about', 'into', 'through', 'during',
+            'before', 'after', 'above', 'below', 'between', 'under', 'again', 'further',
+            'then', 'once', 'create', 'make', 'generate', 'build', 'add', 'update',
+            'component', 'story', 'please', 'should', 'would', 'could'
+        ]);
+        const words = text.toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter(word => word.length > 2 && !commonWords.has(word));
+        // Also extract compound terms (like "toast notification")
+        const phrases = [];
+        const importantPhrases = [
+            'toast notification', 'banner notification', 'success message',
+            'error message', 'warning message', 'info message',
+            'dark mode', 'light mode', 'switch', 'toggle', 'button',
+            'card', 'alert', 'modal', 'dialog', 'form', 'input',
+            'table', 'list', 'grid', 'layout', 'navigation', 'menu'
+        ];
+        const lowerText = text.toLowerCase();
+        for (const phrase of importantPhrases) {
+            if (lowerText.includes(phrase)) {
+                phrases.push(phrase);
+            }
+        }
+        return [...new Set([...words, ...phrases])];
+    }
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Blacklist of component names that AI commonly mistakes for real components
+ * These are often story export names or made-up components that don't exist
+ */
+export declare const BLACKLISTED_COMPONENTS: (string | RegExp)[];
+export declare function isBlacklistedComponent(componentName: string, validComponents: Set<string>, importPath?: string): boolean;
+/**
+ * Common icon name mistakes - maps incorrect names to correct ones
+ */
+export declare const ICON_CORRECTIONS: Record<string, string>;
+export declare function isBlacklistedIcon(iconName: string, allowedIcons: Set<string>): boolean;
+export declare function validateImports(imports: string[], allowedComponents: Set<string>): {
+    valid: string[];
+    invalid: string[];
+    suggestions: Map<string, string[]>;
+};
+/**
+ * Get helpful error message for blacklisted component
+ */
+export declare function getBlacklistErrorMessage(componentName: string, importPath?: string): string;
+//# sourceMappingURL=componentBlacklist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"componentBlacklist.d.ts","sourceRoot":"","sources":["../../story-generator/componentBlacklist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,sBAAsB,qBA2BlC,CAAC;AAOF,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAqCxH;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwBnD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAuBtF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;IAClF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC,CAsBA;AAkCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB3F"}

package/dist/story-generator/componentBlacklist.js

@@ -80,6 +80,10 @@ export const ICON_CORRECTIONS = {
     'ForkIcon': 'RepoForkedIcon',
     'CloseIcon': 'XIcon',
     'CheckmarkIcon': 'CheckIcon',
+    // Ant Design icon corrections
+    'ExclamationTriangleOutlined': 'ExclamationCircleOutlined',
+    'WarningTriangleOutlined': 'WarningOutlined',
+    'ErrorCircleOutlined': 'CloseCircleOutlined',
     'CrossIcon': 'XIcon',
     'EditIcon': 'PencilIcon',
     'DeleteIcon': 'TrashIcon',

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

@@ -0,0 +1,28 @@
+import { StoryUIConfig } from '../story-ui.config.js';
+export interface DiscoveredComponent {
+    name: string;
+    filePath: string;
+    props: string[];
+    description: string;
+    category: 'layout' | 'content' | 'form' | 'navigation' | 'feedback' | 'other';
+    slots?: string[];
+    examples?: string[];
+    __componentPath?: string;
+}
+/**
+ * Discovers components from a directory structure
+ */
+export declare function discoverComponentsFromDirectory(componentsPath: string, componentPrefix?: string): DiscoveredComponent[];
+/**
+ * Discovers components from custom-elements.json (Web Components)
+ */
+export declare function discoverComponentsFromCustomElements(customElementsPath: string, componentPrefix?: string): DiscoveredComponent[];
+/**
+ * Discovers components from package.json exports or index files
+ */
+export declare function discoverComponentsFromPackage(packagePath: string, componentPrefix?: string): DiscoveredComponent[];
+/**
+ * Main discovery function that tries multiple methods
+ */
+export declare function discoverComponents(config: StoryUIConfig): DiscoveredComponent[];
+//# sourceMappingURL=componentDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"componentDiscovery.d.ts","sourceRoot":"","sources":["../../story-generator/componentDiscovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC9E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,MAAM,EACtB,eAAe,GAAE,MAAW,GAC3B,mBAAmB,EAAE,CA2DvB;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,MAAM,EAC1B,eAAe,GAAE,MAAW,GAC3B,mBAAmB,EAAE,CAwCvB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,MAAW,GAC3B,mBAAmB,EAAE,CA8DvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,mBAAmB,EAAE,CAmB/E"}

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/configLoader.js

@@ -25,7 +25,14 @@ export function loadUserConfig() {
     for (const configPath of configPaths) {
         if (fs.existsSync(configPath)) {
             try {
-                console.log(`Loading Story UI config from: ${configPath}`);
+                // Only log to stderr when in MCP mode to avoid corrupting JSON-RPC communication
+                const isMcpMode = process.argv.includes('mcp') || process.env.STORY_UI_MCP_MODE === 'true';
+                if (isMcpMode) {
+                    console.error(`Loading Story UI config from: ${configPath}`);
+                }
+                else {
+                    console.log(`Loading Story UI config from: ${configPath}`);
+                }
                 // Read and evaluate the config file
                 const configContent = fs.readFileSync(configPath, 'utf-8');
                 // Handle both CommonJS and ES modules

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/considerationsLoader.js

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import { logger } from './logger.js';
 /**
  * Loads AI considerations from a markdown or JSON file
  */
@@ -15,7 +16,7 @@ export function loadConsiderations(considerationsPath) {
         for (const possiblePath of possiblePaths) {
             if (fs.existsSync(possiblePath)) {
                 considerationsPath = possiblePath;
-                console.log(`Found considerations file at: ${considerationsPath}`);
+                logger.log(`Found considerations file at: ${considerationsPath}`);
                 break;
             }
         }

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"}