@mks2508/better-logger 0.0.2-alpha.2 → 0.8.1-alpha.1

package/dist/cli/commands/ConfigCommand.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Configuration commands for Advanced Logger CLI
+ */
+/**
+ * Configuration command handler
+ */
+export class ConfigCommand {
+    name = 'config';
+    description = 'Show or update logger configuration';
+    usage = '/config [json|key=value,...]';
+    execute(args, logger) {
+        if (!args) {
+            this.showStatus(logger);
+            return;
+        }
+        try {
+            // Try to parse as JSON first
+            if (args.startsWith('{')) {
+                const config = JSON.parse(args);
+                this.applyConfig(config, logger);
+            }
+            else {
+                // Parse key=value pairs
+                const pairs = args.split(',').map(pair => pair.trim().split('='));
+                const config = {};
+                pairs.forEach(([key, value]) => {
+                    if (key && value) {
+                        config[key.trim()] = value.trim().replace(/["']/g, '');
+                    }
+                });
+                this.applyConfig(config, logger);
+            }
+        }
+        catch (error) {
+            logger.error('Invalid config format. Use JSON or key=value pairs:', error);
+            logger.info('Examples: /config {"theme":"dark"} or /config theme=neon,verbosity=debug');
+        }
+    }
+    showStatus(logger) {
+        const statusData = {
+            theme: logger.getConfig().theme || 'default',
+            verbosity: logger.getConfig().verbosity,
+            colors: logger.getConfig().enableColors,
+            timestamps: logger.getConfig().enableTimestamps,
+            stackTrace: logger.getConfig().enableStackTrace,
+            globalPrefix: logger.getConfig().globalPrefix || 'none',
+            bannerType: logger.getConfig().bannerType || 'simple',
+            handlers: logger.getHandlers().length
+        };
+        logger.group('⚙️ Logger Configuration');
+        logger.table(statusData);
+        logger.groupEnd();
+    }
+    applyConfig(config, logger) {
+        const validKeys = ['theme', 'verbosity', 'enableColors', 'enableTimestamps', 'enableStackTrace', 'globalPrefix', 'bannerType'];
+        const applied = [];
+        Object.entries(config).forEach(([key, value]) => {
+            if (validKeys.includes(key)) {
+                if (key === 'theme' && typeof value === 'string') {
+                    logger.setTheme(value);
+                    applied.push(`${key}=${value}`);
+                }
+                else if (key === 'bannerType' && typeof value === 'string') {
+                    logger.setBannerType(value);
+                    applied.push(`${key}=${value}`);
+                }
+                else if (key === 'verbosity') {
+                    logger.setVerbosity(value);
+                    applied.push(`${key}=${value}`);
+                }
+                else if (key === 'globalPrefix') {
+                    logger.setGlobalPrefix(value);
+                    applied.push(`${key}=${value}`);
+                }
+                else {
+                    logger.updateConfig({ [key]: value });
+                    applied.push(`${key}=${value}`);
+                }
+            }
+            else {
+                logger.warn(`Invalid config key: ${key}`);
+            }
+        });
+        if (applied.length > 0) {
+            logger.success(`Configuration updated: ${applied.join(', ')}`);
+        }
+    }
+}

package/dist/cli/commands/ExportCommand.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Export and clipboard commands for Advanced Logger CLI
+ */
+import type { ICommand } from '../CommandProcessor.js';
+import type { Logger } from '../../Logger.js';
+/**
+ * Export command - export logs in various formats
+ */
+export declare class ExportCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(args: string, logger: Logger): void;
+}
+/**
+ * Copy command - copy logs to clipboard
+ */
+export declare class CopyCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(args: string, logger: Logger): Promise<void>;
+}
+/**
+ * Buffer-size command - configure buffer size
+ */
+export declare class BufferSizeCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(args: string, logger: Logger): void;
+}
+/**
+ * Clear-buffer command - clear log buffer
+ */
+export declare class ClearBufferCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+/**
+ * Buffer-info command - show buffer information
+ */
+export declare class BufferInfoCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+//# sourceMappingURL=ExportCommand.d.ts.map

package/dist/cli/commands/ExportCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ExportCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAiG9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAoC;IAC/C,KAAK,SAAkD;IAEvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA2C9C;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA4B;IACvC,KAAK,SAAgD;IAE/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8B7D;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,IAAI,SAAiB;IACrB,WAAW,SAAyB;IACpC,KAAK,SAAyB;IAE9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAiB9C;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IAC/C,IAAI,SAAkB;IACtB,WAAW,SAA0B;IACrC,KAAK,SAAmB;IAExB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAY/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,IAAI,SAAiB;IACrB,WAAW,SAA4C;IACvD,KAAK,SAAkB;IAEvB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuB/C"}

package/dist/cli/commands/ExportCommand.js

@@ -0,0 +1,243 @@
+/**
+ * @fileoverview Export and clipboard commands for Advanced Logger CLI
+ */
+import { EXPORT_FORMATS } from '../../constants.js';
+/**
+ * Parse command line arguments into filters and options
+ */
+function parseArguments(args) {
+    const filters = {};
+    const options = {};
+    let format;
+    if (!args.trim())
+        return { filters, options };
+    // Split args by spaces, but keep quoted strings together
+    const argParts = args.match(/(?:[^\s"]+|"[^"]*")+/g) || [];
+    for (let i = 0; i < argParts.length; i++) {
+        const arg = argParts[i];
+        // Skip if arg is null/undefined
+        if (!arg) {
+            continue;
+        }
+        // Format (first argument without --)
+        if (i === 0 && !arg.startsWith('--') && arg in EXPORT_FORMATS) {
+            format = arg;
+            continue;
+        }
+        // Parse --flags
+        if (arg.startsWith('--')) {
+            const [flag, value] = arg.slice(2).split('=');
+            switch (flag) {
+                case 'level':
+                case 'levels':
+                    if (value) {
+                        filters.levels = value.split(',').map(l => l.trim());
+                    }
+                    break;
+                case 'since':
+                    if (value)
+                        filters.since = value;
+                    break;
+                case 'until':
+                    if (value)
+                        filters.until = value;
+                    break;
+                case 'prefix':
+                case 'prefixes':
+                    if (value) {
+                        filters.prefixes = value.split(',').map(p => p.trim());
+                    }
+                    break;
+                case 'exclude-prefix':
+                case 'exclude-prefixes':
+                    if (value) {
+                        filters.excludePrefixes = value.split(',').map(p => p.trim());
+                    }
+                    break;
+                case 'last':
+                    if (value)
+                        filters.last = parseInt(value, 10);
+                    break;
+                case 'first':
+                    if (value)
+                        filters.first = parseInt(value, 10);
+                    break;
+                case 'search':
+                    if (value)
+                        filters.search = value.replace(/['"]/g, '');
+                    break;
+                case 'with-stack':
+                    filters.withStackTrace = true;
+                    break;
+                case 'errors-only':
+                    filters.errorsOnly = true;
+                    break;
+                case 'group-by':
+                    if (value) {
+                        filters.groupBy = value;
+                        options.groupBy = value;
+                    }
+                    break;
+                case 'minimal':
+                    options.minimal = true;
+                    break;
+                case 'compact':
+                    options.compact = true;
+                    break;
+                case 'styled':
+                    options.styled = true;
+                    break;
+            }
+        }
+    }
+    return { filters, options, format };
+}
+/**
+ * Export command - export logs in various formats
+ */
+export class ExportCommand {
+    name = 'export';
+    description = 'Export logs to various formats';
+    usage = '/export <format> [--filter=value] [--option]';
+    execute(args, logger) {
+        const exportHandler = logger.getExportHandler();
+        if (!exportHandler) {
+            logger.error('Export handler not available. Make sure ExportLogHandler is registered.');
+            return;
+        }
+        const { filters, options, format } = parseArguments(args);
+        if (!format) {
+            logger.error('Format required. Available formats: ' + Object.keys(EXPORT_FORMATS).join(', '));
+            logger.info('Usage: /export <format> [--filter=value]');
+            logger.info('Example: /export json --level=error,warn --last=50');
+            return;
+        }
+        try {
+            const result = exportHandler.export(format, filters, options);
+            // Log success with metadata
+            logger.success(`✅ Export completed: ${result.metadata.filteredLogs} logs exported in ${format} format`);
+            // Show preview for small exports
+            if (result.data.length < 1000) {
+                logger.group(`📄 Preview (${format.toUpperCase()})`);
+                console.log(result.data);
+                logger.groupEnd();
+            }
+            else {
+                logger.info(`📄 Export size: ${(result.data.length / 1024).toFixed(2)}KB`);
+            }
+            // Show metadata
+            logger.table({
+                format: result.format,
+                totalLogs: result.metadata.totalLogs,
+                filtered: result.metadata.filteredLogs,
+                exported: result.metadata.exportedAt
+            });
+        }
+        catch (error) {
+            logger.error('Export failed:', error);
+        }
+    }
+}
+/**
+ * Copy command - copy logs to clipboard
+ */
+export class CopyCommand {
+    name = 'copy';
+    description = 'Copy logs to clipboard';
+    usage = '/copy <format> [--filter=value] [--option]';
+    async execute(args, logger) {
+        const exportHandler = logger.getExportHandler();
+        if (!exportHandler) {
+            logger.error('Export handler not available. Make sure ExportLogHandler is registered.');
+            return;
+        }
+        const { filters, options, format } = parseArguments(args);
+        if (!format) {
+            logger.error('Format required. Available formats: ' + Object.keys(EXPORT_FORMATS).join(', '));
+            logger.info('Usage: /copy <format> [--filter=value]');
+            logger.info('Example: /copy plain --level=error --last=25');
+            return;
+        }
+        try {
+            const success = await exportHandler.copyToClipboard(format, filters, options);
+            if (success) {
+                const result = exportHandler.export(format, filters, options);
+                logger.success(`📋 Copied ${result.metadata.filteredLogs} logs to clipboard (${format} format)`);
+            }
+            else {
+                logger.error('Failed to copy to clipboard. Browser may not support clipboard API.');
+            }
+        }
+        catch (error) {
+            logger.error('Copy failed:', error);
+        }
+    }
+}
+/**
+ * Buffer-size command - configure buffer size
+ */
+export class BufferSizeCommand {
+    name = 'buffer-size';
+    description = 'Set log buffer size';
+    usage = '/buffer-size <size>';
+    execute(args, logger) {
+        const exportHandler = logger.getExportHandler();
+        if (!exportHandler) {
+            logger.error('Export handler not available.');
+            return;
+        }
+        const size = parseInt(args.trim(), 10);
+        if (isNaN(size) || size <= 0) {
+            logger.error('Invalid buffer size. Must be a positive number.');
+            logger.info('Example: /buffer-size 2000');
+            return;
+        }
+        exportHandler.setBufferSize(size);
+        logger.success(`Buffer size set to ${size}`);
+    }
+}
+/**
+ * Clear-buffer command - clear log buffer
+ */
+export class ClearBufferCommand {
+    name = 'clear-buffer';
+    description = 'Clear the log buffer';
+    usage = '/clear-buffer';
+    execute(_args, logger) {
+        const exportHandler = logger.getExportHandler();
+        if (!exportHandler) {
+            logger.error('Export handler not available.');
+            return;
+        }
+        const stats = exportHandler.getBufferStats();
+        exportHandler.clearBuffer();
+        logger.success(`✅ Buffer cleared. Removed ${stats.size} log entries.`);
+    }
+}
+/**
+ * Buffer-info command - show buffer information
+ */
+export class BufferInfoCommand {
+    name = 'buffer-info';
+    description = 'Show buffer statistics and information';
+    usage = '/buffer-info';
+    execute(_args, logger) {
+        const exportHandler = logger.getExportHandler();
+        if (!exportHandler) {
+            logger.error('Export handler not available.');
+            return;
+        }
+        const stats = exportHandler.getBufferStats();
+        logger.group('📊 Buffer Information');
+        logger.table({
+            size: `${stats.size}/${stats.maxSize}`,
+            usage: `${stats.usage.toFixed(1)}%`,
+            oldestLog: stats.oldestLog?.toLocaleString() || 'None',
+            newestLog: stats.newestLog?.toLocaleString() || 'None'
+        });
+        logger.group('📈 Log Level Counts');
+        logger.table(stats.levelCounts);
+        logger.groupEnd();
+        logger.groupEnd();
+    }
+}

package/dist/cli/commands/StatusCommand.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Status and demo commands for Advanced Logger CLI
+ */
+import type { ICommand } from '../CommandProcessor.js';
+import type { Logger } from '../../Logger.js';
+/**
+ * Status command - show logger configuration and statistics
+ */
+export declare class StatusCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+/**
+ * Reset command - reset logger to defaults
+ */
+export declare class ResetCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+/**
+ * Demo command - show logger feature demonstration
+ */
+export declare class DemoCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+//# sourceMappingURL=StatusCommand.d.ts.map

package/dist/cli/commands/StatusCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/StatusCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkD;IAC7D,KAAK,SAAa;IAElB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAkC/C;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,IAAI,SAAW;IACf,WAAW,SAA4C;IACvD,KAAK,SAAY;IAEjB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG/C;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA8C;IACzD,KAAK,SAAW;IAEhB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuC/C"}

package/dist/cli/commands/StatusCommand.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Status and demo commands for Advanced Logger CLI
+ */
+/**
+ * Status command - show logger configuration and statistics
+ */
+export class StatusCommand {
+    name = 'status';
+    description = 'Show current logger status and configuration';
+    usage = '/status';
+    execute(_args, logger) {
+        const config = logger.getConfig();
+        const statusData = {
+            theme: config.theme ? config.theme : 'default',
+            verbosity: config.verbosity,
+            colors: config.enableColors,
+            timestamps: config.enableTimestamps,
+            stackTrace: config.enableStackTrace,
+            globalPrefix: config.globalPrefix ? config.globalPrefix : 'none',
+            bannerType: config.bannerType ? config.bannerType : 'simple',
+            handlers: logger.getHandlers().length,
+            bufferSize: config.bufferSize ? config.bufferSize : 1000
+        };
+        logger.group('⚙️ Logger Configuration');
+        logger.table(statusData);
+        logger.groupEnd();
+        // Show buffer stats if ExportLogHandler is present
+        const exportHandler = logger.getExportHandler();
+        if (exportHandler) {
+            const bufferStats = exportHandler.getBufferStats();
+            logger.group('📊 Buffer Statistics');
+            logger.table({
+                size: `${bufferStats.size}/${bufferStats.maxSize}`,
+                usage: `${bufferStats.usage.toFixed(1)}%`,
+                oldestLog: bufferStats.oldestLog ? bufferStats.oldestLog.toISOString() : 'None',
+                newestLog: bufferStats.newestLog ? bufferStats.newestLog.toISOString() : 'None',
+                errorCount: bufferStats.levelCounts.error + bufferStats.levelCounts.critical,
+                warningCount: bufferStats.levelCounts.warn
+            });
+            logger.groupEnd();
+        }
+    }
+}
+/**
+ * Reset command - reset logger to defaults
+ */
+export class ResetCommand {
+    name = 'reset';
+    description = 'Reset logger configuration to defaults';
+    usage = '/reset';
+    execute(_args, logger) {
+        logger.resetConfig();
+    }
+}
+/**
+ * Demo command - show logger feature demonstration
+ */
+export class DemoCommand {
+    name = 'demo';
+    description = 'Show comprehensive feature demonstration';
+    usage = '/demo';
+    execute(_args, logger) {
+        logger.group('🎪 Advanced Logger Demo');
+        // Basic logging demo
+        logger.debug('Debug message with detailed information');
+        logger.info('Informational message about system state');
+        logger.warn('Warning about deprecated feature');
+        logger.error('Error processing user request');
+        logger.success('Operation completed successfully');
+        logger.critical('Critical system failure detected');
+        // Advanced features demo
+        logger.group('📊 Advanced Features Demo');
+        // Table demo
+        logger.table([
+            { feature: 'Styled Console', status: '✅ Active', performance: 'Excellent' },
+            { feature: 'Theme System', status: '✅ Active', performance: 'Great' },
+            { feature: 'CLI Interface', status: '✅ Active', performance: 'Good' },
+            { feature: 'Export System', status: '✅ Active', performance: 'Excellent' }
+        ]);
+        // Timer demo
+        logger.time('demo-operation');
+        setTimeout(() => {
+            logger.timeEnd('demo-operation');
+        }, 100);
+        // SVG demo
+        logger.logWithSVG('SVG Demo');
+        // Animated demo
+        logger.logAnimated('🌟 Animated Logger Demo 🌟', 2);
+        logger.groupEnd();
+        logger.groupEnd();
+        logger.info('Demo completed! Check the console for styled output.');
+    }
+}

package/dist/cli/commands/ThemeCommand.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Theme and banner commands for Advanced Logger CLI
+ */
+import type { ICommand } from '../CommandProcessor.js';
+import type { Logger } from '../../Logger.js';
+/**
+ * Themes command - show available themes
+ */
+export declare class ThemesCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+/**
+ * Banners command - show available banner types
+ */
+export declare class BannersCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+/**
+ * Banner command - change/show banner type
+ */
+export declare class BannerCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(args: string, logger: Logger): void;
+}
+//# sourceMappingURL=ThemeCommand.d.ts.map

package/dist/cli/commands/ThemeCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ThemeCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkC;IAC7C,KAAK,SAAa;IAElB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAgB/C;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,IAAI,SAAa;IACjB,WAAW,SAAiC;IAC5C,KAAK,SAAc;IAEnB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAoB/C;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAwC;IACnD,KAAK,SAAoB;IAEzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9C"}

package/dist/cli/commands/ThemeCommand.js

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Theme and banner commands for Advanced Logger CLI
+ */
+import { THEME_PRESETS, BANNER_VARIANTS } from '../../styling/index.js';
+import { StyleBuilder } from '../../styling/index.js';
+/**
+ * Themes command - show available themes
+ */
+export class ThemesCommand {
+    name = 'themes';
+    description = 'Show available theme presets';
+    usage = '/themes';
+    execute(_args, logger) {
+        logger.group('🎨 Available Themes');
+        Object.keys(THEME_PRESETS).forEach(themeName => {
+            const preview = THEME_PRESETS[themeName];
+            const previewStyle = new StyleBuilder()
+                .bg(preview.info.background)
+                .color(preview.info.color)
+                .padding('4px 8px')
+                .rounded('4px')
+                .border(preview.info.border)
+                .build();
+            console.log(`%c${themeName}`, previewStyle, `- ${themeName} theme preview`);
+        });
+        logger.groupEnd();
+    }
+}
+/**
+ * Banners command - show available banner types
+ */
+export class BannersCommand {
+    name = 'banners';
+    description = 'Show available banner types';
+    usage = '/banners';
+    execute(_args, logger) {
+        logger.group('🖼️ Available Banner Types');
+        Object.keys(BANNER_VARIANTS).forEach(bannerName => {
+            const banner = BANNER_VARIANTS[bannerName];
+            console.log(`%c${bannerName}`, 'font-weight: bold; color: #667eea;');
+            console.log(`%cPreview:`, 'color: #666; font-size: 12px;');
+            // Show a mini preview
+            if (bannerName === 'simple') {
+                console.log(`%c${banner.text}`, banner.style);
+            }
+            else if (bannerName === 'ascii') {
+                console.log(`%c${banner.text.split('\n').slice(1, 4).join('\n')}...`, 'font-family: monospace; color: #667eea; font-size: 10px;');
+            }
+            else if (bannerName === 'unicode') {
+                console.log(`%c${banner.text}`, banner.style);
+            }
+            else {
+                console.log(`%c${bannerName} banner`, 'color: #666; font-style: italic;');
+            }
+        });
+        logger.groupEnd();
+    }
+}
+/**
+ * Banner command - change/show banner type
+ */
+export class BannerCommand {
+    name = 'banner';
+    description = 'Change or show current banner type';
+    usage = '/banner [type]';
+    execute(args, logger) {
+        if (!args) {
+            logger.showBanner();
+            return;
+        }
+        if (args in BANNER_VARIANTS) {
+            logger.setBannerType(args);
+            logger.showBanner();
+        }
+        else {
+            logger.error(`Invalid banner type: ${args}. Available: ${Object.keys(BANNER_VARIANTS).join(', ')}`);
+        }
+    }
+}

package/dist/cli/help.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Help system for Advanced Logger CLI
+ */
+import type { ICommand } from './CommandProcessor.js';
+import type { Logger } from '../Logger.js';
+/**
+ * Help command - show comprehensive CLI help
+ */
+export declare class HelpCommand implements ICommand {
+    name: string;
+    description: string;
+    usage: string;
+    execute(_args: string, logger: Logger): void;
+}
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA0C;IACrD,KAAK,SAAqB;IAE1B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA8G/C"}