recker 1.0.15-next.3794a15 → 1.0.15-next.c7370be

package/dist/bench/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bench/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IACpB,KAAK,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,UAAU;IAKxB,KAAK;IA4FX,IAAI;CAGL"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bench/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IACpB,KAAK,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,UAAU;IAKxB,KAAK;IAgGX,IAAI;CAGL"}

package/dist/bench/generator.js

@@ -22,7 +22,7 @@ export class LoadGenerator {
                 agent: {
                     connections: this.config.users,
                     pipelining: this.config.mode === 'throughput' ? 2 : 1,
-                    keepAlive: false
+                    keepAlive: true
                 }
             },
             retry: {
@@ -41,6 +41,7 @@ export class LoadGenerator {
                         await new Promise(r => setTimeout(r, 50 + Math.random() * 450));
                     }
                     const res = await client.get(path, { signal: controller.signal });
+                    await res.text();
                     const duration = performance.now() - start;
                     const bytes = Number(res.headers.get('content-length') || 0);
                     this.stats.addResult(duration, res.status, bytes);

package/dist/bench/stats.d.ts

@@ -1,15 +1,29 @@
+export interface ErrorEntry {
+    status: number;
+    message: string;
+    count: number;
+    lastSeen: number;
+}
 export declare class LoadStats {
     totalRequests: number;
     successful: number;
     failed: number;
     bytesTransferred: number;
     statusCodes: Record<number, number>;
-    errors: Record<string, number>;
+    private errorMap;
+    private recentErrors;
+    private readonly maxRecentErrors;
     latencies: number[];
     private lastSnapshotTime;
     private lastSnapshotRequests;
     activeUsers: number;
     addResult(durationMs: number, status: number, bytes: number, error?: Error): void;
+    private trackError;
+    private formatErrorMessage;
+    private getStatusText;
+    getErrors(): ErrorEntry[];
+    getRecentErrors(): ErrorEntry[];
+    get errors(): Record<string, number>;
     getSnapshot(): {
         rps: number;
         p95: number;

package/dist/bench/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/bench/stats.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS;IACpB,aAAa,SAAK;IAClB,UAAU,SAAK;IACf,MAAM,SAAK;IACX,gBAAgB,SAAK;IAErB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAGpC,SAAS,EAAE,MAAM,EAAE,CAAM;IAGzB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,oBAAoB,CAAK;IAGjC,WAAW,SAAK;IAEhB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAoB1E,WAAW;;;;;IAmBX,UAAU;;;;;;;;;;;;;;;;CAmBX"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/bench/stats.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACpB,aAAa,SAAK;IAClB,UAAU,SAAK;IACf,MAAM,SAAK;IACX,gBAAgB,SAAK;IAErB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAKzC,OAAO,CAAC,QAAQ,CAAiC;IAKjD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAM;IAGtC,SAAS,EAAE,MAAM,EAAE,CAAM;IAGzB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,oBAAoB,CAAK;IAGjC,WAAW,SAAK;IAEhB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAoB1E,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,aAAa;IAoBrB,SAAS,IAAI,UAAU,EAAE;IAQzB,eAAe,IAAI,UAAU,EAAE;IAO/B,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnC;IAED,WAAW;;;;;IAmBX,UAAU;;;;;;;;;;;;;;;;CAmBX"}

package/dist/bench/stats.js

@@ -4,7 +4,9 @@ export class LoadStats {
     failed = 0;
     bytesTransferred = 0;
     statusCodes = {};
-    errors = {};
+    errorMap = new Map();
+    recentErrors = [];
+    maxRecentErrors = 10;
     latencies = [];
     lastSnapshotTime = Date.now();
     lastSnapshotRequests = 0;
@@ -15,10 +17,7 @@ export class LoadStats {
         this.latencies.push(durationMs);
         if (error || status >= 400) {
             this.failed++;
-            if (error) {
-                const msg = error.message || 'Unknown Error';
-                this.errors[msg] = (this.errors[msg] || 0) + 1;
-            }
+            this.trackError(status, error);
         }
         else {
             this.successful++;
@@ -27,6 +26,86 @@ export class LoadStats {
             this.statusCodes[status] = (this.statusCodes[status] || 0) + 1;
         }
     }
+    trackError(status, error) {
+        const message = this.formatErrorMessage(status, error);
+        const key = `${status}:${message}`;
+        const now = Date.now();
+        const existing = this.errorMap.get(key);
+        if (existing) {
+            existing.count++;
+            existing.lastSeen = now;
+        }
+        else {
+            const entry = { status, message, count: 1, lastSeen: now };
+            this.errorMap.set(key, entry);
+            this.recentErrors.push(entry);
+            if (this.recentErrors.length > this.maxRecentErrors) {
+                this.recentErrors.shift();
+            }
+        }
+    }
+    formatErrorMessage(status, error) {
+        if (error) {
+            let msg = error.message || 'Unknown Error';
+            if (msg.includes('ECONNREFUSED'))
+                return 'Connection refused';
+            if (msg.includes('ECONNRESET'))
+                return 'Connection reset';
+            if (msg.includes('ETIMEDOUT'))
+                return 'Connection timeout';
+            if (msg.includes('ENOTFOUND'))
+                return 'DNS lookup failed';
+            if (msg.includes('UND_ERR_SOCKET'))
+                return 'Socket error';
+            if (msg.includes('UND_ERR_HEADERS_TIMEOUT'))
+                return 'Headers timeout';
+            if (msg.includes('UND_ERR_BODY_TIMEOUT'))
+                return 'Body timeout';
+            if (msg.includes('UND_ERR_CONNECT_TIMEOUT'))
+                return 'Connect timeout';
+            if (msg.includes('AbortError') || msg.includes('aborted'))
+                return 'Request aborted';
+            if (msg.length > 50) {
+                msg = msg.substring(0, 47) + '...';
+            }
+            return msg;
+        }
+        if (status >= 400) {
+            return this.getStatusText(status);
+        }
+        return 'Unknown Error';
+    }
+    getStatusText(status) {
+        const texts = {
+            400: 'Bad Request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not Found',
+            405: 'Method Not Allowed',
+            408: 'Request Timeout',
+            429: 'Too Many Requests',
+            500: 'Internal Server Error',
+            502: 'Bad Gateway',
+            503: 'Service Unavailable',
+            504: 'Gateway Timeout',
+        };
+        return texts[status] || `HTTP ${status}`;
+    }
+    getErrors() {
+        return Array.from(this.errorMap.values())
+            .sort((a, b) => b.count - a.count);
+    }
+    getRecentErrors() {
+        return [...this.recentErrors];
+    }
+    get errors() {
+        const result = {};
+        for (const entry of this.errorMap.values()) {
+            const key = entry.status > 0 ? `[${entry.status}] ${entry.message}` : entry.message;
+            result[key] = entry.count;
+        }
+        return result;
+    }
     getSnapshot() {
         const now = Date.now();
         const timeDiff = (now - this.lastSnapshotTime) / 1000;

package/dist/cli/index.js

@@ -270,6 +270,27 @@ complete -F _rek_completions rek
         const shell = new RekShell();
         shell.start();
     });
+    program
+        .command('docs [query...]')
+        .alias('?')
+        .description('Search Recker documentation (opens fullscreen panel)')
+        .action(async (queryParts) => {
+        const query = queryParts.join(' ').trim();
+        const { openSearchPanel } = await import('./tui/search-panel.js');
+        await openSearchPanel(query || undefined);
+    });
+    const dns = program.command('dns').description('DNS tools and diagnostics');
+    dns
+        .command('propagate')
+        .description('Check global DNS propagation across multiple providers')
+        .argument('<domain>', 'Domain name to check')
+        .argument('[type]', 'Record type (A, AAAA, CNAME, MX, NS, TXT)', 'A')
+        .action(async (domain, type) => {
+        const { checkPropagation, formatPropagationReport } = await import('../dns/propagation.js');
+        console.log(pc.gray(`Checking propagation for ${domain} (${type})...`));
+        const results = await checkPropagation(domain, type);
+        console.log(formatPropagationReport(results, domain, type));
+    });
     const bench = program.command('bench').description('Performance benchmarking tools');
     bench
         .command('load')

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;AAMrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,iBA4E1D"}

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

@@ -72,11 +72,11 @@ function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory
     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.white('Reqs:')} ${pc.bold(String(stats.totalRequests))}`);
+    console.log(`${pc.blue('Users:')} ${pc.bold(String(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')}`);
+        `${pc.white('Errors:')} ${stats.failed > 0 ? pc.red(String(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 })));
@@ -86,6 +86,39 @@ function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory
     console.log('');
     console.log(pc.bold(pc.magenta('⏱️  Latency P95 (ms)')));
     console.log(pc.magenta(plot(latencyHistory, { height: 4 })));
+    const recentErrors = stats.getRecentErrors();
+    if (recentErrors.length > 0) {
+        console.log('');
+        console.log(pc.bold(pc.red('⚠️  Recent Errors')));
+        renderErrorList(recentErrors, 5);
+    }
+}
+function formatErrorEntry(entry) {
+    const count = pc.gray(`${entry.count}x`);
+    if (entry.status === 0) {
+        return `  ${count} ${pc.red('NET')} ${entry.message}`;
+    }
+    const statusBadge = formatStatusBadge(entry.status);
+    return `  ${count} ${statusBadge} ${entry.message}`;
+}
+function formatStatusBadge(status) {
+    const code = String(status);
+    if (status >= 500)
+        return pc.bgRed(pc.white(` ${code} `));
+    if (status >= 400)
+        return pc.bgYellow(pc.black(` ${code} `));
+    if (status >= 300)
+        return pc.bgCyan(pc.black(` ${code} `));
+    return pc.bgGreen(pc.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(pc.gray(`  ... and ${errors.length - maxItems} more`));
+    }
 }
 function renderFinalReport(stats, config) {
     const summary = stats.getSummary();
@@ -97,8 +130,8 @@ function renderFinalReport(stats, config) {
     console.log(`  Duration: ${config.duration}s`);
     console.log('\n' + pc.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:      ${pc.green(String(summary.success))}`);
+    console.log(`  Failed:          ${summary.failed > 0 ? pc.red(String(summary.failed)) : pc.gray('0')}`);
     console.log(`  Total Bytes:     ${(summary.bytes / 1024 / 1024).toFixed(2)} MB`);
     console.log('\n' + pc.bold('Latency (ms):'));
     console.log(`  Avg: ${summary.latency.avg.toFixed(2)}`);
@@ -108,10 +141,31 @@ function renderFinalReport(stats, config) {
     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}`);
+        Object.entries(summary.codes)
+            .sort(([a], [b]) => Number(a) - Number(b))
+            .forEach(([code, count]) => {
+            const badge = formatStatusBadge(Number(code));
+            console.log(`  ${badge} ${count}`);
         });
     }
+    const allErrors = stats.getErrors();
+    if (allErrors.length > 0) {
+        console.log('\n' + pc.bold(pc.red('Errors:')));
+        renderErrorList(allErrors, 15);
+        const networkErrors = allErrors.filter(e => e.status === 0);
+        const httpErrors = allErrors.filter(e => e.status > 0);
+        if (networkErrors.length > 0 || httpErrors.length > 0) {
+            console.log('');
+            console.log(pc.gray('  Summary:'));
+            if (networkErrors.length > 0) {
+                const total = networkErrors.reduce((sum, e) => sum + e.count, 0);
+                console.log(pc.gray(`    Network errors: ${total} (${networkErrors.length} types)`));
+            }
+            if (httpErrors.length > 0) {
+                const total = httpErrors.reduce((sum, e) => sum + e.count, 0);
+                console.log(pc.gray(`    HTTP errors: ${total} (${httpErrors.length} types)`));
+            }
+        }
+    }
     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' | 'escape' | 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,QAAQ,GAAG,IAAI,CAyBjI;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 === '\x1b' || str === '\x1b\x1b')
+        return 'escape';
+    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;IA0Bd,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"}