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

package/dist/types/index.d.ts

@@ -1,675 +1,7 @@
-export declare const addHandler: (handler: ILogHandler) => void;
-
-/**
- * Example custom handler for analytics demonstration
- */
-export declare class AnalyticsLogHandler implements ILogHandler {
-    handle(level: LogLevel, message: string, _args: any[], metadata: LogMetadata): void;
-}
-
-/**
- * Banner variants for different display capabilities
- */
-export declare const BANNER_VARIANTS: {
-    simple: {
-        text: string;
-        style: string;
-    };
-    ascii: {
-        text: string;
-        style: string;
-    };
-    unicode: {
-        text: string;
-        style: string;
-    };
-    svg: {
-        text: string;
-        style: string;
-    };
-    animated: {
-        text: string;
-        style: string;
-    };
-};
-
-/**
- * Banner types for different visual approaches
- */
-export declare type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';
-
-/**
- * Buffer statistics for log management
- */
-declare interface BufferStats {
-    size: number;
-    maxSize: number;
-    usage: number;
-    oldestLog?: Date;
-    newestLog?: Date;
-    levelCounts: Record<LogLevel, number>;
-}
-
-export declare const cli: (command: string) => Promise<void>;
-
-export declare const createScopedLogger: (prefix: string) => Logger;
-
-/**
- * Creates a new StyleBuilder instance for custom console styling
- */
-export declare const createStyle: () => StyleBuilder;
-
-export declare const critical: (...args: any[]) => void;
-
-export declare const debug: (...args: any[]) => void;
-
-/**
- * Default configuration values
- */
-export declare const DEFAULT_CONFIG: {
-    readonly verbosity: "info";
-    readonly enableColors: true;
-    readonly enableTimestamps: true;
-    readonly enableStackTrace: true;
-    readonly theme: "default";
-    readonly bannerType: "simple";
-    readonly bufferSize: 1000;
-};
-
-export declare const error: (...args: any[]) => void;
-
-/**
- * Export filter options
- */
-declare 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 formats for log data
- */
-declare type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';
-
-/**
- * Export log handler with circular buffer and multiple export formats
- */
-declare class ExportLogHandler implements ILogHandler {
-    private buffer;
-    private maxSize;
-    private groupDepth;
-    private currentGroup?;
-    constructor(maxSize?: number);
-    /**
-     * Handle incoming log and store in buffer
-     */
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
-    /**
-     * Set group tracking for nested logs
-     */
-    setGroupInfo(depth: number, groupName?: string): void;
-    /**
-     * Get buffer statistics
-     */
-    getBufferStats(): BufferStats;
-    /**
-     * Clear the buffer
-     */
-    clearBuffer(): void;
-    /**
-     * Set buffer size (with limits)
-     */
-    setBufferSize(size: number): void;
-    /**
-     * Filter logs based on criteria
-     */
-    private filterLogs;
-    /**
-     * Export logs in JSON format
-     */
-    private exportJSON;
-    /**
-     * Export logs in CSV format
-     */
-    private exportCSV;
-    /**
-     * Export logs in Markdown format
-     */
-    private exportMarkdown;
-    /**
-     * Export logs in plain text format
-     */
-    private exportPlain;
-    /**
-     * Export logs in HTML format
-     */
-    private exportHTML;
-    /**
-     * Get emoji for log level
-     */
-    private getLevelEmoji;
-    /**
-     * Main export function
-     */
-    export(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): ExportResult;
-    /**
-     * Copy to clipboard with fallback
-     */
-    copyToClipboard(format: ExportFormat, filters?: ExportFilters, options?: ExportOptions): Promise<boolean>;
-    /**
-     * Get all logs (for debugging)
-     */
-    getAllLogs(): LogEntry[];
-}
-
-/**
- * Export options for different formats
- */
-declare interface ExportOptions {
-    minimal?: boolean;
-    compact?: boolean;
-    styled?: boolean;
-    includeMetadata?: boolean;
-    groupBy?: ExportFilters['groupBy'];
-}
-
-/**
- * Export result with metadata
- */
-declare interface ExportResult {
-    format: string;
-    data: string;
-    metadata: {
-        totalLogs: number;
-        filteredLogs: number;
-        exportedAt: string;
-        filters?: ExportFilters;
-        options?: ExportOptions;
-    };
-}
-
-/**
- * File-based log handler for persistent logging
- */
-export declare class FileLogHandler implements ILogHandler {
-    private filename;
-    constructor(filename?: string);
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
-}
-
-/**
- * @fileoverview Timestamp utilities for Advanced Logger
- */
-/**
- * Formats the timestamp using modern Date API
- */
-export declare function formatTimestamp(): string;
-
-export declare const group: (label: string, collapsed?: boolean) => void;
-
-export declare const groupEnd: () => void;
-
-/**
- * Interface for custom log handlers (extensibility)
- */
-export declare interface ILogHandler {
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
-}
-
-export declare const info: (...args: any[]) => void;
-
-/**
- * Style configuration for each log level
- */
-declare interface LevelStyleConfig {
-    emoji: string;
-    label: string;
-    background: string;
-    color: string;
-    border: string;
-    shadow: string;
-}
-
-/**
- * Supported log levels in hierarchical order (debug < info < warn < error < critical)
- */
-declare const LOG_LEVELS: {
-    readonly debug: 0;
-    readonly info: 1;
-    readonly warn: 2;
-    readonly error: 3;
-    readonly critical: 4;
-};
-
-export declare const logAnimated: (message: string, duration?: number) => void;
-
-/**
- * Stored log entry for export functionality
- */
-declare interface LogEntry {
-    id: string;
-    timestamp: string;
-    level: LogLevel;
-    prefix?: string;
-    message: string;
-    args: any[];
-    location?: StackInfo;
-    groupInfo?: {
-        depth: number;
-        groupName?: string;
-    };
-}
-
-/**
- * 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?;
-    /**
-     * Creates a new Logger instance
-     */
-    constructor(config?: Partial<LoggerConfig>);
-    /**
-     * 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;
-    /**
-     * Creates a scoped logger with a specific prefix
-     */
-    createScopedLogger(prefix: string): Logger;
-    /**
-     * 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
-     */
-    private log;
-    /**
-     * 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 logger: Logger;
-export default logger;
-
-/**
- * Configuration interface for logger instances
- */
-export declare interface LoggerConfig {
-    globalPrefix?: string;
-    verbosity: Verbosity;
-    enableColors: boolean;
-    enableTimestamps: boolean;
-    enableStackTrace: boolean;
-    theme?: ThemeVariant;
-    bannerType?: BannerType;
-    bufferSize?: number;
-}
-
-/**
- * Log level type derived from LOG_LEVELS keys
- */
-export declare type LogLevel = keyof typeof LOG_LEVELS;
-
-/**
- * Metadata associated with each log entry
- */
-export declare interface LogMetadata {
-    timestamp: string;
-    level: LogLevel;
-    prefix?: string;
-    stackInfo?: StackInfo;
-    group?: string;
-}
-
-export declare const logWithSVG: (message: string, svgContent?: string, options?: StyleOptions) => void;
-
-/**
- * Parses the current stack trace to extract caller information
- */
-export declare function parseStackTrace(): StackInfo | null;
-
-/**
- * Remote log handler for sending logs to external services
- */
-export declare class RemoteLogHandler implements ILogHandler {
-    private endpoint;
-    private apiKey?;
-    constructor(endpoint: string, apiKey?: string);
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): Promise<void>;
-}
-
-export declare const setBannerType: (bannerType: BannerType) => void;
-
-export declare const setGlobalPrefix: (prefix: string) => void;
-
-export declare const setTheme: (theme: ThemeVariant) => void;
-
-export declare const setVerbosity: (level: Verbosity) => void;
-
-export declare const showBanner: (bannerType?: BannerType) => void;
-
-/**
- * Parsed stack trace information
- */
-export declare interface StackInfo {
-    file: string;
-    line: number;
-    column: number;
-    function?: string;
-}
-
-/**
- * @fileoverview StyleBuilder class for Advanced Logger
- */
-/**
- * Utility class for creating dynamic console styles with method chaining
- */
-export declare class StyleBuilder {
-    private styles;
-    constructor(baseStyle?: string);
-    /**
-     * Add background color or gradient
-     */
-    bg(background: string): StyleBuilder;
-    /**
-     * Add text color
-     */
-    color(color: string): StyleBuilder;
-    /**
-     * Add border styling
-     */
-    border(border: string): StyleBuilder;
-    /**
-     * Add box shadow
-     */
-    shadow(shadow: string): StyleBuilder;
-    /**
-     * Add padding
-     */
-    padding(padding: string): StyleBuilder;
-    /**
-     * Add margin
-     */
-    margin(margin: string): StyleBuilder;
-    /**
-     * Add border radius
-     */
-    rounded(radius?: string): StyleBuilder;
-    /**
-     * Add font weight
-     */
-    bold(): StyleBuilder;
-    /**
-     * Add font styling
-     */
-    font(font: string): StyleBuilder;
-    /**
-     * Add font size
-     */
-    size(size: string): StyleBuilder;
-    /**
-     * Add line height
-     */
-    lineHeight(height: string): StyleBuilder;
-    /**
-     * Add text decoration
-     */
-    underline(): StyleBuilder;
-    /**
-     * Add text transform
-     */
-    uppercase(): StyleBuilder;
-    /**
-     * Add opacity
-     */
-    opacity(value: number): StyleBuilder;
-    /**
-     * Add display property
-     */
-    display(value: string): StyleBuilder;
-    /**
-     * Add position property
-     */
-    position(value: string): StyleBuilder;
-    /**
-     * Add transform property
-     */
-    transform(value: string): StyleBuilder;
-    /**
-     * Add animation property
-     */
-    animation(value: string): StyleBuilder;
-    /**
-     * Add transition property
-     */
-    transition(value: string): StyleBuilder;
-    /**
-     * Add cursor property
-     */
-    cursor(value: string): StyleBuilder;
-    /**
-     * Add any custom CSS property
-     */
-    custom(property: string, value: string): StyleBuilder;
-    /**
-     * Add any CSS property (alias for custom)
-     */
-    css(property: string, value: string): StyleBuilder;
-    /**
-     * Build the final CSS string
-     */
-    build(): string;
-    /**
-     * Clear all styles and start fresh
-     */
-    clear(): StyleBuilder;
-    /**
-     * Clone this StyleBuilder with the same styles
-     */
-    clone(): StyleBuilder;
-    /**
-     * Merge another StyleBuilder's styles into this one
-     */
-    merge(other: StyleBuilder): StyleBuilder;
-}
-
-/**
- * Options for styling components
- */
-export declare interface StyleOptions {
-    width?: number;
-    height?: number;
-    padding?: string;
-}
-
-/**
- * Pre-defined style presets for common use cases
- */
-export declare const StylePresets: {
-    success: () => StyleBuilder;
-    error: () => StyleBuilder;
-    warning: () => StyleBuilder;
-    info: () => StyleBuilder;
-    debug: () => StyleBuilder;
-    muted: () => StyleBuilder;
-    accent: () => StyleBuilder;
-    neon: () => StyleBuilder;
-};
-
-/**
- * Pre-built style presets for common use cases
- */
-export declare const stylePresets: {
-    success: string;
-    error: string;
-    warning: string;
-    info: string;
-    accent: string;
-};
-
-export declare const success: (...args: any[]) => void;
-
-export declare const table: (data: any, columns?: string[]) => void;
-
-/**
- * Theme-specific banners for enhanced visual theming
- */
-export declare const THEME_BANNERS: Record<ThemeVariant, {
-    simple: string;
-    style: string;
-}>;
-
-/**
- * Theme configurations for different visual styles
- */
-export declare const THEME_PRESETS: Record<ThemeVariant, Record<string, LevelStyleConfig>>;
-
-/**
- * Theme variants for different visual styles
- */
-export declare type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';
-
-export declare const time: (label: string) => void;
-
-export declare const timeEnd: (label: string) => void;
-
-/**
- * Timer entry for performance measurement
- */
-export declare interface TimerEntry {
-    label: string;
-    startTime: number;
-}
-
-export declare const trace: (...args: any[]) => void;
-
-/**
- * Verbosity level type for filtering logs
- */
-export declare type Verbosity = LogLevel | 'silent';
-
-export declare const warn: (...args: any[]) => void;
-
-export { }
+/**
+ * @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 { 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

@@ -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,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/types/index.js

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Type definitions exports for Advanced Logger
+ */
+export { LOG_LEVELS } from './core.js';

package/dist/types/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":""}