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

package/dist/types/handlers.d.ts

@@ -1,7 +1,4 @@
-/**
- * @fileoverview Handler and metadata type definitions for Advanced Logger
- */
-import type { LogLevel, StackInfo } from './core.js';
+import { LogLevel, StackInfo } from './core.js';
 /**
  * Metadata associated with each log entry
  */

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Type definitions exports for Advanced Logger
  */
-export type { LogLevel, Verbosity, ThemeVariant, DevToolsTheme, BannerType, ExportFormat, LoggerConfig, StackInfo, TimerEntry, StyleOptions, AdaptiveColors, SpacingType, LogLayout, LogPartConfig, LogStyles, } from './core.js';
+export type { LogLevel, Verbosity, ThemeVariant, DevToolsTheme, BannerType, ExportFormat, OutputFormat, LoggerConfig, StackInfo, TimerEntry, StyleOptions, AdaptiveColors, SpacingType, LogLayout, LogPartConfig, LogStyles, } from './core.js';
 export { LOG_LEVELS } from './core.js';
 export type { LogMetadata, ILogHandler, LogEntry, ExportFilters, ExportOptions, ExportResult, BufferStats, } from './handlers.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,YAAY,EACR,WAAW,EACX,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,GACd,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACR,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,YAAY,EACR,WAAW,EACX,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,GACd,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,156 @@
+import { LogLevel } from '../types/index.js';
+/**
+ * ANSI color codes for terminal styling
+ */
+export declare const ANSI_CODES: {
+    readonly black: 30;
+    readonly red: 31;
+    readonly green: 32;
+    readonly yellow: 33;
+    readonly blue: 34;
+    readonly magenta: 35;
+    readonly cyan: 36;
+    readonly white: 37;
+    readonly brightBlack: 90;
+    readonly brightRed: 91;
+    readonly brightGreen: 92;
+    readonly brightYellow: 93;
+    readonly brightBlue: 94;
+    readonly brightMagenta: 95;
+    readonly brightCyan: 96;
+    readonly brightWhite: 97;
+    readonly bgBlack: 40;
+    readonly bgRed: 41;
+    readonly bgGreen: 42;
+    readonly bgYellow: 43;
+    readonly bgBlue: 44;
+    readonly bgMagenta: 45;
+    readonly bgCyan: 46;
+    readonly bgWhite: 47;
+    readonly bgBrightBlack: 100;
+    readonly bgBrightRed: 101;
+    readonly bgBrightGreen: 102;
+    readonly bgBrightYellow: 103;
+    readonly bgBrightBlue: 104;
+    readonly bgBrightMagenta: 105;
+    readonly bgBrightCyan: 106;
+    readonly bgBrightWhite: 107;
+    readonly reset: 0;
+    readonly bold: 1;
+    readonly dim: 2;
+    readonly italic: 3;
+    readonly underline: 4;
+    readonly blink: 5;
+    readonly inverse: 7;
+    readonly hidden: 8;
+    readonly strikethrough: 9;
+    readonly resetBold: 22;
+    readonly resetDim: 22;
+    readonly resetItalic: 23;
+    readonly resetUnderline: 24;
+    readonly resetBlink: 25;
+    readonly resetInverse: 27;
+    readonly resetHidden: 28;
+    readonly resetStrikethrough: 29;
+};
+/**
+ * ANSI color presets for different log levels
+ */
+export declare const ANSI_LEVEL_STYLES: Record<LogLevel | 'success', {
+    color: number;
+    background?: number;
+    styles: number[];
+    emoji: string;
+}>;
+/**
+ * Applies ANSI styling to text
+ */
+export declare function ansiStyle(text: string, codes: number[]): string;
+/**
+ * Applies color to text
+ */
+export declare function ansiColor(text: string, color: number): string;
+/**
+ * Applies background color to text
+ */
+export declare function ansiBackground(text: string, bg: number, color?: number): string;
+/**
+ * Makes text bold
+ */
+export declare function ansiBold(text: string): string;
+/**
+ * Makes text dim
+ */
+export declare function ansiDim(text: string): string;
+/**
+ * Underlines text
+ */
+export declare function ansiUnderline(text: string): string;
+/**
+ * Specialized formatters for different contexts
+ */
+/**
+ * Format timestamp for terminal
+ */
+export declare function formatTimestampANSI(timestamp: string): string;
+/**
+ * Format log level for terminal
+ */
+export declare function formatLogLevelANSI(level: LogLevel, useEmojis?: boolean): string;
+/**
+ * Format success message for terminal
+ */
+export declare function formatSuccessANSI(message: string, useEmojis?: boolean): string;
+/**
+ * Format prefix for terminal
+ */
+export declare function formatPrefixANSI(prefix: string): string;
+/**
+ * Format file location for terminal
+ */
+export declare function formatLocationANSI(location: string): string;
+/**
+ * Format build-specific messages
+ */
+export declare const BUILD_FORMATTERS: {
+    /**
+     * Format compilation step
+     */
+    compilation: (step: string, status?: "starting" | "completed" | "failed") => string;
+    /**
+     * Format warning message
+     */
+    warning: (message: string) => string;
+    /**
+     * Format error message
+     */
+    error: (message: string) => string;
+    /**
+     * Format success message
+     */
+    success: (message: string) => string;
+    /**
+     * Format info message
+     */
+    info: (message: string) => string;
+};
+/**
+ * Terminal-friendly emoji alternatives for environments that don't support them
+ */
+export declare const EMOJI_ALTERNATIVES: {
+    '\uD83D\uDD0D': string;
+    ℹ️: string;
+    '\u26A0\uFE0F': string;
+    '\u274C': string;
+    '\uD83D\uDEA8': string;
+    '\u2705': string;
+    '\u2713': string;
+    '\u2717': string;
+    '\u2699\uFE0F': string;
+    '\uD83D\uDCE6': string;
+};
+/**
+ * Replace emojis with text alternatives for non-emoji terminals
+ */
+export declare function sanitizeEmojis(text: string): string;
+//# sourceMappingURL=ansi-colors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ansi-colors.d.ts","sourceRoot":"","sources":["../../src/utils/ansi-colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Db,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACjB,CAmCA,CAAC;AAUF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CAerF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CAUpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;wBACiB,MAAM,WAAU,UAAU,GAAG,WAAW,GAAG,QAAQ;IAevE;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qBACc,MAAM;IAIvB;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;oBACa,MAAM;CAGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAW9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBnD"}

package/dist/utils/formatting.d.ts

@@ -1,12 +1,30 @@
+import { LogLevel, StackInfo, OutputFormat } from '../types/index.js';
+export type { OutputFormat } from '../types/index.js';
 /**
- * @fileoverview Formatting utilities for Universal Logger
+ * Creates output based on environment and format preference
  */
-import type { LogLevel, StackInfo } from '../types/index.js';
+export declare function createOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null, format?: OutputFormat): string;
 /**
  * Creates plain text output for any environment
  * No colors, no styling - maximum compatibility
  */
 export declare function createPlainOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates ANSI-colored output for terminals
+ */
+export declare function createANSIOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates build-friendly output (optimized for Next.js builds, webpack, etc.)
+ */
+export declare function createBuildOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Creates CI-friendly output (no emojis, simple formatting)
+ */
+export declare function createCIOutput(level: LogLevel, message: string, prefix?: string, stackInfo?: StackInfo | null): string;
+/**
+ * Detects the optimal output format based on environment
+ */
+export declare function detectOptimalFormat(): OutputFormat;
 /**
  * Gets the appropriate log method for the level
  * Uses different console methods for better semantics

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

@@ -1 +1 @@
-{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAcnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;;;;;;;;;;;;;EAgB/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA+BtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAU,EAAE,YAAY,GAAE,MAAU,GAAG,GAAG,CAqB3F"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAa3E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,EAC5B,MAAM,GAAE,YAAqB,GAC9B,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAyCR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAC7B,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAiClD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAcnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;;;;;;;;;;;;;EAgB/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA+BtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAU,EAAE,YAAY,GAAE,MAAU,GAAG,GAAG,CAqB3F"}

package/dist/utils/index.d.ts

@@ -4,4 +4,5 @@
 export { parseStackTrace } from './stackTrace.js';
 export { formatTimestamp, parseRelativeTime, parseTimeInput, formatDisplayTime } from './timestamps.js';
 export { createStyledOutput, generateLogId, escapeHtml, safeStringify, detectDevToolsTheme, getAdaptiveColor, setupThemeChangeListener, type LevelStyleConfig } from './output.js';
+export { createPlainOutput, createOutput, createANSIOutput, createBuildOutput, createCIOutput, detectOptimalFormat, getConsoleMethod, createLogEntry, formatTablePlain, safeSerialize } from './formatting.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,gBAAgB,EACxB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,gBAAgB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EAChB,MAAM,iBAAiB,CAAC"}

package/dist/utils/output.d.ts

@@ -1,7 +1,4 @@
-/**
- * @fileoverview Styled output creation utilities for Advanced Logger
- */
-import type { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors } from '../types/index.js';
+import { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors } from '../types/index.js';
 /**
  * Style configuration for each log level
  */

package/dist/utils/stackTrace.d.ts

@@ -1,7 +1,4 @@
-/**
- * @fileoverview Stack trace parsing utilities for Advanced Logger
- */
-import type { StackInfo } from '../types/index.js';
+import { StackInfo } from '../types/index.js';
 /**
  * Parses the current stack trace to extract caller information
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mks2508/better-logger",
-  "version": "0.14.0-alpha.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "Logger avanzado para consola con estilos CSS, temas adaptativos, badges automáticos, SVG, animaciones y CLI integrado",
   "main": "dist/index.js",
@@ -83,6 +83,7 @@
     "workflow:release": "npm run version:auto && npm run build:all && npm run release:github"
   },
   "devDependencies": {
+    "@types/node": "^24.5.2",
     "terser": "^5.43.1",
     "typescript": "~5.8.3",
     "vite": "^7.1.2",

package/src/Logger.ts

@@ -21,12 +21,9 @@ import type {
 } from './types/index.js';
 
 // Utility imports
-import {
-    parseStackTrace,
-    formatTimestamp,
-    createStyledOutput,
-    setupThemeChangeListener
-} from './utils/index.js';
+import { parseStackTrace } from './utils/stackTrace.js';
+import { formatTimestamp } from './utils/timestamps.js';
+import { createStyledOutput, setupThemeChangeListener } from './utils/output.js';
 
 // Styling imports
 import {
@@ -328,6 +325,35 @@ export class Logger {
         }
     }
 
+    /**
+     * Factory method para crear loggers con scope evitando dependencias circulares
+     * @private
+     * @param {string} type - Tipo de logger ('scope' | 'api' | 'component')
+     * @param {string} name - Nombre del scope
+     * @returns {Promise<any>} Logger con scope
+     */
+    private async createScopedLogger(type: string, name: string): Promise<any> {
+        try {
+            const { ScopedLogger, APILogger, ComponentLogger } = await import('./ScopedLogger.js');
+            
+            switch (type) {
+                case 'component':
+                    return new ComponentLogger(this, name);
+                case 'api':
+                    return new APILogger(this, name);
+                case 'scope':
+                default:
+                    return new ScopedLogger(this, name);
+            }
+        } catch (error) {
+            // Fallback: crear logger básico con prefijo
+            this.error('Failed to load ScopedLogger, using basic logger with prefix:', error);
+            const basicLogger = new Logger(this.getConfig());
+            basicLogger.setGlobalPrefix(`${this.config.globalPrefix || ''}:${name}`);
+            return basicLogger;
+        }
+    }
+
     // ===== SIMPLIFIED API =====
 
     /**
@@ -488,9 +514,8 @@ export class Logger {
      * @since 0.3.0
      */
     component(name: string): any {
-        // Dynamic import to avoid circular dependency
-        const { ComponentLogger } = require('./ScopedLogger.js');
-        return new ComponentLogger(this, name);
+        // Lazy dynamic import to avoid circular dependency
+        return this.createScopedLogger('component', name);
     }
 
     /**
@@ -511,9 +536,8 @@ export class Logger {
      * @since 0.3.0
      */
     api(name: string): any {
-        // Dynamic import to avoid circular dependency
-        const { APILogger } = require('./ScopedLogger.js');
-        return new APILogger(this, name);
+        // Lazy dynamic import to avoid circular dependency
+        return this.createScopedLogger('api', name);
     }
 
     /**
@@ -534,9 +558,8 @@ export class Logger {
      * @since 0.3.0
      */
     scope(name: string): any {
-        // Dynamic import to avoid circular dependency
-        const { ScopedLogger } = require('./ScopedLogger.js');
-        return new ScopedLogger(this, name);
+        // Lazy dynamic import to avoid circular dependency
+        return this.createScopedLogger('scope', name);
     }
 
     // ===== SIMPLE CUSTOMIZATION =====
@@ -1207,67 +1230,82 @@ export class Logger {
 }
 
 /**
- * Instancia singleton del logger con configuración por defecto
- * @constant {Logger}
+ * Lazy singleton instance - se inicializa solo cuando se necesita
+ * @private
  */
-const defaultLogger = new Logger({
-    verbosity: 'info',
-    enableColors: true,
-    enableTimestamps: true,
-    enableStackTrace: true,
-    bufferSize: 1000, // Enable export functionality by default
-});
+let _defaultLogger: Logger | null = null;
 
-// Display initialization banner
-displayInitBanner();
+/**
+ * Obtiene o crea la instancia singleton del logger
+ * @returns {Logger} Instancia singleton del logger
+ */
+function getDefaultLogger(): Logger {
+    if (!_defaultLogger) {
+        _defaultLogger = new Logger({
+            verbosity: 'info',
+            enableColors: true,
+            enableTimestamps: true,
+            enableStackTrace: true,
+            bufferSize: 1000, // Enable export functionality by default
+        });
+        
+        // Display initialization banner only once
+        try {
+            displayInitBanner();
+        } catch (error) {
+            // Silent fail if banner cannot be displayed
+        }
+    }
+    return _defaultLogger;
+}
 
-// Export the singleton instance as default
-export default defaultLogger;
+// Export the lazy singleton getter as default
+export default getDefaultLogger();
 
 /**
  * Métodos individuales exportados para conveniencia
- * @description Todos los métodos están correctamente enlazados al singleton
+ * @description Todos los métodos están correctamente enlazados al singleton lazy
  * @since 0.3.0
  */
-export const debug = (...args: any[]) => defaultLogger.debug(...args);
-export const info = (...args: any[]) => defaultLogger.info(...args);
-export const warn = (...args: any[]) => defaultLogger.warn(...args);
-export const error = (...args: any[]) => defaultLogger.error(...args);
-export const success = (...args: any[]) => defaultLogger.success(...args);
-export const trace = (...args: any[]) => defaultLogger.trace(...args);
-export const critical = (...args: any[]) => defaultLogger.critical(...args);
-export const table = (data: any, columns?: string[]) => defaultLogger.table(data, columns);
-export const group = (label: string, collapsed?: boolean) => defaultLogger.group(label, collapsed);
-export const groupEnd = () => defaultLogger.groupEnd();
-export const time = (label: string) => defaultLogger.time(label);
-export const timeEnd = (label: string) => defaultLogger.timeEnd(label);
-export const setGlobalPrefix = (prefix: string) => defaultLogger.setGlobalPrefix(prefix);
-export const setVerbosity = (level: Verbosity) => defaultLogger.setVerbosity(level);
-export const addHandler = (handler: ILogHandler) => defaultLogger.addHandler(handler);
-export const setTheme = (theme: ThemeVariant) => defaultLogger.setTheme(theme);
-export const setBannerType = (bannerType: BannerType) => defaultLogger.setBannerType(bannerType);
-export const showBanner = (bannerType?: BannerType) => defaultLogger.showBanner(bannerType);
+export const debug = (...args: any[]) => getDefaultLogger().debug(...args);
+export const info = (...args: any[]) => getDefaultLogger().info(...args);
+export const warn = (...args: any[]) => getDefaultLogger().warn(...args);
+export const error = (...args: any[]) => getDefaultLogger().error(...args);
+export const success = (...args: any[]) => getDefaultLogger().success(...args);
+export const trace = (...args: any[]) => getDefaultLogger().trace(...args);
+export const critical = (...args: any[]) => getDefaultLogger().critical(...args);
+export const table = (data: any, columns?: string[]) => getDefaultLogger().table(data, columns);
+export const group = (label: string, collapsed?: boolean) => getDefaultLogger().group(label, collapsed);
+export const groupEnd = () => getDefaultLogger().groupEnd();
+export const time = (label: string) => getDefaultLogger().time(label);
+export const timeEnd = (label: string) => getDefaultLogger().timeEnd(label);
+export const setGlobalPrefix = (prefix: string) => getDefaultLogger().setGlobalPrefix(prefix);
+export const setVerbosity = (level: Verbosity) => getDefaultLogger().setVerbosity(level);
+export const addHandler = (handler: ILogHandler) => getDefaultLogger().addHandler(handler);
+export const setTheme = (theme: ThemeVariant) => getDefaultLogger().setTheme(theme);
+export const setBannerType = (bannerType: BannerType) => getDefaultLogger().setBannerType(bannerType);
+export const showBanner = (bannerType?: BannerType) => getDefaultLogger().showBanner(bannerType);
 export const logWithSVG = (message: string, svgContent?: string, options?: StyleOptions) => 
-    defaultLogger.logWithSVG(message, svgContent, options);
+    getDefaultLogger().logWithSVG(message, svgContent, options);
 export const logAnimated = (message: string, duration?: number) => 
-    defaultLogger.logAnimated(message, duration);
-export const cli = (command: string) => defaultLogger.cli(command);
-export const cleanup = () => defaultLogger.cleanup();
+    getDefaultLogger().logAnimated(message, duration);
+export const cli = (command: string) => getDefaultLogger().cli(command);
+export const cleanup = () => getDefaultLogger().cleanup();
 
 // Simplified API exports
-export const preset = (name: string) => defaultLogger.preset(name);
-export const presets = () => defaultLogger.presets();
-export const hideTimestamp = () => defaultLogger.hideTimestamp();
-export const showTimestamp = () => defaultLogger.showTimestamp();
-export const hideLocation = () => defaultLogger.hideLocation();
-export const showLocation = () => defaultLogger.showLocation();
-export const hideBadges = () => defaultLogger.hideBadges();
-export const showBadges = () => defaultLogger.showBadges();
-export const component = (name: string) => defaultLogger.component(name);
-export const api = (name: string) => defaultLogger.api(name);
-export const scope = (name: string) => defaultLogger.scope(name);
-export const customize = (overrides: any) => defaultLogger.customize(overrides);
-export const styles = () => defaultLogger.styles();
+export const preset = (name: string) => getDefaultLogger().preset(name);
+export const presets = () => getDefaultLogger().presets();
+export const hideTimestamp = () => getDefaultLogger().hideTimestamp();
+export const showTimestamp = () => getDefaultLogger().showTimestamp();
+export const hideLocation = () => getDefaultLogger().hideLocation();
+export const showLocation = () => getDefaultLogger().showLocation();
+export const hideBadges = () => getDefaultLogger().hideBadges();
+export const showBadges = () => getDefaultLogger().showBadges();
+export const component = (name: string) => getDefaultLogger().component(name);
+export const api = (name: string) => getDefaultLogger().api(name);
+export const scope = (name: string) => getDefaultLogger().scope(name);
+export const customize = (overrides: any) => getDefaultLogger().customize(overrides);
+export const styles = () => getDefaultLogger().styles();
 
 // Re-export handlers and utilities for backward compatibility
 export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler, ExportLogHandler } from './handlers/index.js';

package/src/constants.ts

@@ -17,6 +17,7 @@ export const DEFAULT_CONFIG = {
     bannerType: 'simple' as const,
     bufferSize: 1000,
     autoDetectTheme: true,
+    outputFormat: 'auto' as const,
 } as const;
 
 /**
@@ -168,4 +169,133 @@ export const ADAPTIVE_COLORS = {
         light: '#718096',
         dark: '#a0aec0',
     },
-} as const satisfies Record<string, AdaptiveColors>;
+} as const satisfies Record<string, AdaptiveColors>;
+
+/**
+ * Presets específicos para diferentes entornos de build
+ */
+export const BUILD_PRESETS = {
+    /**
+     * Configuración optimizada para Next.js builds
+     */
+    nextjs: {
+        verbosity: 'info' as const,
+        enableColors: true,
+        enableTimestamps: false,
+        enableStackTrace: false,
+        autoDetectTheme: false,
+        outputFormat: 'build' as const,
+    },
+
+    /**
+     * Configuración para Webpack builds
+     */
+    webpack: {
+        verbosity: 'info' as const,
+        enableColors: true,
+        enableTimestamps: true,
+        enableStackTrace: false,
+        autoDetectTheme: false,
+        outputFormat: 'build' as const,
+    },
+
+    /**
+     * Configuración para CI/CD environments
+     */
+    ci: {
+        verbosity: 'info' as const,
+        enableColors: false,
+        enableTimestamps: true,
+        enableStackTrace: true,
+        autoDetectTheme: false,
+        outputFormat: 'ci' as const,
+    },
+
+    /**
+     * Configuración para desarrollo terminal
+     */
+    terminal: {
+        verbosity: 'debug' as const,
+        enableColors: true,
+        enableTimestamps: true,
+        enableStackTrace: true,
+        autoDetectTheme: false,
+        outputFormat: 'ansi' as const,
+    }
+} as const;
+
+/**
+ * Mapeo de variables de entorno a presets
+ */
+export const ENVIRONMENT_DETECTION = {
+    // Next.js detection
+    isNextJS: typeof process !== 'undefined' && (
+        process.env.NEXT_RUNTIME ||
+        process.env.NEXT_PUBLIC_VERCEL_ENV ||
+        (process.argv && process.argv.some(arg => arg.includes('next')))
+    ),
+
+    // Webpack detection
+    isWebpack: typeof process !== 'undefined' && (
+        process.env.WEBPACK_ENV ||
+        process.env.WEBPACK_BUILD ||
+        (process.argv && process.argv.some(arg => arg.includes('webpack')))
+    ),
+
+    // CI/CD detection
+    isCI: typeof process !== 'undefined' && (
+        process.env.CI ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.JENKINS_URL ||
+        process.env.GITLAB_CI ||
+        process.env.TRAVIS ||
+        process.env.CIRCLECI
+    ),
+
+    // Build detection
+    isBuild: typeof process !== 'undefined' && (
+        process.env.NODE_ENV === 'production' ||
+        process.env.BUILD_MODE === 'production' ||
+        (process.argv && process.argv.some(arg => arg.includes('build')))
+    ),
+
+    // Terminal with ANSI support
+    isTerminal: typeof process !== 'undefined' && (
+        process.stdout?.isTTY === true &&
+        process.env.TERM !== 'dumb'
+    )
+} as const;
+
+/**
+ * Auto-detects the best preset based on current environment
+ */
+export function detectEnvironmentPreset(): keyof typeof BUILD_PRESETS {
+    if (ENVIRONMENT_DETECTION.isCI) {
+        return 'ci';
+    }
+
+    if (ENVIRONMENT_DETECTION.isNextJS) {
+        return 'nextjs';
+    }
+
+    if (ENVIRONMENT_DETECTION.isWebpack) {
+        return 'webpack';
+    }
+
+    if (ENVIRONMENT_DETECTION.isTerminal) {
+        return 'terminal';
+    }
+
+    return 'terminal'; // Default fallback
+}
+
+/**
+ * Gets the optimal configuration for current environment
+ */
+export function getOptimalConfig() {
+    const preset = detectEnvironmentPreset();
+    return {
+        ...DEFAULT_CONFIG,
+        ...BUILD_PRESETS[preset]
+    };
+}