@tachui/core 0.7.0-alpha1

package/dist/validation/enhanced-runtime.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Enhanced Runtime Validation System - Phase 1C
+ *
+ * Smart error recovery, performance optimization, enhanced error reporting,
+ * and component lifecycle validation for production-ready validation.
+ */
+import type { ComponentInstance } from '../runtime/types';
+import { TachUIValidationError, type ValidationConfig } from './comprehensive';
+/**
+ * Recovery strategy for validation errors
+ */
+export type RecoveryStrategy = 'ignore' | 'fallback' | 'fix' | 'throw';
+/**
+ * Enhanced validation error with recovery options
+ */
+export declare class EnhancedValidationError extends TachUIValidationError {
+    context: {
+        component: string;
+        property?: string;
+        suggestion?: string;
+        documentation?: string;
+        example?: {
+            wrong: string;
+            correct: string;
+        };
+        package?: string;
+        recoveryStrategy?: RecoveryStrategy;
+        fallbackValue?: any;
+        autoFix?: () => any;
+    };
+    constructor(message: string, context: {
+        component: string;
+        property?: string;
+        suggestion?: string;
+        documentation?: string;
+        example?: {
+            wrong: string;
+            correct: string;
+        };
+        package?: string;
+        recoveryStrategy?: RecoveryStrategy;
+        fallbackValue?: any;
+        autoFix?: () => any;
+    });
+    /**
+     * Get recovery strategy with proper typing
+     */
+    private getRecoveryStrategyFromContext;
+    /**
+     * Get fallback value with proper typing
+     */
+    private getFallbackValueFromContext;
+    /**
+     * Get auto fix with proper typing
+     */
+    private getAutoFixFromContext;
+    /**
+     * Get suggested recovery action
+     */
+    getRecoveryStrategy(): RecoveryStrategy;
+    /**
+     * Get fallback value for graceful degradation
+     */
+    getFallbackValue(): any;
+    /**
+     * Apply automatic fix if available
+     */
+    applyAutoFix(): any;
+    /**
+     * Enhanced formatted message with recovery options
+     */
+    getFormattedMessage(): string;
+}
+/**
+ * Enhanced validation configuration
+ */
+export interface EnhancedValidationConfig extends ValidationConfig {
+    performance: {
+        enableCaching: boolean;
+        maxCacheSize: number;
+        performanceThreshold: number;
+    };
+    recovery: {
+        enableRecovery: boolean;
+        defaultStrategy: RecoveryStrategy;
+        maxRecoveryAttempts: number;
+    };
+    lifecycle: {
+        validateOnMount: boolean;
+        validateOnUpdate: boolean;
+        validateOnUnmount: boolean;
+    };
+    reporting: {
+        enhancedMessages: boolean;
+        includeStackTrace: boolean;
+        reportToConsole: boolean;
+        reportToExternal?: (error: EnhancedValidationError) => void;
+    };
+}
+/**
+ * Global enhanced validation configuration
+ */
+declare let enhancedConfig: EnhancedValidationConfig;
+/**
+ * Validation cache for performance optimization
+ */
+declare class ValidationCache {
+    private cache;
+    private maxSize;
+    private ttl;
+    constructor(maxSize?: number);
+    get(key: string): boolean | null;
+    set(key: string, result: boolean): void;
+    clear(): void;
+    getSize(): number;
+}
+/**
+ * Performance monitor for validation overhead
+ */
+declare class ValidationPerformanceMonitor {
+    private measurements;
+    private maxMeasurements;
+    startMeasurement(): () => void;
+    private recordMeasurement;
+    getAverageTime(): number;
+    isPerformanceAcceptable(): boolean;
+    getStats(): {
+        averageTime: number;
+        measurements: number;
+        acceptable: boolean;
+        threshold: number;
+    };
+    reset(): void;
+}
+declare const validationCache: ValidationCache;
+declare const performanceMonitor: ValidationPerformanceMonitor;
+/**
+ * Configure enhanced validation
+ */
+export declare function configureEnhancedValidation(config: Partial<EnhancedValidationConfig>): void;
+/**
+ * Check if enhanced validation is enabled
+ */
+export declare function isEnhancedValidationEnabled(): boolean;
+/**
+ * Smart validation executor with error recovery
+ */
+export declare class SmartValidationExecutor {
+    private recoveryAttempts;
+    /**
+     * Execute validation with recovery options
+     */
+    executeWithRecovery<T>(validationKey: string, validator: () => T, recoveryOptions?: {
+        strategy?: RecoveryStrategy;
+        fallbackValue?: T;
+        autoFix?: () => T;
+    }): T;
+    /**
+     * Handle validation error with recovery
+     */
+    private handleValidationError;
+    /**
+     * Report validation error
+     */
+    private reportError;
+    /**
+     * Reset recovery attempts
+     */
+    resetRecoveryAttempts(): void;
+    /**
+     * Get recovery stats
+     */
+    getRecoveryStats(): {
+        totalAttempts: number;
+        keysWithAttempts: number;
+        attempts: {
+            [k: string]: number;
+        };
+    };
+}
+declare const smartValidator: SmartValidationExecutor;
+/**
+ * Component lifecycle validator
+ */
+export declare class ComponentLifecycleValidator {
+    private mountedComponents;
+    private componentStates;
+    /**
+     * Validate component on mount
+     */
+    validateOnMount(component: ComponentInstance, props: any): void;
+    /**
+     * Validate component on update
+     */
+    validateOnUpdate(component: ComponentInstance, newProps: any, oldProps: any): void;
+    /**
+     * Validate component on unmount
+     */
+    validateOnUnmount(component: ComponentInstance): void;
+    /**
+     * Get lifecycle validation stats
+     */
+    getStats(): {
+        mountedComponents: number;
+        enabled: {
+            validateOnMount: boolean;
+            validateOnUpdate: boolean;
+            validateOnUnmount: boolean;
+        };
+        config: {
+            validateOnMount: boolean;
+            validateOnUpdate: boolean;
+            validateOnUnmount: boolean;
+        };
+    };
+}
+declare const lifecycleValidator: ComponentLifecycleValidator;
+/**
+ * Enhanced validation utilities
+ */
+export declare const EnhancedValidationUtils: {
+    /**
+     * Configure enhanced validation
+     */
+    configure: typeof configureEnhancedValidation;
+    /**
+     * Get performance statistics
+     */
+    getPerformanceStats(): {
+        monitor: {
+            averageTime: number;
+            measurements: number;
+            acceptable: boolean;
+            threshold: number;
+        };
+        cache: {
+            size: number;
+            maxSize: number;
+        };
+        recovery: {
+            totalAttempts: number;
+            keysWithAttempts: number;
+            attempts: {
+                [k: string]: number;
+            };
+        };
+        lifecycle: {
+            mountedComponents: number;
+            enabled: {
+                validateOnMount: boolean;
+                validateOnUpdate: boolean;
+                validateOnUnmount: boolean;
+            };
+            config: {
+                validateOnMount: boolean;
+                validateOnUpdate: boolean;
+                validateOnUnmount: boolean;
+            };
+        };
+    };
+    /**
+     * Reset all caches and stats
+     */
+    reset(): void;
+    /**
+     * Test enhanced validation system
+     */
+    test(): void;
+    /**
+     * Enable production bypass mode
+     */
+    enableProductionBypass(): void;
+    /**
+     * Create validated component with enhanced features
+     */
+    createEnhancedValidatedComponent<T extends ComponentInstance>(originalConstructor: (...args: any[]) => T, validator: (args: unknown[]) => void, componentType: string, packageName?: string): (...args: any[]) => T;
+};
+export { smartValidator, lifecycleValidator, validationCache, performanceMonitor, enhancedConfig };
+//# sourceMappingURL=enhanced-runtime.d.ts.map

package/dist/validation/enhanced-runtime.d.ts.map

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