intor-cli 0.0.14 → 0.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor-cli",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "The Intor CLI",
   "author": "Yiming Liao",
   "homepage": "https://github.com/yiming-liao/intor-cli#readme",
@@ -39,6 +39,7 @@
     "intor": "src/cli/index.ts"
   },
   "dependencies": {
+    "@clack/prompts": "^1.0.0",
     "@intor/reader-json5": "^0.1.0",
     "@intor/reader-md": "^0.1.4",
     "@intor/reader-toml": "^0.1.0",

package/src/cli/index.ts

@@ -4,23 +4,34 @@ import { cac } from "cac";
 import { registerCheckCommand } from "./commands/check";
 import { registerGenerateCommand } from "./commands/generate";
 import { registerValidateCommand } from "./commands/validate";
+import { runInteractive } from "./interactive/run";
 
-const cli = cac("intor");
-
-// ---------------------------------------------------------------------
-// Register commands
-// ---------------------------------------------------------------------
-registerGenerateCommand(cli);
-registerCheckCommand(cli);
-registerValidateCommand(cli);
-
-// ---------------------------------------------------------------------
-// Global options / help
-// ---------------------------------------------------------------------
-cli.help();
-cli.version("0.1.10");
-
-// ---------------------------------------------------------------------
-// Parse argv
-// ---------------------------------------------------------------------
-cli.parse();
+const VERSION = "0.1.10";
+
+async function main() {
+  // argv = [node, script, ...args]
+  const args = process.argv.slice(2);
+
+  // -------------------------------------------------------------------
+  // Interactive mode bypasses CAC entirely
+  // -------------------------------------------------------------------
+  if (args.length === 0) {
+    await runInteractive();
+    return;
+  }
+
+  // -------------------------------------------------------------------
+  // Command mode (original CAC behavior)
+  // -------------------------------------------------------------------
+  const cli = cac("intor");
+
+  registerGenerateCommand(cli);
+  registerCheckCommand(cli);
+  registerValidateCommand(cli);
+
+  cli.help();
+  cli.version(VERSION);
+  cli.parse(process.argv);
+}
+
+await main();

package/src/cli/interactive/prompt-generate.ts

@@ -0,0 +1,121 @@
+import type { ExtraExt } from "../../core";
+import type { GenerateOptions } from "../../features/generate/generate";
+import {
+  text,
+  multiselect,
+  confirm,
+  isCancel,
+  select,
+  note,
+} from "@clack/prompts";
+
+export async function promptGenerate(): Promise<GenerateOptions | null> {
+  // ------------------------------------------------------------------
+  // Mode selection
+  // ------------------------------------------------------------------
+  const mode = await select({
+    message: "Generate mode?",
+    options: [
+      { value: "default", label: "Default (recommended)" },
+      { value: "custom", label: "Custom configuration" },
+    ],
+  });
+  if (isCancel(mode)) return null;
+  if (mode === "default") return {};
+
+  const options: GenerateOptions = {};
+
+  // ------------------------------------------------------------------
+  // messageFilePath
+  // ------------------------------------------------------------------
+  const useCustomPath = await confirm({
+    message: "Do you want to configure the messages path?",
+    initialValue: false,
+  });
+  if (isCancel(useCustomPath)) return null;
+
+  if (useCustomPath) {
+    const messageFilePath = await text({
+      message: "Where are your message files located?",
+      placeholder: "messages",
+      defaultValue: "messages",
+    });
+    if (isCancel(messageFilePath)) return null;
+    options.messageFilePath = messageFilePath || undefined;
+  }
+
+  // ------------------------------------------------------------------
+  // extra extensions
+  // ------------------------------------------------------------------
+  const enableExts = await confirm({
+    message: "Enable extra message file extensions?",
+    initialValue: false,
+  });
+  if (isCancel(enableExts)) return null;
+
+  if (enableExts) {
+    const exts = await multiselect<ExtraExt>({
+      message: "Select extra extensions to enable",
+      options: [
+        { value: "md", label: "Markdown (.md)" },
+        { value: "yaml", label: "YAML (.yaml/.yml)" },
+        { value: "toml", label: "TOML (.toml)" },
+        { value: "json5", label: "JSON5 (.json5)" },
+      ],
+      required: false,
+    });
+    if (isCancel(exts)) return null;
+    options.exts = exts;
+  }
+
+  // ------------------------------------------------------------------
+  // custom readers
+  // ------------------------------------------------------------------
+  const enableCustomReaders = await confirm({
+    message: "Do you want to configure custom readers?",
+    initialValue: false,
+  });
+  if (isCancel(enableCustomReaders)) return null;
+
+  if (enableCustomReaders) {
+    const mapping = await text({
+      message: "Enter custom reader mappings (ext=path, comma separated)",
+      placeholder: "md=./reader-md.ts, csv=./reader-csv.ts",
+    });
+    if (isCancel(mapping)) return null;
+    options.customReaders = Object.fromEntries(
+      mapping
+        .split(",")
+        .map((pair) => pair.trim())
+        .filter(Boolean)
+        .map((pair) => pair.split("=") as [string, string]),
+    );
+  }
+
+  // ------------------------------------------------------------------
+  // debug
+  // ------------------------------------------------------------------
+  const debug = await confirm({
+    message: "Enable debug mode?",
+    initialValue: false,
+  });
+  if (isCancel(debug)) return null;
+  if (debug) options.debug = true;
+
+  // ------------------------------------------------------------------
+  // summary
+  // ------------------------------------------------------------------
+  note(
+    `messages path: ${options.messageFilePath ?? "(default)"}\n` +
+      `exts: ${options.exts?.join(", ") ?? "(none)"}\n` +
+      `custom readers: ${
+        options.customReaders
+          ? Object.keys(options.customReaders).join(", ")
+          : "(none)"
+      }\n` +
+      `debug: ${options.debug ? "on" : "off"}`,
+    "Generate options",
+  );
+
+  return options;
+}

package/src/cli/interactive/prompt-validate.ts

@@ -0,0 +1,101 @@
+import type { ExtraExt } from "../../core";
+import type { ValidateOptions } from "../../features/validate/validate";
+import {
+  select,
+  confirm,
+  multiselect,
+  text,
+  isCancel,
+  note,
+} from "@clack/prompts";
+
+export async function promptValidate(): Promise<ValidateOptions | null> {
+  // ------------------------------------------------------------------
+  // Mode selection
+  // ------------------------------------------------------------------
+  const mode = await select({
+    message: "Validate mode?",
+    options: [
+      { value: "default", label: "Default (recommended)" },
+      { value: "custom", label: "Custom configuration" },
+    ],
+  });
+  if (isCancel(mode)) return null;
+  if (mode === "default") return {};
+
+  const options: ValidateOptions = {};
+
+  // ------------------------------------------------------------------
+  // extra extensions
+  // ------------------------------------------------------------------
+  const enableExts = await confirm({
+    message: "Enable extra message file extensions?",
+    initialValue: false,
+  });
+  if (isCancel(enableExts)) return null;
+
+  if (enableExts) {
+    const exts = await multiselect<ExtraExt>({
+      message: "Select extra extensions to enable",
+      options: [
+        { value: "md", label: "Markdown (.md)" },
+        { value: "yaml", label: "YAML (.yaml/.yml)" },
+        { value: "toml", label: "TOML (.toml)" },
+        { value: "json5", label: "JSON5 (.json5)" },
+      ],
+      required: false,
+    });
+    if (isCancel(exts)) return null;
+    options.exts = exts;
+  }
+
+  // ------------------------------------------------------------------
+  // custom readers
+  // ------------------------------------------------------------------
+  const enableCustomReaders = await confirm({
+    message: "Do you want to configure custom readers?",
+    initialValue: false,
+  });
+  if (isCancel(enableCustomReaders)) return null;
+
+  if (enableCustomReaders) {
+    const mapping = await text({
+      message: "Enter custom reader mappings (ext=path, comma separated)",
+      placeholder: "md=./reader-md.ts",
+    });
+    if (isCancel(mapping)) return null;
+    options.customReaders = Object.fromEntries(
+      mapping
+        .split(",")
+        .map((pair) => pair.trim())
+        .filter(Boolean)
+        .map((pair) => pair.split("=") as [string, string]),
+    );
+  }
+
+  // ------------------------------------------------------------------
+  // debug
+  // ------------------------------------------------------------------
+  const debug = await confirm({
+    message: "Enable debug mode?",
+    initialValue: false,
+  });
+  if (isCancel(debug)) return null;
+  if (debug) options.debug = true;
+
+  // ------------------------------------------------------------------
+  // Summary
+  // ------------------------------------------------------------------
+  note(
+    `exts: ${options.exts?.join(", ") ?? "(none)"}\n` +
+      `custom readers: ${
+        options.customReaders
+          ? Object.keys(options.customReaders).join(", ")
+          : "(none)"
+      }\n` +
+      `debug: ${options.debug ? "on" : "off"}`,
+    "Validate options",
+  );
+
+  return options;
+}

package/src/cli/interactive/run.ts

@@ -0,0 +1,64 @@
+/* eslint-disable unicorn/no-process-exit */
+import { intro, outro, select, isCancel } from "@clack/prompts";
+import pc from "picocolors";
+import { check, generate, validate } from "../../features";
+import { promptGenerate } from "./prompt-generate";
+import { promptValidate } from "./prompt-validate";
+
+export function introBanner() {
+  intro(
+    pc.cyan(`
+  ▄▄ ▄▄  ▄▄ ▄▄▄▄▄▄ ▄▄▄  ▄▄▄▄  
+  ██ ███▄██   ██  ██▀██ ██▄█▄ 
+  ██ ██ ▀██   ██  ▀███▀ ██ ██  
+`),
+  );
+}
+
+export async function runInteractive() {
+  introBanner();
+
+  const action = await select({
+    message: "Select an action",
+    options: [
+      { value: "check", label: "Check translation usages" },
+      { value: "generate", label: "Generate types & schemas" },
+      { value: "validate", label: "Validate messages" },
+      { value: "exit", label: "Exit" },
+    ],
+  });
+
+  if (isCancel(action) || action === "exit") {
+    outro("Exited");
+    process.exit(0);
+  }
+
+  switch (action) {
+    case "check": {
+      await check();
+      break;
+    }
+
+    case "generate": {
+      const options = await promptGenerate();
+      if (!options) {
+        outro(pc.dim("Cancelled"));
+        process.exit(0);
+      }
+      await generate(options);
+      break;
+    }
+
+    case "validate": {
+      const options = await promptValidate();
+      if (!options) {
+        outro("Cancelled");
+        process.exit(0);
+      }
+      await validate(options);
+      break;
+    }
+  }
+
+  outro(pc.green("Completed"));
+}