@mks2508/better-logger 0.18.2-alpha.1 → 0.18.2-alpha.2

package/dist/types/serializers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../src/types/serializers.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,GAAG,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACpC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAChC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9F,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACpD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC;IACtD,MAAM,IAAI,eAAe,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../src/types/serializers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,GAAG,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACpC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAChC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9F,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACpD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC;IACtD,MAAM,IAAI,eAAe,EAAE,CAAC;CAC/B"}

package/dist/types/transports.d.ts

@@ -1,20 +1,20 @@
 import type { LogLevel, LogTag } from './core.js';
 /**
- * Map a `LogLevel` to the OpenTelemetry numeric severity (1-24) used by
- * SigNoz / any OTLP/HTTP backend. Spec-compliant banded values:
- *   TRACE=1-4, DEBUG=5-8, INFO=9-12, WARN=13-16, ERROR=17-20, FATAL=21-24
- * We use the canonical mid-band value per level.
+ * Mapea un `LogLevel` a la severidad numérica de OpenTelemetry (1-24) usada
+ * por SigNoz / cualquier backend OTLP/HTTP. Valores por banda conformes a la
+ * spec: TRACE=1-4, DEBUG=5-8, INFO=9-12, WARN=13-16, ERROR=17-20, FATAL=21-24.
+ * Se usa el valor canónico del medio de cada banda.
  *
  * @see https://opentelemetry.io/docs/specs/otel/logs/data-model/#severity-fields
  */
 export declare const LOG_LEVEL_TO_SEVERITY_NUMBER: Record<LogLevel, number>;
 /**
- * Map a `LogLevel` to its OpenTelemetry severity name (uppercase, OTel spec).
+ * Mapea un `LogLevel` a su nombre de severidad OpenTelemetry (mayúsculas, spec OTel).
  */
 export declare const LOG_LEVEL_TO_SEVERITY_TEXT: Record<LogLevel, string>;
 /**
- * OTel resource attributes attached once per batch (service.name, version, env, ...).
- * Values are string-coerced by the transport layer.
+ * Atributos de recurso OTel adjuntados una vez por batch (service.name, version,
+ * env, ...). Los valores son string-coerced por la capa de transport.
  */
 export interface ILogResource {
     'service.name': string;
@@ -23,71 +23,76 @@ export interface ILogResource {
     [key: string]: string | undefined;
 }
 /**
- * Structured attribute bag (OpenTelemetry-compatible). Every key maps to
- * a typed value; the transport layer decides how to serialise it.
+ * Valor admitido en un {@link ILogAttributes}: unión recursiva de primitivos
+ * serializables (string, number, boolean, null), arrays y structs anidados.
+ * Compatible con el modelo de attribute value de OpenTelemetry.
  */
 export type LogAttributeValue = string | number | boolean | null | LogAttributeValue[] | {
     [k: string]: LogAttributeValue;
 };
+/**
+ * Bag estructurado de atributos (compatible con OpenTelemetry). Cada clave
+ * mapea a un valor tipado; la capa de transport decide cómo serializarlo.
+ */
 export interface ILogAttributes {
     [key: string]: LogAttributeValue;
 }
 /**
- * The payload sent to every transport on each `log()` call. Fields are
- * deliberately explicit (no `[key: string]: any` safety hatch) so transport
- * implementations like `OtlpTransport` can map 1:1 to OTLP `logRecords`.
+ * Payload enviado a cada transport en cada llamada a `log()`. Los campos son
+ * deliberadamente explícitos (sin escape hatch `[key: string]: any`) para que
+ * implementaciones como `OtlpTransport` puedan mapear 1:1 a `logRecords` OTLP.
  */
 export interface TransportRecord {
-    /** Canonical log level (trace/debug/info/warn/error/critical). */
+    /** Nivel canónico (trace/debug/info/warn/error/critical). */
     level: LogLevel;
-    /** Numeric severity, copied from `LOG_LEVELS[level]`. */
+    /** Severidad numérica, copiada de `LOG_LEVELS[level]`. */
     levelValue: number;
-    /** OTel numeric severity (1-24). Set automatically by Logger. */
+    /** Severidad numérica OTel (1-24). La asigna automáticamente el Logger. */
     severityNumber: number;
-    /** OTel severity name (TRACE/DEBUG/INFO/WARN/ERROR/FATAL). */
+    /** Nombre de severidad OTel (TRACE/DEBUG/INFO/WARN/ERROR/FATAL). */
     severityText: string;
-    /** Epoch milliseconds at log time. */
+    /** Epoch milliseconds en el momento del log. */
     time: number;
-    /** Final, post-hook message text. */
+    /** Texto final del mensaje, ya procesado por los hooks. */
     msg: string;
-    /** Optional logical scope (e.g. "Auth", "API:Users"). */
+    /** Scope lógico opcional (p.ej. "Auth", "API:Users"). */
     prefix?: string;
-    /** Caller location, only when `enableStackTrace` is true. */
+    /** Ubicación del caller, solo cuando `enableStackTrace` es true. */
     location?: {
         file: string;
         line: number;
         column: number;
         function?: string;
     };
-    /** 32-char hex trace id (OTel), when correlated with an active span. */
+    /** Trace id hex de 32 chars (OTel), cuando hay correlación con un span activo. */
     traceId?: string;
-    /** 16-char hex span id (OTel), when correlated with an active span. */
+    /** Span id hex de 16 chars (OTel), cuando hay correlación con un span activo. */
     spanId?: string;
-    /** Structured attributes (requestId, userId, custom tags). */
+    /** Atributos estructurados (requestId, userId, tags custom). */
     attributes?: ILogAttributes;
-    /** Per-log resource (overrides Transport-level resource). */
+    /** Recurso a nivel de log (sobreescribe el resource del transport). */
     resource?: Partial<ILogResource>;
-    /** Special "success" tag — set by `Logger.success()`. */
+    /** Tag especial "success" — lo setea `Logger.success()`. */
     tag?: LogTag;
 }
 /**
- * Options accepted by any transport at registration time.
+ * Opciones aceptadas por cualquier transport al registrarse.
  */
 export interface TransportOptions {
     level?: LogLevel;
-    /** Transform the record before it's serialised. Return null to drop. */
+    /** Transforma el record antes de serializarlo. Devolver null descarta el record. */
     transform?: (record: TransportRecord) => TransportRecord | null;
-    /** Flush once the buffer reaches this many records. */
+    /** Flush cuando el buffer alcanza esta cantidad de records. */
     batchSize?: number;
-    /** Flush periodically at this interval (ms). */
+    /** Flush periódico a este intervalo (ms). */
     flushInterval?: number;
-    /** Hard cap on buffered records. Older entries are dropped on overflow. */
+    /** Tope duro de records en buffer. Los más antiguos se descartan al desbordar. */
     maxBufferSize?: number;
 }
 /**
- * A transport registration. `target` can be:
- *   - An `ITransport` instance (legacy / inline).
- *   - A string registered in `TransportManager`'s built-in registry
+ * Registro de un transport. `target` puede ser:
+ *   - Una instancia de `ITransport` (legacy / inline).
+ *   - Un string registrado en el registry built-in de `TransportManager`
  *     (`'console' | 'file' | 'http' | 'otlp'`).
  */
 export interface TransportTarget {
@@ -96,7 +101,7 @@ export interface TransportTarget {
     level?: LogLevel;
 }
 /**
- * Minimal contract every transport must satisfy.
+ * Contrato mínimo que todo transport debe satisfacer.
  */
 export interface ITransport {
     readonly name: string;
@@ -106,8 +111,8 @@ export interface ITransport {
     isReady?(): boolean;
 }
 /**
- * Buffered transport contract. Concrete transports like `HttpTransport`,
- * `FileTransport` and `OtlpTransport` extend this.
+ * Contrato de transport con buffer. Transports concretos como `HttpTransport`,
+ * `FileTransport` y `OtlpTransport` extienden esta interfaz.
  */
 export interface IBufferedTransport extends ITransport {
     readonly bufferSize: number;
@@ -115,7 +120,7 @@ export interface IBufferedTransport extends ITransport {
     flush(): Promise<void>;
 }
 /**
- * Transport registry / dispatch contract.
+ * Contrato del registry / dispatch de transports.
  */
 export interface ITransportManager {
     add(target: TransportTarget): string;

package/dist/types/transports.d.ts.map

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

package/dist/utils/ansi-colors.d.ts

@@ -1,9 +1,9 @@
 /**
- * @fileoverview ANSI color utilities for terminal environments
+ * @fileoverview Utilidades de colores ANSI para entornos de terminal
  */
 import type { LogLevel } from '../types/index.js';
 /**
- * ANSI color codes for terminal styling
+ * Códigos de color ANSI para estilos en terminal
  */
 export declare const ANSI_CODES: {
     readonly black: 30;
@@ -57,7 +57,7 @@ export declare const ANSI_CODES: {
     readonly resetStrikethrough: 29;
 };
 /**
- * ANSI color presets for different log levels
+ * Presets de colores ANSI para los distintos niveles de log
  */
 export declare const ANSI_LEVEL_STYLES: Record<LogLevel | 'success', {
     color: number;
@@ -66,50 +66,50 @@ export declare const ANSI_LEVEL_STYLES: Record<LogLevel | 'success', {
     emoji: string;
 }>;
 /**
- * Applies ANSI styling to text
+ * Aplica estilos ANSI al texto
  */
 export declare function ansiStyle(text: string, codes: number[]): string;
 /**
- * Applies color to text
+ * Aplica color al texto
  */
 export declare function ansiColor(text: string, color: number): string;
 /**
- * Applies background color to text
+ * Aplica color de fondo al texto
  */
 export declare function ansiBackground(text: string, bg: number, color?: number): string;
 /**
- * Makes text bold
+ * Pone el texto en bold
  */
 export declare function ansiBold(text: string): string;
 /**
- * Makes text dim
+ * Aplica dim al texto
  */
 export declare function ansiDim(text: string): string;
 /**
- * Underlines text
+ * Subraya el texto
  */
 export declare function ansiUnderline(text: string): string;
 /**
- * Specialized formatters for different contexts
+ * Formatters especializados para distintos contextos
  */
 /**
- * Format timestamp for terminal
+ * Formatea el timestamp para terminal
  */
 export declare function formatTimestampANSI(timestamp: string): string;
 /**
- * Format log level for terminal
+ * Formatea el nivel de log para terminal
  */
 export declare function formatLogLevelANSI(level: LogLevel, useEmojis?: boolean): string;
 /**
- * Format success message for terminal
+ * Formatea el mensaje de success para terminal
  */
 export declare function formatSuccessANSI(message: string, useEmojis?: boolean): string;
 /**
- * Format prefix for terminal
+ * Formatea el prefix para terminal
  */
 export declare function formatPrefixANSI(prefix: string): string;
 /**
- * Format file location for terminal
+ * Formatea la ubicación del archivo para terminal
  */
 export declare function formatLocationANSI(location: string): string;
 //# sourceMappingURL=ansi-colors.d.ts.map

package/dist/utils/environment-detector.d.ts

@@ -1,42 +1,42 @@
 /**
- * Environment Detector - Robust environment detection for logger
- * Detects browser, terminal, server, and other runtime environments
+ * Detector de entorno — Detección robusta del entorno para el logger
+ * Detecta entornos browser, terminal, server y otros runtime
  */
 export type Environment = 'browser' | 'terminal' | 'server' | 'webworker' | 'deno' | 'unknown';
 /**
- * Checks if running in Node.js environment
+ * Comprueba si se ejecuta en entorno Node.js
  */
 export declare const isNode: string | false;
 /**
- * Checks if running in browser environment
+ * Comprueba si se ejecuta en entorno browser
  */
 export declare const isBrowser: boolean;
 /**
- * Main environment detection function
+ * Función principal de detección de entorno
  */
 export declare function getEnvironment(): Environment;
 /**
- * Check if running in an interactive terminal
+ * Comprueba si se ejecuta en una terminal interactiva
  */
 export declare function isRunningInTerminal(): boolean;
 /**
- * Check if environment supports ANSI colors
+ * Comprueba si el entorno soporta colores ANSI
  */
 export declare function supportsANSI(): boolean;
 /**
- * Get environment-specific color capability
+ * Obtiene la capacidad de color específica del entorno
  */
 export declare function getColorCapability(): 'full' | 'basic' | 'none';
 /**
- * Get terminal width in columns
+ * Obtiene el ancho de la terminal en columnas
  */
 export declare function getTerminalWidth(): number;
 /**
- * Get terminal height in rows
+ * Obtiene el alto de la terminal en filas
  */
 export declare function getTerminalHeight(): number;
 /**
- * Environment information for debugging
+ * Información del entorno para debugging
  */
 export declare function getEnvironmentInfo(): {
     environment: Environment;

package/dist/utils/formatting.d.ts

@@ -1,20 +1,20 @@
 /**
- * @fileoverview Formatting utilities for Universal Logger
+ * @fileoverview Utilidades de formatting para Universal Logger
  */
 import type { LogLevel, StackInfo } from '../types/index.js';
 export type { OutputFormat } from '../types/index.js';
 /**
- * Creates plain text output for any environment
- * No colors, no styling - maximum compatibility
+ * Crea output en texto plano para cualquier entorno
+ * Sin colores ni estilos — máxima compatibilidad
  */
 export declare function createPlainOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
 /**
- * Gets the appropriate log method for the level
- * Uses different console methods for better semantics
+ * Obtiene el método de console adecuado para el nivel
+ * Usa distintos métodos de console para mejor semántica
  */
 export declare function getConsoleMethod(level: LogLevel): 'log' | 'info' | 'warn' | 'error';
 /**
- * Create a simple log entry object for handlers
+ * Crea un objeto simple de log entry para los handlers
  */
 export declare function createLogEntry(level: LogLevel, message: string, args: any[], prefix?: string, stackInfo?: StackInfo | null): {
     timestamp: string;
@@ -31,11 +31,11 @@ export declare function createLogEntry(level: LogLevel, message: string, args: a
     raw: any[];
 };
 /**
- * Format data for table display in plain text
+ * Formatea datos para visualización en tabla como texto plano
  */
 export declare function formatTablePlain(data: any, columns?: string[]): string;
 /**
- * Safe object serialization for logging
+ * Serialización segura de objetos para logging
  */
 export declare function safeSerialize(obj: any, maxDepth?: number, currentDepth?: number): any;
 //# sourceMappingURL=formatting.d.ts.map

package/dist/utils/output.d.ts

@@ -1,10 +1,10 @@
 /**
- * @fileoverview Styled output creation utilities for Advanced Logger
+ * @fileoverview Utilidades para crear output estilizado para Advanced Logger
  */
 import type { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors } from '../types/index.js';
 import type { LogStyles } from '../types/index.js';
 /**
- * Style configuration for each log level
+ * Configuración de estilo para cada nivel de log
  */
 export interface LevelStyleConfig {
     emoji: string;
@@ -15,25 +15,25 @@ export interface LevelStyleConfig {
     shadow: string;
 }
 /**
- * Detects the current DevTools theme preference
+ * Detecta la preferencia de theme actual de DevTools
  */
 export declare function detectDevToolsTheme(): DevToolsTheme;
 /**
- * Gets adaptive color based on current DevTools theme
+ * Obtiene el color adaptativo según el theme actual de DevTools
  */
 export declare function getAdaptiveColor(colors: AdaptiveColors, theme?: DevToolsTheme): string;
 /**
- * Sets up theme change listener for dynamic updates
+ * Registra un listener de cambios de theme para actualizaciones dinámicas
  */
 export declare function setupThemeChangeListener(callback: (theme: DevToolsTheme) => void): (() => void) | null;
 /**
- * Creates styled console output with multiple %c formatters
- * Automatically adapts to browser or terminal environment
+ * Crea output estilizado para consola con múltiples formatters `%c`
+ * Se adapta automáticamente al entorno (browser o terminal)
  */
 export declare function createStyledOutput(level: LogLevel, levelStyles: Record<LogLevel | 'success', LevelStyleConfig>, prefix: string | undefined, message: string, stackInfo: StackInfo | null, autoDetectTheme?: boolean, presetStyles?: LogStyles, presetName?: string): [string, ...string[]];
 /**
- * Builds a terminal-friendly line using the ANSI helpers. Used when the
- * runtime is not a browser but supports ANSI codes (TTY, modern terminal).
+ * Construye una línea apta para terminal usando los helpers ANSI. Se usa
+ * cuando el runtime no es browser pero soporta códigos ANSI (TTY, terminal moderna).
  *
  * Layout: `[HH:MM:SS.mmm] [LEVEL] [prefix] message (file:line)`
  */

package/dist/utils/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAyBtG;AAGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,gBAAgB,CAAC,EAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,eAAe,GAAE,OAAc,EAC/B,YAAY,CAAC,EAAE,SAAS,EACxB,UAAU,CAAC,EAAE,MAAM,GACpB,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAwEvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAYvB"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAyBtG;AAGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,gBAAgB,CAAC,EAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,eAAe,GAAE,OAAc,EAC/B,YAAY,CAAC,EAAE,SAAS,EACxB,UAAU,CAAC,EAAE,MAAM,GACpB,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CA+EvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAYvB"}

package/dist/utils/stackTrace.d.ts

@@ -1,9 +1,9 @@
 /**
- * @fileoverview Stack trace parsing utilities for Advanced Logger
+ * @fileoverview Utilidades de parseo de stack traces para Advanced Logger
  */
 import type { StackInfo } from '../types/index.js';
 /**
- * Parses the current stack trace to extract caller information
+ * Parsea el stack trace actual para extraer la información del caller
  */
 export declare function parseStackTrace(): StackInfo | null;
 //# sourceMappingURL=stackTrace.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mks2508/better-logger",
-  "version": "0.18.2-alpha.1",
+  "version": "0.18.2-alpha.2",
   "type": "module",
   "files": [
     "dist",
@@ -26,38 +26,38 @@
       "types": "./dist/cli-module.d.ts"
     },
     "./transports": {
-      "import": "./dist/transports-module.js",
-      "require": "./dist/transports-module.cjs",
+      "import": "./dist/transports.js",
+      "require": "./dist/transports.cjs",
       "types": "./dist/transports-module.d.ts"
     },
     "./context": {
-      "import": "./dist/context-module.js",
-      "require": "./dist/context-module.cjs",
+      "import": "./dist/context.js",
+      "require": "./dist/context.cjs",
       "types": "./dist/context-module.d.ts"
     },
     "./hooks": {
-      "import": "./dist/hooks-module.js",
-      "require": "./dist/hooks-module.cjs",
+      "import": "./dist/hooks.js",
+      "require": "./dist/hooks.cjs",
       "types": "./dist/hooks-module.d.ts"
     },
     "./serializers": {
-      "import": "./dist/serializers-module.js",
-      "require": "./dist/serializers-module.cjs",
+      "import": "./dist/serializers.js",
+      "require": "./dist/serializers.cjs",
       "types": "./dist/serializers-module.d.ts"
     },
     "./styles": {
-      "import": "./dist/styles-module.js",
-      "require": "./dist/styles-module.cjs",
+      "import": "./dist/styles.js",
+      "require": "./dist/styles.cjs",
       "types": "./dist/styles-module.d.ts"
     },
     "./playground": {
-      "import": "./dist/playground-module.js",
-      "require": "./dist/playground-module.cjs",
+      "import": "./dist/playground.js",
+      "require": "./dist/playground.cjs",
       "types": "./dist/playground-module.d.ts"
     },
     "./node": {
-      "import": "./dist/node-module.js",
-      "require": "./dist/node-module.cjs",
+      "import": "./dist/node.js",
+      "require": "./dist/node.cjs",
       "types": "./dist/node-module.d.ts"
     }
   },
@@ -96,7 +96,9 @@
   },
   "homepage": "https://mks2508.github.io/advanced-logger/",
   "scripts": {
-    "dev": "vite",
+    "dev": "vite --config vite.config.demo.ts",
+    "demo:dev": "vite --config vite.config.demo.ts",
+    "demo:build": "vite build --config vite.config.demo.ts",
     "build": "rolldown --config rolldown.config.ts && tsc --emitDeclarationOnly",
     "build:full": "rolldown --config rolldown.config.ts && tsc --emitDeclarationOnly",
     "build:core": "BUILD_MODE=core rolldown --config rolldown.config.ts && tsc --emitDeclarationOnly --project tsconfig.node.json",
@@ -109,6 +111,8 @@
     "lint": "oxlint src/",
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
+    "docs:api": "typedoc",
+    "docs:md-serve": "bun scripts/build-md-serve.ts",
     "test": "bunx vitest run",
     "test:watch": "bunx vitest",
     "test:performance": "bunx vitest bench",
@@ -142,14 +146,7 @@
     "release:major": "bun project-utils/auto-release-ui.ts --major",
     "workflow:full": "npm run commit:auto && npm run release:full",
     "workflow:commit": "npm run commit:auto",
-    "workflow:release": "npm run version:auto && npm run build:all && npm run release:github",
-    "play": "bun playground/demo-all.ts",
-    "play:spinner": "bun playground/demo-spinner.ts",
-    "play:box": "bun playground/demo-box.ts",
-    "play:table": "bun playground/demo-table.ts",
-    "play:steps": "bun playground/demo-steps.ts",
-    "play:levels": "bun playground/demo-levels.ts",
-    "play:real": "bun playground/demo-real-world.ts"
+    "workflow:release": "npm run version:auto && npm run build:all && npm run release:github"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",
@@ -157,7 +154,9 @@
     "prettier": "^3.4.2",
     "rolldown": "^1.0.0-beta.58",
     "terser": "^5.48.0",
-    "tsgo": "^7.0.0-dev",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-frontmatter": "^1.3.1",
+    "typedoc-plugin-markdown": "^4.12.0",
     "typescript": "~6.0.3",
     "vite": "^8.1.2",
     "vite-plugin-dts": "^5.0.3",