@urbicon-ui/docs-gen 6.1.4

package/dist/core/pipeline/ErrorHandler.js

@@ -0,0 +1,321 @@
+/**
+ * Centralized error handling for the documentation pipeline
+ */
+export class ErrorHandler {
+    options;
+    errors = [];
+    warnings = [];
+    context = {};
+    constructor(options = {}) {
+        this.options = options;
+        this.options = {
+            failFast: false,
+            maxErrors: 100,
+            logLevel: 'info',
+            ...options
+        };
+    }
+    // ==========================================
+    // ERROR REPORTING
+    // ==========================================
+    /**
+     * Report an error during pipeline execution
+     */
+    reportError(error) {
+        this.errors.push({
+            ...error,
+            timestamp: new Date().toISOString(),
+            context: { ...this.context }
+        });
+        this.logError(error);
+        // Check if we should fail fast
+        if (this.options.failFast) {
+            throw new PipelineException(error.message, error);
+        }
+        // Check if we've exceeded max errors
+        if (this.errors.length >= this.options.maxErrors) {
+            throw new PipelineException(`Maximum error count exceeded (${this.options.maxErrors})`, this.errors[this.errors.length - 1]);
+        }
+    }
+    /**
+     * Report a warning during pipeline execution
+     */
+    reportWarning(warning) {
+        this.warnings.push({
+            ...warning,
+            timestamp: new Date().toISOString(),
+            context: { ...this.context }
+        });
+        this.logWarning(warning);
+    }
+    /**
+     * Convert extraction errors to pipeline errors
+     */
+    handleExtractionError(extractionError, component, phase) {
+        const pipelineError = {
+            type: 'extraction_error',
+            message: extractionError.message,
+            originalError: extractionError,
+            severity: 'error',
+            recoverable: true
+        };
+        if (phase)
+            pipelineError.phase = phase;
+        else
+            pipelineError.phase = 'extraction';
+        if (component?.name)
+            pipelineError.component = component.name;
+        if (extractionError.location)
+            pipelineError.location = extractionError.location;
+        this.reportError(pipelineError);
+    }
+    /**
+     * Convert extraction warnings to pipeline warnings
+     */
+    handleExtractionWarning(extractionWarning, component, phase) {
+        const pipelineWarning = {
+            type: 'extraction_warning',
+            message: extractionWarning.message,
+            severity: 'warning'
+        };
+        if (phase)
+            pipelineWarning.phase = phase;
+        else
+            pipelineWarning.phase = 'extraction';
+        if (component?.name)
+            pipelineWarning.component = component.name;
+        if (extractionWarning.suggestion)
+            pipelineWarning.suggestion = extractionWarning.suggestion;
+        this.reportWarning(pipelineWarning);
+    }
+    // ==========================================
+    // CONTEXT MANAGEMENT
+    // ==========================================
+    /**
+     * Set context for error reporting
+     */
+    setContext(context) {
+        this.context = { ...this.context, ...context };
+    }
+    /**
+     * Clear context
+     */
+    clearContext() {
+        this.context = {};
+    }
+    /**
+     * Execute code with temporary context
+     */
+    async withContext(context, fn) {
+        const previousContext = { ...this.context };
+        this.setContext(context);
+        try {
+            return await fn();
+        }
+        finally {
+            this.context = previousContext;
+        }
+    }
+    // ==========================================
+    // ERROR RECOVERY
+    // ==========================================
+    async attemptRecovery(_error) {
+        return false;
+    }
+    // ==========================================
+    // REPORTING & SUMMARY
+    // ==========================================
+    /**
+     * Get error summary
+     */
+    getSummary() {
+        const errorsByType = this.groupErrorsByType();
+        const errorsByComponent = this.groupErrorsByComponent();
+        const errorsByPhase = this.groupErrorsByPhase();
+        return {
+            totalErrors: this.errors.length,
+            totalWarnings: this.warnings.length,
+            criticalErrors: this.errors.filter((e) => e.severity === 'critical').length,
+            recoverableErrors: this.errors.filter((e) => e.recoverable).length,
+            errorsByType,
+            errorsByComponent,
+            errorsByPhase,
+            hasBlockingErrors: this.errors.some((e) => e.severity === 'critical' || !e.recoverable)
+        };
+    }
+    /**
+     * Check if pipeline can continue
+     */
+    canContinue() {
+        const summary = this.getSummary();
+        return !summary.hasBlockingErrors;
+    }
+    /**
+     * Generate detailed error report
+     */
+    generateReport() {
+        const summary = this.getSummary();
+        const lines = [];
+        lines.push('📊 Pipeline Error Report');
+        lines.push('========================');
+        lines.push('');
+        if (summary.totalErrors === 0 && summary.totalWarnings === 0) {
+            lines.push('✅ No errors or warnings reported');
+            return lines.join('\n');
+        }
+        lines.push(`📊 Summary:`);
+        lines.push(`  • Errors: ${summary.totalErrors} (${summary.criticalErrors} critical)`);
+        lines.push(`  • Warnings: ${summary.totalWarnings}`);
+        lines.push(`  • Recoverable: ${summary.recoverableErrors}`);
+        lines.push('');
+        if (summary.totalErrors > 0) {
+            lines.push('❌ Errors by Type:');
+            Object.entries(summary.errorsByType).forEach(([type, count]) => {
+                lines.push(`  • ${type}: ${count}`);
+            });
+            lines.push('');
+            lines.push('❌ Errors by Component:');
+            Object.entries(summary.errorsByComponent).forEach(([component, count]) => {
+                lines.push(`  • ${component || 'unknown'}: ${count}`);
+            });
+            lines.push('');
+            lines.push('❌ Recent Errors:');
+            this.errors.slice(-5).forEach((error) => {
+                lines.push(`  • [${error.phase}] ${error.component || 'unknown'}: ${error.message}`);
+            });
+            lines.push('');
+        }
+        if (summary.totalWarnings > 0) {
+            lines.push('⚠️  Recent Warnings:');
+            this.warnings.slice(-5).forEach((warning) => {
+                lines.push(`  • [${warning.phase}] ${warning.component || 'unknown'}: ${warning.message}`);
+            });
+        }
+        return lines.join('\n');
+    }
+    // ==========================================
+    // PRIVATE METHODS
+    // ==========================================
+    logError(error) {
+        const prefix = error.component ? `[${error.component}]` : '[Pipeline]';
+        const phaseInfo = error.phase ? ` (${error.phase})` : '';
+        console.error(`❌ ${prefix}${phaseInfo} ${error.message}`);
+        if (error.location && this.options.logLevel === 'debug') {
+            console.error(`   📍 ${error.location.file}:${error.location.line}:${error.location.column}`);
+        }
+    }
+    logWarning(warning) {
+        const prefix = warning.component ? `[${warning.component}]` : '[Pipeline]';
+        const phaseInfo = warning.phase ? ` (${warning.phase})` : '';
+        console.warn(`⚠️  ${prefix}${phaseInfo} ${warning.message}`);
+        if (warning.suggestion && this.options.logLevel !== 'error') {
+            console.warn(`   💡 ${warning.suggestion}`);
+        }
+    }
+    groupErrorsByType() {
+        const groups = {};
+        this.errors.forEach((error) => {
+            groups[error.type] = (groups[error.type] || 0) + 1;
+        });
+        return groups;
+    }
+    groupErrorsByComponent() {
+        const groups = {};
+        this.errors.forEach((error) => {
+            const component = error.component || 'unknown';
+            groups[component] = (groups[component] || 0) + 1;
+        });
+        return groups;
+    }
+    groupErrorsByPhase() {
+        const groups = {};
+        this.errors.forEach((error) => {
+            const phase = error.phase || 'unknown';
+            groups[phase] = (groups[phase] || 0) + 1;
+        });
+        return groups;
+    }
+    /**
+     * Reset error state (useful for watch mode)
+     */
+    reset() {
+        this.errors = [];
+        this.warnings = [];
+        this.context = {};
+    }
+}
+/**
+ * Custom exception for pipeline failures
+ */
+export class PipelineException extends Error {
+    pipelineError;
+    constructor(message, pipelineError) {
+        super(message);
+        this.pipelineError = pipelineError;
+        this.name = 'PipelineException';
+    }
+}
+// ==========================================
+// UTILITY FUNCTIONS
+// ==========================================
+/**
+ * Create a standard pipeline error
+ */
+export function createError(type, message, options = {}) {
+    return {
+        type,
+        message,
+        severity: 'error',
+        recoverable: true,
+        ...options
+    };
+}
+/**
+ * Create a standard pipeline warning
+ */
+export function createWarning(type, message, options = {}) {
+    return {
+        type,
+        message,
+        severity: 'warning',
+        ...options
+    };
+}
+/**
+ * Wrap async operations with error handling
+ */
+export async function withErrorHandling(operation, errorHandler, context = {}) {
+    return errorHandler.withContext(context, async () => {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const opts = { originalError: error, recoverable: true };
+            if (context.phase)
+                opts.phase = context.phase;
+            if (context.packageName)
+                opts.component = context.packageName;
+            const pipelineError = createError('operation_failed', error instanceof Error ? error.message : String(error), opts);
+            errorHandler.reportError(pipelineError);
+            // Try to recover
+            const recovered = await errorHandler.attemptRecovery(pipelineError);
+            if (!recovered) {
+                return null;
+            }
+            // Retry if recovery succeeded
+            try {
+                return await operation();
+            }
+            catch (retryError) {
+                const retryOpts = { recoverable: false };
+                if (context.phase)
+                    retryOpts.phase = context.phase;
+                if (context.packageName)
+                    retryOpts.component = context.packageName;
+                errorHandler.reportError(createError('recovery_retry_failed', `Retry after recovery failed: ${retryError instanceof Error ? retryError.message : String(retryError)}`, retryOpts));
+                return null;
+            }
+        }
+    });
+}
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/core/pipeline/ErrorHandler.js.map

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

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

@@ -0,0 +1,45 @@
+import type { GenerationResult, GeneratorConfig } from '../../types';
+/**
+ * Main orchestrator for the documentation generation pipeline.
+ * Coordinates all phases: Discovery → Extraction → Enrichment → Generation
+ */
+export declare class PipelineOrchestrator {
+    private config;
+    private startTime;
+    private errorHandler;
+    constructor(config: GeneratorConfig);
+    /**
+     * Execute the complete documentation generation pipeline
+     */
+    execute(): Promise<GenerationResult>;
+    /**
+     * Phase 1: Discovery - Find all components and their files
+     */
+    private discoveryPhase;
+    /**
+     * Phase 2: Extraction - Extract props, variants, inheritance, docs
+     */
+    private extractionPhase;
+    /**
+     * Phase 3: Enrichment - Add cross-references, validate examples, generate API data
+     */
+    private enrichmentPhase;
+    /**
+     * Phase 4: Generation - Generate API file, then LLM docs
+     * CRITICAL: API must be generated FIRST, then consumed by LLM
+     */
+    private generationPhase;
+    /**
+     * Create error result for failed pipeline execution
+     */
+    private createErrorResult;
+    /**
+     * Get current configuration
+     */
+    getConfig(): GeneratorConfig;
+    /**
+     * Update configuration (useful for watch mode)
+     */
+    updateConfig(newConfig: GeneratorConfig): void;
+}
+//# sourceMappingURL=PipelineOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/PipelineOrchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AASrB;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,EAAE,eAAe;IASnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAwF1C;;OAEG;YACW,cAAc;IAqC5B;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,eAAe;IAyC7B;;;OAGG;YACW,eAAe;IA2B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;CAG/C"}

package/dist/core/pipeline/PipelineOrchestrator.js

@@ -0,0 +1,216 @@
+import { ErrorHandler, ExtractionCoordinator, GenerationCoordinator, PipelineException, withErrorHandling } from '..';
+/**
+ * Main orchestrator for the documentation generation pipeline.
+ * Coordinates all phases: Discovery → Extraction → Enrichment → Generation
+ */
+export class PipelineOrchestrator {
+    config;
+    startTime = 0;
+    errorHandler;
+    constructor(config) {
+        this.config = config;
+        this.errorHandler = new ErrorHandler({
+            failFast: !config.processing?.parallel?.enabled,
+            maxErrors: 50,
+            logLevel: config.debug?.level || 'info'
+        });
+    }
+    /**
+     * Execute the complete documentation generation pipeline
+     */
+    async execute() {
+        this.startTime = Date.now();
+        this.errorHandler.reset();
+        try {
+            console.log('🚀 Starting documentation generation pipeline...');
+            // Phase 1: Discovery
+            const manifests = await withErrorHandling(() => this.discoveryPhase(), this.errorHandler, {
+                phase: 'discovery'
+            });
+            if (!manifests || manifests.length === 0) {
+                throw new PipelineException('No components discovered');
+            }
+            // Phase 2: Extraction
+            const richComponents = await withErrorHandling(() => this.extractionPhase(manifests), this.errorHandler, { phase: 'extraction' });
+            if (!richComponents) {
+                throw new PipelineException('Component extraction failed');
+            }
+            // Phase 3: Enrichment
+            const enrichmentResult = await withErrorHandling(() => this.enrichmentPhase(richComponents), this.errorHandler, { phase: 'enrichment' });
+            if (!enrichmentResult) {
+                throw new PipelineException('Component enrichment failed');
+            }
+            // Phase 4: Generation (API first, then others)
+            const result = await withErrorHandling(() => this.generationPhase(enrichmentResult.enrichedComponents, enrichmentResult.apiData), this.errorHandler, { phase: 'generation' });
+            if (!result) {
+                throw new PipelineException('Documentation generation failed');
+            }
+            // Check if we can continue despite errors
+            if (!this.errorHandler.canContinue()) {
+                console.error('❌ Pipeline completed with blocking errors');
+                console.error(this.errorHandler.generateReport());
+                return this.createErrorResult(new Error('Pipeline had blocking errors'));
+            }
+            const summary = this.errorHandler.getSummary();
+            if (summary.totalErrors > 0 || summary.totalWarnings > 0) {
+                console.warn(`⚠️  Pipeline completed with ${summary.totalErrors} errors and ${summary.totalWarnings} warnings`);
+                if (this.config.debug?.enabled) {
+                    console.warn(this.errorHandler.generateReport());
+                }
+            }
+            else {
+                console.log('✅ Pipeline completed successfully');
+            }
+            return {
+                ...result,
+                errors: result.errors.concat(summary.totalErrors > 0
+                    ? [
+                        {
+                            type: 'pipeline_warnings',
+                            message: `Pipeline completed with ${summary.totalErrors} errors and ${summary.totalWarnings} warnings`
+                        }
+                    ]
+                    : [])
+            };
+        }
+        catch (error) {
+            console.error('❌ Pipeline failed:', error);
+            console.error(this.errorHandler.generateReport());
+            return this.createErrorResult(error);
+        }
+    }
+    /**
+     * Phase 1: Discovery - Find all components and their files
+     */
+    async discoveryPhase() {
+        console.log('📍 Phase 1: Discovery');
+        const { ComponentFinder } = await import('../discovery/ComponentFinder');
+        const componentFinder = new ComponentFinder();
+        const allManifests = [];
+        for (const packageConfig of this.config.input.packages) {
+            console.log(`  📦 Processing package: ${packageConfig.name}`);
+            try {
+                const manifests = await componentFinder.findComponents(packageConfig);
+                allManifests.push(...manifests);
+                console.log(`  ✅ Found ${manifests.length} components in ${packageConfig.name}`);
+                // Validate each manifest
+                for (const manifest of manifests) {
+                    const validation = await componentFinder.validateManifest(manifest);
+                    if (!validation.success) {
+                        console.warn(`  ⚠️  Validation issues for ${manifest.component.name}:`, validation.errors.map((e) => e.message).join(', '));
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`  ❌ Failed to process package ${packageConfig.name}:`, error);
+                // Continue with other packages
+            }
+        }
+        console.log(`  📊 Discovery complete: ${allManifests.length} total components`);
+        return allManifests;
+    }
+    /**
+     * Phase 2: Extraction - Extract props, variants, inheritance, docs
+     */
+    async extractionPhase(manifests) {
+        console.log('📍 Phase 2: Extraction');
+        const extractionCoordinator = new ExtractionCoordinator(this.config.processing, this.errorHandler);
+        const richComponents = await extractionCoordinator.extractAllComponents(manifests);
+        // Display statistics
+        const stats = extractionCoordinator.generateExtractionStats(richComponents);
+        console.log(`  📊 Extraction statistics:`);
+        console.log(`     Components: ${stats.totalComponents}`);
+        console.log(`     Props: ${stats.totalProps} (avg: ${stats.averagePropsPerComponent}/component)`);
+        console.log(`     Variants: ${stats.totalVariants}`);
+        console.log(`     With Documentation: ${stats.componentsWithDocumentation}`);
+        return richComponents;
+    }
+    /**
+     * Phase 3: Enrichment - Add cross-references, validate examples, generate API data
+     */
+    async enrichmentPhase(richComponents) {
+        console.log('📍 Phase 3: Enrichment');
+        // Could be moved into EnrichmentCoordinator, but it is already fairly clean
+        const { APIDataGenerator } = await import('../enrichment/APIDataGenerator');
+        // Create enriched components with basic stats for now
+        const enrichedComponents = richComponents.map((component) => ({
+            ...component,
+            crossReferences: [],
+            examples: [],
+            stats: {
+                totalProps: component.props.length,
+                directProps: component.props.filter((p) => p.source.type === 'direct').length,
+                variantProps: component.variants.length,
+                inheritedProps: component.props.filter((p) => p.source.type === 'inherited').length
+            }
+        }));
+        // Generate API data using APIDataGenerator
+        console.log('  📊 Generating API data...');
+        const apiDataGenerator = new APIDataGenerator();
+        const apiData = await apiDataGenerator.generate(richComponents, {
+            routeBasePath: '/components'
+        });
+        console.log(`  ✅ Enrichment complete: ${enrichedComponents.length} components, ${apiData.metadata.totalProps} total props`);
+        // Harmonize stats: prefer API data (single source of truth)
+        const enrichedWithApiStats = enrichedComponents.map((c) => {
+            const api = apiData.components[c.name];
+            return api ? { ...c, stats: api.stats } : c;
+        });
+        return { enrichedComponents: enrichedWithApiStats, apiData };
+    }
+    /**
+     * Phase 4: Generation - Generate API file, then LLM docs
+     * CRITICAL: API must be generated FIRST, then consumed by LLM
+     */
+    async generationPhase(enrichedComponents, apiData) {
+        console.log('📍 Phase 4: Generation');
+        // Dedicated coordinator handles the entire generation logic
+        const generationCoordinator = new GenerationCoordinator(this.config.output, this.errorHandler);
+        // Validate configuration
+        const configValidation = generationCoordinator.validateConfiguration();
+        if (!configValidation.valid) {
+            console.warn('⚠️  Generation configuration issues:', configValidation.errors);
+        }
+        // Display the generation plan (for debugging)
+        const plan = generationCoordinator.getGenerationPlan();
+        console.log(`  📋 Generation plan: ${plan.totalOutputs} outputs, ${plan.phases.filter((p) => p.enabled).length} active phases`);
+        // Run all generations
+        const result = await generationCoordinator.generateAll(enrichedComponents, apiData);
+        return result;
+    }
+    /**
+     * Create error result for failed pipeline execution
+     */
+    createErrorResult(error) {
+        const duration = Date.now() - this.startTime;
+        return {
+            success: false,
+            outputs: [],
+            errors: [
+                {
+                    type: 'pipeline_error',
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            ],
+            stats: {
+                totalComponents: 0,
+                totalProps: 0,
+                apiDataSize: 0
+            },
+            duration
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update configuration (useful for watch mode)
+     */
+    updateConfig(newConfig) {
+        this.config = newConfig;
+    }
+}
+//# sourceMappingURL=PipelineOrchestrator.js.map

package/dist/core/pipeline/PipelineOrchestrator.js.map

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

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

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/index.ts"],"names":[],"mappings":""}

package/dist/core/pipeline/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/pipeline/index.ts"],"names":[],"mappings":""}

package/dist/extractors/BaseExtractor.d.ts

@@ -0,0 +1,33 @@
+import type { ExtractionResult, ExtractionWarning } from '../types';
+/**
+ * Generic base class for all extractors (TypeScript and non-TypeScript)
+ */
+export declare abstract class BaseExtractor<TInput = unknown, TOutput = unknown> {
+    protected config: unknown;
+    constructor(config?: unknown);
+    /**
+     * Main extraction method - must be implemented by subclasses
+     */
+    abstract extract(input: TInput): Promise<ExtractionResult<TOutput>>;
+    /**
+     * Validate input before extraction - can be overridden
+     */
+    protected validateInput(input: TInput): boolean;
+    /**
+     * Handle extraction errors - can be overridden for custom error handling
+     */
+    protected handleError(error: unknown, context?: unknown): ExtractionResult<TOutput>;
+    /**
+     * Create a successful extraction result
+     */
+    protected createSuccessResult(data: TOutput, warnings?: ExtractionWarning[], sourceFile?: string, duration?: number): ExtractionResult<TOutput>;
+    /**
+     * Add warning to extraction result
+     */
+    protected addWarning(type: string, message: string, suggestion?: string): ExtractionWarning;
+    /**
+     * Clear any caches (useful for watch mode)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=BaseExtractor.d.ts.map