@mks2508/better-logger 2.0.1 → 3.0.0

package/dist/types/core.d.ts

@@ -0,0 +1,272 @@
+/**
+ * @fileoverview Definiciones de tipos principales para Better Logger
+ * @version 0.3.0
+ * @since 2024
+ */
+/**
+ * Niveles de log soportados en orden jerárquico (debug < info < warn < error < critical)
+ *
+ * @constant {Object} LOG_LEVELS
+ * @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
+ * }
+ */
+export declare const LOG_LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+    readonly critical: 4;
+};
+/**
+ * Tipo de nivel de log derivado de las claves de LOG_LEVELS
+ * @typedef {'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel
+ */
+export type LogLevel = keyof typeof LOG_LEVELS;
+/**
+ * Tipo de nivel de verbosidad para filtrar logs
+ * @typedef {LogLevel | 'silent'} Verbosity
+ * @description 'silent' desactiva completamente todos los logs
+ */
+export type Verbosity = LogLevel | 'silent';
+/**
+ * Variantes de tema para diferentes estilos visuales
+ * @typedef {'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk'} ThemeVariant
+ *
+ * @description
+ * - default: Tema adaptativo automático (claro/oscuro)
+ * - dark: Tema oscuro con colores vibrantes
+ * - light: Tema claro con colores suaves
+ * - neon: Colores neón brillantes con efectos de resplandor
+ * - minimal: Diseño minimalista y limpio
+ * - cyberpunk: Estilo futurista con neón y efectos
+ */
+export type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';
+/**
+ * Detección de tema de DevTools del navegador
+ * @typedef {'light' | 'dark'} DevToolsTheme
+ */
+export type DevToolsTheme = 'light' | 'dark';
+/**
+ * Tipos de banner para diferentes enfoques visuales
+ * @typedef {'simple' | 'ascii' | 'unicode' | 'svg' | 'animated'} BannerType
+ *
+ * @description
+ * - simple: Texto simple sin decoración
+ * - ascii: Arte ASCII tradicional
+ * - unicode: Caracteres Unicode decorativos
+ * - svg: Gráfico SVG embebido
+ * - animated: Banner con animación CSS
+ */
+export type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';
+/**
+ * Formatos de exportación para datos de log
+ * @typedef {'json' | 'csv' | 'markdown' | 'plain' | 'html'} ExportFormat
+ *
+ * @description
+ * - json: Formato JSON estructurado
+ * - csv: Valores separados por comas para Excel/Sheets
+ * - markdown: Formato Markdown para documentación
+ * - plain: Texto plano sin formato
+ * - html: HTML con estilos para visualización web
+ */
+export type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';
+/**
+ * Formatos de salida para diferentes entornos
+ * @typedef {'auto' | 'plain' | 'ansi' | 'build' | 'ci'} OutputFormat
+ *
+ * @description
+ * - auto: Detección automática basada en entorno (recomendado)
+ * - plain: Texto plano sin colores (máxima compatibilidad)
+ * - ansi: Colores ANSI para terminales modernos
+ * - build: Formato optimizado para builds (Next.js, webpack, etc.)
+ * - ci: Formato optimizado para CI/CD (sin emojis, texto simple)
+ */
+export type OutputFormat = 'auto' | 'plain' | 'ansi' | 'build' | 'ci';
+/**
+ * Interfaz de configuración para instancias del logger
+ *
+ * @interface LoggerConfig
+ * @since 0.3.0
+ *
+ * @example
+ * const config: LoggerConfig = {
+ *   globalPrefix: 'MiApp',
+ *   verbosity: 'info',
+ *   enableColors: true,
+ *   enableTimestamps: true,
+ *   enableStackTrace: false,
+ *   theme: 'cyberpunk',
+ *   bannerType: 'animated',
+ *   bufferSize: 500,
+ *   autoDetectTheme: true
+ * };
+ */
+export interface LoggerConfig {
+    globalPrefix?: string;
+    verbosity: Verbosity;
+    enableColors: boolean;
+    enableTimestamps: boolean;
+    enableStackTrace: boolean;
+    theme?: ThemeVariant;
+    bannerType?: BannerType;
+    bufferSize?: number;
+    autoDetectTheme?: boolean;
+    outputFormat?: OutputFormat;
+}
+/**
+ * Información parseada del stack trace
+ *
+ * @interface StackInfo
+ * @description Contiene la ubicación exacta donde se originó el log
+ */
+export interface StackInfo {
+    file: string;
+    line: number;
+    column: number;
+    function?: string;
+}
+/**
+ * Entrada de temporizador para medición de rendimiento
+ *
+ * @interface TimerEntry
+ * @description Usado internamente para rastrear temporizadores activos
+ */
+export interface TimerEntry {
+    label: string;
+    startTime: number;
+}
+/**
+ * Opciones para estilizar componentes
+ *
+ * @interface StyleOptions
+ * @description Configuración de dimensiones y espaciado para elementos visuales
+ */
+export interface StyleOptions {
+    width?: number;
+    height?: number;
+    padding?: string;
+}
+/**
+ * Configuración de colores adaptativos para temas claro/oscuro
+ *
+ * @interface AdaptiveColors
+ * @description Define colores que se ajustan automáticamente al tema del navegador
+ */
+export interface AdaptiveColors {
+    light: string;
+    dark: string;
+}
+/**
+ * Configuración de espaciado para elementos del log
+ * @typedef {'compact' | 'normal' | 'spacious'} SpacingType
+ *
+ * @description
+ * - compact: Espaciado mínimo para más densidad
+ * - normal: Espaciado estándar balanceado
+ * - spacious: Espaciado amplio para mejor legibilidad
+ */
+export type SpacingType = 'compact' | 'normal' | 'spacious';
+/**
+ * Configuración de layout para la estructura del log
+ *
+ * @interface LogLayout
+ * @description Define cómo se organizan visualmente los elementos del log
+ */
+export interface LogLayout {
+    spacing: SpacingType;
+    innerPadding?: string;
+    outerMargin?: string;
+    separator?: string;
+}
+/**
+ * Configuración para partes individuales del log
+ *
+ * @interface LogPartConfig
+ * @description Permite personalizar cada elemento del log por separado
+ *
+ * @example
+ * const timestampConfig: LogPartConfig = {
+ *   show: true,
+ *   color: '#888',
+ *   font: 'Monaco',
+ *   size: '11px'
+ * };
+ */
+export interface LogPartConfig {
+    show?: boolean;
+    style?: string;
+    font?: string;
+    size?: string;
+    color?: string;
+    background?: string;
+    padding?: string;
+    margin?: string;
+    border?: string;
+    shadow?: string;
+    uppercase?: boolean;
+}
+/**
+ * Configuración completa de estilos del log
+ *
+ * @interface LogStyles
+ * @description Agrupa todas las opciones de estilo en una sola configuración
+ * @since 0.3.0
+ */
+export interface LogStyles {
+    layout?: LogLayout;
+    timestamp?: LogPartConfig;
+    level?: LogPartConfig;
+    prefix?: LogPartConfig;
+    message?: LogPartConfig;
+    location?: LogPartConfig;
+    backdrop?: string;
+    transparency?: number;
+}
+export interface TimerResult {
+    label: string;
+    duration: number;
+    startTime: number;
+    endTime: number;
+}
+export interface IScopedLogger {
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    success(...args: any[]): void;
+    critical(...args: any[]): void;
+    trace(...args: any[]): void;
+    badges(badges: string[]): this;
+    badge(badge: string): this;
+    clearBadges(): this;
+    time(label: string): void;
+    timeEnd(label: string): number | undefined;
+    style(presetName: string): this;
+}
+export interface IAPILogger extends IScopedLogger {
+    slow(message: string, duration?: number): void;
+    rateLimit(message: string): void;
+    auth(message: string): void;
+    deprecated(message: string): void;
+}
+export interface IComponentLogger extends IScopedLogger {
+    lifecycle(event: string, message?: string): void;
+    stateChange(from: string, to: string, data?: any): void;
+    propsChange(changes: Record<string, any>): void;
+}
+export interface Bindings {
+    scope?: string;
+    badges?: string[];
+    type?: 'scope' | 'api' | 'component';
+    context?: string[];
+}
+//# sourceMappingURL=core.d.ts.map

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

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

package/dist/types/handlers.d.ts

@@ -0,0 +1,85 @@
+import { LogLevel, StackInfo } from './core.js';
+/**
+ * Metadata associated with each log entry
+ */
+export interface LogMetadata {
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    stackInfo?: StackInfo;
+    group?: string;
+}
+/**
+ * Interface for custom log handlers (extensibility)
+ */
+export interface ILogHandler {
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
+}
+/**
+ * Stored log entry for export functionality
+ */
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    message: string;
+    args: any[];
+    location?: StackInfo;
+    groupInfo?: {
+        depth: number;
+        groupName?: string;
+    };
+}
+/**
+ * Export filter options
+ */
+export interface ExportFilters {
+    levels?: LogLevel[];
+    since?: Date | string | number;
+    until?: Date | string | number;
+    prefixes?: string[];
+    excludePrefixes?: string[];
+    withStackTrace?: boolean;
+    errorsOnly?: boolean;
+    last?: number;
+    first?: number;
+    search?: string;
+    groupBy?: 'level' | 'prefix' | 'hour' | 'date';
+}
+/**
+ * Export options for different formats
+ */
+export interface ExportOptions {
+    minimal?: boolean;
+    compact?: boolean;
+    styled?: boolean;
+    includeMetadata?: boolean;
+    groupBy?: ExportFilters['groupBy'];
+}
+/**
+ * Export result with metadata
+ */
+export interface ExportResult {
+    format: string;
+    data: string;
+    metadata: {
+        totalLogs: number;
+        filteredLogs: number;
+        exportedAt: string;
+        filters?: ExportFilters;
+        options?: ExportOptions;
+    };
+}
+/**
+ * Buffer statistics for log management
+ */
+export interface BufferStats {
+    size: number;
+    maxSize: number;
+    usage: number;
+    oldestLog?: Date;
+    newestLog?: Date;
+    levelCounts: Record<LogLevel, number>;
+}
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/types/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/dist/types/hooks.d.ts

@@ -0,0 +1,36 @@
+import { LogLevel, StackInfo } from './core.js';
+export interface HookLogEntry {
+    level: LogLevel;
+    message: string;
+    args: any[];
+    timestamp: string;
+    prefix?: string;
+    stackInfo?: StackInfo;
+    correlationId?: string;
+    context?: Record<string, any>;
+    [key: string]: any;
+}
+export type HookEvent = 'beforeLog' | 'afterLog' | 'onError';
+export type HookCallback = (entry: HookLogEntry) => void | HookLogEntry | Promise<void | HookLogEntry>;
+export type MiddlewareFn = (entry: HookLogEntry, next: () => void | Promise<void>) => void | Promise<void>;
+export interface HookRegistration {
+    id: string;
+    event: HookEvent;
+    callback: HookCallback;
+    priority: number;
+    once: boolean;
+}
+export interface MiddlewareRegistration {
+    id: string;
+    fn: MiddlewareFn;
+    priority: number;
+}
+export interface IHookManager {
+    on(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    once(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    off(event: HookEvent, callback: HookCallback): boolean;
+    use(middleware: MiddlewareFn, priority?: number): () => void;
+    emit(event: HookEvent, entry: HookLogEntry): Promise<HookLogEntry>;
+    process(entry: HookLogEntry): Promise<HookLogEntry>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;AAEvG,MAAM,MAAM,YAAY,GAAG,CACvB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5E,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC9E,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACvD,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACvD"}

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Type definitions exports for Advanced Logger
+ */
+export type { LogLevel, Verbosity, ThemeVariant, DevToolsTheme, BannerType, ExportFormat, OutputFormat, LoggerConfig, StackInfo, TimerEntry, TimerResult, StyleOptions, AdaptiveColors, SpacingType, LogLayout, LogPartConfig, LogStyles, IScopedLogger, IAPILogger, IComponentLogger, Bindings, } from './core.js';
+export { LOG_LEVELS } from './core.js';
+export type { LogMetadata, ILogHandler, LogEntry, ExportFilters, ExportOptions, ExportResult, BufferStats, } from './handlers.js';
+export type { SerializerFn, SerializerContext, SerializerEntry, SerializerConfig, ISerializerRegistry, } from './serializers.js';
+export type { HookLogEntry, HookEvent, HookCallback, MiddlewareFn, HookRegistration, MiddlewareRegistration, IHookManager, } from './hooks.js';
+export type { TransportRecord, TransportOptions, TransportTarget, ITransport, IBufferedTransport, ITransportManager, } from './transports.js';
+export type { StyleCacheConfig } from '../styling/StyleCache.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,YAAY,EACZ,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,QAAQ,GACX,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;AAGvB,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACR,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACR,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/serializers.d.ts

@@ -0,0 +1,25 @@
+export type SerializerFn<T = any> = (value: T, context: SerializerContext) => any;
+export interface SerializerContext {
+    depth: number;
+    maxDepth: number;
+    path: string[];
+    seen: WeakSet<object>;
+}
+export interface SerializerEntry<T = any> {
+    type: new (...args: any[]) => T;
+    serializer: SerializerFn<T>;
+    priority: number;
+}
+export interface SerializerConfig {
+    maxDepth?: number;
+    circular?: 'error' | 'skip' | 'placeholder';
+    preserveUndefined?: boolean;
+}
+export interface ISerializerRegistry {
+    add<T>(type: new (...args: any[]) => T, serializer: SerializerFn<T>, priority?: number): void;
+    remove<T>(type: new (...args: any[]) => T): boolean;
+    has<T>(type: new (...args: any[]) => T): boolean;
+    serialize(value: any, config?: SerializerConfig): any;
+    getAll(): SerializerEntry[];
+}
+//# sourceMappingURL=serializers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../src/types/serializers.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,GAAG,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACpC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAChC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9F,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACpD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC;IACtD,MAAM,IAAI,eAAe,EAAE,CAAC;CAC/B"}

package/dist/types/transports.d.ts

@@ -0,0 +1,47 @@
+import { LogLevel } from './core.js';
+export interface TransportRecord {
+    level: LogLevel;
+    levelValue: number;
+    time: number;
+    msg: string;
+    prefix?: string;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+        function?: string;
+    };
+    [key: string]: any;
+}
+export interface TransportOptions {
+    level?: LogLevel;
+    transform?: (record: TransportRecord) => TransportRecord | null;
+    batchSize?: number;
+    flushInterval?: number;
+    [key: string]: any;
+}
+export interface TransportTarget {
+    target: string | ITransport;
+    options?: TransportOptions;
+    level?: LogLevel;
+}
+export interface ITransport {
+    readonly name: string;
+    write(record: TransportRecord): void | Promise<void>;
+    flush?(): void | Promise<void>;
+    close?(): void | Promise<void>;
+    isReady?(): boolean;
+}
+export interface IBufferedTransport extends ITransport {
+    readonly bufferSize: number;
+    readonly maxBufferSize: number;
+    flush(): Promise<void>;
+}
+export interface ITransportManager {
+    add(target: TransportTarget): string;
+    remove(id: string): boolean;
+    write(record: TransportRecord): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/types/transports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,eAAe,GAAG,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/utils/adapter.d.ts

@@ -0,0 +1,48 @@
+import { LogStyles, LogLevel } from '../types/index.js';
+import { ANSIStyle, TerminalRenderer } from '../terminal/terminal-renderer.js';
+export declare class CSS2ANSIAdapter {
+    private renderer;
+    constructor();
+    /**
+     * Convert LogStyles to ANSIStyle for terminal rendering
+     */
+    adaptStyles(level: LogLevel, message: string, timestamp?: string, prefix?: string, location?: string, styles?: LogStyles, presetName?: string): ANSIStyle;
+    /**
+     * Adapt production preset for terminal
+     */
+    private adaptProductionStyles;
+    /**
+     * Adapt debug preset for terminal
+     */
+    private adaptDebugStyles;
+    /**
+     * Adapt glassmorphism preset for terminal
+     */
+    private adaptGlassmorphismStyles;
+    /**
+     * Convert CSS color values to ANSI-friendly colors
+     */
+    adaptColor(cssColor: string): string;
+    /**
+     * Extract primary color from CSS gradient
+     */
+    private extractColorFromGradient;
+    /**
+     * Convert CSS color names to ANSI-compatible names
+     */
+    private cssNameToANSI;
+    /**
+     * Check if a style should be rendered in terminal
+     */
+    shouldRenderStyle(styleType: string, styles?: LogStyles): boolean;
+    /**
+     * Get renderer instance for advanced usage
+     */
+    getRenderer(): TerminalRenderer;
+}
+export declare const css2ansiAdapter: CSS2ANSIAdapter;
+/**
+ * Convenience function for quick style adaptation
+ */
+export declare function adaptToTerminal(level: LogLevel, message: string, timestamp?: string, prefix?: string, location?: string, styles?: LogStyles, presetName?: string): ANSIStyle;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/utils/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAmB;;IAOnC;;OAEG;IACH,WAAW,CACP,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,GACpB,SAAS;IAqBZ;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyChC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAoBpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO;IAOjE;;OAEG;IACH,WAAW,IAAI,gBAAgB;CAGlC;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAErD;;GAEG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,EAClB,UAAU,CAAC,EAAE,MAAM,GACpB,SAAS,CAEX"}