mepcli 0.3.0 → 0.5.0

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);
                     }
                 }
@@ -149,25 +118,6 @@ class TextPrompt extends base_1.Prompt {
                 // But cursorRelativeCol is global? No, we reset it on newline.
                 // So cursorRelativeCol above was correct for the current line.
                 if (isCursorLine) {
-                    // Check if we need to scroll
-                    // We need visual width of the line up to cursor.
-                    // cursorRelativeCol holds that.
-                    // If visual position > maxContentLen, we scroll.
-                    // This logic is similar to before but needs to use widths.
-                    // For simplicity, let's stick to the previous slice logic but apply it to SEGMENTS if possible.
-                    // But slicing segments for display is safer.
-                    // Let's implement simple tail truncation for now to keep it robust.
-                    // Ideally we scroll, but scrolling with variable width chars is complex.
-                    // "Good Enough": if it fits, show it. If not, truncate end.
-                    // If cursor is beyond end, scroll (slice from left).
-                    // Simplified: just show visibleLine truncated by base class renderFrame?
-                    // But renderFrame truncates blindly. We want the cursor visible.
-                    // Let's leave scrolling out for this specific "Backspace" fix task unless it's critical.
-                    // The user asked for "Backspace Emoji fix".
-                    // The scrolling logic is secondary but important.
-                    // I will preserve the existing simple scrolling logic but using segments?
-                    // No, let's just use the string for display and let renderFrame truncate.
-                    // Fix: Ensure we don't crash or show garbage.
                 }
                 displayValueLines.push(theme_1.theme.main + visibleLine + ansi_1.ANSI.RESET);
             });

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/spinner.d.ts

@@ -0,0 +1,33 @@
+export declare class Spinner {
+    private text;
+    private timer?;
+    private frameIndex;
+    private isSpinning;
+    constructor(text: string);
+    /**
+     * Starts the spinner animation.
+     */
+    start(): this;
+    /**
+     * Stops the spinner animation.
+     */
+    stop(): this;
+    /**
+     * Updates the spinner text.
+     */
+    update(text: string): this;
+    /**
+     * Stops the spinner and shows a success message.
+     */
+    success(message?: string): this;
+    /**
+     * Stops the spinner and shows an error message.
+     */
+    error(message?: string): this;
+    /**
+     * Stops the spinner and clears the line.
+     */
+    clear(): this;
+    private render;
+    private handleSignal;
+}

package/dist/spinner.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Spinner = void 0;
+const ansi_1 = require("./ansi");
+const symbols_1 = require("./symbols");
+const theme_1 = require("./theme");
+class Spinner {
+    constructor(text) {
+        this.frameIndex = 0;
+        this.isSpinning = false;
+        this.handleSignal = () => {
+            this.stop();
+            process.exit(0);
+        };
+        this.text = text;
+    }
+    /**
+     * Starts the spinner animation.
+     */
+    start() {
+        if (this.isSpinning)
+            return this;
+        this.isSpinning = true;
+        process.stdout.write(ansi_1.ANSI.HIDE_CURSOR);
+        // Render immediately
+        this.render();
+        // Start loop
+        this.timer = setInterval(() => {
+            this.render();
+        }, 80);
+        // Register signal handler to restore cursor on Ctrl+C
+        process.on('SIGINT', this.handleSignal);
+        return this;
+    }
+    /**
+     * Stops the spinner animation.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.isSpinning) {
+            this.isSpinning = false;
+            process.stdout.write(ansi_1.ANSI.SHOW_CURSOR);
+            process.removeListener('SIGINT', this.handleSignal);
+        }
+        return this;
+    }
+    /**
+     * Updates the spinner text.
+     */
+    update(text) {
+        this.text = text;
+        return this;
+    }
+    /**
+     * Stops the spinner and shows a success message.
+     */
+    success(message) {
+        this.stop();
+        const text = message ?? this.text;
+        process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${theme_1.theme.success}${symbols_1.symbols.tick}${ansi_1.ANSI.RESET} ${text}\n`);
+        return this;
+    }
+    /**
+     * Stops the spinner and shows an error message.
+     */
+    error(message) {
+        this.stop();
+        const text = message ?? this.text;
+        process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${theme_1.theme.error}${symbols_1.symbols.cross}${ansi_1.ANSI.RESET} ${text}\n`);
+        return this;
+    }
+    /**
+     * Stops the spinner and clears the line.
+     */
+    clear() {
+        this.stop();
+        process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}`);
+        return this;
+    }
+    render() {
+        const frame = symbols_1.symbols.spinner[this.frameIndex];
+        process.stdout.write(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}${theme_1.theme.main}${frame}${ansi_1.ANSI.RESET} ${this.text}`);
+        this.frameIndex = (this.frameIndex + 1) % symbols_1.symbols.spinner.length;
+    }
+}
+exports.Spinner = Spinner;

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;
@@ -77,3 +91,21 @@ export interface FileOptions extends BaseOptions {
 }
 export interface MultiSelectOptions<V> extends CheckboxOptions<V> {
 }
+export interface AutocompleteOptions<V> extends BaseOptions {
+    suggest: (input: string) => Promise<SelectChoice<V>[]>;
+    limit?: number;
+    fallback?: string;
+    initial?: string;
+}
+export interface SortOptions extends BaseOptions {
+    items: string[];
+}
+export interface TableRow<V> {
+    value: V;
+    row: string[];
+}
+export interface TableOptions<V> extends BaseOptions {
+    columns: string[];
+    data: TableRow<V>[];
+    rows?: number;
+}

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

@@ -4,11 +4,11 @@ import { MepCLI } from './src'; // Or 'mepcli' if installed via NPM
  * Runs a comprehensive demo showcasing all MepCLI prompt types and utilities.
  * This demonstrates all core functionalities including Text, Password, Select,
  * Checkbox, Number, Toggle, Confirm, List, Slider, Date, File, MultiSelect,
- * and the Spin utility.
+ * Autocomplete, Sort, Table, and the Spin utility.
  */
 async function runComprehensiveDemo() {
     console.clear();
-    console.log("--- MepCLI Comprehensive Demo (All 12 Prompts + Spin Utility) ---\n");
+    console.log("--- MepCLI Comprehensive Demo (All 15 Prompts + Spin Utility) ---\n");
 
     try {
         // --- 1. Text Prompt (Input with Validation and initial value) ---
@@ -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,18 +137,58 @@ async function runComprehensiveDemo() {
         });
         console.log(`\n✅ MultiSelect Result: Linters: [${linters.join(', ')}]`);
 
-        // --- 12. Confirm Prompt (Simple Yes/No) ---
+        // --- 13. Autocomplete Prompt (New) ---
+        const city = await MepCLI.autocomplete({
+            message: "Search for a city (simulated async):",
+            suggest: async (query) => {
+                const cities = [
+                    { title: "New York", value: "NY" },
+                    { title: "London", value: "LDN" },
+                    { title: "Paris", value: "PAR" },
+                    { title: "Tokyo", value: "TKY" },
+                    { title: "Berlin", value: "BER" },
+                    { title: "San Francisco", value: "SF" },
+                    { title: "Toronto", value: "TOR" }
+                ];
+                // Simulate delay
+                await new Promise(r => setTimeout(r, 400));
+                return cities.filter(c => c.title.toLowerCase().includes(query.toLowerCase()));
+            }
+        });
+        console.log(`\n✅ Autocomplete Result: City code: ${city}`);
+
+        // --- 14. Sort Prompt (New) ---
+        const priorities = await MepCLI.sort({
+            message: "Rank your top priorities (Space to grab/drop, Arrows to move):",
+            items: ["Performance", "Security", "Features", "Usability", "Cost"]
+        });
+        console.log(`\n✅ Sort Result: Priorities: [${priorities.join(', ')}]`);
+
+        // --- 15. Table Prompt (New) ---
+        const userId = await MepCLI.table({
+            message: "Select a user from the database:",
+            columns: ["ID", "Name", "Role", "Status"],
+            data: [
+                { value: 1, row: ["001", "Alice", "Admin", "Active"] },
+                { value: 2, row: ["002", "Bob", "Dev", "Offline"] },
+                { value: 3, row: ["003", "Charlie", "User", "Active"] },
+                { value: 4, row: ["004", "David", "Manager", "Active"] },
+            ]
+        });
+        console.log(`\n✅ Table Result: Selected User ID: ${userId}`);
+
+        // --- 16. 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) ---
-        await MepCLI.spin(
-            "Finalizing configuration and deploying...",
-            new Promise(resolve => setTimeout(resolve, 1500)) // Simulates a 1.5 second async task
-        );
+        // --- 17. Spin Utility (Loading/Async Task Indicator) ---
+        const s = MepCLI.spinner("Finalizing configuration and deploying...").start();
+        await new Promise(resolve => setTimeout(resolve, 1500)); // Simulates a 1.5 second async task
+        s.success();
+        
         console.log("\n--- Deployment successful! All MepCLI features demonstrated! ---");
 
     } catch (e) {

package/package.json

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