@portl/cli 0.1.0

package/src/utils/prompts.js

@@ -0,0 +1,210 @@
+/**
+ * Enhanced prompt utilities for intuitive CLI interactions
+ */
+
+const ANSI = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+};
+
+function c(text, color) {
+  return `${color}${text}${ANSI.reset}`;
+}
+
+/**
+ * Display a visual section separator with emoji
+ */
+export function showSection(title, emoji = '📦') {
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`${emoji} ${c(title.toUpperCase(), ANSI.bold)}`);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+}
+
+/**
+ * Display an inline tip/help message
+ */
+export function showTip(message) {
+  console.log(c(`💡 ${message}`, ANSI.dim));
+}
+
+/**
+ * Display a success message
+ */
+export function showSuccess(message) {
+  console.log(c(`✓ ${message}`, ANSI.green));
+}
+
+/**
+ * Display an error message
+ */
+export function showError(message) {
+  console.log(c(`✗ ${message}`, ANSI.red));
+}
+
+/**
+ * Display a warning message
+ */
+export function showWarning(message) {
+  console.log(c(`⚠ ${message}`, ANSI.yellow));
+}
+
+/**
+ * Display an info message
+ */
+export function showInfo(message) {
+  console.log(c(`ℹ ${message}`, ANSI.blue));
+}
+
+/**
+ * Ask a simple yes/no question
+ * Returns true for yes, false for no
+ */
+export async function askYesNo(rl, question, defaultYes = true) {
+  const suffix = defaultYes ? c('(Y/n)', ANSI.dim) : c('(y/N)', ANSI.dim);
+  const answer = await rl.question(`${question} ${suffix}: `);
+  
+  if (!answer || !answer.trim()) {
+    return defaultYes;
+  }
+
+  const normalized = answer.trim().toLowerCase();
+  return normalized === 'y' || normalized === 'yes' || normalized === 's' || normalized === 'si';
+}
+
+/**
+ * Ask a question with a default value
+ */
+export async function ask(rl, question, defaultValue = '') {
+  const suffix = defaultValue ? ` ${c(`(${defaultValue})`, ANSI.dim)}` : '';
+  const answer = await rl.question(`${question}${suffix}: `);
+  const trimmed = answer.trim();
+  return trimmed || defaultValue || '';
+}
+
+/**
+ * Ask a question that requires a non-empty answer
+ */
+export async function askNonEmpty(rl, question, defaultValue = '') {
+  while (true) {
+    const value = await ask(rl, question, defaultValue);
+    if (value.trim()) {
+      return value.trim();
+    }
+    showWarning('Value cannot be empty. Try again.');
+  }
+}
+
+/**
+ * Display a numbered list and let user select one option
+ */
+export async function selectOption(rl, title, options) {
+  console.log(`\n${c(title, ANSI.bold)}`);
+  options.forEach((option, index) => {
+    const description = option.description ? c(` - ${option.description}`, ANSI.dim) : '';
+    console.log(`  ${c(String(index + 1), ANSI.cyan)}. ${option.label}${description}`);
+  });
+
+  while (true) {
+    const answer = await rl.question(`\n${c('Select (1-' + options.length + '):', ANSI.bold)} `);
+    const selected = Number.parseInt(answer.trim(), 10);
+    if (!Number.isNaN(selected) && selected >= 1 && selected <= options.length) {
+      return options[selected - 1];
+    }
+
+    showWarning('Invalid selection. Try again.');
+  }
+}
+
+/**
+ * Display the Portl ASCII banner
+ */
+export function showBanner() {
+  const banner = `
+██████╗  ██████╗ ██████╗ ████████╗██╗
+██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝██║
+██████╔╝██║   ██║██████╔╝   ██║   ██║
+██╔═══╝ ██║   ██║██╔══██╗   ██║   ██║
+██║     ╚██████╔╝██║  ██║   ██║   ███████╗
+╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝
+`;
+  console.log(c(banner, ANSI.cyan));
+  console.log(c('Portl Setup Wizard', ANSI.bold));
+  console.log(c('Bring your infra. Ship with AI.', ANSI.dim));
+  console.log('');
+}
+
+/**
+ * Display a summary section
+ */
+export function showSummary(title, items) {
+  showSection(title, '✅');
+  if (items.length === 0) {
+    console.log(c('  No integrations configured', ANSI.dim));
+  } else {
+    items.forEach(item => {
+      console.log(`  ${c('✓', ANSI.green)} ${item}`);
+    });
+  }
+  console.log('');
+}
+
+/**
+ * Display "next steps" instructions
+ */
+export function showNextSteps(steps) {
+  console.log(c('Next steps:', ANSI.bold));
+  steps.forEach((step, index) => {
+    console.log(`  ${c(String(index + 1), ANSI.cyan)}. ${step}`);
+  });
+  console.log('');
+}
+
+/**
+ * Simple spinner for loading states
+ */
+export class Spinner {
+  constructor(message) {
+    this.message = message;
+    this.frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    this.index = 0;
+    this.intervalId = null;
+  }
+
+  start() {
+    process.stdout.write(`${this.frames[0]} ${this.message}`);
+    this.intervalId = setInterval(() => {
+      this.index = (this.index + 1) % this.frames.length;
+      process.stdout.write(`\r${this.frames[this.index]} ${this.message}`);
+    }, 80);
+  }
+
+  success(message) {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+    }
+    process.stdout.write(`\r${c('✓', ANSI.green)} ${message || this.message}\n`);
+  }
+
+  fail(message) {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+    }
+    process.stdout.write(`\r${c('✗', ANSI.red)} ${message || this.message}\n`);
+  }
+
+  stop() {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+    }
+    process.stdout.write('\r' + ' '.repeat(this.message.length + 3) + '\r');
+  }
+}
+
+export { ANSI, c };