mepcli 0.3.0 → 0.4.0

package/README.md

@@ -5,14 +5,15 @@
 ## Features
 
 - **Zero Dependency:** Keeps your project clean and fast.
-- **Comprehensive Prompts:** Includes `text`, `password`, `select`, `checkbox`, `confirm`, `number`, `toggle`, `list`, `slider`, `date`, `file`, and `multiSelect`.
+- **Comprehensive Prompts:** Includes `text`, `password`, `select`, `checkbox`, `confirm`, `number`, `toggle`, `list`, `slider`, `date`, `file`, `multiSelect`, and `rating`.
+- **Mouse Support:** Built-in support for mouse interaction (SGR 1006 protocol). Scroll to navigate lists or change values; click to select.
 - **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.
 
 ## Installation
 
-```bash
+```shell
 npm install mepcli
 # or
 yarn add mepcli
@@ -66,7 +67,15 @@ async function main() {
         ]
     });
 
-    console.log({ name, age, newsletter, lang, tools });
+    // Rating (Star rating)
+    const stars = await MepCLI.rating({
+        message: "Rate your experience:",
+        min: 1,
+        max: 5,
+        initial: 5
+    });
+
+    console.log({ name, age, newsletter, lang, tools, stars });
 }
 
 main();
@@ -86,10 +95,23 @@ 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.
+*   `rating(options)` - Star rating input.
 *   `date(options)` - Date and time picker.
 *   `file(options)` - File system navigator and selector.
 *   `spin(message, promise)` - Display a spinner while waiting for a promise.
 
+## Mouse Support
+
+MepCLI automatically detects modern terminals and enables **Mouse Tracking** (using SGR 1006 protocol).
+
+*   **Scrolling:**
+    *   `select`, `multiSelect`, `checkbox`: Scroll to navigate the list.
+    *   `number`, `slider`, `rating`, `date`: Scroll to increment/decrement values or fields.
+    *   `toggle`, `confirm`: Scroll to toggle the state.
+*   **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.
+
 ## License
 
 This project is under the **MIT License**.

package/dist/ansi.d.ts

@@ -21,4 +21,7 @@ export declare const ANSI: {
     SHOW_CURSOR: string;
     UP: string;
     DOWN: string;
+    SET_ANY_EVENT_MOUSE: string;
+    SET_SGR_EXT_MODE_MOUSE: string;
+    DISABLE_MOUSE: string;
 };

package/dist/ansi.js

@@ -26,4 +26,8 @@ exports.ANSI = {
     SHOW_CURSOR: '\x1b[?25h',
     UP: '\x1b[A',
     DOWN: '\x1b[B',
+    // Mouse Tracking (SGR Protocol)
+    SET_ANY_EVENT_MOUSE: '\x1b[?1003h',
+    SET_SGR_EXT_MODE_MOUSE: '\x1b[?1006h',
+    DISABLE_MOUSE: '\x1b[?1003l\x1b[?1006l',
 };

package/dist/base.d.ts

@@ -1,3 +1,4 @@
+import { MouseEvent } from './types';
 import { detectCapabilities } from './utils';
 /**
  * Abstract base class for all prompts.
@@ -29,6 +30,11 @@ export declare abstract class Prompt<T, O> {
      * @param key The raw buffer.
      */
     protected abstract handleInput(char: string, key: Buffer): void;
+    /**
+     * Optional method to handle mouse events.
+     * Subclasses can override this to implement mouse interaction.
+     */
+    protected handleMouse(event: MouseEvent): void;
     protected print(text: string): void;
     /**
      * Starts the prompt interaction.

package/dist/base.js

@@ -20,6 +20,11 @@ class Prompt {
         this._inputParser = new input_1.InputParser();
         this.capabilities = (0, utils_1.detectCapabilities)();
     }
+    /**
+     * Optional method to handle mouse events.
+     * Subclasses can override this to implement mouse interaction.
+     */
+    handleMouse(event) { }
     print(text) {
         this.stdout.write(text);
     }
@@ -36,6 +41,12 @@ class Prompt {
             }
             this.stdin.resume();
             this.stdin.setEncoding('utf8');
+            // Enable Mouse Tracking if supported and requested
+            // Default to true if capabilities support it, unless explicitly disabled in options
+            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);
+            }
             // Initial render: Default to hidden cursor (good for menus)
             // Subclasses like TextPrompt will explicitly show it if needed.
             if (this.capabilities.isCI) {
@@ -57,6 +68,10 @@ class Prompt {
                 this.handleInput(char, buffer);
             };
             this._inputParser.on('keypress', this._onKeyHandler);
+            // Listen to mouse events
+            this._inputParser.on('mouse', (event) => {
+                this.handleMouse(event);
+            });
             this._onDataHandler = (buffer) => {
                 this._inputParser.feed(buffer);
             };
@@ -73,6 +88,9 @@ 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') {
             this.stdin.setRawMode(false);
         }

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { TextOptions, SelectOptions, ConfirmOptions, CheckboxOptions, ThemeConfig, NumberOptions, ToggleOptions, ListOptions, SliderOptions, DateOptions, FileOptions, MultiSelectOptions } from './types';
+import { TextOptions, SelectOptions, ConfirmOptions, CheckboxOptions, ThemeConfig, NumberOptions, ToggleOptions, ListOptions, SliderOptions, DateOptions, FileOptions, MultiSelectOptions, RatingOptions } from './types';
 /**
  * Public Facade for MepCLI
  */
@@ -20,4 +20,5 @@ export declare class MepCLI {
     static date(options: DateOptions): Promise<Date>;
     static file(options: FileOptions): Promise<string>;
     static multiSelect<const V>(options: MultiSelectOptions<V>): Promise<V[]>;
+    static rating(options: RatingOptions): Promise<number>;
 }

package/dist/core.js

@@ -15,6 +15,7 @@ const slider_1 = require("./prompts/slider");
 const date_1 = require("./prompts/date");
 const file_1 = require("./prompts/file");
 const multi_select_1 = require("./prompts/multi-select");
+const rating_1 = require("./prompts/rating");
 /**
  * Public Facade for MepCLI
  */
@@ -80,6 +81,9 @@ class MepCLI {
     static multiSelect(options) {
         return new multi_select_1.MultiSelectPrompt(options).run();
     }
+    static rating(options) {
+        return new rating_1.RatingPrompt(options).run();
+    }
 }
 exports.MepCLI = MepCLI;
 MepCLI.theme = theme_1.theme;

package/dist/input.d.ts

@@ -9,5 +9,6 @@ export declare class InputParser extends EventEmitter {
      */
     feed(data: Buffer): void;
     private processChar;
+    private parseSGRMouse;
     private emitKey;
 }

package/dist/input.js

@@ -14,14 +14,6 @@ class InputParser extends events_1.EventEmitter {
      * Feed data into the parser.
      */
     feed(data) {
-        // Convert buffer to string.
-        // For partial multi-byte sequences at the chunk boundary,
-        // buffer.toString() might produce replacement chars.
-        // Ideally we should use StringDecoder, but since we are handling KeyPresses,
-        // and usually a keypress is complete, simple toString often works.
-        // However, the user mentioned fragmentation issues.
-        // But InputParser usually receives data from stdin.
-        // The core issue of fragmentation is splitting escape codes like \x1b [ A
         const input = data.toString('utf-8');
         for (let i = 0; i < input.length; i++) {
             const char = input[i];
@@ -67,6 +59,11 @@ class InputParser extends events_1.EventEmitter {
         }
         else if (this.state === 'CSI') {
             this.buffer += char;
+            if (char === '<') {
+                this.state = 'MOUSE_SGR';
+                this.buffer = '<';
+                return;
+            }
             // CSI sequences end with 0x40-0x7E
             if (char >= '@' && char <= '~') {
                 this.emitKey(this.buffer);
@@ -75,6 +72,63 @@ class InputParser extends events_1.EventEmitter {
             }
             // Otherwise, we keep buffering (params like 1;2)
         }
+        else if (this.state === 'MOUSE_SGR') {
+            this.buffer += char;
+            // SGR sequences end with 'm' (release) or 'M' (press)
+            if (char === 'm' || char === 'M') {
+                this.parseSGRMouse(this.buffer);
+                this.buffer = '';
+                this.state = 'NORMAL';
+            }
+        }
+    }
+    parseSGRMouse(buffer) {
+        // console.log('Parsing SGR:', buffer);
+        // format: <b;x;yM or <b;x;ym
+        // buffer includes the leading < and trailing M/m
+        const content = buffer.slice(1, -1);
+        const type = buffer.slice(-1); // m or M
+        const parts = content.split(';').map(Number);
+        if (parts.length >= 3) {
+            const [b, x, y] = parts;
+            let action = 'press';
+            // Interpret button codes
+            // 0: Left, 1: Middle, 2: Right
+            // +32: Motion
+            // 64: Scroll Up
+            // 65: Scroll Down
+            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');
+                return;
+            }
+            if (type === 'm') {
+                action = 'release';
+            }
+            else {
+                action = 'press';
+                // Check if motion
+                if (b & 32) {
+                    action = 'move';
+                }
+            }
+            this.emit('mouse', {
+                name: 'mouse',
+                x,
+                y,
+                button: b & 3, // Strip modifiers to get raw button 0-2
+                action
+            });
+        }
     }
     emitKey(key) {
         // Normalize Enter

package/dist/prompts/checkbox.d.ts

@@ -1,5 +1,5 @@
 import { Prompt } from '../base';
-import { CheckboxOptions } from '../types';
+import { CheckboxOptions, MouseEvent } from '../types';
 export declare class CheckboxPrompt<V> extends Prompt<any[], CheckboxOptions<V>> {
     private selectedIndex;
     private checkedState;
@@ -9,4 +9,5 @@ export declare class CheckboxPrompt<V> extends Prompt<any[], CheckboxOptions<V>>
     constructor(options: CheckboxOptions<V>);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/checkbox.js

@@ -111,5 +111,19 @@ class CheckboxPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            if (event.scroll === 'up') {
+                this.selectedIndex = this.selectedIndex > 0 ? this.selectedIndex - 1 : this.options.choices.length - 1;
+                this.errorMsg = '';
+                this.render(false);
+            }
+            else if (event.scroll === 'down') {
+                this.selectedIndex = this.selectedIndex < this.options.choices.length - 1 ? this.selectedIndex + 1 : 0;
+                this.errorMsg = '';
+                this.render(false);
+            }
+        }
+    }
 }
 exports.CheckboxPrompt = CheckboxPrompt;

package/dist/prompts/confirm.d.ts

@@ -1,7 +1,8 @@
 import { Prompt } from '../base';
-import { ConfirmOptions } from '../types';
+import { ConfirmOptions, MouseEvent } from '../types';
 export declare class ConfirmPrompt extends Prompt<boolean, ConfirmOptions> {
     constructor(options: ConfirmOptions);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/confirm.js

@@ -38,5 +38,11 @@ class ConfirmPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            this.value = !this.value;
+            this.render(false);
+        }
+    }
 }
 exports.ConfirmPrompt = ConfirmPrompt;

package/dist/prompts/date.d.ts

@@ -1,5 +1,5 @@
 import { Prompt } from '../base';
-import { DateOptions } from '../types';
+import { DateOptions, MouseEvent } from '../types';
 export declare class DatePrompt extends Prompt<Date, DateOptions> {
     private selectedField;
     private errorMsg;
@@ -7,4 +7,6 @@ export declare class DatePrompt extends Prompt<Date, DateOptions> {
     constructor(options: DateOptions);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
+    private adjustDate;
 }

package/dist/prompts/date.js

@@ -37,6 +37,18 @@ class DatePrompt extends base_1.Prompt {
     }
     handleInput(char) {
         if (char === '\r' || char === '\n') {
+            // Min constraint check
+            if (this.options.min && this.value < this.options.min) {
+                this.errorMsg = 'Date cannot be before minimum allowed.';
+                this.render(false);
+                return;
+            }
+            // Max constraint check
+            if (this.options.max && this.value > this.options.max) {
+                this.errorMsg = 'Date cannot be after maximum allowed.';
+                this.render(false);
+                return;
+            }
             this.submit(this.value);
             return;
         }
@@ -89,7 +101,16 @@ class DatePrompt extends base_1.Prompt {
             else if (this.selectedField === 4)
                 d.setMinutes(Math.max(0, Math.min(59, finalVal)));
             this.value = d;
-            this.errorMsg = '';
+            // Check immediately after updating the value to display an error message (but still allow further input)
+            if (this.options.min && this.value < this.options.min) {
+                this.errorMsg = 'Warning: Date is before minimum.';
+            }
+            else if (this.options.max && this.value > this.options.max) {
+                this.errorMsg = 'Warning: Date is after maximum.';
+            }
+            else {
+                this.errorMsg = '';
+            }
             this.render(false);
             return;
         }
@@ -99,39 +120,49 @@ class DatePrompt extends base_1.Prompt {
         if (isUp || isDown) {
             this.inputBuffer = ''; // Reset buffer on arrow move
             const dir = isUp ? 1 : -1;
-            const d = new Date(this.value);
-            switch (this.selectedField) {
-                case 0:
-                    d.setFullYear(d.getFullYear() + dir);
-                    break;
-                case 1:
-                    d.setMonth(d.getMonth() + dir);
-                    break;
-                case 2:
-                    d.setDate(d.getDate() + dir);
-                    break;
-                case 3:
-                    d.setHours(d.getHours() + dir);
-                    break;
-                case 4:
-                    d.setMinutes(d.getMinutes() + dir);
-                    break;
-            }
-            let valid = true;
-            if (this.options.min && d < this.options.min) {
-                this.errorMsg = 'Date cannot be before minimum allowed.';
-                valid = false;
-            }
-            if (this.options.max && d > this.options.max) {
-                this.errorMsg = 'Date cannot be after maximum allowed.';
-                valid = false;
+            this.adjustDate(dir);
+        }
+    }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            if (event.scroll === 'up') {
+                this.adjustDate(1);
             }
-            if (valid) {
-                this.value = d;
-                this.errorMsg = '';
+            else if (event.scroll === 'down') {
+                this.adjustDate(-1);
             }
-            this.render(false);
         }
     }
+    adjustDate(dir) {
+        const d = new Date(this.value);
+        switch (this.selectedField) {
+            case 0:
+                d.setFullYear(d.getFullYear() + dir);
+                break;
+            case 1:
+                d.setMonth(d.getMonth() + dir);
+                break;
+            case 2:
+                d.setDate(d.getDate() + dir);
+                break;
+            case 3:
+                d.setHours(d.getHours() + dir);
+                break;
+            case 4:
+                d.setMinutes(d.getMinutes() + dir);
+                break;
+        }
+        this.value = d;
+        if (this.options.min && this.value < this.options.min) {
+            this.errorMsg = 'Date cannot be before minimum allowed.';
+        }
+        else if (this.options.max && this.value > this.options.max) {
+            this.errorMsg = 'Date cannot be after maximum allowed.';
+        }
+        else {
+            this.errorMsg = '';
+        }
+        this.render(false);
+    }
 }
 exports.DatePrompt = DatePrompt;

package/dist/prompts/multi-select.d.ts

@@ -1,5 +1,5 @@
 import { Prompt } from '../base';
-import { MultiSelectOptions } from '../types';
+import { MultiSelectOptions, MouseEvent } from '../types';
 export declare class MultiSelectPrompt<V> extends Prompt<any[], MultiSelectOptions<V>> {
     private selectedIndex;
     private checkedState;
@@ -11,4 +11,5 @@ export declare class MultiSelectPrompt<V> extends Prompt<any[], MultiSelectOptio
     private getFilteredChoices;
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/multi-select.js

@@ -120,5 +120,20 @@ class MultiSelectPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        const choices = this.getFilteredChoices();
+        if (choices.length === 0)
+            return;
+        if (event.action === 'scroll') {
+            if (event.scroll === 'up') {
+                this.selectedIndex = (this.selectedIndex - 1 + choices.length) % choices.length;
+                this.render(false);
+            }
+            else if (event.scroll === 'down') {
+                this.selectedIndex = (this.selectedIndex + 1) % choices.length;
+                this.render(false);
+            }
+        }
+    }
 }
 exports.MultiSelectPrompt = MultiSelectPrompt;

package/dist/prompts/number.d.ts

@@ -1,5 +1,5 @@
 import { Prompt } from '../base';
-import { NumberOptions } from '../types';
+import { NumberOptions, MouseEvent } from '../types';
 export declare class NumberPrompt extends Prompt<number, NumberOptions> {
     private stringValue;
     private cursor;
@@ -7,4 +7,5 @@ export declare class NumberPrompt extends Prompt<number, NumberOptions> {
     constructor(options: NumberOptions);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/number.js

@@ -130,5 +130,27 @@ class NumberPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            let num = parseFloat(this.stringValue) || 0;
+            const step = this.options.step ?? 1;
+            if (event.scroll === 'up') {
+                num += step;
+                if (this.options.max !== undefined && num > this.options.max)
+                    num = this.options.max;
+            }
+            else if (event.scroll === 'down') {
+                num -= step;
+                if (this.options.min !== undefined && num < this.options.min)
+                    num = this.options.min;
+            }
+            // Round to avoid float errors
+            num = Math.round(num * 10000) / 10000;
+            this.stringValue = num.toString();
+            this.cursor = this.stringValue.length;
+            this.errorMsg = '';
+            this.render(false);
+        }
+    }
 }
 exports.NumberPrompt = NumberPrompt;

package/dist/prompts/rating.d.ts

@@ -0,0 +1,8 @@
+import { Prompt } from '../base';
+import { RatingOptions, MouseEvent } from '../types';
+export declare class RatingPrompt extends Prompt<number, RatingOptions> {
+    constructor(options: RatingOptions);
+    protected render(firstRender: boolean): void;
+    protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
+}

package/dist/prompts/rating.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RatingPrompt = void 0;
+const ansi_1 = require("../ansi");
+const base_1 = require("../base");
+const theme_1 = require("../theme");
+const symbols_1 = require("../symbols");
+class RatingPrompt extends base_1.Prompt {
+    constructor(options) {
+        super(options);
+        // Default to min if initial is not provided
+        this.value = options.initial ?? (options.min || 1);
+    }
+    render(firstRender) {
+        const min = this.options.min || 1;
+        const max = this.options.max || 5;
+        // Render stars
+        let stars = '';
+        for (let i = min; i <= max; i++) {
+            if (i <= this.value) {
+                stars += `${theme_1.theme.success}${symbols_1.symbols.star}${ansi_1.ANSI.RESET} `;
+            }
+            else {
+                stars += `${theme_1.theme.muted}${symbols_1.symbols.starEmpty}${ansi_1.ANSI.RESET} `;
+            }
+        }
+        const output = `${theme_1.theme.success}?${ansi_1.ANSI.RESET} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${stars}`;
+        this.renderFrame(output);
+    }
+    handleInput(char) {
+        const min = this.options.min || 1;
+        const max = this.options.max || 5;
+        if (char === '\r' || char === '\n') {
+            this.submit(this.value);
+            return;
+        }
+        // Arrow keys
+        if (this.isLeft(char) || this.isDown(char)) { // Left/Down decreases
+            if (this.value > min) {
+                this.value--;
+                this.render(false);
+            }
+        }
+        else if (this.isRight(char) || this.isUp(char)) { // Right/Up increases
+            if (this.value < max) {
+                this.value++;
+                this.render(false);
+            }
+        }
+        // Number keys (1-9)
+        const num = parseInt(char);
+        if (!isNaN(num)) {
+            if (num >= min && num <= max) {
+                this.value = num;
+                this.render(false);
+            }
+        }
+    }
+    handleMouse(event) {
+        const min = this.options.min || 1;
+        const max = this.options.max || 5;
+        if (event.action === 'scroll') {
+            if (event.scroll === 'up') {
+                if (this.value < max) {
+                    this.value++;
+                    this.render(false);
+                }
+            }
+            else if (event.scroll === 'down') {
+                if (this.value > min) {
+                    this.value--;
+                    this.render(false);
+                }
+            }
+        }
+    }
+}
+exports.RatingPrompt = RatingPrompt;

package/dist/prompts/select.d.ts

@@ -1,5 +1,5 @@
 import { Prompt } from '../base';
-import { SelectOptions } from '../types';
+import { SelectOptions, MouseEvent } from '../types';
 export declare class SelectPrompt<V> extends Prompt<any, SelectOptions<V>> {
     private selectedIndex;
     private searchBuffer;
@@ -11,4 +11,5 @@ export declare class SelectPrompt<V> extends Prompt<any, SelectOptions<V>> {
     private getFilteredChoices;
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/select.js

@@ -145,5 +145,20 @@ class SelectPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        const choices = this.getFilteredChoices();
+        if (choices.length === 0)
+            return;
+        if (event.action === 'scroll') {
+            if (event.scroll === 'up') {
+                this.selectedIndex = this.findNextSelectableIndex(this.selectedIndex, -1);
+                this.render(false);
+            }
+            else if (event.scroll === 'down') {
+                this.selectedIndex = this.findNextSelectableIndex(this.selectedIndex, 1);
+                this.render(false);
+            }
+        }
+    }
 }
 exports.SelectPrompt = SelectPrompt;

package/dist/prompts/slider.d.ts

@@ -1,7 +1,8 @@
 import { Prompt } from '../base';
-import { SliderOptions } from '../types';
+import { SliderOptions, MouseEvent } from '../types';
 export declare class SliderPrompt extends Prompt<number, SliderOptions> {
     constructor(options: SliderOptions);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/slider.js

@@ -46,5 +46,19 @@ class SliderPrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            const step = this.options.step || 1;
+            if (event.scroll === 'up') { // Scroll Up -> Increase
+                this.value = Math.min(this.options.max, this.value + step);
+            }
+            if (event.scroll === 'down') { // Scroll Down -> Decrease
+                this.value = Math.max(this.options.min, this.value - step);
+            }
+            // Round to avoid float errors
+            this.value = Math.round(this.value * 10000) / 10000;
+            this.render(false);
+        }
+    }
 }
 exports.SliderPrompt = SliderPrompt;

package/dist/prompts/text.js

@@ -77,41 +77,10 @@ class TextPrompt extends base_1.Prompt {
                     visualColIndex = 0;
                 }
                 else {
-                    // Calculate width of this segment? 
-                    // No, for simple text editor logic we often assume 1 char = 1 pos unless we do full layout.
-                    // But here we want correct cursor placement over wide chars.
-                    // So we should sum width.
-                    // However, standard terminals handle wide chars by advancing cursor 2 spots.
-                    // So we just need to sum the string length of the segment? 
-                    // Or 2 if it's wide?
-                    // Standard terminal behavior:
-                    // If I write an Emoji (2 cols), the cursor advances 2 cols.
-                    // So visualColIndex should track stringWidth(seg).
-                    // But if isPassword, it's '*'. Width 1.
                     if (this.options.isPassword) {
                         visualColIndex += 1;
                     }
                     else {
-                        // Use our helper? Or just length?
-                        // If we used stringWidth, it would be accurate.
-                        // But we don't have access to stringWidth here easily unless we import it again (we did in base).
-                        // Let's assume segment.length for now (byte length), 
-                        // because `\x1b[<N>C` moves N COLUMNS? No, N characters? 
-                        // ANSI `CUB` / `CUF` moves N *columns* usually? 
-                        // "The Cursor Forward (CUF) sequence moves the cursor forward by n columns."
-                        // So if we have an emoji (2 cols), we need to move past it.
-                        // If we print an emoji, cursor is at +2.
-                        // Wait, if we use `renderFrame`, we rewrite everything.
-                        // Then we calculate where to put the cursor.
-                        // If line is "A <Emoji> B".
-                        // Output: "A <Emoji> B".
-                        // If cursor is after Emoji.
-                        // We need to be at position: width("A") + width("<Emoji>").
-                        // = 1 + 2 = 3.
-                        // So `visualColIndex` should use `stringWidth(seg)`.
-                        // But I didn't export `stringWidth` from `utils.ts` in the last step?
-                        // Checking `src/utils.ts`... I did export it.
-                        // But I need to import it here.
                         visualColIndex += this.options.isPassword ? 1 : this.getSegmentWidth(seg);
                     }
                 }

package/dist/prompts/toggle.d.ts

@@ -1,7 +1,8 @@
 import { Prompt } from '../base';
-import { ToggleOptions } from '../types';
+import { ToggleOptions, MouseEvent } from '../types';
 export declare class TogglePrompt extends Prompt<boolean, ToggleOptions> {
     constructor(options: ToggleOptions);
     protected render(firstRender: boolean): void;
     protected handleInput(char: string): void;
+    protected handleMouse(event: MouseEvent): void;
 }

package/dist/prompts/toggle.js

@@ -37,5 +37,11 @@ class TogglePrompt extends base_1.Prompt {
             this.render(false);
         }
     }
+    handleMouse(event) {
+        if (event.action === 'scroll') {
+            this.value = !this.value;
+            this.render(false);
+        }
+    }
 }
 exports.TogglePrompt = TogglePrompt;

package/dist/symbols.d.ts

@@ -13,5 +13,9 @@ export interface SymbolDefinition {
     unchecked: string;
     /** Animation frames for the spinner */
     spinner: string[];
+    /** Star symbol for rating */
+    star: string;
+    /** Empty star symbol for rating */
+    starEmpty: string;
 }
 export declare const symbols: SymbolDefinition;

package/dist/symbols.js

@@ -9,7 +9,9 @@ const UnicodeSymbols = {
     line: '─',
     checked: '◉',
     unchecked: '◯',
-    spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+    spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    star: '★',
+    starEmpty: '☆'
 };
 const AsciiSymbols = {
     tick: '+',
@@ -18,7 +20,9 @@ const AsciiSymbols = {
     line: '-',
     checked: '[x]',
     unchecked: '[ ]',
-    spinner: ['|', '/', '-', '\\']
+    spinner: ['|', '/', '-', '\\'],
+    star: '*',
+    starEmpty: ' '
 };
 const capabilities = (0, utils_1.detectCapabilities)();
 const useUnicode = capabilities.hasUnicode && process.env.MEP_NO_UNICODE !== '1';

package/dist/types.d.ts

@@ -10,6 +10,15 @@ export interface ThemeConfig {
 }
 export interface BaseOptions {
     message: string;
+    mouse?: boolean;
+}
+export interface MouseEvent {
+    name: 'mouse';
+    x: number;
+    y: number;
+    button: number;
+    action: 'press' | 'release' | 'move' | 'scroll';
+    scroll?: 'up' | 'down';
 }
 export interface TextOptions extends BaseOptions {
     placeholder?: string;
@@ -65,6 +74,11 @@ export interface SliderOptions extends BaseOptions {
     step?: number;
     unit?: string;
 }
+export interface RatingOptions extends BaseOptions {
+    min?: number;
+    max?: number;
+    initial?: number;
+}
 export interface DateOptions extends BaseOptions {
     initial?: Date;
     min?: Date;

package/dist/utils.d.ts

@@ -5,6 +5,7 @@ export declare function detectCapabilities(): {
     isCI: boolean;
     hasTrueColor: boolean;
     hasUnicode: boolean | "";
+    hasMouse: boolean;
 };
 /**
  * Strips ANSI escape codes from a string.

package/dist/utils.js

@@ -52,7 +52,10 @@ function detectCapabilities() {
         isCI,
         hasTrueColor,
         // Enable Unicode only if it's TTY and environment supports it.
-        hasUnicode: isTTY && isUnicodeSupported()
+        hasUnicode: isTTY && isUnicodeSupported(),
+        // Check if mouse should be enabled (TTY and not CI, or explicit override)
+        // SGR is widely supported in modern terminals
+        hasMouse: isTTY && !isCI
     };
 }
 /**

package/example.ts

@@ -96,7 +96,16 @@ async function runComprehensiveDemo() {
         });
         console.log(`\n✅ Slider Result: Brightness: ${brightness}%`);
 
-        // --- 9. Date / Time Picker (New) ---
+        // --- 9. Rating Prompt (New) ---
+        const userRating = await MepCLI.rating({
+            message: "How would you rate this CLI tool?",
+            min: 1,
+            max: 5,
+            initial: 5
+        });
+        console.log(`\n✅ Rating Result: You rated it: ${userRating}/5`);
+
+        // --- 10. Date / Time Picker (New) ---
         // We capture 'now' once to ensure initial >= min
         const now = new Date();
         const releaseDate = await MepCLI.date({
@@ -106,14 +115,14 @@ async function runComprehensiveDemo() {
         });
         console.log(`\n✅ Date Result: Release set for: ${releaseDate.toLocaleString()}`);
 
-        // --- 10. File Path Selector (New) ---
+        // --- 11. File Path Selector (New) ---
         const configPath = await MepCLI.file({
             message: "Select configuration file (Tab to autocomplete):",
             basePath: process.cwd()
         });
         console.log(`\n✅ File Result: Path: ${configPath}`);
 
-        // --- 11. Multi-Select Autocomplete (New) ---
+        // --- 12. Multi-Select Autocomplete (New) ---
         const linters = await MepCLI.multiSelect({
             message: "Select linters to install (Type to search, Space to select):",
             choices: [
@@ -128,14 +137,14 @@ async function runComprehensiveDemo() {
         });
         console.log(`\n✅ MultiSelect Result: Linters: [${linters.join(', ')}]`);
 
-        // --- 12. Confirm Prompt (Simple Yes/No) ---
+        // --- 13. Confirm Prompt (Simple Yes/No) ---
         const proceed = await MepCLI.confirm({
             message: "Ready to deploy the project now?",
             initial: true
         });
         console.log(`\n✅ Confirm Result: Deployment decision: ${proceed ? 'Proceed' : 'Cancel'}`);
 
-        // --- 13. Spin Utility (Loading/Async Task Indicator) ---
+        // --- 14. Spin Utility (Loading/Async Task Indicator) ---
         await MepCLI.spin(
             "Finalizing configuration and deploying...",
             new Promise(resolve => setTimeout(resolve, 1500)) // Simulates a 1.5 second async task

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mepcli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Zero-dependency, minimalist interactive CLI prompt for Node.js",
   "repository": {
     "type": "git",