@tachui/cli 0.8.10-alpha.0 → 0.8.12

package/dist/devtools/src/runtime/performance.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Performance Monitoring System (Phase 3.2.2)
+ *
+ * Comprehensive performance monitoring and debugging tools for TachUI.
+ * Tracks component lifecycle metrics, reactive system performance,
+ * and provides detailed debugging information.
+ */
+/**
+ * Performance metric types
+ */
+export interface PerformanceMetric {
+    name: string;
+    value: number;
+    unit: 'ms' | 'bytes' | 'count';
+    timestamp: number;
+    category: 'component' | 'reactive' | 'render' | 'memory';
+    componentId?: string;
+    phase?: string;
+}
+/**
+ * Component performance data
+ */
+export interface ComponentMetrics {
+    id: string;
+    name: string;
+    mountTime: number;
+    renderTime: number;
+    updateCount: number;
+    propsChanges: number;
+    lastRenderDuration: number;
+    memoryUsage: number;
+    children: ComponentMetrics[];
+}
+/**
+ * Reactive system metrics
+ */
+export interface ReactiveMetrics {
+    signalCount: number;
+    computedCount: number;
+    effectCount: number;
+    signalUpdates: number;
+    computedRecalculations: number;
+    effectExecutions: number;
+    averageUpdateTime: number;
+    memoryFootprint: number;
+}
+/**
+ * Performance monitoring options
+ */
+export interface MonitoringOptions {
+    enabled: boolean;
+    trackComponents: boolean;
+    trackReactive: boolean;
+    trackMemory: boolean;
+    trackRender: boolean;
+    sampleRate: number;
+    maxMetrics: number;
+}
+/**
+ * Performance event listener
+ */
+export type PerformanceListener = (metric: PerformanceMetric) => void;
+/**
+ * Comprehensive performance monitoring system
+ */
+export declare class PerformanceMonitor {
+    private static instance;
+    private options;
+    private metrics;
+    private componentMetrics;
+    private reactiveMetrics;
+    private listeners;
+    private timers;
+    private metricsSignal;
+    private setMetrics;
+    private componentMetricsSignal;
+    private setComponentMetrics;
+    constructor();
+    static getInstance(): PerformanceMonitor;
+    /**
+     * Configure monitoring options
+     */
+    configure(options: Partial<MonitoringOptions>): void;
+    /**
+     * Enable performance monitoring
+     */
+    enable(): void;
+    /**
+     * Disable performance monitoring
+     */
+    disable(): void;
+    /**
+     * Check if monitoring is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Start timing an operation
+     */
+    startTimer(name: string): void;
+    /**
+     * End timing and record metric
+     */
+    endTimer(name: string, category?: PerformanceMetric['category'], componentId?: string): number;
+    /**
+     * Record a custom metric
+     */
+    recordMetric(metric: PerformanceMetric): void;
+    /**
+     * Track component mount
+     */
+    trackComponentMount(componentId: string, componentName: string): void;
+    /**
+     * Track component unmount
+     */
+    trackComponentUnmount(componentId: string): void;
+    /**
+     * Track component render
+     */
+    trackComponentRender(componentId: string, duration: number): void;
+    /**
+     * Track props changes
+     */
+    trackPropsChange(componentId: string, changedKeys: string[]): void;
+    /**
+     * Track reactive system metrics
+     */
+    trackReactiveOperation(type: 'signal' | 'computed' | 'effect', operation: 'create' | 'update' | 'execute', duration?: number): void;
+    /**
+     * Track memory usage
+     */
+    trackMemoryUsage(): void;
+    /**
+     * Estimate memory usage (simplified)
+     */
+    private estimateMemoryUsage;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): PerformanceMetric[];
+    /**
+     * Get reactive metrics signal
+     */
+    getMetricsSignal(): () => PerformanceMetric[];
+    /**
+     * Get component metrics
+     */
+    getComponentMetrics(): Map<string, ComponentMetrics>;
+    /**
+     * Get component metrics signal
+     */
+    getComponentMetricsSignal(): () => Map<string, ComponentMetrics>;
+    /**
+     * Get reactive system metrics
+     */
+    getReactiveMetrics(): ReactiveMetrics;
+    /**
+     * Get metrics by category
+     */
+    getMetricsByCategory(category: PerformanceMetric['category']): PerformanceMetric[];
+    /**
+     * Get metrics by component
+     */
+    getMetricsByComponent(componentId: string): PerformanceMetric[];
+    /**
+     * Get average metric value
+     */
+    getAverageMetric(name: string): number;
+    /**
+     * Get performance summary
+     */
+    getSummary(): {
+        totalMetrics: number;
+        componentCount: number;
+        reactive: ReactiveMetrics;
+        averageRenderTime: number;
+        averageMemoryUsage: number;
+        mostActiveComponent: string | null;
+    };
+    /**
+     * Add performance listener
+     */
+    addListener(listener: PerformanceListener): () => void;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Export metrics to JSON
+     */
+    exportMetrics(): string;
+    /**
+     * Import metrics from JSON
+     */
+    importMetrics(json: string): void;
+}
+/**
+ * Global performance monitor instance
+ */
+export declare const globalPerformanceMonitor: PerformanceMonitor;
+/**
+ * Performance monitoring decorators and utilities
+ */
+export declare const performanceUtils: {
+    /**
+     * Measure function execution time
+     */
+    measure<T>(name: string, fn: () => T, category?: PerformanceMetric["category"]): T;
+    /**
+     * Async function measurement
+     */
+    measureAsync<T>(name: string, fn: () => Promise<T>, category?: PerformanceMetric["category"]): Promise<T>;
+    /**
+     * Create a performance tracking wrapper for components
+     */
+    withPerformanceTracking<T extends (...args: any[]) => any>(componentFn: T, componentName: string): T;
+};
+//# sourceMappingURL=performance.d.ts.map

package/dist/devtools/src/runtime/performance.d.ts.map

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