@tachui/devtools 0.8.0-alpha

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

@@ -0,0 +1,327 @@
+/**
+ * Advanced Developer Debugging Tools - Phase 1D
+ *
+ * Enhanced validation state inspection, visual debugging tools,
+ * and comprehensive developer diagnostics.
+ */
+import type { FormattedErrorMessage } from './enhanced-errors';
+export type ValidationDebugEventType = 'validation-start' | 'validation-complete' | 'validation-error' | 'validation-warning' | 'validation-end' | 'component-validation' | 'modifier-validation';
+export interface DebugEvent {
+    type: string;
+    timestamp: number;
+    componentId?: string;
+    componentName?: string;
+    data: any;
+    stack?: string;
+}
+/**
+ * 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/debug/advanced-debugging.d.ts.map

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

package/dist/debug/debug.d.ts

@@ -0,0 +1,61 @@
+/**
+ * TachUI Debug System
+ *
+ * Provides visual debugging tools for component hierarchy and layout
+ */
+export interface DebugConfig {
+    enabled: boolean;
+    showLabels: boolean;
+    showBounds: boolean;
+    logComponentTree: boolean;
+}
+declare class DebugManager {
+    private config;
+    private componentTree;
+    /**
+     * Enable debug mode with optional configuration
+     */
+    enable(options?: Partial<DebugConfig>): void;
+    /**
+     * Disable debug mode
+     */
+    disable(): void;
+    /**
+     * Check if debug mode is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Get current debug configuration
+     */
+    getConfig(): DebugConfig;
+    /**
+     * Add debug attributes to DOM element
+     */
+    addDebugAttributes(element: HTMLElement, componentType: string, debugLabel?: string): void;
+    /**
+     * Log component to tree (for hierarchical debugging)
+     */
+    logComponent(type: string, label?: string, depth?: number): void;
+    /**
+     * Print component tree to console
+     */
+    printComponentTree(): void;
+    /**
+     * Get icon for component type
+     */
+    private getComponentIcon;
+    /**
+     * Inject debug CSS styles
+     */
+    private injectDebugStyles;
+    /**
+     * Remove debug CSS styles
+     */
+    private removeDebugStyles;
+}
+export declare const debugManager: DebugManager;
+export declare const enableDebug: (options?: Partial<DebugConfig>) => void;
+export declare const disableDebug: () => void;
+export declare const isDebugEnabled: () => boolean;
+export {};
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug/debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAKb;IAED,OAAO,CAAC,aAAa,CACjB;IAEJ;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,IAAI;IAkBhD;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,kBAAkB,CAChB,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAsBP;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAUnE;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAe1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6DzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAe1B;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAA;AAG9C,eAAO,MAAM,WAAW,GAAI,UAAU,OAAO,CAAC,WAAW,CAAC,SAC5B,CAAA;AAC9B,eAAO,MAAM,YAAY,YAA+B,CAAA;AACxD,eAAO,MAAM,cAAc,eAAiC,CAAA"}

package/dist/debug/developer-experience.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Developer Experience Integration - Phase 1D
+ *
+ * Enhanced error message templates, intelligent fix suggestions,
+ * and comprehensive developer guidance system.
+ */
+export type ValidationErrorCategory = 'component' | 'modifier' | 'runtime' | 'reactive' | 'validation' | 'component-construction' | 'modifier-usage' | 'performance';
+export type ValidationErrorSeverity = 'error' | 'warning' | 'info' | 'critical';
+export interface EnhancedValidationError {
+    message: string;
+    context: {
+        component: string;
+        property?: string;
+        suggestion?: string;
+        documentation?: string;
+        package?: string;
+    };
+    getFormattedMessage(): string;
+}
+export declare function createEnhancedValidationError(message: string, context: {
+    component: string;
+    property?: string;
+    suggestion?: string;
+    documentation?: string;
+    package?: string;
+}): EnhancedValidationError;
+/**
+ * Intelligent fix suggestion with automated repair capability
+ */
+export interface IntelligentFixSuggestion {
+    id: string;
+    title: string;
+    description: string;
+    difficulty: 'easy' | 'medium' | 'hard';
+    confidence: number;
+    category: 'syntax' | 'logic' | 'performance' | 'accessibility' | 'best-practice';
+    before: string;
+    after: string;
+    canAutoFix: boolean;
+    autoFix?: () => string;
+    learnMore?: {
+        documentation: string;
+        examples: string[];
+        videoTutorial?: string;
+    };
+    relatedFixes: string[];
+}
+/**
+ * Enhanced error message template with rich formatting
+ */
+export interface DeveloperErrorMessageTemplate {
+    id: string;
+    title: string;
+    description: string;
+    severity: ValidationErrorSeverity;
+    category: ValidationErrorCategory;
+    emoji: string;
+    color: string;
+    quickFix: string;
+    explanation: string;
+    prevention: string;
+    suggestions: IntelligentFixSuggestion[];
+    examples: {
+        wrong: CodeExample[];
+        correct: CodeExample[];
+    };
+    documentation: {
+        primary: string;
+        related: string[];
+        apiReference?: string;
+    };
+    context: {
+        component?: string;
+        modifier?: string;
+        package?: string;
+        commonCause: string[];
+    };
+}
+/**
+ * Code example with syntax highlighting metadata
+ */
+export interface CodeExample {
+    code: string;
+    language: 'typescript' | 'javascript' | 'tsx' | 'jsx';
+    title: string;
+    description?: string;
+    highlights?: {
+        line: number;
+        type: 'error' | 'warning' | 'info' | 'success';
+        message: string;
+    }[];
+}
+/**
+ * Developer experience configuration
+ */
+export interface DeveloperExperienceConfig {
+    verbosity: 'minimal' | 'standard' | 'detailed' | 'comprehensive';
+    showEmojis: boolean;
+    showColors: boolean;
+    showCodeExamples: boolean;
+    showDocumentationLinks: boolean;
+    enableAutoFix: boolean;
+    suggestionCount: number;
+    minConfidenceScore: number;
+    enableInlineHelp: boolean;
+    enableHoverInfo: boolean;
+    enableQuickActions: boolean;
+    showLearningTips: boolean;
+    trackProgress: boolean;
+    personalization: boolean;
+}
+/**
+ * Comprehensive error message templates database
+ */
+export declare const errorMessageTemplates: Record<string, DeveloperErrorMessageTemplate>;
+/**
+ * Intelligent fix suggestion engine
+ */
+export declare class FixSuggestionEngine {
+    private suggestionDatabase;
+    private usageTracker;
+    constructor();
+    /**
+     * Get intelligent fix suggestions for a given error
+     */
+    getSuggestions(errorType: string, _context: {
+        component?: string;
+        modifier?: string;
+        code?: string;
+        severity?: ValidationErrorSeverity;
+    }): IntelligentFixSuggestion[];
+    /**
+     * Apply automatic fix
+     */
+    applyAutoFix(suggestionId: string, _code: string): string | null;
+    /**
+     * Track suggestion usage for improvement
+     */
+    private trackSuggestionUsage;
+    /**
+     * Initialize suggestion database with common fixes
+     */
+    private initializeSuggestionDatabase;
+    /**
+     * Get suggestion statistics
+     */
+    getStatistics(): {
+        totalSuggestions: number;
+        totalUsages: number;
+        topSuggestions: [string, number][];
+    };
+}
+/**
+ * Enhanced error message formatter with rich templates
+ */
+export declare class EnhancedErrorFormatter {
+    private fixEngine;
+    /**
+     * Format error with enhanced template
+     */
+    formatError(error: EnhancedValidationError, templateId?: string): FormattedErrorMessage;
+    /**
+     * Find the best template for an error
+     */
+    private findBestTemplate;
+    /**
+     * Render formatted message with rich content
+     */
+    private renderFormattedMessage;
+    /**
+     * Format basic error without template
+     */
+    private formatBasicError;
+    /**
+     * Generate quick actions for IDE integration
+     */
+    private generateQuickActions;
+}
+/**
+ * Formatted error message with rich content
+ */
+export interface FormattedErrorMessage {
+    id: string;
+    template: DeveloperErrorMessageTemplate | null;
+    error: EnhancedValidationError;
+    suggestions: IntelligentFixSuggestion[];
+    formatted: string;
+    interactive: {
+        canAutoFix: boolean;
+        quickActions: QuickAction[];
+        learnMore: {
+            primary: string;
+            related: string[];
+        };
+    };
+}
+/**
+ * Quick action for IDE integration
+ */
+export interface QuickAction {
+    id: string;
+    title: string;
+    description: string;
+    command: string;
+    arguments: any[];
+}
+/**
+ * Configure developer experience
+ */
+export declare function configureDeveloperExperience(config: Partial<DeveloperExperienceConfig>): void;
+/**
+ * Get current developer experience configuration
+ */
+export declare function getDeveloperExperienceConfig(): DeveloperExperienceConfig;
+declare const enhancedFormatter: EnhancedErrorFormatter;
+declare const fixEngine: FixSuggestionEngine;
+/**
+ * Developer Experience utilities
+ */
+export declare const DeveloperExperienceUtils: {
+    /**
+     * Format error with enhanced template
+     */
+    formatError: (error: EnhancedValidationError, templateId?: string) => FormattedErrorMessage;
+    /**
+     * Get fix suggestions
+     */
+    getSuggestions: (errorType: string, context: any) => IntelligentFixSuggestion[];
+    /**
+     * Apply automatic fix
+     */
+    applyAutoFix: (suggestionId: string, code: string) => string | null;
+    /**
+     * Get available error templates
+     */
+    getErrorTemplates: () => Record<string, DeveloperErrorMessageTemplate>;
+    /**
+     * Configure experience
+     */
+    configure: typeof configureDeveloperExperience;
+    /**
+     * Get statistics
+     */
+    getStatistics: () => {
+        formatter: {
+            templatesAvailable: number;
+        };
+        fixEngine: {
+            totalSuggestions: number;
+            totalUsages: number;
+            topSuggestions: [string, number][];
+        };
+        config: DeveloperExperienceConfig;
+    };
+    /**
+     * Test developer experience system
+     */
+    test: () => void;
+};
+export { enhancedFormatter, fixEngine };
+//# sourceMappingURL=developer-experience.d.ts.map

package/dist/debug/developer-experience.d.ts.map

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