cliedit 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 CodeTease
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 CodeTease
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,88 +1,92 @@
-# cliedit
-
-A lightweight, zero-dependency (other than `keypress`), raw-mode terminal editor component for Node.js.
-
-`cliedit` is designed to be imported into your own CLI application to provide a full-featured, TTY-based text editing experience. It's perfect for applications that need to ask the user for multi-line input, edit configuration files, or write commit messages.
-
-It includes line wrapping, visual navigation, undo/redo, text selection, and clipboard support.
-
-## Features
-
-- **Raw Mode TTY:** Takes over the terminal for a full "app-like" feel.
-- **Visual Line Wrapping:** Text wraps to fit the terminal width.
-- **Visual Navigation:** `Up`/`Down` arrows move by visual rows, not logical lines.
-- **Undo/Redo:** `Ctrl+Z` / `Ctrl+Y` for persistent history.
-- **Text Selection:** `Ctrl+Arrow` keys to select text.
-- **Clipboard Support:** `Ctrl+C` (Copy), `Ctrl+X` (Cut), `Ctrl+V` (Paste) for system clipboard (macOS/Windows).
-- **File I/O:** Loads from and saves to the filesystem.
-- **Search:** `Ctrl+W` to find text.
-
-## Installation
-```bash
-npm install cliedit
-```
-
-## Usage
-
-The package exports an `async` function `openEditor` that returns a `Promise`. The promise resolves when the user quits the editor.
-```javascript
-import { openEditor } from 'cliedit';
-import path from 'path';
-
-async function getCommitMessage() {
-  const tempFile = path.resolve(process.cwd(), 'COMMIT_MSG.txt');
-  console.log('Opening editor for commit message...');
-
-  try {
-    const result = await openEditor(tempFile);
-
-    // Give the terminal a moment to restore
-    await new Promise(res => setTimeout(res, 50));
-
-    if (result.saved) {
-      console.log('Message saved!');
-      console.log('---------------------');
-      console.log(result.content);
-      console.log('---------------------');
-    } else {
-      console.log('Editor quit without saving.');
-    }
-  } catch (err) {
-    console.error('Editor failed to start:', err);
-  }
-}
-
-getCommitMessage();
-```
-
-## Public API
-
-`openEditor(filepath: string)`
-
-Opens the editor for the specified file. If the file doesn't exist, it will be created upon saving.
-- **Returns:** `Promise<{ saved: boolean; content: string }>`
-    * `saved`: `true` if the user saved (Ctrl+S), `false` otherwise (Ctrl+Q).
-    * `content`: The final content of the file as a string.
-
-`CliEditor`
-
-The main editor class. You can import this directly if you need to extend or instantiate the editor with custom logic.
-```javascript
-import { CliEditor } from 'cliedit';
-```
-
-### Types
-
-Key types are also exported for convenience:
-```javascript
-import type {
-  DocumentState,
-  VisualRow,
-  EditorMode,
-  NormalizedRange,
-} from 'cliedit';
-```
-
-## License
-
+# cliedit
+
+A lightweight, zero-dependency, raw-mode terminal editor component for Node.js.
+
+`cliedit` is designed to be imported into your own CLI application to provide a full-featured, TTY-based text editing experience. It's perfect for applications that need to ask the user for multi-line input, edit configuration files, or write commit messages.
+
+It includes line wrapping, visual navigation, undo/redo, text selection, and clipboard support.
+
+## Features
+
+- **Raw Mode TTY:** Takes over the terminal for a full "app-like" feel.
+- **Visual Line Wrapping:** Text wraps to fit the terminal width.
+- **Visual Navigation:** `Up`/`Down` arrows move by visual rows, not logical lines.
+- **Undo/Redo:** `Ctrl+Z` / `Ctrl+Y` for persistent history.
+- **Text Selection:** `Ctrl+Arrow` keys to select text.
+- **Clipboard Support:** `Ctrl+C` (Copy), `Ctrl+X` (Cut), `Ctrl+V` (Paste) for system clipboard (macOS/Windows).
+- **File I/O:** Loads from and saves to the filesystem.
+- **Search:** `Ctrl+W` to find text.
+
+## Installation
+```bash
+npm install cliedit
+```
+
+## Usage
+
+The package exports an `async` function `openEditor` that returns a `Promise`. The promise resolves when the user quits the editor.
+```javascript
+import { openEditor } from 'cliedit';
+import path from 'path';
+
+async function getCommitMessage() {
+  const tempFile = path.resolve(process.cwd(), 'COMMIT_MSG.txt');
+  console.log('Opening editor for commit message...');
+
+  try {
+    const result = await openEditor(tempFile);
+
+    // Give the terminal a moment to restore
+    await new Promise(res => setTimeout(res, 50));
+
+    if (result.saved) {
+      console.log('Message saved!');
+      console.log('---------------------');
+      console.log(result.content);
+      console.log('---------------------');
+    } else {
+      console.log('Editor quit without saving.');
+    }
+  } catch (err) {
+    console.error('Editor failed to start:', err);
+  }
+}
+
+getCommitMessage();
+```
+
+## Public API
+
+`openEditor(filepath: string)`
+
+Opens the editor for the specified file. If the file doesn't exist, it will be created upon saving.
+- **Returns:** `Promise<{ saved: boolean; content: string }>`
+    * `saved`: `true` if the user saved (Ctrl+S), `false` otherwise (Ctrl+Q).
+    * `content`: The final content of the file as a string.
+
+`CliEditor`
+
+The main editor class. You can import this directly if you need to extend or instantiate the editor with custom logic.
+```javascript
+import { CliEditor } from 'cliedit';
+```
+
+### Types
+
+Key types are also exported for convenience:
+```javascript
+import type {
+  DocumentState,
+  VisualRow,
+  EditorMode,
+  NormalizedRange,
+} from 'cliedit';
+```
+
+## Acknowledgements
+
+Please see the [ACKNOWLEDGEMENTS.md](ACKNOWLEDGEMENTS.md) file for important copyright information regarding the vendored `keypress` component.
+
+## License
+
 [MIT](LICENSE)

package/dist/editor.d.ts

@@ -1,14 +1,5 @@
 import { HistoryManager } from './history.js';
 import { VisualRow, EditorMode } from './types.js';
-declare module 'keypress' {
-    interface KeypressEvent {
-        name?: string;
-        ctrl: boolean;
-        meta: boolean;
-        shift: boolean;
-        sequence: string;
-    }
-}
 import { editingMethods } from './editor.editing.js';
 import { clipboardMethods } from './editor.clipboard.js';
 import { navigationMethods } from './editor.navigation.js';

package/dist/editor.js

@@ -1,6 +1,8 @@
-import keypress from 'keypress';
+// Cập nhật 1: Import từ ./vendor/keypress.js
+import keypress from './vendor/keypress.js';
 import { ANSI } from './constants.js';
 import { HistoryManager } from './history.js';
+// Block `declare module 'keypress'` đã bị xóa
 // Import all functional modules
 import { editingMethods } from './editor.editing.js';
 import { clipboardMethods } from './editor.clipboard.js';

package/dist/editor.keys.d.ts

@@ -1,13 +1,4 @@
-import type { KeypressEvent } from 'keypress';
-declare module 'keypress' {
-    interface KeypressEvent {
-        name?: string;
-        ctrl: boolean;
-        meta: boolean;
-        shift: boolean;
-        sequence: string;
-    }
-}
+import type { KeypressEvent } from './vendor/keypress.js';
 export type TKeyHandlingMethods = {
     handleKeypressEvent: (ch: string, key: KeypressEvent) => void;
     handleEditKeys: (key: string) => boolean;

package/dist/editor.keys.js

@@ -8,19 +8,23 @@ function handleKeypressEvent(ch, key) {
     if (this.isExiting) {
         return;
     }
-    // CRASH FIX: Handle case where 'key' is undefined (a normal character key)
+    let keyName = undefined;
+    let edited = false;
+    // --- 1. Xử lý trường hợp key là null/undefined (Ký tự in được) ---
     if (!key) {
-        if (ch && ch >= ' ' && ch <= '~') {
-            this.handleCharacterKey(ch);
-            this.recalculateVisualRows();
+        if (ch && ch.length === 1 && ch >= ' ' && ch <= '~') {
+            edited = this.handleEditKeys(ch);
+            if (edited) {
+                this.saveState();
+                this.recalculateVisualRows(); // Phải tính toán lại sau khi gõ
+            }
             this.render();
+            return;
         }
         return;
     }
-    // --- From here, 'key' object is guaranteed to exist ---
-    let keyName = undefined;
-    let edited = false;
-    // 1. Map Control sequences (Ctrl+Arrow for selection)
+    // --- 2. Từ đây, 'key' object là đảm bảo có (phím đặc biệt hoặc Ctrl/Meta) ---
+    // 2.1. Ánh xạ Control sequences (Ctrl+Arrow cho selection)
     if (key.ctrl) {
         if (key.name === 'up')
             keyName = KEYS.CTRL_ARROW_UP;
@@ -31,10 +35,10 @@ function handleKeypressEvent(ch, key) {
         else if (key.name === 'right')
             keyName = KEYS.CTRL_ARROW_RIGHT;
         else
-            keyName = key.sequence; // Use sequence for Ctrl+S, Ctrl+C, etc.
+            keyName = key.sequence;
     }
     else {
-        // 2. (FIXED) Map standard navigation keys (Arrow, Home, End)
+        // 2.2. Ánh xạ phím tiêu chuẩn (Arrow, Home, End, Enter, Tab)
         if (key.name === 'up')
             keyName = KEYS.ARROW_UP;
         else if (key.name === 'down')
@@ -60,55 +64,41 @@ function handleKeypressEvent(ch, key) {
         else if (key.name === 'tab')
             keyName = KEYS.TAB;
         else
-            keyName = key.sequence; // Fallback
+            keyName = key.sequence;
     }
-    // 3. (FIXED) Handle printable characters immediately
-    // This was the source of the "no typing" bug.
-    // We must check for characters *before* routing to handleEditKeys.
-    if (keyName && keyName.length === 1 && keyName >= ' ' && keyName <= '~' && !key.ctrl && !key.meta) {
-        this.handleCharacterKey(keyName);
-        this.recalculateVisualRows();
-        this.render();
-        return;
-    }
-    // 4. Mode Routing (If it's not a character, it's a command)
+    // --- 3. Định tuyến theo Mode ---
     if (this.mode === 'search') {
         this.handleSearchKeys(keyName || ch);
     }
     else {
-        // 5. Handle Selection Keys (Ctrl+Arrow)
+        // 4. Xử lý phím lựa chọn (Ctrl+Arrow) - Navigation
         switch (keyName) {
             case KEYS.CTRL_ARROW_UP:
-                this.startOrUpdateSelection();
-                this.moveCursorVisually(-1);
-                this.render();
-                return;
             case KEYS.CTRL_ARROW_DOWN:
-                this.startOrUpdateSelection();
-                this.moveCursorVisually(1);
-                this.render();
-                return;
             case KEYS.CTRL_ARROW_LEFT:
-                this.startOrUpdateSelection();
-                this.moveCursorLogically(-1);
-                this.render();
-                return;
             case KEYS.CTRL_ARROW_RIGHT:
                 this.startOrUpdateSelection();
-                this.moveCursorLogically(1);
+                if (keyName === KEYS.CTRL_ARROW_UP)
+                    this.moveCursorVisually(-1);
+                else if (keyName === KEYS.CTRL_ARROW_DOWN)
+                    this.moveCursorVisually(1);
+                else if (keyName === KEYS.CTRL_ARROW_LEFT)
+                    this.moveCursorLogically(-1);
+                else if (keyName === KEYS.CTRL_ARROW_RIGHT)
+                    this.moveCursorLogically(1);
                 this.render();
                 return;
         }
-        // 6. Handle all other command keys (Editing/Commands)
+        // 5. Xử lý tất cả các phím lệnh/chỉnh sửa khác
         edited = this.handleEditKeys(keyName || ch);
     }
-    // 7. State Update and Render
+    // 6. Cập nhật Trạng thái và Render
     if (edited) {
-        this.saveState();
-        this.recalculateVisualRows();
+        this.saveState(); // <-- Chỉ gọi khi gõ phím, xóa, v.v.
+        this.recalculateVisualRows(); // Tính toán lại layout
     }
     if (!this.isExiting) {
-        this.render();
+        this.render(); // Render cuối cùng (với visual rows đã được cập nhật nếu cần)
     }
 }
 /**
@@ -116,10 +106,6 @@ function handleKeypressEvent(ch, key) {
  * Returns true if content was modified.
  */
 function handleEditKeys(key) {
-    // (FIXED) Removed the guard clause that was blocking typing.
-    // if (key.length === 1 && key >= ' ' && key <= '~') {
-    //     return false;
-    // }
     // Cancel selection on normal navigation
     const isNavigation = [
         KEYS.ARROW_UP, KEYS.ARROW_DOWN, KEYS.ARROW_LEFT, KEYS.ARROW_RIGHT,
@@ -131,7 +117,6 @@ function handleEditKeys(key) {
             this.setStatusMessage(this.DEFAULT_STATUS, 0);
         }
     }
-    // Commands that return Promises must be wrapped in a sync call here
     switch (key) {
         // --- Exit / Save ---
         case KEYS.CTRL_Q:
@@ -143,7 +128,7 @@ function handleEditKeys(key) {
         case KEYS.CTRL_C:
             this.handleCopy();
             return false;
-        // --- Navigation ---
+        // --- Navigation (Non-Selection) ---
         case KEYS.ARROW_UP:
             this.moveCursorVisually(-1);
             return false;
@@ -194,12 +179,16 @@ function handleEditKeys(key) {
         case KEYS.CTRL_G:
             this.findNext();
             return false;
+        // ***** SỬA LỖI VISUAL *****
+        // Sau khi undo/redo, chúng ta PHẢI tính toán lại visual rows
         case KEYS.CTRL_Z:
             this.undo();
-            return true;
+            this.recalculateVisualRows(); // <-- THÊM DÒNG NÀY
+            return false;
         case KEYS.CTRL_Y:
             this.redo();
-            return true;
+            this.recalculateVisualRows(); // <-- THÊM DÒNG NÀY
+            return false;
         // --- Clipboard ---
         case KEYS.CTRL_K: // Cut Line (Traditional)
             this.cutLine();
@@ -208,12 +197,17 @@ function handleEditKeys(key) {
             this.pasteLine();
             return true;
         case KEYS.CTRL_X: // Cut Selection
-            this.cutSelection(); // Synchronous wrapper for cutSelectionAsync
+            this.cutSelection();
             return true;
         case KEYS.CTRL_V: // Paste Selection
             this.pasteSelection();
             return true;
+        // Xử lý Ký tự in được
         default:
+            if (key.length === 1 && key >= ' ' && key <= '~') {
+                this.handleCharacterKey(key);
+                return true;
+            }
             return false;
     }
 }

package/dist/vendor/keypress.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Định nghĩa giao diện cho một sự kiện keypress.
+ * Được điều chỉnh từ file editor.ts.
+ */
+export interface KeypressEvent {
+    name?: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    sequence: string;
+    code?: string;
+}
+/**
+ * Hàm chính, chấp nhận một Readable Stream và làm cho nó
+ * phát ra sự kiện "keypress".
+ */
+export default function keypress(stream: NodeJS.ReadStream): void;

package/dist/vendor/keypress.js

@@ -0,0 +1,425 @@
+// src/vendor/keypress.ts
+// Đây là phiên bản "vendored" của thư viện 'keypress' (0.2.1)
+// được chuyển đổi sang TypeScript và loại bỏ hỗ trợ chuột
+// để tích hợp trực tiếp vào cliedit.
+import { EventEmitter } from 'events';
+import { StringDecoder } from 'string_decoder';
+/**
+ * Hàm polyfill cho `EventEmitter.listenerCount()`, để tương thích ngược.
+ */
+let listenerCount = EventEmitter.listenerCount;
+if (!listenerCount) {
+    listenerCount = function (emitter, event) {
+        return emitter.listeners(event).length;
+    };
+}
+/**
+ * Regexes dùng để phân tích escape code của ansi
+ */
+const metaKeyCodeRe = /^(?:\x1b)([a-zA-Z0-9])$/;
+const functionKeyCodeRe = /^(?:\x1b+)(O|N|\[|\[\[)(?:(\d+)(?:;(\d+))?([~^$])|(?:1;)?(\d+)?([a-zA-Z]))/;
+/**
+ * Hàm chính, chấp nhận một Readable Stream và làm cho nó
+ * phát ra sự kiện "keypress".
+ */
+export default function keypress(stream) {
+    if (isEmittingKeypress(stream))
+        return;
+    // Gắn decoder vào stream để theo dõi
+    stream._keypressDecoder = new StringDecoder('utf8');
+    function onData(b) {
+        if (listenerCount(stream, 'keypress') > 0) {
+            const r = stream._keypressDecoder.write(b);
+            if (r)
+                emitKey(stream, r);
+        }
+        else {
+            // Không ai đang nghe, gỡ bỏ listener
+            stream.removeListener('data', onData);
+            stream.on('newListener', onNewListener);
+        }
+    }
+    function onNewListener(event) {
+        if (event === 'keypress') {
+            stream.on('data', onData);
+            stream.removeListener('newListener', onNewListener);
+        }
+    }
+    if (listenerCount(stream, 'keypress') > 0) {
+        stream.on('data', onData);
+    }
+    else {
+        stream.on('newListener', onNewListener);
+    }
+}
+/**
+ * Kiểm tra xem stream đã phát ra sự kiện "keypress" hay chưa.
+ */
+function isEmittingKeypress(stream) {
+    let rtn = !!stream._keypressDecoder;
+    if (!rtn) {
+        // XXX: Đối với các phiên bản node cũ, chúng ta muốn xóa các
+        // listener "data" và "newListener" hiện có vì chúng sẽ không
+        // bao gồm các phần mở rộng của module này (như "mousepress" đã bị loại bỏ).
+        stream.listeners('data').slice(0).forEach(function (l) {
+            if (l.name === 'onData' && /emitKey/.test(l.toString())) {
+                // FIX TS2769: Ép kiểu 'l' thành kiểu listener hợp lệ
+                stream.removeListener('data', l);
+            }
+        });
+        stream.listeners('newListener').slice(0).forEach(function (l) {
+            if (l.name === 'onNewListener' && /keypress/.test(l.toString())) {
+                // FIX TS2769: Ép kiểu 'l' thành kiểu listener hợp lệ
+                stream.removeListener('newListener', l);
+            }
+        });
+    }
+    return rtn;
+}
+/**
+ * Phần code bên dưới được lấy từ module `readline.js` của node-core
+ * và đã được chuyển đổi sang TypeScript.
+ */
+function emitKey(stream, s) {
+    let ch;
+    const key = {
+        name: undefined,
+        ctrl: false,
+        meta: false,
+        shift: false,
+        sequence: s,
+    };
+    let parts;
+    // Cảnh báo: Block `Buffer.isBuffer(s)` đã bị loại bỏ.
+    // Lý do: `onData` luôn gọi `emitKey` với một string (kết quả từ StringDecoder).
+    // Block đệ quy (paste) cũng gọi với string.
+    // Vì vậy, `s` luôn là string.
+    if (s === '\r') {
+        // carriage return
+        key.name = 'return';
+    }
+    else if (s === '\n') {
+        // enter, đáng lẽ phải là linefeed
+        key.name = 'enter';
+    }
+    else if (s === '\t') {
+        // tab
+        key.name = 'tab';
+    }
+    else if (s === '\b' ||
+        s === '\x7f' ||
+        s === '\x1b\x7f' ||
+        s === '\x1b\b') {
+        // backspace hoặc ctrl+h
+        key.name = 'backspace';
+        key.meta = s.charAt(0) === '\x1b';
+    }
+    else if (s === '\x1b' || s === '\x1b\x1b') {
+        // escape key
+        key.name = 'escape';
+        key.meta = s.length === 2;
+    }
+    else if (s === ' ' || s === '\x1b ') {
+        key.name = 'space';
+        key.meta = s.length === 2;
+    }
+    else if (s <= '\x1a') {
+        // ctrl+letter
+        key.name = String.fromCharCode(s.charCodeAt(0) + 'a'.charCodeAt(0) - 1);
+        key.ctrl = true;
+    }
+    else if (s.length === 1 && s >= 'a' && s <= 'z') {
+        // lowercase letter
+        key.name = s;
+    }
+    else if (s.length === 1 && s >= 'A' && s <= 'Z') {
+        // shift+letter
+        key.name = s.toLowerCase();
+        key.shift = true;
+    }
+    else if ((parts = metaKeyCodeRe.exec(s))) {
+        // meta+character key
+        key.name = parts[1].toLowerCase();
+        key.meta = true;
+        key.shift = /^[A-Z]$/.test(parts[1]);
+    }
+    else if ((parts = functionKeyCodeRe.exec(s))) {
+        // ansi escape sequence
+        // Lắp ráp lại key code, bỏ qua \x1b đứng đầu,
+        // bitflag của phím bổ trợ và bất kỳ chuỗi "1;" vô nghĩa nào
+        const code = (parts[1] || '') +
+            (parts[2] || '') +
+            (parts[4] || '') +
+            (parts[6] || '');
+        // FIX TS2362: Chuyển đổi (parts[...]) sang number bằng parseInt
+        const modifier = parseInt(parts[3] || parts[5] || '1', 10) - 1;
+        // Phân tích phím bổ trợ
+        key.ctrl = !!(modifier & 4);
+        key.meta = !!(modifier & 10);
+        key.shift = !!(modifier & 1);
+        key.code = code;
+        // Phân tích chính phím đó
+        switch (code) {
+            /* xterm/gnome ESC O letter */
+            case 'OP':
+                key.name = 'f1';
+                break;
+            case 'OQ':
+                key.name = 'f2';
+                break;
+            case 'OR':
+                key.name = 'f3';
+                break;
+            case 'OS':
+                key.name = 'f4';
+                break;
+            /* xterm/rxvt ESC [ number ~ */
+            case '[11~':
+                key.name = 'f1';
+                break;
+            case '[12~':
+                key.name = 'f2';
+                break;
+            case '[13~':
+                key.name = 'f3';
+                break;
+            case '[14~':
+                key.name = 'f4';
+                break;
+            /* from Cygwin and used in libuv */
+            case '[[A':
+                key.name = 'f1';
+                break;
+            case '[[B':
+                key.name = 'f2';
+                break;
+            case '[[C':
+                key.name = 'f3';
+                break;
+            case '[[D':
+                key.name = 'f4';
+                break;
+            case '[[E':
+                key.name = 'f5';
+                break;
+            /* common */
+            case '[15~':
+                key.name = 'f5';
+                break;
+            case '[17~':
+                key.name = 'f6';
+                break;
+            case '[18~':
+                key.name = 'f7';
+                break;
+            case '[19~':
+                key.name = 'f8';
+                break;
+            case '[20~':
+                key.name = 'f9';
+                break;
+            case '[21~':
+                key.name = 'f10';
+                break;
+            case '[23~':
+                key.name = 'f11';
+                break;
+            case '[24~':
+                key.name = 'f12';
+                break;
+            /* xterm ESC [ letter */
+            case '[A':
+                key.name = 'up';
+                break;
+            case '[B':
+                key.name = 'down';
+                break;
+            case '[C':
+                key.name = 'right';
+                break;
+            case '[D':
+                key.name = 'left';
+                break;
+            case '[E':
+                key.name = 'clear';
+                break;
+            case '[F':
+                key.name = 'end';
+                break;
+            case '[H':
+                key.name = 'home';
+                break;
+            /* xterm/gnome ESC O letter */
+            case 'OA':
+                key.name = 'up';
+                break;
+            case 'OB':
+                key.name = 'down';
+                break;
+            case 'OC':
+                key.name = 'right';
+                break;
+            case 'OD':
+                key.name = 'left';
+                break;
+            case 'OE':
+                key.name = 'clear';
+                break;
+            case 'OF':
+                key.name = 'end';
+                break;
+            case 'OH':
+                key.name = 'home';
+                break;
+            /* xterm/rxvt ESC [ number ~ */
+            case '[1~':
+                key.name = 'home';
+                break;
+            case '[2~':
+                key.name = 'insert';
+                break;
+            case '[3~':
+                key.name = 'delete';
+                break;
+            case '[4~':
+                key.name = 'end';
+                break;
+            case '[5~':
+                key.name = 'pageup';
+                break;
+            case '[6~':
+                key.name = 'pagedown';
+                break;
+            /* putty */
+            case '[[5~':
+                key.name = 'pageup';
+                break;
+            case '[[6~':
+                key.name = 'pagedown';
+                break;
+            /* rxvt */
+            case '[7~':
+                key.name = 'home';
+                break;
+            case '[8~':
+                key.name = 'end';
+                break;
+            /* rxvt keys with modifiers */
+            case '[a':
+                key.name = 'up';
+                key.shift = true;
+                break;
+            case '[b':
+                key.name = 'down';
+                key.shift = true;
+                break;
+            case '[c':
+                key.name = 'right';
+                key.shift = true;
+                break;
+            case '[d':
+                key.name = 'left';
+                key.shift = true;
+                break;
+            case '[e':
+                key.name = 'clear';
+                key.shift = true;
+                break;
+            case '[2$':
+                key.name = 'insert';
+                key.shift = true;
+                break;
+            case '[3$':
+                key.name = 'delete';
+                key.shift = true;
+                break;
+            case '[5$':
+                key.name = 'pageup';
+                key.shift = true;
+                break;
+            case '[6$':
+                key.name = 'pagedown';
+                key.shift = true;
+                break;
+            case '[7$':
+                key.name = 'home';
+                key.shift = true;
+                break;
+            case '[8$':
+                key.name = 'end';
+                key.shift = true;
+                break;
+            case 'Oa':
+                key.name = 'up';
+                key.ctrl = true;
+                break;
+            case 'Ob':
+                key.name = 'down';
+                key.ctrl = true;
+                break;
+            case 'Oc':
+                key.name = 'right';
+                key.ctrl = true;
+                break;
+            case 'Od':
+                key.name = 'left';
+                key.ctrl = true;
+                break;
+            case 'Oe':
+                key.name = 'clear';
+                key.ctrl = true;
+                break;
+            case '[2^':
+                key.name = 'insert';
+                key.ctrl = true;
+                break;
+            case '[3^':
+                key.name = 'delete';
+                key.ctrl = true;
+                break;
+            case '[5^':
+                key.name = 'pageup';
+                key.ctrl = true;
+                break;
+            case '[6^':
+                key.name = 'pagedown';
+                key.ctrl = true;
+                break;
+            case '[7^':
+                key.name = 'home';
+                key.ctrl = true;
+                break;
+            case '[8^':
+                key.name = 'end';
+                key.ctrl = true;
+                break;
+            /* misc. */
+            case '[Z':
+                key.name = 'tab';
+                key.shift = true;
+                break;
+            default:
+                key.name = 'undefined';
+                break;
+        }
+    }
+    else if (s.length > 1 && s[0] !== '\x1b') {
+        // Nhận được một chuỗi ký tự dài hơn một.
+        // Có thể là paste, vì nó không phải là control sequence.
+        for (const c of s) {
+            emitKey(stream, c);
+        }
+        return;
+    }
+    // XXX: code phân tích "mouse" đã bị XÓA theo yêu cầu.
+    // Không phát ra key nếu không tìm thấy tên
+    if (key.name === undefined) {
+        return; // key = undefined;
+    }
+    if (s.length === 1) {
+        ch = s;
+    }
+    if (key || ch) {
+        stream.emit('keypress', ch, key);
+    }
+}

package/package.json

@@ -1,44 +1,43 @@
-{
-  "name": "cliedit",
-  "version": "0.1.0",
-  "description": "A lightweight, raw-mode terminal editor utility for Node.js CLI applications, with line wrapping and undo/redo support.",
-  "repository": "https://github.com/CodeTease/cliedit",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "demo": "npm run build && cross-env NODE_ENV=development node dist/demo.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [
-    "cli",
-    "editor",
-    "terminal",
-    "tui",
-    "raw-mode",
-    "typescript"
-  ],
-  "author": "CodeTease",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^20.12.12",
-    "cross-env": "^7.0.3",
-    "typescript": "^5.4.5"
-  },
-  "dependencies": {
-    "keypress": "^0.2.1"
-  }
+{
+  "name": "cliedit",
+  "version": "0.1.1",
+  "description": "A lightweight, raw-mode terminal editor utility for Node.js CLI applications, with line wrapping and undo/redo support.",
+  "repository": "https://github.com/CodeTease/cliedit",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "demo": "npm run build && cross-env NODE_ENV=development node dist/demo.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "editor",
+    "terminal",
+    "tui",
+    "raw-mode",
+    "typescript"
+  ],
+  "author": "CodeTease",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.12.12",
+    "cross-env": "^7.0.3",
+    "typescript": "^5.4.5"
+  },
+  "dependencies": {
+  }
 }