@urbicon-ui/docs-gen 6.1.4

package/dist/core/generation/GenerationCoordinator.js

@@ -0,0 +1,206 @@
+import { withErrorHandling } from '../pipeline/ErrorHandler';
+/**
+ * Coordinates all generation operations (API, LLM)
+ * Implements correct API-first dependency order
+ */
+export class GenerationCoordinator {
+    errorHandler;
+    config;
+    constructor(config, errorHandler) {
+        this.errorHandler = errorHandler;
+        this.config = config;
+    }
+    /**
+     * Generate all outputs in correct dependency order (API first, then others)
+     */
+    async generateAll(enrichedComponents, apiData) {
+        console.log('📍 Phase 4: Generation');
+        const outputs = [];
+        const errors = [];
+        const startTime = Date.now();
+        try {
+            // 4a. Generate API file FIRST (other generators depend on this)
+            if (this.config.api.enabled) {
+                const apiOutput = await this.generateAPI(apiData);
+                if (apiOutput) {
+                    outputs.push(apiOutput);
+                }
+            }
+            // 4b. Generate LLM documentation
+            if (this.config.llm.enabled) {
+                const llmResult = await Promise.allSettled([this.generateLLM(enrichedComponents, apiData)]);
+                for (const result of llmResult) {
+                    if (result.status === 'fulfilled' && result.value) {
+                        outputs.push(result.value);
+                    }
+                    else if (result.status === 'rejected') {
+                        errors.push({
+                            type: 'llm_generation_error',
+                            message: `Failed to generate LLM: ${result.reason}`
+                        });
+                    }
+                }
+                // 4c. Generate MCP catalog AFTER LLM (LLM cleans output dir first)
+                const mcpResult = await this.generateMCPCatalog(enrichedComponents, apiData);
+                if (mcpResult)
+                    outputs.push(mcpResult);
+            }
+            const duration = Date.now() - startTime;
+            // Generate statistics
+            const stats = this.generateStats(enrichedComponents, apiData, outputs);
+            console.log(`✅ Generation completed in ${duration}ms`);
+            console.log(`   📄 Generated ${outputs.length} output types`);
+            return {
+                success: errors.length === 0,
+                outputs,
+                errors,
+                stats,
+                duration
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`❌ Generation failed: ${errorMessage}`);
+            return {
+                success: false,
+                outputs,
+                errors: [
+                    {
+                        type: 'generation_coordinator_error',
+                        message: errorMessage
+                    }
+                ],
+                stats: this.generateStats(enrichedComponents, apiData, outputs),
+                duration
+            };
+        }
+    }
+    // ==========================================
+    // INDIVIDUAL GENERATORS
+    // ==========================================
+    /**
+     * Generate API file (must be first)
+     */
+    async generateAPI(apiData) {
+        return withErrorHandling(async () => {
+            console.log('  📄 Generating API file...');
+            const { APIFileGenerator } = await import('../../generators/api/APIFileGenerator');
+            const apiGenerator = new APIFileGenerator(this.config.api);
+            // Validate API data before generation
+            apiGenerator.validateAPIData(apiData);
+            // Create backup if file exists
+            await apiGenerator.createBackup();
+            // Report changes
+            await apiGenerator.reportChanges(apiData);
+            // Generate the API file
+            const apiOutput = await apiGenerator.generate(apiData);
+            console.log(`  ✅ API file generated: ${apiOutput.path} (${Math.round(apiOutput.size / 1024)}KB)`);
+            return apiOutput;
+        }, this.errorHandler, {
+            phase: 'generation',
+            operation: 'api_generation',
+            filePath: this.config.api.outputPath
+        });
+    }
+    /**
+     * Generate LLM documentation
+     */
+    async generateLLM(enrichedComponents, apiData) {
+        return withErrorHandling(async () => {
+            console.log('  🤖 Generating LLM documentation...');
+            const { LLMDocumentationGenerator } = await import('../../generators/llm/LLMDocumentationGenerator');
+            const llmGenerator = new LLMDocumentationGenerator(this.config.llm);
+            const llmOutput = await llmGenerator.generate(enrichedComponents, apiData);
+            console.log(`  ✅ LLM documentation generated: ${llmOutput.path} (${Math.round(llmOutput.size / 1024)}KB)`);
+            return llmOutput;
+        }, this.errorHandler, {
+            phase: 'generation',
+            operation: 'llm_generation',
+            filePath: this.config.llm.outputPath
+        });
+    }
+    /**
+     * Generate MCP catalog (per-package component entries)
+     */
+    async generateMCPCatalog(enrichedComponents, apiData) {
+        return withErrorHandling(async () => {
+            console.log('  📦 Generating MCP catalog entries...');
+            const { MCPCatalogGenerator } = await import('../../generators/mcp/MCPCatalogGenerator');
+            // Infer package name from the first component's package info
+            const firstComp = enrichedComponents[0];
+            const packageName = firstComp?.packageName || '@urbicon-ui/blocks';
+            const generator = new MCPCatalogGenerator(packageName, this.config.llm.outputPath);
+            const result = await generator.generate(enrichedComponents, apiData);
+            console.log(`  ✅ MCP catalog generated: ${result.path} (${result.count} entries)`);
+            return {
+                type: 'api',
+                path: result.path,
+                size: 0,
+                components: enrichedComponents.map((c) => c.name)
+            };
+        }, this.errorHandler, {
+            phase: 'generation',
+            operation: 'mcp_catalog_generation',
+            filePath: this.config.llm.outputPath
+        });
+    }
+    // ==========================================
+    // UTILITIES
+    // ==========================================
+    /**
+     * Generate comprehensive generation statistics
+     */
+    generateStats(enrichedComponents, apiData, outputs) {
+        const totalProps = Object.values(apiData.components).reduce((sum, comp) => sum + comp.props.length, 0);
+        return {
+            totalComponents: enrichedComponents.length,
+            totalProps,
+            apiDataSize: outputs.find((o) => o.type === 'api')?.size || 0
+        };
+    }
+    /**
+     * Validate generation configuration
+     */
+    validateConfiguration() {
+        const errors = [];
+        // Validate API config if enabled
+        if (this.config.api.enabled) {
+            if (!this.config.api.outputPath) {
+                errors.push('API output path is required when API generation is enabled');
+            }
+        }
+        // Validate LLM config if enabled
+        if (this.config.llm.enabled) {
+            if (!this.config.llm.outputPath) {
+                errors.push('LLM output path is required when LLM generation is enabled');
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Get generation plan (useful for dry-run or debugging)
+     */
+    getGenerationPlan() {
+        const phases = [
+            {
+                name: 'API Generation',
+                enabled: this.config.api.enabled,
+                dependencies: [],
+                outputs: this.config.api.enabled ? [this.config.api.outputPath] : []
+            },
+            {
+                name: 'LLM Generation',
+                enabled: this.config.llm.enabled,
+                dependencies: ['API Generation'],
+                outputs: this.config.llm.enabled ? [this.config.llm.outputPath] : []
+            }
+        ];
+        const totalOutputs = phases.reduce((sum, phase) => sum + phase.outputs.length, 0);
+        return { phases, totalOutputs };
+    }
+}
+//# sourceMappingURL=GenerationCoordinator.js.map

package/dist/core/generation/GenerationCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerationCoordinator.js","sourceRoot":"","sources":["../../../src/core/generation/GenerationCoordinator.ts"],"names":[],"mappings":"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"}

package/dist/core/generation/index.d.ts

@@ -0,0 +1,2 @@
+export { GenerationCoordinator } from './GenerationCoordinator';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/generation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/generation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/generation/index.js

@@ -0,0 +1,2 @@
+export { GenerationCoordinator } from './GenerationCoordinator';
+//# sourceMappingURL=index.js.map

package/dist/core/generation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/generation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './discovery';
+export * from './enrichment';
+export * from './extraction';
+export * from './generation';
+export * from './pipeline/ErrorHandler';
+export * from './pipeline/PipelineOrchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AAExC,cAAc,iCAAiC,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,16 @@
+// packages/docs-gen/src/core/index.ts
+// ==========================================
+// CORE MODULE INDEX
+// ==========================================
+// Discovery
+export * from './discovery';
+// Enrichment
+export * from './enrichment';
+// Extraction
+export * from './extraction';
+// Generation
+export * from './generation';
+export * from './pipeline/ErrorHandler';
+// Pipeline
+export * from './pipeline/PipelineOrchestrator';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6CAA6C;AAC7C,oBAAoB;AACpB,6CAA6C;AAE7C,YAAY;AACZ,cAAc,aAAa,CAAC;AAC5B,aAAa;AACb,cAAc,cAAc,CAAC;AAC7B,aAAa;AACb,cAAc,cAAc,CAAC;AAC7B,aAAa;AACb,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,WAAW;AACX,cAAc,iCAAiC,CAAC"}

package/dist/core/pipeline/ErrorHandler.d.ts

@@ -0,0 +1,129 @@
+import type { ComponentInfo, ExtractionError, ExtractionWarning } from '../../types';
+/**
+ * Centralized error handling for the documentation pipeline
+ */
+export declare class ErrorHandler {
+    private options;
+    private errors;
+    private warnings;
+    private context;
+    constructor(options?: ErrorHandlerOptions);
+    /**
+     * Report an error during pipeline execution
+     */
+    reportError(error: PipelineError): void;
+    /**
+     * Report a warning during pipeline execution
+     */
+    reportWarning(warning: PipelineWarning): void;
+    /**
+     * Convert extraction errors to pipeline errors
+     */
+    handleExtractionError(extractionError: ExtractionError, component?: ComponentInfo, phase?: string): void;
+    /**
+     * Convert extraction warnings to pipeline warnings
+     */
+    handleExtractionWarning(extractionWarning: ExtractionWarning, component?: ComponentInfo, phase?: string): void;
+    /**
+     * Set context for error reporting
+     */
+    setContext(context: Partial<ErrorContext>): void;
+    /**
+     * Clear context
+     */
+    clearContext(): void;
+    /**
+     * Execute code with temporary context
+     */
+    withContext<T>(context: Partial<ErrorContext>, fn: () => Promise<T>): Promise<T>;
+    attemptRecovery(_error: PipelineError): Promise<boolean>;
+    /**
+     * Get error summary
+     */
+    getSummary(): ErrorSummary;
+    /**
+     * Check if pipeline can continue
+     */
+    canContinue(): boolean;
+    /**
+     * Generate detailed error report
+     */
+    generateReport(): string;
+    private logError;
+    private logWarning;
+    private groupErrorsByType;
+    private groupErrorsByComponent;
+    private groupErrorsByPhase;
+    /**
+     * Reset error state (useful for watch mode)
+     */
+    reset(): void;
+}
+export interface PipelineError {
+    type: string;
+    phase?: string;
+    component?: string;
+    message: string;
+    originalError?: unknown;
+    severity: 'error' | 'critical';
+    recoverable: boolean;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+    timestamp?: string;
+    context?: ErrorContext;
+}
+export interface PipelineWarning {
+    type: string;
+    phase?: string;
+    component?: string;
+    message: string;
+    suggestion?: string;
+    severity: 'warning' | 'info';
+    timestamp?: string;
+    context?: ErrorContext;
+}
+export interface ErrorContext {
+    packageName?: string;
+    phase?: string;
+    operation?: string;
+    filePath?: string;
+    [key: string]: unknown;
+}
+export interface ErrorHandlerOptions {
+    failFast?: boolean;
+    maxErrors?: number;
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+}
+export interface ErrorSummary {
+    totalErrors: number;
+    totalWarnings: number;
+    criticalErrors: number;
+    recoverableErrors: number;
+    errorsByType: Record<string, number>;
+    errorsByComponent: Record<string, number>;
+    errorsByPhase: Record<string, number>;
+    hasBlockingErrors: boolean;
+}
+/**
+ * Custom exception for pipeline failures
+ */
+export declare class PipelineException extends Error {
+    readonly pipelineError?: PipelineError | undefined;
+    constructor(message: string, pipelineError?: PipelineError | undefined);
+}
+/**
+ * Create a standard pipeline error
+ */
+export declare function createError(type: string, message: string, options?: Partial<PipelineError>): PipelineError;
+/**
+ * Create a standard pipeline warning
+ */
+export declare function createWarning(type: string, message: string, options?: Partial<PipelineWarning>): PipelineWarning;
+/**
+ * Wrap async operations with error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, errorHandler: ErrorHandler, context?: Partial<ErrorContext>): Promise<T | null>;
+//# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/core/pipeline/ErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/ErrorHandler.ts"],"names":[],"mappings":"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"}