mepcli 1.4.0 → 2.0.0-beta.2

package/README.md

@@ -3,7 +3,7 @@
 
 <p align="center">
   <sub>(Mep <a href="examples/basic-prompts.ts">Basic Prompts</a>)</a></sub>
-  <img src="https://raw.githubusercontent.com/CodeTease/mep/refs/heads/dev/media/basic.gif" alt="Enquirer Survey Prompt" width="750">
+  <img src="https://raw.githubusercontent.com/CodeTease/mep/refs/heads/main/media/basic.gif" alt="Enquirer Survey Prompt" width="750">
 
 **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.
 
@@ -25,12 +25,21 @@ For comprehensive guides, API references, and advanced usage, please visit the *
 
 ## Installation
 
+Via NPM:
 ```sh
 npm install mepcli
-# or
+```
+
+Via Yarn:
+```sh
 yarn add mepcli
 ```
 
+Via Bun:
+```sh
+bun add mepcli
+```
+
 ## Quick Start
 
 ```typescript
@@ -206,20 +215,42 @@ tasks.success('download', 'Downloaded');
 tasks.stop();
 ```
 
-## Pipeline (Workflow Engine) <sub style="color:orange">(Experimental)</sub>
+## Pipeline (Workflow Engine)
 
-The **Pipeline** API allows you to orchestrate a sequence of prompts that share a common context. It follows the **Enter-and-Forget** philosophy (exceptions stop the flow) and uses a fluent Builder pattern.
+Pipelines provide a powerful, sequential workflow engine. Based on the philosophy of **Enter-and-Forget (EAF)**, **Zero-Dependency**, and **Method Chaining**, Pipelines allow you to chain actions, prompts, and tasks sequentially, accumulating their results into a Context object.
 
 ```typescript
-const result = await MepCLI.pipeline()
-    .step('name', () => MepCLI.text({ message: 'Name:' }))
+import { MepCLI, Pipeline } from 'mepcli';
+import { z } from 'zod';
+
+interface Context {
+    name: string;
+    age: number;
+    email?: string;
+    parentalConsent?: boolean;
+}
+
+const result = await new Pipeline<Context>()
+    .step('name', async () => {
+        return await MepCLI.text({ message: 'What is your name?' });
+    }, {
+        validate: (val) => val.length > 0 || 'Name is required'
+    })
+    .step('age', async () => {
+        return await MepCLI.number({ message: 'How old are you?' });
+    }, {
+        transform: (val) => Number(val),
+        validate: z.number().min(0, "Age must be positive")
+    })
     .stepIf(
-        (ctx) => ctx.name === 'admin', 
-        'role', 
-        () => MepCLI.select({ 
-            message: 'Role:', 
-            choices: ['SuperUser', 'Maintainer'] 
-        })
+        (ctx) => ctx.age < 18,
+        'parentalConsent',
+        async () => {
+            return await MepCLI.confirm({ message: 'Do you have parental consent?' });
+        },
+        {
+            validate: (val) => val === true || 'Parental consent is required'
+        }
     )
     .run();
 ```

package/dist/{ansi.js → src/ansi.js}

@@ -1,11 +1,17 @@
-"use strict";
 /**
  * ANSI Escape Codes
  * Manual definitions to maintain zero-dependency status.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ANSI = void 0;
-exports.ANSI = {
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ANSI", {
+    enumerable: true,
+    get: function() {
+        return ANSI;
+    }
+});
+const ANSI = {
     RESET: '\x1b[0m',
     BOLD: '\x1b[1m',
     DIM: '\x1b[2m',
@@ -28,9 +34,9 @@ exports.ANSI = {
     BG_GREEN: '\x1b[42m',
     BG_RED: '\x1b[41m',
     // Cursor & Erasing
-    ERASE_LINE: '\x1b[2K', // Clear current line
-    ERASE_DOWN: '\x1b[J', // Clear from cursor to end of screen
-    CURSOR_LEFT: '\x1b[1000D', // Move cursor to start of line
+    ERASE_LINE: '\x1b[2K',
+    ERASE_DOWN: '\x1b[J',
+    CURSOR_LEFT: '\x1b[1000D',
     HIDE_CURSOR: '\x1b[?25l',
     SHOW_CURSOR: '\x1b[?25h',
     UP: '\x1b[A',
@@ -38,5 +44,7 @@ exports.ANSI = {
     // Mouse Tracking (SGR Protocol)
     SET_ANY_EVENT_MOUSE: '\x1b[?1003h',
     SET_SGR_EXT_MODE_MOUSE: '\x1b[?1006h',
-    DISABLE_MOUSE: '\x1b[?1003l\x1b[?1006l',
+    DISABLE_MOUSE: '\x1b[?1003l\x1b[?1006l'
 };
+
+//# sourceMappingURL=ansi.js.map

package/dist/src/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ansi.ts"],"sourcesContent":["/**\n * ANSI Escape Codes\n * Manual definitions to maintain zero-dependency status.\n */\n\nexport const ANSI = {\n    RESET: '\\x1b[0m',\n    BOLD: '\\x1b[1m',\n    DIM: '\\x1b[2m',\n    ITALIC: '\\x1b[3m',\n    UNDERLINE: '\\x1b[4m',\n    REVERSE: '\\x1b[7m',\n\n    // Colors\n    FG_GREEN: '\\x1b[32m',\n    FG_CYAN: '\\x1b[36m',\n    FG_YELLOW: '\\x1b[33m',\n    FG_RED: '\\x1b[31m',\n    FG_GRAY: '\\x1b[90m',\n    FG_WHITE: '\\x1b[37m',\n    FG_BLUE: '\\x1b[34m',\n    FG_MAGENTA: '\\x1b[35m',\n    FG_BLACK: '\\x1b[30m',\n\n    BG_YELLOW: '\\x1b[43m',\n    BG_BLUE: '\\x1b[44m',\n    BG_CYAN: '\\x1b[46m',\n    BG_GREEN: '\\x1b[42m',\n    BG_RED: '\\x1b[41m',\n\n    // Cursor & Erasing\n    ERASE_LINE: '\\x1b[2K',      // Clear current line\n    ERASE_DOWN: '\\x1b[J',       // Clear from cursor to end of screen\n    CURSOR_LEFT: '\\x1b[1000D',  // Move cursor to start of line\n    HIDE_CURSOR: '\\x1b[?25l',\n    SHOW_CURSOR: '\\x1b[?25h',\n    UP: '\\x1b[A',\n    DOWN: '\\x1b[B',\n\n    // Mouse Tracking (SGR Protocol)\n    SET_ANY_EVENT_MOUSE: '\\x1b[?1003h',\n    SET_SGR_EXT_MODE_MOUSE: '\\x1b[?1006h',\n    DISABLE_MOUSE: '\\x1b[?1003l\\x1b[?1006l',\n};\n"],"names":["ANSI","RESET","BOLD","DIM","ITALIC","UNDERLINE","REVERSE","FG_GREEN","FG_CYAN","FG_YELLOW","FG_RED","FG_GRAY","FG_WHITE","FG_BLUE","FG_MAGENTA","FG_BLACK","BG_YELLOW","BG_BLUE","BG_CYAN","BG_GREEN","BG_RED","ERASE_LINE","ERASE_DOWN","CURSOR_LEFT","HIDE_CURSOR","SHOW_CURSOR","UP","DOWN","SET_ANY_EVENT_MOUSE","SET_SGR_EXT_MODE_MOUSE","DISABLE_MOUSE"],"mappings":"AAAA;;;CAGC;;;;+BAEYA;;;eAAAA;;;AAAN,MAAMA,OAAO;IAChBC,OAAO;IACPC,MAAM;IACNC,KAAK;IACLC,QAAQ;IACRC,WAAW;IACXC,SAAS;IAET,SAAS;IACTC,UAAU;IACVC,SAAS;IACTC,WAAW;IACXC,QAAQ;IACRC,SAAS;IACTC,UAAU;IACVC,SAAS;IACTC,YAAY;IACZC,UAAU;IAEVC,WAAW;IACXC,SAAS;IACTC,SAAS;IACTC,UAAU;IACVC,QAAQ;IAER,mBAAmB;IACnBC,YAAY;IACZC,YAAY;IACZC,aAAa;IACbC,aAAa;IACbC,aAAa;IACbC,IAAI;IACJC,MAAM;IAEN,gCAAgC;IAChCC,qBAAqB;IACrBC,wBAAwB;IACxBC,eAAe;AACnB"}

package/dist/{base.js → src/base.js}

@@ -1,54 +1,57 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Prompt = void 0;
-const ansi_1 = require("./ansi");
-const input_1 = require("./input");
-const utils_1 = require("./utils");
-/**
- * Abstract base class for all prompts.
- * Implements a Robust Linear Scan Diffing Engine.
- */
-class Prompt {
-    constructor(options) {
-        this.lastRenderLines = [];
-        this.lastRenderHeight = 0;
-        this.options = options;
-        this.stdin = process.stdin;
-        this.stdout = process.stdout;
-        this._inputParser = new input_1.InputParser();
-        this.capabilities = (0, utils_1.detectCapabilities)();
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "Prompt", {
+    enumerable: true,
+    get: function() {
+        return Prompt;
     }
+});
+const _ansi = require("./ansi");
+const _input = require("./input");
+const _utils = require("./utils");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let Prompt = class Prompt {
     /**
      * Checks if running on Windows and logs a warning message once per component type.
      * Call this in the constructor of problematic prompts.
-     */
-    checkWindowsAttention() {
+     */ checkWindowsAttention() {
         const componentName = this.constructor.name;
         // Check platform and if already warned
         if (process.platform === 'win32' && !Prompt.warnedComponents.has(componentName)) {
-            console.warn(`${ansi_1.ANSI.FG_YELLOW}Warning:${ansi_1.ANSI.RESET} ${componentName} may hang on Windows TTY after multiple cycles. ` +
-                `Press 'Enter' if unresponsive.`);
+            console.warn(`${_ansi.ANSI.FG_YELLOW}Warning:${_ansi.ANSI.RESET} ${componentName} may hang on Windows TTY after multiple cycles. ` + `Press 'Enter' if unresponsive.`);
             Prompt.warnedComponents.add(componentName);
         }
     }
     /**
      * Warn about experimental prompts.
      * Call this in the constructor of experimental prompts.
-     */
-    warnExperimental() {
+     */ warnExperimental() {
         const componentName = this.constructor.name;
         if (!Prompt.warnedComponents.has(componentName)) {
-            console.warn(`${ansi_1.ANSI.FG_YELLOW}Warning:${ansi_1.ANSI.RESET} ${componentName} is an experimental prompt and may have bugs or unexpected behavior. ` +
-                `Use with caution.`);
+            console.warn(`${_ansi.ANSI.FG_YELLOW}Warning:${_ansi.ANSI.RESET} ${componentName} is an experimental prompt and may have bugs or unexpected behavior. ` + `Use with caution.`);
             Prompt.warnedComponents.add(componentName);
         }
     }
-    handleMouse(_event) { }
+    handleMouse(_event) {}
     print(text) {
         this.stdout.write(text);
     }
     run() {
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve, reject)=>{
             this._resolve = resolve;
             this._reject = reject;
             if (typeof this.stdin.setRawMode === 'function') {
@@ -58,26 +61,25 @@ class Prompt {
             this.stdin.setEncoding('utf8');
             const shouldEnableMouse = this.options.mouse !== false && this.capabilities.hasMouse;
             if (shouldEnableMouse) {
-                this.print(ansi_1.ANSI.SET_ANY_EVENT_MOUSE + ansi_1.ANSI.SET_SGR_EXT_MODE_MOUSE);
+                this.print(_ansi.ANSI.SET_ANY_EVENT_MOUSE + _ansi.ANSI.SET_SGR_EXT_MODE_MOUSE);
             }
-            this.print(ansi_1.ANSI.HIDE_CURSOR);
+            this.print(_ansi.ANSI.HIDE_CURSOR);
             // Initial render
             this.render(true);
-            this._onKeyHandler = (char, buffer) => {
-                if (char === '\u0003') { // Ctrl+C
+            this._onKeyHandler = (char, buffer)=>{
+                if (char === '\u0003') {
                     this.cleanup();
-                    this.print(ansi_1.ANSI.SHOW_CURSOR + '\n');
-                    if (this._reject)
-                        this._reject(new Error('User force closed'));
+                    this.print(_ansi.ANSI.SHOW_CURSOR + '\n');
+                    if (this._reject) this._reject(new Error('User force closed'));
                     return;
                 }
                 this.handleInput(char, buffer);
             };
             this._inputParser.on('keypress', this._onKeyHandler);
-            this._inputParser.on('mouse', (event) => {
+            this._inputParser.on('mouse', (event)=>{
                 this.handleMouse(event);
             });
-            this._onDataHandler = (buffer) => {
+            this._onDataHandler = (buffer)=>{
                 this._inputParser.feed(buffer);
             };
             this.stdin.on('data', this._onDataHandler);
@@ -86,8 +88,7 @@ class Prompt {
     /**
      * Pauses the input stream and removes listeners.
      * Useful for yielding control to child processes.
-     */
-    pauseInput() {
+     */ pauseInput() {
         if (this._onDataHandler) {
             this.stdin.removeListener('data', this._onDataHandler);
         }
@@ -98,8 +99,7 @@ class Prompt {
     }
     /**
      * Resumes the input stream and re-attaches listeners.
-     */
-    resumeInput() {
+     */ resumeInput() {
         if (typeof this.stdin.setRawMode === 'function') {
             this.stdin.setRawMode(true);
         }
@@ -115,34 +115,31 @@ class Prompt {
         if (this._onKeyHandler) {
             this._inputParser.removeListener('keypress', this._onKeyHandler);
         }
-        this.print(ansi_1.ANSI.DISABLE_MOUSE);
+        this.print(_ansi.ANSI.DISABLE_MOUSE);
         if (typeof this.stdin.setRawMode === 'function') {
             this.stdin.setRawMode(false);
         }
         this.stdin.pause();
-        this.print(ansi_1.ANSI.SHOW_CURSOR);
+        this.print(_ansi.ANSI.SHOW_CURSOR);
     }
     submit(result) {
         this.cleanup();
         this.print('\n');
-        if (this._resolve)
-            this._resolve(result);
+        if (this._resolve) this._resolve(result);
     }
     cancel(reason) {
         this.cleanup();
         this.print('\n');
-        if (this._reject)
-            this._reject(reason);
+        if (this._reject) this._reject(reason);
     }
     /**
      * Renders the frame using a linear scan diffing algorithm.
      * Prevents flicker and handles height changes (expand/collapse) robustly.
-     */
-    renderFrame(content) {
+     */ renderFrame(content) {
         const width = this.stdout.columns || 80;
         const rawLines = content.split('\n');
         // Truncate lines to prevent wrapping artifacts
-        const newLines = rawLines.map(line => this.truncate(line, width));
+        const newLines = rawLines.map((line)=>this.truncate(line, width));
         // 1. First Render Case
         if (this.lastRenderLines.length === 0) {
             this.print(newLines.join('\n'));
@@ -157,7 +154,7 @@ class Prompt {
         }
         outputBuffer += '\r'; // Ensure column 0
         // 3. Linear Scan & Update
-        for (let i = 0; i < newLines.length; i++) {
+        for(let i = 0; i < newLines.length; i++){
             const newLine = newLines[i];
             // Logic for moving to the next line
             if (i > 0) {
@@ -165,8 +162,7 @@ class Prompt {
                     // Moving within the previously existing area.
                     // Use 'Down' (B) to avoid scrolling/shifting existing content.
                     outputBuffer += '\x1b[B\r';
-                }
-                else {
+                } else {
                     // Moving into NEW area (Append).
                     // Must use '\n' to create the new line.
                     outputBuffer += '\n';
@@ -177,10 +173,9 @@ class Prompt {
                 const oldLine = this.lastRenderLines[i];
                 if (newLine !== oldLine) {
                     // Overwrite existing line
-                    outputBuffer += ansi_1.ANSI.ERASE_LINE + newLine;
+                    outputBuffer += _ansi.ANSI.ERASE_LINE + newLine;
                 }
-            }
-            else {
+            } else {
                 // Print new line (we are already at start due to '\n' above)
                 outputBuffer += newLine;
             }
@@ -190,7 +185,7 @@ class Prompt {
             // Move down to the first obsolete line
             outputBuffer += '\n';
             // Clear everything below
-            outputBuffer += ansi_1.ANSI.ERASE_DOWN;
+            outputBuffer += _ansi.ANSI.ERASE_DOWN;
             // Move back up to the last valid line to maintain cursor state consistency
             outputBuffer += `\x1b[A`;
         }
@@ -200,19 +195,18 @@ class Prompt {
         this.lastRenderHeight = newLines.length;
     }
     stripAnsi(str) {
-        return (0, utils_1.stripAnsi)(str);
+        return (0, _utils.stripAnsi)(str);
     }
     truncate(str, width) {
-        const visualWidth = (0, utils_1.stringWidth)(str);
+        const visualWidth = (0, _utils.stringWidth)(str);
         if (visualWidth <= width) {
             return str;
         }
         let currentWidth = 0;
         let cutIndex = 0;
         let inAnsi = false;
-        for (let i = 0; i < str.length; i++) {
-            if (str[i] === '\x1b')
-                inAnsi = true;
+        for(let i = 0; i < str.length; i++){
+            if (str[i] === '\x1b') inAnsi = true;
             if (!inAnsi) {
                 const code = str.charCodeAt(i);
                 const charWidth = code > 255 ? 2 : 1;
@@ -220,14 +214,12 @@ class Prompt {
                     break;
                 }
                 currentWidth += charWidth;
-            }
-            else {
-                if (str[i] === 'm' || (str[i] >= 'A' && str[i] <= 'Z'))
-                    inAnsi = false;
+            } else {
+                if (str[i] === 'm' || str[i] >= 'A' && str[i] <= 'Z') inAnsi = false;
             }
             cutIndex = i + 1;
         }
-        return str.substring(0, cutIndex) + '...' + ansi_1.ANSI.RESET;
+        return str.substring(0, cutIndex) + '...' + _ansi.ANSI.RESET;
     }
     isUp(char) {
         return char === '\u001b[A' || char === '\u001bOA';
@@ -241,6 +233,26 @@ class Prompt {
     isLeft(char) {
         return char === '\u001b[D' || char === '\u001bOD';
     }
-}
-exports.Prompt = Prompt;
-Prompt.warnedComponents = new Set();
+    constructor(options){
+        _define_property(this, "options", void 0);
+        _define_property(this, "value", void 0);
+        _define_property(this, "stdin", void 0);
+        _define_property(this, "stdout", void 0);
+        _define_property(this, "_resolve", void 0);
+        _define_property(this, "_reject", void 0);
+        _define_property(this, "_inputParser", void 0);
+        _define_property(this, "_onKeyHandler", void 0);
+        _define_property(this, "_onDataHandler", void 0);
+        _define_property(this, "lastRenderLines", []);
+        _define_property(this, "lastRenderHeight", 0);
+        _define_property(this, "capabilities", void 0);
+        this.options = options;
+        this.stdin = process.stdin;
+        this.stdout = process.stdout;
+        this._inputParser = new _input.InputParser();
+        this.capabilities = (0, _utils.detectCapabilities)();
+    }
+};
+_define_property(Prompt, "warnedComponents", new Set());
+
+//# sourceMappingURL=base.js.map

package/dist/src/base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/base.ts"],"sourcesContent":["import { ANSI } from './ansi';\nimport { InputParser } from './input';\nimport { BaseOptions, MouseEvent } from './types';\nimport { detectCapabilities, stringWidth, stripAnsi } from './utils';\n\n/**\n * Abstract base class for all prompts.\n * Implements a Robust Linear Scan Diffing Engine.\n */\nexport abstract class Prompt<T, O> {\n    protected options: O;\n    protected value: any;\n    protected stdin: NodeJS.ReadStream;\n    protected stdout: NodeJS.WriteStream;\n    private _resolve?: (value: T | PromiseLike<T>) => void;\n    private _reject?: (reason?: any) => void;\n    private _inputParser: InputParser;\n    private _onKeyHandler?: (char: string, key: Buffer) => void;\n    private _onDataHandler?: (chunk: Buffer) => void;\n    private static warnedComponents = new Set<string>();\n\n    protected lastRenderLines: string[] = [];\n    protected lastRenderHeight: number = 0;\n\n    protected capabilities: ReturnType<typeof detectCapabilities>;\n\n    constructor(options: O) {\n        this.options = options;\n        this.stdin = process.stdin;\n        this.stdout = process.stdout;\n        this._inputParser = new InputParser();\n        this.capabilities = detectCapabilities();\n    }\n\n    /**\n     * Checks if running on Windows and logs a warning message once per component type.\n     * Call this in the constructor of problematic prompts.\n     */\n    protected checkWindowsAttention() {\n        const componentName = this.constructor.name;\n\n        // Check platform and if already warned\n        if (process.platform === 'win32' && !Prompt.warnedComponents.has(componentName)) {\n            console.warn(\n                `${ANSI.FG_YELLOW}Warning:${ANSI.RESET} ${componentName} may hang on Windows TTY after multiple cycles. ` +\n                `Press 'Enter' if unresponsive.`\n            );\n            Prompt.warnedComponents.add(componentName);\n        }\n    }\n\n    /**\n     * Warn about experimental prompts.\n     * Call this in the constructor of experimental prompts.\n     */\n    protected warnExperimental() {\n        const componentName = this.constructor.name;\n\n        if (!Prompt.warnedComponents.has(componentName)) {\n            console.warn(\n                `${ANSI.FG_YELLOW}Warning:${ANSI.RESET} ${componentName} is an experimental prompt and may have bugs or unexpected behavior. ` +\n                `Use with caution.`\n            );\n            Prompt.warnedComponents.add(componentName);\n        }\n    }\n\n    protected abstract render(firstRender: boolean): void;\n    protected abstract handleInput(char: string, key: Buffer): void;\n    protected handleMouse(_event: MouseEvent): void { }\n\n    protected print(text: string) {\n        this.stdout.write(text);\n    }\n\n    public run(): Promise<T> {\n        return new Promise((resolve, reject) => {\n            this._resolve = resolve;\n            this._reject = reject;\n\n            if (typeof this.stdin.setRawMode === 'function') {\n                this.stdin.setRawMode(true);\n            }\n            this.stdin.resume();\n            this.stdin.setEncoding('utf8');\n\n            const shouldEnableMouse = (this.options as BaseOptions).mouse !== false && this.capabilities.hasMouse;\n            if (shouldEnableMouse) {\n                this.print(ANSI.SET_ANY_EVENT_MOUSE + ANSI.SET_SGR_EXT_MODE_MOUSE);\n            }\n\n            this.print(ANSI.HIDE_CURSOR);\n\n            // Initial render\n            this.render(true);\n\n            this._onKeyHandler = (char: string, buffer: Buffer) => {\n                if (char === '\\u0003') { // Ctrl+C\n                    this.cleanup();\n                    this.print(ANSI.SHOW_CURSOR + '\\n');\n                    if (this._reject) this._reject(new Error('User force closed'));\n                    return;\n                }\n                this.handleInput(char, buffer);\n            };\n\n            this._inputParser.on('keypress', this._onKeyHandler);\n\n            this._inputParser.on('mouse', (event: MouseEvent) => {\n                this.handleMouse(event);\n            });\n\n            this._onDataHandler = (buffer: Buffer) => {\n                this._inputParser.feed(buffer);\n            };\n\n            this.stdin.on('data', this._onDataHandler);\n        });\n    }\n\n    /**\n     * Pauses the input stream and removes listeners.\n     * Useful for yielding control to child processes.\n     */\n    protected pauseInput() {\n        if (this._onDataHandler) {\n            this.stdin.removeListener('data', this._onDataHandler);\n        }\n        if (typeof this.stdin.setRawMode === 'function') {\n            this.stdin.setRawMode(false);\n        }\n        this.stdin.pause();\n    }\n\n    /**\n     * Resumes the input stream and re-attaches listeners.\n     */\n    protected resumeInput() {\n        if (typeof this.stdin.setRawMode === 'function') {\n            this.stdin.setRawMode(true);\n        }\n        this.stdin.resume();\n        if (this._onDataHandler) {\n            this.stdin.on('data', this._onDataHandler);\n        }\n    }\n\n    protected cleanup() {\n        if (this._onDataHandler) {\n            this.stdin.removeListener('data', this._onDataHandler);\n        }\n        if (this._onKeyHandler) {\n            this._inputParser.removeListener('keypress', this._onKeyHandler);\n        }\n\n        this.print(ANSI.DISABLE_MOUSE);\n\n        if (typeof this.stdin.setRawMode === 'function') {\n            this.stdin.setRawMode(false);\n        }\n        this.stdin.pause();\n        this.print(ANSI.SHOW_CURSOR);\n    }\n\n    protected submit(result: T) {\n        this.cleanup();\n        this.print('\\n');\n        if (this._resolve) this._resolve(result);\n    }\n\n    protected cancel(reason: any) {\n        this.cleanup();\n        this.print('\\n');\n        if (this._reject) this._reject(reason);\n    }\n\n    /**\n     * Renders the frame using a linear scan diffing algorithm.\n     * Prevents flicker and handles height changes (expand/collapse) robustly.\n     */\n    protected renderFrame(content: string) {\n        const width = this.stdout.columns || 80;\n        const rawLines = content.split('\\n');\n\n        // Truncate lines to prevent wrapping artifacts\n        const newLines = rawLines.map(line => this.truncate(line, width));\n\n        // 1. First Render Case\n        if (this.lastRenderLines.length === 0) {\n            this.print(newLines.join('\\n'));\n            this.lastRenderLines = newLines;\n            this.lastRenderHeight = newLines.length;\n            return;\n        }\n\n        let outputBuffer = '';\n\n        // 2. Return Cursor to the Top of the Prompt\n        if (this.lastRenderHeight > 1) {\n            outputBuffer += `\\x1b[${this.lastRenderHeight - 1}A`;\n        }\n        outputBuffer += '\\r'; // Ensure column 0\n\n        // 3. Linear Scan & Update\n        for (let i = 0; i < newLines.length; i++) {\n            const newLine = newLines[i];\n\n            // Logic for moving to the next line\n            if (i > 0) {\n                if (i < this.lastRenderLines.length) {\n                    // Moving within the previously existing area.\n                    // Use 'Down' (B) to avoid scrolling/shifting existing content.\n                    outputBuffer += '\\x1b[B\\r';\n                } else {\n                    // Moving into NEW area (Append).\n                    // Must use '\\n' to create the new line.\n                    outputBuffer += '\\n';\n                }\n            }\n\n            // Printing logic\n            if (i < this.lastRenderLines.length) {\n                const oldLine = this.lastRenderLines[i];\n                if (newLine !== oldLine) {\n                    // Overwrite existing line\n                    outputBuffer += ANSI.ERASE_LINE + newLine;\n                }\n            } else {\n                // Print new line (we are already at start due to '\\n' above)\n                outputBuffer += newLine;\n            }\n        }\n\n        // 4. Handle Shrinkage (Clear garbage below)\n        if (newLines.length < this.lastRenderLines.length) {\n            // Move down to the first obsolete line\n            outputBuffer += '\\n';\n            // Clear everything below\n            outputBuffer += ANSI.ERASE_DOWN;\n            // Move back up to the last valid line to maintain cursor state consistency\n            outputBuffer += `\\x1b[A`;\n        }\n\n        this.print(outputBuffer);\n\n        // Update State\n        this.lastRenderLines = newLines;\n        this.lastRenderHeight = newLines.length;\n    }\n\n    protected stripAnsi(str: string): string {\n        return stripAnsi(str);\n    }\n\n    protected truncate(str: string, width: number): string {\n        const visualWidth = stringWidth(str);\n        if (visualWidth <= width) {\n            return str;\n        }\n\n        let currentWidth = 0;\n        let cutIndex = 0;\n        let inAnsi = false;\n\n        for (let i = 0; i < str.length; i++) {\n            if (str[i] === '\\x1b') inAnsi = true;\n\n            if (!inAnsi) {\n                const code = str.charCodeAt(i);\n                const charWidth = code > 255 ? 2 : 1;\n                if (currentWidth + charWidth > width - 3) {\n                    break;\n                }\n                currentWidth += charWidth;\n            } else {\n                if (str[i] === 'm' || (str[i] >= 'A' && str[i] <= 'Z')) inAnsi = false;\n            }\n            cutIndex = i + 1;\n        }\n\n        return str.substring(0, cutIndex) + '...' + ANSI.RESET;\n    }\n\n    protected isUp(char: string): boolean {\n        return char === '\\u001b[A' || char === '\\u001bOA';\n    }\n    protected isDown(char: string): boolean {\n        return char === '\\u001b[B' || char === '\\u001bOB';\n    }\n    protected isRight(char: string): boolean {\n        return char === '\\u001b[C' || char === '\\u001bOC';\n    }\n    protected isLeft(char: string): boolean {\n        return char === '\\u001b[D' || char === '\\u001bOD';\n    }\n}"],"names":["Prompt","checkWindowsAttention","componentName","name","process","platform","warnedComponents","has","console","warn","ANSI","FG_YELLOW","RESET","add","warnExperimental","handleMouse","_event","print","text","stdout","write","run","Promise","resolve","reject","_resolve","_reject","stdin","setRawMode","resume","setEncoding","shouldEnableMouse","options","mouse","capabilities","hasMouse","SET_ANY_EVENT_MOUSE","SET_SGR_EXT_MODE_MOUSE","HIDE_CURSOR","render","_onKeyHandler","char","buffer","cleanup","SHOW_CURSOR","Error","handleInput","_inputParser","on","event","_onDataHandler","feed","pauseInput","removeListener","pause","resumeInput","DISABLE_MOUSE","submit","result","cancel","reason","renderFrame","content","width","columns","rawLines","split","newLines","map","line","truncate","lastRenderLines","length","join","lastRenderHeight","outputBuffer","i","newLine","oldLine","ERASE_LINE","ERASE_DOWN","stripAnsi","str","visualWidth","stringWidth","currentWidth","cutIndex","inAnsi","code","charCodeAt","charWidth","substring","isUp","isDown","isRight","isLeft","value","InputParser","detectCapabilities","Set"],"mappings":"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"}