@tachui/cli 0.8.0-alpha → 0.8.5-alpha

package/dist/devtools/src/profiler/production-monitoring.js

@@ -0,0 +1,274 @@
+/**
+ * Production Mode Monitoring and Analysis
+ *
+ * Development tools for monitoring production optimization effectiveness,
+ * performance tracking, and bundle analysis.
+ *
+ * Moved from @tachui/core for proper separation of dev vs production concerns.
+ */
+/**
+ * Production monitoring and analysis
+ */
+export class ProductionMonitor {
+    static instance;
+    bypassCount = 0;
+    performanceGain = 0;
+    validationTimes = [];
+    slowValidations = [];
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new ProductionMonitor();
+        }
+        return this.instance;
+    }
+    /**
+     * Record a validation bypass for performance tracking
+     */
+    recordBypass(timesSaved) {
+        this.bypassCount++;
+        this.performanceGain += timesSaved;
+    }
+    /**
+     * Record validation performance
+     */
+    recordValidationTime(componentType, duration) {
+        this.validationTimes.push(duration);
+        if (duration > 5) {
+            // More than 5ms is concerning
+            this.slowValidations.push({ component: componentType, time: duration });
+            console.warn(`⚠️ Validation overhead: ${duration.toFixed(2)}ms for ${componentType}`);
+        }
+        // Keep only recent measurements
+        if (this.validationTimes.length > 100) {
+            this.validationTimes = this.validationTimes.slice(-50);
+        }
+        if (this.slowValidations.length > 20) {
+            this.slowValidations = this.slowValidations.slice(-10);
+        }
+    }
+    /**
+     * Get performance statistics
+     */
+    getStats() {
+        const averageOverhead = this.validationTimes.length > 0
+            ? this.validationTimes.reduce((sum, time) => sum + time, 0) /
+                this.validationTimes.length
+            : 0;
+        return {
+            bypassCount: this.bypassCount,
+            performanceGain: this.performanceGain,
+            averageOverhead,
+            slowValidations: [...this.slowValidations],
+        };
+    }
+    /**
+     * Reset monitoring statistics
+     */
+    reset() {
+        this.bypassCount = 0;
+        this.performanceGain = 0;
+        this.validationTimes = [];
+        this.slowValidations = [];
+    }
+    /**
+     * Generate optimization recommendations
+     */
+    getRecommendations() {
+        const recommendations = [];
+        const stats = this.getStats();
+        if (stats.averageOverhead > 3) {
+            recommendations.push('Consider reducing validation complexity - average overhead is high');
+        }
+        if (stats.slowValidations.length > 5) {
+            recommendations.push('Multiple slow validation operations detected - review component validators');
+        }
+        if (stats.bypassCount === 0 && process.env.NODE_ENV === 'production') {
+            recommendations.push('Validation bypass not working - check production build configuration');
+        }
+        return recommendations;
+    }
+}
+/**
+ * Bundle size analysis
+ */
+export class BundleAnalysis {
+    /**
+     * Estimate validation code size in bundle
+     */
+    static getValidationCodeSize() {
+        // This is a rough estimate - in practice this would be more sophisticated
+        if (process.env.NODE_ENV === 'production') {
+            return 0; // Should be tree-shaken in production
+        }
+        // Rough estimate of validation code size in development
+        return 15000; // ~15KB estimated validation code size
+    }
+    /**
+     * Generate optimization report
+     */
+    static getOptimizationReport() {
+        const monitor = ProductionMonitor.getInstance();
+        const stats = monitor.getStats();
+        const codeSize = this.getValidationCodeSize();
+        return {
+            validationCodeSize: codeSize,
+            performanceGain: stats.performanceGain,
+            optimization: codeSize === 0 ? 'Fully optimized (tree-shaken)' : 'Development mode',
+            recommendations: monitor.getRecommendations(),
+        };
+    }
+}
+/**
+ * Development-only assertion macro with detailed reporting
+ */
+export function devAssert(condition, message, context) {
+    if (typeof window !== 'undefined' && window.__TACHUI_DEV_MODE__) {
+        if (!condition) {
+            console.error('TachUI Dev Assertion Failed:', message, context);
+            if (context) {
+                console.trace('Assertion context:', context);
+            }
+            throw new Error(`TachUI Dev Assertion: ${message}`);
+        }
+    }
+}
+/**
+ * Development-only warning macro with enhanced reporting
+ */
+export function devWarn(condition, message, context) {
+    if (typeof window !== 'undefined' && window.__TACHUI_DEV_MODE__) {
+        if (!condition) {
+            console.warn(`TachUI Dev Warning: ${message}`, context);
+            if (context) {
+                console.trace('Warning context:', context);
+            }
+        }
+    }
+}
+/**
+ * Enhanced performance monitoring wrapper
+ */
+export function withPerformanceMonitoring(fn, name, options = {}) {
+    const { threshold = 10, logSlow = true, trackStats = true } = options;
+    return function monitoredFunction(...args) {
+        const start = performance.now();
+        const result = fn(...args);
+        const end = performance.now();
+        const duration = end - start;
+        if (trackStats) {
+            ProductionMonitor.getInstance().recordValidationTime(name, duration);
+        }
+        if (logSlow && duration > threshold) {
+            console.info(`⏱️ ${name}: ${duration.toFixed(2)}ms`);
+        }
+        return result;
+    };
+}
+/**
+ * Component validation wrapper with performance monitoring
+ */
+export function withMonitoredValidation(originalConstructor, componentType, validator) {
+    return function monitoredComponent(...args) {
+        const startTime = performance.now();
+        // Run validation with monitoring
+        if (validator) {
+            try {
+                validator(args);
+            }
+            catch (error) {
+                console.error(`Validation failed for ${componentType}:`, error);
+                throw error;
+            }
+        }
+        const result = originalConstructor.apply(this, args);
+        const endTime = performance.now();
+        // Record performance
+        const duration = endTime - startTime;
+        ProductionMonitor.getInstance().recordValidationTime(componentType, duration);
+        return result;
+    };
+}
+/**
+ * Development build constants (for tree-shaking)
+ */
+export const DevConstants = {
+    __DEVELOPMENT_ONLY__: process.env.NODE_ENV !== 'production',
+    __TACHUI_VERSION__: '0.1.0',
+    // Define globals for bundlers to replace
+    defineGlobals: {
+        __TACHUI_PRODUCTION_MODE__: process.env.NODE_ENV === 'production',
+        __TACHUI_DEBUG_INFO__: process.env.NODE_ENV !== 'production',
+    },
+};
+/**
+ * Production optimization utilities with monitoring
+ */
+export const ProductionOptimizationUtils = {
+    /**
+     * Get detailed performance statistics
+     */
+    getDetailedStats: () => {
+        const monitor = ProductionMonitor.getInstance();
+        return {
+            ...monitor.getStats(),
+            recommendations: monitor.getRecommendations(),
+            bundleReport: BundleAnalysis.getOptimizationReport(),
+        };
+    },
+    /**
+     * Reset monitoring data
+     */
+    resetStats: () => ProductionMonitor.getInstance().reset(),
+    /**
+     * Get bundle optimization report
+     */
+    getBundleReport: BundleAnalysis.getOptimizationReport,
+    /**
+     * Test production optimization with detailed reporting
+     */
+    test() {
+        console.group('🚀 Production Optimization Analysis');
+        const stats = ProductionMonitor.getInstance().getStats();
+        const report = BundleAnalysis.getOptimizationReport();
+        console.info('📊 Performance Statistics:');
+        console.info('  • Validation bypasses:', stats.bypassCount);
+        console.info('  • Performance gain:', `${stats.performanceGain.toFixed(2)}ms`);
+        console.info('  • Average overhead:', `${stats.averageOverhead.toFixed(2)}ms`);
+        console.info('  • Slow validations:', stats.slowValidations.length);
+        console.info('📦 Bundle Optimization:');
+        console.info('  • Bundle status:', report.optimization);
+        console.info('  • Validation code size:', report.validationCodeSize === 0
+            ? 'Tree-shaken ✅'
+            : `${report.validationCodeSize} bytes`);
+        if (report.recommendations.length > 0) {
+            console.info('💡 Optimization Recommendations:');
+            report.recommendations.forEach(rec => console.info(`   • ${rec}`));
+        }
+        else {
+            console.info('✅ No optimization recommendations - system is running efficiently');
+        }
+        if (stats.slowValidations.length > 0) {
+            console.info('⚠️ Slow Validations:');
+            stats.slowValidations.forEach(slow => console.info(`   • ${slow.component}: ${slow.time.toFixed(2)}ms`));
+        }
+        console.groupEnd();
+    },
+    /**
+     * Start continuous monitoring
+     */
+    startMonitoring(intervalMs = 30000) {
+        const monitor = ProductionMonitor.getInstance();
+        const interval = setInterval(() => {
+            const stats = monitor.getStats();
+            if (stats.slowValidations.length > 0) {
+                console.warn('⚠️ TachUI Performance Alert: Slow validation operations detected');
+            }
+        }, intervalMs);
+        console.info('🔍 TachUI production monitoring started');
+        return () => {
+            clearInterval(interval);
+            console.info('🔍 TachUI production monitoring stopped');
+        };
+    },
+};
+//# sourceMappingURL=production-monitoring.js.map

package/dist/devtools/src/profiler/production-monitoring.js.map

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

package/dist/devtools/src/runtime/error-boundary.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Error Boundary and Error Handling System (Phase 3.2.3)
+ *
+ * Comprehensive error handling system for TachUI applications.
+ * Provides error boundaries, recovery mechanisms, and error reporting.
+ */
+import type { ComponentInstance, ComponentProps, DOMNode } from '@tachui/core';
+/**
+ * Error severity levels
+ */
+export type ErrorSeverity = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Error categories for classification
+ */
+export type ErrorCategory = 'component_error' | 'reactive_error' | 'render_error' | 'lifecycle_error' | 'network_error' | 'validation_error' | 'unknown_error';
+/**
+ * Comprehensive error information
+ */
+export interface TachUIError {
+    id: string;
+    message: string;
+    stack?: string;
+    cause?: Error;
+    timestamp: number;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    componentId?: string;
+    componentName?: string;
+    phase?: string;
+    context?: Record<string, any>;
+    userAgent?: string;
+    url?: string;
+    retryCount: number;
+    recovered: boolean;
+}
+/**
+ * Error boundary state
+ */
+export interface ErrorBoundaryState {
+    hasError: boolean;
+    error: TachUIError | null;
+    errorInfo: {
+        componentStack?: string;
+        errorBoundary?: string;
+        retryAttempts: number;
+    };
+}
+/**
+ * Error recovery strategies
+ */
+export type ErrorRecoveryStrategy = 'retry' | 'fallback' | 'reload' | 'redirect' | 'ignore' | 'escalate';
+/**
+ * Error recovery configuration
+ */
+export interface ErrorRecoveryConfig {
+    strategy: ErrorRecoveryStrategy;
+    maxRetries?: number;
+    retryDelay?: number;
+    fallbackComponent?: ComponentInstance;
+    onRecovery?: (error: TachUIError) => void;
+    condition?: (error: TachUIError) => boolean;
+}
+/**
+ * Error boundary props
+ */
+export interface ErrorBoundaryProps extends ComponentProps {
+    fallback?: ComponentInstance | ((error: TachUIError, retry: () => void) => ComponentInstance);
+    onError?: (error: TachUIError, errorInfo: ErrorBoundaryState['errorInfo']) => void;
+    recovery?: ErrorRecoveryConfig[];
+    isolate?: boolean;
+    resetOnPropsChange?: boolean;
+    resetKeys?: string[];
+}
+/**
+ * Error reporter interface
+ */
+export interface ErrorReporter {
+    report(error: TachUIError): void | Promise<void>;
+}
+/**
+ * Error handler function type
+ */
+export type ErrorHandler = (error: TachUIError) => void | Promise<void>;
+/**
+ * Global error handling configuration
+ */
+export interface ErrorHandlingConfig {
+    enabled: boolean;
+    captureConsoleErrors: boolean;
+    captureUnhandledPromises: boolean;
+    captureReactiveErrors: boolean;
+    captureComponentErrors: boolean;
+    maxErrorsPerSession: number;
+    maxErrorAge: number;
+    reportingThrottle: number;
+    enableStackTrace: boolean;
+    enableSourceMap: boolean;
+    development: boolean;
+}
+/**
+ * Error boundary component implementation
+ */
+export declare class ErrorBoundary {
+    private state;
+    private props;
+    private children;
+    private errorManager;
+    private stateSignal;
+    private setState;
+    constructor(props: ErrorBoundaryProps, children: ComponentInstance[], errorManager: ErrorManager);
+    /**
+     * Catch and handle errors in child components
+     */
+    componentDidCatch(error: Error, errorInfo: any): void;
+    /**
+     * Handle error and determine recovery strategy
+     */
+    private handleError;
+    /**
+     * Attempt error recovery based on configured strategies
+     */
+    private attemptRecovery;
+    /**
+     * Retry failed operation with configuration
+     */
+    private retryWithConfig;
+    /**
+     * Retry the failed operation
+     */
+    retry(): void;
+    /**
+     * Reset error boundary to normal state
+     */
+    resetErrorBoundary(): void;
+    /**
+     * Reload the component
+     */
+    private reloadComponent;
+    /**
+     * Setup props watcher for error boundary reset
+     */
+    private setupPropsWatcher;
+    /**
+     * Check if error boundary should reset based on props
+     */
+    private shouldResetOnProps;
+    /**
+     * Render error boundary content
+     */
+    render(): DOMNode[];
+    /**
+     * Render default error UI
+     */
+    private renderDefaultErrorUI;
+    /**
+     * Get current error boundary state
+     */
+    getState(): ErrorBoundaryState;
+    /**
+     * Get reactive state signal
+     */
+    getStateSignal(): () => ErrorBoundaryState;
+}
+/**
+ * Global error manager
+ */
+export declare class ErrorManager {
+    private static instance;
+    private config;
+    private errors;
+    private reporters;
+    private handlers;
+    private throttleMap;
+    private errorsSignal;
+    private setErrors;
+    constructor();
+    static getInstance(): ErrorManager;
+    /**
+     * Configure error handling
+     */
+    configure(config: Partial<ErrorHandlingConfig>): void;
+    /**
+     * Setup global error handlers
+     */
+    private setupGlobalErrorHandlers;
+    /**
+     * Create standardized TachUI error
+     */
+    createTachUIError(error: Error, options?: {
+        category?: ErrorCategory;
+        severity?: ErrorSeverity;
+        componentId?: string;
+        componentName?: string;
+        phase?: string;
+        context?: Record<string, any>;
+    }): TachUIError;
+    /**
+     * Report error to all registered reporters
+     */
+    reportError(error: TachUIError): void;
+    /**
+     * Clean old errors based on max age
+     */
+    private cleanOldErrors;
+    /**
+     * Add error reporter
+     */
+    addReporter(reporter: ErrorReporter): () => void;
+    /**
+     * Add error handler
+     */
+    addHandler(handler: ErrorHandler): () => void;
+    /**
+     * Get all errors
+     */
+    getErrors(): TachUIError[];
+    /**
+     * Get errors signal
+     */
+    getErrorsSignal(): () => TachUIError[];
+    /**
+     * Get errors by category
+     */
+    getErrorsByCategory(category: ErrorCategory): TachUIError[];
+    /**
+     * Get errors by severity
+     */
+    getErrorsBySeverity(severity: ErrorSeverity): TachUIError[];
+    /**
+     * Get errors by component
+     */
+    getErrorsByComponent(componentId: string): TachUIError[];
+    /**
+     * Mark error as recovered
+     */
+    markErrorRecovered(errorId: string): void;
+    /**
+     * Clear all errors
+     */
+    clear(): void;
+    /**
+     * Get error statistics
+     */
+    getStatistics(): {
+        totalErrors: number;
+        errorsByCategory: Record<ErrorCategory, number>;
+        errorsBySeverity: Record<ErrorSeverity, number>;
+        recoveredErrors: number;
+        recentErrors: number;
+    };
+}
+/**
+ * Global error manager instance
+ */
+export declare const globalErrorManager: ErrorManager;
+/**
+ * Create error boundary component
+ */
+export declare function createErrorBoundary(props: ErrorBoundaryProps, children: ComponentInstance[]): ErrorBoundary;
+/**
+ * Built-in error reporters
+ */
+export declare const errorReporters: {
+    /**
+     * Console reporter
+     */
+    console: ErrorReporter;
+    /**
+     * Local storage reporter
+     */
+    localStorage: ErrorReporter;
+    /**
+     * Remote API reporter
+     */
+    createRemoteReporter(endpoint: string, apiKey?: string): ErrorReporter;
+};
+/**
+ * Error handling utilities
+ */
+export declare const errorUtils: {
+    /**
+     * Wrap function with error handling
+     */
+    withErrorHandling<T extends (...args: any[]) => any>(fn: T, options?: {
+        category?: ErrorCategory;
+        onError?: (error: TachUIError) => void;
+        fallback?: ReturnType<T>;
+    }): T;
+    /**
+     * Wrap async function with error handling
+     */
+    withAsyncErrorHandling<T extends (...args: any[]) => Promise<any>>(fn: T, options?: {
+        category?: ErrorCategory;
+        onError?: (error: TachUIError) => void;
+        fallback?: Awaited<ReturnType<T>>;
+    }): T;
+    /**
+     * Create error boundary with common configurations
+     */
+    createSimpleErrorBoundary(fallbackMessage?: string): (children: ComponentInstance[]) => ErrorBoundary;
+};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/devtools/src/runtime/error-boundary.d.ts.map

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