mepcli 0.5.5 → 0.6.0

package/README.md

@@ -1,12 +1,14 @@
 # Mep
 
-**Mep** is a minimalist and zero-dependency library for creating interactive command-line prompts in Node.js. It focuses on simplicity, modern design, and robust input handling, including support for cursor movement and input validation.
+**Mep** is a lightweight and zero-dependency library for creating interactive command-line prompts in Node.js. It focuses on simplicity, modern design, and robust input handling, including support for cursor movement and input validation.
+
+A **CodeTease** project. 
 
 ## Features
 
 - **Zero Dependency:** Keeps your project clean and fast.
-- **Comprehensive Prompts:** Includes `text`, `password`, `select`, `checkbox`, `confirm`, `number`, `toggle`, `list`, `slider`, `date`, `file`, `multiSelect`, `autocomplete`, `sort`, `table`, `rating`, `editor`, `tree`, and `keypress`.
-- **Mouse Support:** Built-in support for mouse interaction (SGR 1006 protocol). Scroll to navigate lists or change values; click to select.
+- **Comprehensive Prompts:** Includes `text`, `password`, `secret`, `select`, `checkbox`, `confirm`, `number`, `toggle`, `list`, `slider`, `range`, `date`, `file`, `multiSelect`, `autocomplete`, `sort`, `transfer`, `cron`, `table`, `rating`, `editor`, `tree`, `keypress`, `color`, `grid`, and `calendar`.
+- **Mouse Support:** Built-in support for mouse interaction (SGR 1006 protocol). Scroll to navigate lists or change values.
 - **Responsive Input:** Supports cursor movement (Left/Right) and character insertion/deletion in text-based prompts.
 - **Validation:** Built-in support for input validation (sync and async) with custom error messages.
 - **Elegant Look:** Uses ANSI colors for a clean, modern CLI experience.
@@ -104,13 +106,79 @@ async function main() {
         ]
     });
 
+    // Color (RGB Picker)
+    const color = await MepCLI.color({
+        message: "Choose theme color:",
+        initial: "#3B82F6"
+    });
+
+    // Grid (Matrix Selection)
+    const permissions = await MepCLI.grid({
+        message: "Manage Permissions:",
+        rows: ["Admin", "User", "Guest"],
+        columns: ["Read", "Write", "Delete"]
+    });
+
+    // Calendar (Date/Range Picker)
+    const booking = await MepCLI.calendar({
+        message: "Select dates:",
+        mode: "range"
+    });
+
     // Editor (External text editor)
     const bio = await MepCLI.editor({
         message: "Write your biography:",
         extension: ".md"
     });
 
-    console.log({ name, age, newsletter, lang, tools, stars, city, priorities, user, bio });
+    // Form (Multi-field input)
+    const userDetails = await MepCLI.form({
+        message: "User Details:",
+        fields: [
+            { name: "firstname", message: "First Name", initial: "John" },
+            { name: "lastname", message: "Last Name", validate: (v) => v.length > 0 ? true : "Required" },
+            { name: "email", message: "Email", validate: (v) => v.includes("@") || "Invalid email" }
+        ]
+    });
+
+    // Snippet (Template filling)
+    const commitMsg = await MepCLI.snippet({
+        message: "Commit Message:",
+        template: "feat(${scope}): ${message}",
+        values: {
+            scope: "core"
+        }
+    });
+
+    // Code Prompt (JSON/YAML Editing)
+    const config = await MepCLI.code({
+        message: "Configure Server:",
+        language: "json",
+        template: `
+{
+  "host": "\${host}",
+  "port": \${port},
+  "debug": \${debug}
+}
+`
+    });
+
+    // Tree Select (Hierarchical Multi-Select)
+    const selectedFiles = await MepCLI.treeSelect({
+        message: "Select files to backup:",
+        data: [
+            {
+                title: "src",
+                value: "src",
+                children: [
+                    { title: "index.ts", value: "src/index.ts" },
+                    { title: "utils.ts", value: "src/utils.ts" }
+                ]
+            }
+        ]
+    });
+
+    console.log({ name, age, newsletter, lang, tools, stars, city, priorities, user, color, permissions, booking, bio, userDetails, commitMsg, config, selectedFiles });
 }
 
 main();
@@ -122,6 +190,7 @@ main();
 
 *   `text(options)` - Single line or multiline text input.
 *   `password(options)` - Masked text input.
+*   `secret(options)` - Completely hidden text input.
 *   `number(options)` - Numeric input with increment/decrement support.
 *   `confirm(options)` - Yes/No question.
 *   `toggle(options)` - On/Off switch.
@@ -130,15 +199,27 @@ main();
 *   `checkbox(options)` - Classic checkbox selection.
 *   `list(options)` - Enter a list of tags/strings.
 *   `slider(options)` - Select a number within a range using a visual slider.
+*   `range(options)` - Select a numerical range (min/max) using a dual-handle slider.
 *   `rating(options)` - Star rating input.
 *   `date(options)` - Date and time picker.
+*   `color(options)` - RGB color picker with hex output and TrueColor preview.
+*   `grid(options)` - 2D matrix selection (rows x columns).
+*   `calendar(options)` - Interactive monthly calendar for single dates or ranges.
 *   `file(options)` - File system navigator and selector.
 *   `autocomplete(options)` - Searchable selection with async suggestions.
 *   `sort(options)` - Reorder a list of items.
+*   `transfer(options)` - Move items between two lists (Source/Target).
+*   `cron(options)` - Visually build a cron schedule (Minute, Hour, Day, Month, Weekday).
 *   `table(options)` - Display data in columns and select rows.
 *   `tree(options)` - Navigate and select from a hierarchical tree structure.
 *   `keypress(options)` - Wait for a specific key press or any key.
 *   `editor(options)` - Launch an external editor (Vim, Nano, Notepad, etc.) to capture multi-line content.
+*   `form(options)` - Multi-field input form with navigation.
+*   `snippet(options)` - Template string filling with variable navigation.
+*   `code(options)` - Edit variables within a code block (JSON/YAML). Syntax highlighting is supported (Experimental).
+*   `treeSelect(options)` - Hierarchical multi-selection with cascading checkboxes.
+*   `spam(options)` - Confirm a dangerous action or fun.
+*   `wait(options)` - Wait for a specified number of seconds.
 *   `spinner(message)` - Returns a `Spinner` instance for manual control (`start`, `stop`, `update`, `success`, `error`).
 
 ## Mouse Support
@@ -146,14 +227,100 @@ main();
 MepCLI automatically detects modern terminals and enables **Mouse Tracking** (using SGR 1006 protocol).
 
 *   **Scrolling:**
-    *   `select`, `multiSelect`, `checkbox`, `autocomplete`, `table`, `tree`: Scroll to navigate the list.
-    *   `number`, `slider`, `rating`, `date`: Scroll to increment/decrement values or fields.
+    *   `select`, `multiSelect`, `checkbox`, `autocomplete`, `table`, `tree`, `transfer`: Scroll to navigate the list.
+    *   `form`, `snippet`, `cron`: Scroll to navigate between fields or values.
+    *   `number`, `slider`, `range`, `rating`, `date`: Scroll to increment/decrement values or fields.
     *   `sort`: Scroll to navigate or reorder items (when grabbed).
     *   `toggle`, `confirm`: Scroll to toggle the state.
+    *   `calendar`: Scroll to switch months.
+    *   `color`: Scroll to adjust RGB channels.
+    *   `grid`: Scroll to move selection.
 *   **Configuration:**
     *   Mouse support is enabled by default if the terminal supports it.
     *   You can explicitly disable it per prompt by setting `mouse: false` in the options.
 
+## Advanced Shortcuts
+
+### Calendar Prompt
+
+Mep's Calendar prompt supports advanced navigation and selection shortcuts for power users.
+
+*   **Keyboard:**
+    *   `Arrow Keys`: Move cursor day by day.
+    *   `PageUp` / `PageDown`: Jump to previous/next **Month**.
+    *   `Ctrl + Up` / `Ctrl + Down`: Jump to previous/next **Year**.
+    *   `Home` / `End`: Jump to the first/last day of the current month.
+    *   `t`: Jump immediately to **Today**.
+    *   `Enter`: Select date (or start/end of range).
+
+*   **Mouse:**
+    *   `Scroll`: Navigate **Months**.
+    *   `Ctrl + Scroll`: Adjust the selected **Day** (cursor movement).
+
+### Color Prompt
+
+*   **Keyboard:**
+    *   `Tab`: Switch between RGB channels.
+    *   `Up` / `Down`: Move between channels.
+    *   `Left` / `Right`: Adjust current channel value.
+    *   `Shift + Left` / `Shift + Right`: Fast adjust current channel value.
+
+*   **Mouse:**
+    *   `Scroll`: Adjust the current channel value.
+    *   `Ctrl + Scroll`: Fast adjust.
+
+### Checkbox Prompt
+
+*   **Keyboard:**
+    *   `Space`: Toggle selection.
+    *   `a`: Select **All**.
+    *   `x` / `n`: Select **None**.
+    *   `i`: **Invert** selection.
+
+### MultiSelect Prompt
+
+*   **Keyboard:**
+    *   `Space`: Toggle selection.
+    *   `Ctrl + A`: Select **All** (Visible).
+    *   `Ctrl + X`: Deselect **All** (Visible).
+    *   `Typing`: Filter list.
+
+### Transfer Prompt
+
+*   **Keyboard:**
+    *   `Tab` / `Left` / `Right`: Switch focus between Source and Target.
+    *   `Space`: Move selected item.
+    *   `a` / `>`: Move **All** to Target.
+    *   `r` / `<`: Move **All** to Source (Reset).
+
+### Tree & TreeSelect Prompt
+
+*   **Keyboard:**
+    *   `Right`: Expand folder or jump to child.
+    *   `Left`: Collapse folder or jump to parent.
+    *   `Space`: Toggle expansion (Tree) or Checkbox (TreeSelect).
+    *   `e`: **Expand** all recursively.
+    *   `c`: **Collapse** all recursively.
+
+### Grid Prompt
+
+The Grid prompt (Matrix selection) includes robust shortcuts for bulk actions.
+
+*   **Keyboard:**
+    *   `Arrow Keys`: Move cursor.
+    *   `PageUp` / `PageDown`: Jump to the first/last **Row**.
+    *   `Home` / `End`: Jump to the first/last **Column**.
+    *   `Space`: Toggle current cell.
+    *   `r`: Toggle entire **Row**.
+    *   `c`: Toggle entire **Column**.
+    *   `a`: Select **All**.
+    *   `x`: Deselect **All** (None).
+    *   `i`: **Invert** selection.
+
+*   **Mouse:**
+    *   `Scroll`: Vertical navigation (Rows).
+    *   `Shift + Scroll`: Horizontal navigation (Columns).
+
 ## License
 
 This project is under the **MIT License**.

package/dist/ansi.d.ts

@@ -8,6 +8,7 @@ export declare const ANSI: {
     DIM: string;
     ITALIC: string;
     UNDERLINE: string;
+    REVERSE: string;
     FG_GREEN: string;
     FG_CYAN: string;
     FG_YELLOW: string;

package/dist/ansi.js

@@ -11,6 +11,7 @@ exports.ANSI = {
     DIM: '\x1b[2m',
     ITALIC: '\x1b[3m',
     UNDERLINE: '\x1b[4m',
+    REVERSE: '\x1b[7m',
     // Colors
     FG_GREEN: '\x1b[32m',
     FG_CYAN: '\x1b[36m',

package/dist/base.d.ts

@@ -34,7 +34,7 @@ export declare abstract class Prompt<T, O> {
      * Optional method to handle mouse events.
      * Subclasses can override this to implement mouse interaction.
      */
-    protected handleMouse(event: MouseEvent): void;
+    protected handleMouse(_event: MouseEvent): void;
     protected print(text: string): void;
     /**
      * Starts the prompt interaction.

package/dist/base.js

@@ -24,7 +24,7 @@ class Prompt {
      * Optional method to handle mouse events.
      * Subclasses can override this to implement mouse interaction.
      */
-    handleMouse(event) { }
+    handleMouse(_event) { }
     print(text) {
         this.stdout.write(text);
     }
@@ -88,7 +88,6 @@ class Prompt {
         if (this._onKeyHandler) {
             this._inputParser.removeListener('keypress', this._onKeyHandler);
         }
-        // Cleanup mouse listener - though InputParser is instance specific, so it's fine.
         // Disable Mouse Tracking
         this.print(ansi_1.ANSI.DISABLE_MOUSE);
         if (typeof this.stdin.setRawMode === 'function') {
@@ -169,11 +168,6 @@ class Prompt {
                 }
             }
             else {
-                // Width check
-                // Handle surrogates roughly (we don't need perfect width here during loop, just enough to stop)
-                // But wait, we imported `stringWidth`.
-                // We can't easily use `stringWidth` incrementally without re-parsing.
-                // Let's just trust the loop for cut index.
                 // Re-implement basic width logic here for the cut index finding
                 let charWidth = 1;
                 let cp = code;
@@ -185,9 +179,6 @@ class Prompt {
                         // We'll handle i increment in the loop
                     }
                 }
-                // Check range (simplified or call helper)
-                // We don't have isWideCodePoint exported. 
-                // But generally, we can just say:
                 if (cp >= 0x1100) { // Quick check for potentially wide
                     // It's acceptable to be slightly aggressive on wide chars for truncation
                     charWidth = 2;

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { TextOptions, SelectOptions, ConfirmOptions, CheckboxOptions, ThemeConfig, NumberOptions, ToggleOptions, ListOptions, SliderOptions, DateOptions, FileOptions, MultiSelectOptions, RatingOptions, AutocompleteOptions, SortOptions, TableOptions, EditorOptions, TreeOptions, KeypressOptions } from './types';
+import { TextOptions, SelectOptions, ConfirmOptions, CheckboxOptions, ThemeConfig, NumberOptions, ToggleOptions, ListOptions, SliderOptions, DateOptions, FileOptions, MultiSelectOptions, RatingOptions, AutocompleteOptions, SortOptions, TableOptions, EditorOptions, TreeOptions, KeypressOptions, FormOptions, SnippetOptions, SpamOptions, WaitOptions, CodeOptions, TreeSelectOptions, RangeOptions, TransferOptions, CronOptions, ColorOptions, GridOptions, CalendarOptions } from './types';
 import { Spinner } from './spinner';
 /**
  * Public Facade for MepCLI
@@ -14,10 +14,14 @@ export declare class MepCLI {
     static checkbox<const V>(options: CheckboxOptions<V>): Promise<V[]>;
     static confirm(options: ConfirmOptions): Promise<boolean>;
     static password(options: TextOptions): Promise<string>;
+    static secret(options: TextOptions): Promise<string>;
     static number(options: NumberOptions): Promise<number>;
     static toggle(options: ToggleOptions): Promise<boolean>;
     static list(options: ListOptions): Promise<string[]>;
     static slider(options: SliderOptions): Promise<number>;
+    static range(options: RangeOptions): Promise<[number, number]>;
+    static transfer<const V>(options: TransferOptions<V>): Promise<[V[], V[]]>;
+    static cron(options: CronOptions): Promise<string>;
     static date(options: DateOptions): Promise<Date>;
     static file(options: FileOptions): Promise<string>;
     static multiSelect<const V>(options: MultiSelectOptions<V>): Promise<V[]>;
@@ -28,4 +32,22 @@ export declare class MepCLI {
     static editor(options: EditorOptions): Promise<string>;
     static tree<const V>(options: TreeOptions<V>): Promise<V>;
     static keypress(options: KeypressOptions): Promise<string>;
+    static form(options: FormOptions): Promise<Record<string, string>>;
+    static snippet(options: SnippetOptions): Promise<string>;
+    static spam(options: SpamOptions): Promise<boolean>;
+    static wait(options: WaitOptions): Promise<void>;
+    static code(options: CodeOptions): Promise<string>;
+    /**
+     * Tree Select Prompt (Multi-selection)
+     * * @param options Configuration for the tree selection
+     * @returns A promise that resolves to an array of selected values
+     * * @notice Windows Compatibility:
+     * When used in a long sequence of prompts, this component may experience
+     * an input delay. If it feels "blocked", simply press 'Enter' once
+     * to refresh the TTY stream.
+     */
+    static treeSelect<const V>(options: TreeSelectOptions<V>): Promise<V[]>;
+    static color(options: ColorOptions): Promise<string>;
+    static grid(options: GridOptions): Promise<boolean[][]>;
+    static calendar(options: CalendarOptions): Promise<Date | [Date, Date]>;
 }

package/dist/core.js

@@ -11,6 +11,9 @@ const toggle_1 = require("./prompts/toggle");
 const number_1 = require("./prompts/number");
 const list_1 = require("./prompts/list");
 const slider_1 = require("./prompts/slider");
+const range_1 = require("./prompts/range");
+const transfer_1 = require("./prompts/transfer");
+const cron_1 = require("./prompts/cron");
 const date_1 = require("./prompts/date");
 const file_1 = require("./prompts/file");
 const multi_select_1 = require("./prompts/multi-select");
@@ -21,6 +24,15 @@ const table_1 = require("./prompts/table");
 const editor_1 = require("./prompts/editor");
 const tree_1 = require("./prompts/tree");
 const keypress_1 = require("./prompts/keypress");
+const form_1 = require("./prompts/form");
+const snippet_1 = require("./prompts/snippet");
+const spam_1 = require("./prompts/spam");
+const wait_1 = require("./prompts/wait");
+const code_1 = require("./prompts/code");
+const tree_select_1 = require("./prompts/tree-select");
+const color_1 = require("./prompts/color");
+const grid_1 = require("./prompts/grid");
+const calendar_1 = require("./prompts/calendar");
 /**
  * Public Facade for MepCLI
  */
@@ -46,6 +58,9 @@ class MepCLI {
     static password(options) {
         return new text_1.TextPrompt({ ...options, isPassword: true }).run();
     }
+    static secret(options) {
+        return new text_1.TextPrompt({ ...options, mask: '' }).run();
+    }
     static number(options) {
         return new number_1.NumberPrompt(options).run();
     }
@@ -58,6 +73,15 @@ class MepCLI {
     static slider(options) {
         return new slider_1.SliderPrompt(options).run();
     }
+    static range(options) {
+        return new range_1.RangePrompt(options).run();
+    }
+    static transfer(options) {
+        return new transfer_1.TransferPrompt(options).run();
+    }
+    static cron(options) {
+        return new cron_1.CronPrompt(options).run();
+    }
     static date(options) {
         return new date_1.DatePrompt(options).run();
     }
@@ -88,6 +112,42 @@ class MepCLI {
     static keypress(options) {
         return new keypress_1.KeypressPrompt(options).run();
     }
+    static form(options) {
+        return new form_1.FormPrompt(options).run();
+    }
+    static snippet(options) {
+        return new snippet_1.SnippetPrompt(options).run();
+    }
+    static spam(options) {
+        return new spam_1.SpamPrompt(options).run();
+    }
+    static wait(options) {
+        return new wait_1.WaitPrompt(options).run();
+    }
+    static code(options) {
+        return new code_1.CodePrompt(options).run();
+    }
+    /**
+     * Tree Select Prompt (Multi-selection)
+     * * @param options Configuration for the tree selection
+     * @returns A promise that resolves to an array of selected values
+     * * @notice Windows Compatibility:
+     * When used in a long sequence of prompts, this component may experience
+     * an input delay. If it feels "blocked", simply press 'Enter' once
+     * to refresh the TTY stream.
+     */
+    static treeSelect(options) {
+        return new tree_select_1.TreeSelectPrompt(options).run();
+    }
+    static color(options) {
+        return new color_1.ColorPrompt(options).run();
+    }
+    static grid(options) {
+        return new grid_1.GridPrompt(options).run();
+    }
+    static calendar(options) {
+        return new calendar_1.CalendarPrompt(options).run();
+    }
 }
 exports.MepCLI = MepCLI;
 MepCLI.theme = theme_1.theme;

package/dist/highlight.d.ts

@@ -0,0 +1 @@
+export declare function highlightJson(json: string): string;

package/dist/highlight.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.highlightJson = highlightJson;
+const ansi_1 = require("./ansi");
+function highlightJson(json) {
+    if (!json)
+        return '';
+    // Regex for JSON tokens
+    // Captures:
+    // 1. Strings (potentially keys if followed by :)
+    // 2. Numbers
+    // 3. Booleans/Null
+    // 4. Punctuation
+    const tokenRegex = /("(\\u[a-zA-Z0-9]{4}|\\[^u]|[^\\"])*"(\s*:)?)|(-?\d+(?:\.\d*)?(?:[eE][+-]?\d+)?)|(true|false|null)|([{}[\],:])/g;
+    return json.replace(tokenRegex, (match) => {
+        // String
+        if (match.startsWith('"')) {
+            // Check if it's a key (ends with :)
+            if (match.trim().endsWith(':')) {
+                const colonIndex = match.lastIndexOf(':');
+                const keyPart = match.substring(0, colonIndex);
+                const colonPart = match.substring(colonIndex);
+                // Key in Cyan
+                return `${ansi_1.ANSI.FG_CYAN}${keyPart}${ansi_1.ANSI.RESET}${colonPart}`;
+            }
+            // String value in Green
+            return `${ansi_1.ANSI.FG_GREEN}${match}${ansi_1.ANSI.RESET}`;
+        }
+        // Number in Yellow
+        if (/^-?\d/.test(match)) {
+            return `${ansi_1.ANSI.FG_YELLOW}${match}${ansi_1.ANSI.RESET}`;
+        }
+        // Boolean/Null in Red (or Magenta if available, using Red for now)
+        if (/^(true|false|null)$/.test(match)) {
+            return `${ansi_1.ANSI.FG_RED}${match}${ansi_1.ANSI.RESET}`;
+        }
+        // Punctuation in White (or default)
+        return `${ansi_1.ANSI.FG_WHITE}${match}${ansi_1.ANSI.RESET}`;
+    });
+}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Mep (Minimalist Interactive CLI Prompt)
+ * Mep (A Interactive CLI Prompt)
  * Export file
  */
 export * from './types';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Mep (Minimalist Interactive CLI Prompt)
+ * Mep (A Interactive CLI Prompt)
  * Export file
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {

package/dist/input.js

@@ -92,23 +92,32 @@ class InputParser extends events_1.EventEmitter {
         if (parts.length >= 3) {
             const [b, x, y] = parts;
             let action = 'press';
+            // Extract modifiers
+            const shift = !!(b & 4);
+            const meta = !!(b & 8);
+            const ctrl = !!(b & 16);
             // Interpret button codes
             // 0: Left, 1: Middle, 2: Right
             // +32: Motion
-            // 64: Scroll Up
-            // 65: Scroll Down
-            if (b === 64) {
+            // 64: Scroll (bit 6)
+            if (b & 64) {
                 action = 'scroll';
-                this.emit('mouse', { name: 'mouse', x, y, button: 0, action, scroll: 'up' });
-                // Also emit keypress for scroll if needed? No, prompt should listen to mouse.
-                // But for "Easy Features", we emit standard names
-                this.emit('scrollup');
-                return;
-            }
-            if (b === 65) {
-                action = 'scroll';
-                this.emit('mouse', { name: 'mouse', x, y, button: 0, action, scroll: 'down' });
-                this.emit('scrolldown');
+                const scroll = (b & 1) ? 'down' : 'up';
+                this.emit('mouse', {
+                    name: 'mouse',
+                    x,
+                    y,
+                    button: 0,
+                    action,
+                    scroll,
+                    shift,
+                    ctrl,
+                    meta
+                });
+                if (scroll === 'up')
+                    this.emit('scrollup');
+                else
+                    this.emit('scrolldown');
                 return;
             }
             if (type === 'm') {
@@ -126,7 +135,10 @@ class InputParser extends events_1.EventEmitter {
                 x,
                 y,
                 button: b & 3, // Strip modifiers to get raw button 0-2
-                action
+                action,
+                shift,
+                ctrl,
+                meta
             });
         }
     }

package/dist/prompts/autocomplete.d.ts

@@ -16,7 +16,7 @@ export declare class AutocompletePrompt<V> extends Prompt<V, AutocompleteOptions
     private startSpinner;
     private stopSpinner;
     protected cleanup(): void;
-    protected render(firstRender: boolean): void;
+    protected render(_firstRender: boolean): void;
     protected handleInput(char: string): void;
     protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/autocomplete.js

@@ -36,7 +36,7 @@ class AutocompletePrompt extends base_1.Prompt {
                 this.scrollTop = 0;
                 this.hasSearched = true;
             }
-            catch (err) {
+            catch (_err) {
                 this.choices = [];
             }
             finally {
@@ -64,15 +64,10 @@ class AutocompletePrompt extends base_1.Prompt {
         this.stopSpinner();
         super.cleanup();
     }
-    render(firstRender) {
-        // --- FIX START: Restore cursor position ---
-        // renderFrame() in Base assumes the cursor is at the bottom of the output.
-        // Since Autocomplete moves the cursor to the top (for input) after rendering,
-        // we must manually move it back down before the next render cycle.
+    render(_firstRender) {
         if (this.lastRenderHeight > 1) {
             this.print(`\x1b[${this.lastRenderHeight - 1}B`); // Move down
         }
-        // --- FIX END ---
         let output = '';
         // Header
         const icon = this.loading ? `${theme_1.theme.main}${symbols_1.symbols.spinner[this.spinnerFrame]}${ansi_1.ANSI.RESET}` : `${theme_1.theme.success}?${ansi_1.ANSI.RESET}`;

package/dist/prompts/calendar.d.ts

@@ -0,0 +1,20 @@
+import { Prompt } from '../base';
+import { CalendarOptions, MouseEvent } from '../types';
+export declare class CalendarPrompt extends Prompt<Date | [Date, Date], CalendarOptions> {
+    private cursor;
+    private viewDate;
+    private selection;
+    private selectingRange;
+    constructor(options: CalendarOptions);
+    private getDaysInMonth;
+    private getDayOfWeek;
+    private generateMonthGrid;
+    private isSameDay;
+    private isSelected;
+    private isRangeStart;
+    protected render(_firstRender: boolean): void;
+    private syncViewDate;
+    private alignCursorToViewDate;
+    protected handleInput(char: string, _key: Buffer): void;
+    protected handleMouse(event: MouseEvent): void;
+}