mepcli 0.6.1 → 1.0.0-beta.2

package/package.json

@@ -1,47 +1,51 @@
-{
-  "name": "mepcli",
-  "version": "0.6.1",
-  "description": "Zero-dependency, interactive CLI prompt for Node.js",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/CodeTease/mep.git"
-  },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "example.ts"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "test": "jest",
-    "demo": "ts-node example.ts",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
-  },
-  "keywords": [
-    "cli",
-    "prompt",
-    "inquirer",
-    "interactive",
-    "zero-dependency",
-    "codetease"
-  ],
-  "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-eslint": "^8"
-  }
-}
+{
+  "name": "mepcli",
+  "version": "1.0.0-beta.2",
+  "description": "Zero-dependency, interactive CLI prompt for Node.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CodeTease/mep.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "demo": "ts-node example.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "keywords": [
+    "cli",
+    "prompt",
+    "inquirer",
+    "enquirer",
+    "interactive",
+    "zero-dependency",
+    "codetease",
+    "command-line",
+    "typescript",
+    "color",
+    "ansi"
+  ],
+  "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-eslint": "^8"
+  }
+}

package/example.ts

@@ -1,390 +0,0 @@
-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,
- * Autocomplete, Sort, Table, and the Spin utility.
- */
-async function runComprehensiveDemo() {
-    console.clear();
-    console.log("--- MepCLI Comprehensive Demo (All Prompts + Spin Utility) ---\n");
-
-    try {
-        // --- 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.";
-                return true;
-            }
-        });
-        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})`);
-
-        // --- 2.5. Secret Prompt (Completely hidden input) ---
-        const secretToken = await MepCLI.secret({
-            message: "Enter secret token (no feedback):",
-            validate: (v) => v.length > 0 || "Token required"
-        });
-        console.log(`\n Secret Result: Token entered (length: ${secretToken.length})`);
-
-        // --- 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 (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 }, // 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 ---
-        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 ---
-        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}%`);
-
-        // --- 8.1. Range Prompt (Dual Slider) ---
-        const priceRange = await MepCLI.range({
-            message: "Filter by price range:",
-            min: 0,
-            max: 1000,
-            initial: [200, 800],
-            step: 50,
-            unit: "$"
-        });
-        console.log(`\n Range Result: $${priceRange[0]} - $${priceRange[1]}`);
-
-        // --- 9. Rating Prompt ---
-        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 ---
-        // 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()}`);
-
-        // --- 11. File Path Selector  ---
-        const configPath = await MepCLI.file({
-            message: "Select configuration file (Tab to autocomplete):",
-            basePath: process.cwd()
-        });
-        console.log(`\n File Result: Path: ${configPath}`);
-
-        // --- 12. Multi-Select Autocomplete ---
-        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(', ')}]`);
-
-        // --- 13. Autocomplete Prompt ---
-        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 ---
-        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(', ')}]`);
-
-        // --- 14.1 Transfer Prompt (PickList) ---
-        const teamA = await MepCLI.transfer({
-            message: "Assign members to Team A (Space to move):",
-            source: ["Alice", "Bob", "Charlie", "David", "Eve"],
-            target: ["Frank"] // Pre-assigned
-        });
-        console.log(`\n Transfer Result: Team A: [${teamA[1].join(', ')}] (Remaining: [${teamA[0].join(', ')}])`);
-
-        // --- 15. Table Prompt ---
-        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'}`);
-
-        // --- 17. Editor Prompt ---
-        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`);
-
-        // --- 18. Keypress Prompt ---
-        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 ---
-        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. Form Prompt ---
-        const userDetails = await MepCLI.form({
-            message: "Enter User Details (Up/Down/Tab to navigate):",
-            fields: [
-                { name: "firstname", message: "First Name", initial: "John" },
-                { name: "lastname", message: "Last Name", validate: (v) => v.length > 0 ? true : "Required" },
-                { name: "email", message: "Email", validate: (v) => v.includes("@") || "Invalid email" },
-                { name: "role", message: "Job Role", initial: "Developer" }
-            ]
-        });
-        console.log(`\n Form Result: User: ${JSON.stringify(userDetails)}`);
-
-        // --- 21. Snippet Prompt ---
-        const commitMsg = await MepCLI.snippet({
-            message: "Compose Commit Message (Tab/Shift+Tab to navigate variables):",
-            template: "feat(${scope}): ${message} (Refs: #${issue})",
-            values: {
-                scope: "cli",
-                issue: "123"
-            }
-        });
-        console.log(`\n Snippet Result: "${commitMsg}"`);
-
-        // --- 22. Spam Prompt ---
-        const spamConfirmed = await MepCLI.spam({
-            message: "Hold on! Confirm deployment by mashing the Space key!",
-            threshold: 10,
-            decay: false, // We're not devil
-            spamKey: ' ' // Space key
-        });
-        console.log(`\n Spam Result: Deployment confirmed: ${spamConfirmed}`);
-
-        // --- 23. Wait Prompt ---
-        await MepCLI.wait({
-            message: "Please wait while we finalize the setup...",
-            seconds: 3, // Just 3 seconds for demo
-            autoSubmit: true // Automatically proceeds after time is up
-        });
-        console.log("\n Wait Result: Wait complete.");
-
-        // --- 24. Code Prompt ---
-        const config = await MepCLI.code({
-            message: "Configure Server (JSON) - Tab to nav:",
-            language: "json",
-            highlight: true, // Experimental syntax highlighting
-            template: `
-{
-  "host": "\${host}",
-  "port": \${port},
-  "debug": \${debug}
-}
-`
-        });
-        console.log(`\n Code Result: Config: ${config.replace(/\n/g, ' ')}`);
-
-        // --- 25. Tree Select Prompt ---
-        const selectedTreeItems = await MepCLI.treeSelect({
-             message: "Select files to backup (Multi-select Tree):",
-             data: [
-                 {
-                     title: "src",
-                     value: "src",
-                     children: [
-                         { title: "index.ts", value: "src/index.ts" },
-                         { title: "utils.ts", value: "src/utils.ts" }
-                     ]
-                 },
-                 {
-                     title: "tests",
-                     value: "tests",
-                     expanded: true,
-                     children: [
-                         { title: "e2e", value: "tests/e2e", selected: true },
-                         { title: "unit", value: "tests/unit" }
-                     ]
-                 }
-             ]
-        });
-        console.log(`\n TreeSelect Result: Selected: [${selectedTreeItems.join(', ')}]`);
-
-        // --- 26. Cron Prompt ---
-        const schedule = await MepCLI.cron({
-            message: "Set backup schedule (Cron):",
-            initial: "0 4 * * *" // Daily at 4:00 AM
-        });
-        console.log(`\n Cron Result: "${schedule}"`);
-
-        // --- 27. Color Prompt ---
-        const themeColor = await MepCLI.color({
-            message: "Pick your brand color (RGB):",
-            initial: "#6366f1"
-        });
-        console.log(`\n Color Result: "${themeColor}"`);
-
-        // --- 28. Grid Prompt ---
-        const permissions = await MepCLI.grid({
-            message: "Configure Access Permissions:",
-            rows: ["Admin", "User", "Guest"],
-            columns: ["Read", "Write", "Execute"]
-        });
-        console.log(`\n Grid Result: (Boolean Matrix)`, permissions);
-
-        // --- 29. Calendar Prompt ---
-        const bookingRange = await MepCLI.calendar({
-            message: "Select booking period:",
-            mode: "range"
-        });
-        console.log(`\n Calendar Result:`, bookingRange);
-
-        // --- 30. 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) {
-        // Global handler for Ctrl+C closure
-        if (e instanceof Error && e.message === 'User force closed') {
-             console.log("\nOperation cancelled by user (Ctrl+C).");
-        } else {
-             console.error("\nAn error occurred during prompt execution:", e);
-        }
-    }
-}
-
-runComprehensiveDemo();