traceperf 0.1.0

package/dist/core/config.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = void 0;
+const constants_1 = require("./constants");
+/**
+ * Configuration manager for the logger
+ * Handles merging user config with defaults and provides utility methods
+ */
+class ConfigManager {
+    /**
+     * Create a new ConfigManager instance
+     *
+     * @param userConfig - User-provided configuration options
+     */
+    constructor(userConfig = {}) {
+        this._config = { ...constants_1.DEFAULT_CONFIG, ...userConfig };
+    }
+    /**
+     * Get the current configuration
+     *
+     * @returns The current configuration
+     */
+    getConfig() {
+        return { ...this._config };
+    }
+    /**
+     * Update the configuration
+     *
+     * @param newConfig - New configuration options to merge
+     */
+    updateConfig(newConfig) {
+        this._config = { ...this._config, ...newConfig };
+    }
+    /**
+     * Get the current mode
+     *
+     * @returns The current mode
+     */
+    getMode() {
+        var _a;
+        return (_a = this._config.mode) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.mode;
+    }
+    /**
+     * Set the current mode
+     *
+     * @param mode - The mode to set
+     */
+    setMode(mode) {
+        this._config.mode = mode;
+    }
+    /**
+     * Check if a log level should be displayed based on the current mode and level
+     *
+     * @param level - The log level to check
+     * @returns Whether the log level should be displayed
+     */
+    shouldLog(level) {
+        var _a;
+        const currentMode = this.getMode();
+        const configLevel = (_a = this._config.level) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.level;
+        // Get the minimum level for the current mode
+        const modeMinLevel = constants_1.MODE_MIN_LEVELS[currentMode] || 'info';
+        // Use the higher of the mode's minimum level and the configured level
+        const effectiveMinLevel = this.getHigherPriorityLevel(modeMinLevel, configLevel);
+        // Check if the provided level meets the minimum threshold
+        return constants_1.LOG_LEVEL_PRIORITY[level] >= constants_1.LOG_LEVEL_PRIORITY[effectiveMinLevel];
+    }
+    /**
+     * Get the higher priority level between two log levels
+     *
+     * @param levelA - First log level
+     * @param levelB - Second log level
+     * @returns The higher priority level
+     */
+    getHigherPriorityLevel(levelA, levelB) {
+        return constants_1.LOG_LEVEL_PRIORITY[levelA] >= constants_1.LOG_LEVEL_PRIORITY[levelB] ? levelA : levelB;
+    }
+    /**
+     * Get the performance threshold
+     *
+     * @returns The performance threshold in milliseconds
+     */
+    getPerformanceThreshold() {
+        var _a;
+        return (_a = this._config.performanceThreshold) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.performanceThreshold;
+    }
+    /**
+     * Get the indentation size
+     *
+     * @returns The number of spaces for each indentation level
+     */
+    getIndentSize() {
+        var _a;
+        return (_a = this._config.indentSize) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.indentSize;
+    }
+    /**
+     * Check if colorization is enabled
+     *
+     * @returns Whether colorization is enabled
+     */
+    isColorEnabled() {
+        var _a;
+        return (_a = this._config.colorize) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.colorize;
+    }
+    /**
+     * Check if timestamps are enabled
+     *
+     * @returns Whether timestamps are enabled
+     */
+    isTimestampEnabled() {
+        var _a;
+        return (_a = this._config.timestamp) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_CONFIG.timestamp;
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":";;;AACA,2CAAkF;AAElF;;;GAGG;AACH,MAAa,aAAa;IAGxB;;;;OAIG;IACH,YAAY,aAAqC,EAAE;QACjD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,0BAAc,EAAE,GAAG,UAAU,EAAE,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,SAAS;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,SAAiC;QACnD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,OAAO;;QACZ,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,IAAI,mCAAI,0BAAc,CAAC,IAAe,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,IAAa;QAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACI,SAAS,CAAC,KAAe;;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAA,IAAI,CAAC,OAAO,CAAC,KAAK,mCAAI,0BAAc,CAAC,KAAiB,CAAC;QAE3E,6CAA6C;QAC7C,MAAM,YAAY,GAAG,2BAAe,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC;QAE5D,sEAAsE;QACtE,MAAM,iBAAiB,GAAG,IAAI,CAAC,sBAAsB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAEjF,0DAA0D;QAC1D,OAAO,8BAAkB,CAAC,KAAK,CAAC,IAAI,8BAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACK,sBAAsB,CAAC,MAAgB,EAAE,MAAgB;QAC/D,OAAO,8BAAkB,CAAC,MAAM,CAAC,IAAI,8BAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,CAAC;IAED;;;;OAIG;IACI,uBAAuB;;QAC5B,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,oBAAoB,mCAAI,0BAAc,CAAC,oBAA8B,CAAC;IAC5F,CAAC;IAED;;;;OAIG;IACI,aAAa;;QAClB,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,UAAU,mCAAI,0BAAc,CAAC,UAAoB,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACI,cAAc;;QACnB,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,mCAAI,0BAAc,CAAC,QAAmB,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACI,kBAAkB;;QACvB,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,SAAS,mCAAI,0BAAc,CAAC,SAAoB,CAAC;IACvE,CAAC;CACF;AAlHD,sCAkHC"}

package/dist/core/constants.d.ts

@@ -0,0 +1,78 @@
+import { LogLevel, LogMode, ILoggerConfig } from '../types';
+/**
+ * Default configuration for the logger
+ */
+export declare const DEFAULT_CONFIG: ILoggerConfig;
+/**
+ * Log level priorities (higher number = higher priority)
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+/**
+ * Minimum log level for each mode
+ */
+export declare const MODE_MIN_LEVELS: Record<LogMode, LogLevel>;
+/**
+ * ANSI color codes for terminal output
+ */
+export declare const COLORS: {
+    reset: string;
+    bright: string;
+    dim: string;
+    underscore: string;
+    fg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        gray: string;
+    };
+    bg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+    };
+};
+/**
+ * Log level colors
+ */
+export declare const LEVEL_COLORS: Record<LogLevel, string>;
+/**
+ * Log level icons
+ */
+export declare const LEVEL_ICONS: Record<LogLevel, string>;
+/**
+ * Box drawing characters for ASCII flow charts
+ */
+export declare const BOX_CHARS: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    verticalRight: string;
+    verticalLeft: string;
+    horizontalDown: string;
+    horizontalUp: string;
+    cross: string;
+    downArrow: string;
+};
+/**
+ * Performance icons
+ */
+export declare const PERFORMANCE_ICONS: {
+    timer: string;
+    slow: string;
+    memory: string;
+    bottleneck: string;
+    fix: string;
+};

package/dist/core/constants.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERFORMANCE_ICONS = exports.BOX_CHARS = exports.LEVEL_ICONS = exports.LEVEL_COLORS = exports.COLORS = exports.MODE_MIN_LEVELS = exports.LOG_LEVEL_PRIORITY = exports.DEFAULT_CONFIG = void 0;
+/**
+ * Default configuration for the logger
+ */
+exports.DEFAULT_CONFIG = {
+    mode: 'dev',
+    level: 'debug',
+    colorize: true,
+    timestamp: true,
+    performanceThreshold: 100, // ms
+    indentSize: 2,
+};
+/**
+ * Log level priorities (higher number = higher priority)
+ */
+exports.LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Minimum log level for each mode
+ */
+exports.MODE_MIN_LEVELS = {
+    dev: 'debug', // In dev mode, show all logs
+    staging: 'warn', // In staging, show only warnings and errors
+    prod: 'error', // In prod, show only errors
+};
+/**
+ * ANSI color codes for terminal output
+ */
+exports.COLORS = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    underscore: '\x1b[4m',
+    // Foreground colors
+    fg: {
+        black: '\x1b[30m',
+        red: '\x1b[31m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m',
+        magenta: '\x1b[35m',
+        cyan: '\x1b[36m',
+        white: '\x1b[37m',
+        gray: '\x1b[90m',
+    },
+    // Background colors
+    bg: {
+        black: '\x1b[40m',
+        red: '\x1b[41m',
+        green: '\x1b[42m',
+        yellow: '\x1b[43m',
+        blue: '\x1b[44m',
+        magenta: '\x1b[45m',
+        cyan: '\x1b[46m',
+        white: '\x1b[47m',
+    },
+};
+/**
+ * Log level colors
+ */
+exports.LEVEL_COLORS = {
+    debug: exports.COLORS.fg.gray,
+    info: exports.COLORS.fg.blue,
+    warn: exports.COLORS.fg.yellow,
+    error: exports.COLORS.fg.red,
+};
+/**
+ * Log level icons
+ */
+exports.LEVEL_ICONS = {
+    debug: '🔍',
+    info: 'ℹ️',
+    warn: '⚠️',
+    error: '❌',
+};
+/**
+ * Box drawing characters for ASCII flow charts
+ */
+exports.BOX_CHARS = {
+    topLeft: '┌',
+    topRight: '┐',
+    bottomLeft: '└',
+    bottomRight: '┘',
+    horizontal: '─',
+    vertical: '│',
+    verticalRight: '├',
+    verticalLeft: '┤',
+    horizontalDown: '┬',
+    horizontalUp: '┴',
+    cross: '┼',
+    downArrow: '▼',
+};
+/**
+ * Performance icons
+ */
+exports.PERFORMANCE_ICONS = {
+    timer: '⏱',
+    slow: '⚠️',
+    memory: '📊',
+    bottleneck: '🛑',
+    fix: '🛠',
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACU,QAAA,cAAc,GAAkB;IAC3C,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,oBAAoB,EAAE,GAAG,EAAE,KAAK;IAChC,UAAU,EAAE,CAAC;CACd,CAAC;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA6B;IAC1D,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF;;GAEG;AACU,QAAA,eAAe,GAA8B;IACxD,GAAG,EAAE,OAAO,EAAK,6BAA6B;IAC9C,OAAO,EAAE,MAAM,EAAG,4CAA4C;IAC9D,IAAI,EAAE,OAAO,EAAK,4BAA4B;CAC/C,CAAC;AAEF;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,SAAS;IACd,UAAU,EAAE,SAAS;IAErB,oBAAoB;IACpB,EAAE,EAAE;QACF,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,UAAU;KACjB;IAED,oBAAoB;IACpB,EAAE,EAAE;QACF,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;KAClB;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,YAAY,GAA6B;IACpD,KAAK,EAAE,cAAM,CAAC,EAAE,CAAC,IAAI;IACrB,IAAI,EAAE,cAAM,CAAC,EAAE,CAAC,IAAI;IACpB,IAAI,EAAE,cAAM,CAAC,EAAE,CAAC,MAAM;IACtB,KAAK,EAAE,cAAM,CAAC,EAAE,CAAC,GAAG;CACrB,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA6B;IACnD,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,GAAG;CACX,CAAC;AAEF;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,GAAG;IACnB,YAAY,EAAE,GAAG;IACjB,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,GAAG;CACf,CAAC;AAEF;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,GAAG,EAAE,IAAI;CACV,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './config';
+export * from './constants';
+export * from './logger';

package/dist/core/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./logger"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,2CAAyB"}

package/dist/core/logger.d.ts

@@ -0,0 +1,84 @@
+import { ILogger, ILoggerConfig, LogMode, ITrackOptions } from '../types';
+/**
+ * Main logger class that implements the ILogger interface
+ */
+export declare class Logger implements ILogger {
+    private _config;
+    private _executionTracker;
+    private _performanceMonitor;
+    private _indentLevel;
+    private _transports;
+    private _formatters;
+    /**
+     * Create a new Logger instance
+     *
+     * @param config - Logger configuration
+     */
+    constructor(config?: Partial<ILoggerConfig>);
+    /**
+     * 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;
+    /**
+     * Internal method to log a message
+     *
+     * @param level - The log level
+     * @param message - The message to log
+     * @param args - Additional arguments
+     */
+    private log;
+}

package/dist/core/logger.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const config_1 = require("./config");
+const execution_1 = require("../trackers/execution");
+const performance_1 = require("../trackers/performance");
+const cli_1 = require("../formatters/cli");
+/**
+ * Console transport for outputting logs to the console
+ */
+class ConsoleTransport {
+    /**
+     * Write a log entry to the console
+     *
+     * @param entry - The formatted log entry
+     */
+    write(entry) {
+        console.log(entry);
+    }
+}
+/**
+ * Main logger class that implements the ILogger interface
+ */
+class Logger {
+    /**
+     * Create a new Logger instance
+     *
+     * @param config - Logger configuration
+     */
+    constructor(config = {}) {
+        this._indentLevel = 0;
+        this._config = new config_1.ConfigManager(config);
+        // Set up trackers
+        this._executionTracker = new execution_1.ExecutionTracker({
+            defaultThreshold: this._config.getPerformanceThreshold(),
+        });
+        this._performanceMonitor = new performance_1.PerformanceMonitor({
+            defaultThreshold: this._config.getPerformanceThreshold(),
+        });
+        // Set up transports
+        this._transports = config.transports || [new ConsoleTransport()];
+        // Set up formatters
+        this._formatters = config.formatters || [
+            new cli_1.CliFormatter({
+                colorEnabled: this._config.isColorEnabled(),
+                indentSize: this._config.getIndentSize(),
+            }),
+        ];
+    }
+    /**
+     * Log an informational message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    info(message, ...args) {
+        this.log('info', message, args);
+    }
+    /**
+     * Log a warning message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    warn(message, ...args) {
+        this.log('warn', message, args);
+    }
+    /**
+     * Log an error message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    error(message, ...args) {
+        this.log('error', message, args);
+    }
+    /**
+     * Log a debug message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to include in the log
+     */
+    debug(message, ...args) {
+        // Skip debug logs in production mode
+        if (this.getMode() === 'prod') {
+            return;
+        }
+        this.log('debug', message, args);
+    }
+    /**
+     * Start a new log group with the given label
+     *
+     * @param label - The label for the group
+     */
+    group(label) {
+        this.info(label);
+        this._indentLevel++;
+    }
+    /**
+     * End the current log group
+     */
+    groupEnd() {
+        if (this._indentLevel > 0) {
+            this._indentLevel--;
+        }
+    }
+    /**
+     * Set the operational mode for the logger
+     *
+     * @param mode - The mode to set
+     */
+    setMode(mode) {
+        this._config.setMode(mode);
+    }
+    /**
+     * Get the current operational mode
+     *
+     * @returns The current mode
+     */
+    getMode() {
+        return this._config.getMode();
+    }
+    /**
+     * 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(fn, options) {
+        var _a;
+        const silent = (_a = options === null || options === void 0 ? void 0 : options.silent) !== null && _a !== void 0 ? _a : false;
+        // Track the function execution
+        const result = this._executionTracker.track(fn, options);
+        // Log the execution flow if not silent
+        if (!silent) {
+            const flowChart = this._executionTracker.generateFlowChart();
+            // Log the flow chart directly to the console
+            // This bypasses the formatters to preserve the ASCII art
+            console.log('\nExecution Flow:');
+            console.log(flowChart);
+        }
+        return result;
+    }
+    /**
+     * Internal method to log a message
+     *
+     * @param level - The log level
+     * @param message - The message to log
+     * @param args - Additional arguments
+     */
+    log(level, message, args) {
+        // Check if this log level should be displayed
+        if (!this._config.shouldLog(level)) {
+            return;
+        }
+        // Create metadata for the log entry
+        const meta = {
+            timestamp: new Date(),
+            level,
+            indentLevel: this._indentLevel,
+        };
+        // Format the log entry using each formatter
+        for (const formatter of this._formatters) {
+            const formattedEntry = formatter.format(level, message, args, meta);
+            // Send to each transport
+            for (const transport of this._transports) {
+                transport.write(formattedEntry);
+            }
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/formatters/ascii.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Execution data for a function call
+ */
+export interface ExecutionData {
+    name: string;
+    duration: number;
+    isSlow: boolean;
+    memoryUsage?: number;
+    level: number;
+}
+/**
+ * ASCII art generator for execution flow charts
+ */
+export declare class AsciiArtGenerator {
+    private _boxWidth;
+    /**
+     * Create a new AsciiArtGenerator instance
+     *
+     * @param options - Generator options
+     */
+    constructor(options?: {
+        boxWidth?: number;
+    });
+    /**
+     * Generate a flow chart for a sequence of function executions
+     *
+     * @param executions - Array of execution data
+     * @returns ASCII art flow chart
+     */
+    generateFlowChart(executions: ExecutionData[]): string;
+    /**
+     * Generate a box for a function execution
+     *
+     * @param execution - The execution data
+     * @returns ASCII art box
+     */
+    private generateFunctionBox;
+    /**
+     * Generate an arrow between function boxes
+     *
+     * @param levelDiff - Difference in nesting level
+     * @returns ASCII art arrow
+     */
+    private generateArrow;
+    /**
+     * Format memory usage in a human-readable format
+     *
+     * @param bytes - Memory usage in bytes
+     * @returns Formatted memory usage
+     */
+    private formatMemory;
+}