@gleapai/kai-bridge 0.10.1 → 0.11.0

package/src/tui.mjs

@@ -0,0 +1,76 @@
+// Terminal drawing for the wizard and status screens: ANSI colours that
+// switch off on pipes / NO_COLOR, and box-drawn panels laid out side by
+// side when the terminal is wide enough. No dependency on purpose.
+
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+
+export function colorsEnabled({ stream = process.stdout, env = process.env } = {}) {
+  if (env.NO_COLOR) return false;
+  if (env.FORCE_COLOR) return true;
+  return !!stream.isTTY && env.TERM !== "dumb";
+}
+
+/** `palette().green("ok")` — every style is an identity function when colours are off. */
+export function palette(on = colorsEnabled()) {
+  const wrap = (open, close) => (s) => (on ? `\x1b[${open}m${s}\x1b[${close}m` : String(s));
+  return {
+    on,
+    bold: wrap(1, 22),
+    dim: wrap(2, 22),
+    red: wrap(31, 39),
+    green: wrap(32, 39),
+    yellow: wrap(33, 39),
+    blue: wrap(34, 39),
+    magenta: wrap(35, 39),
+    cyan: wrap(36, 39),
+  };
+}
+
+export const strip = (s) => String(s).replace(ANSI_RE, "");
+/** Printed width of a string — styling stripped. Box glyphs count as one cell. */
+export const width = (s) => [...strip(s)].length;
+export const padRight = (s, n) => s + " ".repeat(Math.max(0, n - width(s)));
+
+/**
+ * Rounded banner: title left, `right` flush right.
+ *   ╭──────────────────────╮
+ *   │  TITLE  v1     ● ok  │
+ *   ╰──────────────────────╯
+ */
+export function banner({ left, right = "", cols = 64, paint = palette() }) {
+  const inner = Math.max(cols - 2, width(left) + width(right) + 6);
+  const gap = inner - 2 - width(left) - width(right) - 2;
+  const line = `│  ${left}${" ".repeat(Math.max(1, gap))}${right}  │`;
+  return [paint.magenta(`╭${"─".repeat(inner)}╮`), paint.magenta("│") + line.slice(1, -1) + paint.magenta("│"), paint.magenta(`╰${"─".repeat(inner)}╯`)];
+}
+
+/**
+ * One box with a title in its top edge. `inner` widens it beyond its content.
+ *   ┌ title ───────┐
+ *   │ line         │
+ *   └──────────────┘
+ */
+export function panel(title, lines, { inner = 0, paint = palette() } = {}) {
+  const w = Math.max(inner, width(title) + 3, ...lines.map((l) => width(l) + 2));
+  const top = paint.dim(`┌ ${title} ${"─".repeat(Math.max(0, w - width(title) - 2))}┐`);
+  const body = lines.map((l) => `${paint.dim("│")} ${padRight(l, w - 2)} ${paint.dim("│")}`);
+  return [top, ...body, paint.dim(`└${"─".repeat(w)}┘`)];
+}
+
+/** Blocks (arrays of lines) next to each other when they fit in `cols`, else stacked. */
+export function layout(blocks, { cols = 80, gap = 1 } = {}) {
+  const widths = blocks.map((b) => Math.max(...b.map(width)));
+  const total = widths.reduce((a, b) => a + b, 0) + gap * (blocks.length - 1);
+  if (total > cols) return blocks.flatMap((b, i) => (i < blocks.length - 1 ? [...b, ""] : b));
+  const rows = Math.max(...blocks.map((b) => b.length));
+  const lines = [];
+  for (let r = 0; r < rows; r += 1) {
+    lines.push(blocks.map((b, i) => padRight(b[r] ?? "", widths[i])).join(" ".repeat(gap)).replace(/\s+$/, ""));
+  }
+  return lines;
+}
+
+/** The terminal width to draw for — capped so wide monitors keep a readable block. */
+export function terminalColumns({ stream = process.stdout, max = 72, min = 40 } = {}) {
+  return Math.max(min, Math.min(max, stream.columns || 80));
+}