task-summary-extractor 9.4.0 → 9.6.0

package/src/utils/interactive.js

@@ -0,0 +1,356 @@
+/**
+ * Interactive prompt engine — zero dependencies, arrow-key navigation.
+ *
+ * Provides:
+ *   selectOne()   — single-select with ↑↓ arrows + Enter
+ *   selectMany()  — multi-select with ↑↓ arrows + Space (toggle) + Enter (confirm)
+ *
+ * Falls back to number input when stdin is not a TTY.
+ *
+ * Rendering strategy:
+ *   After every draw(), the terminal cursor sits on the LAST rendered line
+ *   (bottom of the block).  Before each subsequent redraw we move UP by
+ *   (totalRenderedLines − 1) to reach the first item line, then overwrite
+ *   every line top-to-bottom.  This keeps positioning deterministic and
+ *   avoids the overlap / garble bugs of relative-to-highlight approaches.
+ */
+
+'use strict';
+
+const { c, strip } = require('./colors');
+
+// ── ANSI helpers ──────────────────────────────────────────────────────────────
+
+const HIDE_CURSOR = '\x1b[?25l';
+const SHOW_CURSOR = '\x1b[?25h';
+const CLEAR_LINE  = '\x1b[2K';
+
+/** Move cursor up N lines */
+const UP   = (n) => n > 0 ? `\x1b[${n}A` : '';
+/** Move cursor down N lines */
+const DOWN = (n) => n > 0 ? `\x1b[${n}B` : '';
+/** Carriage return — column 0 */
+const CR   = '\r';
+
+// ── Render helpers ────────────────────────────────────────────────────────────
+
+/**
+ * Build display strings for each item.
+ *
+ * @param {Array<{label: string, hint?: string}>} items
+ * @param {number}      cursor   Currently highlighted index
+ * @param {Set<number>} [selected]  For multi-select: selected indices
+ * @param {boolean}     [multi=false]
+ * @returns {string[]}
+ */
+function renderList(items, cursor, selected, multi = false) {
+  return items.map((item, i) => {
+    const isCursor = i === cursor;
+    const prefix = isCursor ? c.cyan('❯') : ' ';
+
+    let checkbox = '';
+    if (multi) {
+      const isChecked = selected && selected.has(i);
+      checkbox = isChecked ? c.green(' ◉') : c.dim(' ○');
+    }
+
+    const label = isCursor ? c.bold(c.cyan(strip(item.label))) : item.label;
+    const hint  = item.hint
+      ? (isCursor ? c.dim(` ${strip(item.hint)}`) : c.dim(` ${item.hint}`))
+      : '';
+
+    return `  ${prefix}${checkbox} ${label}${hint}`;
+  });
+}
+
+/**
+ * Write an array of strings to stdout, one per line.
+ * Each line is preceded by CR + CLEAR_LINE so the entire row is wiped first.
+ */
+function writeLines(lines) {
+  for (let i = 0; i < lines.length; i++) {
+    if (i > 0) process.stdout.write('\n');
+    process.stdout.write(`${CR}${CLEAR_LINE}${lines[i]}`);
+  }
+}
+
+// ── Key decoder ───────────────────────────────────────────────────────────────
+
+/**
+ * Decode a raw keypress buffer into a named action.
+ * @param {Buffer} buf
+ * @returns {'up'|'down'|'space'|'enter'|'escape'|'a'|null}
+ */
+function decodeKey(buf) {
+  if (buf[0] === 0x1b && buf[1] === 0x5b) {
+    if (buf[2] === 0x41) return 'up';
+    if (buf[2] === 0x42) return 'down';
+    return null;
+  }
+  if (buf[0] === 0x0d || buf[0] === 0x0a) return 'enter';
+  if (buf[0] === 0x20) return 'space';
+  if (buf[0] === 0x03) return 'escape';
+  if (buf[0] === 0x61 || buf[0] === 0x41) return 'a';
+  return null;
+}
+
+// ── Core: selectOne ───────────────────────────────────────────────────────────
+
+/**
+ * Interactive single-select with arrow-key navigation.
+ *
+ * @param {Object} opts
+ * @param {string}  opts.title   - Heading text (printed once)
+ * @param {Array<{label: string, hint?: string, value: any}>} opts.items
+ * @param {number}  [opts.default=0]  - Default highlighted index
+ * @param {string}  [opts.footer]     - Hint line below the list
+ * @returns {Promise<{index: number, value: any}>}
+ */
+function selectOne({ title, items, default: defaultIdx = 0, footer }) {
+  if (!process.stdin.isTTY) {
+    return _fallbackSelectOne({ title, items, default: defaultIdx });
+  }
+
+  return new Promise((resolve) => {
+    let cursor = defaultIdx;
+    const total = items.length;
+    const hasFooter = !!footer;
+    const renderedLines = total + (hasFooter ? 1 : 0); // lines we overwrite
+    let firstDraw = true;
+
+    // ── Title (printed once, never overwritten) ────────
+    if (title) {
+      console.log('');
+      console.log(`  ${title}`);
+      console.log(c.dim('  ' + '─'.repeat(60)));
+    }
+
+    process.stdout.write(HIDE_CURSOR);
+
+    // ── Draw / redraw ──────────────────────────────────
+    const draw = () => {
+      if (!firstDraw) {
+        // Terminal cursor is on the last rendered line — go back to first
+        process.stdout.write(UP(renderedLines - 1) + CR);
+      }
+      const lines = renderList(items, cursor);
+      writeLines(lines);
+      if (hasFooter) {
+        process.stdout.write('\n');
+        process.stdout.write(`${CR}${CLEAR_LINE}${c.dim(`  ${footer}`)}`);
+      }
+      // Terminal cursor is now on the LAST rendered line
+      firstDraw = false;
+    };
+
+    draw(); // initial render
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+
+    const cleanup = () => {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeListener('data', onKey);
+      process.stdout.write(CR + SHOW_CURSOR + '\n');
+    };
+
+    const onKey = (buf) => {
+      const key = decodeKey(buf);
+      if (key === 'up') {
+        cursor = (cursor - 1 + total) % total;
+        draw();
+      } else if (key === 'down') {
+        cursor = (cursor + 1) % total;
+        draw();
+      } else if (key === 'enter') {
+        cleanup();
+        const chosen = items[cursor];
+        console.log(c.success(`${strip(chosen.label)}`));
+        resolve({ index: cursor, value: chosen.value });
+      } else if (key === 'escape') {
+        cleanup();
+        const chosen = items[defaultIdx];
+        console.log(c.success(`${strip(chosen.label)}`));
+        resolve({ index: defaultIdx, value: chosen.value });
+      }
+    };
+
+    process.stdin.on('data', onKey);
+  });
+}
+
+// ── Core: selectMany ──────────────────────────────────────────────────────────
+
+/**
+ * Interactive multi-select with arrow-key navigation + Space toggle.
+ *
+ * @param {Object} opts
+ * @param {string}  opts.title
+ * @param {Array<{label: string, hint?: string, value: any}>} opts.items
+ * @param {Set<number>} [opts.defaultSelected]  - Pre-selected indices
+ * @param {string}  [opts.footer]
+ * @returns {Promise<{indices: number[], values: any[]}>}
+ */
+function selectMany({ title, items, defaultSelected, footer }) {
+  if (!process.stdin.isTTY) {
+    return _fallbackSelectMany({ title, items, defaultSelected });
+  }
+
+  return new Promise((resolve) => {
+    let cursor = 0;
+    const selected = new Set(defaultSelected || []);
+    const total = items.length;
+
+    const footerText = footer || '↑↓ navigate · Space toggle · A all/none · Enter confirm';
+    const renderedLines = total + 1; // items + footer (always shown)
+    let firstDraw = true;
+
+    if (title) {
+      console.log('');
+      console.log(`  ${title}`);
+      console.log(c.dim('  ' + '─'.repeat(60)));
+    }
+
+    process.stdout.write(HIDE_CURSOR);
+
+    const draw = () => {
+      if (!firstDraw) {
+        process.stdout.write(UP(renderedLines - 1) + CR);
+      }
+      const lines = renderList(items, cursor, selected, true);
+      writeLines(lines);
+      process.stdout.write('\n');
+      process.stdout.write(`${CR}${CLEAR_LINE}${c.dim(`  ${footerText}`)}`);
+      firstDraw = false;
+    };
+
+    draw();
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+
+    const cleanup = () => {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeListener('data', onKey);
+      process.stdout.write(CR + SHOW_CURSOR + '\n');
+    };
+
+    const onKey = (buf) => {
+      const key = decodeKey(buf);
+      if (key === 'up') {
+        cursor = (cursor - 1 + total) % total;
+        draw();
+      } else if (key === 'down') {
+        cursor = (cursor + 1) % total;
+        draw();
+      } else if (key === 'space') {
+        if (selected.has(cursor)) selected.delete(cursor);
+        else selected.add(cursor);
+        draw();
+      } else if (key === 'a') {
+        if (selected.size === total) selected.clear();
+        else { for (let i = 0; i < total; i++) selected.add(i); }
+        draw();
+      } else if (key === 'enter') {
+        cleanup();
+        const indices = [...selected].sort((a, b) => a - b);
+        const values  = indices.map(i => items[i].value);
+        const labels  = indices.map(i => strip(items[i].label));
+        if (labels.length === 0) {
+          console.log(c.dim('  None selected'));
+        } else if (labels.length === total) {
+          console.log(c.success('All selected'));
+        } else {
+          console.log(c.success(labels.join(', ')));
+        }
+        resolve({ indices, values });
+      } else if (key === 'escape') {
+        cleanup();
+        const indices = [...(defaultSelected || [])].sort((a, b) => a - b);
+        const values  = indices.map(i => items[i].value);
+        resolve({ indices, values });
+      }
+    };
+
+    process.stdin.on('data', onKey);
+  });
+}
+
+// ── Fallback implementations (non-TTY) ───────────────────────────────────────
+
+async function _fallbackSelectOne({ title, items, default: defaultIdx }) {
+  const readline = require('readline');
+  if (title) {
+    console.log('');
+    console.log(`  ${title}`);
+    console.log(c.dim('  ' + '─'.repeat(50)));
+  }
+
+  items.forEach((item, i) => {
+    const marker = i === defaultIdx ? c.green(' ← default') : '';
+    console.log(`    ${c.cyan(`[${i + 1}]`)} ${item.label}${item.hint ? c.dim(` ${item.hint}`) : ''}${marker}`);
+  });
+  console.log('');
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question(`  Select [1-${items.length}] (Enter = default): `, answer => {
+      rl.close();
+      const trimmed = (answer || '').trim();
+      if (!trimmed) {
+        resolve({ index: defaultIdx, value: items[defaultIdx].value });
+        return;
+      }
+      const num = parseInt(trimmed, 10);
+      if (num >= 1 && num <= items.length) {
+        resolve({ index: num - 1, value: items[num - 1].value });
+        return;
+      }
+      resolve({ index: defaultIdx, value: items[defaultIdx].value });
+    });
+  });
+}
+
+async function _fallbackSelectMany({ title, items, defaultSelected }) {
+  const readline = require('readline');
+  if (title) {
+    console.log('');
+    console.log(`  ${title}`);
+    console.log(c.dim('  ' + '─'.repeat(50)));
+  }
+
+  items.forEach((item, i) => {
+    console.log(`    ${c.cyan(`[${i + 1}]`)} ${item.label}${item.hint ? c.dim(` ${item.hint}`) : ''}`);
+  });
+  console.log(`    ${c.cyan('[A]')} All`);
+  console.log('');
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question('  Select (e.g. 1,3 or A for all) [Enter = all]: ', answer => {
+      rl.close();
+      const trimmed = (answer || '').trim().toLowerCase();
+      if (!trimmed || trimmed === 'a' || trimmed === 'all') {
+        const all = items.map((_, i) => i);
+        resolve({ indices: all, values: items.map(it => it.value) });
+        return;
+      }
+      const parts = trimmed.split(/[\s,]+/).filter(Boolean);
+      const indices = [];
+      for (const p of parts) {
+        const num = parseInt(p, 10);
+        if (num >= 1 && num <= items.length) indices.push(num - 1);
+      }
+      if (indices.length === 0) {
+        const all = items.map((_, i) => i);
+        resolve({ indices: all, values: items.map(it => it.value) });
+        return;
+      }
+      resolve({ indices, values: indices.map(i => items[i].value) });
+    });
+  });
+}
+
+module.exports = { selectOne, selectMany };