opencastle 0.5.1 → 0.7.0

package/src/cli/prompt.ts

@@ -2,6 +2,31 @@ import { createInterface, type Interface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
 import type { SelectOption } from './types.js';
 
+// ── ANSI helpers ──────────────────────────────────────────────────
+
+const ESC = '\x1B';
+const CSI = `${ESC}[`;
+const HIDE_CURSOR = `${CSI}?25l`;
+const SHOW_CURSOR = `${CSI}?25h`;
+const ERASE_LINE = `${CSI}2K`;
+
+function moveUp(n: number): string {
+  return n > 0 ? `${CSI}${n}A` : '';
+}
+
+// ── Color helpers ─────────────────────────────────────────────────
+
+/** ANSI color helpers for CLI output. */
+export const c = {
+  cyan: (s: string) => `\x1B[36m${s}\x1B[0m`,
+  green: (s: string) => `\x1B[32m${s}\x1B[0m`,
+  yellow: (s: string) => `\x1B[33m${s}\x1B[0m`,
+  red: (s: string) => `\x1B[31m${s}\x1B[0m`,
+  bold: (s: string) => `\x1B[1m${s}\x1B[0m`,
+  dim: (s: string) => `\x1B[2m${s}\x1B[0m`,
+  magenta: (s: string) => `\x1B[35m${s}\x1B[0m`,
+};
+
 // ── Line-buffered readline ────────────────────────────────────────
 // readline.question() drops lines that arrived between calls because
 // it only listens for the NEXT 'line' event.  When piped input
@@ -70,10 +95,121 @@ export function closePrompts(): void {
 
 /**
  * Interactive single-choice selection prompt.
+ *
+ * TTY mode:  arrow-key navigation (↑/↓) with Enter to confirm.
+ * Piped mode: falls back to number-based selection for scripts.
  */
 export async function select(
   message: string,
   options: SelectOption[]
+): Promise<string> {
+  if (stdin.isTTY) {
+    return selectInteractive(message, options);
+  }
+  return selectNumbered(message, options);
+}
+
+// ── Arrow-key selection (TTY) ─────────────────────────────────────
+
+function renderOptions(
+  options: SelectOption[],
+  cursor: number,
+  initial: boolean
+): void {
+  // Move back up to overwrite previous render (skip on first draw)
+  if (!initial) {
+    stdout.write(moveUp(options.length));
+  }
+
+  for (let i = 0; i < options.length; i++) {
+    const active = i === cursor;
+    const marker = active ? '❯' : ' ';
+    const hint = options[i].hint ? ` — ${options[i].hint}` : '';
+    const label = active
+      ? `\x1B[36m${options[i].label}\x1B[0m${hint}`
+      : `${options[i].label}${hint}`;
+    stdout.write(`${ERASE_LINE}\r    ${marker} ${label}\n`);
+  }
+}
+
+function selectInteractive(
+  message: string,
+  options: SelectOption[]
+): Promise<string> {
+  return new Promise<string>((resolve) => {
+    let cursor = 0;
+
+    // Pause the readline interface so raw mode can take over
+    if (_rl) _rl.pause();
+
+    stdout.write(`\n  ${message}\n\n`);
+    stdout.write(HIDE_CURSOR);
+    renderOptions(options, cursor, true);
+
+    stdin.setRawMode(true);
+    stdin.resume();
+
+    const onData = (data: Buffer): void => {
+      const key = data.toString();
+
+      // Arrow up or k
+      if (key === `${ESC}[A` || key === 'k') {
+        cursor = (cursor - 1 + options.length) % options.length;
+        renderOptions(options, cursor, false);
+        return;
+      }
+
+      // Arrow down or j
+      if (key === `${ESC}[B` || key === 'j') {
+        cursor = (cursor + 1) % options.length;
+        renderOptions(options, cursor, false);
+        return;
+      }
+
+      // Enter
+      if (key === '\r' || key === '\n') {
+        cleanup();
+        // Re-render final state with the selected option highlighted
+        stdout.write(moveUp(options.length));
+        for (let i = 0; i < options.length; i++) {
+          const active = i === cursor;
+          const hint = options[i].hint ? ` — ${options[i].hint}` : '';
+          const label = active
+            ? `\x1B[36m${options[i].label}\x1B[0m${hint}`
+            : `\x1B[2m${options[i].label}${hint}\x1B[0m`;
+          const marker = active ? '✔' : ' ';
+          stdout.write(`${ERASE_LINE}\r    ${marker} ${label}\n`);
+        }
+        stdout.write('\n');
+        resolve(options[cursor].value);
+        return;
+      }
+
+      // Ctrl+C
+      if (key === '\x03') {
+        cleanup();
+        stdout.write('\n');
+        process.exit(130);
+      }
+    };
+
+    function cleanup(): void {
+      stdin.removeListener('data', onData);
+      stdin.setRawMode(false);
+      stdout.write(SHOW_CURSOR);
+      // Resume readline for subsequent confirm() calls
+      if (_rl) _rl.resume();
+    }
+
+    stdin.on('data', onData);
+  });
+}
+
+// ── Number-based selection (piped / non-TTY) ──────────────────────
+
+async function selectNumbered(
+  message: string,
+  options: SelectOption[]
 ): Promise<string> {
   console.log(`\n  ${message}\n`);
   options.forEach((opt, i) => {
@@ -113,3 +249,166 @@ export async function confirm(
   if (!answer.trim()) return defaultYes;
   return answer.trim().toLowerCase().startsWith('y');
 }
+
+// ── Multiselect ───────────────────────────────────────────────────
+
+/**
+ * Interactive multi-choice selection prompt.
+ *
+ * TTY mode:  arrow-key navigation (↑/↓), Space to toggle, Enter to confirm.
+ * Piped mode: falls back to comma-separated number input.
+ *
+ * Returns an array of selected values (possibly empty).
+ */
+export async function multiselect(
+  message: string,
+  options: SelectOption[]
+): Promise<string[]> {
+  if (stdin.isTTY) {
+    return multiselectInteractive(message, options);
+  }
+  return multiselectNumbered(message, options);
+}
+
+// ── Arrow-key multiselect (TTY) ───────────────────────────────────
+
+function renderMultiselectOptions(
+  options: SelectOption[],
+  cursor: number,
+  selected: Set<number>,
+  initial: boolean
+): void {
+  if (!initial) {
+    stdout.write(moveUp(options.length));
+  }
+
+  for (let i = 0; i < options.length; i++) {
+    const active = i === cursor;
+    const checked = selected.has(i);
+    const checkbox = checked ? `\x1B[32m✔\x1B[0m` : ' ';
+    const marker = active ? '❯' : ' ';
+    const hint = options[i].hint ? ` ${c.dim('—')} ${c.dim(options[i].hint!)}` : '';
+    const label = active
+      ? `\x1B[36m${options[i].label}\x1B[0m${hint}`
+      : `${options[i].label}${hint}`;
+    stdout.write(`${ERASE_LINE}\r    ${marker} [${checkbox}] ${label}\n`);
+  }
+}
+
+function multiselectInteractive(
+  message: string,
+  options: SelectOption[]
+): Promise<string[]> {
+  return new Promise<string[]>((resolve) => {
+    let cursor = 0;
+    const selected = new Set<number>();
+    // Pre-select options marked as selected
+    for (let i = 0; i < options.length; i++) {
+      if (options[i].selected) selected.add(i);
+    }
+
+    if (_rl) _rl.pause();
+
+    stdout.write(`\n  ${message} ${c.dim('(↑/↓ navigate, Space toggle, Enter confirm)')}\n\n`);
+    stdout.write(HIDE_CURSOR);
+    renderMultiselectOptions(options, cursor, selected, true);
+
+    stdin.setRawMode(true);
+    stdin.resume();
+
+    const onData = (data: Buffer): void => {
+      const key = data.toString();
+
+      // Arrow up or k
+      if (key === `${ESC}[A` || key === 'k') {
+        cursor = (cursor - 1 + options.length) % options.length;
+        renderMultiselectOptions(options, cursor, selected, false);
+        return;
+      }
+
+      // Arrow down or j
+      if (key === `${ESC}[B` || key === 'j') {
+        cursor = (cursor + 1) % options.length;
+        renderMultiselectOptions(options, cursor, selected, false);
+        return;
+      }
+
+      // Space — toggle selection
+      if (key === ' ') {
+        if (selected.has(cursor)) {
+          selected.delete(cursor);
+        } else {
+          selected.add(cursor);
+        }
+        renderMultiselectOptions(options, cursor, selected, false);
+        return;
+      }
+
+      // Enter — confirm
+      if (key === '\r' || key === '\n') {
+        cleanup();
+        // Final render
+        stdout.write(moveUp(options.length));
+        for (let i = 0; i < options.length; i++) {
+          const checked = selected.has(i);
+          const hint = options[i].hint ? ` ${c.dim('—')} ${c.dim(options[i].hint!)}` : '';
+          const checkbox = checked ? `\x1B[32m✔\x1B[0m` : ' ';
+          const label = checked
+            ? `\x1B[36m${options[i].label}\x1B[0m${hint}`
+            : `\x1B[2m${options[i].label}${hint}\x1B[0m`;
+          stdout.write(`${ERASE_LINE}\r      [${checkbox}] ${label}\n`);
+        }
+        stdout.write('\n');
+        resolve(Array.from(selected).sort().map(i => options[i].value));
+        return;
+      }
+
+      // Ctrl+C
+      if (key === '\x03') {
+        cleanup();
+        stdout.write('\n');
+        process.exit(130);
+      }
+    };
+
+    function cleanup(): void {
+      stdin.removeListener('data', onData);
+      stdin.setRawMode(false);
+      stdout.write(SHOW_CURSOR);
+      if (_rl) _rl.resume();
+    }
+
+    stdin.on('data', onData);
+  });
+}
+
+// ── Number-based multiselect (piped / non-TTY) ────────────────────
+
+async function multiselectNumbered(
+  message: string,
+  options: SelectOption[]
+): Promise<string[]> {
+  console.log(`\n  ${message}\n`);
+  options.forEach((opt, i) => {
+    const hint = opt.hint ? ` — ${opt.hint}` : '';
+    console.log(`    ${i + 1}) ${opt.label}${hint}`);
+  });
+
+  const preselected = options
+    .map((opt, i) => (opt.selected ? i + 1 : null))
+    .filter((n): n is number => n !== null);
+  const defaultHint = preselected.length > 0 ? preselected.join(',') : 'none';
+  const answer = await nextLine(`\n  Select [comma-separated, e.g. 1,3] or Enter for ${defaultHint}: `);
+  if (!answer.trim()) {
+    return preselected.map(n => options[n - 1].value);
+  }
+
+  const nums = answer.split(',').map(s => parseInt(s.trim(), 10));
+  const result: string[] = [];
+  for (const num of nums) {
+    if (num >= 1 && num <= options.length) {
+      result.push(options[num - 1].value);
+    }
+  }
+  return result;
+}