recker 1.0.15 → 1.0.17-next.9570ed5

package/dist/cli/presets.js

@@ -1,5 +1,5 @@
 import * as presets from '../presets/index.js';
-import pc from '../utils/colors.js';
+import colors from '../utils/colors.js';
 const ENV_MAPPING = {
     openai: ['OPENAI_API_KEY'],
     anthropic: ['ANTHROPIC_API_KEY'],
@@ -14,7 +14,7 @@ const ENV_MAPPING = {
 export function resolvePreset(name) {
     const presetFn = presets[name];
     if (!presetFn) {
-        console.error(pc.red(`Error: Unknown preset '@${name}'`));
+        console.error(colors.red(`Error: Unknown preset '@${name}'`));
         process.exit(1);
     }
     const requiredEnvs = ENV_MAPPING[name];
@@ -24,7 +24,7 @@ export function resolvePreset(name) {
         for (const envVar of requiredEnvs) {
             const value = process.env[envVar];
             if (!value) {
-                console.error(pc.yellow(`Warning: Missing env variable ${envVar} for preset @${name}`));
+                console.error(colors.yellow(`Warning: Missing env variable ${envVar} for preset @${name}`));
                 missing = true;
             }
             else {
@@ -33,14 +33,14 @@ export function resolvePreset(name) {
             }
         }
         if (missing) {
-            console.log(pc.gray(`Tip: export ${requiredEnvs.join('=... ')}=...`));
+            console.log(colors.gray(`Tip: export ${requiredEnvs.join('=... ')}=...`));
         }
     }
     try {
         return presetFn(options);
     }
     catch (error) {
-        console.error(pc.red(`Error initializing preset @${name}: ${error.message}`));
+        console.error(colors.red(`Error initializing preset @${name}: ${error.message}`));
         process.exit(1);
     }
 }

package/dist/cli/tui/ai-chat.js

@@ -1,16 +1,16 @@
 import readline from 'node:readline';
-import pc from '../../utils/colors.js';
+import colors from '../../utils/colors.js';
 import { createAI } from '../../ai/client.js';
 export async function startAIChat(rl, provider = 'openai', apiKey, model) {
     console.clear();
-    console.log(pc.bold(pc.magenta(`🤖 Rek AI Chat (${provider})`)));
-    console.log(pc.gray('Type your message. Ctrl+C to exit.'));
+    console.log(colors.bold(colors.magenta(`🤖 Rek AI Chat (${provider})`)));
+    console.log(colors.gray('Type your message. Ctrl+C to exit.'));
     const envKey = provider === 'openai' ? 'OPENAI_API_KEY' : 'ANTHROPIC_API_KEY';
     const key = apiKey || process.env[envKey];
     if (!key) {
-        console.log(pc.yellow(`
+        console.log(colors.yellow(`
 Warning: No API Key found for ${provider}.`));
-        console.log(`Please set it via environment variable ${pc.bold(envKey)} or passing it to the command.`);
+        console.log(`Please set it via environment variable ${colors.bold(envKey)} or passing it to the command.`);
         console.log(`Example: set ${envKey}=sk-... inside the shell.`);
         return;
     }
@@ -24,7 +24,7 @@ Warning: No API Key found for ${provider}.`));
     const history = [
         { role: 'system', content: 'You are Recker AI, a helpful and concise assistant in a terminal environment.' }
     ];
-    rl.setPrompt(pc.magenta('You › '));
+    rl.setPrompt(colors.magenta('You › '));
     rl.prompt();
     return new Promise((resolve) => {
         const onLine = async (line) => {
@@ -36,7 +36,7 @@ Warning: No API Key found for ${provider}.`));
             if (input.toLowerCase() === '/clear') {
                 history.length = 1;
                 console.clear();
-                console.log(pc.gray('Context cleared.'));
+                console.log(colors.gray('Context cleared.'));
                 rl.prompt();
                 return;
             }
@@ -47,7 +47,7 @@ Warning: No API Key found for ${provider}.`));
             }
             history.push({ role: 'user', content: input });
             rl.pause();
-            process.stdout.write(pc.cyan('AI  › '));
+            process.stdout.write(colors.cyan('AI  › '));
             let fullResponse = '';
             try {
                 const stream = await client.stream({
@@ -66,10 +66,10 @@ Warning: No API Key found for ${provider}.`));
                 history.push({ role: 'assistant', content: fullResponse });
             }
             catch (error) {
-                console.log(pc.red(`
+                console.log(colors.red(`
 Error: ${error.message}`));
                 if (error.cause)
-                    console.log(pc.gray(error.cause));
+                    console.log(colors.gray(error.cause));
             }
             finally {
                 rl.resume();

package/dist/cli/tui/load-dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/load-dashboard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,iBA4E1D"}
+{"version":3,"file":"load-dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/load-dashboard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AASrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,iBAuG1D"}

package/dist/cli/tui/load-dashboard.js

@@ -1,9 +1,12 @@
-import pc from '../../utils/colors.js';
+import colors from '../../utils/colors.js';
 import { plot } from '../../utils/chart.js';
 import readline from 'node:readline';
 import { LoadGenerator } from '../../bench/generator.js';
+import { SparklineBuffer } from '../../utils/sparkline.js';
+import { SystemMetrics } from '../../utils/system-metrics.js';
 const ALTERNATE_SCREEN_ENTER = '\x1b[?1049h';
 const ALTERNATE_SCREEN_EXIT = '\x1b[?1049l';
+const SPARKLINE_WIDTH = 40;
 export async function startLoadDashboard(config) {
     process.stdout.write(ALTERNATE_SCREEN_ENTER);
     readline.emitKeypressEvents(process.stdin);
@@ -12,6 +15,22 @@ export async function startLoadDashboard(config) {
         process.stdin.resume();
     }
     const generator = new LoadGenerator(config);
+    const sysMetrics = new SystemMetrics();
+    const cpuBuffer = new SparklineBuffer(SPARKLINE_WIDTH);
+    const memBuffer = new SparklineBuffer(SPARKLINE_WIDTH);
+    let currentCpu = 0;
+    let currentMem = { percent: 0, used: 0, total: 0 };
+    sysMetrics.onSnapshot((snap) => {
+        cpuBuffer.push(snap.cpu);
+        memBuffer.push(snap.memory);
+        currentCpu = snap.cpu;
+        currentMem = {
+            percent: snap.memory,
+            used: snap.memoryUsed,
+            total: snap.memoryTotal
+        };
+    });
+    sysMetrics.startPolling(1000);
     let abortReject;
     const abortPromise = new Promise((_, reject) => {
         abortReject = reject;
@@ -19,6 +38,7 @@ export async function startLoadDashboard(config) {
     const onKeypress = (_str, key) => {
         if (key && (key.name === 'escape' || (key.ctrl && key.name === 'c'))) {
             generator.stop();
+            sysMetrics.stopPolling();
             if (abortReject)
                 abortReject(new Error('User aborted'));
         }
@@ -43,7 +63,7 @@ export async function startLoadDashboard(config) {
         latencyHistory.push(snapshot.p95);
         usersHistory.shift();
         usersHistory.push(snapshot.activeUsers);
-        render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory, usersHistory, generator.stats);
+        render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory, usersHistory, generator.stats, cpuBuffer, memBuffer, currentCpu, currentMem);
     }, 1000);
     try {
         await Promise.race([runPromise, abortPromise]);
@@ -54,6 +74,7 @@ export async function startLoadDashboard(config) {
     }
     finally {
         clearInterval(interval);
+        sysMetrics.stopPolling();
         process.stdin.off('keypress', onKeypress);
         if (process.stdin.isTTY)
             process.stdin.setRawMode(false);
@@ -61,57 +82,131 @@ export async function startLoadDashboard(config) {
     }
     renderFinalReport(generator.stats, config);
 }
-function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory, usersHistory, stats) {
+function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory, usersHistory, stats, cpuBuffer, memBuffer, currentCpu, currentMem) {
     readline.cursorTo(process.stdout, 0, 0);
     readline.clearScreenDown(process.stdout);
-    console.log(pc.bold(pc.cyan('🔥 Rek Load Generator')));
-    console.log(pc.gray(`Target: ${config.url}`));
-    console.log(pc.gray(`Mode: ${config.mode.toUpperCase()} ${config.http2 ? '(HTTP/2)' : ''}`));
-    console.log(pc.gray('Press ESC to stop'));
+    console.log(colors.bold(colors.cyan('🔥 Rek Load Generator')));
+    console.log(colors.gray(`Target: ${config.url}`));
+    console.log(colors.gray(`Mode: ${config.mode.toUpperCase()} ${config.http2 ? '(HTTP/2)' : ''}`));
+    console.log(colors.gray('Press ESC to stop'));
+    console.log('');
+    console.log(`${colors.white('Time:')} ${colors.green(elapsed + 's')} ` +
+        `${colors.gray('/')} ${config.duration}s ` +
+        `${colors.gray('(')}${colors.yellow(remaining + 's left')}${colors.gray(')')}   ` +
+        `${colors.white('Reqs:')} ${colors.bold(String(stats.totalRequests))}`);
+    console.log(`${colors.blue('Users:')} ${colors.bold(String(snapshot.activeUsers))}   ` +
+        `${colors.green('RPS:')} ${colors.bold(snapshot.rps.toFixed(0))}   ` +
+        `${colors.magenta('Latency (P95):')} ${colors.bold(snapshot.p95.toFixed(0) + 'ms')}   ` +
+        `${colors.white('Errors:')} ${stats.failed > 0 ? colors.red(String(stats.failed)) : colors.green('0')}`);
+    console.log(colors.gray('──────────────────────────────────────────────────'));
+    console.log(colors.bold(colors.blue('👥 Active Users')));
+    console.log(colors.blue(plot(usersHistory, { height: 4 })));
     console.log('');
-    console.log(`${pc.white('Time:')} ${pc.green(elapsed + 's')} ` +
-        `${pc.gray('/')} ${config.duration}s ` +
-        `${pc.gray('(')}${pc.yellow(remaining + 's left')}${pc.gray(')')}   ` +
-        `${pc.white('Reqs:')} ${pc.bold(stats.totalRequests)}`);
-    console.log(`${pc.blue('Users:')} ${pc.bold(snapshot.activeUsers)}   ` +
-        `${pc.green('RPS:')} ${pc.bold(snapshot.rps.toFixed(0))}   ` +
-        `${pc.magenta('Latency (P95):')} ${pc.bold(snapshot.p95.toFixed(0) + 'ms')}   ` +
-        `${pc.white('Errors:')} ${stats.failed > 0 ? pc.red(stats.failed) : pc.green('0')}`);
-    console.log(pc.gray('──────────────────────────────────────────────────'));
-    console.log(pc.bold(pc.blue('👥 Active Users')));
-    console.log(pc.blue(plot(usersHistory, { height: 4 })));
+    console.log(colors.bold(colors.green('⚡ Requests per Second')));
+    console.log(colors.green(plot(rpsHistory, { height: 6 })));
     console.log('');
-    console.log(pc.bold(pc.green('⚡ Requests per Second')));
-    console.log(pc.green(plot(rpsHistory, { height: 6 })));
+    console.log(colors.bold(colors.magenta('⏱️  Latency P95 (ms)')));
+    console.log(colors.magenta(plot(latencyHistory, { height: 4 })));
     console.log('');
-    console.log(pc.bold(pc.magenta('⏱️  Latency P95 (ms)')));
-    console.log(pc.magenta(plot(latencyHistory, { height: 4 })));
+    console.log(colors.bold(colors.yellow('💻 System Resources')));
+    const cpuSparkline = cpuBuffer.render({ min: 0, max: 100 });
+    const memSparkline = memBuffer.render({ min: 0, max: 100 });
+    const memUsed = SystemMetrics.formatBytes(currentMem.used);
+    const memTotal = SystemMetrics.formatBytes(currentMem.total);
+    console.log(`  ${colors.yellow('CPU')} ${colors.gray(cpuSparkline)} ${colors.bold(currentCpu.toFixed(0) + '%')}`);
+    console.log(`  ${colors.yellow('RAM')} ${colors.gray(memSparkline)} ${colors.bold(currentMem.percent.toFixed(0) + '%')} ${colors.gray(`(${memUsed}/${memTotal})`)}`);
+    const recentErrors = stats.getRecentErrors();
+    if (recentErrors.length > 0) {
+        console.log('');
+        console.log(colors.bold(colors.red('⚠️  Recent Errors')));
+        renderErrorList(recentErrors, 5);
+    }
+}
+function formatErrorEntry(entry) {
+    const count = colors.white(`${entry.count}x`);
+    if (entry.status === 0) {
+        return `  ${count} ${colors.red('ERR')} ${colors.gray(entry.message)}`;
+    }
+    const statusColor = entry.status >= 500 ? colors.red : colors.yellow;
+    return `  ${count} ${statusColor(String(entry.status))} ${colors.gray(entry.message)}`;
+}
+function formatStatusBadge(status) {
+    const code = String(status);
+    if (status >= 500)
+        return colors.bgRed(colors.white(` ${code} `));
+    if (status >= 400)
+        return colors.bgYellow(colors.black(` ${code} `));
+    if (status >= 300)
+        return colors.bgCyan(colors.black(` ${code} `));
+    return colors.bgGreen(colors.black(` ${code} `));
+}
+function renderErrorList(errors, maxItems = 10) {
+    const toShow = errors.slice(-maxItems);
+    for (const entry of toShow) {
+        console.log(formatErrorEntry(entry));
+    }
+    if (errors.length > maxItems) {
+        console.log(colors.gray(`  ... and ${errors.length - maxItems} more`));
+    }
 }
 function renderFinalReport(stats, config) {
     const summary = stats.getSummary();
-    console.log(pc.bold(pc.green('\n✅ Load Test Complete')));
-    console.log(pc.bold('Configuration:'));
+    console.log(colors.bold(colors.green('\n✅ Load Test Complete')));
+    console.log(colors.bold('Configuration:'));
     console.log(`  URL:      ${config.url}`);
     console.log(`  Mode:     ${config.mode}`);
     console.log(`  Users:    ${config.users}`);
     console.log(`  Duration: ${config.duration}s`);
-    console.log('\n' + pc.bold('Traffic:'));
+    console.log('\n' + colors.bold('Traffic:'));
     console.log(`  Total Requests:  ${summary.total}`);
-    console.log(`  Successful:      ${pc.green(summary.success)}`);
-    console.log(`  Failed:          ${summary.failed > 0 ? pc.red(summary.failed) : pc.gray(0)}`);
+    console.log(`  Successful:      ${colors.green(String(summary.success))}`);
+    console.log(`  Failed:          ${summary.failed > 0 ? colors.red(String(summary.failed)) : colors.gray('0')}`);
     console.log(`  Total Bytes:     ${(summary.bytes / 1024 / 1024).toFixed(2)} MB`);
-    console.log('\n' + pc.bold('Latency (ms):'));
+    console.log('\n' + colors.bold('Latency (ms):'));
     console.log(`  Avg: ${summary.latency.avg.toFixed(2)}`);
     console.log(`  P50: ${summary.latency.p50.toFixed(0)}`);
     console.log(`  P95: ${summary.latency.p95.toFixed(0)}`);
     console.log(`  P99: ${summary.latency.p99.toFixed(0)}`);
     console.log(`  Max: ${summary.latency.max.toFixed(0)}`);
     if (Object.keys(summary.codes).length > 0) {
-        console.log('\n' + pc.bold('Status Codes:'));
-        Object.entries(summary.codes).forEach(([code, count]) => {
-            const color = code.startsWith('2') ? pc.green : code.startsWith('5') ? pc.red : pc.yellow;
-            console.log(`  ${color(code)}: ${count}`);
+        console.log('\n' + colors.bold('Status Codes:'));
+        const codeEntries = Object.entries(summary.codes)
+            .sort(([a], [b]) => Number(a) - Number(b))
+            .map(([code, count]) => {
+            const c = Number(code);
+            const color = c >= 500 ? colors.red : c >= 400 ? colors.yellow : colors.green;
+            return `${color(code)}: ${count}`;
         });
+        console.log(`  ${codeEntries.join('  ')}`);
+    }
+    const allErrors = stats.getErrors();
+    if (allErrors.length > 0) {
+        console.log('\n' + colors.bold(colors.red('Errors:')));
+        const httpErrors = allErrors.filter(e => e.status > 0);
+        const netErrors = allErrors.filter(e => e.status === 0);
+        if (httpErrors.length > 0) {
+            const httpLine = httpErrors
+                .slice(0, 5)
+                .map(e => {
+                const color = e.status >= 500 ? colors.red : colors.yellow;
+                return `${e.count}x ${color(String(e.status))} ${colors.gray(e.message)}`;
+            })
+                .join(colors.gray(', '));
+            console.log(`  ${httpLine}`);
+            if (httpErrors.length > 5) {
+                console.log(colors.gray(`  ... +${httpErrors.length - 5} more HTTP errors`));
+            }
+        }
+        if (netErrors.length > 0) {
+            const netLine = netErrors
+                .slice(0, 5)
+                .map(e => `${e.count}x ${colors.red('ERR')} ${colors.gray(e.message)}`)
+                .join(colors.gray(', '));
+            console.log(`  ${netLine}`);
+            if (netErrors.length > 5) {
+                console.log(colors.gray(`  ... +${netErrors.length - 5} more network errors`));
+            }
+        }
     }
     console.log('');
 }

package/dist/cli/tui/scroll-buffer.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter } from 'node:events';
+export interface ScrollBufferOptions {
+    maxLines?: number;
+    viewportHeight?: number;
+}
+export declare class ScrollBuffer extends EventEmitter {
+    private lines;
+    private scrollOffset;
+    private maxLines;
+    private viewportHeight;
+    private isScrollMode;
+    private originalWrite;
+    private pendingOutput;
+    constructor(options?: ScrollBufferOptions);
+    write(content: string): void;
+    flush(): void;
+    get lineCount(): number;
+    get position(): number;
+    get isScrolledUp(): boolean;
+    scrollUp(lines?: number): boolean;
+    scrollDown(lines?: number): boolean;
+    pageUp(): boolean;
+    pageDown(): boolean;
+    scrollToTop(): void;
+    scrollToBottom(): void;
+    getVisibleLines(): string[];
+    render(): string;
+    updateViewport(height?: number): void;
+    enterScrollMode(): void;
+    exitScrollMode(): void;
+    get inScrollMode(): boolean;
+    clear(): void;
+    getScrollInfo(): {
+        current: number;
+        total: number;
+        percent: number;
+    };
+}
+export declare function parseScrollKey(data: Buffer): 'pageUp' | 'pageDown' | 'scrollUp' | 'scrollDown' | 'home' | 'end' | 'quit' | null;
+export declare function parseMouseScroll(data: Buffer): 'scrollUp' | 'scrollDown' | null;
+export declare function enableMouseReporting(): void;
+export declare function disableMouseReporting(): void;
+//# sourceMappingURL=scroll-buffer.d.ts.map

package/dist/cli/tui/scroll-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-buffer.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/scroll-buffer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,aAAa,CAAc;gBAEvB,OAAO,GAAE,mBAAwB;IAS7C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAuB5B,KAAK,IAAI,IAAI;IAUb,IAAI,SAAS,IAAI,MAAM,CAEtB;IAKD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAKD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAKD,QAAQ,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO;IAcpC,UAAU,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO;IAatC,MAAM,IAAI,OAAO;IAOjB,QAAQ,IAAI,OAAO;IAOnB,WAAW,IAAI,IAAI;IAOnB,cAAc,IAAI,IAAI;IAOtB,eAAe,IAAI,MAAM,EAAE;IAS3B,MAAM,IAAI,MAAM;IAsBhB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOrC,eAAe,IAAI,IAAI;IAcvB,cAAc,IAAI,IAAI;IAWtB,IAAI,YAAY,IAAI,OAAO,CAE1B;IAKD,KAAK,IAAI,IAAI;IASb,aAAa,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAOrE;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAyB/H;AAOD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI,CAqB/E;AAKD,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAKD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/cli/tui/scroll-buffer.js

@@ -0,0 +1,162 @@
+import { EventEmitter } from 'node:events';
+export class ScrollBuffer extends EventEmitter {
+    lines = [];
+    scrollOffset = 0;
+    maxLines;
+    viewportHeight;
+    isScrollMode = false;
+    originalWrite = null;
+    pendingOutput = '';
+    constructor(options = {}) {
+        super();
+        this.maxLines = options.maxLines || 10000;
+        this.viewportHeight = options.viewportHeight || (process.stdout.rows || 24) - 2;
+    }
+    write(content) {
+        const parts = (this.pendingOutput + content).split('\n');
+        this.pendingOutput = parts.pop() || '';
+        for (const part of parts) {
+            this.lines.push(part);
+        }
+        if (this.lines.length > this.maxLines) {
+            this.lines = this.lines.slice(-this.maxLines);
+        }
+        if (this.scrollOffset === 0 && !this.isScrollMode) {
+            this.emit('output', content);
+        }
+    }
+    flush() {
+        if (this.pendingOutput) {
+            this.lines.push(this.pendingOutput);
+            this.pendingOutput = '';
+        }
+    }
+    get lineCount() {
+        return this.lines.length;
+    }
+    get position() {
+        return this.scrollOffset;
+    }
+    get isScrolledUp() {
+        return this.scrollOffset > 0;
+    }
+    scrollUp(lines = 1) {
+        const maxScroll = Math.max(0, this.lines.length - this.viewportHeight);
+        const newOffset = Math.min(this.scrollOffset + lines, maxScroll);
+        if (newOffset !== this.scrollOffset) {
+            this.scrollOffset = newOffset;
+            return true;
+        }
+        return false;
+    }
+    scrollDown(lines = 1) {
+        const newOffset = Math.max(0, this.scrollOffset - lines);
+        if (newOffset !== this.scrollOffset) {
+            this.scrollOffset = newOffset;
+            return true;
+        }
+        return false;
+    }
+    pageUp() {
+        return this.scrollUp(this.viewportHeight - 1);
+    }
+    pageDown() {
+        return this.scrollDown(this.viewportHeight - 1);
+    }
+    scrollToTop() {
+        this.scrollOffset = Math.max(0, this.lines.length - this.viewportHeight);
+    }
+    scrollToBottom() {
+        this.scrollOffset = 0;
+    }
+    getVisibleLines() {
+        const endIndex = this.lines.length - this.scrollOffset;
+        const startIndex = Math.max(0, endIndex - this.viewportHeight);
+        return this.lines.slice(startIndex, endIndex);
+    }
+    render() {
+        const visibleLines = this.getVisibleLines();
+        let output = '';
+        output += '\x1b[2J\x1b[H';
+        output += visibleLines.join('\n');
+        if (this.scrollOffset > 0) {
+            const indicator = `\x1b[7m ↑ ${this.scrollOffset} lines above | Page Down to scroll ↓ \x1b[0m`;
+            output += `\n${indicator}`;
+        }
+        return output;
+    }
+    updateViewport(height) {
+        this.viewportHeight = height || (process.stdout.rows || 24) - 2;
+    }
+    enterScrollMode() {
+        if (this.isScrollMode)
+            return;
+        this.isScrollMode = true;
+        this.flush();
+        this.emit('scrollModeStart');
+    }
+    exitScrollMode() {
+        if (!this.isScrollMode)
+            return;
+        this.isScrollMode = false;
+        this.scrollToBottom();
+        this.emit('scrollModeEnd');
+    }
+    get inScrollMode() {
+        return this.isScrollMode;
+    }
+    clear() {
+        this.lines = [];
+        this.scrollOffset = 0;
+        this.pendingOutput = '';
+    }
+    getScrollInfo() {
+        const total = this.lines.length;
+        const current = total - this.scrollOffset;
+        const percent = total > 0 ? Math.round((current / total) * 100) : 100;
+        return { current, total, percent };
+    }
+}
+export function parseScrollKey(data) {
+    const str = data.toString();
+    if (str === '\x1b[5~' || str === '\x1bOy')
+        return 'pageUp';
+    if (str === '\x1b[6~' || str === '\x1bOs')
+        return 'pageDown';
+    if (str === '\x1b[1;2A')
+        return 'scrollUp';
+    if (str === '\x1b[1;2B')
+        return 'scrollDown';
+    if (str === '\x1b[H' || str === '\x1b[1~' || str === '\x1bOH')
+        return 'home';
+    if (str === '\x1b[F' || str === '\x1b[4~' || str === '\x1bOF')
+        return 'end';
+    if (str === 'q' || str === 'Q')
+        return 'quit';
+    return null;
+}
+export function parseMouseScroll(data) {
+    const str = data.toString();
+    const sgrMatch = str.match(/\x1b\[<(\d+);(\d+);(\d+)[Mm]/);
+    if (sgrMatch) {
+        const button = parseInt(sgrMatch[1], 10);
+        if (button === 64)
+            return 'scrollUp';
+        if (button === 65)
+            return 'scrollDown';
+    }
+    if (data.length >= 6 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x4d) {
+        const button = data[3];
+        if (button === 96 || button === 0x60)
+            return 'scrollUp';
+        if (button === 97 || button === 0x61)
+            return 'scrollDown';
+    }
+    return null;
+}
+export function enableMouseReporting() {
+    process.stdout.write('\x1b[?1000h\x1b[?1006h');
+}
+export function disableMouseReporting() {
+    process.stdout.write('\x1b[?1000l\x1b[?1006l');
+}

package/dist/cli/tui/search-panel.d.ts

@@ -0,0 +1,41 @@
+interface SearchPanelOptions {
+    initialQuery?: string;
+    docsPath?: string;
+}
+export declare class SearchPanel {
+    private rl;
+    private state;
+    private docsPath;
+    private running;
+    private termWidth;
+    private termHeight;
+    private leftPanelWidth;
+    private rightPanelWidth;
+    private contentHeight;
+    private previewContent;
+    constructor(options?: SearchPanelOptions);
+    private findDocsPath;
+    open(): Promise<void>;
+    close(): void;
+    private updateDimensions;
+    private handleKeyInput;
+    private navigateUp;
+    private navigateDown;
+    private scrollPreview;
+    private performSearch;
+    private loadPreview;
+    private formatMarkdown;
+    private wordWrap;
+    private stripAnsi;
+    private render;
+    private renderHeader;
+    private renderSearchInput;
+    private renderDivider;
+    private renderContent;
+    private renderLeftPanelLine;
+    private renderRightPanelLine;
+    private renderFooter;
+}
+export declare function openSearchPanel(query?: string): Promise<void>;
+export {};
+//# sourceMappingURL=search-panel.d.ts.map

package/dist/cli/tui/search-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-panel.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/search-panel.ts"],"names":[],"mappings":"AAyCA,UAAU,kBAAkB;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAgB;gBAE1B,OAAO,GAAE,kBAAuB;IAa5C,OAAO,CAAC,YAAY;IAed,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD3B,KAAK,IAAI,IAAI;IAsBb,OAAO,CAAC,gBAAgB;YAYV,cAAc;IA8C5B,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;YAKP,aAAa;IAgC3B,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IA2Bd,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,YAAY;CA0BrB;AAKD,wBAAsB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE"}