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

package/dist/chunks/StyleManager-DjwAYbxE.js

@@ -0,0 +1,113 @@
+import { n as getSmartPreset, r as hasPreset, s as THEME_PRESETS, t as getAvailablePresets } from "./styling-CRw3KQW4.js";
+//#region src/styles/StyleManager.ts
+/**
+* @fileoverview StyleManager — gestión de presets de estilo y display settings.
+*
+* Encapsula el tracking del preset activo, los toggles de visibilidad del
+* output (timestamp, location, badges) y la variable de módulo
+* {@link LEVEL_STYLES}. El Logger delega en este bridge la resolución de
+* estilos y los cambios de theme para mantener sincronizado el estado
+* compartido a nivel módulo.
+*/
+function createDefaultDisplaySettings() {
+	return {
+		showTimestamp: true,
+		showLocation: true,
+		showBadges: true
+	};
+}
+/**
+* Crea una instancia de {@link StyleManager} con display settings por defecto
+* (o los overrides que se pasen en `options`).
+*
+* Cada instancia mantiene su propio estado de preset/customization/display,
+* pero la backing store de estilos activos ({@link LEVEL_STYLES}) es
+* module-scoped: dos StyleManagers comparten la misma vista de LEVEL_STYLES.
+*
+* @param options - Overrides opcionales para los display settings iniciales.
+*
+* @example
+* ```ts
+* const sm = createStyleManager({
+*   initialDisplaySettings: { showTimestamp: false, showBadges: true }
+* });
+*
+* sm.applyPreset('cyberpunk'); // aplica preset + ajusta toggles
+* sm.setTheme('dark');         // muta LEVEL_STYLES (global al módulo)
+* console.log(sm.getStyles()); // lee el LEVEL_STYLES vigente
+* ```
+*
+* @see {@link StyleManager} para el contrato completo del bridge.
+*/
+function createStyleManager(options = {}) {
+	const displaySettings = createDefaultDisplaySettings();
+	let activePreset;
+	let activePresetName;
+	let customization;
+	return {
+		getDisplaySettings() {
+			return { ...displaySettings };
+		},
+		applyPreset(name) {
+			if (!hasPreset(name)) return false;
+			const presetConfig = getSmartPreset(name);
+			if (presetConfig) {
+				displaySettings.showTimestamp = presetConfig.timestamp?.show ?? true;
+				displaySettings.showLocation = presetConfig.location?.show ?? true;
+				activePreset = presetConfig;
+				activePresetName = name;
+			}
+			return true;
+		},
+		getAvailablePresets() {
+			return getAvailablePresets();
+		},
+		getStyles() {
+			return LEVEL_STYLES;
+		},
+		getActivePreset() {
+			return activePreset;
+		},
+		getActivePresetName() {
+			return activePresetName;
+		},
+		getCustomization() {
+			return customization;
+		},
+		setCustomization(overrides) {
+			customization = overrides;
+		},
+		resolveThemeStyle(theme) {
+			if (theme in THEME_PRESETS) return THEME_PRESETS[theme] ?? THEME_PRESETS.default;
+			return THEME_PRESETS.default;
+		},
+		setTheme(theme) {
+			if (theme in THEME_PRESETS) {
+				const newStyles = THEME_PRESETS[theme];
+				if (newStyles) {
+					LEVEL_STYLES = newStyles;
+					return true;
+				}
+			}
+			return false;
+		},
+		resetStyles() {
+			LEVEL_STYLES = THEME_PRESETS.default;
+		}
+	};
+}
+/**
+* Variable de módulo con el set de estilos activo, compartida por todas las
+* instancias de Logger/StyleManager que importan este módulo. Se exporta
+* `let` para que el Logger la pueda leer directamente sin pasar por el bridge.
+*
+* **Mutadores**: {@link StyleManager.setTheme} y {@link StyleManager.resetStyles}
+* (o el {@link resetStyles} exportado de este módulo) reasignan esta variable.
+* Cualquier referencia capturada con anterioridad queda stale — siempre leer
+* vía `LEVEL_STYLES` en punto de uso, no cacheandola.
+*/
+let LEVEL_STYLES = THEME_PRESETS.default;
+//#endregion
+export { createStyleManager as t };
+
+//# sourceMappingURL=StyleManager-DjwAYbxE.js.map

package/dist/chunks/StyleManager-DjwAYbxE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleManager-DjwAYbxE.js","names":["themeRecord"],"sources":["../../src/styles/StyleManager.ts"],"sourcesContent":["/**\n * @fileoverview StyleManager — gestión de presets de estilo y display settings.\n *\n * Encapsula el tracking del preset activo, los toggles de visibilidad del\n * output (timestamp, location, badges) y la variable de módulo\n * {@link LEVEL_STYLES}. El Logger delega en este bridge la resolución de\n * estilos y los cambios de theme para mantener sincronizado el estado\n * compartido a nivel módulo.\n */\n\nimport {\n    THEME_PRESETS,\n    type StylePresets,\n    type StyleBuilder\n} from '../styling/index.js';\nimport { getSmartPreset, getAvailablePresets, hasPreset } from '../styling/SmartPresets.js';\nimport type { ThemeVariant, LogStyles } from '../types/index.js';\n\n/**\n * Re-export de `StyleBuilder` para consumo interno del Logger dentro de este\n * paquete. La API pública de styling vive en `../styling/index.ts`; este\n * re-export existe únicamente para evitar un segundo import cruzado desde\n * Logger.ts. No considerar parte del surface público de este módulo.\n *\n * @internal\n */\nexport { StyleBuilder } from '../styling/index.js';\n\n/**\n * Toggles de visibilidad que controlan qué metadatos acompañan a cada línea\n * de log en la salida formateada. Cada preset inteligente\n * (via {@link StyleManager.applyPreset}) puede imponer sus propios defaults\n * sobreescribiendo estos valores.\n */\nexport interface DisplaySettings {\n    /** Muestra (o no) el timestamp ISO al inicio de cada línea. */\n    showTimestamp: boolean;\n    /** Muestra (o no) la ubicación del caller (file:line) parseada del stack. */\n    showLocation: boolean;\n    /** Muestra (o no) los badges de scope/nivel junto al mensaje. */\n    showBadges: boolean;\n}\n\n/**\n * Snapshot del estado interno que el StyleManager trackea en closure:\n * preset activo, overrides de `customize()` y display settings vigentes.\n * Útil para serializar/inspeccionar el estado de styling sin exponer la\n * implementación del bridge.\n */\nexport interface PresetState {\n    /** Config de estilos resuelta (referencia a {@link LEVEL_STYLES}). */\n    styles: typeof THEME_PRESETS.default;\n    /** Config del smart-preset activo (si lo hay). */\n    activePreset: unknown;\n    /** Nombre del smart-preset activo (si lo hay). */\n    activePresetName: string | undefined;\n    /** Últimos overrides aplicados via `customize()`. */\n    customization: unknown;\n    /** Toggles de visibilidad del output. */\n    displaySettings: DisplaySettings;\n}\n\n/**\n * Opciones de construcción para {@link createStyleManager}.\n */\nexport interface IStyleManagerOptions {\n    /** Display settings iniciales (parciales: se merguean sobre los defaults). */\n    initialDisplaySettings?: Partial<DisplaySettings>;\n}\n\n/**\n * Bridge que gestiona presets de estilo, display settings y el ciclo de\n * theme switching para un Logger.\n *\n * Encapsula el estado de styling en una closure para que el Logger no\n * tenga que mantener boilerplate propio. La implementación por defecto\n * (ver {@link createStyleManager}) opera sobre la variable de módulo\n * compartida {@link LEVEL_STYLES}: esto significa que `setTheme()` y\n * `resetStyles()` mutan estado global visible para TODAS las instancias\n * de Logger que comparten el módulo. Cada Logger construye su propio\n * StyleManager, pero la backing store de estilos activos es module-scoped\n * — está pensado así para que cambiar de theme una vez afecte a toda la\n * app, pero conviene saberlo al instanciar múltiples loggers con intents\n * distintos.\n */\nexport interface StyleManager {\n    /**\n     * Devuelve un shallow clone de los display settings vigentes, de modo\n     * que el caller pueda leerlos sin riesgo de mutar el estado interno.\n     */\n    getDisplaySettings(): DisplaySettings;\n    /**\n     * Aplica un smart-preset por nombre. Si el preset existe, actualiza los\n     * toggles de display (`showTimestamp`/`showLocation`) según la config\n     * del preset y memoriza su nombre/config para que el renderer pueda\n     * regenerar el output si cambia el theme.\n     *\n     * @param name - Identificador del preset (ver {@link getAvailablePresets}).\n     * @returns `true` si el preset existe y se aplicó, `false` si no se encontró.\n     */\n    applyPreset(name: string): boolean;\n    /**\n     * Lista los identificadores de todos los smart-presets registrados.\n     * Útil para alimentar un selector de UI o validar input de usuario.\n     */\n    getAvailablePresets(): string[];\n    /**\n     * Devuelve la referencia actual a {@link LEVEL_STYLES}. Como es\n     * module-scoped, refleja el último `setTheme()`/`resetStyles()` aunque\n     * provenga de otra instancia.\n     */\n    getStyles(): typeof THEME_PRESETS.default;\n    /** Devuelve la config cruda del smart-preset activo (o `undefined`). */\n    getActivePreset(): unknown;\n    /** Nombre del smart-preset activo — útil para logging diagnóstico. */\n    getActivePresetName(): string | undefined;\n    /** Último override aplicado via `Logger.customize()` (si lo hubo). */\n    getCustomization(): unknown;\n    /**\n     * Persiste overrides de customización para que el renderer los consuma\n     * en el próximo render. No muta {@link LEVEL_STYLES}.\n     */\n    setCustomization(overrides: unknown): void;\n    /**\n     * Resuelve (sin mutar nada) el set de estilos que correspondería a un\n     * theme dado. Si el theme no existe en {@link THEME_PRESETS}, cae al\n     * preset `default`. Útil para previsualizar un theme sin aplicarlo.\n     *\n     * @param theme - Variante de theme soportada por {@link THEME_PRESETS}.\n     */\n    resolveThemeStyle(theme: ThemeVariant): typeof THEME_PRESETS.default;\n    /**\n     * Aplica el theme mutando la variable de módulo {@link LEVEL_STYLES}.\n     *\n     * **Side-effect global**: como `LEVEL_STYLES` se comparte entre todas\n     * las instancias de Logger del módulo, este cambio es visible para\n     * cualquier Logger que haya en el proceso. No hay undo a nivel\n     * instancia — llamar a {@link resetStyles} para volver al default.\n     *\n     * @param theme - Variante de theme soportada por {@link THEME_PRESETS}.\n     * @returns `true` si el theme existe y se aplicó, `false` si no se encontró.\n     */\n    setTheme(theme: ThemeVariant): boolean;\n    /**\n     * Restablece {@link LEVEL_STYLES} al preset `default` de\n     * {@link THEME_PRESETS}. Al igual que {@link setTheme}, afecta a todas\n     * las instancias de Logger del módulo.\n     */\n    resetStyles(): void;\n}\n\nfunction createDefaultDisplaySettings(): DisplaySettings {\n    return {\n        showTimestamp: true,\n        showLocation: true,\n        showBadges: true\n    };\n}\n\n/**\n * Crea una instancia de {@link StyleManager} con display settings por defecto\n * (o los overrides que se pasen en `options`).\n *\n * Cada instancia mantiene su propio estado de preset/customization/display,\n * pero la backing store de estilos activos ({@link LEVEL_STYLES}) es\n * module-scoped: dos StyleManagers comparten la misma vista de LEVEL_STYLES.\n *\n * @param options - Overrides opcionales para los display settings iniciales.\n *\n * @example\n * ```ts\n * const sm = createStyleManager({\n *   initialDisplaySettings: { showTimestamp: false, showBadges: true }\n * });\n *\n * sm.applyPreset('cyberpunk'); // aplica preset + ajusta toggles\n * sm.setTheme('dark');         // muta LEVEL_STYLES (global al módulo)\n * console.log(sm.getStyles()); // lee el LEVEL_STYLES vigente\n * ```\n *\n * @see {@link StyleManager} para el contrato completo del bridge.\n */\nexport function createStyleManager(options: IStyleManagerOptions = {}): StyleManager {\n    const displaySettings = createDefaultDisplaySettings();\n    let activePreset: unknown;\n    let activePresetName: string | undefined;\n    let customization: unknown;\n\n    return {\n        getDisplaySettings(): DisplaySettings {\n            return { ...displaySettings };\n        },\n\n        applyPreset(name: string): boolean {\n            if (!hasPreset(name)) {\n                return false;\n            }\n\n            const presetConfig = getSmartPreset(name);\n            if (presetConfig) {\n                displaySettings.showTimestamp = presetConfig.timestamp?.show ?? true;\n                displaySettings.showLocation = presetConfig.location?.show ?? true;\n                activePreset = presetConfig;\n                activePresetName = name;\n            }\n            return true;\n        },\n\n        getAvailablePresets(): string[] {\n            return getAvailablePresets();\n        },\n\n        getStyles(): typeof THEME_PRESETS.default {\n            return LEVEL_STYLES;\n        },\n\n        getActivePreset(): unknown {\n            return activePreset;\n        },\n\n        getActivePresetName(): string | undefined {\n            return activePresetName;\n        },\n\n        getCustomization(): unknown {\n            return customization;\n        },\n\n        setCustomization(overrides: unknown): void {\n            customization = overrides;\n        },\n\n        resolveThemeStyle(theme: ThemeVariant): typeof THEME_PRESETS.default {\n            if (theme in THEME_PRESETS) {\n                const themeRecord = THEME_PRESETS as unknown as Record<string, typeof LEVEL_STYLES>;\n                return themeRecord[theme] ?? THEME_PRESETS.default;\n            }\n            return THEME_PRESETS.default;\n        },\n\n        setTheme(theme: ThemeVariant): boolean {\n            if (theme in THEME_PRESETS) {\n                const themeRecord = THEME_PRESETS as unknown as Record<string, typeof LEVEL_STYLES>;\n                const newStyles = themeRecord[theme];\n                if (newStyles) {\n                    LEVEL_STYLES = newStyles;\n                    return true;\n                }\n            }\n            return false;\n        },\n\n        resetStyles(): void {\n            LEVEL_STYLES = THEME_PRESETS.default;\n        }\n    };\n}\n\n/**\n * Variable de módulo con el set de estilos activo, compartida por todas las\n * instancias de Logger/StyleManager que importan este módulo. Se exporta\n * `let` para que el Logger la pueda leer directamente sin pasar por el bridge.\n *\n * **Mutadores**: {@link StyleManager.setTheme} y {@link StyleManager.resetStyles}\n * (o el {@link resetStyles} exportado de este módulo) reasignan esta variable.\n * Cualquier referencia capturada con anterioridad queda stale — siempre leer\n * vía `LEVEL_STYLES` en punto de uso, no cacheandola.\n */\nexport let LEVEL_STYLES: typeof THEME_PRESETS.default = THEME_PRESETS.default;\n\n/**\n * Restablece {@link LEVEL_STYLES} al preset `default` de {@link THEME_PRESETS}.\n *\n * Equivalente a invocar {@link StyleManager.resetStyles} sobre cualquier\n * instancia, expuesto como función libre para que código externo al Logger\n * (CLIs, tooling, tests) pueda resetear el módulo sin tener que sostener una\n * referencia al StyleManager. Mismo side-effect global que `setTheme`.\n *\n * @example\n * ```ts\n * import { resetStyles } from '@mks2508/better-logger/styles';\n * resetStyles(); // vuelve al theme default para todos los loggers del módulo\n * ```\n */\nexport function resetStyles(): void {\n    LEVEL_STYLES = THEME_PRESETS.default;\n}\n"],"mappings":";;;;;;;;;;;AAuJA,SAAS,+BAAgD;CACrD,OAAO;EACH,eAAe;EACf,cAAc;EACd,YAAY;CAChB;AACJ;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,mBAAmB,UAAgC,CAAC,GAAiB;CACjF,MAAM,kBAAkB,6BAA6B;CACrD,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,OAAO;EACH,qBAAsC;GAClC,OAAO,EAAE,GAAG,gBAAgB;EAChC;EAEA,YAAY,MAAuB;GAC/B,IAAI,CAAC,UAAU,IAAI,GACf,OAAO;GAGX,MAAM,eAAe,eAAe,IAAI;GACxC,IAAI,cAAc;IACd,gBAAgB,gBAAgB,aAAa,WAAW,QAAQ;IAChE,gBAAgB,eAAe,aAAa,UAAU,QAAQ;IAC9D,eAAe;IACf,mBAAmB;GACvB;GACA,OAAO;EACX;EAEA,sBAAgC;GAC5B,OAAO,oBAAoB;EAC/B;EAEA,YAA0C;GACtC,OAAO;EACX;EAEA,kBAA2B;GACvB,OAAO;EACX;EAEA,sBAA0C;GACtC,OAAO;EACX;EAEA,mBAA4B;GACxB,OAAO;EACX;EAEA,iBAAiB,WAA0B;GACvC,gBAAgB;EACpB;EAEA,kBAAkB,OAAmD;GACjE,IAAI,SAAS,eAET,OAAOA,cAAY,UAAU,cAAc;GAE/C,OAAO,cAAc;EACzB;EAEA,SAAS,OAA8B;GACnC,IAAI,SAAS,eAAe;IAExB,MAAM,YAAYA,cAAY;IAC9B,IAAI,WAAW;KACX,eAAe;KACf,OAAO;IACX;GACJ;GACA,OAAO;EACX;EAEA,cAAoB;GAChB,eAAe,cAAc;EACjC;CACJ;AACJ;;;;;;;;;;;AAYA,IAAW,eAA6C,cAAc"}

package/dist/chunks/core-Blfi2klP.js

@@ -0,0 +1,31 @@
+//#region src/types/core.ts
+/**
+* Niveles de log soportados en orden jerárquico
+* (trace < debug < info < warn < error < critical)
+*
+* @constant {Object} LOG_LEVELS
+* @property {number} trace - Nivel -1: Trazas muy verbosas (alineado con OTel TRACE severity 1-4)
+* @property {number} debug - Nivel 0: Información de depuración detallada
+* @property {number} info - Nivel 1: Mensajes informativos generales
+* @property {number} warn - Nivel 2: Advertencias que no detienen la ejecución
+* @property {number} error - Nivel 3: Errores que pueden afectar funcionalidad
+* @property {number} critical - Nivel 4: Errores críticos que requieren atención inmediata
+*
+* @example
+* // Verificar si un nivel debe mostrarse
+* if (LOG_LEVELS[currentLevel] >= LOG_LEVELS.warn) {
+*   // Mostrar solo warn, error y critical
+* }
+*/
+const LOG_LEVELS = {
+	trace: -1,
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	critical: 4
+};
+//#endregion
+export { LOG_LEVELS as t };
+
+//# sourceMappingURL=core-Blfi2klP.js.map

package/dist/chunks/core-Blfi2klP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-Blfi2klP.js","names":[],"sources":["../../src/types/core.ts"],"sourcesContent":["/**\n * Niveles de log soportados en orden jerárquico\n * (trace < debug < info < warn < error < critical)\n *\n * @constant {Object} LOG_LEVELS\n * @property {number} trace - Nivel -1: Trazas muy verbosas (alineado con OTel TRACE severity 1-4)\n * @property {number} debug - Nivel 0: Información de depuración detallada\n * @property {number} info - Nivel 1: Mensajes informativos generales\n * @property {number} warn - Nivel 2: Advertencias que no detienen la ejecución\n * @property {number} error - Nivel 3: Errores que pueden afectar funcionalidad\n * @property {number} critical - Nivel 4: Errores críticos que requieren atención inmediata\n *\n * @example\n * // Verificar si un nivel debe mostrarse\n * if (LOG_LEVELS[currentLevel] >= LOG_LEVELS.warn) {\n *   // Mostrar solo warn, error y critical\n * }\n */\nexport const LOG_LEVELS = {\n    trace: -1,\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    critical: 4,\n} as const;\n\n/**\n * Tipo de nivel de log derivado de las claves de LOG_LEVELS\n * @typedef {'trace' | 'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel\n */\nexport type LogLevel = keyof typeof LOG_LEVELS;\n\n/**\n * Tag especial de \"nivel\" usado por `success()` — mapea a severidad INFO de OTel.\n * Vive fuera del union `LogLevel` estándar para que las comparaciones internas\n * de nivel (trace < debug < info < warn < error < critical) no se vean alteradas.\n */\nexport const SUCCESS_LEVEL = 'success' as const;\n\n/**\n * Tags aceptados por la familia `log()` y los métodos visuales (`success()`\n * emite a severidad INFO pero usa styling de success). Útil para transports\n * que necesitan distinguir \"success\" de logs info genéricos.\n */\nexport type LogTag = LogLevel | typeof SUCCESS_LEVEL;\n\n/**\n * Tipo de nivel de verbosidad para filtrar logs\n * @typedef {LogLevel | 'silent'} Verbosity\n * @description 'silent' desactiva completamente todos los logs\n */\nexport type Verbosity = LogLevel | 'silent';\n\n/**\n * Variantes de tema para diferentes estilos visuales\n * @typedef {'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk'} ThemeVariant\n * \n * @description\n * - default: Tema adaptativo automático (claro/oscuro)\n * - dark: Tema oscuro con colores vibrantes\n * - light: Tema claro con colores suaves\n * - neon: Colores neón brillantes con efectos de resplandor\n * - minimal: Diseño minimalista y limpio\n * - cyberpunk: Estilo futurista con neón y efectos\n */\nexport type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';\n\n/**\n * Detección de tema de DevTools del navegador\n * @typedef {'light' | 'dark'} DevToolsTheme\n */\nexport type DevToolsTheme = 'light' | 'dark';\n\n/**\n * Tipos de banner para diferentes enfoques visuales\n * @typedef {'simple' | 'ascii' | 'unicode' | 'svg' | 'animated'} BannerType\n * \n * @description\n * - simple: Texto simple sin decoración\n * - ascii: Arte ASCII tradicional\n * - unicode: Caracteres Unicode decorativos\n * - svg: Gráfico SVG embebido\n * - animated: Banner con animación CSS\n */\nexport type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';\n\n/**\n * Formatos de exportación para datos de log\n * @typedef {'json' | 'csv' | 'markdown' | 'plain' | 'html'} ExportFormat\n *\n * @description\n * - json: Formato JSON estructurado\n * - csv: Valores separados por comas para Excel/Sheets\n * - markdown: Formato Markdown para documentación\n * - plain: Texto plano sin formato\n * - html: HTML con estilos para visualización web\n */\nexport type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';\n\n/**\n * Formatos de salida para diferentes entornos\n * @typedef {'auto' | 'plain' | 'ansi' | 'build' | 'ci'} OutputFormat\n *\n * @description\n * - auto: Detección automática basada en entorno (recomendado)\n * - plain: Texto plano sin colores (máxima compatibilidad)\n * - ansi: Colores ANSI para terminales modernos\n * - build: Formato optimizado para builds (Next.js, webpack, etc.)\n * - ci: Formato optimizado para CI/CD (sin emojis, texto simple)\n */\nexport type OutputFormat = 'auto' | 'plain' | 'ansi' | 'build' | 'ci';\n\n/**\n * Modos de output para controlar dónde se escriben los logs.\n * @typedef {'console' | 'silent' | 'custom'} OutputMode\n *\n * @description\n * - console: Output estándar vía `console.log` (default)\n * - silent: Sin output\n * - custom: Usa un `OutputWriter` custom para escenarios avanzados\n */\nexport type OutputMode = 'console' | 'silent' | 'custom';\n\n/**\n * Interfaz de output writer custom para redirigir el output de logs.\n *\n * @interface OutputWriter\n *\n * @description\n * Permite redirigir el output de logs a destinos custom como:\n * - DraftLog para CLI spinners con logging concurrente\n * - Buffers para colectar logs durante operaciones\n * - Streams o transports custom\n *\n * @example\n * class BufferWriter implements OutputWriter {\n *   private buffer: string[] = [];\n *\n *   write(message: string, level: LogLevel, styles: string[]): void {\n *     this.buffer.push(message);\n *   }\n *\n *   flush(): void {\n *     this.buffer.forEach(msg => console.log(msg));\n *     this.buffer = [];\n *   }\n * }\n */\nexport interface OutputWriter {\n    write(message: string, level: LogLevel, styles: string[]): void;\n    flush?(): void;\n}\n\n/**\n * Shape mínima de recurso OTel — duplicada aquí para evitar un import\n * circular con `./transports.js`. El `ILogResource` canónico vive en\n * `./transports.js`; ambos shapes se mantienen sincronizados vía el\n * contrato público (service.name + version opcional + environment opcional).\n */\nexport interface ILogResourceRef {\n    'service.name': string;\n    'service.version'?: string;\n    'deployment.environment'?: string;\n    [key: string]: string | undefined;\n}\n\n/**\n * Configuración de una instancia de `Logger`. Los campos booleanos activan\n * o desactivan features visuales (colores, timestamps, stack traces); los\n * campos selectores controlan tema, banner y formato de salida. Todos los\n * campos son opcionales salvo `verbosity`, `enableColors` y\n * `enableTimestamps`, que el constructor del logger rellena desde\n * `DEFAULT_CONFIG` cuando no se proveen.\n *\n * @example\n * const config: LoggerConfig = {\n *   globalPrefix: 'MiApp',\n *   verbosity: 'info',\n *   enableColors: true,\n *   enableTimestamps: true,\n *   enableStackTrace: false,\n *   theme: 'cyberpunk',\n *   bannerType: 'animated',\n *   bufferSize: 500,\n *   autoDetectTheme: true\n * };\n */\nexport interface LoggerConfig {\n    globalPrefix?: string;\n    verbosity: Verbosity;\n    enableColors: boolean;\n    enableTimestamps: boolean;\n    enableStackTrace: boolean;\n    theme?: ThemeVariant;\n    bannerType?: BannerType;\n    bufferSize?: number;\n    autoDetectTheme?: boolean;\n    outputFormat?: OutputFormat;\n    /** Modo de output: 'console' (default), 'silent' o 'custom'. */\n    outputMode?: OutputMode;\n    /** Writer custom cuando outputMode es 'custom'. */\n    outputWriter?: OutputWriter;\n    /** Nivel de verbosidad CLI para controlar el output primitivo. */\n    cliLevel?: CLILogLevel;\n    /**\n     * Recurso OTel por defecto adjuntado a cada record que no lo sobreescriba.\n     * Se setea una vez por proceso (service.name, service.version, deployment.environment).\n     */\n    resource?: Partial<ILogResourceRef>;\n}\n\n/**\n * Información parseada del stack trace\n * \n * @interface StackInfo\n * @description Contiene la ubicación exacta donde se originó el log\n */\nexport interface StackInfo {\n    file: string;\n    line: number;\n    column: number;\n    function?: string;\n}\n\n/**\n * Entrada de temporizador para medición de rendimiento\n * \n * @interface TimerEntry\n * @description Usado internamente para rastrear temporizadores activos\n */\nexport interface TimerEntry {\n    label: string;\n    startTime: number;\n}\n\n/**\n * Opciones para estilizar componentes\n * \n * @interface StyleOptions\n * @description Configuración de dimensiones y espaciado para elementos visuales\n */\nexport interface StyleOptions {\n    width?: number;\n    height?: number;\n    padding?: string;\n}\n\n/**\n * Configuración de colores adaptativos para temas claro/oscuro\n * \n * @interface AdaptiveColors\n * @description Define colores que se ajustan automáticamente al tema del navegador\n */\nexport interface AdaptiveColors {\n    light: string;\n    dark: string;\n}\n\n/**\n * Configuración de espaciado para elementos del log\n * @typedef {'compact' | 'normal' | 'spacious'} SpacingType\n * \n * @description\n * - compact: Espaciado mínimo para más densidad\n * - normal: Espaciado estándar balanceado\n * - spacious: Espaciado amplio para mejor legibilidad\n */\nexport type SpacingType = 'compact' | 'normal' | 'spacious';\n\n/**\n * Layout de la línea de log: spacing entre elementos, padding interior,\n * margen externo y separador entre partes. Lo consume el renderer para\n * estructurar la salida visual.\n *\n * @interface LogLayout\n */\nexport interface LogLayout {\n    spacing: SpacingType;\n    innerPadding?: string;\n    outerMargin?: string;\n    separator?: string;\n}\n\n/**\n * Estilo de un elemento individual del log (timestamp, level, prefix,\n * mensaje, location). Cada campo es opcional y se aplica solo al elemento\n * seleccionado sin tocar el resto de la línea.\n *\n * @interface LogPartConfig\n *\n * @example\n * const timestampConfig: LogPartConfig = {\n *   show: true,\n *   color: '#888',\n *   font: 'Monaco',\n *   size: '11px'\n * };\n */\nexport interface LogPartConfig {\n    show?: boolean;\n    style?: string;\n    font?: string;\n    size?: string;\n    color?: string; // Adaptativo por defecto\n    background?: string;\n    padding?: string;\n    margin?: string;\n    border?: string;\n    shadow?: string;\n    uppercase?: boolean;\n}\n\n/**\n * Estilos globales del log: layout, configuración por elemento (timestamp,\n * level, prefix, mensaje, location) y props visuales de fondo (backdrop,\n * transparency).\n *\n * @interface LogStyles\n */\nexport interface LogStyles {\n    layout?: LogLayout;\n    timestamp?: LogPartConfig;\n    level?: LogPartConfig;\n    prefix?: LogPartConfig;\n    message?: LogPartConfig;\n    location?: LogPartConfig;\n    backdrop?: string;\n    transparency?: number;\n}\n\n/**\n * Resultado de un timer completado. Lo retorna internamente `Logger.timeEnd`\n * y lo pasan los hooks en `extra` para mediciones de rendimiento.\n *\n * @property label - Etiqueta con la que se registró el timer vía `time(label)`.\n * @property duration - Milisegundos transcurridos entre `startTime` y `endTime`.\n * @property startTime - Marca temporal de inicio (`performance.now()` o `Date.now()`).\n * @property endTime - Marca temporal de fin.\n */\nexport interface TimerResult {\n    label: string;\n    duration: number;\n    startTime: number;\n    endTime: number;\n}\n\n/**\n * Contrato del logger retornado por los factory de scope (`Logger.component`,\n * `Logger.scope`). Expone los métodos de log por nivel más una API fluida\n * para badges, timers y estilos.\n *\n * Los métodos de log (`debug`, `info`, ...) devuelven `void`; los métodos de\n * configuración (`badges`, `badge`, `clearBadges`, `style`) devuelven `this`\n * para permitir encadenamiento.\n *\n * @example\n * const auth = logger.component('Auth');\n * auth.badge('JWT').info('Token validado');\n * auth.style('cyberpunk').success('Login OK');\n */\nexport interface IScopedLogger {\n    debug(...args: any[]): void;\n    info(...args: any[]): void;\n    warn(...args: any[]): void;\n    error(...args: any[]): void;\n    success(...args: any[]): void;\n    critical(...args: any[]): void;\n    trace(...args: any[]): void;\n\n    badges(badges: string[]): this;\n    badge(badge: string): this;\n    clearBadges(): this;\n\n    time(label: string): void;\n    timeEnd(label: string): number | undefined;\n\n    style(presetName: string): this;\n}\n\n/**\n * Logger especializado para servicios API. Extiende {@link IScopedLogger} con\n * verbosidades específicas de backend: latencia (`slow`), rate limiting\n * (`rateLimit`), fallos de credenciales (`auth`) y endpoints legacy\n * (`deprecated`).\n */\nexport interface IAPILogger extends IScopedLogger {\n    slow(message: string, duration?: number): void;\n    rateLimit(message: string): void;\n    auth(message: string): void;\n    deprecated(message: string): void;\n}\n\n/**\n * Logger especializado para componentes UI. Extiende {@link IScopedLogger}\n * con verbosidades de lifecycle: montaje/desmontaje (`lifecycle`), cambios\n * de estado (`stateChange`) y diffs de props (`propsChange`). Útil para\n * depurar re-renders y flujos de componentes sin inundar el log de ruido.\n */\nexport interface IComponentLogger extends IScopedLogger {\n    lifecycle(event: string, message?: string): void;\n    stateChange(from: string, to: string, data?: any): void;\n    propsChange(changes: Record<string, any>): void;\n}\n\n/**\n * Bindings inmutables que viajan con un logger scoped/child. Definen la\n * \"identidad\" del logger para filtrado, agrupación y atribución en\n * transports. Se propagan a través de `child()` y se merguean al construir\n * el {@link TransportRecord} que reciben los transports.\n *\n * @property scope - Etiqueta lógica del scope (p.ej. `\"Auth\"`, `\"API:Users\"`).\n * @property badges - Lista de badges a renderizar junto al mensaje.\n * @property type - Categoría del logger: `'scope'` (genérico), `'api'` (verbosidades HTTP), `'component'` (UI lifecycle).\n * @property context - Cadena jerárquica de contexto (parent → child) para traces anidados.\n */\nexport interface Bindings {\n    scope?: string;\n    badges?: string[];\n    type?: 'scope' | 'api' | 'component';\n    context?: string[];\n}\n\n/**\n * Estilo visual del wrapper de un badge.\n *\n * - `'brackets'` — `[badge]`\n * - `'rounded'` — `(badge)`\n * - `'plain'` — `badge` (sin wrapper)\n * - `'unicode'` — `「badge」`\n * - `'pill'` — badge con fondo redondeado estilo pill (CSS)\n */\nexport type BadgeStyle = 'brackets' | 'rounded' | 'plain' | 'unicode' | 'pill';\n\n/**\n * Formato de renderizado del timestamp en la línea de log.\n *\n * - `'iso'` — `2026-07-05T12:34:56.789Z` (default, sortable)\n * - `'time'` — `12:34:56`\n * - `'timeMs'` — `12:34:56.789`\n * - `'relative'` — tiempo relativo al momento de carga del logger\n * - `'elapsed'` — `+1.2s` transcurrido desde el primer log de la sesión\n * - `'date'` — `2026-07-05 12:34:56` (local)\n * - `'custom'` — delega al formateador custom registrado en el logger\n */\nexport type TimestampFormat = 'iso' | 'time' | 'timeMs' | 'relative' | 'elapsed' | 'date' | 'custom';\n\n/**\n * Alineación horizontal de una celda dentro de una columna de\n * `Logger.cliTable`.\n */\nexport type ColumnAlign = 'left' | 'right' | 'center';\n\n/**\n * Definición de una columna para `Logger.cliTable`. `content` es la fuente\n * del valor (clave del row o string fijo); los demás campos controlan layout\n * y color.\n *\n * @property content - Clave del row a renderizar, o string fijo para todas las filas.\n * @property width - Ancho fijo en caracteres; si se omite, se auto-detecta del contenido.\n * @property align - Alineación del contenido dentro de la celda.\n * @property color - Color del texto (hex, nombre CSS o nombre ANSI).\n */\nexport interface ColumnConfig {\n    content: string;\n    width?: number;\n    align?: ColumnAlign;\n    color?: string;\n}\n\n/**\n * Opciones de presentación aplicables a un log individual. Controlan layout\n * multi-columna, ancho máximo, modo clave-valor, estilo de badge y formato\n * de timestamp — todo sin alterar el `LoggerConfig` global del logger.\n *\n * @property rightAlign - Texto alineado a la derecha del mensaje principal (p.ej. duración).\n * @property columns - Definición de columnas para modo tabla.\n * @property maxWidth - Ancho máximo del mensaje antes de truncar/wrap.\n * @property keyValue - Si `true`, renderiza los argumentos como `clave: valor`.\n * @property badgeStyle - Override del estilo de badge para esta entrada.\n * @property timestampFormat - Override del formato de timestamp para esta entrada.\n */\nexport interface LogOptions {\n    rightAlign?: string;\n    columns?: ColumnConfig[];\n    maxWidth?: number;\n    keyValue?: boolean;\n    badgeStyle?: BadgeStyle;\n    timestampFormat?: TimestampFormat;\n}\n\n// ===== CLI PRIMITIVES =====\n\n/**\n * Niveles de verbosidad CLI para controlar el output primitivo.\n */\nexport type CLILogLevel = 'silent' | 'quiet' | 'normal' | 'verbose' | 'debug';\n\n/**\n * Handle retornado por `logger.spinner()` para controlar el ciclo de vida\n * del spinner.\n */\nexport interface ISpinnerHandle {\n    /** Arranca la animación del spinner. */\n    start(): void;\n    /** Detiene el spinner sin mensaje de status. */\n    stop(): void;\n    /** Detiene el spinner con un mensaje de success. */\n    succeed(msg?: string): void;\n    /** Detiene el spinner con un mensaje de failure. */\n    fail(msg?: string): void;\n    /** Actualiza el texto del spinner mientras corre. */\n    text(msg: string): void;\n}\n\n/**\n * Opciones para el output de `logger.box()`.\n */\nexport interface IBoxOptions {\n    /** Título mostrado en el borde superior. */\n    title?: string;\n    /** Color del borde (hex, nombre CSS o nombre ANSI). */\n    borderColor?: string;\n    /** Estilo de caracteres del borde. */\n    borderStyle?: 'single' | 'double' | 'rounded' | 'bold';\n    /** Líneas de padding interior (default: 0). */\n    padding?: number;\n}\n\n/**\n * Opciones para el output de `logger.cliTable()`.\n */\nexport interface ITableOptions {\n    /** Nombres de columnas a mostrar (sobreescribe la auto-detección). */\n    columns?: string[];\n    /** Labels del header (default: nombres de columnas). */\n    head?: string[];\n}"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,aAAa;CACtB,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,UAAU;AACd"}

package/dist/chunks/core-CqS_UBzJ.cjs

@@ -0,0 +1,36 @@
+//#region src/types/core.ts
+/**
+* Niveles de log soportados en orden jerárquico
+* (trace < debug < info < warn < error < critical)
+*
+* @constant {Object} LOG_LEVELS
+* @property {number} trace - Nivel -1: Trazas muy verbosas (alineado con OTel TRACE severity 1-4)
+* @property {number} debug - Nivel 0: Información de depuración detallada
+* @property {number} info - Nivel 1: Mensajes informativos generales
+* @property {number} warn - Nivel 2: Advertencias que no detienen la ejecución
+* @property {number} error - Nivel 3: Errores que pueden afectar funcionalidad
+* @property {number} critical - Nivel 4: Errores críticos que requieren atención inmediata
+*
+* @example
+* // Verificar si un nivel debe mostrarse
+* if (LOG_LEVELS[currentLevel] >= LOG_LEVELS.warn) {
+*   // Mostrar solo warn, error y critical
+* }
+*/
+const LOG_LEVELS = {
+	trace: -1,
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	critical: 4
+};
+//#endregion
+Object.defineProperty(exports, "LOG_LEVELS", {
+	enumerable: true,
+	get: function() {
+		return LOG_LEVELS;
+	}
+});
+
+//# sourceMappingURL=core-CqS_UBzJ.cjs.map

package/dist/chunks/core-CqS_UBzJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-CqS_UBzJ.cjs","names":[],"sources":["../../src/types/core.ts"],"sourcesContent":["/**\n * Niveles de log soportados en orden jerárquico\n * (trace < debug < info < warn < error < critical)\n *\n * @constant {Object} LOG_LEVELS\n * @property {number} trace - Nivel -1: Trazas muy verbosas (alineado con OTel TRACE severity 1-4)\n * @property {number} debug - Nivel 0: Información de depuración detallada\n * @property {number} info - Nivel 1: Mensajes informativos generales\n * @property {number} warn - Nivel 2: Advertencias que no detienen la ejecución\n * @property {number} error - Nivel 3: Errores que pueden afectar funcionalidad\n * @property {number} critical - Nivel 4: Errores críticos que requieren atención inmediata\n *\n * @example\n * // Verificar si un nivel debe mostrarse\n * if (LOG_LEVELS[currentLevel] >= LOG_LEVELS.warn) {\n *   // Mostrar solo warn, error y critical\n * }\n */\nexport const LOG_LEVELS = {\n    trace: -1,\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    critical: 4,\n} as const;\n\n/**\n * Tipo de nivel de log derivado de las claves de LOG_LEVELS\n * @typedef {'trace' | 'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel\n */\nexport type LogLevel = keyof typeof LOG_LEVELS;\n\n/**\n * Tag especial de \"nivel\" usado por `success()` — mapea a severidad INFO de OTel.\n * Vive fuera del union `LogLevel` estándar para que las comparaciones internas\n * de nivel (trace < debug < info < warn < error < critical) no se vean alteradas.\n */\nexport const SUCCESS_LEVEL = 'success' as const;\n\n/**\n * Tags aceptados por la familia `log()` y los métodos visuales (`success()`\n * emite a severidad INFO pero usa styling de success). Útil para transports\n * que necesitan distinguir \"success\" de logs info genéricos.\n */\nexport type LogTag = LogLevel | typeof SUCCESS_LEVEL;\n\n/**\n * Tipo de nivel de verbosidad para filtrar logs\n * @typedef {LogLevel | 'silent'} Verbosity\n * @description 'silent' desactiva completamente todos los logs\n */\nexport type Verbosity = LogLevel | 'silent';\n\n/**\n * Variantes de tema para diferentes estilos visuales\n * @typedef {'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk'} ThemeVariant\n * \n * @description\n * - default: Tema adaptativo automático (claro/oscuro)\n * - dark: Tema oscuro con colores vibrantes\n * - light: Tema claro con colores suaves\n * - neon: Colores neón brillantes con efectos de resplandor\n * - minimal: Diseño minimalista y limpio\n * - cyberpunk: Estilo futurista con neón y efectos\n */\nexport type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';\n\n/**\n * Detección de tema de DevTools del navegador\n * @typedef {'light' | 'dark'} DevToolsTheme\n */\nexport type DevToolsTheme = 'light' | 'dark';\n\n/**\n * Tipos de banner para diferentes enfoques visuales\n * @typedef {'simple' | 'ascii' | 'unicode' | 'svg' | 'animated'} BannerType\n * \n * @description\n * - simple: Texto simple sin decoración\n * - ascii: Arte ASCII tradicional\n * - unicode: Caracteres Unicode decorativos\n * - svg: Gráfico SVG embebido\n * - animated: Banner con animación CSS\n */\nexport type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';\n\n/**\n * Formatos de exportación para datos de log\n * @typedef {'json' | 'csv' | 'markdown' | 'plain' | 'html'} ExportFormat\n *\n * @description\n * - json: Formato JSON estructurado\n * - csv: Valores separados por comas para Excel/Sheets\n * - markdown: Formato Markdown para documentación\n * - plain: Texto plano sin formato\n * - html: HTML con estilos para visualización web\n */\nexport type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';\n\n/**\n * Formatos de salida para diferentes entornos\n * @typedef {'auto' | 'plain' | 'ansi' | 'build' | 'ci'} OutputFormat\n *\n * @description\n * - auto: Detección automática basada en entorno (recomendado)\n * - plain: Texto plano sin colores (máxima compatibilidad)\n * - ansi: Colores ANSI para terminales modernos\n * - build: Formato optimizado para builds (Next.js, webpack, etc.)\n * - ci: Formato optimizado para CI/CD (sin emojis, texto simple)\n */\nexport type OutputFormat = 'auto' | 'plain' | 'ansi' | 'build' | 'ci';\n\n/**\n * Modos de output para controlar dónde se escriben los logs.\n * @typedef {'console' | 'silent' | 'custom'} OutputMode\n *\n * @description\n * - console: Output estándar vía `console.log` (default)\n * - silent: Sin output\n * - custom: Usa un `OutputWriter` custom para escenarios avanzados\n */\nexport type OutputMode = 'console' | 'silent' | 'custom';\n\n/**\n * Interfaz de output writer custom para redirigir el output de logs.\n *\n * @interface OutputWriter\n *\n * @description\n * Permite redirigir el output de logs a destinos custom como:\n * - DraftLog para CLI spinners con logging concurrente\n * - Buffers para colectar logs durante operaciones\n * - Streams o transports custom\n *\n * @example\n * class BufferWriter implements OutputWriter {\n *   private buffer: string[] = [];\n *\n *   write(message: string, level: LogLevel, styles: string[]): void {\n *     this.buffer.push(message);\n *   }\n *\n *   flush(): void {\n *     this.buffer.forEach(msg => console.log(msg));\n *     this.buffer = [];\n *   }\n * }\n */\nexport interface OutputWriter {\n    write(message: string, level: LogLevel, styles: string[]): void;\n    flush?(): void;\n}\n\n/**\n * Shape mínima de recurso OTel — duplicada aquí para evitar un import\n * circular con `./transports.js`. El `ILogResource` canónico vive en\n * `./transports.js`; ambos shapes se mantienen sincronizados vía el\n * contrato público (service.name + version opcional + environment opcional).\n */\nexport interface ILogResourceRef {\n    'service.name': string;\n    'service.version'?: string;\n    'deployment.environment'?: string;\n    [key: string]: string | undefined;\n}\n\n/**\n * Configuración de una instancia de `Logger`. Los campos booleanos activan\n * o desactivan features visuales (colores, timestamps, stack traces); los\n * campos selectores controlan tema, banner y formato de salida. Todos los\n * campos son opcionales salvo `verbosity`, `enableColors` y\n * `enableTimestamps`, que el constructor del logger rellena desde\n * `DEFAULT_CONFIG` cuando no se proveen.\n *\n * @example\n * const config: LoggerConfig = {\n *   globalPrefix: 'MiApp',\n *   verbosity: 'info',\n *   enableColors: true,\n *   enableTimestamps: true,\n *   enableStackTrace: false,\n *   theme: 'cyberpunk',\n *   bannerType: 'animated',\n *   bufferSize: 500,\n *   autoDetectTheme: true\n * };\n */\nexport interface LoggerConfig {\n    globalPrefix?: string;\n    verbosity: Verbosity;\n    enableColors: boolean;\n    enableTimestamps: boolean;\n    enableStackTrace: boolean;\n    theme?: ThemeVariant;\n    bannerType?: BannerType;\n    bufferSize?: number;\n    autoDetectTheme?: boolean;\n    outputFormat?: OutputFormat;\n    /** Modo de output: 'console' (default), 'silent' o 'custom'. */\n    outputMode?: OutputMode;\n    /** Writer custom cuando outputMode es 'custom'. */\n    outputWriter?: OutputWriter;\n    /** Nivel de verbosidad CLI para controlar el output primitivo. */\n    cliLevel?: CLILogLevel;\n    /**\n     * Recurso OTel por defecto adjuntado a cada record que no lo sobreescriba.\n     * Se setea una vez por proceso (service.name, service.version, deployment.environment).\n     */\n    resource?: Partial<ILogResourceRef>;\n}\n\n/**\n * Información parseada del stack trace\n * \n * @interface StackInfo\n * @description Contiene la ubicación exacta donde se originó el log\n */\nexport interface StackInfo {\n    file: string;\n    line: number;\n    column: number;\n    function?: string;\n}\n\n/**\n * Entrada de temporizador para medición de rendimiento\n * \n * @interface TimerEntry\n * @description Usado internamente para rastrear temporizadores activos\n */\nexport interface TimerEntry {\n    label: string;\n    startTime: number;\n}\n\n/**\n * Opciones para estilizar componentes\n * \n * @interface StyleOptions\n * @description Configuración de dimensiones y espaciado para elementos visuales\n */\nexport interface StyleOptions {\n    width?: number;\n    height?: number;\n    padding?: string;\n}\n\n/**\n * Configuración de colores adaptativos para temas claro/oscuro\n * \n * @interface AdaptiveColors\n * @description Define colores que se ajustan automáticamente al tema del navegador\n */\nexport interface AdaptiveColors {\n    light: string;\n    dark: string;\n}\n\n/**\n * Configuración de espaciado para elementos del log\n * @typedef {'compact' | 'normal' | 'spacious'} SpacingType\n * \n * @description\n * - compact: Espaciado mínimo para más densidad\n * - normal: Espaciado estándar balanceado\n * - spacious: Espaciado amplio para mejor legibilidad\n */\nexport type SpacingType = 'compact' | 'normal' | 'spacious';\n\n/**\n * Layout de la línea de log: spacing entre elementos, padding interior,\n * margen externo y separador entre partes. Lo consume el renderer para\n * estructurar la salida visual.\n *\n * @interface LogLayout\n */\nexport interface LogLayout {\n    spacing: SpacingType;\n    innerPadding?: string;\n    outerMargin?: string;\n    separator?: string;\n}\n\n/**\n * Estilo de un elemento individual del log (timestamp, level, prefix,\n * mensaje, location). Cada campo es opcional y se aplica solo al elemento\n * seleccionado sin tocar el resto de la línea.\n *\n * @interface LogPartConfig\n *\n * @example\n * const timestampConfig: LogPartConfig = {\n *   show: true,\n *   color: '#888',\n *   font: 'Monaco',\n *   size: '11px'\n * };\n */\nexport interface LogPartConfig {\n    show?: boolean;\n    style?: string;\n    font?: string;\n    size?: string;\n    color?: string; // Adaptativo por defecto\n    background?: string;\n    padding?: string;\n    margin?: string;\n    border?: string;\n    shadow?: string;\n    uppercase?: boolean;\n}\n\n/**\n * Estilos globales del log: layout, configuración por elemento (timestamp,\n * level, prefix, mensaje, location) y props visuales de fondo (backdrop,\n * transparency).\n *\n * @interface LogStyles\n */\nexport interface LogStyles {\n    layout?: LogLayout;\n    timestamp?: LogPartConfig;\n    level?: LogPartConfig;\n    prefix?: LogPartConfig;\n    message?: LogPartConfig;\n    location?: LogPartConfig;\n    backdrop?: string;\n    transparency?: number;\n}\n\n/**\n * Resultado de un timer completado. Lo retorna internamente `Logger.timeEnd`\n * y lo pasan los hooks en `extra` para mediciones de rendimiento.\n *\n * @property label - Etiqueta con la que se registró el timer vía `time(label)`.\n * @property duration - Milisegundos transcurridos entre `startTime` y `endTime`.\n * @property startTime - Marca temporal de inicio (`performance.now()` o `Date.now()`).\n * @property endTime - Marca temporal de fin.\n */\nexport interface TimerResult {\n    label: string;\n    duration: number;\n    startTime: number;\n    endTime: number;\n}\n\n/**\n * Contrato del logger retornado por los factory de scope (`Logger.component`,\n * `Logger.scope`). Expone los métodos de log por nivel más una API fluida\n * para badges, timers y estilos.\n *\n * Los métodos de log (`debug`, `info`, ...) devuelven `void`; los métodos de\n * configuración (`badges`, `badge`, `clearBadges`, `style`) devuelven `this`\n * para permitir encadenamiento.\n *\n * @example\n * const auth = logger.component('Auth');\n * auth.badge('JWT').info('Token validado');\n * auth.style('cyberpunk').success('Login OK');\n */\nexport interface IScopedLogger {\n    debug(...args: any[]): void;\n    info(...args: any[]): void;\n    warn(...args: any[]): void;\n    error(...args: any[]): void;\n    success(...args: any[]): void;\n    critical(...args: any[]): void;\n    trace(...args: any[]): void;\n\n    badges(badges: string[]): this;\n    badge(badge: string): this;\n    clearBadges(): this;\n\n    time(label: string): void;\n    timeEnd(label: string): number | undefined;\n\n    style(presetName: string): this;\n}\n\n/**\n * Logger especializado para servicios API. Extiende {@link IScopedLogger} con\n * verbosidades específicas de backend: latencia (`slow`), rate limiting\n * (`rateLimit`), fallos de credenciales (`auth`) y endpoints legacy\n * (`deprecated`).\n */\nexport interface IAPILogger extends IScopedLogger {\n    slow(message: string, duration?: number): void;\n    rateLimit(message: string): void;\n    auth(message: string): void;\n    deprecated(message: string): void;\n}\n\n/**\n * Logger especializado para componentes UI. Extiende {@link IScopedLogger}\n * con verbosidades de lifecycle: montaje/desmontaje (`lifecycle`), cambios\n * de estado (`stateChange`) y diffs de props (`propsChange`). Útil para\n * depurar re-renders y flujos de componentes sin inundar el log de ruido.\n */\nexport interface IComponentLogger extends IScopedLogger {\n    lifecycle(event: string, message?: string): void;\n    stateChange(from: string, to: string, data?: any): void;\n    propsChange(changes: Record<string, any>): void;\n}\n\n/**\n * Bindings inmutables que viajan con un logger scoped/child. Definen la\n * \"identidad\" del logger para filtrado, agrupación y atribución en\n * transports. Se propagan a través de `child()` y se merguean al construir\n * el {@link TransportRecord} que reciben los transports.\n *\n * @property scope - Etiqueta lógica del scope (p.ej. `\"Auth\"`, `\"API:Users\"`).\n * @property badges - Lista de badges a renderizar junto al mensaje.\n * @property type - Categoría del logger: `'scope'` (genérico), `'api'` (verbosidades HTTP), `'component'` (UI lifecycle).\n * @property context - Cadena jerárquica de contexto (parent → child) para traces anidados.\n */\nexport interface Bindings {\n    scope?: string;\n    badges?: string[];\n    type?: 'scope' | 'api' | 'component';\n    context?: string[];\n}\n\n/**\n * Estilo visual del wrapper de un badge.\n *\n * - `'brackets'` — `[badge]`\n * - `'rounded'` — `(badge)`\n * - `'plain'` — `badge` (sin wrapper)\n * - `'unicode'` — `「badge」`\n * - `'pill'` — badge con fondo redondeado estilo pill (CSS)\n */\nexport type BadgeStyle = 'brackets' | 'rounded' | 'plain' | 'unicode' | 'pill';\n\n/**\n * Formato de renderizado del timestamp en la línea de log.\n *\n * - `'iso'` — `2026-07-05T12:34:56.789Z` (default, sortable)\n * - `'time'` — `12:34:56`\n * - `'timeMs'` — `12:34:56.789`\n * - `'relative'` — tiempo relativo al momento de carga del logger\n * - `'elapsed'` — `+1.2s` transcurrido desde el primer log de la sesión\n * - `'date'` — `2026-07-05 12:34:56` (local)\n * - `'custom'` — delega al formateador custom registrado en el logger\n */\nexport type TimestampFormat = 'iso' | 'time' | 'timeMs' | 'relative' | 'elapsed' | 'date' | 'custom';\n\n/**\n * Alineación horizontal de una celda dentro de una columna de\n * `Logger.cliTable`.\n */\nexport type ColumnAlign = 'left' | 'right' | 'center';\n\n/**\n * Definición de una columna para `Logger.cliTable`. `content` es la fuente\n * del valor (clave del row o string fijo); los demás campos controlan layout\n * y color.\n *\n * @property content - Clave del row a renderizar, o string fijo para todas las filas.\n * @property width - Ancho fijo en caracteres; si se omite, se auto-detecta del contenido.\n * @property align - Alineación del contenido dentro de la celda.\n * @property color - Color del texto (hex, nombre CSS o nombre ANSI).\n */\nexport interface ColumnConfig {\n    content: string;\n    width?: number;\n    align?: ColumnAlign;\n    color?: string;\n}\n\n/**\n * Opciones de presentación aplicables a un log individual. Controlan layout\n * multi-columna, ancho máximo, modo clave-valor, estilo de badge y formato\n * de timestamp — todo sin alterar el `LoggerConfig` global del logger.\n *\n * @property rightAlign - Texto alineado a la derecha del mensaje principal (p.ej. duración).\n * @property columns - Definición de columnas para modo tabla.\n * @property maxWidth - Ancho máximo del mensaje antes de truncar/wrap.\n * @property keyValue - Si `true`, renderiza los argumentos como `clave: valor`.\n * @property badgeStyle - Override del estilo de badge para esta entrada.\n * @property timestampFormat - Override del formato de timestamp para esta entrada.\n */\nexport interface LogOptions {\n    rightAlign?: string;\n    columns?: ColumnConfig[];\n    maxWidth?: number;\n    keyValue?: boolean;\n    badgeStyle?: BadgeStyle;\n    timestampFormat?: TimestampFormat;\n}\n\n// ===== CLI PRIMITIVES =====\n\n/**\n * Niveles de verbosidad CLI para controlar el output primitivo.\n */\nexport type CLILogLevel = 'silent' | 'quiet' | 'normal' | 'verbose' | 'debug';\n\n/**\n * Handle retornado por `logger.spinner()` para controlar el ciclo de vida\n * del spinner.\n */\nexport interface ISpinnerHandle {\n    /** Arranca la animación del spinner. */\n    start(): void;\n    /** Detiene el spinner sin mensaje de status. */\n    stop(): void;\n    /** Detiene el spinner con un mensaje de success. */\n    succeed(msg?: string): void;\n    /** Detiene el spinner con un mensaje de failure. */\n    fail(msg?: string): void;\n    /** Actualiza el texto del spinner mientras corre. */\n    text(msg: string): void;\n}\n\n/**\n * Opciones para el output de `logger.box()`.\n */\nexport interface IBoxOptions {\n    /** Título mostrado en el borde superior. */\n    title?: string;\n    /** Color del borde (hex, nombre CSS o nombre ANSI). */\n    borderColor?: string;\n    /** Estilo de caracteres del borde. */\n    borderStyle?: 'single' | 'double' | 'rounded' | 'bold';\n    /** Líneas de padding interior (default: 0). */\n    padding?: number;\n}\n\n/**\n * Opciones para el output de `logger.cliTable()`.\n */\nexport interface ITableOptions {\n    /** Nombres de columnas a mostrar (sobreescribe la auto-detección). */\n    columns?: string[];\n    /** Labels del header (default: nombres de columnas). */\n    head?: string[];\n}"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,aAAa;CACtB,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,UAAU;AACd"}

package/dist/chunks/environment-detector-7NvnYUfr.js

@@ -0,0 +1,110 @@
+//#region src/utils/environment-detector.ts
+/**
+* Comprueba si se ejecuta en entorno Node.js
+*/
+const isNode = typeof process !== "undefined" && process.versions && process.versions.node;
+/**
+* Comprueba si se ejecuta en entorno browser
+*/
+const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+/**
+* Función principal de detección de entorno
+*/
+function getEnvironment() {
+	if (typeof globalThis !== "undefined" && globalThis.Deno) return "deno";
+	if (typeof window === "undefined" && typeof self !== "undefined" && typeof self.importScripts === "function") return "webworker";
+	if (typeof process !== "undefined" && process.versions && process.versions.node) {
+		if (isRunningInTerminal()) return "terminal";
+		return "server";
+	}
+	if (typeof window !== "undefined" && typeof document !== "undefined") return "browser";
+	return "unknown";
+}
+/**
+* Comprueba si se ejecuta en una terminal interactiva
+*/
+function isRunningInTerminal() {
+	if (typeof process === "undefined") return false;
+	const isTTY = process.stdout && process.stdout.isTTY;
+	const hasTerminalEnv = process.env && (process.env.TERM || process.env.TERM_PROGRAM || process.env.SSH_TTY || process.env.TERM_SESSION_ID);
+	const isTerminalProgram = hasTerminalEnv && [
+		"vscode",
+		"hyper",
+		"iterm",
+		"terminal",
+		"alacritty",
+		"kitty",
+		"gnome-terminal",
+		"konsole",
+		"xterm",
+		"tmux",
+		"screen"
+	].some((program) => process.env.TERM_PROGRAM?.toLowerCase().includes(program) || process.env.TERM?.toLowerCase().includes(program));
+	return Boolean(isTTY || hasTerminalEnv || isTerminalProgram);
+}
+/**
+* Comprueba si el entorno soporta colores ANSI
+*/
+function supportsANSI() {
+	const env = getEnvironment();
+	if (env === "browser") return false;
+	if (env === "terminal") return true;
+	if (env === "server") return checkServerANSISupport();
+	return false;
+}
+/**
+* Comprueba si el entorno server soporta colores ANSI
+*/
+function checkServerANSISupport() {
+	if (typeof process === "undefined") return false;
+	const supportsANSI = process.env && (process.env.COLORTERM || process.env.FORCE_COLOR || process.env.TERM && process.env.TERM !== "dumb" || process.env.TERM_PROGRAM);
+	return Boolean(supportsANSI);
+}
+/**
+* Obtiene la capacidad de color específica del entorno
+*/
+function getColorCapability() {
+	if (getEnvironment() === "browser") return "full";
+	if (!supportsANSI()) return "none";
+	if (typeof process !== "undefined" && process.env) {
+		const hasTrueColor = process.env.COLORTERM === "truecolor" || process.env.COLORTERM === "24bit";
+		const has256Colors = process.env.TERM && process.env.TERM.includes("256");
+		if (hasTrueColor || has256Colors) return "full";
+	}
+	return "basic";
+}
+/**
+* Obtiene el ancho de la terminal en columnas
+*/
+function getTerminalWidth() {
+	if (typeof process !== "undefined" && process.stdout?.columns) return process.stdout.columns;
+	return 80;
+}
+/**
+* Obtiene el alto de la terminal en filas
+*/
+function getTerminalHeight() {
+	if (typeof process !== "undefined" && process.stdout?.rows) return process.stdout.rows;
+	return 24;
+}
+/**
+* Información del entorno para debugging
+*/
+function getEnvironmentInfo() {
+	return {
+		environment: getEnvironment(),
+		supportsANSI: supportsANSI(),
+		colorCapability: getColorCapability(),
+		isTTY: typeof process !== "undefined" ? Boolean(process.stdout?.isTTY) : false,
+		platform: typeof process !== "undefined" ? process.platform : "unknown",
+		nodeVersion: typeof process !== "undefined" ? process.versions?.node : null,
+		term: typeof process !== "undefined" ? process.env?.TERM : null,
+		colorTerm: typeof process !== "undefined" ? process.env?.COLORTERM : null,
+		terminalWidth: getTerminalWidth(),
+		terminalHeight: getTerminalHeight()
+	};
+}
+//#endregion
+export { getTerminalWidth as a, isRunningInTerminal as c, getTerminalHeight as i, supportsANSI as l, getEnvironment as n, isBrowser as o, getEnvironmentInfo as r, isNode as s, getColorCapability as t };
+
+//# sourceMappingURL=environment-detector-7NvnYUfr.js.map

package/dist/chunks/environment-detector-7NvnYUfr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detector-7NvnYUfr.js","names":[],"sources":["../../src/utils/environment-detector.ts"],"sourcesContent":["/**\n * Detector de entorno — Detección robusta del entorno para el logger\n * Detecta entornos browser, terminal, server y otros runtime\n */\n\nexport type Environment = 'browser' | 'terminal' | 'server' | 'webworker' | 'deno' | 'unknown';\n\n/**\n * Comprueba si se ejecuta en entorno Node.js\n */\nexport const isNode = typeof process !== 'undefined' &&\n                      process.versions &&\n                      process.versions.node;\n\n/**\n * Comprueba si se ejecuta en entorno browser\n */\nexport const isBrowser = typeof window !== 'undefined' &&\n                          typeof document !== 'undefined';\n\n/**\n * Función principal de detección de entorno\n */\nexport function getEnvironment(): Environment {\n    // Comprueba Deno primero\n    if (typeof globalThis !== 'undefined' && (globalThis as any).Deno) {\n        return 'deno';\n    }\n\n    // Comprueba WebWorker\n    if (typeof window === 'undefined' && typeof self !== 'undefined' && typeof (self as any).importScripts === 'function') {\n        return 'webworker';\n    }\n\n    // Comprueba Node.js (entorno server)\n    if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n        // Determina si corre en una terminal o como server\n        if (isRunningInTerminal()) {\n            return 'terminal';\n        }\n        return 'server';\n    }\n\n    // Comprueba browser\n    if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        return 'browser';\n    }\n\n    return 'unknown';\n}\n\n/**\n * Comprueba si se ejecuta en una terminal interactiva\n */\nexport function isRunningInTerminal(): boolean {\n    // Comprueba indicadores comunes de terminal\n    if (typeof process === 'undefined') return false;\n\n    const isTTY = process.stdout && process.stdout.isTTY;\n    const hasTerminalEnv = process.env && (\n        process.env.TERM ||\n        process.env.TERM_PROGRAM ||\n        process.env.SSH_TTY ||\n        process.env.TERM_SESSION_ID\n    );\n\n    // Comprueba si corre dentro de programas de terminal comunes\n    const terminalPrograms = [\n        'vscode',\n        'hyper',\n        'iterm',\n        'terminal',\n        'alacritty',\n        'kitty',\n        'gnome-terminal',\n        'konsole',\n        'xterm',\n        'tmux',\n        'screen'\n    ];\n\n    const isTerminalProgram = hasTerminalEnv && terminalPrograms.some(program =>\n        process.env.TERM_PROGRAM?.toLowerCase().includes(program) ||\n        process.env.TERM?.toLowerCase().includes(program)\n    );\n\n    return Boolean(isTTY || hasTerminalEnv || isTerminalProgram);\n}\n\n/**\n * Comprueba si el entorno soporta colores ANSI\n */\nexport function supportsANSI(): boolean {\n    const env = getEnvironment();\n\n    if (env === 'browser') return false;\n    if (env === 'terminal') return true;\n    if (env === 'server') return checkServerANSISupport();\n\n    return false;\n}\n\n/**\n * Comprueba si el entorno server soporta colores ANSI\n */\nfunction checkServerANSISupport(): boolean {\n    if (typeof process === 'undefined') return false;\n\n    // Comprueba variables de entorno comunes que indican soporte ANSI\n    const supportsANSI = process.env && (\n        process.env.COLORTERM ||\n        process.env.FORCE_COLOR ||\n        (process.env.TERM && process.env.TERM !== 'dumb') ||\n        process.env.TERM_PROGRAM\n    );\n\n    return Boolean(supportsANSI);\n}\n\n/**\n * Obtiene la capacidad de color específica del entorno\n */\nexport function getColorCapability(): 'full' | 'basic' | 'none' {\n    const env = getEnvironment();\n\n    if (env === 'browser') {\n        return 'full'; // Colores CSS\n    }\n\n    if (!supportsANSI()) {\n        return 'none';\n    }\n\n    // Comprueba soporte de 256 colores o truecolor\n    if (typeof process !== 'undefined' && process.env) {\n        const hasTrueColor = process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit';\n        const has256Colors = process.env.TERM && process.env.TERM.includes('256');\n\n        if (hasTrueColor || has256Colors) {\n            return 'full';\n        }\n    }\n\n    return 'basic'; // 16 colores básicos\n}\n\n/**\n * Obtiene el ancho de la terminal en columnas\n */\nexport function getTerminalWidth(): number {\n    if (typeof process !== 'undefined' && process.stdout?.columns) {\n        return process.stdout.columns;\n    }\n    return 80;\n}\n\n/**\n * Obtiene el alto de la terminal en filas\n */\nexport function getTerminalHeight(): number {\n    if (typeof process !== 'undefined' && process.stdout?.rows) {\n        return process.stdout.rows;\n    }\n    return 24;\n}\n\n/**\n * Información del entorno para debugging\n */\nexport function getEnvironmentInfo() {\n    return {\n        environment: getEnvironment(),\n        supportsANSI: supportsANSI(),\n        colorCapability: getColorCapability(),\n        isTTY: typeof process !== 'undefined' ? Boolean(process.stdout?.isTTY) : false,\n        platform: typeof process !== 'undefined' ? process.platform : 'unknown',\n        nodeVersion: typeof process !== 'undefined' ? process.versions?.node : null,\n        term: typeof process !== 'undefined' ? process.env?.TERM : null,\n        colorTerm: typeof process !== 'undefined' ? process.env?.COLORTERM : null,\n        terminalWidth: getTerminalWidth(),\n        terminalHeight: getTerminalHeight()\n    };\n}"],"mappings":";;;;AAUA,MAAa,SAAS,OAAO,YAAY,eACnB,QAAQ,YACR,QAAQ,SAAS;;;;AAKvC,MAAa,YAAY,OAAO,WAAW,eACjB,OAAO,aAAa;;;;AAK9C,SAAgB,iBAA8B;CAE1C,IAAI,OAAO,eAAe,eAAgB,WAAmB,MACzD,OAAO;CAIX,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS,eAAe,OAAQ,KAAa,kBAAkB,YACvG,OAAO;CAIX,IAAI,OAAO,YAAY,eAAe,QAAQ,YAAY,QAAQ,SAAS,MAAM;EAE7E,IAAI,oBAAoB,GACpB,OAAO;EAEX,OAAO;CACX;CAGA,IAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aACrD,OAAO;CAGX,OAAO;AACX;;;;AAKA,SAAgB,sBAA+B;CAE3C,IAAI,OAAO,YAAY,aAAa,OAAO;CAE3C,MAAM,QAAQ,QAAQ,UAAU,QAAQ,OAAO;CAC/C,MAAM,iBAAiB,QAAQ,QAC3B,QAAQ,IAAI,QACZ,QAAQ,IAAI,gBACZ,QAAQ,IAAI,WACZ,QAAQ,IAAI;CAkBhB,MAAM,oBAAoB,kBAAkB;EAbxC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAGuD,CAAC,CAAC,MAAK,YAC9D,QAAQ,IAAI,cAAc,YAAY,CAAC,CAAC,SAAS,OAAO,KACxD,QAAQ,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,CACpD;CAEA,OAAO,QAAQ,SAAS,kBAAkB,iBAAiB;AAC/D;;;;AAKA,SAAgB,eAAwB;CACpC,MAAM,MAAM,eAAe;CAE3B,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,YAAY,OAAO;CAC/B,IAAI,QAAQ,UAAU,OAAO,uBAAuB;CAEpD,OAAO;AACX;;;;AAKA,SAAS,yBAAkC;CACvC,IAAI,OAAO,YAAY,aAAa,OAAO;CAG3C,MAAM,eAAe,QAAQ,QACzB,QAAQ,IAAI,aACZ,QAAQ,IAAI,eACX,QAAQ,IAAI,QAAQ,QAAQ,IAAI,SAAS,UAC1C,QAAQ,IAAI;CAGhB,OAAO,QAAQ,YAAY;AAC/B;;;;AAKA,SAAgB,qBAAgD;CAG5D,IAFY,eAEN,MAAM,WACR,OAAO;CAGX,IAAI,CAAC,aAAa,GACd,OAAO;CAIX,IAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;EAC/C,MAAM,eAAe,QAAQ,IAAI,cAAc,eAAe,QAAQ,IAAI,cAAc;EACxF,MAAM,eAAe,QAAQ,IAAI,QAAQ,QAAQ,IAAI,KAAK,SAAS,KAAK;EAExE,IAAI,gBAAgB,cAChB,OAAO;CAEf;CAEA,OAAO;AACX;;;;AAKA,SAAgB,mBAA2B;CACvC,IAAI,OAAO,YAAY,eAAe,QAAQ,QAAQ,SAClD,OAAO,QAAQ,OAAO;CAE1B,OAAO;AACX;;;;AAKA,SAAgB,oBAA4B;CACxC,IAAI,OAAO,YAAY,eAAe,QAAQ,QAAQ,MAClD,OAAO,QAAQ,OAAO;CAE1B,OAAO;AACX;;;;AAKA,SAAgB,qBAAqB;CACjC,OAAO;EACH,aAAa,eAAe;EAC5B,cAAc,aAAa;EAC3B,iBAAiB,mBAAmB;EACpC,OAAO,OAAO,YAAY,cAAc,QAAQ,QAAQ,QAAQ,KAAK,IAAI;EACzE,UAAU,OAAO,YAAY,cAAc,QAAQ,WAAW;EAC9D,aAAa,OAAO,YAAY,cAAc,QAAQ,UAAU,OAAO;EACvE,MAAM,OAAO,YAAY,cAAc,QAAQ,KAAK,OAAO;EAC3D,WAAW,OAAO,YAAY,cAAc,QAAQ,KAAK,YAAY;EACrE,eAAe,iBAAiB;EAChC,gBAAgB,kBAAkB;CACtC;AACJ"}

package/dist/chunks/environment-detector-D-tHkKWA.cjs

@@ -0,0 +1,163 @@
+//#region src/utils/environment-detector.ts
+/**
+* Comprueba si se ejecuta en entorno Node.js
+*/
+const isNode = typeof process !== "undefined" && process.versions && process.versions.node;
+/**
+* Comprueba si se ejecuta en entorno browser
+*/
+const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+/**
+* Función principal de detección de entorno
+*/
+function getEnvironment() {
+	if (typeof globalThis !== "undefined" && globalThis.Deno) return "deno";
+	if (typeof window === "undefined" && typeof self !== "undefined" && typeof self.importScripts === "function") return "webworker";
+	if (typeof process !== "undefined" && process.versions && process.versions.node) {
+		if (isRunningInTerminal()) return "terminal";
+		return "server";
+	}
+	if (typeof window !== "undefined" && typeof document !== "undefined") return "browser";
+	return "unknown";
+}
+/**
+* Comprueba si se ejecuta en una terminal interactiva
+*/
+function isRunningInTerminal() {
+	if (typeof process === "undefined") return false;
+	const isTTY = process.stdout && process.stdout.isTTY;
+	const hasTerminalEnv = process.env && (process.env.TERM || process.env.TERM_PROGRAM || process.env.SSH_TTY || process.env.TERM_SESSION_ID);
+	const isTerminalProgram = hasTerminalEnv && [
+		"vscode",
+		"hyper",
+		"iterm",
+		"terminal",
+		"alacritty",
+		"kitty",
+		"gnome-terminal",
+		"konsole",
+		"xterm",
+		"tmux",
+		"screen"
+	].some((program) => process.env.TERM_PROGRAM?.toLowerCase().includes(program) || process.env.TERM?.toLowerCase().includes(program));
+	return Boolean(isTTY || hasTerminalEnv || isTerminalProgram);
+}
+/**
+* Comprueba si el entorno soporta colores ANSI
+*/
+function supportsANSI() {
+	const env = getEnvironment();
+	if (env === "browser") return false;
+	if (env === "terminal") return true;
+	if (env === "server") return checkServerANSISupport();
+	return false;
+}
+/**
+* Comprueba si el entorno server soporta colores ANSI
+*/
+function checkServerANSISupport() {
+	if (typeof process === "undefined") return false;
+	const supportsANSI = process.env && (process.env.COLORTERM || process.env.FORCE_COLOR || process.env.TERM && process.env.TERM !== "dumb" || process.env.TERM_PROGRAM);
+	return Boolean(supportsANSI);
+}
+/**
+* Obtiene la capacidad de color específica del entorno
+*/
+function getColorCapability() {
+	if (getEnvironment() === "browser") return "full";
+	if (!supportsANSI()) return "none";
+	if (typeof process !== "undefined" && process.env) {
+		const hasTrueColor = process.env.COLORTERM === "truecolor" || process.env.COLORTERM === "24bit";
+		const has256Colors = process.env.TERM && process.env.TERM.includes("256");
+		if (hasTrueColor || has256Colors) return "full";
+	}
+	return "basic";
+}
+/**
+* Obtiene el ancho de la terminal en columnas
+*/
+function getTerminalWidth() {
+	if (typeof process !== "undefined" && process.stdout?.columns) return process.stdout.columns;
+	return 80;
+}
+/**
+* Obtiene el alto de la terminal en filas
+*/
+function getTerminalHeight() {
+	if (typeof process !== "undefined" && process.stdout?.rows) return process.stdout.rows;
+	return 24;
+}
+/**
+* Información del entorno para debugging
+*/
+function getEnvironmentInfo() {
+	return {
+		environment: getEnvironment(),
+		supportsANSI: supportsANSI(),
+		colorCapability: getColorCapability(),
+		isTTY: typeof process !== "undefined" ? Boolean(process.stdout?.isTTY) : false,
+		platform: typeof process !== "undefined" ? process.platform : "unknown",
+		nodeVersion: typeof process !== "undefined" ? process.versions?.node : null,
+		term: typeof process !== "undefined" ? process.env?.TERM : null,
+		colorTerm: typeof process !== "undefined" ? process.env?.COLORTERM : null,
+		terminalWidth: getTerminalWidth(),
+		terminalHeight: getTerminalHeight()
+	};
+}
+//#endregion
+Object.defineProperty(exports, "getColorCapability", {
+	enumerable: true,
+	get: function() {
+		return getColorCapability;
+	}
+});
+Object.defineProperty(exports, "getEnvironment", {
+	enumerable: true,
+	get: function() {
+		return getEnvironment;
+	}
+});
+Object.defineProperty(exports, "getEnvironmentInfo", {
+	enumerable: true,
+	get: function() {
+		return getEnvironmentInfo;
+	}
+});
+Object.defineProperty(exports, "getTerminalHeight", {
+	enumerable: true,
+	get: function() {
+		return getTerminalHeight;
+	}
+});
+Object.defineProperty(exports, "getTerminalWidth", {
+	enumerable: true,
+	get: function() {
+		return getTerminalWidth;
+	}
+});
+Object.defineProperty(exports, "isBrowser", {
+	enumerable: true,
+	get: function() {
+		return isBrowser;
+	}
+});
+Object.defineProperty(exports, "isNode", {
+	enumerable: true,
+	get: function() {
+		return isNode;
+	}
+});
+Object.defineProperty(exports, "isRunningInTerminal", {
+	enumerable: true,
+	get: function() {
+		return isRunningInTerminal;
+	}
+});
+Object.defineProperty(exports, "supportsANSI", {
+	enumerable: true,
+	get: function() {
+		return supportsANSI;
+	}
+});
+
+//# sourceMappingURL=environment-detector-D-tHkKWA.cjs.map

package/dist/chunks/environment-detector-D-tHkKWA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detector-D-tHkKWA.cjs","names":[],"sources":["../../src/utils/environment-detector.ts"],"sourcesContent":["/**\n * Detector de entorno — Detección robusta del entorno para el logger\n * Detecta entornos browser, terminal, server y otros runtime\n */\n\nexport type Environment = 'browser' | 'terminal' | 'server' | 'webworker' | 'deno' | 'unknown';\n\n/**\n * Comprueba si se ejecuta en entorno Node.js\n */\nexport const isNode = typeof process !== 'undefined' &&\n                      process.versions &&\n                      process.versions.node;\n\n/**\n * Comprueba si se ejecuta en entorno browser\n */\nexport const isBrowser = typeof window !== 'undefined' &&\n                          typeof document !== 'undefined';\n\n/**\n * Función principal de detección de entorno\n */\nexport function getEnvironment(): Environment {\n    // Comprueba Deno primero\n    if (typeof globalThis !== 'undefined' && (globalThis as any).Deno) {\n        return 'deno';\n    }\n\n    // Comprueba WebWorker\n    if (typeof window === 'undefined' && typeof self !== 'undefined' && typeof (self as any).importScripts === 'function') {\n        return 'webworker';\n    }\n\n    // Comprueba Node.js (entorno server)\n    if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n        // Determina si corre en una terminal o como server\n        if (isRunningInTerminal()) {\n            return 'terminal';\n        }\n        return 'server';\n    }\n\n    // Comprueba browser\n    if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        return 'browser';\n    }\n\n    return 'unknown';\n}\n\n/**\n * Comprueba si se ejecuta en una terminal interactiva\n */\nexport function isRunningInTerminal(): boolean {\n    // Comprueba indicadores comunes de terminal\n    if (typeof process === 'undefined') return false;\n\n    const isTTY = process.stdout && process.stdout.isTTY;\n    const hasTerminalEnv = process.env && (\n        process.env.TERM ||\n        process.env.TERM_PROGRAM ||\n        process.env.SSH_TTY ||\n        process.env.TERM_SESSION_ID\n    );\n\n    // Comprueba si corre dentro de programas de terminal comunes\n    const terminalPrograms = [\n        'vscode',\n        'hyper',\n        'iterm',\n        'terminal',\n        'alacritty',\n        'kitty',\n        'gnome-terminal',\n        'konsole',\n        'xterm',\n        'tmux',\n        'screen'\n    ];\n\n    const isTerminalProgram = hasTerminalEnv && terminalPrograms.some(program =>\n        process.env.TERM_PROGRAM?.toLowerCase().includes(program) ||\n        process.env.TERM?.toLowerCase().includes(program)\n    );\n\n    return Boolean(isTTY || hasTerminalEnv || isTerminalProgram);\n}\n\n/**\n * Comprueba si el entorno soporta colores ANSI\n */\nexport function supportsANSI(): boolean {\n    const env = getEnvironment();\n\n    if (env === 'browser') return false;\n    if (env === 'terminal') return true;\n    if (env === 'server') return checkServerANSISupport();\n\n    return false;\n}\n\n/**\n * Comprueba si el entorno server soporta colores ANSI\n */\nfunction checkServerANSISupport(): boolean {\n    if (typeof process === 'undefined') return false;\n\n    // Comprueba variables de entorno comunes que indican soporte ANSI\n    const supportsANSI = process.env && (\n        process.env.COLORTERM ||\n        process.env.FORCE_COLOR ||\n        (process.env.TERM && process.env.TERM !== 'dumb') ||\n        process.env.TERM_PROGRAM\n    );\n\n    return Boolean(supportsANSI);\n}\n\n/**\n * Obtiene la capacidad de color específica del entorno\n */\nexport function getColorCapability(): 'full' | 'basic' | 'none' {\n    const env = getEnvironment();\n\n    if (env === 'browser') {\n        return 'full'; // Colores CSS\n    }\n\n    if (!supportsANSI()) {\n        return 'none';\n    }\n\n    // Comprueba soporte de 256 colores o truecolor\n    if (typeof process !== 'undefined' && process.env) {\n        const hasTrueColor = process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit';\n        const has256Colors = process.env.TERM && process.env.TERM.includes('256');\n\n        if (hasTrueColor || has256Colors) {\n            return 'full';\n        }\n    }\n\n    return 'basic'; // 16 colores básicos\n}\n\n/**\n * Obtiene el ancho de la terminal en columnas\n */\nexport function getTerminalWidth(): number {\n    if (typeof process !== 'undefined' && process.stdout?.columns) {\n        return process.stdout.columns;\n    }\n    return 80;\n}\n\n/**\n * Obtiene el alto de la terminal en filas\n */\nexport function getTerminalHeight(): number {\n    if (typeof process !== 'undefined' && process.stdout?.rows) {\n        return process.stdout.rows;\n    }\n    return 24;\n}\n\n/**\n * Información del entorno para debugging\n */\nexport function getEnvironmentInfo() {\n    return {\n        environment: getEnvironment(),\n        supportsANSI: supportsANSI(),\n        colorCapability: getColorCapability(),\n        isTTY: typeof process !== 'undefined' ? Boolean(process.stdout?.isTTY) : false,\n        platform: typeof process !== 'undefined' ? process.platform : 'unknown',\n        nodeVersion: typeof process !== 'undefined' ? process.versions?.node : null,\n        term: typeof process !== 'undefined' ? process.env?.TERM : null,\n        colorTerm: typeof process !== 'undefined' ? process.env?.COLORTERM : null,\n        terminalWidth: getTerminalWidth(),\n        terminalHeight: getTerminalHeight()\n    };\n}"],"mappings":";;;;AAUA,MAAa,SAAS,OAAO,YAAY,eACnB,QAAQ,YACR,QAAQ,SAAS;;;;AAKvC,MAAa,YAAY,OAAO,WAAW,eACjB,OAAO,aAAa;;;;AAK9C,SAAgB,iBAA8B;CAE1C,IAAI,OAAO,eAAe,eAAgB,WAAmB,MACzD,OAAO;CAIX,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS,eAAe,OAAQ,KAAa,kBAAkB,YACvG,OAAO;CAIX,IAAI,OAAO,YAAY,eAAe,QAAQ,YAAY,QAAQ,SAAS,MAAM;EAE7E,IAAI,oBAAoB,GACpB,OAAO;EAEX,OAAO;CACX;CAGA,IAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aACrD,OAAO;CAGX,OAAO;AACX;;;;AAKA,SAAgB,sBAA+B;CAE3C,IAAI,OAAO,YAAY,aAAa,OAAO;CAE3C,MAAM,QAAQ,QAAQ,UAAU,QAAQ,OAAO;CAC/C,MAAM,iBAAiB,QAAQ,QAC3B,QAAQ,IAAI,QACZ,QAAQ,IAAI,gBACZ,QAAQ,IAAI,WACZ,QAAQ,IAAI;CAkBhB,MAAM,oBAAoB,kBAAkB;EAbxC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAGuD,CAAC,CAAC,MAAK,YAC9D,QAAQ,IAAI,cAAc,YAAY,CAAC,CAAC,SAAS,OAAO,KACxD,QAAQ,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,CACpD;CAEA,OAAO,QAAQ,SAAS,kBAAkB,iBAAiB;AAC/D;;;;AAKA,SAAgB,eAAwB;CACpC,MAAM,MAAM,eAAe;CAE3B,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,YAAY,OAAO;CAC/B,IAAI,QAAQ,UAAU,OAAO,uBAAuB;CAEpD,OAAO;AACX;;;;AAKA,SAAS,yBAAkC;CACvC,IAAI,OAAO,YAAY,aAAa,OAAO;CAG3C,MAAM,eAAe,QAAQ,QACzB,QAAQ,IAAI,aACZ,QAAQ,IAAI,eACX,QAAQ,IAAI,QAAQ,QAAQ,IAAI,SAAS,UAC1C,QAAQ,IAAI;CAGhB,OAAO,QAAQ,YAAY;AAC/B;;;;AAKA,SAAgB,qBAAgD;CAG5D,IAFY,eAEN,MAAM,WACR,OAAO;CAGX,IAAI,CAAC,aAAa,GACd,OAAO;CAIX,IAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;EAC/C,MAAM,eAAe,QAAQ,IAAI,cAAc,eAAe,QAAQ,IAAI,cAAc;EACxF,MAAM,eAAe,QAAQ,IAAI,QAAQ,QAAQ,IAAI,KAAK,SAAS,KAAK;EAExE,IAAI,gBAAgB,cAChB,OAAO;CAEf;CAEA,OAAO;AACX;;;;AAKA,SAAgB,mBAA2B;CACvC,IAAI,OAAO,YAAY,eAAe,QAAQ,QAAQ,SAClD,OAAO,QAAQ,OAAO;CAE1B,OAAO;AACX;;;;AAKA,SAAgB,oBAA4B;CACxC,IAAI,OAAO,YAAY,eAAe,QAAQ,QAAQ,MAClD,OAAO,QAAQ,OAAO;CAE1B,OAAO;AACX;;;;AAKA,SAAgB,qBAAqB;CACjC,OAAO;EACH,aAAa,eAAe;EAC5B,cAAc,aAAa;EAC3B,iBAAiB,mBAAmB;EACpC,OAAO,OAAO,YAAY,cAAc,QAAQ,QAAQ,QAAQ,KAAK,IAAI;EACzE,UAAU,OAAO,YAAY,cAAc,QAAQ,WAAW;EAC9D,aAAa,OAAO,YAAY,cAAc,QAAQ,UAAU,OAAO;EACvE,MAAM,OAAO,YAAY,cAAc,QAAQ,KAAK,OAAO;EAC3D,WAAW,OAAO,YAAY,cAAc,QAAQ,KAAK,YAAY;EACrE,eAAe,iBAAiB;EAChC,gBAAgB,kBAAkB;CACtC;AACJ"}