@tachui/devtools 0.8.0-alpha

package/dist/inspector/index.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Development Tools System
+ *
+ * Comprehensive debugging and development tools for TachUI.
+ * Provides component tree inspection, performance analysis,
+ * and runtime debugging capabilities.
+ */
+import type { ComponentInstance } from '@tachui/core';
+/**
+ * Component tree node for debugging
+ */
+export interface ComponentTreeNode {
+    id: string;
+    name: string;
+    type: 'component' | 'element' | 'text' | 'fragment';
+    props: Record<string, any>;
+    children: ComponentTreeNode[];
+    parent: ComponentTreeNode | null;
+    depth: number;
+    renderCount: number;
+    lastRenderTime: number;
+    memoryUsage: number;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Development environment state
+ */
+export interface DevState {
+    enabled: boolean;
+    performanceTracking: boolean;
+    componentInspection: boolean;
+    reactiveDebugging: boolean;
+    memoryTracking: boolean;
+    warningsEnabled: boolean;
+    logLevel: 'error' | 'warn' | 'info' | 'debug';
+}
+/**
+ * Development tools configuration
+ */
+export interface DevToolsConfig {
+    autoEnable: boolean;
+    trackAllComponents: boolean;
+    trackMemoryUsage: boolean;
+    enableWarnings: boolean;
+    enableErrors: boolean;
+    maxTreeDepth: number;
+    updateInterval: number;
+}
+/**
+ * Runtime debugging event
+ */
+export interface DebugEvent {
+    type: 'component_mount' | 'component_unmount' | 'component_update' | 'reactive_create' | 'reactive_update' | 'context_change' | 'performance_warning' | 'error';
+    timestamp: number;
+    componentId?: string;
+    componentName?: string;
+    data: any;
+    stack?: string;
+}
+/**
+ * Development tools manager
+ */
+export declare class DevTools {
+    private static instance;
+    private config;
+    private state;
+    private componentTree;
+    private componentRegistry;
+    private debugEvents;
+    private activeComponents;
+    private treeSignal;
+    private setTree;
+    private eventsSignal;
+    private setEvents;
+    private stateSignal;
+    private setState;
+    private updateTimer;
+    constructor();
+    static getInstance(): DevTools;
+    /**
+     * Configure development tools
+     */
+    configure(config: Partial<DevToolsConfig>): void;
+    /**
+     * Enable development tools
+     */
+    enable(): void;
+    /**
+     * Disable development tools
+     */
+    disable(): void;
+    /**
+     * Check if dev tools are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Register a component instance
+     */
+    registerComponent(componentId: string, instance: ComponentInstance, parentId?: string): void;
+    /**
+     * Unregister a component instance
+     */
+    unregisterComponent(componentId: string): void;
+    /**
+     * Update component data
+     */
+    updateComponent(componentId: string, updates: Partial<ComponentTreeNode>): void;
+    /**
+     * Track reactive operation
+     */
+    trackReactiveOperation(type: string, operation: string, componentId?: string): void;
+    /**
+     * Track context changes
+     */
+    trackContextChange(contextName: string, newValue: any, componentId?: string): void;
+    /**
+     * Add warning to component
+     */
+    addWarning(componentId: string, message: string): void;
+    /**
+     * Add error to component
+     */
+    addError(componentId: string, error: Error | string): void;
+    /**
+     * Get component tree
+     */
+    getComponentTree(): Map<string, ComponentTreeNode>;
+    /**
+     * Get component tree signal
+     */
+    getComponentTreeSignal(): () => Map<string, ComponentTreeNode>;
+    /**
+     * Get root components
+     */
+    getRootComponents(): ComponentTreeNode[];
+    /**
+     * Get component by ID
+     */
+    getComponent(componentId: string): ComponentTreeNode | undefined;
+    /**
+     * Find components by name
+     */
+    findComponentsByName(name: string): ComponentTreeNode[];
+    /**
+     * Get debug events
+     */
+    getDebugEvents(): DebugEvent[];
+    /**
+     * Get debug events signal
+     */
+    getDebugEventsSignal(): () => DebugEvent[];
+    /**
+     * Get development state
+     */
+    getDevState(): DevState;
+    /**
+     * Get development state signal
+     */
+    getDevStateSignal(): () => DevState;
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary(): {
+        componentCount: number;
+        averageRenderTime: number;
+        memoryUsage: number;
+        warningCount: number;
+        errorCount: number;
+        slowComponents: {
+            id: string;
+            name: string;
+            renderTime: number;
+        }[];
+    };
+    /**
+     * Export debug data
+     */
+    exportDebugData(): string;
+    /**
+     * Clear debug data
+     */
+    clear(): void;
+    private getComponentName;
+    private removeNodeAndDescendants;
+    private addDebugEvent;
+    private startUpdateTimer;
+    private stopUpdateTimer;
+    private updateComponentMetrics;
+}
+/**
+ * Global dev tools instance
+ */
+export declare const globalDevTools: DevTools;
+/**
+ * Enable performance tracking
+ */
+export declare function enablePerformanceTracking(): void;
+/**
+ * Get component tree
+ */
+export declare function getComponentTree(): Map<string, ComponentTreeNode>;
+/**
+ * Enable development mode with full debugging
+ */
+export declare function enableDevelopmentMode(config?: Partial<DevToolsConfig>): void;
+/**
+ * Get development tools instance
+ */
+export declare function getDevTools(): DevTools;
+/**
+ * Development utilities
+ */
+export declare const devUtils: {
+    /**
+     * Log component tree to console
+     */
+    logComponentTree(): void;
+    /**
+     * Log performance summary
+     */
+    logPerformanceSummary(): void;
+    /**
+     * Find component by name
+     */
+    findComponent(name: string): ComponentTreeNode[];
+    /**
+     * Inspect component
+     */
+    inspectComponent(componentId: string): ComponentTreeNode | undefined;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/inspector/index.d.ts.map

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