mepcli 0.2.0 → 0.2.5

package/dist/prompts/text.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextPrompt = void 0;
+const ansi_1 = require("../ansi");
+const base_1 = require("../base");
+const theme_1 = require("../theme");
+// --- Implementation: Text Prompt ---
+class TextPrompt extends base_1.Prompt {
+    constructor(options) {
+        super(options);
+        this.errorMsg = '';
+        this.cursor = 0;
+        this.hasTyped = false;
+        this.renderLines = 1;
+        this.value = options.initial || '';
+        this.cursor = this.value.length;
+    }
+    render(firstRender) {
+        // TextPrompt needs the cursor visible!
+        this.print(ansi_1.ANSI.SHOW_CURSOR);
+        if (!firstRender) {
+            // Clear previous lines
+            for (let i = 0; i < this.renderLines; i++) {
+                this.print(ansi_1.ANSI.ERASE_LINE);
+                if (i < this.renderLines - 1)
+                    this.print(ansi_1.ANSI.UP);
+            }
+            this.print(ansi_1.ANSI.CURSOR_LEFT);
+        }
+        let output = '';
+        // 1. Render the Prompt Message
+        const icon = this.errorMsg ? `${theme_1.theme.error}✖` : `${theme_1.theme.success}?`;
+        const multilineHint = this.options.multiline ? ` ${theme_1.theme.muted}(Press Ctrl+D to submit)${ansi_1.ANSI.RESET}` : '';
+        output += `${icon} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET}${multilineHint} `;
+        // 2. Render the Value or Placeholder
+        let displayValue = '';
+        if (!this.value && this.options.placeholder && !this.errorMsg && !this.hasTyped) {
+            displayValue = `${theme_1.theme.muted}${this.options.placeholder}${ansi_1.ANSI.RESET}`;
+        }
+        else {
+            displayValue = this.options.isPassword ? '*'.repeat(this.value.length) : this.value;
+            displayValue = `${theme_1.theme.main}${displayValue}${ansi_1.ANSI.RESET}`;
+        }
+        output += displayValue;
+        // 3. Handle Error Message
+        if (this.errorMsg) {
+            output += `\n${theme_1.theme.error}>> ${this.errorMsg}${ansi_1.ANSI.RESET}`;
+        }
+        this.print(output);
+        // 4. Calculate Visual Metrics for Wrapping
+        const cols = process.stdout.columns || 80;
+        const stripAnsi = (str) => str.replace(/\x1b\[[0-9;]*m/g, '');
+        // Prompt String (visual part before value)
+        const promptStr = `${icon} ${theme_1.theme.title}${this.options.message} ${multilineHint} `;
+        const promptVisualLen = stripAnsi(promptStr).length;
+        // Value String (visual part)
+        const rawValue = (!this.value && this.options.placeholder && !this.errorMsg && !this.hasTyped)
+            ? this.options.placeholder || ''
+            : (this.options.isPassword ? '*'.repeat(this.value.length) : this.value);
+        // Error String (visual part)
+        const errorVisualLines = this.errorMsg ? Math.ceil((3 + this.errorMsg.length) / cols) : 0;
+        // Calculate Total Lines and Cursor Position
+        // We simulate printing the prompt + value + error
+        let currentVisualLine = 0;
+        let currentCol = 0;
+        // State tracking for cursor
+        let cursorRow = 0;
+        let cursorCol = 0;
+        // Add Prompt
+        currentCol += promptVisualLen;
+        while (currentCol >= cols) {
+            currentVisualLine++;
+            currentCol -= cols;
+        }
+        // Add Value (Character by character to handle wrapping and cursor tracking accurately)
+        const valueLen = rawValue.length;
+        // If placeholder, we treat it as value for render height, but cursor is at 0
+        const isPlaceholder = (!this.value && this.options.placeholder && !this.errorMsg && !this.hasTyped);
+        for (let i = 0; i < valueLen; i++) {
+            // Check if we are at cursor position
+            if (!isPlaceholder && i === this.cursor) {
+                cursorRow = currentVisualLine;
+                cursorCol = currentCol;
+            }
+            const char = rawValue[i];
+            if (char === '\n') {
+                currentVisualLine++;
+                currentCol = 0;
+            }
+            else {
+                currentCol++;
+                if (currentCol >= cols) {
+                    currentVisualLine++;
+                    currentCol = 0;
+                }
+            }
+        }
+        // If cursor is at the very end
+        if (!isPlaceholder && this.cursor === valueLen) {
+            cursorRow = currentVisualLine;
+            cursorCol = currentCol;
+        }
+        // If placeholder, cursor is at start of value
+        if (isPlaceholder) {
+            let pCol = promptVisualLen;
+            let pRow = 0;
+            while (pCol >= cols) {
+                pRow++;
+                pCol -= cols;
+            }
+            cursorRow = pRow;
+            cursorCol = pCol;
+        }
+        // Final height
+        const totalValueRows = currentVisualLine + 1;
+        this.renderLines = totalValueRows + errorVisualLines;
+        // 5. Position Cursor Logic
+        const endRow = this.renderLines - 1;
+        // Move up to cursor row
+        const linesUp = endRow - cursorRow;
+        if (linesUp > 0) {
+            this.print(`\x1b[${linesUp}A`);
+        }
+        // Move to cursor col
+        this.print(ansi_1.ANSI.CURSOR_LEFT); // Go to col 0
+        if (cursorCol > 0) {
+            this.print(`\x1b[${cursorCol}C`);
+        }
+    }
+    handleInput(char) {
+        // Enter
+        if (char === '\r' || char === '\n') {
+            if (this.options.multiline) {
+                this.value = this.value.slice(0, this.cursor) + '\n' + this.value.slice(this.cursor);
+                this.cursor++;
+                this.render(false);
+                return;
+            }
+            this.validateAndSubmit();
+            return;
+        }
+        // Ctrl+D (EOF) or Ctrl+S for Submit in Multiline
+        if (this.options.multiline && (char === '\u0004' || char === '\u0013')) {
+            this.validateAndSubmit();
+            return;
+        }
+        // Backspace
+        if (char === '\u0008' || char === '\x7f') {
+            this.hasTyped = true;
+            if (this.cursor > 0) {
+                this.value = this.value.slice(0, this.cursor - 1) + this.value.slice(this.cursor);
+                this.cursor--;
+                this.errorMsg = '';
+                this.render(false);
+            }
+            return;
+        }
+        // Arrow Left
+        if (this.isLeft(char)) {
+            if (this.cursor > 0) {
+                this.cursor--;
+                this.render(false);
+            }
+            return;
+        }
+        // Arrow Right
+        if (this.isRight(char)) {
+            if (this.cursor < this.value.length) {
+                this.cursor++;
+                this.render(false);
+            }
+            return;
+        }
+        // Delete key
+        if (char === '\u001b[3~') {
+            this.hasTyped = true;
+            if (this.cursor < this.value.length) {
+                this.value = this.value.slice(0, this.cursor) + this.value.slice(this.cursor + 1);
+                this.errorMsg = '';
+                this.render(false);
+            }
+            return;
+        }
+        // Regular Typing & Paste
+        if (!/^[\x00-\x1F]/.test(char) && !char.startsWith('\x1b')) {
+            this.hasTyped = true;
+            this.value = this.value.slice(0, this.cursor) + char + this.value.slice(this.cursor);
+            this.cursor += char.length;
+            this.errorMsg = '';
+            this.render(false);
+        }
+    }
+    validateAndSubmit() {
+        if (this.options.validate) {
+            const result = this.options.validate(this.value);
+            // Handle Promise validation
+            if (result instanceof Promise) {
+                // Show loading state
+                this.print(`\n${ansi_1.ANSI.ERASE_LINE}${theme_1.theme.main}Validating...${ansi_1.ANSI.RESET}`);
+                this.print(ansi_1.ANSI.UP);
+                result.then(valid => {
+                    // Clear loading message
+                    this.print(`\n${ansi_1.ANSI.ERASE_LINE}`);
+                    this.print(ansi_1.ANSI.UP);
+                    if (typeof valid === 'string' && valid.length > 0) {
+                        this.errorMsg = valid;
+                        this.render(false);
+                    }
+                    else if (valid === false) {
+                        this.errorMsg = 'Invalid input';
+                        this.render(false);
+                    }
+                    else {
+                        if (this.errorMsg) {
+                            this.print(`\n${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.UP}`);
+                        }
+                        this.submit(this.value);
+                    }
+                }).catch(err => {
+                    this.print(`\n${ansi_1.ANSI.ERASE_LINE}`);
+                    this.print(ansi_1.ANSI.UP);
+                    this.errorMsg = err.message || 'Validation failed';
+                    this.render(false);
+                });
+                return;
+            }
+            // Handle Sync validation
+            if (typeof result === 'string' && result.length > 0) {
+                this.errorMsg = result;
+                this.render(false);
+                return;
+            }
+            if (result === false) {
+                this.errorMsg = 'Invalid input';
+                this.render(false);
+                return;
+            }
+        }
+        if (this.errorMsg) {
+            this.print(`\n${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.UP}`);
+        }
+        this.submit(this.value);
+    }
+}
+exports.TextPrompt = TextPrompt;

package/dist/prompts/toggle.d.ts

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

package/dist/prompts/toggle.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TogglePrompt = void 0;
+const ansi_1 = require("../ansi");
+const base_1 = require("../base");
+const theme_1 = require("../theme");
+// --- Implementation: Toggle Prompt ---
+class TogglePrompt extends base_1.Prompt {
+    constructor(options) {
+        super(options);
+        this.value = options.initial ?? false;
+    }
+    render(firstRender) {
+        this.print(ansi_1.ANSI.HIDE_CURSOR);
+        if (!firstRender) {
+            this.print(`${ansi_1.ANSI.ERASE_LINE}${ansi_1.ANSI.CURSOR_LEFT}`);
+        }
+        const activeText = this.options.activeText || 'ON';
+        const inactiveText = this.options.inactiveText || 'OFF';
+        let toggleDisplay = '';
+        if (this.value) {
+            toggleDisplay = `${theme_1.theme.main}[${ansi_1.ANSI.BOLD}${activeText}${ansi_1.ANSI.RESET}${theme_1.theme.main}]${ansi_1.ANSI.RESET}  ${theme_1.theme.muted}${inactiveText}${ansi_1.ANSI.RESET}`;
+        }
+        else {
+            toggleDisplay = `${theme_1.theme.muted}${activeText}${ansi_1.ANSI.RESET}  ${theme_1.theme.main}[${ansi_1.ANSI.BOLD}${inactiveText}${ansi_1.ANSI.RESET}${theme_1.theme.main}]${ansi_1.ANSI.RESET}`;
+        }
+        this.print(`${theme_1.theme.success}?${ansi_1.ANSI.RESET} ${ansi_1.ANSI.BOLD}${theme_1.theme.title}${this.options.message}${ansi_1.ANSI.RESET} ${toggleDisplay}`);
+        this.print(`\x1b[${toggleDisplay.length}D`); // Move back is not really needed as we hide cursor, but kept for consistency
+    }
+    handleInput(char) {
+        if (char === '\r' || char === '\n') {
+            this.submit(this.value);
+            return;
+        }
+        if (this.isLeft(char) || this.isRight(char) || char === 'h' || char === 'l') { // Left/Right
+            this.value = !this.value;
+            this.render(false);
+        }
+        if (char === ' ') {
+            this.value = !this.value;
+            this.render(false);
+        }
+    }
+}
+exports.TogglePrompt = TogglePrompt;

package/dist/theme.d.ts

@@ -0,0 +1,2 @@
+import { ThemeConfig } from './types';
+export declare const theme: ThemeConfig;

package/dist/theme.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.theme = void 0;
+const ansi_1 = require("./ansi");
+exports.theme = {
+    main: ansi_1.ANSI.FG_CYAN,
+    success: ansi_1.ANSI.FG_GREEN,
+    error: ansi_1.ANSI.FG_RED,
+    muted: ansi_1.ANSI.FG_GRAY,
+    title: ansi_1.ANSI.RESET
+};

package/dist/types.d.ts

@@ -14,8 +14,9 @@ export interface BaseOptions {
 export interface TextOptions extends BaseOptions {
     placeholder?: string;
     initial?: string;
-    validate?: (value: string) => string | boolean;
+    validate?: (value: string) => string | boolean | Promise<string | boolean>;
     isPassword?: boolean;
+    multiline?: boolean;
 }
 export interface Separator {
     separator: true;
@@ -52,3 +53,27 @@ export interface ToggleOptions extends BaseOptions {
     activeText?: string;
     inactiveText?: string;
 }
+export interface ListOptions extends BaseOptions {
+    placeholder?: string;
+    initial?: string[];
+    validate?: (value: string[]) => string | boolean | Promise<string | boolean>;
+}
+export interface SliderOptions extends BaseOptions {
+    min: number;
+    max: number;
+    initial?: number;
+    step?: number;
+    unit?: string;
+}
+export interface DateOptions extends BaseOptions {
+    initial?: Date;
+    min?: Date;
+    max?: Date;
+}
+export interface FileOptions extends BaseOptions {
+    basePath?: string;
+    extensions?: string[];
+    onlyDirectories?: boolean;
+}
+export interface MultiSelectOptions extends CheckboxOptions {
+}

package/example.ts

@@ -1,77 +1,149 @@
-import { MepCLI } from './src'; // Or mepcli if installed via NPM
+import { MepCLI } from './src'; // Or 'mepcli' if installed via NPM
 
 /**
- * Runs a comprehensive set of tests for all MepCLI prompt types.
+ * 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.
  */
-async function runAllTests() {
+async function runComprehensiveDemo() {
     console.clear();
-    console.log("--- MepCLI Comprehensive Test Suite (Neutralized) ---\n");
+    console.log("--- MepCLI Comprehensive Demo (All 12 Prompts + Spin Utility) ---\n");
 
     try {
-        // --- 1. Text Prompt Test (with Validation) ---
+        // --- 1. Text Prompt (Input with Validation and initial value) ---
         const projectName = await MepCLI.text({
             message: "Enter the name for your new project:",
             placeholder: "e.g., minimalist-cli-app",
             initial: "MepProject",
             validate: (value) => {
-                if (value.length < 3) {
-                    return "Project name must be at least 3 characters long.";
-                }
-                if (value.includes('&')) {
-                    return "Project name cannot contain '&' symbol.";
-                }
+                if (value.length < 3) return "Project name must be at least 3 characters long.";
                 return true;
             }
         });
         console.log(`\n✅ Text Result: Project name set to '${projectName}'`);
 
-        // --- 2. Password Prompt Test ---
+        // --- 2. Password Prompt (Hidden input) ---
         const apiKey = await MepCLI.password({
             message: "Enter the project's external API key:",
             placeholder: "Input will be hidden..."
         });
-        // Note: Do not log the actual key in a real app.
         console.log(`\n✅ Password Result: API key entered (length: ${apiKey.length})`);
 
-
-        // --- 3. Select Prompt Test (Single Choice) ---
+        // --- 3. Select Prompt (Single choice, supports filtering/searching by typing) ---
         const theme = await MepCLI.select({
             message: "Choose your preferred editor color theme:",
             choices: [
                 { title: "Dark Mode (Default)", value: "dark" },
                 { title: "Light Mode (Classic)", value: "light" },
                 { title: "High Contrast (Accessibility)", value: "contrast" },
+                // Demonstrates a separator option
+                { separator: true, text: "--- Pro Themes ---" },
                 { title: "Monokai Pro", value: "monokai" },
             ]
         });
         console.log(`\n✅ Select Result: Chosen theme is: ${theme}`);
 
-
-        // --- 4. Checkbox Prompt Test (Multi-Choice with Min/Max) ---
+        // --- 4. Checkbox Prompt (Multi-choice with Min/Max limits) ---
         const buildTools = await MepCLI.checkbox({
             message: "Select your required bundlers/build tools (Min 1, Max 2):",
             min: 1, 
             max: 2, 
             choices: [
                 { title: "Webpack", value: "webpack" },
-                { title: "Vite", value: "vite", selected: true },
+                { title: "Vite", value: "vite", selected: true }, // Default selected state
                 { title: "Rollup", value: "rollup" },
                 { title: "esbuild", value: "esbuild" }
             ]
         });
         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({
+            message: "Which port should the server run on?",
+            initial: 3000,
+            min: 1024,
+            max: 65535,
+            step: 100 // Increments/decrements by 100 with arrows
+        });
+        console.log(`\n✅ Number Result: Server port: ${port}`);
+        
+        // --- 6. Toggle Prompt (Boolean input, supports custom labels) ---
+        const isSecure = await MepCLI.toggle({
+            message: "Enable HTTPS/SSL for production?",
+            initial: false,
+            activeText: "SECURE", // Custom 'on' label
+            inactiveText: "INSECURE" // Custom 'off' label
+        });
+        console.log(`\n✅ Toggle Result: HTTPS enabled: ${isSecure}`);
+
+        // --- 7. List / Tags Input (New) ---
+        const keywords = await MepCLI.list({
+            message: "Enter keywords for package.json (Enter to add, Backspace to remove):",
+            initial: ["cli", "mep"],
+            validate: (tags) => tags.length > 0 || "Please add at least one keyword."
+        });
+        console.log(`\n✅ List Result: Keywords: [${keywords.join(', ')}]`);
+
+        // --- 8. Slider / Scale (New) ---
+        const brightness = await MepCLI.slider({
+            message: "Set initial brightness:",
+            min: 0,
+            max: 100,
+            initial: 80,
+            step: 5,
+            unit: "%"
+        });
+        console.log(`\n✅ Slider Result: Brightness: ${brightness}%`);
+
+        // --- 9. Date / Time Picker (New) ---
+        // We capture 'now' once to ensure initial >= min
+        const now = new Date();
+        const releaseDate = await MepCLI.date({
+            message: "Schedule release date:",
+            initial: now,
+            min: now // Cannot be in the past
+        });
+        console.log(`\n✅ Date Result: Release set for: ${releaseDate.toLocaleString()}`);
+
+        // --- 10. 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) ---
+        const linters = await MepCLI.multiSelect({
+            message: "Select linters to install (Type to search, Space to select):",
+            choices: [
+                { title: "ESLint", value: "eslint", selected: true },
+                { title: "Prettier", value: "prettier" },
+                { title: "Stylelint", value: "stylelint" },
+                { title: "TSLint (Deprecated)", value: "tslint" },
+                { title: "JSHint", value: "jshint" },
+                { title: "StandardJS", value: "standard" }
+            ],
+            min: 1
+        });
+        console.log(`\n✅ MultiSelect Result: Linters: [${linters.join(', ')}]`);
 
-        // --- 5. Confirm Prompt Test ---
+        // --- 12. Confirm Prompt (Simple Yes/No) ---
         const proceed = await MepCLI.confirm({
-            message: "Do you want to continue with the installation setup?",
+            message: "Ready to deploy the project now?",
             initial: true
         });
-        console.log(`\n✅ Confirm Result: Setup decision: ${proceed ? 'Proceed' : 'Cancel'}`);
+        console.log(`\n✅ Confirm Result: Deployment decision: ${proceed ? 'Proceed' : 'Cancel'}`);
 
-        console.log("\n--- All MepCLI tests completed successfully! ---");
+        // --- 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
+        );
+        console.log("\n--- Deployment successful! All MepCLI features demonstrated! ---");
 
     } catch (e) {
+        // Global handler for Ctrl+C closure
         if (e instanceof Error && e.message === 'User force closed') {
              console.log("\nOperation cancelled by user (Ctrl+C).");
         } else {
@@ -80,4 +152,4 @@ async function runAllTests() {
     }
 }
 
-runAllTests();
+runComprehensiveDemo();

package/package.json

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