edgeflowjs 0.1.0 → 0.2.0

package/dist/tools/debugger.d.ts

@@ -0,0 +1,258 @@
+/**
+ * edgeFlow.js - Visual Debugging Tools
+ *
+ * In-browser debugging and visualization utilities for ML models.
+ */
+import { EdgeFlowTensor } from '../core/index.js';
+/**
+ * Debugger configuration
+ */
+export interface DebuggerConfig {
+    /** Enable logging */
+    logging?: boolean;
+    /** Log level */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** Enable tensor inspection */
+    inspectTensors?: boolean;
+    /** Maximum values to display per tensor */
+    maxDisplayValues?: number;
+    /** Enable performance tracking */
+    trackPerformance?: boolean;
+    /** Custom logger function */
+    logger?: (level: string, message: string, data?: unknown) => void;
+}
+/**
+ * Tensor inspection result
+ */
+export interface TensorInspection {
+    name: string;
+    shape: number[];
+    dtype: string;
+    size: number;
+    memoryBytes: number;
+    stats: TensorStats;
+    sample: number[];
+    histogram?: HistogramData;
+}
+/**
+ * Tensor statistics
+ */
+export interface TensorStats {
+    min: number;
+    max: number;
+    mean: number;
+    std: number;
+    zeros: number;
+    nans: number;
+    infinities: number;
+    sparsity: number;
+}
+/**
+ * Histogram data
+ */
+export interface HistogramData {
+    bins: number[];
+    counts: number[];
+    binEdges: number[];
+}
+/**
+ * Inference trace
+ */
+export interface InferenceTrace {
+    id: string;
+    modelId: string;
+    timestamp: number;
+    inputs: TensorInspection[];
+    outputs: TensorInspection[];
+    duration: number;
+    memoryUsed: number;
+    operations: OperationTrace[];
+}
+/**
+ * Operation trace
+ */
+export interface OperationTrace {
+    name: string;
+    type: string;
+    duration: number;
+    inputShapes: number[][];
+    outputShapes: number[][];
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Debug event
+ */
+export interface DebugEvent {
+    type: 'tensor' | 'inference' | 'error' | 'warning' | 'info' | 'performance';
+    timestamp: number;
+    data: unknown;
+    message: string;
+}
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    inferenceCount: number;
+    totalInferenceTime: number;
+    averageInferenceTime: number;
+    minInferenceTime: number;
+    maxInferenceTime: number;
+    peakMemoryUsage: number;
+    currentMemoryUsage: number;
+    tensorAllocations: number;
+    tensorDeallocations: number;
+}
+/**
+ * Inspect a tensor
+ */
+export declare function inspectTensor(tensor: EdgeFlowTensor, name?: string, options?: {
+    histogram?: boolean;
+    maxSample?: number;
+}): TensorInspection;
+/**
+ * Format tensor inspection for display
+ */
+export declare function formatTensorInspection(inspection: TensorInspection): string;
+/**
+ * Visual debugger for edgeFlow.js
+ */
+export declare class EdgeFlowDebugger {
+    private config;
+    private events;
+    private traces;
+    private performanceMetrics;
+    private listeners;
+    private isEnabled;
+    constructor(config?: DebuggerConfig);
+    /**
+     * Default logger
+     */
+    private defaultLogger;
+    /**
+     * Log a message
+     */
+    log(level: string, message: string, data?: unknown): void;
+    /**
+     * Add debug event
+     */
+    private addEvent;
+    /**
+     * Enable debugger
+     */
+    enable(): void;
+    /**
+     * Disable debugger
+     */
+    disable(): void;
+    /**
+     * Subscribe to events
+     */
+    on(type: string, callback: (event: DebugEvent) => void): () => void;
+    /**
+     * Inspect and log a tensor
+     */
+    inspectTensor(tensor: EdgeFlowTensor, name?: string): TensorInspection;
+    /**
+     * Start tracing an inference
+     */
+    startTrace(modelId: string): string;
+    /**
+     * Add input to trace
+     */
+    traceInput(traceId: string, tensor: EdgeFlowTensor, name: string): void;
+    /**
+     * Add output to trace
+     */
+    traceOutput(traceId: string, tensor: EdgeFlowTensor, name: string): void;
+    /**
+     * Add operation to trace
+     */
+    traceOperation(traceId: string, operation: OperationTrace): void;
+    /**
+     * End trace
+     */
+    endTrace(traceId: string): InferenceTrace | undefined;
+    /**
+     * Record tensor allocation
+     */
+    recordAllocation(tensor: EdgeFlowTensor): void;
+    /**
+     * Record tensor deallocation
+     */
+    recordDeallocation(tensor: EdgeFlowTensor): void;
+    /**
+     * Get performance metrics
+     */
+    getPerformanceMetrics(): PerformanceMetrics;
+    /**
+     * Get all events
+     */
+    getEvents(): DebugEvent[];
+    /**
+     * Get all traces
+     */
+    getTraces(): InferenceTrace[];
+    /**
+     * Get trace by ID
+     */
+    getTrace(traceId: string): InferenceTrace | undefined;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    /**
+     * Export debug data
+     */
+    export(): {
+        events: DebugEvent[];
+        traces: InferenceTrace[];
+        metrics: PerformanceMetrics;
+        timestamp: number;
+    };
+    /**
+     * Generate summary report
+     */
+    generateReport(): string;
+}
+/**
+ * Get or create the global debugger instance
+ */
+export declare function getDebugger(config?: DebuggerConfig): EdgeFlowDebugger;
+/**
+ * Enable debugging
+ */
+export declare function enableDebugging(config?: DebuggerConfig): EdgeFlowDebugger;
+/**
+ * Disable debugging
+ */
+export declare function disableDebugging(): void;
+/**
+ * Create ASCII histogram
+ */
+export declare function createAsciiHistogram(histogram: HistogramData, width?: number, height?: number): string;
+/**
+ * Create tensor heatmap (for 2D tensors)
+ */
+export declare function createTensorHeatmap(tensor: EdgeFlowTensor, width?: number): string;
+/**
+ * Create model architecture visualization
+ */
+export declare function visualizeModelArchitecture(layers: Array<{
+    name: string;
+    type: string;
+    inputShape: number[];
+    outputShape: number[];
+}>): string;
+declare const _default: {
+    EdgeFlowDebugger: typeof EdgeFlowDebugger;
+    getDebugger: typeof getDebugger;
+    enableDebugging: typeof enableDebugging;
+    disableDebugging: typeof disableDebugging;
+    inspectTensor: typeof inspectTensor;
+    formatTensorInspection: typeof formatTensorInspection;
+    createAsciiHistogram: typeof createAsciiHistogram;
+    createTensorHeatmap: typeof createTensorHeatmap;
+    visualizeModelArchitecture: typeof visualizeModelArchitecture;
+};
+export default _default;
+//# sourceMappingURL=debugger.d.ts.map

package/dist/tools/debugger.d.ts.map

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