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

package/dist/index.d.ts

@@ -1,83 +1,44 @@
 /**
- * @fileoverview Better Logger - Librería completa con todas las características
- * @version 0.3.0
- * @since 2024
+ * @fileoverview Better Logger — default entry point.
  *
- * Punto de entrada principal que proporciona la experiencia completa de Better Logger
- * con características avanzadas incluyendo estilos CSS, soporte SVG, animaciones,
- * capacidades de exportación y logging remoto.
- *
- * @module @mks2508/better-logger
+ * Re-exports `Logger`, the scoped loggers, subpath-style bridges, and
+ * cross-runtime styling/utility helpers. Side-effect free at import.
  */
 import { Logger } from './Logger.js';
 import type { Verbosity, ThemeVariant, BannerType, StyleOptions, ILogHandler } from './types/index.js';
-declare const logger: Logger;
 /**
- * Clase principal Logger con conjunto completo de características
- *
- * @example
- * // Importación y uso básico
- * import { Logger } from '@mks2508/better-logger';
- *
- * const logger = new Logger();
- * logger.preset('cyberpunk');  // Aplicar preset completo
- * logger.info('¡Hola mundo!');
- *
- * @example
- * // Logger con scope para componentes
- * const auth = logger.component('Auth');
- * auth.info('Usuario autenticando...');
- * auth.success('Login exitoso');
- *
- * @example
- * // Logger para APIs con badges
- * const api = logger.api('GraphQL');
- * api.badges(['v2', 'cached']).info('Query ejecutada');
- *
- * @since 0.3.0
+ * Main `Logger` class — orchestrator for styling, transports, hooks,
+ * serializers, MDC, and CLI primitives. Construct directly or use the
+ * default singleton below.
  */
 export { Logger };
 /**
- * Instancia singleton del logger lista para usar
- * @default
- *
- * @example
- * // Uso directo sin crear instancia
- * import logger from '@mks2508/better-logger';
- *
- * logger.info('Aplicación iniciada');
- * logger.success('Conexión establecida');
- * logger.warn('Memoria al 80%');
- * logger.error('Fallo en conexión');
+ * Default Logger singleton (lazy). Use this for the common case.
  */
-export default logger;
+declare const _default: Logger;
+export default _default;
 /**
- * Métodos de logging individuales (enlazados al singleton)
- *
- * @example
- * // Importar solo los métodos necesarios
- * import { info, error, success } from '@mks2508/better-logger';
- *
- * info('Proceso iniciado');
- * success('✓ Completado exitosamente');
- * error('Error:', errorDetails);
- *
- * @since 0.3.0
+ * Top-level log methods bound to the default singleton.
  */
-export declare const debug: (...args: any[]) => void;
-export declare const info: (...args: any[]) => void;
-export declare const warn: (...args: any[]) => void;
-export declare const error: (...args: any[]) => void;
-export declare const success: (...args: any[]) => void;
-export declare const critical: (...args: any[]) => void;
-export declare const trace: (...args: any[]) => void;
-export declare const table: (data: any, columns?: string[]) => void;
+export declare const debug: (...args: unknown[]) => Promise<void>;
+export declare const info: (...args: unknown[]) => Promise<void>;
+export declare const warn: (...args: unknown[]) => Promise<void>;
+export declare const error: (...args: unknown[]) => Promise<void>;
+export declare const success: (...args: unknown[]) => Promise<void>;
+export declare const critical: (...args: unknown[]) => Promise<void>;
+export declare const trace: (...args: unknown[]) => void;
+export declare const table: (data: unknown, columns?: string[]) => void;
 export declare const group: (label: string, collapsed?: boolean) => void;
 export declare const groupEnd: () => void;
 export declare const time: (label: string) => void;
-export declare const timeEnd: (label: string) => void;
+export declare const timeEnd: (label: string) => number;
 export declare const setGlobalPrefix: (prefix: string) => void;
-export declare const scope: (prefix: string) => any;
+export declare const scope: (name: string) => import("./ScopedLogger.js").ScopedLogger;
+export declare const component: (name: string) => import("./ScopedLogger.js").ComponentLogger;
+export declare const api: (name: string) => import("./ScopedLogger.js").APILogger;
+export declare const badges: (badgeList: string[]) => Logger;
+export declare const badge: (badgeName: string) => Logger;
+export declare const clearBadges: () => Logger;
 export declare const setVerbosity: (level: Verbosity) => void;
 export declare const addHandler: (handler: ILogHandler) => void;
 export declare const setTheme: (theme: ThemeVariant) => void;
@@ -86,72 +47,23 @@ export declare const showBanner: (bannerType?: BannerType) => void;
 export declare const logWithSVG: (message: string, svgContent?: string, options?: StyleOptions) => void;
 export declare const logAnimated: (message: string, duration?: number) => void;
 export declare const cli: (command: string) => Promise<void>;
-export type { LogLevel, Verbosity, ThemeVariant, BannerType, StyleOptions, ILogHandler, LoggerConfig, LogMetadata, StackInfo, TimerEntry } from './types/index.js';
+export type { LogLevel, Verbosity, ThemeVariant, BannerType, StyleOptions, ILogHandler, LoggerConfig, LogMetadata, StackInfo, TimerEntry, TimerResult, OutputFormat, IScopedLogger, IAPILogger, IComponentLogger, Bindings, SerializerFn, SerializerContext, SerializerConfig, ISerializerRegistry, HookLogEntry, HookEvent, HookCallback, MiddlewareFn, IHookManager, TransportRecord, TransportOptions, TransportTarget, ITransport, TimestampFormat, ColumnAlign, ColumnConfig, LogOptions, CLILogLevel, ISpinnerHandle, IBoxOptions, ITableOptions, } from './types/index.js';
 export { StyleBuilder, StylePresets, THEME_PRESETS, THEME_BANNERS, BANNER_VARIANTS } from './styling/index.js';
-export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler } from './handlers/index.js';
+import type { SerializerFn, HookEvent, HookCallback, MiddlewareFn, TransportTarget } from './types/index.js';
+export declare const addSerializer: <T>(type: new (...args: unknown[]) => T, serializer: SerializerFn<T>, priority?: number) => void;
+export declare const removeSerializer: <T>(type: new (...args: unknown[]) => T) => boolean;
+export declare const on: (event: HookEvent, callback: HookCallback, priority?: number) => () => void;
+export declare const once: (event: HookEvent, callback: HookCallback, priority?: number) => () => void;
+export declare const off: (event: HookEvent, callback: HookCallback) => boolean;
+export declare const use: (middleware: MiddlewareFn, priority?: number) => () => void;
+export declare const addTransport: (target: TransportTarget) => string;
+export declare const removeTransport: (id: string) => boolean;
+export declare const flushTransports: () => Promise<void>;
+export declare const closeTransports: () => Promise<void>;
+export { ScopedLogger, APILogger, ComponentLogger, ContextLogger } from './ScopedLogger.js';
 export { DEFAULT_CONFIG } from './constants.js';
-export { parseStackTrace, formatTimestamp } from './utils/index.js';
-/**
- * Utilidades de estilo para crear estilos personalizados de consola
- *
- * @example
- * // Crear estilo personalizado
- * import { createStyle, stylePresets } from '@mks2508/better-logger';
- *
- * const miEstilo = createStyle()
- *   .bg('linear-gradient(45deg, #ff6b6b, #feca57)')
- *   .color('white')
- *   .padding('10px')
- *   .rounded('8px')
- *   .bold()
- *   .build();
- *
- * console.log('%cMensaje estilizado', miEstilo);
- *
- * @example
- * // Usar presets predefinidos
- * console.log('%cÉxito!', stylePresets.success);
- * console.log('%cError!', stylePresets.error);
- *
- * @since 0.3.0
- */
-import { StyleBuilder } from './styling/index.js';
-/**
- * Crea una nueva instancia de StyleBuilder para estilos personalizados de consola
- *
- * @returns {StyleBuilder} Constructor de estilos encadenable
- *
- * @example
- * const estilo = createStyle()
- *   .gradient('#667eea', '#764ba2')
- *   .color('white')
- *   .padding('8px 16px')
- *   .rounded('4px')
- *   .shadow('0 2px 4px rgba(0,0,0,0.2)')
- *   .build();
- *
- * @since 0.3.0
- */
-export declare const createStyle: () => StyleBuilder;
-/**
- * Presets de estilo predefinidos para casos de uso comunes
- *
- * @constant {Object} stylePresets
- *
- * @example
- * console.log('%cOperación exitosa', stylePresets.success);
- * console.log('%cAdvertencia', stylePresets.warning);
- * console.log('%cError crítico', stylePresets.error);
- * console.log('%cInformación', stylePresets.info);
- * console.log('%cDestacado', stylePresets.accent);
- *
- * @since 0.3.0
- */
-export declare const stylePresets: {
-    success: string;
-    error: string;
-    warning: string;
-    info: string;
-    accent: string;
-};
+export { parseStackTrace, formatTimestamp, getConsoleMethod, createLogEntry, formatTablePlain, safeSerialize } from './utils/index.js';
+export { ansiStyle, ansiColor, ansiBackground, ansiBold, ansiDim, ansiUnderline, formatLogLevelANSI, formatSuccessANSI } from './utils/ansi-colors.js';
+export { getEnvironment, isRunningInTerminal, supportsANSI, getColorCapability, getTerminalWidth, getTerminalHeight, getEnvironmentInfo, } from './utils/environment-detector.js';
+export type { Environment } from './utils/environment-detector.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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