doc

Author: nnao45

README.md

@@ -14,20 +14,20 @@ jsq is a secure, jQuery/Lodash-style JSON processor with 110+ built-in methods,
 ## ✨ Why jsq?
 
 ```bash
-# 🚀 20x faster with parallel processing
-cat huge.jsonl | jsq --parallel '$.filter(item => item.active)'
-
 # 🔗 jQuery-style chaining with 110+ built-in methods  
 cat data.json | jsq '$.users.filter(u => u.active).pluck("name").uniq()'
 
 # 🎨 Beautiful interactive REPL with real-time evaluation
-jsq --repl --file data.json
+curl -H "Accept: application/json" https://api.example.com/data | jsq
 
 # 🔒 Secure VM isolation by default
 cat sensitive.json | jsq '$.private' # Safe: No file/network access
 
 # 📝 Intuitive variable declarations
 jsq "const names = ['Alice', 'Bob'] | names.map(n => n.toUpperCase())"
+
+# 🚀 parallel processing
+cat huge.jsonl | jsq --parallel '$.filter(item => item.active)'
 ```
 
 ## 🚀 Quick Start

src/core/repl/prompts/prompts-repl-manager.ts

@@ -44,6 +44,7 @@ import {
   DefaultPromptsProvider,
 } from '../../../utils/default-providers.js';
 import { OutputFormatter } from '../../../utils/output-formatter.js';
+import { Pager } from '../../../utils/pager.js';
 import { AutocompleteEngine } from '../autocomplete-engine.js';
 
 interface PromptsReplOptions {
@@ -589,6 +590,12 @@ export class PromptsReplManager implements ReplManagerInterface {
           }
         }
 
+        // Handle Ctrl+R for showing last result in pager
+        if (key && key.ctrl && key.name === 'r') {
+          await this.showLastResultInPager();
+          return;
+        }
+
         if (!key || key.name === 'return' || key.name === 'tab' || key.ctrl || key.meta) {
           // Clear preview line on return key
           if (key && key.name === 'return') {
@@ -1136,4 +1143,45 @@ export class PromptsReplManager implements ReplManagerInterface {
       // 保存に失敗しても続行
     }
   }
+
+  private async showLastResultInPager(): Promise<void> {
+    // 最後の評価結果がない場合は何もしない
+    if (this.lastResult === undefined) {
+      return;
+    }
+
+    // 現在の入力を保存
+    const savedLine = this.rl?.line || '';
+    const savedCursor = this.rl?.cursor || 0;
+
+    // 評価結果をフォーマット
+    const formattedResult = OutputFormatter.format(this.lastResult, {
+      isReplMode: false,
+      oneline: false,
+      noColor: false,
+    });
+
+    // 画面をクリア
+    this.console.log('\x1b[2J\x1b[H');
+
+    // Pagerで表示
+    const pager = new Pager(formattedResult);
+    await pager.show();
+
+    // REPLの画面を再描画
+    if (this.rl) {
+      // Clear screen and redraw
+      this.rl.write(null, { ctrl: true, name: 'l' });
+      this.rl.prompt();
+      // Restore the saved line
+      if (savedLine) {
+        this.rl.write(savedLine);
+        // Move cursor to the saved position
+        const moveBack = savedLine.length - savedCursor;
+        if (moveBack > 0) {
+          this.rl.write(null, { ctrl: true, name: 'b', sequence: '\x1b[D'.repeat(moveBack) });
+        }
+      }
+    }
+  }
 }

src/core/repl/repl-manager.ts

@@ -3,6 +3,7 @@ import type { JsqOptions } from '@/types/cli';
 import type { ReplIO, ReplOptions } from '@/types/repl';
 import { type DebouncedFunction, debounce } from '@/utils/debounce';
 import { OutputFormatter } from '@/utils/output-formatter';
+import { Pager } from '@/utils/pager';
 import { AutocompleteEngine, type CompletionContext } from './autocomplete-engine';
 import { StringBuffer } from './string-buffer';
 
@@ -238,6 +239,9 @@ export class ReplManager {
       case 'w':
         this.deleteWord();
         break;
+      case 'r':
+        await this.showLastResultInPager();
+        break;
     }
   }
 
@@ -967,4 +971,35 @@ export class ReplManager {
       this.io.output.write('\x1b[A');
     }
   }
+
+  private async showLastResultInPager(): Promise<void> {
+    // 最後の評価結果がない場合は何もしない
+    if (this.state.lastResult === undefined) {
+      return;
+    }
+
+    // 現在の入力を保存
+    const savedInput = this.state.currentInput.toString();
+    const savedCursorPosition = this.state.cursorPosition;
+
+    // 評価結果をフォーマット
+    const formattedResult = OutputFormatter.format(this.state.lastResult, {
+      ...this.state.options,
+      isReplMode: false,
+      oneline: false,
+    });
+
+    // 画面をクリア
+    this.io.output.write('\x1b[2J\x1b[H');
+
+    // Pagerで表示
+    const pager = new Pager(formattedResult);
+    await pager.show();
+
+    // REPLの画面を再描画
+    this.io.output.clearLine(0);
+    this.io.output.cursorTo(0);
+    this.io.output.write(this.prompt + savedInput);
+    this.io.output.cursorTo(this.prompt.length + savedCursorPosition);
+  }
 }

test-repl-pager.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# Test script for REPL pager functionality
+
+echo "Testing JSQ REPL Ctrl+R functionality..."
+echo ""
+echo "Instructions:"
+echo "1. Type an expression like: [1,2,3].map(x => x*2)"
+echo "2. Press Enter to evaluate"
+echo "3. Press Ctrl+R to view the result in pager mode"
+echo "4. Press 'q' to exit pager and return to REPL"
+echo "5. Press Ctrl+D to exit REPL"
+echo ""
+echo "Starting REPL..."
+
+# Start REPL with some initial data
+echo '{"test": [1,2,3], "nested": {"value": 42}}' | node dist/index.js