tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/libs/tools/TinyDebugger.cjs

@@ -4,17 +4,81 @@ var events = require('events');
 var objChecker = require('../../basics/objChecker.cjs');
 var browserDetector = require('../../basics/browserDetector.cjs');
 
+/**
+ * @typedef {Object} DebuggerConstructor
+ * @property {Partial<Console>} logger - A custom logger (must implement Console methods).
+ * @property {string} id - The unique identifier for this debugger instance.
+ * @property {boolean} [autoHideId=false] - Whether to hide the instance id whenever a sub id is set.
+ * @property {boolean} debugMode - Whether to enable internal debug logging.
+ * @property {boolean} [canEmitLogs=false] - Whether to emit debug events to listeners.
+ * @property {boolean} [useLogColors=false] - Whether to enable log color support.
+ */
+
+/**
+ * A `console`-compatible facade. Every method delegates to a TinyDebugger instance.
+ * @typedef {Object} ConsoleFacade
+ * @property {(...data: any[]) => void} log - Writes a log message.
+ * @property {(...data: any[]) => void} info - Writes an informational message.
+ * @property {(...data: any[]) => void} warn - Writes a warning message.
+ * @property {(...data: any[]) => void} error - Writes an error message.
+ * @property {(...data: any[]) => void} debug - Writes a debug message.
+ * @property {(...data: any[]) => void} dirxml - Writes an XML representation.
+ * @property {(...data: any[]) => void} group - Starts a log group.
+ * @property {(...data: any[]) => void} groupCollapsed - Starts a collapsed log group.
+ * @property {(...data: any[]) => void} trace - Writes a stack trace.
+ * @property {(condition: boolean, ...data: any[]) => void} assert - Logs when the condition is false.
+ * @property {(item: any, options?: import('util').InspectOptions) => void} dir - Logs an object.
+ * @property {(tabularData: any, properties?: string[]) => void} table - Logs a table.
+ * @property {() => void} clear - Clears the console.
+ * @property {() => void} groupEnd - Ends the current log group.
+ * @property {(label?: string) => void} count - Logs the call count for a label.
+ * @property {(label?: string) => void} countReset - Resets the counter for a label.
+ * @property {(label?: string) => void} time - Starts a timer.
+ * @property {(label?: string) => void} timeEnd - Stops a timer.
+ * @property {(label?: string, ...data: any[]) => void} timeLog - Logs the current timer value.
+ * @property {(label?: string) => void} timeStamp - Adds a timestamp marker.
+ * @property {(label?: string) => void} profile - Starts a profiler.
+ * @property {(label?: string) => void} profileEnd - Stops a profiler.
+ */
+
+/**
+ * Event map for {@link TinyDebugger}.
+ *
+ * `TinyDebugger` is a base class that is widely extended, so the event map is kept
+ * open (`Record<string, ...>`) to allow subclasses to emit their own events while
+ * still providing autocomplete for the well-known debug events.
+ *
+ * @typedef {{
+ *   setLogSubId: (value: string) => void,
+ *   setUseLogColors: (value: boolean) => void,
+ *   setDebugMode: (value: boolean) => void,
+ *   'debug:clear': () => void,
+ *   'debug:groupEnd': () => void,
+ *   'debug:logLabel': (logType: string, label?: string) => void,
+ *   'debug:timeLog': (label?: string, ...args: any[]) => void,
+ *   'debug:assert': (condition?: boolean, ...args: any[]) => void,
+ *   'debug:dir': (item?: any, options?: any) => void,
+ *   'debug:table': (tabularData?: any, properties?: string[]) => void,
+ *   'debug:log': (prefix: string, message: string, ...args: any[]) => void,
+ * } & Record<string, (...args: any[]) => void>} TinyDebuggerEvents
+ */
+
+/** @type {new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyDebuggerEvents>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * A lightweight debugging utility that wraps console methods and provides event emission.
- * @extends EventEmitter
  */
-class TinyDebugger extends events.EventEmitter {
+class TinyDebugger extends TypedEventEmitter {
   /** @type {Partial<Console>} */
   #logger;
 
   /** @type {string} */
   #logId;
 
+  /** @type {string|null} */
+  #logSubId = null;
+
   /** @type {boolean} */
   #canEmitLogs;
 
@@ -24,6 +88,9 @@ class TinyDebugger extends events.EventEmitter {
   /** @type {boolean} */
   #useLogColors;
 
+  /** @type {boolean} */
+  #autoHideId;
+
   /**
    * Colors (ANSI Escape Codes)
    * @type {Map<string, string>}
@@ -35,6 +102,8 @@ class TinyDebugger extends events.EventEmitter {
     ['warn', '\x1b[33m'], // Yellow
     ['error', '\x1b[31m'], // Red
     ['debug', '\x1b[35m'], // Magenta
+    ['main_class', '\x1b[34m'], // Blue
+    ['sub_class', '\x1b[32m'], // Green
     ['reset', '\x1b[0m'], // Reset
 
     // Color names mapping (for manual usage via _color_)
@@ -63,15 +132,17 @@ class TinyDebugger extends events.EventEmitter {
 
   /**
    * Creates an instance of TinyDebugger.
-   * @param {Object} config - The configuration object.
-   * @param {Partial<Console>} config.logger - A custom logger (must implement Console methods).
-   * @param {string} config.id - The unique identifier for this debugger instance.
-   * @param {boolean} config.debugMode - Whether to enable internal debug logging.
-   * @param {boolean} [config.canEmitLogs=false] - Whether to emit debug events to listeners.
-   * @param {boolean} [config.useLogColors=false] - Whether to enable log color support.
+   * @param {DebuggerConstructor} config - The configuration object.
    * @throws {TypeError} If parameters do not match the required types.
    */
-  constructor({ logger, id, debugMode, canEmitLogs = false, useLogColors = false }) {
+  constructor({
+    logger,
+    id,
+    debugMode,
+    canEmitLogs = false,
+    useLogColors = false,
+    autoHideId = false,
+  }) {
     super();
     if (!objChecker.isValidObj(logger)) {
       throw new TypeError('Logger must be an object that implements the Console interface.');
@@ -88,11 +159,15 @@ class TinyDebugger extends events.EventEmitter {
     if (typeof useLogColors !== 'boolean') {
       throw new TypeError('useLogColors must be a boolean.');
     }
+    if (typeof autoHideId !== 'boolean') {
+      throw new TypeError('autoHideId must be a boolean.');
+    }
 
     this.#logId = id;
     this.#logger = logger;
     this.#debugMode = debugMode;
     this.#canEmitLogs = canEmitLogs;
+    this.#autoHideId = autoHideId;
     this.#useLogColors = browserDetector.browserIs() !== 'firefox' ? useLogColors : false;
 
     this.log('info', `Emit logs of debug mode set to: ${this.#debugMode ? 'ON' : 'OFF'}`);
@@ -106,6 +181,33 @@ class TinyDebugger extends events.EventEmitter {
     return this.#logId;
   }
 
+  /**
+   * @returns {string} The instance debug sub id.
+   */
+  get logSubId() {
+    if (typeof this.#logSubId !== 'string') {
+      throw new Error(
+        'logSubId has not been set yet. Assign a string to "logSubId" before reading it.',
+      );
+    }
+    return this.#logSubId;
+  }
+
+  /**
+   * @param {string} value - The new instance debug sub id.
+   * @throws {Error} If the sub id has not been set yet.
+   */
+  set logSubId(value) {
+    if (typeof value !== 'string') {
+      throw new TypeError(`logSubId must be a string. Received: ${typeof value}.`);
+    }
+    if (this.#logSubId !== null) {
+      throw new Error(`logSubId is already set to "${this.#logSubId}" and cannot be reassigned.`);
+    }
+    this.#logSubId = value;
+    this.emit('setLogSubId', value);
+  }
+
   /**
    * @returns {boolean} Whether event emission is enabled.
    */
@@ -130,7 +232,7 @@ class TinyDebugger extends events.EventEmitter {
     }
     this.#useLogColors = value;
     this.log('info', `Log Colors usage mode set to: ${this.#useLogColors ? 'ON' : 'OFF'}`);
-    this.emit('setDebugMode', value);
+    this.emit('setUseLogColors', value);
   }
 
   /**
@@ -211,6 +313,15 @@ class TinyDebugger extends events.EventEmitter {
     return result;
   }
 
+  /**
+   * Internal method to apply prefix and color replacements.
+   * @param {string} text - The text to format.
+   * @returns {string} The formatted text.
+   */
+  _applyLogFormatting(text) {
+    return this.#applyFormatting(text);
+  }
+
   /**
    * Clears the console.
    * @returns {void|undefined}
@@ -270,7 +381,7 @@ class TinyDebugger extends events.EventEmitter {
 
   /**
    * Starts a timer with a label.
-   * @param {string} label - The label for the timer.
+   * @param {string} [label] - The label for the timer.
    * @param {...any} args - Additional arguments for the timer.
    * @throws {TypeError} If label is not a string.
    * @returns {void}
@@ -285,7 +396,7 @@ class TinyDebugger extends events.EventEmitter {
 
   /**
    * Asserts a condition and logs a message if the condition is false.
-   * @param {boolean} condition - The condition to evaluate.
+   * @param {boolean} [condition] - The condition to evaluate.
    * @param {...any} args - Arguments to log if the condition is false.
    * @returns {void}
    */
@@ -299,7 +410,7 @@ class TinyDebugger extends events.EventEmitter {
 
   /**
    * Logs an element as a JavaScript object.
-   * @param {any} item - The object to inspect.
+   * @param {any} [item] - The object to inspect.
    * @param {import('util').InspectOptions} [options] - Inspection options.
    * @returns {void}
    */
@@ -311,7 +422,7 @@ class TinyDebugger extends events.EventEmitter {
 
   /**
    * Displays a table of objects.
-   * @param {any} tabularData - The data to be displayed in a table.
+   * @param {any} [tabularData] - The data to be displayed in a table.
    * @param {string[]} [properties] - The properties (columns) to display.
    * @throws {TypeError} If properties is provided but is not an array of strings.
    * @returns {void}
@@ -360,21 +471,71 @@ class TinyDebugger extends events.EventEmitter {
     }
 
     let prefix = this.#logId;
+    let subPrefix = this.#logSubId ?? '';
     let formattedMessage = message;
+    const showId = !this.#autoHideId || typeof this.#logSubId !== 'string';
 
-    prefix = this.#applyFormatting(prefix);
+    prefix = showId ? this.#applyFormatting(prefix) : '';
+    if (subPrefix) subPrefix = this.#applyFormatting(subPrefix);
     formattedMessage = this.#applyFormatting(formattedMessage);
+    const fullPrefix = `${prefix}${subPrefix ? (showId ? ` ${subPrefix}` : subPrefix) : ''}`;
 
     const logFunc = this.#logger[logType] ? this.#logger[logType] : console[logType];
 
     if (logFunc) {
-      if (this.#canEmitLogs) this.emit('debug:log', prefix, formattedMessage, ...args);
-      return logFunc(prefix, formattedMessage, ...args);
+      if (this.#canEmitLogs) this.emit('debug:log', fullPrefix, formattedMessage, ...args);
+      return logFunc(fullPrefix, formattedMessage, ...args);
     } else {
-      if (this.#canEmitLogs) this.emit('debug:log', prefix, formattedMessage, ...args);
-      return console.log(prefix, formattedMessage, ...args);
+      if (this.#canEmitLogs) this.emit('debug:log', fullPrefix, formattedMessage, ...args);
+      return console.log(fullPrefix, formattedMessage, ...args);
     }
   }
+
+  /**
+   * Forwards a `console`-style call to the internal `log` method.
+   * @param {'log' | 'info' | 'warn' | 'error' | 'debug' | 'dirxml' | 'group' | 'groupCollapsed' | 'trace'} logType - The console method to use.
+   * @param {any[]} data - The arguments forwarded to the logger.
+   * @returns {void}
+   */
+  #forwardLog(logType, data) {
+    const [message = '', ...rest] = data;
+    return typeof message === 'string'
+      ? this.log(logType, message, ...rest)
+      : this.log(logType, '', message, ...rest);
+  }
+
+  /**
+   * Builds a `console`-compatible facade bound to this instance.
+   * Every call is routed through the existing logging methods, so formatting,
+   * debug mode and event emission keep working without extra code.
+   * @returns {ConsoleFacade} A `console`-compatible object bound to this instance.
+   */
+  toConsole() {
+    return {
+      log: (...data) => this.#forwardLog('log', data),
+      info: (...data) => this.#forwardLog('info', data),
+      warn: (...data) => this.#forwardLog('warn', data),
+      error: (...data) => this.#forwardLog('error', data),
+      debug: (...data) => this.#forwardLog('debug', data),
+      dirxml: (...data) => this.#forwardLog('dirxml', data),
+      group: (...data) => this.#forwardLog('group', data),
+      groupCollapsed: (...data) => this.#forwardLog('groupCollapsed', data),
+      trace: (...data) => this.#forwardLog('trace', data),
+      assert: (condition, ...data) => this.logAssert(condition, ...data),
+      dir: (item, options) => this.logDir(item, options),
+      table: (tabularData, properties) => this.logTable(tabularData, properties),
+      clear: () => this.logClear(),
+      groupEnd: () => this.logGroupEnd(),
+      count: (label) => this.logLabel('count', label),
+      countReset: (label) => this.logLabel('countReset', label),
+      time: (label) => this.logLabel('time', label),
+      timeEnd: (label) => this.logLabel('timeEnd', label),
+      timeLog: (label, ...data) => this.logTimeLabel(label, ...data),
+      timeStamp: (label) => this.logLabel('timeStamp', label),
+      profile: (label) => this.logLabel('profile', label),
+      profileEnd: (label) => this.logLabel('profileEnd', label),
+    };
+  }
 }
 
 module.exports = TinyDebugger;

package/dist/v1/libs/tools/TinyDebugger.d.mts

@@ -1,31 +1,214 @@
-import { EventEmitter } from 'events';
+export type DebuggerConstructor = {
+    /**
+     * - A custom logger (must implement Console methods).
+     */
+    logger: Partial<Console>;
+    /**
+     * - The unique identifier for this debugger instance.
+     */
+    id: string;
+    /**
+     * - Whether to hide the instance id whenever a sub id is set.
+     */
+    autoHideId?: boolean;
+    /**
+     * - Whether to enable internal debug logging.
+     */
+    debugMode: boolean;
+    /**
+     * - Whether to emit debug events to listeners.
+     */
+    canEmitLogs?: boolean;
+    /**
+     * - Whether to enable log color support.
+     */
+    useLogColors?: boolean;
+};
+export type ConsoleFacade = {
+    /**
+     * - Writes a log message.
+     */
+    log: (...data: any[]) => void;
+    /**
+     * - Writes an informational message.
+     */
+    info: (...data: any[]) => void;
+    /**
+     * - Writes a warning message.
+     */
+    warn: (...data: any[]) => void;
+    /**
+     * - Writes an error message.
+     */
+    error: (...data: any[]) => void;
+    /**
+     * - Writes a debug message.
+     */
+    debug: (...data: any[]) => void;
+    /**
+     * - Writes an XML representation.
+     */
+    dirxml: (...data: any[]) => void;
+    /**
+     * - Starts a log group.
+     */
+    group: (...data: any[]) => void;
+    /**
+     * - Starts a collapsed log group.
+     */
+    groupCollapsed: (...data: any[]) => void;
+    /**
+     * - Writes a stack trace.
+     */
+    trace: (...data: any[]) => void;
+    /**
+     * - Logs when the condition is false.
+     */
+    assert: (condition: boolean, ...data: any[]) => void;
+    /**
+     * - Logs an object.
+     */
+    dir: (item: any, options?: import('util').InspectOptions) => void;
+    /**
+     * - Logs a table.
+     */
+    table: (tabularData: any, properties?: string[]) => void;
+    /**
+     * - Clears the console.
+     */
+    clear: () => void;
+    /**
+     * - Ends the current log group.
+     */
+    groupEnd: () => void;
+    /**
+     * - Logs the call count for a label.
+     */
+    count: (label?: string) => void;
+    /**
+     * - Resets the counter for a label.
+     */
+    countReset: (label?: string) => void;
+    /**
+     * - Starts a timer.
+     */
+    time: (label?: string) => void;
+    /**
+     * - Stops a timer.
+     */
+    timeEnd: (label?: string) => void;
+    /**
+     * - Logs the current timer value.
+     */
+    timeLog: (label?: string, ...data: any[]) => void;
+    /**
+     * - Adds a timestamp marker.
+     */
+    timeStamp: (label?: string) => void;
+    /**
+     * - Starts a profiler.
+     */
+    profile: (label?: string) => void;
+    /**
+     * - Stops a profiler.
+     */
+    profileEnd: (label?: string) => void;
+};
+export type TinyDebuggerEvents = {
+    setLogSubId: (value: string) => void;
+    setUseLogColors: (value: boolean) => void;
+    setDebugMode: (value: boolean) => void;
+    *   'debug:clear': () => void;
+    *   'debug:groupEnd': () => void;
+    *   'debug:logLabel': (logType: string, label?: string) => void;
+    *   'debug:timeLog': (label?: string, ...args: any[]) => void;
+    *   'debug:assert': (condition?: boolean, ...args: any[]) => void;
+    *   'debug:dir': (item?: any, options?: any) => void;
+    *   'debug:table': (tabularData?: any, properties?: string[]) => void;
+    *   'debug:log': (prefix: string, message: string, ...args: any[]) => void;
+} & Record<string, (...args: any[]) => void>;
+/**
+ * @typedef {Object} DebuggerConstructor
+ * @property {Partial<Console>} logger - A custom logger (must implement Console methods).
+ * @property {string} id - The unique identifier for this debugger instance.
+ * @property {boolean} [autoHideId=false] - Whether to hide the instance id whenever a sub id is set.
+ * @property {boolean} debugMode - Whether to enable internal debug logging.
+ * @property {boolean} [canEmitLogs=false] - Whether to emit debug events to listeners.
+ * @property {boolean} [useLogColors=false] - Whether to enable log color support.
+ */
+/**
+ * A `console`-compatible facade. Every method delegates to a TinyDebugger instance.
+ * @typedef {Object} ConsoleFacade
+ * @property {(...data: any[]) => void} log - Writes a log message.
+ * @property {(...data: any[]) => void} info - Writes an informational message.
+ * @property {(...data: any[]) => void} warn - Writes a warning message.
+ * @property {(...data: any[]) => void} error - Writes an error message.
+ * @property {(...data: any[]) => void} debug - Writes a debug message.
+ * @property {(...data: any[]) => void} dirxml - Writes an XML representation.
+ * @property {(...data: any[]) => void} group - Starts a log group.
+ * @property {(...data: any[]) => void} groupCollapsed - Starts a collapsed log group.
+ * @property {(...data: any[]) => void} trace - Writes a stack trace.
+ * @property {(condition: boolean, ...data: any[]) => void} assert - Logs when the condition is false.
+ * @property {(item: any, options?: import('util').InspectOptions) => void} dir - Logs an object.
+ * @property {(tabularData: any, properties?: string[]) => void} table - Logs a table.
+ * @property {() => void} clear - Clears the console.
+ * @property {() => void} groupEnd - Ends the current log group.
+ * @property {(label?: string) => void} count - Logs the call count for a label.
+ * @property {(label?: string) => void} countReset - Resets the counter for a label.
+ * @property {(label?: string) => void} time - Starts a timer.
+ * @property {(label?: string) => void} timeEnd - Stops a timer.
+ * @property {(label?: string, ...data: any[]) => void} timeLog - Logs the current timer value.
+ * @property {(label?: string) => void} timeStamp - Adds a timestamp marker.
+ * @property {(label?: string) => void} profile - Starts a profiler.
+ * @property {(label?: string) => void} profileEnd - Stops a profiler.
+ */
+/**
+ * Event map for {@link TinyDebugger}.
+ *
+ * `TinyDebugger` is a base class that is widely extended, so the event map is kept
+ * open (`Record<string, ...>`) to allow subclasses to emit their own events while
+ * still providing autocomplete for the well-known debug events.
+ *
+ * @typedef {{
+ *   setLogSubId: (value: string) => void,
+ *   setUseLogColors: (value: boolean) => void,
+ *   setDebugMode: (value: boolean) => void,
+ *   'debug:clear': () => void,
+ *   'debug:groupEnd': () => void,
+ *   'debug:logLabel': (logType: string, label?: string) => void,
+ *   'debug:timeLog': (label?: string, ...args: any[]) => void,
+ *   'debug:assert': (condition?: boolean, ...args: any[]) => void,
+ *   'debug:dir': (item?: any, options?: any) => void,
+ *   'debug:table': (tabularData?: any, properties?: string[]) => void,
+ *   'debug:log': (prefix: string, message: string, ...args: any[]) => void,
+ * } & Record<string, (...args: any[]) => void>} TinyDebuggerEvents
+ */
+/** @type {new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyDebuggerEvents>} */
+declare const TypedEventEmitter: new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyDebuggerEvents>;
 /**
  * A lightweight debugging utility that wraps console methods and provides event emission.
- * @extends EventEmitter
  */
-declare class TinyDebugger extends EventEmitter {
+declare class TinyDebugger extends TypedEventEmitter {
     #private;
     /**
      * Creates an instance of TinyDebugger.
-     * @param {Object} config - The configuration object.
-     * @param {Partial<Console>} config.logger - A custom logger (must implement Console methods).
-     * @param {string} config.id - The unique identifier for this debugger instance.
-     * @param {boolean} config.debugMode - Whether to enable internal debug logging.
-     * @param {boolean} [config.canEmitLogs=false] - Whether to emit debug events to listeners.
-     * @param {boolean} [config.useLogColors=false] - Whether to enable log color support.
+     * @param {DebuggerConstructor} config - The configuration object.
      * @throws {TypeError} If parameters do not match the required types.
      */
-    constructor({ logger, id, debugMode, canEmitLogs, useLogColors }: {
-        logger: Partial<Console>;
-        id: string;
-        debugMode: boolean;
-        canEmitLogs?: boolean;
-        useLogColors?: boolean;
-    });
+    constructor({ logger, id, debugMode, canEmitLogs, useLogColors, autoHideId, }: DebuggerConstructor);
     /**
      * @returns {string} The instance debug id.
      */
     get logId(): string;
+    /**
+     * @returns {string} The instance debug sub id.
+     */
+    get logSubId(): string;
+    /**
+     * @param {string} value - The new instance debug sub id.
+     * @throws {Error} If the sub id has not been set yet.
+     */
+    set logSubId(value: string);
     /**
      * @returns {boolean} Whether event emission is enabled.
      */
@@ -70,6 +253,12 @@ declare class TinyDebugger extends EventEmitter {
      * @param {string} id - The shortcut ID to remove.
      */
     _removeLogPrefix(id: string): void;
+    /**
+     * Internal method to apply prefix and color replacements.
+     * @param {string} text - The text to format.
+     * @returns {string} The formatted text.
+     */
+    _applyLogFormatting(text: string): string;
     /**
      * Clears the console.
      * @returns {void|undefined}
@@ -90,34 +279,34 @@ declare class TinyDebugger extends EventEmitter {
     logLabel(logType: 'count' | 'countReset' | 'time' | 'timeEnd' | 'profile' | 'profileEnd' | 'timeStamp', label?: string): void;
     /**
      * Starts a timer with a label.
-     * @param {string} label - The label for the timer.
+     * @param {string} [label] - The label for the timer.
      * @param {...any} args - Additional arguments for the timer.
      * @throws {TypeError} If label is not a string.
      * @returns {void}
      */
-    logTimeLabel(label: string, ...args: any[]): void;
+    logTimeLabel(label?: string, ...args: any[]): void;
     /**
      * Asserts a condition and logs a message if the condition is false.
-     * @param {boolean} condition - The condition to evaluate.
+     * @param {boolean} [condition] - The condition to evaluate.
      * @param {...any} args - Arguments to log if the condition is false.
      * @returns {void}
      */
-    logAssert(condition: boolean, ...args: any[]): void;
+    logAssert(condition?: boolean, ...args: any[]): void;
     /**
      * Logs an element as a JavaScript object.
-     * @param {any} item - The object to inspect.
+     * @param {any} [item] - The object to inspect.
      * @param {import('util').InspectOptions} [options] - Inspection options.
      * @returns {void}
      */
-    logDir(item: any, options?: import('util').InspectOptions): void;
+    logDir(item?: any, options?: import('util').InspectOptions): void;
     /**
      * Displays a table of objects.
-     * @param {any} tabularData - The data to be displayed in a table.
+     * @param {any} [tabularData] - The data to be displayed in a table.
      * @param {string[]} [properties] - The properties (columns) to display.
      * @throws {TypeError} If properties is provided but is not an array of strings.
      * @returns {void}
      */
-    logTable(tabularData: any, properties?: string[]): void;
+    logTable(tabularData?: any, properties?: string[]): void;
     /**
      * Internal helper to handle debug logging.
      * @param {'log' | 'info' | 'warn' | 'error' | 'debug' | 'dirxml' | 'group' | 'groupCollapsed' | 'trace'} logType - The console method to use.
@@ -127,6 +316,13 @@ declare class TinyDebugger extends EventEmitter {
      * @returns {void}
      */
     log(logType: 'log' | 'info' | 'warn' | 'error' | 'debug' | 'dirxml' | 'group' | 'groupCollapsed' | 'trace', message: string, ...args: any[]): void;
+    /**
+     * Builds a `console`-compatible facade bound to this instance.
+     * Every call is routed through the existing logging methods, so formatting,
+     * debug mode and event emission keep working without extra code.
+     * @returns {ConsoleFacade} A `console`-compatible object bound to this instance.
+     */
+    toConsole(): ConsoleFacade;
 }
 export default TinyDebugger;
 //# sourceMappingURL=TinyDebugger.d.mts.map

package/dist/v1/libs/tools/TinyDebugger.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyDebugger.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyDebugger.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC;;;GAGG;AACH,cAAM,YAAa,SAAQ,YAAY;;IAqDrC;;;;;;;;;OASG;IACH,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,WAAmB,EAAE,YAAoB,EAAE,EAP7E;QAAiC,MAAM,EAA/B,OAAO,CAAC,OAAO,CAAC,CACxB;QAAuB,EAAE,EAAjB,MAAM,CACd;QAAwB,SAAS,EAAzB,OAAO,CACf;QAAyB,WAAW,AAApC,CACA,EADQ,OAAO,CACf;QAAyB,YAAY,AAArC,CACA,EADQ,OAAO,CACf;KAE6E,EA0B/E;IAED;;OAEG;IACH,IAAI,KAAK,IAFI,MAAM,CAIlB;IAED;;OAEG;IACH,IAAI,WAAW,IAFF,OAAO,CAInB;IAED;;OAEG;IACH,IAAI,YAAY,IAFH,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,YAAY,CAAC,KAAK,EAHX,OAGW,EAOrB;IAED;;OAEG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,SAAS,CAAC,KAAK,EAHR,OAGQ,EAOlB;IAED;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAHJ,MAGI,EAAE,IAAI,EAFV,MAEU,QAEpB;IAED;;;OAGG;IACH,eAAe,CAAC,EAAE,EAFP,MAEO,QAEjB;IAED;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAHL,MAGK,EAAE,IAAI,EAFX,MAEW,QAErB;IAED;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAFR,MAEQ,QAElB;IA0BD;;;OAGG;IACH,QAAQ,IAFK,IAAI,GAAC,SAAS,CAM1B;IAED;;;OAGG;IACH,WAAW,IAFE,IAAI,GAAC,SAAS,CAM1B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EALL,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAKpE,EAAE,KAAK,AAJpB,CACA,EADQ,MAIY,GAFV,IAAI,CA8BhB;IAED;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EALP,MAKO,EAAE,GAAG,IAAI,EAJb,GAAG,EAIU,GAFd,IAAI,CAQhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAJR,OAIQ,EAAE,GAAG,IAAI,EAHd,GAAG,EAGW,GAFf,IAAI,CAQhB;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAJA,GAIA,EAAE,OAAO,AAHjB,CACA,EADQ,OAAO,MAAM,EAAE,cAGN,GAFP,IAAI,CAMhB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EALT,GAKS,EAAE,UAAU,AAJ7B,CACA,EADQ,MAAM,EAIe,GAFnB,IAAI,CAchB;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EANA,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAMtF,EAAE,OAAO,EALT,MAKS,EAAE,GAAG,IAAI,EAJf,GAAG,EAIY,GAFhB,IAAI,CAsChB;CACF;eAEc,YAAY"}
+{"version":3,"file":"TinyDebugger.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyDebugger.mjs"],"names":[],"mappings":"AAKG,YAAkB,mBAAmB,GACrC;;;;IAA6B,MAAM,EAAxB,OAAO,CAAC,OAAO,CAAC,CAC3B;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAAqB,UAAU,AAA/B,CACA,EADW,OAAO,CAClB;;;;IAAoB,SAAS,EAAlB,OAAO,CAClB;;;;IAAqB,WAAW,AAAhC,CACA,EADW,OAAO,CAClB;;;;IAAqB,YAAY,AAAjC,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AAIE,YAAkB,aAAa,GAC/B;;;;IAAqC,GAAG,EAA7B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,IAAI,EAA9B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,IAAI,EAA9B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,KAAK,EAA/B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,KAAK,EAA/B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,MAAM,EAAhC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,KAAK,EAA/B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,cAAc,EAAxC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAqC,KAAK,EAA/B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnC;;;;IAAyD,MAAM,EAApD,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACvD;;;;IAAyE,GAAG,EAAjE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,cAAc,KAAK,IAAI,CACvE;;;;IAA8D,KAAK,EAAxD,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAC5D;;;;IAAuB,KAAK,EAAjB,MAAM,IAAI,CACrB;;;;IAAuB,QAAQ,EAApB,MAAM,IAAI,CACrB;;;;IAAqC,KAAK,EAA/B,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqC,UAAU,EAApC,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqC,IAAI,EAA9B,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqC,OAAO,EAAjC,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqD,OAAO,EAAjD,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CACnD;;;;IAAqC,SAAS,EAAnC,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqC,OAAO,EAAjC,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACnC;;;;IAAqC,UAAU,EAApC,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CACrC;CAAA,CAAA;AASE,YAY8C,kBAAkB,GAZtD;IACR,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,mBAAmB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC9D,kBAAkB,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAClE,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACrD,iBAAiB,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtE,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACxE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAAoB;AAxDnE;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uGAAuG;AACvG,QAAA,MAAM,iBAAiB,EADZ,UAAU,OAAO,8BAA8B,EAAE,mBAAmB,CAAC,kBAAkB,CACvC,CAAC;AAE5D;;GAEG;AACH,cAAM,YAAa,SAAQ,iBAAiB;;IA6D1C;;;;OAIG;IACH,YAAY,EACV,MAAM,EACN,EAAE,EACF,SAAS,EACT,WAAmB,EACnB,YAAoB,EACpB,UAAkB,GACnB,EAVU,mBAUV,EA8BA;IAED;;OAEG;IACH,IAAI,KAAK,IAFI,MAAM,CAIlB;IAED;;OAEG;IACH,IAAI,QAAQ,IAFC,MAAM,CASlB;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAAK,EAHP,MAGO,EASjB;IAED;;OAEG;IACH,IAAI,WAAW,IAFF,OAAO,CAInB;IAED;;OAEG;IACH,IAAI,YAAY,IAFH,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,YAAY,CAAC,KAAK,EAHX,OAGW,EAOrB;IAED;;OAEG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,SAAS,CAAC,KAAK,EAHR,OAGQ,EAOlB;IAED;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAHJ,MAGI,EAAE,IAAI,EAFV,MAEU,QAEpB;IAED;;;OAGG;IACH,eAAe,CAAC,EAAE,EAFP,MAEO,QAEjB;IAED;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAHL,MAGK,EAAE,IAAI,EAFX,MAEW,QAErB;IAED;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAFR,MAEQ,QAElB;IA0BD;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAHb,MAGa,GAFX,MAAM,CAIlB;IAED;;;OAGG;IACH,QAAQ,IAFK,IAAI,GAAC,SAAS,CAM1B;IAED;;;OAGG;IACH,WAAW,IAFE,IAAI,GAAC,SAAS,CAM1B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EALL,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAKpE,EAAE,KAAK,AAJpB,CACA,EADQ,MAIY,GAFV,IAAI,CA8BhB;IAED;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,AALf,CACA,EADQ,MAKO,EAAE,GAAG,IAAI,EAJb,GAAG,EAIU,GAFd,IAAI,CAQhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,AAJhB,CACA,EADQ,OAIQ,EAAE,GAAG,IAAI,EAHd,GAAG,EAGW,GAFf,IAAI,CAQhB;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,AAJR,CACA,EADQ,GAIA,EAAE,OAAO,AAHjB,CACA,EADQ,OAAO,MAAM,EAAE,cAGN,GAFP,IAAI,CAMhB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,AALjB,CACA,EADQ,GAKS,EAAE,UAAU,AAJ7B,CACA,EADQ,MAAM,EAIe,GAFnB,IAAI,CAchB;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EANA,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAMtF,EAAE,OAAO,EALT,MAKS,EAAE,GAAG,IAAI,EAJf,GAAG,EAIY,GAFhB,IAAI,CA0ChB;IAeD;;;;;OAKG;IACH,SAAS,IAFI,aAAa,CA2BzB;CACF;eAEc,YAAY"}