@mks2508/better-logger 4.0.0 → 5.0.0

package/dist/chunks/{Logger-D-gmmgR2.js → Logger-BZ7B7OXE.js}

@@ -1,4 +1,6 @@
-import { C as getAdaptiveColor, F as ADAPTIVE_COLORS, b as StyleBuilder, j as getANSIForeground, A as ANSI, u as getTerminalWidth, G as BUFFER_LIMITS, H as generateLogId, I as parseTimeInput, J as formatDisplayTime, K as safeStringify, M as escapeHtml, N as EXPORT_FORMATS, D as DEFAULT_CONFIG$1, O as setupThemeChangeListener, o as getEnvironment, p as parseStackTrace, f as formatTimestamp$1, y as createStyledOutput, t as getColorCapability, S as StylePresets } from "./environment-COWvu6Wz.js";
+import { h as getAdaptiveColor, A as ADAPTIVE_COLORS, b as StyleBuilder, j as BUFFER_LIMITS, k as generateLogId, l as parseTimeInput, m as formatDisplayTime, n as safeStringify, o as escapeHtml, q as EXPORT_FORMATS, D as DEFAULT_CONFIG$1, r as setupThemeChangeListener, p as parseStackTrace, f as formatTimestamp, c as createStyledOutput, S as StylePresets, C as CLI_LEVEL_MAP } from "./environment-C1xxvc8l.js";
+import { i as getEnvironment, k as getColorCapability, j as isRunningInTerminal } from "./color-converter-_Xdmsy7E.js";
+import { c as formatBadge, k as renderStep, l as renderDivider, m as renderBox, n as renderTable, N as NoopSpinner, S as SpinnerManager, o as ServerFallback, q as renderHeader } from "./cli-module-ClIJmaT8.js";
 const DEFAULT_CONFIG = {
   maxDepth: 5,
   circular: "placeholder",
@@ -1570,157 +1572,6 @@ function getAvailablePresets() {
 function hasPreset(name) {
   return name in SMART_PRESETS;
 }
-function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
-}
-function getVisibleLength(str) {
-  return stripAnsi(str).length;
-}
-function padToWidth(str, width, align = "left") {
-  const visibleLen = getVisibleLength(str);
-  if (visibleLen >= width) return str;
-  const padding = width - visibleLen;
-  switch (align) {
-    case "right":
-      return " ".repeat(padding) + str;
-    case "center":
-      const leftPad = Math.floor(padding / 2);
-      const rightPad = padding - leftPad;
-      return " ".repeat(leftPad) + str + " ".repeat(rightPad);
-    case "left":
-    default:
-      return str + " ".repeat(padding);
-  }
-}
-function formatWithRightAlign(leftContent, rightContent, maxWidth) {
-  const width = maxWidth ?? getTerminalWidth();
-  const leftLen = getVisibleLength(leftContent);
-  const rightLen = getVisibleLength(rightContent);
-  const gap = width - leftLen - rightLen;
-  if (gap <= 1) {
-    return `${leftContent} ${rightContent}`;
-  }
-  return `${leftContent}${" ".repeat(gap)}${rightContent}`;
-}
-function formatColumns(columns, maxWidth, colorCapability = "full") {
-  const width = maxWidth ?? getTerminalWidth();
-  columns.length;
-  const columnsWithWidths = columns.map((col, idx) => {
-    if (col.width) return { ...col, calculatedWidth: col.width };
-    const remainingWidth = width - columns.filter((c, i) => i !== idx && c.width).reduce((sum, c) => sum + (c.width ?? 0), 0);
-    const autoColumns = columns.filter((c) => !c.width).length;
-    const calculatedWidth = Math.floor(remainingWidth / autoColumns);
-    return { ...col, calculatedWidth };
-  });
-  return columnsWithWidths.map((col) => {
-    let content = col.content;
-    if (col.color && colorCapability !== "none") {
-      const colorCode = getANSIForeground(col.color, colorCapability);
-      content = `${colorCode}${content}${ANSI.reset}`;
-    }
-    return padToWidth(content, col.calculatedWidth, col.align);
-  }).join("");
-}
-function formatKeyValue(obj, colorCapability = "full", options = {}) {
-  const {
-    separator = "  ",
-    keyColor = "#888888",
-    valueColor = "#00ffff"
-  } = options;
-  const entries = Object.entries(obj);
-  if (entries.length === 0) return "";
-  const keyColorCode = colorCapability !== "none" ? getANSIForeground(keyColor, colorCapability) : "";
-  const valueColorCode = colorCapability !== "none" ? getANSIForeground(valueColor, colorCapability) : "";
-  const reset = colorCapability !== "none" ? ANSI.reset : "";
-  return entries.map(([key, value]) => {
-    const valueStr = typeof value === "object" ? JSON.stringify(value) : String(value);
-    return `${keyColorCode}${key}:${reset} ${valueColorCode}${valueStr}${reset}`;
-  }).join(separator);
-}
-function isKeyValueObject(obj) {
-  if (typeof obj !== "object" || obj === null) return false;
-  if (Array.isArray(obj)) return false;
-  const proto = Object.getPrototypeOf(obj);
-  if (proto !== Object.prototype && proto !== null) return false;
-  const values = Object.values(obj);
-  return values.every(
-    (v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null
-  );
-}
-function formatBadge(badge, style = "brackets", colorCapability = "full", color) {
-  const colorCode = color && colorCapability !== "none" ? getANSIForeground(color, colorCapability) : "";
-  const reset = colorCapability !== "none" ? ANSI.reset : "";
-  const bgBlack = colorCapability !== "none" ? ANSI.bg.black : "";
-  const text = badge.toUpperCase();
-  switch (style) {
-    case "rounded":
-      return `${bgBlack}${colorCode}⟨${text}⟩${reset}`;
-    case "plain":
-      return `${colorCode}${text}${reset}`;
-    case "unicode":
-      return `${bgBlack}${colorCode}╭${text}╮${reset}`;
-    case "pill":
-      return `${bgBlack}${colorCode}⦗${text}⦘${reset}`;
-    case "brackets":
-    default:
-      return `${bgBlack}${colorCode}[${text}]${reset}`;
-  }
-}
-function formatTimestamp(date = /* @__PURE__ */ new Date(), format = "time") {
-  switch (format) {
-    case "iso":
-      return date.toISOString();
-    case "date":
-      return date.toISOString().split("T")[0] ?? "";
-    case "time":
-      return date.toTimeString().slice(0, 8);
-    case "timeMs":
-      return date.toTimeString().slice(0, 8) + "." + String(date.getMilliseconds()).padStart(3, "0");
-    case "relative":
-      return formatRelativeTime(date);
-    case "elapsed":
-      return formatElapsedTime(date);
-    case "custom":
-    default:
-      return date.toLocaleTimeString();
-  }
-}
-let startTime = null;
-function formatRelativeTime(date) {
-  if (startTime === null) {
-    startTime = Date.now();
-  }
-  const diff = date.getTime() - startTime;
-  if (diff < 1e3) {
-    return `+${diff}ms`;
-  } else if (diff < 6e4) {
-    return `+${(diff / 1e3).toFixed(1)}s`;
-  } else {
-    const mins = Math.floor(diff / 6e4);
-    const secs = Math.floor(diff % 6e4 / 1e3);
-    return `+${mins}m${secs}s`;
-  }
-}
-function formatElapsedTime(date) {
-  if (startTime === null) {
-    startTime = Date.now();
-  }
-  const diff = date.getTime() - startTime;
-  const hours = Math.floor(diff / 36e5);
-  const mins = Math.floor(diff % 36e5 / 6e4);
-  const secs = Math.floor(diff % 6e4 / 1e3);
-  return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}:${String(secs).padStart(2, "0")}`;
-}
-function resetStartTime() {
-  startTime = Date.now();
-}
-function applyLogOptions(message, options, colorCapability = "full") {
-  let result = message;
-  if (options.rightAlign) {
-    result = formatWithRightAlign(message, options.rightAlign);
-  }
-  return result;
-}
 class ScopedLogger {
   parent;
   scopeName;
@@ -1806,6 +1657,39 @@ class ScopedLogger {
     this.parent.logWithBindings(this.getBindings(), "debug", ...args);
     console.trace(`[${this.scopeName}]`);
   }
+  // ===== CLI PRIMITIVES (v5.0 delegation) =====
+  /** @see Logger.step */
+  step(current, total, message) {
+    this.parent.step(current, total, message);
+  }
+  /** @see Logger.header */
+  header(title, subtitle) {
+    this.parent.header(title, subtitle);
+  }
+  /** @see Logger.divider */
+  divider() {
+    this.parent.divider();
+  }
+  /** @see Logger.blank */
+  blank() {
+    this.parent.blank();
+  }
+  /** @see Logger.box */
+  box(content, options) {
+    this.parent.box(content, options);
+  }
+  /** @see Logger.cliTable */
+  cliTable(rows, options) {
+    this.parent.cliTable(rows, options);
+  }
+  /** @see Logger.spinner */
+  spinner(message) {
+    return this.parent.spinner(message);
+  }
+  /** @see Logger.setCLILevel */
+  setCLILevel(level) {
+    this.parent.setCLILevel(level);
+  }
   _pushContext(context) {
     this.contextStack.push(context);
   }
@@ -3204,6 +3088,10 @@ class Logger {
   serializerRegistry;
   hookManager;
   transportManager;
+  /** Whether CLI primitives (step, box, header, etc.) should be shown @since 5.0.0 */
+  _showPrimitives = true;
+  /** Server-mode fallback for non-TTY environments @since 5.0.0 */
+  _serverFallback;
   /**
    * Crea una nueva instancia del Logger
    * 
@@ -3882,7 +3770,7 @@ class Logger {
     if (!this.shouldLog(level)) return;
     const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;
     const prefix = this.getEffectivePrefix();
-    const timestamp = formatTimestamp$1();
+    const timestamp = formatTimestamp();
     const serializedArgs = args.map((arg) => this.serializerRegistry.serialize(arg));
     let message = serializedArgs.length > 0 ? String(serializedArgs[0]) : "";
     if (this.badgeList.length > 0 && this.displaySettings.showBadges) {
@@ -4069,7 +3957,7 @@ class Logger {
       console.log(finalFormat, ...styles2);
     }
     const metadata = {
-      timestamp: formatTimestamp$1(),
+      timestamp: formatTimestamp(),
       level: "info",
       prefix,
       stackInfo: stackInfo ? stackInfo : void 0
@@ -4214,26 +4102,28 @@ class Logger {
   }
   /**
    * Finaliza un temporizador y muestra el tiempo transcurrido
-   * 
+   *
    * @param {string} label - Etiqueta del temporizador a finalizar
-   * 
+   * @returns {number} Elapsed milliseconds, or -1 if timer not found
+   *
    * @example
    * logger.time('consulta-db');
    * await consultarBaseDatos();
-   * logger.timeEnd('consulta-db'); // ⏱️ Timer ended: consulta-db - 234.56ms
-   * 
+   * const elapsed = logger.timeEnd('consulta-db'); // ⏱️ Timer ended: consulta-db - 234.56ms
+   *
    * @since 0.3.0
    */
   timeEnd(label) {
     const timer = this.timers.get(label);
     if (!timer) {
       this.warn(`Timer '${label}' does not exist`);
-      return;
+      return -1;
     }
     const elapsed = performance.now() - timer.startTime;
     this.timers.delete(label);
     const timerStyle = StylePresets.success().build();
     console.log(`%c⏱️ Timer ended: ${label} - ${elapsed.toFixed(2)}ms`, timerStyle);
+    return elapsed;
   }
   // ===== ADVANCED VISUAL FEATURES =====
   /**
@@ -4352,6 +4242,182 @@ class Logger {
       this.info("Grouped data:", items);
     }
   }
+  // ===== CLI PRIMITIVES (v5.0) =====
+  /**
+   * Displays a step progress indicator in the terminal
+   *
+   * @param {number} current - Current step number
+   * @param {number} total - Total number of steps
+   * @param {string} message - Step description
+   *
+   * @example
+   * logger.step(1, 5, 'Analyzing repository...');
+   * logger.step(2, 5, 'Generating commit message...');
+   *
+   * @since 5.0.0
+   */
+  step(current, total, message) {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().step(current, total, message);
+      return;
+    }
+    const colorCap = getColorCapability();
+    const output = renderStep(current, total, message, colorCap);
+    process.stderr.write(output + "\n");
+  }
+  /**
+   * Displays a styled header with optional subtitle
+   *
+   * @param {string} title - Main title text
+   * @param {string} subtitle - Optional subtitle (rendered dimmed)
+   *
+   * @example
+   * logger.header('Commit Wizard', 'v2.0.0');
+   *
+   * @since 5.0.0
+   */
+  header(title, subtitle) {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().header(title, subtitle);
+      return;
+    }
+    const output = renderHeader(title, subtitle);
+    process.stderr.write(output + "\n");
+  }
+  /**
+   * Displays a horizontal divider line
+   *
+   * @example
+   * logger.divider();
+   *
+   * @since 5.0.0
+   */
+  divider() {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().divider();
+      return;
+    }
+    const output = renderDivider();
+    process.stderr.write(output + "\n");
+  }
+  /**
+   * Outputs a blank line
+   *
+   * @example
+   * logger.blank();
+   *
+   * @since 5.0.0
+   */
+  blank() {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().blank();
+      return;
+    }
+    process.stderr.write("\n");
+  }
+  /**
+   * Renders content inside a bordered box
+   *
+   * @param {string} content - Content string (may contain newlines)
+   * @param {IBoxOptions} options - Box rendering options
+   *
+   * @example
+   * logger.box('3 commits generated\nProvider: Groq', { title: 'Done', borderColor: '#00ff00' });
+   *
+   * @since 5.0.0
+   */
+  box(content, options) {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().box(content, options);
+      return;
+    }
+    const colorCap = getColorCapability();
+    const output = renderBox(content, options, colorCap);
+    process.stderr.write(output + "\n");
+  }
+  /**
+   * Renders an array of objects as a formatted ASCII table.
+   * Note: This is distinct from the existing table() method which uses console.table.
+   *
+   * @param {Record<string, unknown>[]} rows - Array of row objects
+   * @param {ITableOptions} options - Table rendering options
+   *
+   * @example
+   * logger.cliTable([
+   *   { provider: 'Groq', status: 'Available', model: 'llama-3.3-70b' },
+   *   { provider: 'Gemini', status: 'Configured', model: 'gemini-2.5-flash' },
+   * ]);
+   *
+   * @since 5.0.0
+   */
+  cliTable(rows, options) {
+    if (!this._showPrimitives) return;
+    if (!isRunningInTerminal()) {
+      this.getServerFallback().cliTable(rows, options);
+      return;
+    }
+    const colorCap = getColorCapability();
+    const output = renderTable(rows, options, colorCap);
+    process.stderr.write(output + "\n");
+  }
+  /**
+   * Creates a spinner handle for showing progress during async operations.
+   * Returns a NoopSpinner in non-TTY environments.
+   *
+   * @param {string} message - Initial spinner text
+   * @returns {ISpinnerHandle} Spinner controller
+   *
+   * @example
+   * const s = logger.spinner('Analyzing repository...');
+   * s.start();
+   * await analyzeRepo();
+   * s.succeed('Analysis complete (1.2s)');
+   *
+   * @since 5.0.0
+   */
+  spinner(message) {
+    if (!isRunningInTerminal() || this.config.outputMode === "silent") {
+      return new NoopSpinner(message, this);
+    }
+    return new SpinnerManager(message, this.config, this);
+  }
+  /**
+   * Sets the CLI verbosity level, controlling both log verbosity and primitive visibility
+   *
+   * @param {CLILogLevel} level - CLI log level
+   *
+   * @example
+   * logger.setCLILevel('quiet');   // Only errors, no CLI primitives
+   * logger.setCLILevel('verbose'); // Debug logs + all CLI primitives
+   *
+   * @since 5.0.0
+   */
+  setCLILevel(level) {
+    const mapping = CLI_LEVEL_MAP[level];
+    this.setVerbosity(mapping.verbosity);
+    this._showPrimitives = mapping.showPrimitives;
+    this.config.cliLevel = level;
+  }
+  /**
+   * Returns the current CLI log level
+   * @returns {CLILogLevel} Current CLI log level
+   * @since 5.0.0
+   */
+  get cliLevel() {
+    return this.config.cliLevel ?? "normal";
+  }
+  /** Lazily creates the server fallback instance @private */
+  getServerFallback() {
+    if (!this._serverFallback) {
+      this._serverFallback = new ServerFallback(this);
+    }
+    return this._serverFallback;
+  }
   // ===== OUTPUT WRITER SYSTEM =====
   /**
    * Writes formatted output to the configured destination.
@@ -4439,20 +4505,7 @@ export {
   THEME_BANNERS as a,
   TransportManager as b,
   ScopedLogger as c,
-  ContextLogger as d,
-  formatColumns as e,
-  formatWithRightAlign as f,
-  formatKeyValue as g,
-  formatBadge as h,
-  formatTimestamp as i,
-  formatRelativeTime as j,
-  formatElapsedTime as k,
-  isKeyValueObject as l,
-  getVisibleLength as m,
-  applyLogOptions as n,
-  displayInitBanner as o,
-  padToWidth as p,
-  resetStartTime as r,
-  stripAnsi as s
+  displayInitBanner as d,
+  ContextLogger as e
 };
-//# sourceMappingURL=Logger-D-gmmgR2.js.map
+//# sourceMappingURL=Logger-BZ7B7OXE.js.map