@ijuantm/simpl-addon 2.5.0 → 2.6.0

package/install.js

@@ -81,6 +81,107 @@ const getSimplVersion = () => {
   return config.version;
 };
 
+// --- Argument parsing ---
+
+const parseArgs = (args) => {
+  const result = {addon: null, unknownFlags: [], help: false, list: false};
+
+  for (const arg of args) {
+    if (arg === '--help' || arg === '-h') {
+      result.help = true;
+      continue;
+    }
+    if (arg === '--list' || arg === '-l') {
+      result.list = true;
+      continue;
+    }
+
+    if (arg.startsWith('--addon=')) {
+      result.addon = arg.slice(8).trim() || null;
+      continue;
+    }
+    if (arg.startsWith('-a=')) {
+      result.addon = arg.slice(3).trim() || null;
+      continue;
+    }
+
+    if (arg.startsWith('-') && !arg.startsWith('--addon') && !arg.startsWith('-a')) {
+      result.unknownFlags.push(arg);
+      continue;
+    }
+
+    if (!arg.startsWith('-') && !result.addon) result.addon = arg;
+  }
+
+  return result;
+};
+
+const KNOWN_FLAGS = ['--addon', '-a', '--help', '-h', '--list', '-l'];
+
+const levenshtein = (a, b) => {
+  const m = a.length, n = b.length;
+  const dp = Array.from({length: m + 1}, (_, i) => Array.from({length: n + 1}, (_, j) => i === 0 ? j : j === 0 ? i : 0));
+
+  for (let i = 1; i <= m; i++)
+    for (let j = 1; j <= n; j++)
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+
+  return dp[m][n];
+};
+
+const closestMatch = (input, options) => {
+  let best = null, bestDist = Infinity;
+
+  for (const opt of options) {
+    const dist = levenshtein(input.toLowerCase(), opt.toLowerCase());
+    if (dist < bestDist) {
+      bestDist = dist;
+      best = opt;
+    }
+  }
+
+  return bestDist <= Math.max(3, Math.floor(input.length / 2)) ? best : null;
+};
+
+// --- Fuzzy addon resolution with interactive prompts ---
+
+const resolveAddon = async (input, addons) => {
+  if (addons.includes(input)) return input;
+
+  const suggestion = closestMatch(input, addons);
+  console.log();
+  log(`  ${COLORS.red}✗${COLORS.reset} Add-on ${COLORS.bold}${input}${COLORS.reset} not found`, 'red');
+
+  if (suggestion) {
+    log(`  ${COLORS.yellow}Did you mean:${COLORS.reset} ${COLORS.cyan}${suggestion}${COLORS.reset}?`);
+    console.log();
+
+    while (true) {
+      const answer = await promptUser(`  Use "${suggestion}"? ${COLORS.dim}(yes / no / list)${COLORS.reset}`);
+      const a = answer.toLowerCase();
+
+      if (a === 'yes' || a === 'y') return suggestion;
+      if (a === 'list') {
+        listAddons(addons);
+        break;
+      }
+      if (a === 'no' || a === 'n') break;
+
+      log(`  ${COLORS.dim}Please answer yes, no, or list${COLORS.reset}`);
+    }
+  }
+
+  console.log();
+  log(`  ${COLORS.bold}Available add-ons:${COLORS.reset}`, 'blue');
+  listAddons(addons);
+  console.log();
+  process.exit(1);
+};
+
+const listAddons = (addons) => addons.forEach((name, i) => log(`    ${COLORS.cyan}${i + 1}.${COLORS.reset} ${name}`));
+
+// --- Help ---
+
 const showHelp = () => {
   console.log();
   log(`  ╭${'─'.repeat(62)}╮`);
@@ -89,11 +190,13 @@ const showHelp = () => {
   console.log();
   log(`  ${COLORS.bold}Usage:${COLORS.reset}`, 'blue');
   log(`    ${COLORS.dim}npx @ijuantm/simpl-addon${COLORS.reset}`);
-  log(`    ${COLORS.dim}npx @ijuantm/simpl-addon <add-on>${COLORS.reset}`);
+  log(`    ${COLORS.dim}npx @ijuantm/simpl-addon --addon=<name>${COLORS.reset}`);
   log(`    ${COLORS.dim}npx @ijuantm/simpl-addon --help${COLORS.reset}`);
   console.log();
-  log(`  ${COLORS.bold}Commands:${COLORS.reset}`, 'blue');
-  log(`    ${COLORS.dim}--help, -h${COLORS.reset}    Show this help message`);
+  log(`  ${COLORS.bold}Options:${COLORS.reset}`, 'blue');
+  log(`    ${COLORS.dim}--addon=<name>, -a=<name>${COLORS.reset}    Add-on to install`);
+  log(`    ${COLORS.dim}--list, -l${COLORS.reset}                   List available add-ons`);
+  log(`    ${COLORS.dim}--help, -h${COLORS.reset}                   Show this help message`);
   console.log();
   log(`  ${COLORS.bold}Note:${COLORS.reset}`, 'blue');
   log(`    Run this command from the root of your Simpl project.`);
@@ -378,14 +481,27 @@ const mergeFiles = (toMerge) => {
 
 const main = async () => {
   const args = process.argv.slice(2);
-  const firstArg = args[0];
+  const parsed = parseArgs(args);
 
-  if (firstArg === '--help' || firstArg === '-h') {
+  if (parsed.help) {
     showHelp();
     process.exit(0);
   }
 
-  const directName = firstArg && !firstArg.startsWith('-') ? firstArg : null;
+  // Warn about unknown flags and suggest closest known ones
+  for (const flag of parsed.unknownFlags) {
+    const flagName = flag.includes('=') ? flag.slice(0, flag.indexOf('=')) : flag;
+    const suggestion = closestMatch(flagName, KNOWN_FLAGS);
+    console.log();
+    log(`  ${COLORS.yellow}⚠${COLORS.reset} Unknown option: ${COLORS.bold}${flag}${COLORS.reset}`, 'yellow');
+    if (suggestion) log(`  ${COLORS.dim}Did you mean ${COLORS.reset}${COLORS.cyan}${suggestion}${COLORS.reset}${COLORS.dim}?${COLORS.reset}`);
+  }
+
+  if (parsed.unknownFlags.length > 0) {
+    log(`  ${COLORS.dim}Run with --help to see all available options.${COLORS.reset}`);
+    console.log();
+    process.exit(1);
+  }
 
   let version;
 
@@ -442,7 +558,7 @@ const main = async () => {
     process.exit(1);
   }
 
-  if (!directName) {
+  if (!parsed.addon) {
     console.log();
     log('  🗄️ Fetching available add-ons...', 'bold');
   }
@@ -466,23 +582,22 @@ const main = async () => {
     process.exit(0);
   }
 
+  if (parsed.list) {
+    console.log();
+    log(`  ${COLORS.bold}Available add-ons:${COLORS.reset}`, 'blue');
+    listAddons(addons);
+    console.log();
+    process.exit(0);
+  }
+
   let addonName;
 
-  if (directName) {
-    if (!addons.includes(directName)) {
-      console.log();
-      log(`  ${COLORS.red}✗${COLORS.reset} Add-on ${COLORS.bold}${directName}${COLORS.reset} not found`, 'red');
-      console.log();
-      log(`  ${COLORS.bold}Available add-ons:${COLORS.reset}`, 'blue');
-      addons.forEach((name, index) => log(`    ${COLORS.cyan}${index + 1}.${COLORS.reset} ${name}`));
-      console.log();
-      process.exit(1);
-    }
-    addonName = directName;
+  if (parsed.addon) {
+    addonName = await resolveAddon(parsed.addon, addons);
   } else {
     console.log();
     log(`  ${COLORS.bold}Available add-ons:${COLORS.reset}`, 'blue');
-    addons.forEach((name, index) => log(`    ${COLORS.cyan}${index + 1}.${COLORS.reset} ${name}`));
+    listAddons(addons);
     console.log();
 
     while (true) {
@@ -505,7 +620,9 @@ const main = async () => {
         break;
       }
 
-      log(`  ${COLORS.red}✗${COLORS.reset} Invalid selection "${input}"`, 'red');
+      const suggestion = closestMatch(input, addons);
+      log(`  ${COLORS.red}✗${COLORS.reset} Invalid selection ${COLORS.bold}${input}${COLORS.reset}`, 'red');
+      if (suggestion) log(`  ${COLORS.dim}Did you mean ${COLORS.reset}${COLORS.cyan}${suggestion}${COLORS.reset}${COLORS.dim}?${COLORS.reset}`);
       console.log();
     }
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ijuantm/simpl-addon",
   "description": "CLI tool to install Simpl framework add-ons.",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "scripts": {
     "link": "npm link",
     "unlink": "npm unlink -g @ijuantm/simpl-addon"