@mks2508/better-logger 0.0.2-alpha.2 → 0.3.0

package/dist/Logger.d.ts

@@ -0,0 +1,272 @@
+/**
+ * @fileoverview Refactored Advanced Logger with modular architecture
+ * @version 2.0.0
+ */
+import type { LogLevel, Verbosity, ThemeVariant, BannerType, LoggerConfig, ILogHandler, StyleOptions } from './types/index.js';
+import { ScopedLogger, APILogger, ComponentLogger } from './ScopedLogger.js';
+import { ExportLogHandler } from './handlers/index.js';
+/**
+ * Main Logger class implementing state-of-the-art logging capabilities
+ */
+export declare class Logger {
+    private config;
+    private scopedPrefix?;
+    private handlers;
+    private timers;
+    private groupDepth;
+    private exportHandler?;
+    private cliProcessor?;
+    private themeChangeListener?;
+    private displaySettings;
+    /**
+     * Creates a new Logger instance
+     */
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Sets up automatic theme detection with change listener
+     */
+    private setupAutoThemeDetection;
+    /**
+     * Get current configuration
+     */
+    getConfig(): LoggerConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<LoggerConfig>): void;
+    /**
+     * Sets the global prefix for all log messages
+     */
+    setGlobalPrefix(prefix: string): void;
+    /**
+     * Sets the verbosity level for filtering log output
+     */
+    setVerbosity(level: Verbosity): void;
+    /**
+     * Sets the logger theme
+     */
+    setTheme(theme: ThemeVariant): void;
+    /**
+     * Set banner type for initialization display
+     */
+    setBannerType(bannerType: BannerType): void;
+    /**
+     * Reset logger to default configuration
+     */
+    resetConfig(): void;
+    /**
+     * Cleanup method to remove event listeners and free resources
+     */
+    cleanup(): void;
+    /**
+     * Apply a smart preset - works perfectly out-of-the-box
+     */
+    preset(name: string): void;
+    /**
+     * List available presets
+     */
+    presets(): string[];
+    /**
+     * Hide timestamp in logs
+     */
+    hideTimestamp(): void;
+    /**
+     * Show timestamp in logs
+     */
+    showTimestamp(): void;
+    /**
+     * Hide location info in logs
+     */
+    hideLocation(): void;
+    /**
+     * Show location info in logs
+     */
+    showLocation(): void;
+    /**
+     * Hide badges in logs
+     */
+    hideBadges(): void;
+    /**
+     * Show badges in logs
+     */
+    showBadges(): void;
+    /**
+     * Create a component logger with automatic styling
+     */
+    component(name: string): ComponentLogger;
+    /**
+     * Create an API logger with automatic badges
+     */
+    api(name: string): APILogger;
+    /**
+     * Create a general scoped logger with badges support
+     */
+    scope(name: string): ScopedLogger;
+    /**
+     * Simple customization with minimal configuration
+     */
+    customize(overrides: {
+        message?: {
+            color?: string;
+            font?: string;
+            size?: string;
+        };
+        timestamp?: {
+            show?: boolean;
+            color?: string;
+        };
+        location?: {
+            show?: boolean;
+            color?: string;
+        };
+        level?: {
+            uppercase?: boolean;
+            style?: string;
+        };
+        prefix?: {
+            show?: boolean;
+            style?: string;
+        };
+        spacing?: 'compact' | 'normal' | 'spacious';
+    }): void;
+    /**
+     * Access advanced styling API (for power users)
+     */
+    styles(): any;
+    /**
+     * Adds a custom log handler for extensibility
+     */
+    addHandler(handler: ILogHandler): void;
+    /**
+     * Get all registered handlers
+     */
+    getHandlers(): ILogHandler[];
+    /**
+     * Get export handler if available
+     */
+    getExportHandler(): ExportLogHandler | undefined;
+    /**
+     * Checks if a log level should be output based on current verbosity
+     */
+    private shouldLog;
+    /**
+     * Gets the effective prefix (global + scoped)
+     */
+    private getEffectivePrefix;
+    /**
+     * Core logging method that handles styling and formatting
+     */
+    protected log(level: LogLevel, ...args: any[]): void;
+    /**
+     * Logs debug information (lowest priority)
+     */
+    debug(...args: any[]): void;
+    /**
+     * Logs informational messages
+     */
+    info(...args: any[]): void;
+    /**
+     * Logs warning messages
+     */
+    warn(...args: any[]): void;
+    /**
+     * Logs error messages
+     */
+    error(...args: any[]): void;
+    /**
+     * Logs success messages (special info level)
+     */
+    success(...args: any[]): void;
+    /**
+     * Logs trace information (detailed debugging)
+     */
+    trace(...args: any[]): void;
+    /**
+     * Logs critical errors (highest priority)
+     */
+    critical(...args: any[]): void;
+    /**
+     * Displays data in a table format
+     */
+    table(data: any, columns?: string[]): void;
+    /**
+     * Starts a collapsible group in the console
+     */
+    group(label: string, collapsed?: boolean): void;
+    /**
+     * Ends the current console group
+     */
+    groupEnd(): void;
+    /**
+     * Starts a timer with the given label
+     */
+    time(label: string): void;
+    /**
+     * Ends a timer and logs the elapsed time
+     */
+    timeEnd(label: string): void;
+    /**
+     * Display banner with specified or configured type
+     */
+    showBanner(bannerType?: BannerType): void;
+    /**
+     * Log with SVG background image
+     */
+    logWithSVG(message: string, svgContent?: string, options?: StyleOptions): void;
+    /**
+     * Log with animated background gradient
+     */
+    logAnimated(message: string, duration?: number): void;
+    /**
+     * Groups logs by a specific property using modern Object.groupBy (when available)
+     */
+    logGrouped<T>(items: T[], groupBy: (item: T) => string): void;
+    /**
+     * CLI command processor for logger configuration and export
+     */
+    cli(command: string): Promise<void>;
+}
+declare const defaultLogger: Logger;
+export default defaultLogger;
+/**
+ * Export individual methods for convenience (with proper binding)
+ */
+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 trace: (...args: any[]) => void;
+export declare const critical: (...args: any[]) => void;
+export declare const table: (data: any, 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 setGlobalPrefix: (prefix: string) => void;
+export declare const setVerbosity: (level: Verbosity) => void;
+export declare const addHandler: (handler: ILogHandler) => void;
+export declare const setTheme: (theme: ThemeVariant) => void;
+export declare const setBannerType: (bannerType: BannerType) => void;
+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 declare const cleanup: () => void;
+export declare const preset: (name: string) => void;
+export declare const presets: () => string[];
+export declare const hideTimestamp: () => void;
+export declare const showTimestamp: () => void;
+export declare const hideLocation: () => void;
+export declare const showLocation: () => void;
+export declare const hideBadges: () => void;
+export declare const showBadges: () => void;
+export declare const component: (name: string) => ComponentLogger;
+export declare const api: (name: string) => APILogger;
+export declare const scope: (name: string) => ScopedLogger;
+export declare const customize: (overrides: any) => void;
+export declare const styles: () => any;
+export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler, ExportLogHandler } from './handlers/index.js';
+export { StyleBuilder, StylePresets as Styles } from './styling/index.js';
+export { ScopedLogger, APILogger, ComponentLogger } from './ScopedLogger.js';
+//# sourceMappingURL=Logger.d.ts.map

package/dist/Logger.d.ts.map

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