noiton 1.0.0 → 2.0.0

package/src/ui.js

@@ -0,0 +1,196 @@
+/**
+ * NOITON UI - visual helpers for the terminal
+ *
+ * Provides: banner, boxes, spinners, progress, dividers, status lines.
+ * Uses picocolors (lightweight) + ora (spinners) + boxen (boxes).
+ */
+
+import picocolors from "picocolors";
+import ora from "ora";
+import boxen from "boxen";
+import { VERSION, c } from "./constants.js";
+import { octopusHappy, octopusCurious, octopusDancing, octopusSad, octopusSleeping, octopusWorking, octopusLogo, brandGradient } from "./octopus.js";
+
+// ============= BANNER =============
+
+/**
+ * Print the main NOITON banner with octopus mascot.
+ * @param {"happy"|"curious"|"dancing"|"sad"|"sleeping"|"working"} mood
+ */
+export function printBanner(mood = "happy") {
+  const octopus = {
+    happy: octopusHappy,
+    curious: octopusCurious,
+    dancing: octopusDancing,
+    sad: octopusSad,
+    sleeping: octopusSleeping,
+    working: octopusWorking,
+  }[mood] || octopusHappy;
+
+  console.log();
+  console.log(octopus());
+  console.log(brandGradient(`                    N O I T O N   v${VERSION}`));
+  console.log(c.dim(`           🐙 Universal AI Agent Connector  🐙`));
+  console.log();
+}
+
+// ============= BOXES =============
+
+/**
+ * Print a message inside a colored box.
+ * @param {string} text
+ * @param {"info"|"success"|"warning"|"error"|"purple"} style
+ */
+export function box(text, style = "info") {
+  const styles = {
+    info: { borderColor: "cyan", title: " ℹ️  " },
+    success: { borderColor: "green", title: " ✅  " },
+    warning: { borderColor: "yellow", title: " ⚠️  " },
+    error: { borderColor: "red", title: " ❌  " },
+    purple: { borderColor: "magenta", title: " 🐙  " },
+  };
+  const s = styles[style] || styles.info;
+  console.log(
+    boxen(text, {
+      padding: 1,
+      margin: { top: 0, bottom: 0, left: 2, right: 2 },
+      borderStyle: "round",
+      borderColor: s.borderColor,
+      title: s.title,
+      titleAlignment: "left",
+    })
+  );
+}
+
+// ============= SPINNER =============
+
+/**
+ * Create and start a spinner with a NOITON-flavored message.
+ * @param {string} text
+ * @returns {ora.Spinner} spinner instance
+ */
+export function spinner(text) {
+  return ora({
+    text,
+    spinner: "dots",
+    color: "magenta",
+  }).start();
+}
+
+// ============= DIVIDER =============
+
+/**
+ * Print a horizontal divider line.
+ */
+export function divider(char = "─", len = 56) {
+  console.log(c.gray(char.repeat(len)));
+}
+
+// ============= STATUS LINES =============
+
+/**
+ * Print a success status line.
+ * @param {string} msg
+ */
+export function ok(msg) {
+  console.log(`  ${c.green("✓")} ${msg}`);
+}
+
+/**
+ * Print a warning status line.
+ * @param {string} msg
+ */
+export function warn(msg) {
+  console.log(`  ${c.yellow("⚠")}  ${msg}`);
+}
+
+/**
+ * Print an error status line.
+ * @param {string} msg
+ */
+export function fail(msg) {
+  console.log(`  ${c.red("✗")} ${msg}`);
+}
+
+/**
+ * Print an info status line.
+ * @param {string} msg
+ */
+export function info(msg) {
+  console.log(`  ${c.cyan("ℹ")}  ${msg}`);
+}
+
+/**
+ * Print a dim/secondary line.
+ * @param {string} msg
+ */
+export function dim(msg) {
+  console.log(`  ${c.dim(msg)}`);
+}
+
+/**
+ * Print a step header.
+ * @param {number} n - step number
+ * @param {string} title
+ */
+export function step(n, title) {
+  console.log();
+  console.log(c.bold(c.purple(`  ▸ Passo ${n}: ${title}`)));
+  divider("·");
+}
+
+// ============= CHECKLIST =============
+
+/**
+ * Print a checklist of items with check/cross marks.
+ * @param {Array<{label: string, ok: boolean, detail?: string}>} items
+ */
+export function checklist(items) {
+  for (const item of items) {
+    const mark = item.ok ? c.green("✓") : c.gray("○");
+    const label = item.ok ? c.white(item.label) : c.gray(item.label);
+    const detail = item.detail ? c.dim(` ${item.detail}`) : "";
+    console.log(`  ${mark} ${label}${detail}`);
+  }
+}
+
+// ============= PROGRESS =============
+
+/**
+ * Run an async task with a spinner, then show success/fail.
+ * @param {string} message - spinner text
+ * @param {Function} fn - async function to run
+ * @param {string} successMsg - message on success
+ * @returns {Promise<any>} result of fn
+ */
+export async function withSpinner(message, fn, successMsg) {
+  const s = spinner(message);
+  try {
+    const result = await fn();
+    s.succeed(successMsg || message);
+    return result;
+  } catch (err) {
+    s.fail(`${message} - ${err.message}`);
+    throw err;
+  }
+}
+
+// ============= CLEAR =============
+
+export function clear() {
+  process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+}
+
+// ============= HEADER (small) =============
+
+/**
+ * Print a small inline header (no octopus) for sub-commands.
+ */
+export function printHeader(title) {
+  console.log();
+  console.log(c.bold(c.purple(`  🐙  NOITON  `)) + c.dim(` v${VERSION} `));
+  console.log(c.gray(`  ${"─".repeat(title.length + 4)}`));
+  console.log(c.bold(`  ${title}`));
+  console.log(c.gray(`  ${"─".repeat(title.length + 4)}`));
+  console.log();
+}