@kosdev-code/kos-ui-cli 2.1.0 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-cli",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "bin": {
     "kosui": "./src/lib/cli.mjs"
   },
@@ -9,6 +9,7 @@
   ],
   "type": "module",
   "dependencies": {
+    "chalk": "^5.3.0",
     "prettier": "^2.6.2",
     "rimraf": "^5.0.1",
     "plop": "^3.1.2",
@@ -20,7 +21,7 @@
   "main": "./src/index.js",
   "kos": {
     "build": {
-      "gitHash": "82fe4f624fff667405f0cd0cc6eb874031e807f4"
+      "gitHash": "ced64602bed23fe8386ffbada4657bec2503a42f"
     }
   },
   "publishConfig": {

package/src/lib/cli.mjs

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
+import chalk from "chalk";
 import figlet from "figlet";
 import minimist from "minimist";
 import nodePlop from "node-plop";
 import path, { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { clearCache } from "./utils/cache.mjs";
+import { buildNonInteractiveCommand, isRunningInteractively } from "./utils/command-builder.mjs";
 import { getGeneratorMetadata } from "./utils/generator-loader.mjs";
 
 const originalArgs = process.argv.slice(2);
@@ -772,6 +774,15 @@ async function launch() {
     results.failures.forEach((fail) => {
       console.error(fail.error || fail.message);
     });
+
+    // Output equivalent non-interactive command when running interactively
+    if (isRunningInteractively(parsedArgs, hasAnyAnswers) && results.failures.length === 0 && !hasQuiet) {
+      const commandString = buildNonInteractiveCommand(command, answers, meta);
+      if (commandString) {
+        console.log(chalk.cyan("\n[kos-cli] Equivalent non-interactive command:"));
+        console.log(chalk.green(`  ${commandString}`));
+      }
+    }
   } catch (err) {
     console.error("[kos-cli] Generator run failed:", err.message);
     process.exit(1);

package/src/lib/utils/command-builder.mjs

@@ -0,0 +1,94 @@
+/**
+ * Builds a non-interactive command string from interactive session answers
+ * This helps users understand how to run the same command without prompts
+ */
+
+/**
+ * Converts interactive prompt answers back to CLI command arguments
+ * @param {string} command - The generator command name
+ * @param {Object} answers - The answers collected from prompts
+ * @param {Object} meta - Generator metadata including namedArguments mapping
+ * @returns {string|null} The equivalent CLI command string, or null if cannot be built
+ */
+export function buildNonInteractiveCommand(command, answers, meta) {
+  if (!meta?.namedArguments) {
+    return null;
+  }
+
+  const args = [`kosui ${command}`];
+  const reverseMap = {};
+
+  // Create reverse mapping from prompt names to CLI arguments
+  Object.entries(meta.namedArguments).forEach(([cliArg, promptName]) => {
+    // Skip special flags that don't map to prompts
+    if (cliArg !== "interactive" && cliArg !== "dryRun") {
+      reverseMap[promptName] = cliArg;
+    }
+  });
+
+  // Build command arguments from answers
+  Object.entries(answers).forEach(([promptName, value]) => {
+    const cliArg = reverseMap[promptName];
+    if (cliArg && value !== undefined && value !== null && value !== "") {
+      args.push(formatArgument(cliArg, value));
+    }
+  });
+
+  // Add dryRun if it was provided
+  if (answers.dryRun) {
+    args.push("--dryRun");
+  }
+
+  return args.join(" ");
+}
+
+/**
+ * Formats a single CLI argument based on its value type
+ * @param {string} argName - The CLI argument name
+ * @param {any} value - The value for the argument
+ * @returns {string} The formatted CLI argument string
+ */
+function formatArgument(argName, value) {
+  // Handle boolean values
+  if (typeof value === "boolean") {
+    if (value) {
+      return `--${argName}`;
+    } else {
+      // For false booleans, explicitly set to false
+      // This ensures the command can be replicated exactly
+      return `--${argName}=false`;
+    }
+  }
+
+  // Handle string/number values
+  const stringValue = String(value);
+
+  // Check if value needs escaping
+  if (needsEscaping(stringValue)) {
+    // Use double quotes and escape internal quotes
+    return `--${argName}="${stringValue.replace(/"/g, '\\"')}"`;
+  }
+
+  return `--${argName}=${stringValue}`;
+}
+
+/**
+ * Determines if a string value needs shell escaping
+ * @param {string} value - The value to check
+ * @returns {boolean} True if the value needs escaping
+ */
+function needsEscaping(value) {
+  // Check for characters that need escaping in shell
+  return /[\s'"$`\\!]/.test(value);
+}
+
+/**
+ * Determines if the CLI is running in interactive mode
+ * @param {Object} parsedArgs - Parsed command line arguments
+ * @param {boolean} hasAnyAnswers - Whether any answers were provided via CLI
+ * @returns {boolean} True if running in interactive mode
+ */
+export function isRunningInteractively(parsedArgs, hasAnyAnswers) {
+  const forceInteractive = parsedArgs.interactive || parsedArgs.i;
+  return forceInteractive || (!hasAnyAnswers && !parsedArgs.help);
+}