mepcli 0.4.0 → 0.5.5

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

@@ -91,3 +91,42 @@ 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 EditorOptions extends BaseOptions {
+    initial?: string;
+    extension?: string;
+    waitUserInput?: boolean;
+}
+export interface TableRow<V> {
+    value: V;
+    row: string[];
+}
+export interface TableOptions<V> extends BaseOptions {
+    columns: string[];
+    data: TableRow<V>[];
+    rows?: number;
+}
+export interface TreeNode<V> {
+    title: string;
+    value: V;
+    children?: TreeNode<V>[];
+    expanded?: boolean;
+    disabled?: boolean;
+}
+export interface TreeOptions<V> extends BaseOptions {
+    data: TreeNode<V>[];
+    initial?: V;
+    indent?: number;
+}
+export interface KeypressOptions extends BaseOptions {
+    keys?: string[];
+    showInvisible?: boolean;
+}

package/dist/utils.js

@@ -131,7 +131,11 @@ function stringWidth(str) {
             continue;
         }
         if (inAnsi) {
-            if ((str[i] >= '@' && str[i] <= '~') || (str[i] >= 'a' && str[i] <= 'z') || (str[i] >= 'A' && str[i] <= 'Z')) {
+            if (str[i] === '[') {
+                // Continue, this is the start of CSI
+                continue;
+            }
+            if ((str[i] >= '@' && str[i] <= '~')) {
                 inAnsi = false;
             }
             continue;

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) ---
@@ -21,14 +21,14 @@ async function runComprehensiveDemo() {
                 return true;
             }
         });
-        console.log(`\n✅ Text Result: Project name set to '${projectName}'`);
+        console.log(`\n Text Result: Project name set to '${projectName}'`);
 
         // --- 2. Password Prompt (Hidden input) ---
         const apiKey = await MepCLI.password({
             message: "Enter the project's external API key:",
             placeholder: "Input will be hidden..."
         });
-        console.log(`\n✅ Password Result: API key entered (length: ${apiKey.length})`);
+        console.log(`\n Password Result: API key entered (length: ${apiKey.length})`);
 
         // --- 3. Select Prompt (Single choice, supports filtering/searching by typing) ---
         const theme = await MepCLI.select({
@@ -42,7 +42,7 @@ async function runComprehensiveDemo() {
                 { title: "Monokai Pro", value: "monokai" },
             ]
         });
-        console.log(`\n✅ Select Result: Chosen theme is: ${theme}`);
+        console.log(`\n Select Result: Chosen theme is: ${theme}`);
 
         // --- 4. Checkbox Prompt (Multi-choice with Min/Max limits) ---
         const buildTools = await MepCLI.checkbox({
@@ -56,7 +56,7 @@ async function runComprehensiveDemo() {
                 { title: "esbuild", value: "esbuild" }
             ]
         });
-        console.log(`\n✅ Checkbox Result: Selected build tools: [${buildTools.join(', ')}]`);
+        console.log(`\n Checkbox Result: Selected build tools: [${buildTools.join(', ')}]`);
 
         // --- 5. Number Prompt (Numeric input, supports Min/Max and Up/Down arrow for Step) ---
         const port = await MepCLI.number({
@@ -66,7 +66,7 @@ async function runComprehensiveDemo() {
             max: 65535,
             step: 100 // Increments/decrements by 100 with arrows
         });
-        console.log(`\n✅ Number Result: Server port: ${port}`);
+        console.log(`\n Number Result: Server port: ${port}`);
         
         // --- 6. Toggle Prompt (Boolean input, supports custom labels) ---
         const isSecure = await MepCLI.toggle({
@@ -75,7 +75,7 @@ async function runComprehensiveDemo() {
             activeText: "SECURE", // Custom 'on' label
             inactiveText: "INSECURE" // Custom 'off' label
         });
-        console.log(`\n✅ Toggle Result: HTTPS enabled: ${isSecure}`);
+        console.log(`\n Toggle Result: HTTPS enabled: ${isSecure}`);
 
         // --- 7. List / Tags Input (New) ---
         const keywords = await MepCLI.list({
@@ -83,7 +83,7 @@ async function runComprehensiveDemo() {
             initial: ["cli", "mep"],
             validate: (tags) => tags.length > 0 || "Please add at least one keyword."
         });
-        console.log(`\n✅ List Result: Keywords: [${keywords.join(', ')}]`);
+        console.log(`\n List Result: Keywords: [${keywords.join(', ')}]`);
 
         // --- 8. Slider / Scale (New) ---
         const brightness = await MepCLI.slider({
@@ -94,7 +94,7 @@ async function runComprehensiveDemo() {
             step: 5,
             unit: "%"
         });
-        console.log(`\n✅ Slider Result: Brightness: ${brightness}%`);
+        console.log(`\n Slider Result: Brightness: ${brightness}%`);
 
         // --- 9. Rating Prompt (New) ---
         const userRating = await MepCLI.rating({
@@ -103,7 +103,7 @@ async function runComprehensiveDemo() {
             max: 5,
             initial: 5
         });
-        console.log(`\n✅ Rating Result: You rated it: ${userRating}/5`);
+        console.log(`\n Rating Result: You rated it: ${userRating}/5`);
 
         // --- 10. Date / Time Picker (New) ---
         // We capture 'now' once to ensure initial >= min
@@ -113,14 +113,14 @@ async function runComprehensiveDemo() {
             initial: now,
             min: now // Cannot be in the past
         });
-        console.log(`\n✅ Date Result: Release set for: ${releaseDate.toLocaleString()}`);
+        console.log(`\n Date Result: Release set for: ${releaseDate.toLocaleString()}`);
 
         // --- 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}`);
+        console.log(`\n File Result: Path: ${configPath}`);
 
         // --- 12. Multi-Select Autocomplete (New) ---
         const linters = await MepCLI.multiSelect({
@@ -135,21 +135,112 @@ async function runComprehensiveDemo() {
             ],
             min: 1
         });
-        console.log(`\n✅ MultiSelect Result: Linters: [${linters.join(', ')}]`);
+        console.log(`\n MultiSelect Result: Linters: [${linters.join(', ')}]`);
+
+        // --- 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}`);
 
-        // --- 13. Confirm Prompt (Simple Yes/No) ---
+        // --- 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'}`);
+        console.log(`\n Confirm Result: Deployment decision: ${proceed ? 'Proceed' : 'Cancel'}`);
+
+        // --- 17. Editor Prompt (New) ---
+        const bio = await MepCLI.editor({
+            message: "Write your biography (opens default editor):",
+            initial: "Hi, I am a developer...",
+            extension: ".md",
+            waitUserInput: true
+        });
+        console.log(`\n Editor Result: Biography length: ${bio.length} chars`);
 
-        // --- 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
-        );
-        console.log("\n--- Deployment successful! All MepCLI features demonstrated! ---");
+        // --- 18. Keypress Prompt (New) ---
+        console.log("\n--- Press any key to continue to the Tree Prompt Demo... ---");
+        const key = await MepCLI.keypress({
+            message: "Press any key to proceed (or 'q' to quit):",
+            keys: ['q', 'enter', 'space', 'escape'] // Optional whitelist, or leave undefined for any
+        });
+        console.log(`\n Keypress Result: You pressed '${key}'`);
+        if (key === 'q') return;
+
+        // --- 19. Tree Prompt (New) ---
+        const selectedFile = await MepCLI.tree({
+             message: "Select a file from the project structure (Space to toggle, Enter to select):",
+             data: [
+                 {
+                     title: "src",
+                     value: "src",
+                     children: [
+                         { title: "index.ts", value: "src/index.ts" },
+                         { title: "utils.ts", value: "src/utils.ts" },
+                         { 
+                             title: "prompts", 
+                             value: "src/prompts", 
+                             expanded: true,
+                             children: [
+                                 { title: "text.ts", value: "src/prompts/text.ts" },
+                                 { title: "select.ts", value: "src/prompts/select.ts" }
+                             ]
+                         }
+                     ]
+                 },
+                 {
+                     title: "package.json",
+                     value: "package.json"
+                 },
+                 {
+                     title: "README.md",
+                     value: "README.md"
+                 }
+             ]
+        });
+        console.log(`\n Tree Result: Selected path: ${selectedFile}`);
+
+        // --- 20. 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 (including Editor) demonstrated! ---");
 
     } catch (e) {
         // Global handler for Ctrl+C closure

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mepcli",
-  "version": "0.4.0",
+  "version": "0.5.5",
   "description": "Zero-dependency, minimalist interactive CLI prompt for Node.js",
   "repository": {
     "type": "git",
@@ -17,7 +17,10 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test": "ts-node example.ts"
+    "test": "jest",
+    "demo": "ts-node example.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   },
   "keywords": [
     "cli",
@@ -30,8 +33,15 @@
   "author": "CodeTease",
   "license": "MIT",
   "devDependencies": {
+    "@eslint/js": "^9",
+    "@types/jest": "^30",
     "@types/node": "^22",
+    "eslint": "^9",
+    "globals": "^17",
+    "jest": "^30",
+    "ts-jest": "^29",
     "ts-node": "^10",
-    "typescript": "^5"
+    "typescript": "^5",
+    "typescript-eslint": "^8"
   }
 }