cliedit 0.1.2 → 0.1.3

package/README.md

@@ -4,7 +4,7 @@ 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.
+It includes line wrapping, visual navigation, smart auto-indentation, undo/redo, text selection, Find/Replace, and cross-platform clipboard support.
 
 ## Features
 
@@ -13,18 +13,21 @@ It includes line wrapping, visual navigation, undo/redo, text selection, and cli
 - **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).
+- **Clipboard Support:** `Ctrl+C` (Copy), `Ctrl+X` (Cut), `Ctrl+V` (Paste) for system clipboard (macOS, Windows, **and Linux** via `xclip`).
 - **File I/O:** Loads from and saves to the filesystem.
-- **Search:** `Ctrl+W` to find text.
+- **Search & Replace:** `Ctrl+W` to find text, `Ctrl+R` to find and replace interactively.
+- **Go to Line:** `Ctrl+L` to quickly jump to a specific line number.
+- **Smart Auto-Indentation:** Automatically preserves indentation level when pressing Enter.
 
 ## 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';
@@ -60,13 +63,15 @@ getCommitMessage();
 `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.
+
+  - **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';
 ```
@@ -74,6 +79,7 @@ import { CliEditor } from 'cliedit';
 ### Types
 
 Key types are also exported for convenience:
+
 ```javascript
 import type {
   DocumentState,

package/dist/editor.editing.d.ts

@@ -29,6 +29,14 @@ declare function deleteBackward(this: CliEditor): void;
  * Deletes the character after the cursor, or joins the current line with the next one.
  */
 declare function deleteForward(this: CliEditor): void;
+/**
+ * Handles auto-pairing of brackets and quotes.
+ * If text is selected, it wraps the selection.
+ * Otherwise, it inserts the pair and places the cursor in the middle.
+ * @param openChar The opening character that was typed (e.g., '(', '[', '{').
+ * @param closeChar The corresponding closing character (e.g., ')', ']', '}').
+ */
+declare function handleAutoPair(this: CliEditor, openChar: string, closeChar: string): void;
 export declare const editingMethods: {
     insertContentAtCursor: typeof insertContentAtCursor;
     insertCharacter: typeof insertCharacter;
@@ -36,5 +44,6 @@ export declare const editingMethods: {
     insertNewLine: typeof insertNewLine;
     deleteBackward: typeof deleteBackward;
     deleteForward: typeof deleteForward;
+    handleAutoPair: typeof handleAutoPair;
 };
 export {};

package/dist/editor.editing.js

@@ -110,6 +110,36 @@ function deleteForward() {
     }
     this.setDirty();
 }
+/**
+ * Handles auto-pairing of brackets and quotes.
+ * If text is selected, it wraps the selection.
+ * Otherwise, it inserts the pair and places the cursor in the middle.
+ * @param openChar The opening character that was typed (e.g., '(', '[', '{').
+ * @param closeChar The corresponding closing character (e.g., ')', ']', '}').
+ */
+function handleAutoPair(openChar, closeChar) {
+    if (this.selectionAnchor) {
+        // There is a selection, so we need to wrap it.
+        const selection = this.getNormalizedSelection();
+        if (!selection)
+            return; // Should not happen if anchor exists, but good practice
+        const selectedText = this.getSelectedText();
+        // The deleteSelectedText() function automatically moves the cursor to the start
+        // of the selection, so we don't need to set it manually.
+        this.deleteSelectedText();
+        // Wrap the original selected text
+        const wrappedText = openChar + selectedText + closeChar;
+        this.insertContentAtCursor(wrappedText.split('\n'));
+        // The selection is already cancelled by deleteSelectedText().
+    }
+    else {
+        // No selection, just insert the opening and closing characters
+        this.insertCharacter(openChar + closeChar);
+        // Move cursor back one position to be in between the pair
+        this.cursorX--;
+    }
+    this.setDirty();
+}
 export const editingMethods = {
     insertContentAtCursor,
     insertCharacter,
@@ -117,4 +147,5 @@ export const editingMethods = {
     insertNewLine,
     deleteBackward,
     deleteForward,
+    handleAutoPair,
 };

package/dist/editor.keys.js

@@ -1,5 +1,12 @@
 // src/editor.keys.ts
 import { KEYS } from './constants.js';
+const PAIR_MAP = {
+    '(': ')',
+    '[': ']',
+    '{': '}',
+    "'": "'",
+    '"': '"',
+};
 /**
  * Main router for standardized keypress events from the 'keypress' library.
  */
@@ -175,10 +182,24 @@ function handleEditKeys(key) {
             this.insertNewLine();
             return true;
         case KEYS.BACKSPACE:
-            if (this.selectionAnchor)
-                this.deleteSelectedText();
-            else
-                this.deleteBackward();
+            // Handle auto-pair deletion
+            const line = this.lines[this.cursorY] || '';
+            const charBefore = line[this.cursorX - 1];
+            const charAfter = line[this.cursorX];
+            if (!this.selectionAnchor &&
+                charBefore && charAfter &&
+                PAIR_MAP[charBefore] === charAfter) {
+                // Delete both characters of the pair
+                this.lines[this.cursorY] = line.slice(0, this.cursorX - 1) + line.slice(this.cursorX + 1);
+                this.cursorX--; // Move cursor back
+                this.setDirty();
+            }
+            else {
+                if (this.selectionAnchor)
+                    this.deleteSelectedText();
+                else
+                    this.deleteBackward();
+            }
             return true;
         case KEYS.DELETE:
             if (this.selectionAnchor)
@@ -238,11 +259,26 @@ function handleEditKeys(key) {
  * Handles insertion of a character, deleting selection first if it exists.
  */
 function handleCharacterKey(ch) {
-    if (this.selectionAnchor) {
-        this.deleteSelectedText();
+    const line = this.lines[this.cursorY] || '';
+    const charAfter = line[this.cursorX];
+    // If user types a closing character and it's what we expect, just move the cursor.
+    if (!this.selectionAnchor &&
+        (ch === ')' || ch === ']' || ch === '}' || ch === "'" || ch === '"') &&
+        charAfter === ch) {
+        this.cursorX++;
+        return;
+    }
+    const closeChar = PAIR_MAP[ch];
+    if (closeChar) {
+        this.handleAutoPair(ch, closeChar);
+    }
+    else {
+        if (this.selectionAnchor) {
+            this.deleteSelectedText();
+        }
+        this.insertCharacter(ch);
+        this.setDirty();
     }
-    this.insertCharacter(ch);
-    this.setDirty();
 }
 /**
  * Handles Ctrl+Q (Quit) sequence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cliedit",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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",