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

package/dist/chunks/utils-tKfBAWUM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-tKfBAWUM.js","names":[],"sources":["../../src/utils/stackTrace.ts","../../src/utils/timestamps.ts","../../src/constants.ts","../../src/utils/ansi-colors.ts","../../src/utils/output.ts","../../src/utils/formatting.ts"],"sourcesContent":["/**\n * @fileoverview Utilidades de parseo de stack traces para Advanced Logger\n */\n\nimport type { StackInfo } from '../types/index.js';\n\n/**\n * Comprueba si un nombre de archivo corresponde a un archivo minificado/bundle\n */\nfunction isMinifiedFile(filename: string): boolean {\n    // Salta si el nombre contiene patrones de minificado\n    const minifiedPatterns = [\n        /\\.min\\.js$/,\n        /\\.bundle\\.js$/,\n        /\\.chunk\\.js$/,\n        /-[\\w\\d]{8,}\\.js$/, // Nombres basados en hash\n        /Logger-[A-Za-z0-9]+\\.js$/, // Bundles de Logger\n        /node_modules/,\n        /dist\\//,\n        /build\\//,\n        /\\.mjs$/\n    ];\n\n    return minifiedPatterns.some(pattern => pattern.test(filename));\n}\n\n/**\n * Extrae un nombre de archivo limpio a partir de la ruta completa\n */\nfunction extractCleanFilename(fullPath: string): string {\n    // Extrae solo el nombre de archivo de la ruta completa\n    const filename = fullPath.split(/[/\\\\]/).pop() || fullPath;\n\n    // Elimina sufijos comunes de build/minificado\n    return filename\n        .replace(/\\.min\\.js$/, '.js')\n        .replace(/\\.bundle\\.js$/, '.js')\n        .replace(/\\.chunk\\.js$/, '.js')\n        .replace(/-[\\w\\d]{8,}\\.js$/, '.js')\n        .replace(/Logger-[A-Za-z0-9]+\\.js$/, 'logger.ts');\n}\n\n/**\n * Parsea el stack trace actual para extraer la información del caller\n */\nexport function parseStackTrace(): StackInfo | null {\n    try {\n        const stack = new Error().stack;\n        if (!stack) {\n            return null;\n        }\n\n        const lines = stack.split('\\n').filter(line => line.trim());\n\n        // Busca el primer caller que no provenga de métodos de Logger\n        for (let i = 1; i < lines.length; i++) {\n            const line = lines[i];\n\n            if (!line) {\n                continue;\n            }\n\n            // Salta si la línea contiene métodos de Logger o parseStackTrace\n            if (line.includes('parseStackTrace') ||\n                line.includes('Logger.') ||\n                line.includes('.log(') ||\n                line.includes('createStyledOutput')) {\n                continue;\n            }\n\n            // Parsea distintos formatos de stack trace\n            let match;\n\n            // Formato Chrome: \"at functionName (file:line:column)\" o \"at file:line:column\"\n            const chromeMatch = line.match(/at\\s+(?:(.+?)\\s+\\()?(.+?):(\\d+):(\\d+)\\)?$/);\n            if (chromeMatch) {\n                const filename = chromeMatch[2];\n                // Salta archivos minificados/bundle\n                if (filename && isMinifiedFile(filename)) {\n                    continue;\n                }\n                match = chromeMatch;\n            } else {\n                // Formato Firefox: \"functionName@file:line:column\"\n                const firefoxMatch = line.match(/(.+?)@(.+?):(\\d+):(\\d+)$/);\n                if (firefoxMatch) {\n                    const filename = firefoxMatch[2];\n                    // Salta archivos minificados/bundle\n                    if (filename && isMinifiedFile(filename)) {\n                        continue;\n                    }\n                    match = firefoxMatch;\n                } else {\n                    // Formato Safari/otros\n                    const safariMatch = line.match(/(\\S+)?@(.+?):(\\d+):(\\d+)$/);\n                    if (safariMatch) {\n                        const filename = safariMatch[2];\n                        // Salta archivos minificados/bundle\n                        if (filename && isMinifiedFile(filename)) {\n                            continue;\n                        }\n                        match = safariMatch;\n                    }\n                }\n            }\n\n            if (!match) {\n                continue;\n            }\n\n            const [, functionName, file, lineStr, columnStr] = match;\n\n            if (!file) {\n                continue;\n            }\n\n            // Usa la extracción limpia para evitar archivos minificados\n            const cleanFileName = extractCleanFilename(file).split('?')[0];\n            if (!cleanFileName) {\n                continue;\n            }\n\n            // Parsea los números de línea y columna\n            const lineNum = lineStr ? parseInt(lineStr, 10) : 0;\n            const columnNum = columnStr ? parseInt(columnStr, 10) : 0;\n\n            // Limpia el nombre de la función\n            const cleanFunction = functionName && functionName.trim()\n                ? functionName.trim()\n                : undefined;\n                \n            return {\n                file: cleanFileName ? cleanFileName : 'unknown',\n                line: lineNum,\n                column: columnNum,\n                function: cleanFunction\n            };\n        }\n        \n        return null;\n    } catch {\n        return null;\n    }\n}","/**\n * @fileoverview Timestamp utilities for Advanced Logger\n */\n\n/**\n * Formats the timestamp using modern Date API\n */\nexport function formatTimestamp(): string {\n    try {\n        // Use modern Temporal API if available, fallback to Date\n        const now = new Date();\n        return now.toISOString();\n    } catch {\n        return new Date().toISOString();\n    }\n}","/**\n * @fileoverview Global constants for Advanced Logger\n */\n\nimport type { LogLevel, AdaptiveColors, CLILogLevel, Verbosity } from './types/index.js';\nimport type { LevelStyleConfig } from './utils/index.js';\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG = {\n    verbosity: 'info' as const,\n    enableColors: true,\n    enableTimestamps: true,\n    enableStackTrace: true,\n    theme: 'default' as const,\n    bannerType: 'simple' as const,\n    bufferSize: 1000,\n    autoDetectTheme: true,\n    outputFormat: 'auto' as const,\n} as const;\n\n/**\n * Basic level styles for core module (minimal CSS styling)\n */\nexport const LEVEL_STYLES: Record<LogLevel | 'success', LevelStyleConfig> = {\n    trace: {\n        emoji: '🔬',\n        label: 'TRACE',\n        background: 'linear-gradient(90deg, #495057, #343a40)',\n        color: '#dee2e6',\n        border: '1px solid #495057',\n        shadow: '0 1px 2px rgba(73, 80, 87, 0.3)'\n    },\n    debug: {\n        emoji: '🔍',\n        label: 'DEBUG',\n        background: 'linear-gradient(90deg, #6c757d, #495057)',\n        color: '#ffffff',\n        border: '1px solid #6c757d',\n        shadow: '0 2px 4px rgba(108, 117, 125, 0.3)'\n    },\n    info: {\n        emoji: 'ℹ️',\n        label: 'INFO',\n        background: 'linear-gradient(90deg, #007bff, #0056b3)',\n        color: '#ffffff',\n        border: '1px solid #007bff',\n        shadow: '0 2px 4px rgba(0, 123, 255, 0.3)'\n    },\n    warn: {\n        emoji: '⚠️',\n        label: 'WARN',\n        background: 'linear-gradient(90deg, #ffc107, #e0a800)',\n        color: '#000000',\n        border: '1px solid #ffc107',\n        shadow: '0 2px 4px rgba(255, 193, 7, 0.3)'\n    },\n    error: {\n        emoji: '❌',\n        label: 'ERROR',\n        background: 'linear-gradient(90deg, #dc3545, #c82333)',\n        color: '#ffffff',\n        border: '1px solid #dc3545',\n        shadow: '0 2px 4px rgba(220, 53, 69, 0.3)'\n    },\n    critical: {\n        emoji: '🚨',\n        label: 'CRITICAL',\n        background: 'linear-gradient(90deg, #8B0000, #FF0000)',\n        color: '#ffffff',\n        border: '2px solid #FF0000',\n        shadow: '0 4px 8px rgba(255, 0, 0, 0.4)'\n    },\n    success: {\n        emoji: '✅',\n        label: 'SUCCESS',\n        background: 'linear-gradient(90deg, #28a745, #1e7e34)',\n        color: '#ffffff',\n        border: '1px solid #28a745',\n        shadow: '0 2px 4px rgba(40, 167, 69, 0.3)'\n    }\n} as const;\n\n/**\n * Time parsing constants for relative time filters\n */\nexport const TIME_UNITS = {\n    ms: 1,\n    s: 1000,\n    m: 60 * 1000,\n    h: 60 * 60 * 1000,\n    d: 24 * 60 * 60 * 1000,\n} as const;\n\n/**\n * Export format definitions with extensions\n */\nexport const EXPORT_FORMATS = {\n    json: { extension: '.json', mimeType: 'application/json' },\n    csv: { extension: '.csv', mimeType: 'text/csv' },\n    markdown: { extension: '.md', mimeType: 'text/markdown' },\n    plain: { extension: '.txt', mimeType: 'text/plain' },\n    html: { extension: '.html', mimeType: 'text/html' },\n} as const;\n\n/**\n * Adaptive color configurations for DevTools theme compatibility\n */\nexport const ADAPTIVE_COLORS = {\n    timestamp: {\n        light: '#666666',\n        dark: '#a0a0a0',\n    },\n    messageText: {\n        light: '#2d3748',\n        dark: '#f7fafc',\n    },\n    prefix: {\n        light: '#2d3748',\n        dark: '#e2e8f0',\n    },\n    prefixBackground: {\n        light: '#2d3748',\n        dark: '#4a5568',\n    },\n    location: {\n        light: '#718096',\n        dark: '#a0aec0',\n    },\n} as const satisfies Record<string, AdaptiveColors>;\n\n/**\n * CLI log level to internal verbosity mapping\n */\nexport const CLI_LEVEL_MAP: Record<CLILogLevel, { verbosity: Verbosity; showPrimitives: boolean }> = {\n    silent:  { verbosity: 'silent',  showPrimitives: false },\n    quiet:   { verbosity: 'error',   showPrimitives: false },\n    normal:  { verbosity: 'info',    showPrimitives: true  },\n    verbose: { verbosity: 'debug',   showPrimitives: true  },\n    debug:   { verbosity: 'debug',   showPrimitives: true  },\n} as const;","/**\n * @fileoverview Utilidades de colores ANSI para entornos de terminal\n */\n\nimport type { LogLevel } from '../types/index.js';\nimport { supportsANSI } from './environment-detector.js';\n\n/**\n * Códigos de color ANSI para estilos en terminal\n */\nexport const ANSI_CODES = {\n    // Colors\n    black: 30,\n    red: 31,\n    green: 32,\n    yellow: 33,\n    blue: 34,\n    magenta: 35,\n    cyan: 36,\n    white: 37,\n\n    // Bright colors\n    brightBlack: 90,\n    brightRed: 91,\n    brightGreen: 92,\n    brightYellow: 93,\n    brightBlue: 94,\n    brightMagenta: 95,\n    brightCyan: 96,\n    brightWhite: 97,\n\n    // Background colors\n    bgBlack: 40,\n    bgRed: 41,\n    bgGreen: 42,\n    bgYellow: 43,\n    bgBlue: 44,\n    bgMagenta: 45,\n    bgCyan: 46,\n    bgWhite: 47,\n\n    // Background bright colors\n    bgBrightBlack: 100,\n    bgBrightRed: 101,\n    bgBrightGreen: 102,\n    bgBrightYellow: 103,\n    bgBrightBlue: 104,\n    bgBrightMagenta: 105,\n    bgBrightCyan: 106,\n    bgBrightWhite: 107,\n\n    // Styles\n    reset: 0,\n    bold: 1,\n    dim: 2,\n    italic: 3,\n    underline: 4,\n    blink: 5,\n    inverse: 7,\n    hidden: 8,\n    strikethrough: 9,\n\n    // Reset specific\n    resetBold: 22,\n    resetDim: 22,\n    resetItalic: 23,\n    resetUnderline: 24,\n    resetBlink: 25,\n    resetInverse: 27,\n    resetHidden: 28,\n    resetStrikethrough: 29\n} as const;\n\n/**\n * Presets de colores ANSI para los distintos niveles de log\n */\nexport const ANSI_LEVEL_STYLES: Record<LogLevel | 'success', {\n    color: number;\n    background?: number;\n    styles: number[];\n    emoji: string;\n}> = {\n    trace: {\n        color: ANSI_CODES.brightBlack,\n        styles: [ANSI_CODES.dim],\n        emoji: '🔬'\n    },\n    debug: {\n        color: ANSI_CODES.brightBlack,\n        styles: [ANSI_CODES.dim],\n        emoji: '🔍'\n    },\n    info: {\n        color: ANSI_CODES.blue,\n        styles: [ANSI_CODES.bold],\n        emoji: 'ℹ️'\n    },\n    warn: {\n        color: ANSI_CODES.yellow,\n        background: ANSI_CODES.bgYellow,\n        styles: [ANSI_CODES.bold, ANSI_CODES.black],\n        emoji: '⚠️'\n    },\n    error: {\n        color: ANSI_CODES.red,\n        background: ANSI_CODES.bgRed,\n        styles: [ANSI_CODES.bold],\n        emoji: '❌'\n    },\n    critical: {\n        color: ANSI_CODES.white,\n        background: ANSI_CODES.bgRed,\n        styles: [ANSI_CODES.bold, ANSI_CODES.blink],\n        emoji: '🚨'\n    },\n    success: {\n        color: ANSI_CODES.green,\n        background: ANSI_CODES.bgGreen,\n        styles: [ANSI_CODES.bold],\n        emoji: '✅'\n    }\n};\n\n/**\n * Crea una secuencia de escape ANSI\n */\nfunction ansi(code: number | number[]): string {\n    const codes = Array.isArray(code) ? code : [code];\n    return `\\x1b[${codes.join(';')}m`;\n}\n\n/**\n * Aplica estilos ANSI al texto\n */\nexport function ansiStyle(text: string, codes: number[]): string {\n    if (!supportsANSI()) return text;\n    return `${ansi(codes)}${text}${ansi(ANSI_CODES.reset)}`;\n}\n\n/**\n * Aplica color al texto\n */\nexport function ansiColor(text: string, color: number): string {\n    return ansiStyle(text, [color]);\n}\n\n/**\n * Aplica color de fondo al texto\n */\nexport function ansiBackground(text: string, bg: number, color?: number): string {\n    if (color) {\n        return ansiStyle(text, [color, bg]);\n    }\n    return ansiStyle(text, [bg]);\n}\n\n/**\n * Pone el texto en bold\n */\nexport function ansiBold(text: string): string {\n    return ansiStyle(text, [ANSI_CODES.bold]);\n}\n\n/**\n * Aplica dim al texto\n */\nexport function ansiDim(text: string): string {\n    return ansiStyle(text, [ANSI_CODES.dim]);\n}\n\n/**\n * Subraya el texto\n */\nexport function ansiUnderline(text: string): string {\n    return ansiStyle(text, [ANSI_CODES.underline]);\n}\n\n/**\n * Formatters especializados para distintos contextos\n */\n\n/**\n * Formatea el timestamp para terminal\n */\nexport function formatTimestampANSI(timestamp: string): string {\n    return ansiColor(timestamp, ANSI_CODES.brightBlack);\n}\n\n/**\n * Formatea el nivel de log para terminal\n */\nexport function formatLogLevelANSI(level: LogLevel, useEmojis: boolean = true): string {\n    const style = ANSI_LEVEL_STYLES[level];\n    const emoji = useEmojis ? style.emoji : '';\n    const label = level.toUpperCase().padEnd(8);\n\n    if (!supportsANSI()) {\n        return `${emoji} ${label}`;\n    }\n\n    let codes = [style.color, ...style.styles];\n    if (style.background) {\n        codes.push(style.background);\n    }\n\n    return ansiStyle(`${emoji} ${label}`, codes);\n}\n\n/**\n * Formatea el mensaje de success para terminal\n */\nexport function formatSuccessANSI(message: string, useEmojis: boolean = true): string {\n    const style = ANSI_LEVEL_STYLES.success;\n    const emoji = useEmojis ? style.emoji : '';\n\n    if (!supportsANSI()) {\n        return `${emoji} SUCCESS: ${message}`;\n    }\n\n    const prefix = ansiStyle(`${emoji} SUCCESS:`, [style.color, ...style.styles]);\n    return `${prefix} ${message}`;\n}\n\n/**\n * Formatea el prefix para terminal\n */\nexport function formatPrefixANSI(prefix: string): string {\n    if (!supportsANSI()) {\n        return `[${prefix}]`;\n    }\n\n    return ansiStyle(`[${prefix}]`, [ANSI_CODES.cyan, ANSI_CODES.bold]);\n}\n\n/**\n * Formatea la ubicación del archivo para terminal\n */\nexport function formatLocationANSI(location: string): string {\n    if (!supportsANSI()) {\n        return `(${location})`;\n    }\n\n    return ansiColor(`(${location})`, ANSI_CODES.brightBlack);\n}","/**\n * @fileoverview Utilidades para crear output estilizado para Advanced Logger\n */\n\nimport type { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors } from '../types/index.js';\nimport { formatTimestamp } from './timestamps.js';\nimport { StyleBuilder } from '../styling/index.js';\nimport { ADAPTIVE_COLORS } from '../constants.js';\nimport { getEnvironment, supportsANSI } from './environment-detector.js';\nimport { formatLogLevelANSI, formatTimestampANSI, formatPrefixANSI, formatLocationANSI } from './ansi-colors.js';\nimport type { LogStyles } from '../types/index.js';\n\n/**\n * Configuración de estilo para cada nivel de log\n */\nexport interface LevelStyleConfig {\n    emoji: string;\n    label: string;\n    background: string;\n    color: string;\n    border: string;\n    shadow: string;\n}\n\n/**\n * Detecta la preferencia de theme actual de DevTools\n */\nexport function detectDevToolsTheme(): DevToolsTheme {\n    try {\n        if (typeof window === 'undefined' || !window.matchMedia) {\n            return 'light'; // Fallback seguro para SSR o browsers antiguos\n        }\n\n        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n        return mediaQuery.matches ? 'dark' : 'light';\n    } catch (error) {\n        console.warn('Failed to detect DevTools theme:', error);\n        return 'light'; // Fallback al theme light\n    }\n}\n\n/**\n * Obtiene el color adaptativo según el theme actual de DevTools\n */\nexport function getAdaptiveColor(colors: AdaptiveColors, theme?: DevToolsTheme): string {\n    const currentTheme = theme ?? detectDevToolsTheme();\n    return colors[currentTheme];\n}\n\n/**\n * Registra un listener de cambios de theme para actualizaciones dinámicas\n */\nexport function setupThemeChangeListener(callback: (theme: DevToolsTheme) => void): (() => void) | null {\n    try {\n        if (typeof window === 'undefined' || !window.matchMedia) {\n            return null;\n        }\n\n        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n        const handler = (e: MediaQueryListEvent) => {\n            callback(e.matches ? 'dark' : 'light');\n        };\n\n        // Usa addEventListener si está disponible, fallback a addListener\n        if (mediaQuery.addEventListener) {\n            mediaQuery.addEventListener('change', handler);\n            return () => mediaQuery.removeEventListener('change', handler);\n        } else if (mediaQuery.addListener) {\n            mediaQuery.addListener(handler);\n            return () => mediaQuery.removeListener?.(handler);\n        }\n\n        return null;\n    } catch (error) {\n        console.warn('Failed to set up theme change listener:', error);\n        return null;\n    }\n}\n\n\n/**\n * Crea output estilizado para consola con múltiples formatters `%c`\n * Se adapta automáticamente al entorno (browser o terminal)\n */\nexport function createStyledOutput(\n    level: LogLevel,\n    levelStyles: Record<LogLevel | 'success', LevelStyleConfig>,\n    prefix: string | undefined,\n    message: string,\n    stackInfo: StackInfo | null,\n    autoDetectTheme: boolean = true,\n    presetStyles?: LogStyles,\n    presetName?: string\n): [string, ...string[]] {\n    const levelConfig = levelStyles[level] ?? {\n        emoji: '📝',\n        label: level.toUpperCase(),\n        background: '#6c757d',\n        color: '#ffffff',\n        border: '1px solid #6c757d',\n        shadow: 'none'\n    };\n    const timestamp = formatTimestamp();\n    const environment = getEnvironment();\n\n    // Comprueba si se debe usar rendering en terminal\n    if (environment !== 'browser' && supportsANSI()) {\n        return createTerminalOutput(level, message, timestamp, prefix, stackInfo);\n    }\n\n    // Rendering en browser (lógica existente)\n    const currentTheme = autoDetectTheme ? detectDevToolsTheme() : 'light';\n\n    // Estilos base con colores adaptativos\n    const timestampStyle = new StyleBuilder()\n        .color(getAdaptiveColor(ADAPTIVE_COLORS.timestamp, currentTheme))\n        .size('11px')\n        .font('Monaco, Consolas, monospace')\n        .build();\n\n    const levelStyle = new StyleBuilder()\n        .bg(levelConfig.background)\n        .color(levelConfig.color)\n        .border(levelConfig.border)\n        .shadow(levelConfig.shadow)\n        .padding('2px 8px')\n        .rounded('4px')\n        .bold()\n        .font('Monaco, Consolas, monospace')\n        .size('12px')\n        .build();\n\n    const prefixStyle = new StyleBuilder()\n        .bg(getAdaptiveColor(ADAPTIVE_COLORS.prefixBackground, currentTheme))\n        .color(getAdaptiveColor(ADAPTIVE_COLORS.prefix, currentTheme))\n        .padding('2px 6px')\n        .rounded('3px')\n        .bold()\n        .font('Monaco, Consolas, monospace')\n        .size('11px')\n        .build();\n\n    const messageStyle = new StyleBuilder()\n        .color(getAdaptiveColor(ADAPTIVE_COLORS.messageText, currentTheme))\n        .font('system-ui, -apple-system, sans-serif')\n        .size('14px')\n        .build();\n\n    const locationStyle = new StyleBuilder()\n        .color(getAdaptiveColor(ADAPTIVE_COLORS.location, currentTheme))\n        .size('11px')\n        .font('Monaco, Consolas, monospace')\n        .build();\n\n    // Construye el format string y los estilos\n    let format = `%c${timestamp.slice(11, 23)} %c${levelConfig.emoji} ${levelConfig.label}`;\n    const styles = [timestampStyle, levelStyle];\n\n    if (prefix) {\n        format += ` %c${prefix}`;\n        styles.push(prefixStyle);\n    }\n\n    format += ` %c${message}`;\n    styles.push(messageStyle);\n\n    if (stackInfo) {\n        format += ` %c(${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;\n        styles.push(locationStyle);\n    }\n\n    return [format, ...styles];\n}\n\n/**\n * Construye una línea apta para terminal usando los helpers ANSI. Se usa\n * cuando el runtime no es browser pero soporta códigos ANSI (TTY, terminal moderna).\n *\n * Layout: `[HH:MM:SS.mmm] [LEVEL] [prefix] message (file:line)`\n */\nexport function createTerminalOutput(\n    level: LogLevel,\n    message: string,\n    timestamp?: string,\n    prefix?: string,\n    stackInfo?: StackInfo | null\n): [string, ...string[]] {\n    const ts = timestamp?.slice(11, 23) ?? '';\n    const location = stackInfo ? `${stackInfo.file}:${stackInfo.line}:${stackInfo.column}` : undefined;\n\n    const parts: string[] = [];\n    parts.push(formatTimestampANSI(`[${ts}]`));\n    parts.push(formatLogLevelANSI(level));\n    if (prefix) parts.push(formatPrefixANSI(prefix));\n    parts.push(message);\n    if (location) parts.push(formatLocationANSI(`(${location})`));\n\n    return [parts.join(' ') + '\\n'];\n}","/**\n * @fileoverview Utilidades de formatting para Universal Logger\n */\n\nimport type { LogLevel, StackInfo } from '../types/index.js';\nimport { formatTimestamp } from './timestamps.js';\n\n// Re-export del tipo por conveniencia\nexport type { OutputFormat } from '../types/index.js';\n\n/**\n * Crea output en texto plano para cualquier entorno\n * Sin colores ni estilos — máxima compatibilidad\n */\nexport function createPlainOutput(\n    level: LogLevel,\n    message: string,\n    prefix?: string,\n    stackInfo?: StackInfo | null\n): string {\n    const timestamp = formatTimestamp();\n    const timeStr = timestamp.slice(11, 23); // HH:MM:SS.mmm\n\n    let output = `[${timeStr}] [${level.toUpperCase()}]`;\n\n    if (prefix) {\n        output += ` [${prefix}]`;\n    }\n\n    output += ` ${message}`;\n\n    if (stackInfo) {\n        output += ` (${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;\n    }\n\n    return output;\n}\n\n/**\n * Obtiene el método de console adecuado para el nivel\n * Usa distintos métodos de console para mejor semántica\n */\nexport function getConsoleMethod(level: LogLevel): 'log' | 'info' | 'warn' | 'error' {\n    switch (level) {\n        case 'debug':\n            return 'log';\n        case 'info':\n            return 'info';\n        case 'warn':\n            return 'warn';\n        case 'error':\n        case 'critical':\n            return 'error';\n        default:\n            return 'log';\n    }\n}\n\n/**\n * Crea un objeto simple de log entry para los handlers\n */\nexport function createLogEntry(\n    level: LogLevel,\n    message: string,\n    args: any[],\n    prefix?: string,\n    stackInfo?: StackInfo | null\n) {\n    return {\n        timestamp: formatTimestamp(),\n        level: level.toUpperCase(),\n        prefix,\n        message,\n        args: args.slice(1), // Excluye el primer argumento (el mensaje)\n        location: stackInfo ? {\n            file: stackInfo.file,\n            line: stackInfo.line,\n            column: stackInfo.column,\n            function: stackInfo.function\n        } : undefined,\n        raw: args\n    };\n}\n\n/**\n * Formatea datos para visualización en tabla como texto plano\n */\nexport function formatTablePlain(data: any, columns?: string[]): string {\n    try {\n        if (Array.isArray(data)) {\n            if (data.length === 0) return '[Empty Array]';\n\n            // Formateo simple de array\n            if (typeof data[0] !== 'object') {\n                return data.map((item, i) => `${i}: ${item}`).join('\\n');\n            }\n\n            // Formateo de array de objetos\n            const keys = columns || Object.keys(data[0] || {});\n            const header = keys.join('\\t');\n            const rows = data.map(item =>\n                keys.map(key => String(item[key] || '')).join('\\t')\n            );\n\n            return [header, ...rows].join('\\n');\n        }\n\n        if (typeof data === 'object' && data !== null) {\n            // Formateo simple de objeto\n            return Object.entries(data)\n                .map(([key, value]) => `${key}: ${value}`)\n                .join('\\n');\n        }\n\n        return String(data);\n    } catch (error) {\n        return `[Error al formatear la tabla: ${error}]`;\n    }\n}\n\n/**\n * Serialización segura de objetos para logging\n */\nexport function safeSerialize(obj: any, maxDepth: number = 3, currentDepth: number = 0): any {\n    if (currentDepth >= maxDepth) {\n        return '[Max Depth Reached]';\n    }\n\n    if (obj === null) return null;\n    if (obj === undefined) return '[undefined]';\n    if (typeof obj === 'function') return '[Function]';\n    if (obj instanceof Error) return `[Error: ${obj.message}]`;\n    if (obj instanceof Date) return obj.toISOString();\n    if (typeof obj !== 'object') return obj;\n\n    if (Array.isArray(obj)) {\n        return obj.map(item => safeSerialize(item, maxDepth, currentDepth + 1));\n    }\n\n    const result: any = {};\n    for (const [key, value] of Object.entries(obj)) {\n        result[key] = safeSerialize(value, maxDepth, currentDepth + 1);\n    }\n    return result;\n}"],"mappings":"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"}

package/dist/cli/CommandProcessor.d.ts

@@ -1,31 +1,82 @@
 /**
- * @fileoverview CLI Command processor for Advanced Logger
+ * @fileoverview Procesador central del CLI del logger. Resuelve comandos,
+ * despacha ejecución, mantiene historial y soporta plugins. No es un binario
+ * standalone: se invoca vía `logger.cli()` o `window.cli()` en browser.
  */
 import type { Logger } from '../Logger.js';
 /**
- * Base interface for CLI commands
+ * Comando del CLI del logger. Cada implementación se registra en un
+ * {@link CommandProcessor} para ser invocable vía `/name` desde la consola
+ * del navegador o cualquier host interactivo.
+ *
+ * @see {@link CommandProcessor.registerCommand}
+ * @see {@link HelpCommand}
  */
 export interface ICommand {
+    /** Nombre canónico del comando, sin la barra inicial `/`. Debe ser único. */
     name: string;
+    /** Descripción corta humana; la usa el sistema de help. */
     description: string;
+    /** Sintaxis de uso mostrada en `/help`, p.ej. `/export <format>`. */
     usage: string;
+    /** Agrupación opcional para el help (`Configuration`, `Export`, ...). */
     category?: string;
+    /** Nombres alternativos sin la `/`; se resuelven al comando real. */
     aliases?: string[];
+    /**
+     * Ejecuta el comando. Recibe los argumentos como string plano (todo lo
+     * posterior al primer token, re-joined con espacios) y el {@link Logger}
+     * activo para emitir output.
+     *
+     * @param args - Argumentos del comando (string), puede ser `''`.
+     * @param logger - Logger activo.
+     */
     execute(args: string, logger: Logger): void | Promise<void>;
 }
 /**
- * Plugin interface for extending CLI functionality
+ * Plugin de CLI: agrupa uno o más {@link ICommand} con lifecycle
+ * `initialize`/`cleanup`. Permite a terceros empaquetar funcionalidad
+ * extendida (ej: integración con un dashboard, transport custom) y
+ * registrarla de golpe vía {@link CommandProcessor.registerPlugin}.
+ *
+ * @example
+ * ```ts
+ * const telemetryPlugin: ICLIPlugin = {
+ *   name: 'telemetry',
+ *   version: '1.0.0',
+ *   description: 'Comandos de telemetría',
+ *   commands: [new TelemetryDumpCommand()],
+ *   initialize(processor, logger) {
+ *     logger.info('telemetry plugin cargado');
+ *   },
+ *   cleanup() {
+ *     // liberar suscripciones/recursos
+ *   }
+ * };
+ * processor.registerPlugin(telemetryPlugin, logger);
+ * ```
+ *
+ * @see {@link CommandProcessor.registerPlugin}
  */
 export interface ICLIPlugin {
+    /** Identificador único del plugin. */
     name: string;
+    /** Versión semántica del plugin. */
     version: string;
+    /** Descripción humana corta. */
     description: string;
+    /** Comandos que el plugin aporta al registry al registrarse. */
     commands: ICommand[];
+    /** Hook opcional llamado tras el registro — útil para suscribirse a eventos del processor. */
     initialize?(processor: CommandProcessor, logger: Logger): void;
+    /** Hook opcional llamado al desregistrar el plugin — liberar recursos. */
     cleanup?(): void;
 }
 /**
- * Command history entry
+ * Entrada del historial de comandos ejecutados. No se exporta; solo circula
+ * internamente entre {@link CommandProcessor.getHistory} y el storage privado.
+ *
+ * @internal
  */
 interface HistoryEntry {
     command: string;
@@ -33,7 +84,34 @@ interface HistoryEntry {
     success: boolean;
 }
 /**
- * CLI command processor
+ * Procesador central del CLI del logger. Resuelve nombres de comando (con
+ * aliases), despacha ejecución, mantiene historial acotado (max 100 entradas)
+ * y soporta un sistema de plugins para extensión de terceros.
+ *
+ * No es un binario standalone: se invoca desde la consola del navegador vía
+ * `window.cli("<command>")` (modo interactivo habilitado por
+ * {@link enterInteractiveMode}) o desde código vía `logger.cli()`. El
+ * constructor no registra ningún comando por defecto — usar
+ * {@link createDefaultCLI} para obtener una instancia con los 8 comandos
+ * estándar ya cargados.
+ *
+ * @example
+ * ```ts
+ * const cli = createDefaultCLI();
+ * await cli.processCommand('/themes', logger);
+ * await cli.processCommand('/config theme=neon', logger);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Modo interactivo: expone `window.cli` en el navegador
+ * cli.enterInteractiveMode(logger);
+ * // Desde la devtools: cli('help')  →  procesa '/help'
+ * ```
+ *
+ * @see {@link createDefaultCLI}
+ * @see {@link ICommand}
+ * @see {@link ICLIPlugin}
  */
 export declare class CommandProcessor {
     private commands;
@@ -43,59 +121,128 @@ export declare class CommandProcessor {
     private maxHistorySize;
     private isInteractiveMode;
     /**
-     * Register a command
+     * Registra un comando. Si el comando declara `aliases`, también se indexan
+     * para resolución. Un comando con el mismo `name` sobreescribe al previo.
+     *
+     * @param {ICommand} command - Comando a registrar.
+     * @see {@link ICommand}
      */
     registerCommand(command: ICommand): void;
     /**
-     * Register a plugin
+     * Registra un plugin: indexa todos sus commands y, si el plugin define
+     * `initialize`, lo invoca con el processor y el logger. Los comandos del
+     * plugin se registran vía {@link registerCommand} y sus aliases quedan
+     * resolvibles igual que los directos.
+     *
+     * @param {ICLIPlugin} plugin - Plugin a registrar.
+     * @param {Logger} [logger] - Logger activo; requerido solo si el plugin define `initialize`.
+     * @throws {Error} Si ya existe un plugin registrado con el mismo `name`.
+     * @see {@link unregisterPlugin}
      */
     registerPlugin(plugin: ICLIPlugin, logger?: Logger): void;
     /**
-     * Unregister a plugin
+     * Desregistra un plugin por nombre: elimina todos sus commands (y los
+     * aliases que aportasen), invoca su hook `cleanup` si existe y lo quita
+     * del registry. No-op si el nombre no existe.
+     *
+     * @param {string} pluginName - Nombre del plugin a desregistrar.
+     * @see {@link registerPlugin}
      */
     unregisterPlugin(pluginName: string): void;
     /**
-     * Get all registered commands
+     * Lista todos los commands registrados (directamente o vía plugins).
+     * No incluye aliases.
+     *
+     * @returns {ICommand[]} Snapshot array de los commands registrados.
      */
     getCommands(): ICommand[];
     /**
-     * Get a specific command
+     * Resuelve un comando por nombre canónico o alias. Devuelve `undefined`
+     * si no existe ninguno que matchee.
+     *
+     * @param {string} name - Nombre canónico o alias del comando.
+     * @returns {ICommand | undefined} El comando resuelto, o `undefined`.
      */
     getCommand(name: string): ICommand | undefined;
     /**
-     * Get command history
+     * Devuelve una copia del historial de comandos ejecutados (más recientes
+     * primero). Acotado a 100 entradas por {@link maxHistorySize}; las más
+     * viejas se descartan al insertar nuevas.
+     *
+     * @returns {HistoryEntry[]} Snapshot del historial; mutar el array devuelto
+     *   no afecta al estado interno del processor.
      */
     getHistory(): HistoryEntry[];
     /**
-     * Clear command history
+     * Vacía el historial de comandos en memoria.
      */
     clearHistory(): void;
     /**
-     * Get registered plugins
+     * Lista los plugins actualmente registrados.
+     *
+     * @returns {ICLIPlugin[]} Snapshot array de plugins activos.
      */
     getPlugins(): ICLIPlugin[];
     /**
-     * Enter interactive mode
+     * Activa el modo interactivo. Marca el flag interno y, si se ejecuta en
+     * navegador, expone `window.cli(command)` para invocar comandos desde la
+     * devtools sin prefijo `/` (se añade automáticamente al input).
+     *
+     * @param {Logger} logger - Logger activo (emite el mensaje de bienvenida
+     *   con hint sobre `cli(...)` en browser).
+     * @see {@link exitInteractiveMode}
      */
     enterInteractiveMode(logger: Logger): void;
     /**
-     * Exit interactive mode
+     * Desactiva el flag de modo interactivo. Nota: no elimina el `window.cli`
+     * que {@link enterInteractiveMode} haya expuesto en el navegador — el
+     * handler global sigue vivo hasta reload.
+     *
+     * @see {@link enterInteractiveMode}
      */
     exitInteractiveMode(): void;
     /**
-     * Setup browser interactive mode
+     * Instala `window.cli(command)` como wrapper delgado alrededor de
+     * {@link processCommand}, prefijando `/` automáticamente. Solo se invoca
+     * desde {@link enterInteractiveMode} cuando `window` está disponible.
+     *
+     * @internal
+     * @param logger - Logger activo, reenviado a cada invocación.
      */
     private setupBrowserInteractiveMode;
     /**
-     * Process a CLI command
+     * Parsea y ejecuta un comando. El formato esperado es `/name args...`:
+     * split por espacios, primer token = nombre del comando, resto = args
+     * (re-joined con espacios). Si el comando no existe, loguea el error y
+     * sugiere similares vía {@link getSuggestions} ("Did you mean: ...?").
+     *
+     * Toda invocación (válida o no) se registra en el historial con flag de
+     * éxito/fallo según si `execute` resolvió o throweó.
+     *
+     * @param {string} commandString - Comando completo, debe empezar con `/`.
+     * @param {Logger} logger - Logger activo para output y errores.
+     * @returns {Promise<void>} Resuelve cuando el comando termina (sync o async).
+     *   Nunca rechaza: los errores de `execute` se capturan y se loguean.
+     * @see {@link ICommand.execute}
+     * @see {@link getSuggestions}
      */
     processCommand(commandString: string, logger: Logger): Promise<void>;
     /**
-     * Add command to history
+     * Inserta una entrada al frente del historial y trunca a
+     * {@link maxHistorySize} (100) si hace falta.
+     *
+     * @internal
+     * @param command - String crudo del comando ejecutado.
+     * @param success - Si la ejecución tuvo éxito.
      */
     private addToHistory;
     /**
-     * Get command suggestions for partial matches
+     * Devuelve nombres de comando que empiezan con el prefijo dado. Alimente
+     * el hint "Did you mean" de {@link processCommand} cuando un comando no
+     * se encuentra. Match por `startsWith` (no fuzzy).
+     *
+     * @param {string} partial - Prefijo parcial tipeado por el usuario.
+     * @returns {string[]} Nombres canónicos que matchean; aliases excluidos.
      */
     getSuggestions(partial: string): string[];
 }

package/dist/cli/CommandProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandProcessor.d.ts","sourceRoot":"","sources":["../../src/cli/CommandProcessor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,UAAU,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,OAAO,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,YAAY;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,iBAAiB,CAAkB;IAE3C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAWxC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBzD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAsB1C;;OAEG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAc9C;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU1C;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IASnC;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1E;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAI5C"}
+{"version":3,"file":"CommandProcessor.d.ts","sourceRoot":"","sources":["../../src/cli/CommandProcessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACrB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,UAAU;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,8FAA8F;IAC9F,UAAU,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,0EAA0E;IAC1E,OAAO,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,UAAU,YAAY;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,iBAAiB,CAAkB;IAE3C;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAWxC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBzD;;;;;;;OAOG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAsB1C;;;;;OAKG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAc9C;;;;;;;OAOG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;;OAIG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;;;;;;;OAQG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU1C;;;;;;OAMG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;IASnC;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1E;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAI5C"}

package/dist/cli/commands/ConfigCommand.d.ts

@@ -4,12 +4,47 @@
 import type { ICommand } from '../CommandProcessor.js';
 import type { Logger } from '../../Logger.js';
 /**
- * Configuration command handler
+ * Comando `/config` del CLI runtime del {@link Logger}. Inspecciona o muta
+ * la configuración del logger en vivo desde la DevTools console.
+ *
+ * Acepta tres modos de invocación:
+ * - Sin argumentos: vuelca el estado actual como tabla agrupada.
+ * - JSON completo (empieza con `{`): aplica un objeto de configuración parcial.
+ * - Pares `key=value` separados por coma: atajo para mutaciones puntuales.
+ *
+ * Solo se aplican las keys de la whitelist interna (`theme`, `verbosity`,
+ * `enableColors`, `enableTimestamps`, `enableStackTrace`, `globalPrefix`,
+ * `bannerType`); cualquier otra key se rechaza con un `warn` y se ignora.
+ *
+ * @example
+ * // Sin argumentos: ver estado actual
+ * // > /config
+ *
+ * @example
+ * // Objeto JSON completo
+ * // > /config {"theme":"neon","verbosity":"debug"}
+ *
+ * @example
+ * // Atajo key=value (múltiples pares separados por coma)
+ * // > /config theme=neon,verbosity=debug,globalPrefix=MiApp
+ *
+ * @see {@link ICommand} para el contrato que implementa este comando.
+ * @see {@link Logger.setTheme}, {@link Logger.setVerbosity},
+ *      {@link Logger.setBannerType}, {@link Logger.setGlobalPrefix}
+ *      para los setters subyacentes.
  */
 export declare class ConfigCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/config` contra el logger dado.
+     *
+     * @param args - Argumentos crudos del usuario. Vacío = status; con `{`
+     *               inicial = parse JSON; resto = pares `key=value` separados
+     *               por coma.
+     * @param logger - Instancia destino cuyos setters se invocan.
+     */
     execute(args: string, logger: Logger): void;
     private showStatus;
     private applyConfig;

package/dist/cli/commands/ConfigCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAyC;IACpD,KAAK,SAAkC;IAEvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B3C,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;CA+BtB"}
+{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAyC;IACpD,KAAK,SAAkC;IAEvC;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B3C,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;CA+BtB"}

package/dist/cli/commands/ExportCommand.d.ts

@@ -1,51 +1,79 @@
 /**
- * @fileoverview Export and clipboard commands for Advanced Logger CLI
+ * @fileoverview Status and demo commands for Advanced Logger CLI
  */
 import type { ICommand } from '../CommandProcessor.js';
 import type { Logger } from '../../Logger.js';
 /**
- * Export command - export logs in various formats
+ * Comando `/status` del CLI runtime del {@link Logger}. Vuelca la
+ * configuración vigente y algunas estadísticas (theme, verbosity, flags
+ * de features, handler count, bufferSize) en una tabla agrupada dentro
+ * de la consola. Es de solo lectura: no muta el logger.
+ *
+ * @example
+ * // Inspeccionar el estado actual del logger
+ * // > /status
+ *
+ * @see {@link Logger.getConfig} fuente de los datos mostrados.
  */
-export declare class ExportCommand implements ICommand {
+export declare class StatusCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
-    execute(args: string, logger: Logger): void;
-}
-/**
- * Copy command - copy logs to clipboard
- */
-export declare class CopyCommand implements ICommand {
-    name: string;
-    description: string;
-    usage: string;
-    execute(args: string, logger: Logger): Promise<void>;
-}
-/**
- * Buffer-size command - configure buffer size
- */
-export declare class BufferSizeCommand implements ICommand {
-    name: string;
-    description: string;
-    usage: string;
-    execute(args: string, logger: Logger): void;
+    /**
+     * Ejecuta el comando `/status` contra el logger dado.
+     *
+     * @param _args - Ignorado (comando sin parámetros).
+     * @param logger - Instancia de la que se lee la configuración.
+     */
+    execute(_args: string, logger: Logger): void;
 }
 /**
- * Clear-buffer command - clear log buffer
+ * Comando `/reset` del CLI runtime del {@link Logger}. Restaura la
+ * configuración a sus defaults de fábrica vía {@link Logger.resetConfig}.
+ * No resetea handlers ni transports registrados — solo config.
+ *
+ * @example
+ * // Volver a la configuración por defecto
+ * // > /reset
+ *
+ * @see {@link Logger.resetConfig} para el método subyacente.
  */
-export declare class ClearBufferCommand implements ICommand {
+export declare class ResetCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/reset` contra el logger dado.
+     *
+     * @param _args - Ignorado (comando sin parámetros).
+     * @param logger - Instancia cuya configuración se resetea.
+     */
     execute(_args: string, logger: Logger): void;
 }
 /**
- * Buffer-info command - show buffer information
+ * Comando `/demo` del CLI runtime del {@link Logger}. Ejecuta una
+ * demostración integral de las capacidades del logger: todos los niveles
+ * de log (debug → critical), tablas, timers (`time`/`timeEnd`), SVG inline
+ * y mensajes animados. Útil para validar que el styling funciona en un
+ * entorno nuevo o tras un cambio de tema.
+ *
+ * @example
+ * // Lanzar la demo completa
+ * // > /demo
+ *
+ * @see {@link Logger} para cada feature individual (`table`, `time`,
+ *      `logWithSVG`, `logAnimated`, ...).
  */
-export declare class BufferInfoCommand implements ICommand {
+export declare class DemoCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/demo` contra el logger dado.
+     *
+     * @param _args - Ignorado (comando sin parámetros).
+     * @param logger - Instancia sobre la que se ejecutan los ejemplos.
+     */
     execute(_args: string, logger: Logger): void;
 }
 //# sourceMappingURL=ExportCommand.d.ts.map

package/dist/cli/commands/ExportCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExportCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ExportCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAiG9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAoC;IAC/C,KAAK,SAAkD;IAEvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA2C9C;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA4B;IACvC,KAAK,SAAgD;IAE/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8B7D;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,IAAI,SAAiB;IACrB,WAAW,SAAyB;IACpC,KAAK,SAAyB;IAE9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAiB9C;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IAC/C,IAAI,SAAkB;IACtB,WAAW,SAA0B;IACrC,KAAK,SAAmB;IAExB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAY/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,IAAI,SAAiB;IACrB,WAAW,SAA4C;IACvD,KAAK,SAAkB;IAEvB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuB/C"}
+{"version":3,"file":"ExportCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ExportCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkD;IAC7D,KAAK,SAAa;IAElB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAkB/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,IAAI,SAAW;IACf,WAAW,SAA4C;IACvD,KAAK,SAAY;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG/C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA8C;IACzD,KAAK,SAAW;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuC/C"}

package/dist/cli/commands/ThemeCommand.d.ts

@@ -4,30 +4,89 @@
 import type { ICommand } from '../CommandProcessor.js';
 import type { Logger } from '../../Logger.js';
 /**
- * Themes command - show available themes
+ * Comando `/themes` del CLI runtime del {@link Logger}. Lista los presets
+ * temáticos disponibles en {@link THEME_PRESETS}, renderizando una preview
+ * con los colores reales de cada tema (background, foreground, border).
+ *
+ * Es de solo lectura: no muta el logger. Útil para descubrir qué tema
+ * aplicar antes de correr `/config theme=<name>`.
+ *
+ * @example
+ * // Listar todos los temas con preview coloreada
+ * // > /themes
+ *
+ * @see {@link THEME_PRESETS} para el catálogo completo de temas.
+ * @see {@link ConfigCommand} para aplicar un tema vía `/config theme=...`.
  */
 export declare class ThemesCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/themes` contra el logger dado.
+     *
+     * @param _args - Ignorado (comando sin parámetros).
+     * @param logger - Instancia usada para abrir/cerrar el `group` de salida.
+     */
     execute(_args: string, logger: Logger): void;
 }
 /**
- * Banners command - show available banner types
+ * Comando `/banners` del CLI runtime del {@link Logger}. Enumera los tipos
+ * de banner disponibles en {@link BANNER_VARIANTS} (`simple`, `ascii`,
+ * `unicode`, ...) con una mini-preview de cada uno para inspección visual.
+ *
+ * Es de solo lectura: no muta el logger. Para cambiar el banner activo
+ * usar {@link BannerCommand}.
+ *
+ * @example
+ * // Listar todas las variantes de banner con preview
+ * // > /banners
+ *
+ * @see {@link BANNER_VARIANTS} para el catálogo completo de variantes.
+ * @see {@link BannerCommand} para aplicar un tipo concreto.
  */
 export declare class BannersCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/banners` contra el logger dado.
+     *
+     * @param _args - Ignorado (comando sin parámetros).
+     * @param logger - Instancia usada para abrir/cerrar el `group` de salida.
+     */
     execute(_args: string, logger: Logger): void;
 }
 /**
- * Banner command - change/show banner type
+ * Comando `/banner [type]` del CLI runtime del {@link Logger}.
+ *
+ * - Sin argumentos: re-renderiza el banner actualmente activo.
+ * - Con un tipo válido: lo aplica vía {@link Logger.setBannerType} y lo
+ *   muestra inmediatamente.
+ * - Con un tipo inválido: loguea un `error` listando las opciones válidas.
+ *
+ * @example
+ * // Mostrar el banner actual
+ * // > /banner
+ *
+ * @example
+ * // Cambiar a un tipo concreto
+ * // > /banner ascii
+ *
+ * @see {@link BANNER_VARIANTS} para los tipos aceptados.
+ * @see {@link Logger.setBannerType} y {@link Logger.showBanner} para los
+ *      métodos subyacentes.
  */
 export declare class BannerCommand implements ICommand {
     name: string;
     description: string;
     usage: string;
+    /**
+     * Ejecuta el comando `/banner` contra el logger dado.
+     *
+     * @param args - Tipo de banner solicitado. Vacío = mostrar banner actual.
+     * @param logger - Instancia destino cuyo banner se actualiza/muestra.
+     */
     execute(args: string, logger: Logger): void;
 }
 //# sourceMappingURL=ThemeCommand.d.ts.map

package/dist/cli/commands/ThemeCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ThemeCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkC;IAC7C,KAAK,SAAa;IAElB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAgB/C;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,IAAI,SAAa;IACjB,WAAW,SAAiC;IAC5C,KAAK,SAAc;IAEnB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAoB/C;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAwC;IACnD,KAAK,SAAoB;IAEzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9C"}
+{"version":3,"file":"ThemeCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ThemeCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkC;IAC7C,KAAK,SAAa;IAElB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAgB/C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,IAAI,SAAa;IACjB,WAAW,SAAiC;IAC5C,KAAK,SAAc;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAoB/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAwC;IACnD,KAAK,SAAoB;IAEzB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9C"}