devkill 0.12.2

package/lib/cli/ui/components/help/help.constants.d.ts

@@ -0,0 +1,8 @@
+interface HelpSection {
+    id: string;
+    title: string;
+    icon: string;
+    content: string[];
+}
+export declare const HELP_SECTIONS: HelpSection[];
+export {};

package/lib/cli/ui/components/help/help.constants.js

@@ -0,0 +1,270 @@
+/* eslint-disable quotes */
+import pc from 'picocolors';
+export const HELP_SECTIONS = [
+    {
+        id: 'welcome',
+        title: 'Welcome',
+        icon: '👋',
+        content: [
+            pc.bold('Welcome to devkill!'),
+            '',
+            'Devkill helps you find and manage "junk" directories',
+            'left behind by development tools.',
+            '',
+            'These folders are essential while working on projects,',
+            'but over time they pile up, eating tons of space long',
+            "after you've moved on.",
+            '',
+            'Devkill scans your directories, lists these folders with',
+            'their sizes, and shows when you last touched each project,',
+            'so you can quickly decide what to keep and what to clean.',
+            '',
+            pc.green(pc.bold('Multi-language. Easy. Powerful.')),
+        ],
+    },
+    {
+        id: 'shortcuts',
+        title: 'Quick Reference',
+        icon: '⌨️',
+        content: [
+            pc.cyan(pc.bold('Navigation')),
+            `  ${pc.green('↑/↓ or j/k')}       Move cursor.`,
+            `  ${pc.green('←/→ or h/l')}       Switch panels.`,
+            `  ${pc.green('PgUp/PgDown')}      Fast scroll.`,
+            `  ${pc.green('Home/End')}         Jump to first/last.`,
+            '',
+            pc.cyan(pc.bold('Actions (normal mode)')),
+            `  ${pc.green('SPACE / DEL')}      Delete folder.`,
+            `  ${pc.green('o')}                Open parent folder.`,
+            `  ${pc.green('/')}                Search (Regex supported).`,
+            `  ${pc.green('t')}                Enter ${pc.green('multi-select mode')}.`,
+            '',
+            pc.cyan(pc.bold('Actions (multi-select mode)')),
+            `  ${pc.green('t')}                Back to ${pc.green('normal mode')} without delete.`,
+            `  ${pc.green('v')}                Range selection.`,
+            `  ${pc.green('a')}                Select/deselect all.`,
+            `  ${pc.green('SPACE')}            Select/deselect current.`,
+            `  ${pc.green('ENTER')}            Delete selected folders.`,
+            '',
+            pc.cyan(pc.bold('Others')),
+            `  ${pc.green('e')}                Show errors.`,
+            `  ${pc.green('q / ESC')}          Quit devkill.`,
+        ],
+    },
+    {
+        id: 'header',
+        title: 'Header Info',
+        icon: '📊',
+        content: [
+            pc.bold('Understanding the header'),
+            '',
+            pc.bold(pc.green('Potential Space')),
+            'The total size of all detected directories.',
+            'This represents the maximum possible space you could',
+            'free if you deleted everything.',
+            '',
+            pc.bold(pc.green('Freed Space')),
+            'The space actually recovered in this session.',
+            '',
+            pc.bold(pc.green('Last Modified (age)')),
+            'Shows when the last file in the parent workspace was',
+            'modified. This helps identify abandoned projects.',
+            '',
+            pc.dim('Note: This checks the entire parent directory,'),
+            pc.dim('not just the target folder itself.'),
+            '',
+            pc.bold(pc.green('Progress Bar')),
+            'The progress bar has 3 color-coded parts:',
+            '',
+            ` ${pc.green('▀▀▀▀')} Green  → Results ready (stats calculated)`,
+            ` ${pc.white('▀▀▀▀')} White  → Directories examined`,
+            ` ${pc.gray('▀▀▀▀')} Gray   → Pending to be analyzed`,
+            '',
+            'Full bar example:',
+            ` ${pc.green('▀▀▀▀▀▀▀')}${pc.white('▀▀▀▀')}${pc.gray('▀▀▀▀▀▀▀▀▀▀▀')}`,
+        ],
+    },
+    {
+        id: 'warnings',
+        title: 'Warnings',
+        icon: '⚠️',
+        content: [
+            pc.bold(pc.yellow('Important: Not all results are safe to delete!')),
+            '',
+            'Some applications (VSCode, Discord, Slack, etc.) need',
+            'their dependencies to work. If their directory is deleted,',
+            'the application will probably break until dependencies',
+            'are reinstalled.',
+            '',
+            'Devkill will try to detect this folders and show "⚠️"',
+            'alongside the result and mark it as "sensitive".',
+            '',
+            '',
+            pc.bold(pc.green('Pro tip')),
+            'Use the Info panel (→) to see more information',
+            'about why a folder is flagged.',
+        ],
+    },
+    {
+        id: 'panels',
+        title: 'Panels',
+        icon: '📋',
+        content: [
+            pc.bold('Understanding the interface'),
+            '',
+            pc.bold(pc.cyan('Delete Panel (Main)')),
+            'Lists all found directories with their sizes.',
+            'Navigate with arrow keys or j/k.',
+            'Press SPACE to delete a folder.',
+            'Press → to see details.',
+            '',
+            pc.bold(pc.cyan('Info Panel')),
+            'Shows details of the selected result. Plus notes',
+            'that might be useful to you.',
+            '',
+            pc.bold(pc.cyan('Options Panel')),
+            'Configure devkill settings on the fly.',
+            '',
+            pc.bold(pc.cyan('Help Panel (You are here!)')),
+            'Navigate through help sections.',
+            'Use ↑/↓ to change sections.',
+            'Scroll content with j/k or arrow keys.',
+        ],
+    },
+    //   { // TODO pending to add .npkillrc support
+    //     id: 'config',
+    //     title: 'Configuration',
+    //     icon: '⚙️',
+    //     content: [
+    //       colors.bold('Customizing npkill with .npkillrc'),
+    //       '',
+    //       colors.bold.cyan('What is .npkillrc?'),
+    //       'A configuration file where you can set your default',
+    //       'preferences, custom profiles, and target folders.',
+    //       '',
+    //       colors.bold.cyan('Location'),
+    //       '',
+    //       'Place it in your home directory:',
+    //       colors.dim('  ~/.npkillrc'),
+    //       '',
+    //       'Or load from a custom location:',
+    //       colors.green('  npkill --config /path/to/config'),
+    //       '',
+    //       colors.bold.cyan('Example Configuration'),
+    //       '',
+    //       colors.dim('{'),
+    //       colors.dim('  "targets": ["node_modules", ".venv", "target"],'),
+    //       colors.dim('  "exclude": [".git", "important-project"],'),
+    //       colors.dim('  "sortBy": "size",'),
+    //       colors.dim('  "excludeSensitiveResults": true,'),
+    //       colors.dim('  "profiles": {'),
+    //       colors.dim('    "mystack": {'),
+    //       colors.dim('      "targets": ["node_modules", "venv", "target"]'),
+    //       colors.dim('    }'),
+    //       colors.dim('  }'),
+    //       colors.dim('}'),
+    //       '',
+    //       colors.bold.cyan('Available Options'),
+    //       `${colors.green('targets')}              Target folder names to search`,
+    //       `${colors.green('exclude')}              Directories to skip`,
+    //       `${colors.green('sortBy')}               Default sort (size/path/age)`,
+    //       `${colors.green('sizeUnit')}             Display unit (auto/mb/gb)`,
+    //       `${colors.green('profiles')}             Custom profile definitions`,
+    //     ],
+    //   },
+    {
+        id: 'profiles',
+        title: 'Profiles',
+        icon: '📦',
+        content: [
+            pc.bold('Working with profiles'),
+            '',
+            pc.bold(pc.cyan('What are profiles?')),
+            'Profiles are presets of target folders for different',
+            'programming languages and tools.',
+            '',
+            pc.bold(pc.cyan('Usage')),
+            'List available profiles:',
+            pc.green('  devkill -p'),
+            '',
+            'Single profile:',
+            pc.green('  devkill -p node'),
+            '',
+            'Multiple profiles:',
+            pc.green('  devkill -p node,python,java'),
+            '',
+            // colors.bold.cyan('Custom Profiles'),
+            //   'Define your own in .npkillrc:',
+            //   '',
+            //   colors.dim('"profiles": {'),
+            //   colors.dim('  "webdev": {'),
+            //   colors.dim('    "targets": ["node_modules", "dist", ".next"]'),
+            //   colors.dim('  }'),
+            //   colors.dim('}'),
+            //   '',
+            //   'Then use:',
+            // colors.green('  npkill -p webdev'),
+        ],
+    },
+    {
+        id: 'tips',
+        title: 'Tips & Tricks',
+        icon: '💡',
+        content: [
+            pc.bold('Get the most out of devkill'),
+            '',
+            pc.bold(pc.cyan('1. Use profiles')),
+            '   Start with profiles for common tools:',
+            `   ${pc.green('devkill -p node,python,java')}.`,
+            '',
+            pc.bold(pc.cyan('2. Sort intelligently')),
+            '   Sort by size to find the biggest space hogs:',
+            `   ${pc.green('devkill --sort size')}`,
+            '   Or by age to find abandoned projects.',
+            '',
+            pc.bold(pc.cyan('3. Exclude what you need')),
+            '   Protect important directories:',
+            `   ${pc.green('devkill -E ".git,important_project"')}`,
+            '',
+            pc.bold(pc.cyan('4. Try dry-run mode')),
+            '   Test without risk using --dry-run.',
+            '   Nothing is deleted! (simulated with delay).',
+            '',
+            pc.bold(pc.cyan('5. Multi-select workflow')),
+            '   Press "t" to enter selection mode.',
+            '   Mark folders with SPACE.',
+            '   Press ENTER to delete all at once.',
+            '',
+            '   Press "v" on first item.',
+            '   Move to last item and press "v" again.',
+            '   All items in between are selected!',
+            '',
+            pc.bold(pc.cyan('6. Check details first')),
+            '   Unsure about a result? Press → to see',
+            '   more details.',
+        ],
+    },
+    {
+        id: 'about',
+        title: 'About',
+        icon: 'ℹ️',
+        content: [
+            pc.bold('About devkill'),
+            '',
+            'Devkill, a tool designed to help developers',
+            'reclaim disk space by finding and removing',
+            'unnecessary dependency folders.',
+            '',
+            pc.bold(pc.cyan('Get Involved')),
+            'GitHub: github.com/arupbasak/devkill',
+            'Report bugs, request features, contribute!',
+            '',
+            pc.bold(pc.cyan('License')),
+            'MIT License - Free and open source.',
+            '',
+            '',
+            pc.dim('Made with ❤️'),
+        ],
+    },
+];
+//# sourceMappingURL=help.constants.js.map

package/lib/cli/ui/components/help/help.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.constants.js","sourceRoot":"","sources":["../../../../../src/cli/ui/components/help/help.constants.ts"],"names":[],"mappings":"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"}

package/lib/cli/ui/components/help/help.ui.d.ts

@@ -0,0 +1,30 @@
+import { Subject } from 'rxjs';
+import type { IKeyPress } from '../../../interfaces/key-press.interface.js';
+import { BaseUi, type InteractiveUi } from '../../base.ui.js';
+export declare class HelpUi extends BaseUi implements InteractiveUi {
+    resultIndex: number;
+    readonly goToOptions$: Subject<null>;
+    private selectedSection;
+    private scrollOffset;
+    private readonly INDEX_WIDTH;
+    private readonly SCROLL_STEP;
+    private readonly KEYS;
+    private previousSection;
+    private nextSection;
+    private selectSection;
+    private scrollUp;
+    private scrollDown;
+    private scrollPageUp;
+    private scrollPageDown;
+    private scrollToTop;
+    private scrollToBottom;
+    private goToOptions;
+    private getContentAreaHeight;
+    onKeyInput({ name }: IKeyPress): void;
+    render(): void;
+    private drawIndex;
+    private drawContent;
+    /** Get real width, removing ANSI color codes. */
+    private getStringWidth;
+    clear(): void;
+}

package/lib/cli/ui/components/help/help.ui.js

@@ -0,0 +1,176 @@
+import pc from 'picocolors';
+import { Subject } from 'rxjs';
+import { MARGINS } from '../../../../constants/main.constants.js';
+import { BaseUi } from '../../base.ui.js';
+import { HELP_SECTIONS } from './help.constants.js';
+export class HelpUi extends BaseUi {
+    resultIndex = 0;
+    goToOptions$ = new Subject();
+    selectedSection = 0;
+    scrollOffset = 0;
+    INDEX_WIDTH = 23;
+    SCROLL_STEP = 2;
+    KEYS = {
+        up: () => this.previousSection(),
+        down: () => this.nextSection(),
+        k: () => this.scrollUp(),
+        j: () => this.scrollDown(),
+        u: () => this.scrollPageUp(),
+        d: () => this.scrollPageDown(),
+        pageup: () => this.scrollPageUp(),
+        pagedown: () => this.scrollPageDown(),
+        home: () => this.scrollToTop(),
+        end: () => this.scrollToBottom(),
+        right: () => this.goToOptions(),
+        l: () => this.goToOptions(),
+        q: () => this.goToOptions(),
+        escape: () => this.goToOptions(),
+        return: () => this.selectSection(),
+    };
+    previousSection() {
+        if (this.selectedSection > 0) {
+            this.selectedSection--;
+            this.scrollOffset = 0;
+            this.render();
+        }
+    }
+    nextSection() {
+        if (this.selectedSection < HELP_SECTIONS.length - 1) {
+            this.selectedSection++;
+            this.scrollOffset = 0;
+            this.render();
+        }
+    }
+    selectSection() {
+        this.scrollOffset = 0;
+        this.render();
+    }
+    scrollUp() {
+        if (this.scrollOffset > 0) {
+            this.scrollOffset = Math.max(0, this.scrollOffset - this.SCROLL_STEP);
+            this.render();
+        }
+    }
+    scrollDown() {
+        const currentSection = HELP_SECTIONS[this.selectedSection];
+        const contentHeight = this.getContentAreaHeight();
+        const maxScroll = Math.max(0, currentSection.content.length - contentHeight);
+        if (this.scrollOffset < maxScroll) {
+            this.scrollOffset = Math.min(maxScroll, this.scrollOffset + this.SCROLL_STEP);
+            this.render();
+        }
+    }
+    scrollPageUp() {
+        const pageSize = this.getContentAreaHeight() - 2;
+        this.scrollOffset = Math.max(0, this.scrollOffset - pageSize);
+        this.render();
+    }
+    scrollPageDown() {
+        const currentSection = HELP_SECTIONS[this.selectedSection];
+        const contentHeight = this.getContentAreaHeight();
+        const pageSize = contentHeight - 2;
+        const maxScroll = Math.max(0, currentSection.content.length - contentHeight);
+        this.scrollOffset = Math.min(maxScroll, this.scrollOffset + pageSize);
+        this.render();
+    }
+    scrollToTop() {
+        this.scrollOffset = 0;
+        this.render();
+    }
+    scrollToBottom() {
+        const currentSection = HELP_SECTIONS[this.selectedSection];
+        const contentHeight = this.getContentAreaHeight();
+        this.scrollOffset = Math.max(0, currentSection.content.length - contentHeight);
+        this.render();
+    }
+    goToOptions() {
+        this.clear();
+        this.goToOptions$.next(null);
+    }
+    getContentAreaHeight() {
+        return this.terminal.rows - MARGINS.ROW_RESULTS_START - 4;
+    }
+    onKeyInput({ name }) {
+        const action = this.KEYS[name];
+        if (action === undefined) {
+            return;
+        }
+        action();
+    }
+    render() {
+        this.clear();
+        const startRow = MARGINS.ROW_RESULTS_START;
+        const contentAreaHeight = this.getContentAreaHeight();
+        // Header hint
+        this.printAt(pc.dim('Use ') +
+            pc.green('↑/↓') +
+            pc.dim(' to change section, ') +
+            pc.green('j/k') +
+            pc.dim(' to scroll.'), { x: 2, y: startRow });
+        this.drawIndex(startRow + 2);
+        this.drawContent(startRow + 2, contentAreaHeight);
+    }
+    drawIndex(startRow) {
+        const indexHeight = this.terminal.rows - startRow - 1;
+        this.printAt(pc.gray(`╭${'─'.repeat(this.INDEX_WIDTH - 2)}╮`), {
+            x: 2,
+            y: startRow - 1,
+        });
+        for (let i = 0; i < Math.min(HELP_SECTIONS.length, indexHeight); i++) {
+            const section = HELP_SECTIONS[i];
+            const isSelected = i === this.selectedSection;
+            const padding = ' '.repeat(Math.max(0, this.INDEX_WIDTH - section.title.length - 6));
+            const line = ` ${section.icon} ${section.title}${padding}`;
+            if (isSelected) {
+                this.printAt(pc.gray('│') + pc.bgCyan(pc.black(line)) + pc.gray('│'), {
+                    x: 2,
+                    y: startRow + i,
+                });
+            }
+            else {
+                this.printAt(pc.gray('│') + pc.white(line) + pc.gray('│'), {
+                    x: 2,
+                    y: startRow + i,
+                });
+            }
+        }
+        const bottomRow = startRow + Math.min(HELP_SECTIONS.length, indexHeight);
+        this.printAt(pc.gray(`╰${'─'.repeat(this.INDEX_WIDTH - 2)}╯`), {
+            x: 2,
+            y: bottomRow,
+        });
+    }
+    drawContent(startRow, contentHeight) {
+        const currentSection = HELP_SECTIONS[this.selectedSection];
+        const contentStartX = this.INDEX_WIDTH + 2;
+        const contentWidth = Math.max(20, this.terminal.columns - contentStartX - 4);
+        this.printAt(pc.gray(`╭${'─'.repeat(contentWidth)}╮`), {
+            x: contentStartX,
+            y: startRow - 1,
+        });
+        const visibleContent = currentSection.content.slice(this.scrollOffset, this.scrollOffset + contentHeight);
+        for (let i = 0; i < contentHeight; i++) {
+            const line = visibleContent[i] || '';
+            const padding = ' '.repeat(Math.max(0, contentWidth - this.getStringWidth(line) - 1));
+            this.printAt(pc.gray('│ ') + line + padding + pc.gray('│'), {
+                x: contentStartX,
+                y: startRow + i,
+            });
+        }
+        this.printAt(pc.gray(`╰${'─'.repeat(contentWidth)}╯`), {
+            x: contentStartX,
+            y: startRow + contentHeight,
+        });
+    }
+    /** Get real width, removing ANSI color codes. */
+    getStringWidth(str) {
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI escape code stripping
+        return str.replace(/\u001b\[[0-9;]*m/g, '').length;
+    }
+    clear() {
+        for (let row = MARGINS.ROW_RESULTS_START; row < this.terminal.rows; row++) {
+            this.clearLine(row);
+        }
+    }
+}
+//# sourceMappingURL=help.ui.js.map

package/lib/cli/ui/components/help/help.ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.ui.js","sourceRoot":"","sources":["../../../../../src/cli/ui/components/help/help.ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAElE,OAAO,EAAE,MAAM,EAAsB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,MAAO,SAAQ,MAAM;IAChC,WAAW,GAAG,CAAC,CAAC;IAEP,YAAY,GAAG,IAAI,OAAO,EAAQ,CAAC;IAEpC,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAG,CAAC,CAAC;IACR,WAAW,GAAG,EAAE,CAAC;IACjB,WAAW,GAAG,CAAC,CAAC;IAEhB,IAAI,GAAG;QACtB,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE;QAChC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAC9B,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;QAC1B,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE;QAC5B,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE;QACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QACrC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QAChC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAC/B,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAC3B,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QAChC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE;KACnC,CAAC;IAEM,eAAe;QACrB,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACtE,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,CAAC,EACD,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAC9C,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,GAAG,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAC1B,SAAS,EACT,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CACrC,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,cAAc;QACpB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,aAAa,GAAG,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,CAAC,EACD,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAC9C,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,cAAc;QACpB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAC1B,CAAC,EACD,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAC9C,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,oBAAoB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,UAAU,CAAC,EAAE,IAAI,EAAa;QAC5B,MAAM,MAAM,GAA6B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,MAAM,EAAE,CAAC;IACX,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;QAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAEtD,cAAc;QACd,IAAI,CAAC,OAAO,CACV,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;YACZ,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;YACf,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;YAC9B,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;YACf,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EACvB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CACtB,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACpD,CAAC;IAEO,SAAS,CAAC,QAAgB;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;YAC7D,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,QAAQ,GAAG,CAAC;SAChB,CAAC,CAAC;QAEH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACrE,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC;YAE9C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CACxB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CACzD,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC;YAE3D,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBACpE,CAAC,EAAE,CAAC;oBACJ,CAAC,EAAE,QAAQ,GAAG,CAAC;iBAChB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBACzD,CAAC,EAAE,CAAC;oBACJ,CAAC,EAAE,QAAQ,GAAG,CAAC;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;YAC7D,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,SAAS;SACb,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,QAAgB,EAAE,aAAqB;QACzD,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,EAAE,EACF,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,aAAa,GAAG,CAAC,CAC1C,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;YACrD,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,QAAQ,GAAG,CAAC;SAChB,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CACjD,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,GAAG,aAAa,CAClC,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAErC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CACxB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC1D,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAC1D,CAAC,EAAE,aAAa;gBAChB,CAAC,EAAE,QAAQ,GAAG,CAAC;aAChB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;YACrD,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,QAAQ,GAAG,aAAa;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,iDAAiD;IACzC,cAAc,CAAC,GAAW;QAChC,kGAAkG;QAClG,OAAO,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,KAAK;QACH,KAAK,IAAI,GAAG,GAAG,OAAO,CAAC,iBAAiB,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/lib/cli/ui/components/logs.ui.d.ts

@@ -0,0 +1,24 @@
+import type { LoggerService } from '@core/services/logger.service.js';
+import { Subject } from 'rxjs';
+import type { IKeyPress } from '../../interfaces/key-press.interface.js';
+import { BaseUi, type InteractiveUi } from '../base.ui.js';
+export declare class LogsUi extends BaseUi implements InteractiveUi {
+    private readonly logger;
+    readonly close$: Subject<null>;
+    private size;
+    private errors;
+    private pages;
+    private actualPage;
+    private readonly KEYS;
+    constructor(logger: LoggerService);
+    onKeyInput({ name }: IKeyPress): void;
+    render(): void;
+    private cyclePages;
+    private close;
+    private renderPopup;
+    private printHeader;
+    private stylizeText;
+    private chunkString;
+    private chunkArray;
+    private calculatePosition;
+}

package/lib/cli/ui/components/logs.ui.js

@@ -0,0 +1,132 @@
+import pc from 'picocolors';
+import { Subject } from 'rxjs';
+import { BaseUi } from '../base.ui.js';
+export class LogsUi extends BaseUi {
+    logger;
+    close$ = new Subject();
+    size;
+    errors = 0;
+    pages = [];
+    actualPage = 0;
+    KEYS = {
+        e: () => this.cyclePages(),
+        escape: () => this.close(),
+    };
+    constructor(logger) {
+        super();
+        this.logger = logger;
+        this.setVisible(false, false);
+    }
+    onKeyInput({ name }) {
+        const action = this.KEYS[name];
+        if (action === undefined) {
+            return;
+        }
+        action();
+    }
+    render() {
+        this.renderPopup();
+    }
+    cyclePages() {
+        this.actualPage++;
+        if (this.actualPage >= this.pages.length) {
+            this.actualPage = 0;
+            this.close();
+            return;
+        }
+        this.render();
+    }
+    close() {
+        this.close$.next(null);
+    }
+    renderPopup() {
+        this.calculatePosition();
+        for (let x = this.position.x; x < this.size.x; x++) {
+            for (let y = this.position.y; y < this.size.y; y++) {
+                let char = ' ';
+                if (x === this.position.x || x === this.size.x - 1) {
+                    char = '│';
+                }
+                if (y === this.position.y) {
+                    char = '═';
+                }
+                if (y === this.size.y - 1) {
+                    char = '─';
+                }
+                if (x === this.position.x && y === this.position.y) {
+                    char = '╒';
+                }
+                if (x === this.size.x - 1 && y === this.position.y) {
+                    char = '╕';
+                }
+                if (x === this.position.x && y === this.size.y - 1) {
+                    char = '╰';
+                }
+                if (x === this.size.x - 1 && y === this.size.y - 1) {
+                    char = '╯';
+                }
+                this.printAt(pc.bgBlack(char), { x, y });
+            }
+        }
+        const width = this.size.x - this.position.x - 2;
+        const maxEntries = this.size.y - this.position.y - 2;
+        const messagesByLine = this.logger
+            .get('error')
+            .map((entry, index) => `${index}. ${entry.message}`)
+            .reduce((acc, line) => {
+            acc.push(...this.chunkString(line, width));
+            return acc;
+        }, []);
+        this.pages = this.chunkArray(messagesByLine, maxEntries);
+        this.errors = this.logger.get('error').length;
+        if (messagesByLine.length === 0) {
+            this.printAt(this.stylizeText('No errors!'), {
+                x: this.position.x + 1,
+                y: this.position.y + 1,
+            });
+        }
+        this.pages[this.actualPage].forEach((entry, index) => {
+            this.printAt(this.stylizeText(entry, 'error'), {
+                x: this.position.x + 1,
+                y: this.position.y + 1 + index,
+            });
+        });
+        this.printHeader();
+    }
+    printHeader() {
+        const titleText = ' Errors ';
+        this.printAt(this.stylizeText(titleText), {
+            x: Math.floor((this.size.x + titleText.length / 2) / 2) - this.position.x,
+            y: this.position.y,
+        });
+        const rightText = ` ${this.errors} errors | Page ${this.actualPage + 1}/${this.pages.length} `;
+        this.printAt(this.stylizeText(rightText), {
+            x: Math.floor(this.size.x + this.position.x - 4 - (rightText.length + 2)),
+            y: this.position.y,
+        });
+    }
+    stylizeText(text, style = 'normal') {
+        const styles = { normal: 'white', error: 'red' };
+        const color = styles[style];
+        return pc[color](pc.bgBlack(text));
+    }
+    chunkString(str, length) {
+        const matches = str.match(new RegExp(`.{1,${length}}`, 'g'));
+        return matches !== null ? [...matches] : [];
+    }
+    chunkArray(arr, size) {
+        return arr.length > size
+            ? [arr.slice(0, size), ...this.chunkArray(arr.slice(size), size)]
+            : [arr];
+    }
+    calculatePosition() {
+        const posX = 5;
+        const posY = 4;
+        this.setPosition({ x: posX, y: posY }, false);
+        this.size = {
+            x: this.terminal.columns - posX,
+            y: this.terminal.rows - 3,
+        };
+    }
+}
+//# sourceMappingURL=logs.ui.js.map