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

package/dist/types/styling.d.ts

@@ -1,751 +0,0 @@
-/**
- * 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';
-
-/**
- * Available banner types
- *
- * @example
- * ```typescript
- * import { bannerTypes } from '@mks2508/better-logger/styling';
- *
- * console.log('Available banners:', bannerTypes);
- * ```
- */
-export declare const bannerTypes: string[];
-
-/**
- * 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 createScopedLogger: (prefix: string) => Logger;
-
-/**
- * Utility functions for creating custom styles
- *
- * @example
- * ```typescript
- * import { createStyle, StyleBuilder } from '@mks2508/better-logger/styling';
- *
- * const myStyle = createStyle()
- *   .bg('linear-gradient(45deg, #ff6b6b, #feca57)')
- *   .color('white')
- *   .padding('10px')
- *   .build();
- *
- * console.log('%cCustom Message', myStyle);
- * ```
- */
-export declare const createStyle: () => StyleBuilder;
-
-export declare const critical: (...args: any[]) => void;
-
-/**
- * Export individual styled logging methods
- */
-export declare const debug: (...args: any[]) => void;
-
-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;
-    };
-}
-
-export declare const group: (label: string, collapsed?: boolean) => void;
-
-export declare const groupEnd: () => void;
-
-/**
- * Interface for custom log handlers (extensibility)
- */
-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
- */
-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>;
-}
-
-/**
- * Configuration interface for logger instances
- */
-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
- */
-declare type LogLevel = keyof typeof LOG_LEVELS;
-
-/**
- * Metadata associated with each log entry
- */
-declare interface LogMetadata {
-    timestamp: string;
-    level: LogLevel;
-    prefix?: string;
-    stackInfo?: StackInfo;
-    group?: string;
-}
-
-export declare const logWithSVG: (message: string, svgContent?: string, options?: StyleOptions) => 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: any) => void;
-
-export declare const showBanner: (bannerType?: BannerType) => void;
-
-/**
- * Display initialization banner
- *
- * @param bannerType - Type of banner to display
- *
- * @example
- * ```typescript
- * import { showInitBanner } from '@mks2508/better-logger/styling';
- *
- * showInitBanner('animated');
- * ```
- */
-export declare const showInitBanner: (bannerType?: BannerType) => void;
-
-/**
- * Parsed stack trace information
- */
-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;
-}
-
-/**
- * Enhanced Logger with advanced styling capabilities
- *
- * @example
- * ```typescript
- * import { StyledLogger } from '@mks2508/better-logger/styling';
- *
- * const logger = new StyledLogger();
- * logger.setTheme('neon');
- * logger.logAnimated('🌟 Animated message!');
- * logger.logWithSVG('Custom SVG Logo', svgContent);
- * ```
- */
-export declare class StyledLogger extends Logger {
-    /**
-     * Log with SVG background image
-     *
-     * @param message - The message to log
-     * @param svgContent - SVG content as string (optional)
-     * @param options - Styling options
-     *
-     * @example
-     * ```typescript
-     * logger.logWithSVG('My App', '<svg>...</svg>', {
-     *   width: 400,
-     *   height: 80,
-     *   padding: '40px 200px'
-     * });
-     * ```
-     */
-    logWithSVG(message: string, svgContent?: string, options?: StyleOptions): void;
-    /**
-     * Log with animated background gradient
-     *
-     * @param message - The message to log
-     * @param duration - Animation duration in seconds
-     *
-     * @example
-     * ```typescript
-     * logger.logAnimated('🚀 Loading...', 2);
-     * ```
-     */
-    logAnimated(message: string, duration?: number): void;
-    /**
-     * Display banner with specified type
-     *
-     * @param bannerType - Type of banner to display
-     *
-     * @example
-     * ```typescript
-     * logger.showBanner('animated');
-     * ```
-     */
-    showBanner(bannerType?: BannerType): void;
-    /**
-     * Set banner type for initialization display
-     *
-     * @param bannerType - Type of banner to display
-     *
-     * @example
-     * ```typescript
-     * logger.setBannerType('svg');
-     * ```
-     */
-    setBannerType(bannerType: BannerType): void;
-    /**
-     * Sets the logger theme with visual banner
-     *
-     * @param theme - Theme variant to apply
-     *
-     * @example
-     * ```typescript
-     * logger.setTheme('cyberpunk'); // Shows themed banner
-     * ```
-     */
-    setTheme(theme: ThemeVariant): void;
-}
-
-declare const styledLogger: StyledLogger;
-export default styledLogger;
-
-/**
- * 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
- *
- * @example
- * ```typescript
- * import { stylePresets } from '@mks2508/better-logger/styling';
- *
- * console.log('%cSuccess!', stylePresets.success);
- * console.log('%cError!', stylePresets.error);
- * ```
- */
-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>>;
-
-/**
- * Available themes for the logger
- *
- * @example
- * ```typescript
- * import { themes } from '@mks2508/better-logger/styling';
- *
- * console.log('Available themes:', Object.keys(themes));
- * ```
- */
-export declare const themes: string[];
-
-/**
- * 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;
-
-export declare const trace: (...args: any[]) => void;
-
-/**
- * Verbosity level type for filtering logs
- */
-declare type Verbosity = LogLevel | 'silent';
-
-export declare const warn: (...args: any[]) => void;
-
-export { }