mepcli 1.2.0 → 1.3.1

package/README.md

@@ -11,6 +11,10 @@
 
 A **CodeTease** project.
 
+## Documentation
+
+For comprehensive guides, API references, and advanced usage, please visit the **[Documentation](./docs/README.md)**.
+
 ## Features
 
 - **Zero Dependency:** Keeps your project clean and fast.
@@ -147,7 +151,7 @@ Complex interfaces for structured data.
 | `box` | Box model (CSS Margin/Padding) editor. |
 | `phone` | International phone input with masking & country search. |
 | `connectionString` | Database URL wizard. |
-| `curl` (experimental) | Interactive HTTP request builder. |
+| `curl` | Interactive HTTP request builder. |
 
 ### 🔹 Gamified & Fun
 Add some personality to your CLI.
@@ -166,7 +170,7 @@ Helper functions for better CLI UX.
 
 | Function | Description |
 | :--- | :--- |
-| `exec` (experimental) | Run shell command with spinner. |
+| `exec` | Run shell command with spinner. |
 | `scroll` | Scrollable text viewer (e.g., License). |
 | `diff` | Text merge conflict resolver. |
 | `editor` | Open external editor (Vim/Nano). |
@@ -222,363 +226,8 @@ const result = await MepCLI.pipeline()
 
 ## Keyboard & Mouse Support
 
-MepCLI automatically detects modern terminals and enables **Mouse Tracking** (using SGR 1006 protocol) for scrolling and clicking.
-
-### ⌨️ Advanced Shortcuts
-
-<details>
-<summary><b>Calendar Prompt</b></summary>
-
-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).
-
-</details>
-
-<details>
-<summary><b>Color Prompt</b></summary>
-
-*   **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.
-
-</details>
-
-<details>
-<summary><b>Checkbox Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Space`: Toggle selection.
-    *   `a`: Select **All**.
-    *   `x` / `n`: Select **None**.
-    *   `i`: **Invert** selection.
-
-</details>
-
-<details>
-<summary><b>MultiSelect Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Space`: Toggle selection.
-    *   `Ctrl + A`: Select **All** (Visible).
-    *   `Ctrl + X`: Deselect **All** (Visible).
-    *   `Typing`: Filter list.
-
-</details>
-
-<details>
-<summary><b>Transfer Prompt</b></summary>
-
-*   **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).
-
-</details>
-
-<details>
-<summary><b>Tree & TreeSelect Prompt</b></summary>
-
-*   **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.
-
-</details>
-
-<details>
-<summary><b>Grid Prompt</b></summary>
-
-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).
-
-</details>
-
-<details>
-<summary><b>Map Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Ctrl + N`: Add new row.
-    *   `Ctrl + D`: Delete current row.
-    *   `Arrows` / `Tab`: Navigate cells.
-
-</details>
-
-<details>
-<summary><b>IP Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `typing...`: Auto-jumps to next octet after 3 digits or `.`.
-    *   `Backspace`: Navigates back to previous octet if empty.
-
-</details>
-
-<details>
-<summary><b>Kanban Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate items/columns.
-    *   `Space`: Grab/Drop item (Drag & Drop mode).
-    *   `Enter`: Submit.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate items (Normal) or Move item Left/Right (Grabbed).
-
-</details>
-
-<details>
-<summary><b>Time Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Up` / `Down`: Adjust value.
-    *   `Left` / `Right` / `Tab`: Switch unit (Hour/Minute/AM-PM).
-
-*   **Mouse:**
-    *   `Scroll`: Adjust value (Up/Down).
-
-</details>
-
-<details>
-<summary><b>Heatmap Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate cells.
-    *   `Tab` / `Shift+Tab`: Navigate cells (Horizontal).
-    *   `Space`: Cycle value.
-    *   `0-9`: Set value directly.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate rows (Vertical).
-
-</details>
-
-<details>
-<summary><b>Emoji Prompt & MultiColumnSelect</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate grid.
-    *   `Typing`: Filter/Search (Emoji only).
-
-</details>
-
-<details>
-<summary><b>Miller Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Up` / `Down`: Navigate items.
-    *   `Right` / `Enter` / `Tab`: Expand child or Drill down.
-    *   `Left` / `Shift + Tab`: Collapse or Go back.
-
-</details>
-
-<details>
-<summary><b>Match Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate lists.
-    *   `Tab`: Switch Source/Target.
-    *   `Space`: Pick Source or Toggle Link.
-
-</details>
-
-<details>
-<summary><b>Diff Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Left` / `Right`: Switch Action (Original / Modified / Edit).
-    *   `Enter`: Submit selection.
-
-</details>
-
-<details>
-<summary><b>Dial Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Adjust value (rotate knob).
-    *   `Enter`: Submit.
-
-*   **Mouse:**
-    *   `Scroll`: Adjust value.
-
-</details>
-
-<details>
-<summary><b>Draw Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Move cursor.
-    *   `Space`: Toggle pixel.
-    *   `c`: Clear canvas.
-    *   `i`: Invert canvas.
-    *   `Enter`: Submit.
-
-*   **Mouse:**
-    *   `Drag`: Paint (Left Click) or Erase (Right Click).
-    *   `Click`: Toggle pixel.
-
-</details>
-
-<details>
-<summary><b>Breadcrumb Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate list.
-    *   `Enter`: Drill down into folder.
-    *   `Backspace`: Go up one level.
-
-*  **Mouse:**
-    *   `Scroll`: Navigate list.
-
-</details>
-
-<details>
-<summary><b>Schedule Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Move task in time.
-    *   `Tab` / `Shift + Tab`: Switch between tasks.
-    *   `Shift + Left/Right`: Resize task duration.
-    *   `PageUp` / `PageDown`: Scroll timeline horizontally.
-
-* **Mouse:**
-    *   `Scroll`: Scroll timeline horizontally.
-
-</details>
-
-<details>
-<summary><b>Data Inspector</b></summary>
-
-*   **Keyboard:**
-    *   `Space` / `Arrows`: Expand/Collapse nodes.
-    *   `Enter`: Toggle Boolean or Edit String/Number.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate tree.
-
-</details>
-
-<details>
-<summary><b>Seat Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate seat grid.
-    *   `Tab` / `Shift+Tab`: Navigate Left/Right.
-    *   `Space`: Select/Deselect seat.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate Up/Down.
-
-</details>
-
-<details>
-<summary><b>Select Range Prompt & Multi Range Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows (Up/Down)`: Navigate items.
-    *   `Space`: Set/Unset anchor point (drag start) or commit range (drag end).
-    *   `Enter`: Submit selected range(s).
-
-</details>
-
-<details>
-<summary><b>Breadcrumb Search Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate.
-    *   `Typing`: Enter **Search Mode** (filters current folder).
-    *   `Esc`: Exit Search Mode.
-    *   `Enter`: Drill down (Folder) or Select (File).
-
-</details>
-
-<details>
-<summary><b>Sort Grid Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate grid.
-    *   `Tab` / `Shift+Tab`: Navigate Left/Right.
-    *   `Space`: Grab/Drop item.
-    *   `Enter`: Submit grid.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate Up/Down.
-
-</details>
-
-<details>
-<summary><b>Dependency Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows`: Navigate items.
-    *   `Space`: Toggle item (Triggers auto-resolution).
-    *   `Enter`: Submit selection.
-
-*   **Mouse:**
-    *   `Scroll`: Navigate Up/Down.
-
-</details>
-
-<details>
-<summary><b>Box Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Arrows` / `Tab`: Navigate (Top -> Right -> Bottom -> Left).
-    *   `Shift + Tab`: Navigate backwards.
-    *   `+` / `-`: Increment/Decrement value.
-    *   `0-9`: Type value directly.
-
-*   **Mouse:**
-    *   `Scroll`: Cycle focus (Up=Backwards, Down=Forwards).
-
-</details>
-
-<details>
-<summary><b>Phone Prompt</b></summary>
-
-*   **Keyboard:**
-    *   `Tab`: Switch between **Country Code** and **Number** sections.
-    *   `Typing` (in Country section): Fuzzy search for country (e.g., "Viet", "US").
-    *   `Arrows (Up/Down)`: Cycle through countries.
-    *   `Backspace`: Delete digit or clear search.
-
-*   **Mouse:**
-    *   `Scroll`: Cycle through countries (when Country section is active).
-
-</details>
+For a detailed list of shortcuts and mouse interactions, please refer to the **[Shortcuts Documentation](./docs/shortcuts.md)**.
 
 ## License
 
-This project is under the **MIT License**.
+This project is under the **MIT License**.

package/dist/core.d.ts

@@ -7,7 +7,7 @@ import { Pipeline } from './pipeline';
 import { TaskRunner } from './tasks';
 import { TaskGroupOptions } from './types';
 /**
- * Public Facade for MepCLI
+ * Public Facade for Mep
  */
 export declare class MepCLI {
     static theme: ThemeConfig;
@@ -875,7 +875,7 @@ export declare class MepCLI {
      * });
      * @param options - Command string and streaming preferences.
      * @returns A promise resolving when execution completes.
-     * @see {@link https://github.com/CodeTease/mep/blob/main/example.ts}
+     * @see {@link https://github.com/CodeTease/mep/blob/main/examples/exec-prompt.ts}
      */
     static exec(options: ExecOptions): Promise<void>;
     /**
@@ -1007,7 +1007,6 @@ export declare class MepCLI {
     static connectionString(options: ConnectionStringOptions): Promise<ConnectionStringResult>;
     /**
      * cURL Command Builder.
-     * @experimental
      * @example
      * const request = await MepCLI.curl({
      *   message: 'Build API Request',

package/dist/core.js

@@ -79,7 +79,7 @@ const curl_1 = require("./prompts/curl");
 const pipeline_1 = require("./pipeline");
 const tasks_1 = require("./tasks");
 /**
- * Public Facade for MepCLI
+ * Public Facade for Mep
  */
 class MepCLI {
     /**
@@ -1072,7 +1072,7 @@ class MepCLI {
      * });
      * @param options - Command string and streaming preferences.
      * @returns A promise resolving when execution completes.
-     * @see {@link https://github.com/CodeTease/mep/blob/main/example.ts}
+     * @see {@link https://github.com/CodeTease/mep/blob/main/examples/exec-prompt.ts}
      */
     static exec(options) {
         return new exec_1.ExecPrompt(options).run();
@@ -1219,7 +1219,6 @@ class MepCLI {
     }
     /**
      * cURL Command Builder.
-     * @experimental
      * @example
      * const request = await MepCLI.curl({
      *   message: 'Build API Request',

package/dist/prompts/curl-utils.d.ts

@@ -0,0 +1,25 @@
+export type ShellType = 'bash' | 'powershell' | 'cmd';
+export interface ShellStrategy {
+    binary: string;
+    wrapper: string;
+    continuation: string;
+    escape(value: string): string;
+}
+export declare class BashStrategy implements ShellStrategy {
+    readonly binary = "curl";
+    readonly wrapper = "'";
+    readonly continuation = " \\";
+    escape(value: string): string;
+}
+export declare class PowerShellStrategy implements ShellStrategy {
+    readonly binary = "curl.exe";
+    readonly wrapper = "'";
+    readonly continuation = " `";
+    escape(value: string): string;
+}
+export declare class CmdStrategy implements ShellStrategy {
+    readonly binary = "curl";
+    readonly wrapper = "\"";
+    readonly continuation = " ^";
+    escape(value: string): string;
+}

package/dist/prompts/curl-utils.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CmdStrategy = exports.PowerShellStrategy = exports.BashStrategy = void 0;
+class BashStrategy {
+    constructor() {
+        this.binary = 'curl';
+        this.wrapper = "'";
+        this.continuation = ' \\';
+    }
+    escape(value) {
+        // e.g. "It's me" -> 'It'\''s me'
+        return `'${value.replace(/'/g, "'\\''")}'`;
+    }
+}
+exports.BashStrategy = BashStrategy;
+class PowerShellStrategy {
+    constructor() {
+        this.binary = 'curl.exe';
+        this.wrapper = "'";
+        this.continuation = ' `';
+    }
+    escape(value) {
+        // e.g. "It's me" -> 'It''s me'
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+}
+exports.PowerShellStrategy = PowerShellStrategy;
+class CmdStrategy {
+    constructor() {
+        this.binary = 'curl';
+        this.wrapper = '"';
+        this.continuation = ' ^';
+    }
+    escape(value) {
+        // e.g. {"key": "value"} -> "{\"key\": \"value\"}"
+        // e.g. value with " -> "value with \""
+        const flattened = value.replace(/[\r\n]+/g, ' ');
+        return `"${flattened.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+}
+exports.CmdStrategy = CmdStrategy;

package/dist/prompts/curl.d.ts

@@ -16,24 +16,25 @@ export interface CurlResult {
 export declare class CurlPrompt extends Prompt<CurlResult, CurlOptions> {
     private section;
     private methodIndex;
-    private url;
+    private urlSegments;
+    private urlCursor;
     private headers;
     private body;
-    private urlCursor;
     private lastLinesUp;
+    private shell;
+    private strategies;
     constructor(options: CurlOptions);
     private get currentMethod();
     private get hasBody();
-    /**
-     * Escape a string for safe inclusion inside a double-quoted shell argument.
-     * This escapes backslashes first, then double quotes.
-     */
-    private shellEscapeDoubleQuoted;
+    private get url();
+    private cycleShell;
     private generateCommand;
     protected render(firstRender: boolean): void;
     protected cleanup(): void;
     protected handleInput(char: string, _buffer: Buffer): void;
+    private handleUrlInput;
     private cycleSection;
+    private clear;
     private editHeaders;
     private editBody;
     private submitResult;

package/dist/prompts/curl.js

@@ -7,6 +7,8 @@ const theme_1 = require("../theme");
 const symbols_1 = require("../symbols");
 const map_1 = require("./map");
 const code_1 = require("./code");
+const utils_1 = require("../utils");
+const curl_utils_1 = require("./curl-utils");
 var Section;
 (function (Section) {
     Section[Section["METHOD"] = 0] = "METHOD";
@@ -15,26 +17,45 @@ var Section;
     Section[Section["BODY"] = 3] = "BODY";
 })(Section || (Section = {}));
 const METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];
+const COMMON_HEADERS = [
+    'Accept', 'Accept-Encoding', 'Accept-Language',
+    'Authorization', 'Cache-Control', 'Connection',
+    'Content-Type', 'Cookie', 'Host',
+    'Origin', 'Pragma', 'Referer',
+    'User-Agent', 'X-Requested-With'
+];
 class CurlPrompt extends base_1.Prompt {
     constructor(options) {
         super(options);
         this.section = Section.METHOD;
         this.methodIndex = 0;
-        this.url = '';
+        // URL State
+        this.urlSegments = [];
+        this.urlCursor = 0;
         this.headers = {};
         this.body = '';
-        // For URL input
-        this.urlCursor = 0;
+        // Render State
         this.lastLinesUp = 0;
-        this.warnExperimental();
+        // Shell State
+        this.shell = 'bash';
+        this.strategies = {
+            bash: new curl_utils_1.BashStrategy(),
+            powershell: new curl_utils_1.PowerShellStrategy(),
+            cmd: new curl_utils_1.CmdStrategy()
+        };
+        // Auto-detect shell
+        if (process.platform === 'win32') {
+            this.shell = 'powershell';
+        }
         // Initialize state
         if (options.defaultMethod) {
             const idx = METHODS.indexOf(options.defaultMethod.toUpperCase());
             if (idx >= 0)
                 this.methodIndex = idx;
         }
-        this.url = options.defaultUrl || '';
-        this.urlCursor = this.url.length;
+        const initialUrl = options.defaultUrl || '';
+        this.urlSegments = (0, utils_1.safeSplit)(initialUrl);
+        this.urlCursor = this.urlSegments.length;
         this.headers = { ...options.defaultHeaders };
         this.body = options.defaultBody || '';
         // Auto-select URL if method is GET (default)
@@ -48,32 +69,36 @@ class CurlPrompt extends base_1.Prompt {
     get hasBody() {
         return this.currentMethod !== 'GET' && this.currentMethod !== 'HEAD';
     }
-    /**
-     * Escape a string for safe inclusion inside a double-quoted shell argument.
-     * This escapes backslashes first, then double quotes.
-     */
-    shellEscapeDoubleQuoted(value) {
-        return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    get url() {
+        return this.urlSegments.join('');
+    }
+    cycleShell() {
+        const shells = ['bash', 'powershell', 'cmd'];
+        const currentIdx = shells.indexOf(this.shell);
+        this.shell = shells[(currentIdx + 1) % shells.length];
+        this.render(false);
     }
-    generateCommand() {
-        let cmd = `curl -X ${this.currentMethod}`;
+    generateCommand(multiline = false) {
+        // Force single line for CMD
+        if (this.shell === 'cmd') {
+            multiline = false;
+        }
+        const strategy = this.strategies[this.shell];
+        const continuation = multiline ? `${strategy.continuation}\n  ` : ' ';
+        let cmd = `${strategy.binary} -X ${this.currentMethod}`;
         // Headers
         Object.entries(this.headers).forEach(([k, v]) => {
-            cmd += ` -H "${k}: ${v}"`;
+            cmd += `${continuation}-H ${strategy.escape(`${k}: ${v}`)}`;
         });
         // Body
         if (this.hasBody && this.body) {
-            // Escape body for shell
-            const escapedBody = this.shellEscapeDoubleQuoted(this.body);
-            cmd += ` -d "${escapedBody}"`;
+            const escapedBody = strategy.escape(this.body);
+            cmd += `${continuation}-d ${escapedBody}`;
         }
         // URL
-        if (this.url) {
-            cmd += ` "${this.url}"`;
-        }
-        else {
-            cmd += ` "http://localhost..."`;
-        }
+        const urlStr = this.url;
+        const displayUrl = urlStr || 'http://localhost...';
+        cmd += `${continuation}${strategy.escape(displayUrl)}`;
         return cmd;
     }
     render(firstRender) {
@@ -83,7 +108,8 @@ class CurlPrompt extends base_1.Prompt {
         this.lastLinesUp = 0;
         let output = '';
         // Title
-        output += `${theme_1.theme.success}? ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET}\n`;
+        const shellLabel = `${theme_1.theme.muted}[Shell: ${this.shell.toUpperCase()}]${ansi_1.ANSI.RESET}`;
+        output += `${theme_1.theme.success}? ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message} ${shellLabel}${ansi_1.ANSI.RESET}\n`;
         // 1. Method
         const methodLabel = this.section === Section.METHOD
             ? `${theme_1.theme.main}${ansi_1.ANSI.REVERSE} ${this.currentMethod} ${ansi_1.ANSI.RESET}`
@@ -92,16 +118,16 @@ class CurlPrompt extends base_1.Prompt {
         // 2. URL
         const urlActive = this.section === Section.URL;
         const urlPrefix = urlActive ? `${theme_1.theme.main}${ansi_1.ANSI.BOLD} URL: ${ansi_1.ANSI.RESET}` : ` URL: `;
-        let urlDisplay = this.url;
-        if (!urlDisplay && urlActive) {
+        let urlDisplay = '';
+        if (this.urlSegments.length === 0 && urlActive) {
+            // Placeholder/Empty state when active
+            urlDisplay = '';
+        }
+        else if (this.urlSegments.length === 0 && !urlActive) {
             urlDisplay = `${theme_1.theme.muted}http://localhost:3000${ansi_1.ANSI.RESET}`;
         }
-        // Insert cursor for URL
-        if (urlActive) {
-            const beforeCursor = urlDisplay.slice(0, this.urlCursor);
-            const atCursor = urlDisplay.slice(this.urlCursor, this.urlCursor + 1) || ' ';
-            const afterCursor = urlDisplay.slice(this.urlCursor + 1);
-            urlDisplay = `${beforeCursor}${theme_1.theme.main}${ansi_1.ANSI.UNDERLINE}${atCursor}${ansi_1.ANSI.RESET}${afterCursor}`;
+        else {
+            urlDisplay = this.urlSegments.join('');
         }
         output += `${urlPrefix}${urlDisplay}\n`;
         // 3. Headers
@@ -130,26 +156,39 @@ class CurlPrompt extends base_1.Prompt {
         }
         // Preview
         output += `\n${ansi_1.ANSI.BOLD}Preview:${ansi_1.ANSI.RESET}\n`;
-        const cmd = this.generateCommand();
+        // Use multiline mode for preview
+        const cmd = this.generateCommand(true);
         // Syntax highlight command (basic)
         output += `${ansi_1.ANSI.FG_CYAN}${cmd}${ansi_1.ANSI.RESET}\n`;
         // Instructions
-        output += `\n${theme_1.theme.muted}(Tab: Nav, Space: Toggle Method, Enter: Edit/Submit)${ansi_1.ANSI.RESET}`;
+        output += `\n${theme_1.theme.muted}(Tab: Nav, 's': Shell, Space: Toggle Method, Enter: Edit/Submit)${ansi_1.ANSI.RESET}`;
         this.renderFrame(output);
         // Cursor Positioning
         if (this.section === Section.URL) {
             const prefixLen = 6; // " URL: "
-            // We need to move cursor to (row 3, prefixLen + this.urlCursor)
-            const lines = output.split('\n');
-            const urlLineIndex = lines.findIndex(l => l.includes(' URL: '));
-            const linesFromBottom = lines.length - 1 - urlLineIndex;
-            this.print(ansi_1.ANSI.SHOW_CURSOR);
-            if (linesFromBottom > 0) {
-                this.print(`\x1b[${linesFromBottom}A`);
-                this.lastLinesUp = linesFromBottom;
+            // Use lastRenderLines to find the exact visual line index
+            let urlLineIndex = -1;
+            for (let i = 0; i < this.lastRenderLines.length; i++) {
+                if (this.lastRenderLines[i].includes(' URL: ')) {
+                    urlLineIndex = i;
+                    break;
+                }
+            }
+            if (urlLineIndex !== -1) {
+                const linesFromBottom = this.lastRenderLines.length - 1 - urlLineIndex;
+                this.print(ansi_1.ANSI.SHOW_CURSOR);
+                if (linesFromBottom > 0) {
+                    this.print(`\x1b[${linesFromBottom}A`);
+                    this.lastLinesUp = linesFromBottom;
+                }
+                // Calculate visual cursor position
+                let targetCol = prefixLen;
+                // Add width of segments up to cursor
+                for (let i = 0; i < this.urlCursor; i++) {
+                    targetCol += (0, utils_1.stringWidth)(this.urlSegments[i]);
+                }
+                this.print(`\r\x1b[${targetCol}C`);
             }
-            const targetCol = prefixLen + this.urlCursor;
-            this.print(`\r\x1b[${targetCol}C`);
         }
         else {
             this.print(ansi_1.ANSI.HIDE_CURSOR);
@@ -163,6 +202,11 @@ class CurlPrompt extends base_1.Prompt {
         super.cleanup();
     }
     handleInput(char, _buffer) {
+        // Toggle Shell (only when not editing URL)
+        if (char === 's' && this.section !== Section.URL) {
+            this.cycleShell();
+            return;
+        }
         // Navigation
         if (char === '\t') {
             this.cycleSection(1);
@@ -186,40 +230,11 @@ class CurlPrompt extends base_1.Prompt {
                     this.render(false);
                 }
                 else if (char === '\r' || char === '\n') {
-                    // Enter on Method -> Submit
                     this.submitResult();
                 }
                 break;
             case Section.URL:
-                if (char === '\r' || char === '\n') {
-                    this.submitResult();
-                    return;
-                }
-                // Typing
-                if (char === '\u0008' || char === '\x7f') { // Backspace
-                    if (this.urlCursor > 0) {
-                        this.url = this.url.slice(0, this.urlCursor - 1) + this.url.slice(this.urlCursor);
-                        this.urlCursor--;
-                        this.render(false);
-                    }
-                }
-                else if (this.isLeft(char)) {
-                    if (this.urlCursor > 0) {
-                        this.urlCursor--;
-                        this.render(false);
-                    }
-                }
-                else if (this.isRight(char)) {
-                    if (this.urlCursor < this.url.length) {
-                        this.urlCursor++;
-                        this.render(false);
-                    }
-                }
-                else if (!/^[\x00-\x1F]/.test(char)) {
-                    this.url = this.url.slice(0, this.urlCursor) + char + this.url.slice(this.urlCursor);
-                    this.urlCursor += char.length;
-                    this.render(false);
-                }
+                this.handleUrlInput(char);
                 break;
             case Section.HEADERS:
                 if (char === '\r' || char === '\n') {
@@ -233,36 +248,139 @@ class CurlPrompt extends base_1.Prompt {
                 break;
         }
     }
+    handleUrlInput(char) {
+        // Submit
+        if (char === '\r' || char === '\n') {
+            this.submitResult();
+            return;
+        }
+        // Home
+        if (char === '\x1b[H' || char === '\x1bOH' || char === '\x1b[1~') {
+            this.urlCursor = 0;
+            this.render(false);
+            return;
+        }
+        // End
+        if (char === '\x1b[F' || char === '\x1bOF' || char === '\x1b[4~') {
+            this.urlCursor = this.urlSegments.length;
+            this.render(false);
+            return;
+        }
+        // Ctrl+U (Delete to start)
+        if (char === '\x15') {
+            if (this.urlCursor > 0) {
+                this.urlSegments.splice(0, this.urlCursor);
+                this.urlCursor = 0;
+                this.render(false);
+            }
+            return;
+        }
+        // Ctrl+W (Delete word backwards)
+        if (char === '\x17') {
+            if (this.urlCursor > 0) {
+                // Find previous word boundary
+                let i = this.urlCursor - 1;
+                // Skip trailing spaces
+                while (i >= 0 && this.urlSegments[i] === ' ')
+                    i--;
+                // Skip word characters
+                while (i >= 0 && this.urlSegments[i] !== ' ')
+                    i--;
+                const deleteCount = this.urlCursor - (i + 1);
+                this.urlSegments.splice(i + 1, deleteCount);
+                this.urlCursor = i + 1;
+                this.render(false);
+            }
+            return;
+        }
+        // Backspace
+        if (char === '\u0008' || char === '\x7f') {
+            if (this.urlCursor > 0) {
+                this.urlSegments.splice(this.urlCursor - 1, 1);
+                this.urlCursor--;
+                this.render(false);
+            }
+            return;
+        }
+        // Delete
+        if (char === '\u001b[3~') {
+            if (this.urlCursor < this.urlSegments.length) {
+                this.urlSegments.splice(this.urlCursor, 1);
+                this.render(false);
+            }
+            return;
+        }
+        // Left
+        if (this.isLeft(char)) {
+            if (this.urlCursor > 0) {
+                this.urlCursor--;
+                this.render(false);
+            }
+            return;
+        }
+        // Right
+        if (this.isRight(char)) {
+            if (this.urlCursor < this.urlSegments.length) {
+                this.urlCursor++;
+                this.render(false);
+            }
+            return;
+        }
+        // Regular Typing
+        if (!/^[\x00-\x1F]/.test(char) && !char.startsWith('\x1b')) {
+            const newSegments = (0, utils_1.safeSplit)(char);
+            this.urlSegments.splice(this.urlCursor, 0, ...newSegments);
+            this.urlCursor += newSegments.length;
+            this.render(false);
+        }
+    }
     cycleSection(direction) {
-        // Logic to skip disabled Body
         let next = this.section + direction;
-        // Loop
         if (next > Section.BODY)
             next = Section.METHOD;
         if (next < Section.METHOD)
             next = Section.BODY;
-        // If Body is disabled and we landed on it
         if (next === Section.BODY && !this.hasBody) {
             next = direction === 1 ? Section.METHOD : Section.HEADERS;
         }
         this.section = next;
     }
+    clear() {
+        // 1. Restore cursor to bottom if it was moved up (for URL editing)
+        if (this.lastLinesUp > 0) {
+            this.print(`\x1b[${this.lastLinesUp}B`);
+            this.lastLinesUp = 0;
+        }
+        // 2. Erase the prompt content
+        // We move up (height - 1) lines to the top line, then erase everything below
+        if (this.lastRenderHeight > 0) {
+            this.print(`\x1b[${this.lastRenderHeight - 1}A`); // Go to top line
+            this.print('\r'); // Go to start of line
+            this.print(ansi_1.ANSI.ERASE_DOWN); // Erase everything below
+            // Reset state so next render is treated as fresh
+            this.lastRenderLines = [];
+            this.lastRenderHeight = 0;
+        }
+    }
     async editHeaders() {
+        this.clear(); // Clear UI to prevent artifacts
         this.pauseInput();
         try {
             const result = await new map_1.MapPrompt({
                 message: 'Edit Headers',
                 initial: this.headers,
+                suggestions: COMMON_HEADERS
             }).run();
             this.headers = result;
         }
         catch (_e) {
-            // Cancelled or error
+            // Cancelled
         }
         this.resumeInput();
-        this.render(false); // Re-render our UI
+        this.render(true); // Force full re-render
     }
     async editBody() {
+        this.clear(); // Clear UI to prevent artifacts
         this.pauseInput();
         try {
             const result = await new code_1.CodePrompt({
@@ -277,7 +395,7 @@ class CurlPrompt extends base_1.Prompt {
             // Cancelled
         }
         this.resumeInput();
-        this.render(false);
+        this.render(true); // Force full re-render
     }
     submitResult() {
         this.submit({
@@ -285,7 +403,7 @@ class CurlPrompt extends base_1.Prompt {
             url: this.url,
             headers: this.headers,
             body: this.hasBody ? this.body : undefined,
-            command: this.generateCommand()
+            command: this.generateCommand(false) // Single line for clipboard/usage
         });
     }
 }

package/dist/prompts/exec.d.ts

@@ -4,8 +4,12 @@ export declare class ExecPrompt extends Prompt<void, ExecOptions> {
     private child?;
     private status;
     private timer?;
+    private stdoutBuffer;
+    private stderrBuffer;
+    private lastLogLine;
     constructor(options: ExecOptions);
     run(): Promise<void>;
+    private updateLastLogLine;
     private killChild;
     protected cleanup(): void;
     protected render(_firstRender: boolean): void;

package/dist/prompts/exec.js

@@ -10,20 +10,42 @@ class ExecPrompt extends base_1.Prompt {
     constructor(options) {
         super(options);
         this.status = 'running';
-        this.warnExperimental();
+        this.stdoutBuffer = '';
+        this.stderrBuffer = '';
+        this.lastLogLine = '';
+        // Experimental warning removed
     }
     run() {
         this.child = (0, child_process_1.spawn)(this.options.command, [], {
             cwd: this.options.cwd || process.cwd(),
             shell: true,
-            stdio: this.options.streamOutput ? 'inherit' : 'ignore'
+            // Use 'ignore' for stdin so parent keeps control (and raw mode).
+            // Use 'pipe' for stdout/stderr to capture output.
+            stdio: ['ignore', 'pipe', 'pipe']
         });
+        // Capture stdout
+        if (this.child.stdout) {
+            this.child.stdout.on('data', (data) => {
+                const chunk = data.toString();
+                this.stdoutBuffer += chunk;
+                this.updateLastLogLine(chunk);
+            });
+        }
+        // Capture stderr
+        if (this.child.stderr) {
+            this.child.stderr.on('data', (data) => {
+                const chunk = data.toString();
+                this.stderrBuffer += chunk;
+                this.updateLastLogLine(chunk);
+            });
+        }
         if (this.options.timeout && this.options.timeout > 0) {
             this.timer = setTimeout(() => {
                 if (this.status !== 'running')
                     return;
                 this.status = 'error';
                 this.render(false);
+                this.killChild();
                 this.cancel(new Error(`Timeout after ${this.options.timeout}ms`));
             }, this.options.timeout);
         }
@@ -38,7 +60,15 @@ class ExecPrompt extends base_1.Prompt {
             else {
                 this.status = 'error';
                 this.render(false);
-                this.cancel(new Error(`Command failed with exit code ${code}`));
+                const errorMessage = this.stderrBuffer.trim() || `Command failed with exit code ${code}`;
+                const err = new Error(errorMessage);
+                // Attach details
+                Object.assign(err, {
+                    code,
+                    stdout: this.stdoutBuffer,
+                    stderr: this.stderrBuffer
+                });
+                this.cancel(err);
             }
         });
         this.child.on('error', (err) => {
@@ -50,6 +80,19 @@ class ExecPrompt extends base_1.Prompt {
         });
         return super.run();
     }
+    updateLastLogLine(chunk) {
+        // We only want the last non-empty line
+        const lines = chunk.split('\n');
+        // Iterate backwards
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const line = lines[i].trim();
+            if (line) {
+                this.lastLogLine = line;
+                this.render(false);
+                break;
+            }
+        }
+    }
     killChild() {
         if (this.child && !this.child.killed) {
             this.child.kill();
@@ -73,11 +116,22 @@ class ExecPrompt extends base_1.Prompt {
         else if (this.status === 'error') {
             symbol = theme_1.theme.error + symbols_1.symbols.cross + ansi_1.ANSI.RESET;
         }
-        const output = `${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${symbol}`;
+        let details = '';
+        if (this.status === 'running' && this.lastLogLine) {
+            // Truncate for display
+            const maxLen = 50;
+            let line = this.stripAnsi(this.lastLogLine);
+            if (line.length > maxLen) {
+                line = line.substring(0, maxLen - 3) + '...';
+            }
+            details = ` ${theme_1.theme.muted}${line}${ansi_1.ANSI.RESET}`;
+        }
+        const output = `${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${symbol}${details}`;
         this.renderFrame(output);
     }
     handleInput(_char, _key) {
-        // Ignore input
+        // Prompt base class handles Ctrl+C (SIGINT) in _onKeyHandler
+        // which calls cleanup() -> killChild().
     }
 }
 exports.ExecPrompt = ExecPrompt;

package/dist/prompts/map.d.ts

@@ -7,9 +7,11 @@ export declare class MapPrompt extends Prompt<Record<string, string>, MapOptions
     private scrollTop;
     private readonly pageSize;
     private errorMsg;
+    private ghost;
     constructor(options: MapOptions);
     protected render(_firstRender: boolean): void;
     private pad;
+    private updateGhost;
     protected handleInput(char: string): void;
     protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/map.js

@@ -15,6 +15,7 @@ class MapPrompt extends base_1.Prompt {
         this.scrollTop = 0;
         this.pageSize = 7;
         this.errorMsg = '';
+        this.ghost = '';
         if (options.initial) {
             this.items = Object.entries(options.initial).map(([key, value]) => ({ key, value }));
         }
@@ -29,7 +30,11 @@ class MapPrompt extends base_1.Prompt {
         output += `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET}\n`;
         // Layout Calculation
         const maxKeyWidth = Math.max(5, // Minimum width
-        ...this.items.map(item => (0, utils_1.stringWidth)(item.key))) + 2; // Padding
+        ...this.items.map((item, idx) => {
+            // Include ghost length in calculation if it's the active row
+            const ghostLen = (idx === this.rowIndex && this.colIndex === 0) ? (0, utils_1.stringWidth)(this.ghost) : 0;
+            return (0, utils_1.stringWidth)(item.key) + ghostLen;
+        })) + 2; // Padding
         // Scrolling Logic
         if (this.rowIndex < this.scrollTop) {
             this.scrollTop = this.rowIndex;
@@ -53,11 +58,16 @@ class MapPrompt extends base_1.Prompt {
             const pointer = isRowActive ? `${theme_1.theme.main}${symbols_1.symbols.pointer}${ansi_1.ANSI.RESET} ` : '  ';
             // Render Key
             let keyStr = item.key;
+            let ghostStr = '';
             if (isRowActive && this.colIndex === 0) {
-                keyStr = `${theme_1.theme.main}${ansi_1.ANSI.UNDERLINE}${keyStr}${ansi_1.ANSI.RESET}`;
+                if (this.ghost) {
+                    ghostStr = `${theme_1.theme.muted}${this.ghost}${ansi_1.ANSI.RESET}`;
+                }
+                keyStr = `${theme_1.theme.main}${ansi_1.ANSI.UNDERLINE}${keyStr}${ansi_1.ANSI.RESET}${ghostStr}`;
             }
-            // Adjust padding manually because ANSI codes mess up simple padEnd
-            const keyVisualWidth = (0, utils_1.stringWidth)(item.key);
+            // Adjust padding manually
+            // We need visual width of key + ghost (if active)
+            const keyVisualWidth = (0, utils_1.stringWidth)(item.key) + (isRowActive && this.colIndex === 0 ? (0, utils_1.stringWidth)(this.ghost) : 0);
             const padding = ' '.repeat(Math.max(0, maxKeyWidth - keyVisualWidth));
             // Render Value
             let valStr = item.value;
@@ -79,12 +89,41 @@ class MapPrompt extends base_1.Prompt {
             return str;
         return str + ' '.repeat(width - len);
     }
+    updateGhost() {
+        this.ghost = '';
+        if (this.colIndex !== 0 || !this.options.suggestions)
+            return;
+        const currentKey = this.items[this.rowIndex].key;
+        if (!currentKey)
+            return;
+        const lowerKey = currentKey.toLowerCase();
+        // Find first match
+        const match = this.options.suggestions.find(s => s.toLowerCase().startsWith(lowerKey) && s.length > currentKey.length);
+        if (match) {
+            this.ghost = match.slice(currentKey.length);
+        }
+    }
     handleInput(char) {
         this.errorMsg = '';
+        // Tab (Accept Suggestion) or Toggle Column
+        if (char === '\t') {
+            if (this.colIndex === 0 && this.ghost) {
+                this.items[this.rowIndex].key += this.ghost;
+                this.ghost = '';
+                this.render(false);
+                return;
+            }
+            // Standard Tab behavior (toggle column)
+            this.colIndex = this.colIndex === 0 ? 1 : 0;
+            this.ghost = ''; // Clear ghost when changing columns
+            this.render(false);
+            return;
+        }
         // Navigation
         if (this.isUp(char)) {
             if (this.rowIndex > 0)
                 this.rowIndex--;
+            this.ghost = '';
             this.render(false);
             return;
         }
@@ -96,28 +135,28 @@ class MapPrompt extends base_1.Prompt {
                 // Down at last row adds new row
                 this.items.push({ key: '', value: '' });
                 this.rowIndex++;
-                this.colIndex = 0; // Optional: Reset to Key col when creating new row
+                this.colIndex = 0;
             }
+            this.ghost = '';
             this.render(false);
             return;
         }
-        if (char === '\t' || this.isRight(char) || this.isLeft(char)) {
-            // Toggle column
+        if (this.isRight(char) || this.isLeft(char)) {
             this.colIndex = this.colIndex === 0 ? 1 : 0;
+            this.ghost = '';
             this.render(false);
             return;
         }
         // CRUD
-        // Ctrl+N (Standard ASCII for Ctrl+N is \x0e)
-        if (char === '\x0e') {
+        if (char === '\x0e') { // Ctrl+N
             this.items.push({ key: '', value: '' });
             this.rowIndex = this.items.length - 1;
             this.colIndex = 0;
+            this.ghost = '';
             this.render(false);
             return;
         }
-        // Ctrl+D (Standard ASCII for Ctrl+D is \x04)
-        if (char === '\x04') {
+        if (char === '\x04') { // Ctrl+D
             if (this.items.length > 1) {
                 this.items.splice(this.rowIndex, 1);
                 if (this.rowIndex >= this.items.length) {
@@ -125,9 +164,9 @@ class MapPrompt extends base_1.Prompt {
                 }
             }
             else {
-                // Clear the last remaining item instead of deleting it
                 this.items[0] = { key: '', value: '' };
             }
+            this.ghost = '';
             this.render(false);
             return;
         }
@@ -157,8 +196,13 @@ class MapPrompt extends base_1.Prompt {
         if (char === '\u0008' || char === '\x7f') {
             const item = this.items[this.rowIndex];
             if (this.colIndex === 0) {
-                if (item.key.length > 0)
+                if (item.key.length > 0) {
                     item.key = item.key.slice(0, -1);
+                    this.updateGhost();
+                }
+                else {
+                    this.ghost = '';
+                }
             }
             else {
                 if (item.value.length > 0)
@@ -172,6 +216,7 @@ class MapPrompt extends base_1.Prompt {
             const item = this.items[this.rowIndex];
             if (this.colIndex === 0) {
                 item.key += char;
+                this.updateGhost();
             }
             else {
                 item.value += char;
@@ -184,12 +229,14 @@ class MapPrompt extends base_1.Prompt {
             if (event.scroll === 'up') {
                 if (this.rowIndex > 0) {
                     this.rowIndex--;
+                    this.ghost = '';
                     this.render(false);
                 }
             }
             else if (event.scroll === 'down') {
                 if (this.rowIndex < this.items.length - 1) {
                     this.rowIndex++;
+                    this.ghost = '';
                     this.render(false);
                 }
             }

package/dist/types.d.ts

@@ -236,6 +236,7 @@ export interface CalendarOptions extends BaseOptions {
 }
 export interface MapOptions extends BaseOptions {
     initial?: Record<string, string>;
+    suggestions?: string[];
 }
 export interface SemVerOptions extends BaseOptions {
     currentVersion: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mepcli",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Zero-dependency, interactive CLI prompt",
   "repository": {
     "type": "git",