@tachui/core 0.7.0-alpha1

package/dist/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 './types';
+/**
+ * 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/runtime/error-boundary.d.ts.map

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