traceperf 0.1.0 → 0.1.2

package/dist/esm/types/logger.d.ts

@@ -0,0 +1,127 @@
+import { LogMode, ITrackOptions } from './config';
+/**
+ * ILogger - Interface for the main logger functionality
+ */
+export interface ILogger {
+    /**
+     * Log an informational message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    info(message: string | object, ...args: any[]): void;
+    /**
+     * Log a warning message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    warn(message: string | object, ...args: any[]): void;
+    /**
+     * Log an error message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    error(message: string | object, ...args: any[]): void;
+    /**
+     * Log a debug message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    debug(message: string | object, ...args: any[]): void;
+    /**
+     * Start a new log group with the given label
+     *
+     * @param label - The label for the group
+     */
+    group(label: string): void;
+    /**
+     * End the current log group
+     */
+    groupEnd(): void;
+    /**
+     * Set the operational mode for the logger
+     *
+     * @param mode - The mode to set
+     */
+    setMode(mode: LogMode): void;
+    /**
+     * Get the current operational mode
+     *
+     * @returns The current mode
+     */
+    getMode(): LogMode;
+    /**
+     * Track the execution of a function and log performance metrics
+     *
+     * @param fn - The function to track
+     * @param options - Options for tracking
+     * @returns The return value of the tracked function
+     */
+    track<T>(fn: () => T, options?: ITrackOptions): T;
+}
+/**
+ * IExecutionTracker - Interface for tracking function execution
+ */
+export interface IExecutionTracker {
+    /**
+     * Track the execution of a function
+     *
+     * @param fn - The function to track
+     * @param options - Options for tracking
+     * @returns The return value of the tracked function
+     */
+    track<T>(fn: () => T, options?: ITrackOptions): T;
+    /**
+     * Get the current call stack
+     *
+     * @returns The current call stack
+     */
+    getCallStack(): string[];
+    /**
+     * Generate a visual representation of the execution flow
+     *
+     * @returns ASCII flow chart of the execution
+     */
+    generateFlowChart(): string;
+}
+/**
+ * IPerformanceMonitor - Interface for monitoring performance
+ */
+export interface IPerformanceMonitor {
+    /**
+     * Start timing an operation
+     *
+     * @param label - Label for the operation
+     * @returns A unique identifier for the timing operation
+     */
+    startTimer(label: string): string;
+    /**
+     * End timing an operation
+     *
+     * @param id - The identifier returned by startTimer
+     * @returns The duration in milliseconds
+     */
+    endTimer(id: string): number;
+    /**
+     * Check if an operation exceeds the performance threshold
+     *
+     * @param duration - The duration in milliseconds
+     * @param threshold - The threshold to check against
+     * @returns Whether the operation is considered slow
+     */
+    isBottleneck(duration: number, threshold?: number): boolean;
+    /**
+     * Get memory usage information
+     *
+     * @returns Memory usage in bytes
+     */
+    getMemoryUsage(): {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    };
+}

package/dist/esm/types/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/esm/types/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/types/logger.ts"],"names":[],"mappings":""}

package/dist/esm/utils/colors.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Utilities for working with terminal colors
+ */
+/**
+ * Apply color to a string
+ *
+ * @param text - The text to colorize
+ * @param color - The color to apply
+ * @returns The colorized string
+ */
+export declare function colorize(text: string, color: string): string;
+/**
+ * Apply bold formatting to a string
+ *
+ * @param text - The text to make bold
+ * @returns The bold string
+ */
+export declare function bold(text: string): string;
+/**
+ * Apply dim formatting to a string
+ *
+ * @param text - The text to make dim
+ * @returns The dim string
+ */
+export declare function dim(text: string): string;
+/**
+ * Apply underline formatting to a string
+ *
+ * @param text - The text to underline
+ * @returns The underlined string
+ */
+export declare function underline(text: string): string;
+/**
+ * Apply red color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The red string
+ */
+export declare function red(text: string): string;
+/**
+ * Apply green color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The green string
+ */
+export declare function green(text: string): string;
+/**
+ * Apply yellow color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The yellow string
+ */
+export declare function yellow(text: string): string;
+/**
+ * Apply blue color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The blue string
+ */
+export declare function blue(text: string): string;
+/**
+ * Apply magenta color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The magenta string
+ */
+export declare function magenta(text: string): string;
+/**
+ * Apply cyan color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The cyan string
+ */
+export declare function cyan(text: string): string;
+/**
+ * Apply gray color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The gray string
+ */
+export declare function gray(text: string): string;
+/**
+ * Check if terminal supports colors
+ *
+ * @returns Whether the terminal supports colors
+ */
+export declare function supportsColor(): boolean;

package/dist/esm/utils/colors.js

@@ -0,0 +1,134 @@
+import { COLORS } from '../core/constants';
+/**
+ * Utilities for working with terminal colors
+ */
+/**
+ * Apply color to a string
+ *
+ * @param text - The text to colorize
+ * @param color - The color to apply
+ * @returns The colorized string
+ */
+export function colorize(text, color) {
+    return `${color}${text}${COLORS.reset}`;
+}
+/**
+ * Apply bold formatting to a string
+ *
+ * @param text - The text to make bold
+ * @returns The bold string
+ */
+export function bold(text) {
+    return `${COLORS.bright}${text}${COLORS.reset}`;
+}
+/**
+ * Apply dim formatting to a string
+ *
+ * @param text - The text to make dim
+ * @returns The dim string
+ */
+export function dim(text) {
+    return `${COLORS.dim}${text}${COLORS.reset}`;
+}
+/**
+ * Apply underline formatting to a string
+ *
+ * @param text - The text to underline
+ * @returns The underlined string
+ */
+export function underline(text) {
+    return `${COLORS.underscore}${text}${COLORS.reset}`;
+}
+/**
+ * Apply red color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The red string
+ */
+export function red(text) {
+    return colorize(text, COLORS.fg.red);
+}
+/**
+ * Apply green color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The green string
+ */
+export function green(text) {
+    return colorize(text, COLORS.fg.green);
+}
+/**
+ * Apply yellow color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The yellow string
+ */
+export function yellow(text) {
+    return colorize(text, COLORS.fg.yellow);
+}
+/**
+ * Apply blue color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The blue string
+ */
+export function blue(text) {
+    return colorize(text, COLORS.fg.blue);
+}
+/**
+ * Apply magenta color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The magenta string
+ */
+export function magenta(text) {
+    return colorize(text, COLORS.fg.magenta);
+}
+/**
+ * Apply cyan color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The cyan string
+ */
+export function cyan(text) {
+    return colorize(text, COLORS.fg.cyan);
+}
+/**
+ * Apply gray color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The gray string
+ */
+export function gray(text) {
+    return colorize(text, COLORS.fg.gray);
+}
+/**
+ * Check if terminal supports colors
+ *
+ * @returns Whether the terminal supports colors
+ */
+export function supportsColor() {
+    if (process.env.FORCE_COLOR === '0') {
+        return false;
+    }
+    if (process.env.FORCE_COLOR) {
+        return true;
+    }
+    if (process.platform === 'win32') {
+        return true;
+    }
+    if ('CI' in process.env) {
+        return true;
+    }
+    if (process.env.COLORTERM) {
+        return true;
+    }
+    if (process.env.TERM === 'dumb') {
+        return false;
+    }
+    if (process.stdout.isTTY) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=colors.js.map

package/dist/esm/utils/colors.js.map

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

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './timing';
+export * from './stack';
+export * from './colors';

package/dist/esm/utils/index.js

@@ -0,0 +1,4 @@
+export * from './timing';
+export * from './stack';
+export * from './colors';
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/esm/utils/stack.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Utilities for managing call stacks and function tracking
+ */
+/**
+ * Extract the name of a function
+ *
+ * @param fn - The function to extract the name from
+ * @returns The function name or a placeholder if not available
+ */
+export declare function getFunctionName(fn: Function): string;
+/**
+ * Get the current call stack
+ *
+ * @returns An array of function names in the call stack
+ */
+export declare function getCallStack(): string[];
+/**
+ * CallStackManager - Manages a call stack for execution tracking
+ */
+export declare class CallStackManager {
+    private _stack;
+    /**
+     * Push a function name onto the call stack
+     *
+     * @param name - The function name
+     * @returns The current stack depth
+     */
+    push(name: string): number;
+    /**
+     * Pop a function name from the call stack
+     *
+     * @returns The popped function name or undefined if the stack is empty
+     */
+    pop(): string | undefined;
+    /**
+     * Get the current call stack
+     *
+     * @returns A copy of the current call stack
+     */
+    getStack(): string[];
+    /**
+     * Get the current stack depth
+     *
+     * @returns The current stack depth
+     */
+    getDepth(): number;
+    /**
+     * Clear the call stack
+     */
+    clear(): void;
+    /**
+     * Get the current function name (top of the stack)
+     *
+     * @returns The current function name or undefined if the stack is empty
+     */
+    getCurrentFunction(): string | undefined;
+    /**
+     * Get the parent function name
+     *
+     * @returns The parent function name or undefined if there is no parent
+     */
+    getParentFunction(): string | undefined;
+}

package/dist/esm/utils/stack.js

@@ -0,0 +1,110 @@
+/**
+ * Utilities for managing call stacks and function tracking
+ */
+/**
+ * Extract the name of a function
+ *
+ * @param fn - The function to extract the name from
+ * @returns The function name or a placeholder if not available
+ */
+export function getFunctionName(fn) {
+    if (fn.name) {
+        return fn.name;
+    }
+    // Try to extract name from function toString()
+    const fnStr = fn.toString();
+    const nameMatch = fnStr.match(/function\s+([^(]+)/);
+    if (nameMatch) {
+        return nameMatch[1].trim();
+    }
+    // For arrow functions or anonymous functions
+    const arrowMatch = fnStr.match(/^\s*(?:async\s+)?(?:\([^)]*\)|\w+)\s*=>/);
+    if (arrowMatch) {
+        return '<arrow function>';
+    }
+    return '<anonymous>';
+}
+/**
+ * Get the current call stack
+ *
+ * @returns An array of function names in the call stack
+ */
+export function getCallStack() {
+    const stack = new Error().stack;
+    if (!stack) {
+        return [];
+    }
+    // Parse the stack trace
+    return stack
+        .split('\n')
+        .slice(2) // Skip the Error and this function
+        .map(line => {
+        const match = line.match(/at\s+([^\s]+)/);
+        return match ? match[1] : line.trim();
+    });
+}
+/**
+ * CallStackManager - Manages a call stack for execution tracking
+ */
+export class CallStackManager {
+    constructor() {
+        this._stack = [];
+    }
+    /**
+     * Push a function name onto the call stack
+     *
+     * @param name - The function name
+     * @returns The current stack depth
+     */
+    push(name) {
+        this._stack.push(name);
+        return this._stack.length;
+    }
+    /**
+     * Pop a function name from the call stack
+     *
+     * @returns The popped function name or undefined if the stack is empty
+     */
+    pop() {
+        return this._stack.pop();
+    }
+    /**
+     * Get the current call stack
+     *
+     * @returns A copy of the current call stack
+     */
+    getStack() {
+        return [...this._stack];
+    }
+    /**
+     * Get the current stack depth
+     *
+     * @returns The current stack depth
+     */
+    getDepth() {
+        return this._stack.length;
+    }
+    /**
+     * Clear the call stack
+     */
+    clear() {
+        this._stack = [];
+    }
+    /**
+     * Get the current function name (top of the stack)
+     *
+     * @returns The current function name or undefined if the stack is empty
+     */
+    getCurrentFunction() {
+        return this._stack[this._stack.length - 1];
+    }
+    /**
+     * Get the parent function name
+     *
+     * @returns The parent function name or undefined if there is no parent
+     */
+    getParentFunction() {
+        return this._stack[this._stack.length - 2];
+    }
+}
+//# sourceMappingURL=stack.js.map

package/dist/esm/utils/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/utils/stack.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,EAAY;IAC1C,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC,IAAI,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC1E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wBAAwB;IACxB,OAAO,KAAK;SACT,KAAK,CAAC,IAAI,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC;SAC5C,GAAG,CAAC,IAAI,CAAC,EAAE;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACU,WAAM,GAAa,EAAE,CAAC;IAgEhC,CAAC;IA9DC;;;;;OAKG;IACI,IAAI,CAAC,IAAY;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/esm/utils/timing.d.ts

@@ -0,0 +1,65 @@
+/**
+ * High-resolution timing utilities for performance tracking
+ */
+/**
+ * Get the current high-resolution time
+ *
+ * @returns The current high-resolution time
+ */
+export declare function getHighResTime(): [number, number];
+/**
+ * Calculate the duration between a start time and now
+ *
+ * @param startTime - The start time from getHighResTime()
+ * @returns The duration in milliseconds
+ */
+export declare function getDuration(startTime: [number, number]): number;
+/**
+ * Format a duration in milliseconds to a human-readable string
+ *
+ * @param duration - The duration in milliseconds
+ * @returns A formatted string (e.g., "1.23ms", "1.23s")
+ */
+export declare function formatDuration(duration: number): string;
+/**
+ * A simple timer class for measuring durations
+ */
+export declare class Timer {
+    private _startTime;
+    private _endTime;
+    private _label;
+    /**
+     * Create a new Timer instance
+     *
+     * @param label - A label for the timer
+     */
+    constructor(label: string);
+    /**
+     * Stop the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    stop(): number;
+    /**
+     * Get the duration of the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    getDuration(): number;
+    /**
+     * Get the label of the timer
+     *
+     * @returns The timer label
+     */
+    getLabel(): string;
+    /**
+     * Reset the timer
+     */
+    reset(): void;
+    /**
+     * Get a formatted string with the duration
+     *
+     * @returns A formatted string (e.g., "label: 1.23ms")
+     */
+    toString(): string;
+}