@tachui/core 0.7.0-alpha1

package/dist/validation/advanced-debugging.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Advanced Developer Debugging Tools - Phase 1D
+ *
+ * Enhanced validation state inspection, visual debugging tools,
+ * and comprehensive developer diagnostics.
+ */
+import type { ValidationDebugEventType, DebugEvent } from './debug-tools';
+import type { FormattedErrorMessage } from './developer-experience';
+/**
+ * Advanced debugging configuration
+ */
+export interface AdvancedDebuggingConfig {
+    enableVisualDebugging: boolean;
+    highlightValidationErrors: boolean;
+    showComponentBoundaries: boolean;
+    showModifierEffects: boolean;
+    enableStateInspection: boolean;
+    trackStateChanges: boolean;
+    showStateHistory: boolean;
+    maxHistorySize: number;
+    enablePerformanceDebugging: boolean;
+    trackRenderTimes: boolean;
+    showMemoryUsage: boolean;
+    enableFrameProfiler: boolean;
+    enableInteractiveMode: boolean;
+    showDebugPanel: boolean;
+    enableBreakpoints: boolean;
+    enableStepThrough: boolean;
+    enableDebugExport: boolean;
+    exportFormat: 'json' | 'csv' | 'html';
+    includeSourceMaps: boolean;
+}
+/**
+ * Component state snapshot for debugging
+ */
+export interface ComponentStateSnapshot {
+    id: string;
+    componentType: string;
+    timestamp: number;
+    props: Record<string, any>;
+    state: Record<string, any>;
+    modifiers: string[];
+    validationErrors: FormattedErrorMessage[];
+    validationWarnings: FormattedErrorMessage[];
+    isValid: boolean;
+    renderTime: number;
+    memoryUsage: number;
+    updateCount: number;
+    domNode?: {
+        tagName: string;
+        className: string;
+        attributes: Record<string, string>;
+        computedStyles: Record<string, string>;
+    };
+    parent?: string;
+    children: string[];
+}
+/**
+ * Validation state inspector
+ */
+export interface ValidationStateInspector {
+    id: string;
+    target: 'component' | 'modifier' | 'global';
+    targetId?: string;
+    watchProperties: string[];
+    watchEvents: ValidationDebugEventType[];
+    snapshots: ComponentStateSnapshot[];
+    events: DebugEvent[];
+    trends: {
+        errorFrequency: number;
+        performanceRegression: boolean;
+        memoryLeaks: boolean;
+        stateInconsistencies: boolean;
+    };
+    isActive: boolean;
+    startTime: number;
+    lastUpdate: number;
+}
+/**
+ * Visual debugging overlay
+ */
+export interface VisualDebuggingOverlay {
+    id: string;
+    type: 'error-highlight' | 'component-boundary' | 'modifier-effect' | 'performance-heatmap';
+    color: string;
+    opacity: number;
+    strokeWidth: number;
+    animation?: 'pulse' | 'fade' | 'shake';
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    label?: string;
+    tooltip?: string;
+    additionalInfo?: Record<string, any>;
+    duration: number;
+    createdAt: number;
+    expiresAt: number;
+}
+/**
+ * Advanced debugging session
+ */
+export interface AdvancedDebuggingSession {
+    id: string;
+    name: string;
+    description: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    components: Map<string, ComponentStateSnapshot[]>;
+    validators: ValidationStateInspector[];
+    overlays: VisualDebuggingOverlay[];
+    events: DebugEvent[];
+    summary: {
+        totalErrors: number;
+        totalWarnings: number;
+        criticalIssues: string[];
+        performanceIssues: string[];
+        recommendations: string[];
+    };
+    exported: boolean;
+    exportFormat?: string;
+    exportPath?: string;
+}
+/**
+ * Advanced validation state inspector
+ */
+export declare class AdvancedValidationInspector {
+    private inspectors;
+    private snapshots;
+    private overlays;
+    private activeSession;
+    /**
+     * Create a new state inspector
+     */
+    createInspector(target: 'component' | 'modifier' | 'global', targetId?: string, options?: {
+        watchProperties?: string[];
+        watchEvents?: ValidationDebugEventType[];
+    }): string;
+    /**
+     * Take a component state snapshot
+     */
+    takeSnapshot(componentId: string, componentData: {
+        type: string;
+        props: Record<string, any>;
+        state: Record<string, any>;
+        modifiers: string[];
+        domElement?: HTMLElement;
+    }): string;
+    /**
+     * Add visual debugging overlay
+     */
+    addVisualOverlay(type: VisualDebuggingOverlay['type'], bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, options?: {
+        color?: string;
+        label?: string;
+        tooltip?: string;
+        duration?: number;
+        animation?: VisualDebuggingOverlay['animation'];
+    }): string;
+    /**
+     * Start advanced debugging session
+     */
+    startSession(name: string, description?: string): string;
+    /**
+     * Stop debugging session and generate report
+     */
+    stopSession(): AdvancedDebuggingSession | null;
+    /**
+     * Get component state history
+     */
+    getComponentHistory(componentId: string): ComponentStateSnapshot[];
+    /**
+     * Get validation trends analysis
+     */
+    getValidationTrends(componentId?: string): {
+        errorRate: number;
+        warningRate: number;
+        performanceRegression: boolean;
+        memoryTrend: 'increasing' | 'stable' | 'decreasing';
+        recommendations: string[];
+    };
+    /**
+     * Export debugging session data
+     */
+    exportSessionData(session: AdvancedDebuggingSession, format?: 'json' | 'csv' | 'html'): string;
+    /**
+     * Extract DOM information from element
+     */
+    private extractDOMInfo;
+    /**
+     * Get computed styles for an element
+     */
+    private getComputedStyles;
+    /**
+     * Get current memory usage
+     */
+    private getMemoryUsage;
+    /**
+     * Get default color for overlay type
+     */
+    private getDefaultColor;
+    /**
+     * Update active inspectors with new snapshot
+     */
+    private updateInspectors;
+    /**
+     * Update inspector trends analysis
+     */
+    private updateInspectorTrends;
+    /**
+     * Analyze debugging session
+     */
+    private analyzeSession;
+    /**
+     * Export session as JSON
+     */
+    private exportAsJSON;
+    /**
+     * Export session as CSV
+     */
+    private exportAsCSV;
+    /**
+     * Export session as HTML report
+     */
+    private exportAsHTML;
+    /**
+     * Get inspector statistics
+     */
+    getStatistics(): {
+        activeInspectors: number;
+        totalSnapshots: number;
+        activeOverlays: number;
+        sessionActive: boolean;
+        memoryUsage: number;
+    };
+}
+/**
+ * Configure advanced debugging
+ */
+export declare function configureAdvancedDebugging(config: Partial<AdvancedDebuggingConfig>): void;
+/**
+ * Get current advanced debugging configuration
+ */
+export declare function getAdvancedDebuggingConfig(): AdvancedDebuggingConfig;
+declare const advancedInspector: AdvancedValidationInspector;
+/**
+ * Advanced Debugging utilities
+ */
+export declare const AdvancedDebuggingUtils: {
+    /**
+     * Create new inspector
+     */
+    createInspector: (target: "component" | "modifier" | "global", targetId?: string, options?: any) => string;
+    /**
+     * Take component snapshot
+     */
+    takeSnapshot: (componentId: string, componentData: any) => string;
+    /**
+     * Add visual overlay
+     */
+    addVisualOverlay: (type: VisualDebuggingOverlay["type"], bounds: any, options?: any) => string;
+    /**
+     * Start debugging session
+     */
+    startSession: (name: string, description?: string) => string;
+    /**
+     * Stop debugging session
+     */
+    stopSession: () => AdvancedDebuggingSession | null;
+    /**
+     * Get component history
+     */
+    getComponentHistory: (componentId: string) => ComponentStateSnapshot[];
+    /**
+     * Get validation trends
+     */
+    getValidationTrends: (componentId?: string) => {
+        errorRate: number;
+        warningRate: number;
+        performanceRegression: boolean;
+        memoryTrend: "increasing" | "stable" | "decreasing";
+        recommendations: string[];
+    };
+    /**
+     * Export session data
+     */
+    exportSessionData: (session: AdvancedDebuggingSession, format?: "json" | "csv" | "html") => string;
+    /**
+     * Configure debugging
+     */
+    configure: typeof configureAdvancedDebugging;
+    /**
+     * Get configuration
+     */
+    getConfig: typeof getAdvancedDebuggingConfig;
+    /**
+     * Get statistics
+     */
+    getStatistics: () => {
+        activeInspectors: number;
+        totalSnapshots: number;
+        activeOverlays: number;
+        sessionActive: boolean;
+        memoryUsage: number;
+    };
+    /**
+     * Test advanced debugging system
+     */
+    test: () => void;
+};
+export { advancedInspector };
+//# sourceMappingURL=advanced-debugging.d.ts.map

package/dist/validation/advanced-debugging.d.ts.map

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