kavoru 0.2.0 → 0.3.0

package/README.md

@@ -44,7 +44,7 @@ During setup you can pick which integrations to scaffold. Core is always include
 | `cron`      | Cron jobs              |
 | `docker`    | Dockerfile + Compose     |
 
-Interactive mode (TTY) shows a toggle menu after the project name. Non-interactive runs use the full stack unless you pass flags.
+Interactive mode (TTY) shows a checkbox menu (↑↓ move, Space toggle, Enter confirm). Non-interactive runs use the full stack unless you pass flags.
 
 ### Examples
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kavoru",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Scaffold a new Kavoru (Elysia + Bun) backend from the official template",
   "type": "module",
   "bin": {

package/src/prompts.ts

@@ -1,5 +1,4 @@
-import * as readline from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
+import { stdin, stdout } from "node:process";
 import {
   ALL_FEATURES,
   FEATURES,
@@ -9,70 +8,178 @@ import {
   formatFeatureSelection,
 } from "./features";
 
+const ESC = "\x1b";
+const dim = `${ESC}[2m`;
+const reset = `${ESC}[0m`;
+const cyan = `${ESC}[36m`;
+
 function cloneSelection(selection: FeatureSelection): FeatureSelection {
   return { ...selection };
 }
 
-function printFeatureMenu(selection: FeatureSelection) {
-  console.log();
-  console.log("Select optional features for your project:");
-  console.log(
-    "  Type a number to toggle · a = all · m = minimal · Enter = continue",
-  );
-  console.log();
+type KeyAction =
+  | "up"
+  | "down"
+  | "toggle"
+  | "confirm"
+  | "all"
+  | "minimal"
+  | "interrupt";
+
+const KEY_UP = ESC + "[A";
+const KEY_DOWN = ESC + "[B";
+const KEY_UP_ALT = ESC + "OA";
+const KEY_DOWN_ALT = ESC + "OB";
+
+function parseKeyInput(data: string): KeyAction | null {
+  if (data === "\u0003") return "interrupt";
+  if (data === "\r" || data === "\n") return "confirm";
+  if (data === " ") return "toggle";
+  if (data === "a" || data === "A") return "all";
+  if (data === "m" || data === "M") return "minimal";
+  if (data === KEY_UP || data === KEY_UP_ALT) return "up";
+  if (data === KEY_DOWN || data === KEY_DOWN_ALT) return "down";
+  return null;
+}
+
+function createKeyReader(onKey: (action: KeyAction) => void) {
+  let pending = "";
+
+  const onData = (chunk: string) => {
+    pending += chunk;
+
+    while (pending.length > 0) {
+      if (pending === ESC) return;
+
+      if (pending.startsWith(ESC)) {
+        if (pending.length < 3) return;
+
+        const action = parseKeyInput(pending.slice(0, 3));
+        if (action) {
+          pending = pending.slice(3);
+          onKey(action);
+          continue;
+        }
+
+        if (pending.startsWith(ESC + "O") && pending.length < 3) return;
+
+        pending = pending.slice(1);
+        continue;
+      }
+
+      const action = parseKeyInput(pending[0] ?? "");
+      pending = pending.slice(1);
+      if (action) onKey(action);
+    }
+  };
+
+  return onData;
+}
+
+function renderCheckboxMenu(
+  selection: FeatureSelection,
+  activeIndex: number,
+  lineCount: number,
+): number {
+  const lines: string[] = [
+    `${cyan}◆${reset} Select optional features ${dim}(↑↓ move · Space toggle · Enter confirm)${reset}`,
+    `${dim}  a = all · m = minimal${reset}`,
+    "",
+  ];
 
   FEATURES.forEach((feature, index) => {
-    const checked = selection[feature.id] ? "x" : " ";
-    console.log(
-      `  [${checked}] ${index + 1}. ${feature.label.padEnd(22)} ${feature.description}`,
+    const isActive = index === activeIndex;
+    const pointer = isActive ? `${cyan}❯${reset}` : " ";
+    const mark = selection[feature.id] ? "x" : " ";
+    const label = isActive ? `${cyan}${feature.label}${reset}` : feature.label;
+    lines.push(
+      ` ${pointer} [${mark}] ${label.padEnd(22)} ${dim}${feature.description}${reset}`,
     );
   });
 
-  console.log();
-  console.log(`  Selected: ${formatFeatureSelection(selection)}`);
-  console.log();
+  lines.push("", ` ${dim}Selected: ${formatFeatureSelection(selection)}${reset}`);
+
+  if (lineCount > 0) {
+    stdout.write(`${ESC}[${lineCount}A`);
+  }
+
+  for (const line of lines) {
+    stdout.write(`${ESC}[2K${ESC}[0G${line}\n`);
+  }
+
+  return lines.length;
+}
+
+function restoreTerminal(onData: (chunk: string) => void) {
+  stdin.off("data", onData);
+  if (stdin.isTTY) {
+    stdin.setRawMode(false);
+  }
+  stdin.pause();
+  stdout.write(`${ESC}[?25h`);
 }
 
 export async function promptFeatureSelection(
   initial: FeatureSelection = ALL_FEATURES,
 ): Promise<FeatureSelection> {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+  if (!stdin.isTTY || !stdout.isTTY) {
     return cloneSelection(initial);
   }
 
   const selection = cloneSelection(initial);
-  const rl = readline.createInterface({ input, output });
+  let activeIndex = 0;
+  let lineCount = 0;
 
-  try {
-    while (true) {
-      printFeatureMenu(selection);
-      const answer = (await rl.question("Toggle feature: ")).trim().toLowerCase();
+  stdout.write(`${ESC}[?25l`);
 
-      if (!answer) {
-        return selection;
-      }
-
-      if (answer === "a" || answer === "all") {
-        Object.assign(selection, ALL_FEATURES);
-        continue;
-      }
+  if (stdin.isTTY) {
+    stdin.setRawMode(true);
+  }
+  stdin.resume();
+  stdin.setEncoding("utf8");
 
-      if (answer === "m" || answer === "minimal") {
-        Object.assign(selection, MINIMAL_FEATURES);
-        continue;
+  return new Promise((resolve, reject) => {
+    const onKey = (action: KeyAction) => {
+      switch (action) {
+        case "up":
+          activeIndex =
+            (activeIndex - 1 + FEATURES.length) % FEATURES.length;
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "down":
+          activeIndex = (activeIndex + 1) % FEATURES.length;
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "toggle": {
+          const feature = FEATURES[activeIndex];
+          if (!feature) break;
+          selection[feature.id as FeatureId] = !selection[feature.id as FeatureId];
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        }
+        case "all":
+          Object.assign(selection, ALL_FEATURES);
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "minimal":
+          Object.assign(selection, MINIMAL_FEATURES);
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "confirm":
+          restoreTerminal(onData);
+          stdout.write("\n");
+          resolve(selection);
+          break;
+        case "interrupt":
+          restoreTerminal(onData);
+          stdout.write("\n");
+          reject(new Error("Feature selection cancelled."));
+          break;
       }
+    };
 
-      const index = Number.parseInt(answer, 10);
-      if (Number.isNaN(index) || index < 1 || index > FEATURES.length) {
-        console.log("Enter a number between 1 and 9, a, m, or press Enter.");
-        continue;
-      }
-
-      const feature = FEATURES[index - 1];
-      if (!feature) continue;
-      selection[feature.id as FeatureId] = !selection[feature.id as FeatureId];
-    }
-  } finally {
-    rl.close();
-  }
+    const onData = createKeyReader(onKey);
+    stdin.on("data", onData);
+    lineCount = renderCheckboxMenu(selection, activeIndex, 0);
+  });
 }