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

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.cjs","names":["DEFAULT_CONFIG","isBrowser","LOG_LEVELS","parseStackTrace","getConsoleMethod","createStyledOutput","LEVEL_STYLES","createPlainOutput","createLogEntry","formatTablePlain","isNode"],"sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Core Logger Module - Minimal logging without advanced features\n * \n * This module provides the essential logging functionality without visual enhancements,\n * SVG support, or advanced styling. Perfect for lightweight applications or server-side usage.\n */\n\n// Core types\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Core utilities\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Universal formatting and environment detection\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize,\n    type OutputFormat\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode\n} from './utils/environment-detector.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constants\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\nimport { LOG_LEVELS } from './types/core.js';\n\n/**\n * Minimal Logger class with core functionality only\n * \n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n * \n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Creates a new CoreLogger instance\n     * @param config - Optional configuration\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configure based on environment\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true,\n            outputFormat: config.outputFormat ?? 'auto'\n        };\n    }\n\n    // ===== CONFIGURATION METHODS =====\n\n    /**\n     * Get current configuration\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Sets the global prefix for all log messages\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Sets the verbosity level for filtering log output\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Creates a scoped logger with a specific prefix\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Adds a custom log handler for extensibility\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== CORE LOGGING METHODS =====\n\n    /**\n     * Checks if a log level should be output based on current verbosity\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const verbosity = this.config.verbosity as LogLevel;\n        return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];\n    }\n\n    /**\n     * Gets the effective prefix (global + scoped)\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Core logging method with universal formatting\n     */\n    private log(level: LogLevel, ...args: unknown[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n\n        // Choose formatting based on environment and configuration\n        if (isBrowser && this.config.enableColors) {\n            // Browser with CSS styling\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback to plain formatting if CSS fails\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js or browser without colors - use plain formatting\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Call custom handlers with structured metadata\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Logs debug information (lowest priority)\n     */\n    debug(...args: unknown[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Logs informational messages\n     */\n    info(...args: unknown[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Logs warning messages\n     */\n    warn(...args: unknown[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Logs error messages\n     */\n    error(...args: unknown[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Logs critical errors (highest priority)\n     */\n    critical(...args: unknown[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Logs trace information (detailed debugging)\n     */\n    trace(...args: unknown[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== BASIC ADVANCED FEATURES =====\n\n    /**\n     * Displays data in a table format\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser has native table support\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js or fallback - use plain text formatting\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Starts a collapsible group in the console\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser supports native grouping\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Node.js fallback - just log the group label\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Ends the current console group\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Node.js fallback - log group end\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Starts a timer with the given label\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Ends a timer and logs the elapsed time\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Gets performance.now() or fallback for older environments\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback to Date.now()\n        return Date.now();\n    }\n}\n\n// Create and export singleton instance for convenience\nconst coreLogger = new CoreLogger();\n\n/**\n * Export individual methods for convenience (with proper binding)\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Export the singleton as default\nexport default coreLogger;\n\n// Re-export core types\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"mappings":"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"}
+{"version":3,"file":"core.cjs","names":["DEFAULT_CONFIG","isBrowser","LOG_LEVELS","parseStackTrace","getConsoleMethod","createStyledOutput","LEVEL_STYLES","createPlainOutput","createLogEntry","formatTablePlain","isNode"],"sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Módulo Core Logger — logging minimal sin features avanzadas\n *\n * Provee la funcionalidad esencial de logging sin mejoras visuales,\n * soporte SVG ni styling avanzado. Adecuado para apps ligeras o uso server-side.\n */\n\n// Tipos core\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Utilidades core\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Formato universal y detección de entorno\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize,\n    type OutputFormat\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode\n} from './utils/environment-detector.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constantes\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\nimport { LOG_LEVELS } from './types/core.js';\n\n/**\n * Logger minimal con solo la funcionalidad core.\n *\n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n *\n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Crea una nueva instancia de CoreLogger.\n     * @param config - Configuración opcional.\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configurar según entorno\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true,\n            outputFormat: config.outputFormat ?? 'auto'\n        };\n    }\n\n    // ===== MÉTODOS DE CONFIGURACIÓN =====\n\n    /**\n     * Obtiene la configuración actual.\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Define el prefijo global para todos los mensajes de log.\n     * @param prefix - Prefijo a aplicar a todos los mensajes.\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Define el nivel de verbosity para filtrar la salida de log.\n     * @param level - Nivel de verbosity.\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Crea un logger con scope y un prefijo específico.\n     * @param prefix - Prefijo del scope.\n     * @returns Nueva instancia de CoreLogger con el prefijo asignado.\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Añade un handler personalizado para extensibilidad.\n     * @param handler - Handler que implementa la interfaz ILogHandler.\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== MÉTODOS CORE DE LOGGING =====\n\n    /**\n     * Comprueba si un nivel debe emitirse según el verbosity actual.\n     * @param level - Nivel a evaluar.\n     * @returns `true` si el nivel debe emitirse.\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const verbosity = this.config.verbosity as LogLevel;\n        return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];\n    }\n\n    /**\n     * Obtiene el prefijo efectivo (global + scope).\n     * @returns Prefijo combinado o `undefined` si no hay ninguno.\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Método principal de log con formato universal.\n     * @param level - Nivel del mensaje.\n     * @param args - Argumentos del mensaje.\n     */\n    private log(level: LogLevel, ...args: unknown[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n\n        // Elegir formato según entorno y configuración\n        if (isBrowser && this.config.enableColors) {\n            // Browser con styling CSS\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback a formato plano si falla el CSS\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js o browser sin colores: formato plano\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Llama a los handlers con metadata estructurada\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Emite mensajes de debug (prioridad más baja).\n     * @param args - Argumentos del mensaje.\n     */\n    debug(...args: unknown[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Emite mensajes informativos.\n     * @param args - Argumentos del mensaje.\n     */\n    info(...args: unknown[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Emite mensajes de advertencia.\n     * @param args - Argumentos del mensaje.\n     */\n    warn(...args: unknown[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Emite mensajes de error.\n     * @param args - Argumentos del mensaje.\n     */\n    error(...args: unknown[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Emite errores críticos (prioridad más alta).\n     * @param args - Argumentos del mensaje.\n     */\n    critical(...args: unknown[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Emite información de trace (debugging detallado).\n     * @param args - Argumentos del mensaje.\n     */\n    trace(...args: unknown[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== FEATURES AVANZADAS BÁSICAS =====\n\n    /**\n     * Muestra datos en formato tabla.\n     * @param data - Datos a mostrar.\n     * @param columns - Columnas opcionales a incluir.\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser con soporte nativo de table\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js o fallback: formato de texto plano\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Inicia un grupo colapsable en la console.\n     * @param label - Etiqueta del grupo.\n     * @param collapsed - Si el grupo inicia colapsado.\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser soporta grouping nativo\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Fallback Node.js: solo emite el label del grupo\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Cierra el grupo actual de la console.\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Fallback Node.js: emite el cierre del grupo\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Inicia un timer con el label indicado.\n     * @param label - Identificador del timer.\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Detiene un timer y emite el tiempo transcurrido.\n     * @param label - Identificador del timer previamente iniciado.\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Obtiene `performance.now()` o un fallback para entornos antiguos.\n     * @returns Timestamp en milisegundos.\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback a Date.now()\n        return Date.now();\n    }\n}\n\n// Crea y exporta una instancia singleton por conveniencia\nconst coreLogger = new CoreLogger();\n\n/**\n * Exporta métodos individuales por conveniencia (con binding correcto).\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Exporta el singleton como default\nexport default coreLogger;\n\n// Re-exporta tipos core\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"mappings":"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"}

package/dist/core.d.ts

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Core Logger Module - Minimal logging without advanced features
+ * @fileoverview Módulo Core Logger — logging minimal sin features avanzadas
  *
- * This module provides the essential logging functionality without visual enhancements,
- * SVG support, or advanced styling. Perfect for lightweight applications or server-side usage.
+ * Provee la funcionalidad esencial de logging sin mejoras visuales,
+ * soporte SVG ni styling avanzado. Adecuado para apps ligeras o uso server-side.
  */
 import type { Verbosity, LoggerConfig, ILogHandler } from './types/index.js';
 /**
- * Minimal Logger class with core functionality only
+ * Logger minimal con solo la funcionalidad core.
  *
  * @example
  * ```typescript
@@ -24,94 +24,117 @@ export declare class CoreLogger {
     private timers;
     private groupDepth;
     /**
-     * Creates a new CoreLogger instance
-     * @param config - Optional configuration
+     * Crea una nueva instancia de CoreLogger.
+     * @param config - Configuración opcional.
      */
     constructor(config?: Partial<LoggerConfig>);
     /**
-     * Get current configuration
+     * Obtiene la configuración actual.
      */
     getConfig(): LoggerConfig;
     /**
-     * Sets the global prefix for all log messages
+     * Define el prefijo global para todos los mensajes de log.
+     * @param prefix - Prefijo a aplicar a todos los mensajes.
      */
     setGlobalPrefix(prefix: string): void;
     /**
-     * Sets the verbosity level for filtering log output
+     * Define el nivel de verbosity para filtrar la salida de log.
+     * @param level - Nivel de verbosity.
      */
     setVerbosity(level: Verbosity): void;
     /**
-     * Creates a scoped logger with a specific prefix
+     * Crea un logger con scope y un prefijo específico.
+     * @param prefix - Prefijo del scope.
+     * @returns Nueva instancia de CoreLogger con el prefijo asignado.
      */
     scope(prefix: string): CoreLogger;
     /**
-     * Adds a custom log handler for extensibility
+     * Añade un handler personalizado para extensibilidad.
+     * @param handler - Handler que implementa la interfaz ILogHandler.
      */
     addHandler(handler: ILogHandler): void;
     /**
-     * Checks if a log level should be output based on current verbosity
+     * Comprueba si un nivel debe emitirse según el verbosity actual.
+     * @param level - Nivel a evaluar.
+     * @returns `true` si el nivel debe emitirse.
      */
     private shouldLog;
     /**
-     * Gets the effective prefix (global + scoped)
+     * Obtiene el prefijo efectivo (global + scope).
+     * @returns Prefijo combinado o `undefined` si no hay ninguno.
      */
     private getEffectivePrefix;
     /**
-     * Core logging method with universal formatting
+     * Método principal de log con formato universal.
+     * @param level - Nivel del mensaje.
+     * @param args - Argumentos del mensaje.
      */
     private log;
     /**
-     * Logs debug information (lowest priority)
+     * Emite mensajes de debug (prioridad más baja).
+     * @param args - Argumentos del mensaje.
      */
     debug(...args: unknown[]): void;
     /**
-     * Logs informational messages
+     * Emite mensajes informativos.
+     * @param args - Argumentos del mensaje.
      */
     info(...args: unknown[]): void;
     /**
-     * Logs warning messages
+     * Emite mensajes de advertencia.
+     * @param args - Argumentos del mensaje.
      */
     warn(...args: unknown[]): void;
     /**
-     * Logs error messages
+     * Emite mensajes de error.
+     * @param args - Argumentos del mensaje.
      */
     error(...args: unknown[]): void;
     /**
-     * Logs critical errors (highest priority)
+     * Emite errores críticos (prioridad más alta).
+     * @param args - Argumentos del mensaje.
      */
     critical(...args: unknown[]): void;
     /**
-     * Logs trace information (detailed debugging)
+     * Emite información de trace (debugging detallado).
+     * @param args - Argumentos del mensaje.
      */
     trace(...args: unknown[]): void;
     /**
-     * Displays data in a table format
+     * Muestra datos en formato tabla.
+     * @param data - Datos a mostrar.
+     * @param columns - Columnas opcionales a incluir.
      */
     table(data: any, columns?: string[]): void;
     /**
-     * Starts a collapsible group in the console
+     * Inicia un grupo colapsable en la console.
+     * @param label - Etiqueta del grupo.
+     * @param collapsed - Si el grupo inicia colapsado.
      */
     group(label: string, collapsed?: boolean): void;
     /**
-     * Ends the current console group
+     * Cierra el grupo actual de la console.
      */
     groupEnd(): void;
     /**
-     * Starts a timer with the given label
+     * Inicia un timer con el label indicado.
+     * @param label - Identificador del timer.
      */
     time(label: string): void;
     /**
-     * Ends a timer and logs the elapsed time
+     * Detiene un timer y emite el tiempo transcurrido.
+     * @param label - Identificador del timer previamente iniciado.
      */
     timeEnd(label: string): void;
     /**
-     * Gets performance.now() or fallback for older environments
+     * Obtiene `performance.now()` o un fallback para entornos antiguos.
+     * @returns Timestamp en milisegundos.
      */
     private getPerformanceNow;
 }
 declare const coreLogger: CoreLogger;
 /**
- * Export individual methods for convenience (with proper binding)
+ * Exporta métodos individuales por conveniencia (con binding correcto).
  */
 export declare const debug: (...args: any[]) => void;
 export declare const info: (...args: any[]) => void;

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -1,14 +1,14 @@
-import { t as LOG_LEVELS } from "./chunks/core-PoT7RrTK.js";
-import { _ as DEFAULT_CONFIG, b as parseStackTrace, i as getConsoleMethod, n as createPlainOutput, o as createStyledOutput, r as formatTablePlain, t as createLogEntry, v as LEVEL_STYLES } from "./chunks/utils-VETbVpkR.js";
-import { o as isBrowser, s as isNode } from "./chunks/environment-detector-CI3TrWK_.js";
+import { t as LOG_LEVELS } from "./chunks/core-Blfi2klP.js";
+import { _ as DEFAULT_CONFIG, b as parseStackTrace, i as getConsoleMethod, n as createPlainOutput, o as createStyledOutput, r as formatTablePlain, t as createLogEntry, v as LEVEL_STYLES } from "./chunks/utils-tKfBAWUM.js";
+import { o as isBrowser, s as isNode } from "./chunks/environment-detector-7NvnYUfr.js";
 //#region src/core.ts
 /**
-* Minimal Logger class with core functionality only
-* 
+* Logger minimal con solo la funcionalidad core.
+*
 * @example
 * ```typescript
 * import { CoreLogger } from '@mks2508/better-logger/core';
-* 
+*
 * const logger = new CoreLogger();
 * logger.info('Hello world');
 * logger.error('Something went wrong', error);
@@ -21,8 +21,8 @@ var CoreLogger = class CoreLogger {
 	timers = /* @__PURE__ */ new Map();
 	groupDepth = 0;
 	/**
-	* Creates a new CoreLogger instance
-	* @param config - Optional configuration
+	* Crea una nueva instancia de CoreLogger.
+	* @param config - Configuración opcional.
 	*/
 	constructor(config = {}) {
 		this.config = {
@@ -36,25 +36,29 @@ var CoreLogger = class CoreLogger {
 		};
 	}
 	/**
-	* Get current configuration
+	* Obtiene la configuración actual.
 	*/
 	getConfig() {
 		return { ...this.config };
 	}
 	/**
-	* Sets the global prefix for all log messages
+	* Define el prefijo global para todos los mensajes de log.
+	* @param prefix - Prefijo a aplicar a todos los mensajes.
 	*/
 	setGlobalPrefix(prefix) {
 		this.config.globalPrefix = prefix;
 	}
 	/**
-	* Sets the verbosity level for filtering log output
+	* Define el nivel de verbosity para filtrar la salida de log.
+	* @param level - Nivel de verbosity.
 	*/
 	setVerbosity(level) {
 		this.config.verbosity = level;
 	}
 	/**
-	* Creates a scoped logger with a specific prefix
+	* Crea un logger con scope y un prefijo específico.
+	* @param prefix - Prefijo del scope.
+	* @returns Nueva instancia de CoreLogger con el prefijo asignado.
 	*/
 	scope(prefix) {
 		const scopedLogger = new CoreLogger(this.config);
@@ -63,13 +67,16 @@ var CoreLogger = class CoreLogger {
 		return scopedLogger;
 	}
 	/**
-	* Adds a custom log handler for extensibility
+	* Añade un handler personalizado para extensibilidad.
+	* @param handler - Handler que implementa la interfaz ILogHandler.
 	*/
 	addHandler(handler) {
 		this.handlers.push(handler);
 	}
 	/**
-	* Checks if a log level should be output based on current verbosity
+	* Comprueba si un nivel debe emitirse según el verbosity actual.
+	* @param level - Nivel a evaluar.
+	* @returns `true` si el nivel debe emitirse.
 	*/
 	shouldLog(level) {
 		if (this.config.verbosity === "silent") return false;
@@ -77,14 +84,17 @@ var CoreLogger = class CoreLogger {
 		return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];
 	}
 	/**
-	* Gets the effective prefix (global + scoped)
+	* Obtiene el prefijo efectivo (global + scope).
+	* @returns Prefijo combinado o `undefined` si no hay ninguno.
 	*/
 	getEffectivePrefix() {
 		const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);
 		return parts.length > 0 ? parts.join(":") : void 0;
 	}
 	/**
-	* Core logging method with universal formatting
+	* Método principal de log con formato universal.
+	* @param level - Nivel del mensaje.
+	* @param args - Argumentos del mensaje.
 	*/
 	log(level, ...args) {
 		if (!this.shouldLog(level)) return;
@@ -119,44 +129,52 @@ var CoreLogger = class CoreLogger {
 		});
 	}
 	/**
-	* Logs debug information (lowest priority)
+	* Emite mensajes de debug (prioridad más baja).
+	* @param args - Argumentos del mensaje.
 	*/
 	debug(...args) {
 		this.log("debug", ...args);
 	}
 	/**
-	* Logs informational messages
+	* Emite mensajes informativos.
+	* @param args - Argumentos del mensaje.
 	*/
 	info(...args) {
 		this.log("info", ...args);
 	}
 	/**
-	* Logs warning messages
+	* Emite mensajes de advertencia.
+	* @param args - Argumentos del mensaje.
 	*/
 	warn(...args) {
 		this.log("warn", ...args);
 	}
 	/**
-	* Logs error messages
+	* Emite mensajes de error.
+	* @param args - Argumentos del mensaje.
 	*/
 	error(...args) {
 		this.log("error", ...args);
 	}
 	/**
-	* Logs critical errors (highest priority)
+	* Emite errores críticos (prioridad más alta).
+	* @param args - Argumentos del mensaje.
 	*/
 	critical(...args) {
 		this.log("critical", ...args);
 	}
 	/**
-	* Logs trace information (detailed debugging)
+	* Emite información de trace (debugging detallado).
+	* @param args - Argumentos del mensaje.
 	*/
 	trace(...args) {
 		this.log("debug", ...args);
 		if (this.shouldLog("debug")) console.trace(...args);
 	}
 	/**
-	* Displays data in a table format
+	* Muestra datos en formato tabla.
+	* @param data - Datos a mostrar.
+	* @param columns - Columnas opcionales a incluir.
 	*/
 	table(data, columns) {
 		if (!this.shouldLog("info")) return;
@@ -173,7 +191,9 @@ var CoreLogger = class CoreLogger {
 		}
 	}
 	/**
-	* Starts a collapsible group in the console
+	* Inicia un grupo colapsable en la console.
+	* @param label - Etiqueta del grupo.
+	* @param collapsed - Si el grupo inicia colapsado.
 	*/
 	group(label, collapsed = false) {
 		const prefix = this.getEffectivePrefix();
@@ -187,7 +207,7 @@ var CoreLogger = class CoreLogger {
 		this.groupDepth++;
 	}
 	/**
-	* Ends the current console group
+	* Cierra el grupo actual de la console.
 	*/
 	groupEnd() {
 		if (this.groupDepth > 0) {
@@ -197,7 +217,8 @@ var CoreLogger = class CoreLogger {
 		}
 	}
 	/**
-	* Starts a timer with the given label
+	* Inicia un timer con el label indicado.
+	* @param label - Identificador del timer.
 	*/
 	time(label) {
 		const timer = {
@@ -210,7 +231,8 @@ var CoreLogger = class CoreLogger {
 		console.log(output);
 	}
 	/**
-	* Ends a timer and logs the elapsed time
+	* Detiene un timer y emite el tiempo transcurrido.
+	* @param label - Identificador del timer previamente iniciado.
 	*/
 	timeEnd(label) {
 		const timer = this.timers.get(label);
@@ -225,7 +247,8 @@ var CoreLogger = class CoreLogger {
 		console.log(output);
 	}
 	/**
-	* Gets performance.now() or fallback for older environments
+	* Obtiene `performance.now()` o un fallback para entornos antiguos.
+	* @returns Timestamp en milisegundos.
 	*/
 	getPerformanceNow() {
 		if (typeof performance !== "undefined" && performance.now) return performance.now();
@@ -238,7 +261,7 @@ var CoreLogger = class CoreLogger {
 };
 const coreLogger = new CoreLogger();
 /**
-* Export individual methods for convenience (with proper binding)
+* Exporta métodos individuales por conveniencia (con binding correcto).
 */
 const debug = (...args) => coreLogger.debug(...args);
 const info = (...args) => coreLogger.info(...args);

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Core Logger Module - Minimal logging without advanced features\n * \n * This module provides the essential logging functionality without visual enhancements,\n * SVG support, or advanced styling. Perfect for lightweight applications or server-side usage.\n */\n\n// Core types\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Core utilities\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Universal formatting and environment detection\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize,\n    type OutputFormat\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode\n} from './utils/environment-detector.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constants\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\nimport { LOG_LEVELS } from './types/core.js';\n\n/**\n * Minimal Logger class with core functionality only\n * \n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n * \n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Creates a new CoreLogger instance\n     * @param config - Optional configuration\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configure based on environment\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true,\n            outputFormat: config.outputFormat ?? 'auto'\n        };\n    }\n\n    // ===== CONFIGURATION METHODS =====\n\n    /**\n     * Get current configuration\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Sets the global prefix for all log messages\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Sets the verbosity level for filtering log output\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Creates a scoped logger with a specific prefix\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Adds a custom log handler for extensibility\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== CORE LOGGING METHODS =====\n\n    /**\n     * Checks if a log level should be output based on current verbosity\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const verbosity = this.config.verbosity as LogLevel;\n        return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];\n    }\n\n    /**\n     * Gets the effective prefix (global + scoped)\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Core logging method with universal formatting\n     */\n    private log(level: LogLevel, ...args: unknown[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n\n        // Choose formatting based on environment and configuration\n        if (isBrowser && this.config.enableColors) {\n            // Browser with CSS styling\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback to plain formatting if CSS fails\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js or browser without colors - use plain formatting\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Call custom handlers with structured metadata\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Logs debug information (lowest priority)\n     */\n    debug(...args: unknown[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Logs informational messages\n     */\n    info(...args: unknown[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Logs warning messages\n     */\n    warn(...args: unknown[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Logs error messages\n     */\n    error(...args: unknown[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Logs critical errors (highest priority)\n     */\n    critical(...args: unknown[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Logs trace information (detailed debugging)\n     */\n    trace(...args: unknown[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== BASIC ADVANCED FEATURES =====\n\n    /**\n     * Displays data in a table format\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser has native table support\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js or fallback - use plain text formatting\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Starts a collapsible group in the console\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser supports native grouping\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Node.js fallback - just log the group label\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Ends the current console group\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Node.js fallback - log group end\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Starts a timer with the given label\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Ends a timer and logs the elapsed time\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Gets performance.now() or fallback for older environments\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback to Date.now()\n        return Date.now();\n    }\n}\n\n// Create and export singleton instance for convenience\nconst coreLogger = new CoreLogger();\n\n/**\n * Export individual methods for convenience (with proper binding)\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Export the singleton as default\nexport default coreLogger;\n\n// Re-export core types\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"mappings":";;;;;;;;;;;;;;;;AAwDA,IAAa,aAAb,MAAa,WAAW;CACpB;CACA;CACA,WAAkC,CAAC;CACnC,yBAA0C,IAAI,IAAI;CAClD,aAA6B;;;;;CAM7B,YAAY,SAAgC,CAAC,GAAG;EAC5C,KAAK,SAAS;GACV,GAAG;GACH,GAAG;GAEH,cAAc,OAAO,iBAAiB,YAAY,OAAO;GACzD,kBAAkB,OAAO,oBAAoB;GAC7C,kBAAkB,OAAO,oBAAoB;GAC7C,iBAAiB,OAAO,mBAAmB;GAC3C,cAAc,OAAO,gBAAgB;EACzC;CACJ;;;;CAOA,YAA0B;EACtB,OAAO,EAAE,GAAG,KAAK,OAAO;CAC5B;;;;CAKA,gBAAgB,QAAsB;EAClC,KAAK,OAAO,eAAe;CAC/B;;;;CAKA,aAAa,OAAwB;EACjC,KAAK,OAAO,YAAY;CAC5B;;;;CAKA,MAAM,QAA4B;EAC9B,MAAM,eAAe,IAAI,WAAW,KAAK,MAAM;EAC/C,aAAa,eAAe;EAC5B,aAAa,WAAW,CAAC,GAAG,KAAK,QAAQ;EACzC,OAAO;CACX;;;;CAKA,WAAW,SAA4B;EACnC,KAAK,SAAS,KAAK,OAAO;CAC9B;;;;CAOA,UAAkB,OAA0B;EACxC,IAAI,KAAK,OAAO,cAAc,UAAU,OAAO;EAC/C,MAAM,YAAY,KAAK,OAAO;EAC9B,OAAO,WAAW,UAAU,WAAW;CAC3C;;;;CAKA,qBAAiD;EAC7C,MAAM,QAAQ,CAAC,KAAK,OAAO,cAAc,KAAK,YAAY,CAAC,CAAC,OAAO,OAAO;EAC1E,OAAO,MAAM,SAAS,IAAI,MAAM,KAAK,GAAG,IAAI,KAAA;CAChD;;;;CAKA,IAAY,OAAiB,GAAG,MAAuB;EACnD,IAAI,CAAC,KAAK,UAAU,KAAK,GAAG;EAE5B,MAAM,SAAS,KAAK,mBAAmB;EACvC,MAAM,UAAU,OAAO,KAAK,MAAM,EAAE;EACpC,MAAM,YAAY,KAAK,OAAO,mBAAmB,gBAAgB,IAAI;EACrE,MAAM,gBAAgB,iBAAiB,KAAK;EAG5C,IAAI,aAAa,KAAK,OAAO,cAEzB,IAAI;GACA,MAAM,CAAC,QAAQ,GAAG,UAAU,mBACxB,OACA,cACA,QACA,SACA,WACA,KAAK,OAAO,eAChB;GACA,QAAQ,cAAc,CAAC,QAAQ,GAAG,QAAQ,GAAG,KAAK,MAAM,CAAC,CAAC;EAC9D,SAAS,OAAO;GAEZ,MAAM,SAAS,kBAAkB,OAAO,SAAS,QAAQ,SAAS;GAClE,QAAQ,cAAc,CAAC,QAAQ,GAAG,KAAK,MAAM,CAAC,CAAC;EACnD;OACG;GAGH,MAAM,SADc,KAAK,OAAO,KAAK,UACZ,IAAI,kBAAkB,OAAO,SAAS,QAAQ,SAAS;GAChF,QAAQ,cAAc,CAAC,QAAQ,GAAG,KAAK,MAAM,CAAC,CAAC;EACnD;EAGA,MAAM,WAAW,eAAe,OAAO,SAAS,MAAM,QAAQ,SAAS;EACvE,MAAM,WAAwB;GAC1B,WAAW,SAAS;GACpB;GACA;GACA,WAAW,SAAS;EACxB;EAEA,KAAK,SAAS,SAAQ,YAAW;GAC7B,IAAI;IACA,QAAQ,OAAO,OAAO,SAAS,MAAM,QAAQ;GACjD,SAAS,OAAO;IACZ,QAAQ,MAAM,uBAAuB,KAAK;GAC9C;EACJ,CAAC;CACL;;;;CAKA,MAAM,GAAG,MAAuB;EAC5B,KAAK,IAAI,SAAS,GAAG,IAAI;CAC7B;;;;CAKA,KAAK,GAAG,MAAuB;EAC3B,KAAK,IAAI,QAAQ,GAAG,IAAI;CAC5B;;;;CAKA,KAAK,GAAG,MAAuB;EAC3B,KAAK,IAAI,QAAQ,GAAG,IAAI;CAC5B;;;;CAKA,MAAM,GAAG,MAAuB;EAC5B,KAAK,IAAI,SAAS,GAAG,IAAI;CAC7B;;;;CAKA,SAAS,GAAG,MAAuB;EAC/B,KAAK,IAAI,YAAY,GAAG,IAAI;CAChC;;;;CAKA,MAAM,GAAG,MAAuB;EAC5B,KAAK,IAAI,SAAS,GAAG,IAAI;EACzB,IAAI,KAAK,UAAU,OAAO,GACtB,QAAQ,MAAM,GAAG,IAAI;CAE7B;;;;CAOA,MAAM,MAAW,SAA0B;EACvC,IAAI,CAAC,KAAK,UAAU,MAAM,GAAG;EAE7B,MAAM,SAAS,KAAK,mBAAmB;EACvC,MAAM,cAAc,UAAU,SAAS,KAAK,OAAO,KAAK,GAAG;EAE3D,IAAI,aAAa,OAAO,QAAQ,UAAU,YAAY;GAElD,QAAQ,IAAI,WAAW;GACvB,IAAI,SACA,QAAQ,MAAM,MAAM,OAAO;QAE3B,QAAQ,MAAM,IAAI;EAE1B,OAAO;GAEH,QAAQ,IAAI,WAAW;GACvB,MAAM,YAAY,iBAAiB,MAAM,OAAO;GAChD,QAAQ,IAAI,SAAS;EACzB;CACJ;;;;CAKA,MAAM,OAAe,YAAqB,OAAa;EACnD,MAAM,SAAS,KAAK,mBAAmB;EACvC,MAAM,YAAY,GAAG,SAAS,IAAI,OAAO,MAAM,KAAK;EAEpD,IAAI,aAAa,QAAQ,SAAS,QAAQ,gBAEtC,IAAI,WACA,QAAQ,eAAe,SAAS;OAEhC,QAAQ,MAAM,SAAS;OAExB;GAEH,MAAM,aAAa,QAAQ;GAC3B,QAAQ,IAAI,UAAU;EAC1B;EAEA,KAAK;CACT;;;;CAKA,WAAiB;EACb,IAAI,KAAK,aAAa,GAAG;GACrB,IAAI,aAAa,QAAQ,UACrB,QAAQ,SAAS;QAIjB,QAAQ,IAAI,gBAAQ;GAExB,KAAK;EACT;CACJ;;;;CAKA,KAAK,OAAqB;EAEtB,MAAM,QAAoB;GACtB;GACA,WAHc,KAAK,kBAGX;EACZ;EACA,KAAK,OAAO,IAAI,OAAO,KAAK;EAE5B,MAAM,SAAS,KAAK,mBAAmB;EAEvC,MAAM,SAAS,kBAAkB,QAAQ,kBADP,SACgB,MAAM;EACxD,QAAQ,IAAI,MAAM;CACtB;;;;CAKA,QAAQ,OAAqB;EACzB,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK;EACnC,IAAI,CAAC,OAAO;GACR,KAAK,KAAK,UAAU,MAAM,iBAAiB;GAC3C;EACJ;EAEA,MAAM,UAAU,KAAK,kBAAkB,IAAI,MAAM;EACjD,KAAK,OAAO,OAAO,KAAK;EAExB,MAAM,SAAS,KAAK,mBAAmB;EAEvC,MAAM,SAAS,kBAAkB,QAAQ,gBADT,MAAM,KAAK,QAAQ,QAAQ,CAAC,EAAE,KACZ,MAAM;EACxD,QAAQ,IAAI,MAAM;CACtB;;;;CAKA,oBAAoC;EAChC,IAAI,OAAO,gBAAgB,eAAe,YAAY,KAClD,OAAO,YAAY,IAAI;EAG3B,IAAI,UAAU,QAAQ,QAAQ;GAE1B,MAAM,CAAC,SAAS,eAAe,QAAQ,OAAO;GAC9C,OAAO,UAAU,MAAO,cAAc;EAC1C;EAGA,OAAO,KAAK,IAAI;CACpB;AACJ;AAGA,MAAM,aAAa,IAAI,WAAW;;;;AAKlC,MAAa,SAAS,GAAG,SAAgB,WAAW,MAAM,GAAG,IAAI;AACjE,MAAa,QAAQ,GAAG,SAAgB,WAAW,KAAK,GAAG,IAAI;AAC/D,MAAa,QAAQ,GAAG,SAAgB,WAAW,KAAK,GAAG,IAAI;AAC/D,MAAa,SAAS,GAAG,SAAgB,WAAW,MAAM,GAAG,IAAI;AACjE,MAAa,YAAY,GAAG,SAAgB,WAAW,SAAS,GAAG,IAAI;AACvE,MAAa,SAAS,GAAG,SAAgB,WAAW,MAAM,GAAG,IAAI;AACjE,MAAa,SAAS,MAAW,YAAuB,WAAW,MAAM,MAAM,OAAO;AACtF,MAAa,SAAS,OAAe,cAAwB,WAAW,MAAM,OAAO,SAAS;AAC9F,MAAa,iBAAiB,WAAW,SAAS;AAClD,MAAa,QAAQ,UAAkB,WAAW,KAAK,KAAK;AAC5D,MAAa,WAAW,UAAkB,WAAW,QAAQ,KAAK;AAClE,MAAa,mBAAmB,WAAmB,WAAW,gBAAgB,MAAM;AACpF,MAAa,SAAS,WAAmB,WAAW,MAAM,MAAM;AAChE,MAAa,gBAAgB,UAAqB,WAAW,aAAa,KAAK;AAC/E,MAAa,cAAc,YAAyB,WAAW,WAAW,OAAO"}
+{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Módulo Core Logger — logging minimal sin features avanzadas\n *\n * Provee la funcionalidad esencial de logging sin mejoras visuales,\n * soporte SVG ni styling avanzado. Adecuado para apps ligeras o uso server-side.\n */\n\n// Tipos core\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Utilidades core\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Formato universal y detección de entorno\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize,\n    type OutputFormat\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode\n} from './utils/environment-detector.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constantes\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\nimport { LOG_LEVELS } from './types/core.js';\n\n/**\n * Logger minimal con solo la funcionalidad core.\n *\n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n *\n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Crea una nueva instancia de CoreLogger.\n     * @param config - Configuración opcional.\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configurar según entorno\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true,\n            outputFormat: config.outputFormat ?? 'auto'\n        };\n    }\n\n    // ===== MÉTODOS DE CONFIGURACIÓN =====\n\n    /**\n     * Obtiene la configuración actual.\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Define el prefijo global para todos los mensajes de log.\n     * @param prefix - Prefijo a aplicar a todos los mensajes.\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Define el nivel de verbosity para filtrar la salida de log.\n     * @param level - Nivel de verbosity.\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Crea un logger con scope y un prefijo específico.\n     * @param prefix - Prefijo del scope.\n     * @returns Nueva instancia de CoreLogger con el prefijo asignado.\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Añade un handler personalizado para extensibilidad.\n     * @param handler - Handler que implementa la interfaz ILogHandler.\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== MÉTODOS CORE DE LOGGING =====\n\n    /**\n     * Comprueba si un nivel debe emitirse según el verbosity actual.\n     * @param level - Nivel a evaluar.\n     * @returns `true` si el nivel debe emitirse.\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const verbosity = this.config.verbosity as LogLevel;\n        return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];\n    }\n\n    /**\n     * Obtiene el prefijo efectivo (global + scope).\n     * @returns Prefijo combinado o `undefined` si no hay ninguno.\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Método principal de log con formato universal.\n     * @param level - Nivel del mensaje.\n     * @param args - Argumentos del mensaje.\n     */\n    private log(level: LogLevel, ...args: unknown[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n\n        // Elegir formato según entorno y configuración\n        if (isBrowser && this.config.enableColors) {\n            // Browser con styling CSS\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback a formato plano si falla el CSS\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js o browser sin colores: formato plano\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Llama a los handlers con metadata estructurada\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Emite mensajes de debug (prioridad más baja).\n     * @param args - Argumentos del mensaje.\n     */\n    debug(...args: unknown[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Emite mensajes informativos.\n     * @param args - Argumentos del mensaje.\n     */\n    info(...args: unknown[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Emite mensajes de advertencia.\n     * @param args - Argumentos del mensaje.\n     */\n    warn(...args: unknown[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Emite mensajes de error.\n     * @param args - Argumentos del mensaje.\n     */\n    error(...args: unknown[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Emite errores críticos (prioridad más alta).\n     * @param args - Argumentos del mensaje.\n     */\n    critical(...args: unknown[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Emite información de trace (debugging detallado).\n     * @param args - Argumentos del mensaje.\n     */\n    trace(...args: unknown[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== FEATURES AVANZADAS BÁSICAS =====\n\n    /**\n     * Muestra datos en formato tabla.\n     * @param data - Datos a mostrar.\n     * @param columns - Columnas opcionales a incluir.\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser con soporte nativo de table\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js o fallback: formato de texto plano\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Inicia un grupo colapsable en la console.\n     * @param label - Etiqueta del grupo.\n     * @param collapsed - Si el grupo inicia colapsado.\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser soporta grouping nativo\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Fallback Node.js: solo emite el label del grupo\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Cierra el grupo actual de la console.\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Fallback Node.js: emite el cierre del grupo\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Inicia un timer con el label indicado.\n     * @param label - Identificador del timer.\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Detiene un timer y emite el tiempo transcurrido.\n     * @param label - Identificador del timer previamente iniciado.\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Obtiene `performance.now()` o un fallback para entornos antiguos.\n     * @returns Timestamp en milisegundos.\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback a Date.now()\n        return Date.now();\n    }\n}\n\n// Crea y exporta una instancia singleton por conveniencia\nconst coreLogger = new CoreLogger();\n\n/**\n * Exporta métodos individuales por conveniencia (con binding correcto).\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Exporta el singleton como default\nexport default coreLogger;\n\n// Re-exporta tipos core\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"mappings":"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"}

package/dist/hooks/HookBridge.d.ts

@@ -1,26 +1,32 @@
 /**
- * @fileoverview HookBridge — HookManager facade.
- * Encapsulates hook registration, middleware pipeline, and event emission.
+ * @fileoverview HookBridge — facade de HookManager.
+ * Encapsula registro de hooks, middleware pipeline y emisión de eventos.
+ *
+ * @internal
  */
 import type { HookEvent, HookCallback, MiddlewareFn } from '../types/index.js';
 import { HookManager } from './index.js';
 /**
- * Bridge for hook and middleware management.
+ * Bridge para la gestión de hooks y middleware.
+ *
+ * @internal
  */
 export interface HookBridge {
-    /** Registers a hook for an event. Returns unsubscribe function. */
+    /** Registra un hook para un evento. Devuelve función de unsubscribe. */
     on(event: HookEvent, callback: HookCallback, priority?: number): () => void;
-    /** Registers a one-time hook. Returns unsubscribe function. */
+    /** Registra un hook one-time. Devuelve función de unsubscribe. */
     once(event: HookEvent, callback: HookCallback, priority?: number): () => void;
-    /** Removes a registered hook. Returns true if removed. */
+    /** Elimina un hook registrado. Devuelve `true` si se eliminó. */
     off(event: HookEvent, callback: HookCallback): boolean;
-    /** Adds middleware to the pipeline. Returns unsubscribe function. */
+    /** Añade middleware al pipeline. Devuelve función de unsubscribe. */
     use(middleware: MiddlewareFn, priority?: number): () => void;
-    /** Returns the underlying HookManager. */
+    /** Devuelve el HookManager subyacente. */
     getHookManager(): HookManager;
 }
 /**
- * Creates a HookBridge instance.
+ * Crea una instancia de {@link HookBridge}.
+ *
+ * @internal
  */
 export declare function createHookBridge(): HookBridge;
 //# sourceMappingURL=HookBridge.d.ts.map

package/dist/hooks/HookBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HookBridge.d.ts","sourceRoot":"","sources":["../../src/hooks/HookBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,mEAAmE;IACnE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5E,+DAA+D;IAC/D,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC9E,0DAA0D;IAC1D,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACvD,qEAAqE;IACrE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,0CAA0C;IAC1C,cAAc,IAAI,WAAW,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAwB7C"}
+{"version":3,"file":"HookBridge.d.ts","sourceRoot":"","sources":["../../src/hooks/HookBridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB,wEAAwE;IACxE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5E,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC9E,iEAAiE;IACjE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACvD,qEAAqE;IACrE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,0CAA0C;IAC1C,cAAc,IAAI,WAAW,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAwB7C"}