@h-rig/cli 0.0.6-alpha.9 → 0.0.6-alpha.90

package/dist/src/app/drone-ui.d.ts

@@ -0,0 +1,37 @@
+export declare function droneIntro(title: string, subtitle?: string): void;
+export declare function droneOutro(text: string): void;
+export declare function droneNote(message: string, title?: string): void;
+export declare function droneStep(text: string): void;
+export declare function droneInfo(text: string): void;
+export declare function droneWarn(text: string): void;
+export declare function droneError(text: string): void;
+export declare function droneCancel(text: string): void;
+/** Clack-spinner-shaped adapter over the micro-drone TTY spinner. */
+export declare function droneSpinner(): {
+    start(message: string): void;
+    stop(message?: string): void;
+    error(message?: string): void;
+};
+type DroneSelectOption<T extends string> = {
+    value: T;
+    label: string;
+    hint?: string;
+};
+/** Drone-styled select. Returns null on cancel (esc / ctrl+c / q). */
+export declare function droneSelect<T extends string>(input: {
+    readonly message: string;
+    readonly options: readonly DroneSelectOption<T>[];
+    readonly initialValue?: T;
+}): Promise<T | null>;
+/** Drone-styled text input. Returns null on cancel. */
+export declare function droneText(input: {
+    readonly message: string;
+    readonly placeholder?: string;
+    readonly initialValue?: string;
+}): Promise<string | null>;
+/** Drone-styled yes/no. Returns null on cancel. */
+export declare function droneConfirm(input: {
+    readonly message: string;
+    readonly initialValue?: boolean;
+}): Promise<boolean | null>;
+export {};

package/dist/src/app/drone-ui.js

@@ -0,0 +1,294 @@
+// @bun
+// packages/cli/src/app/drone-ui.ts
+import { ProcessTerminal, TUI, Text, Input, SelectList, matchesKey } from "@earendil-works/pi-tui";
+
+// packages/cli/src/app/theme.ts
+var RIG_PALETTE = {
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  accent: "#ccff4d",
+  accentDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d"
+};
+function hexToRgb(hex) {
+  const value = hex.replace("#", "");
+  return [
+    Number.parseInt(value.slice(0, 2), 16),
+    Number.parseInt(value.slice(2, 4), 16),
+    Number.parseInt(value.slice(4, 6), 16)
+  ];
+}
+function fg(hex) {
+  const [r, g, b] = hexToRgb(hex);
+  return (text) => `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+var ink = fg(RIG_PALETTE.ink);
+var ink2 = fg(RIG_PALETTE.ink2);
+var ink3 = fg(RIG_PALETTE.ink3);
+var ink4 = fg(RIG_PALETTE.ink4);
+var accent = fg(RIG_PALETTE.accent);
+var accentDim = fg(RIG_PALETTE.accentDim);
+var cyan = fg(RIG_PALETTE.cyan);
+var red = fg(RIG_PALETTE.red);
+var yellow = fg(RIG_PALETTE.yellow);
+function bold(text) {
+  return `\x1B[1m${text}\x1B[22m`;
+}
+var DRONE_ART = [
+  "  .-=-.                   .-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'._               _.'-=-'   ",
+  "        '._           _.'         ",
+  "           '=$$$$$$$=.'           ",
+  "          =$$$$$$$$$$$=           ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "        $$$@@        @@$$$        ",
+  "        $$@    ?     @$$$         ",
+  "        $$$@   '-'   @$$$         ",
+  "        $$$@@        @@$$$        ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "          =$$$$$$$$$$$=           ",
+  "           '=$$$$$$$=.'           ",
+  "        _.'           '._         ",
+  "  .-=-.'                 '.-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'                   '-=-'   "
+];
+var EYE_FRAMES = ["@", "o", "."];
+var DRONE_WIDTH = DRONE_ART[0].length;
+var DRONE_HEIGHT = DRONE_ART.length;
+var MICRO_BLADES = ["---", "\\\\\\", "|||", "///"];
+function microDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `(${blade})${eye}(${blade})`;
+}
+var MICRO_DRONE_FRAMES = Array.from({ length: 12 }, (_, index) => microDroneFrame(index));
+function renderMicroDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `${ink4("(")}${cyan(blade)}${ink4(")")}${bold(accent(eye))}${ink4("(")}${cyan(blade)}${ink4(")")}`;
+}
+
+// packages/cli/src/commands/_spinner.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createTtySpinner(input) {
+  const output = input.output ?? process.stdout;
+  const isTty = output.isTTY === true;
+  const frames = input.frames && input.frames.length > 0 ? input.frames : SPINNER_FRAMES;
+  let label = input.label;
+  let frame = 0;
+  let paused = false;
+  let stopped = false;
+  let lastPrintedLabel = "";
+  const render = () => {
+    if (stopped || paused)
+      return;
+    if (!isTty) {
+      if (label !== lastPrintedLabel) {
+        output.write(`${label}
+`);
+        lastPrintedLabel = label;
+      }
+      return;
+    }
+    frame = (frame + 1) % frames.length;
+    const glyph = frames[frame] ?? frames[0] ?? "";
+    output.write(`\r\x1B[2K${input.styleFrame ? input.styleFrame(glyph) : glyph} ${label}`);
+  };
+  const clearLine = () => {
+    if (isTty)
+      output.write("\r\x1B[2K");
+  };
+  render();
+  const timer = isTty ? setInterval(render, input.intervalMs ?? 120) : null;
+  return {
+    setLabel(next) {
+      label = next;
+      render();
+    },
+    pause() {
+      paused = true;
+      clearLine();
+    },
+    resume() {
+      if (stopped)
+        return;
+      paused = false;
+      render();
+    },
+    stop(finalLine) {
+      if (stopped)
+        return;
+      stopped = true;
+      if (timer)
+        clearInterval(timer);
+      clearLine();
+      if (finalLine)
+        output.write(`${finalLine}
+`);
+    }
+  };
+}
+
+// packages/cli/src/app/drone-ui.ts
+var isTty = () => Boolean(process.stdout.isTTY);
+function hairline(width = Math.min(process.stdout.columns ?? 80, 100)) {
+  return ink4("\u2500".repeat(Math.max(10, width)));
+}
+function droneIntro(title, subtitle) {
+  console.log("");
+  console.log(` ${accent("\u258D")}${bold(ink(title))}${subtitle ? ink3(` \u2014 ${subtitle}`) : ""}`);
+  console.log(hairline());
+}
+function droneOutro(text) {
+  console.log(hairline());
+  console.log(` ${accent("\u25C6")} ${ink2(text)}`);
+  console.log("");
+}
+function droneNote(message, title) {
+  if (title)
+    console.log(` ${accentDim("\u25C7")} ${bold(ink2(title))}`);
+  for (const line of message.split(`
+`)) {
+    console.log(` ${ink4("\u2502")} ${line}`);
+  }
+}
+function droneStep(text) {
+  console.log(` ${accent("\u203A")} ${ink(text)}`);
+}
+function droneInfo(text) {
+  console.log(` ${cyan("\xB7")} ${ink2(text)}`);
+}
+function droneWarn(text) {
+  console.log(` ${yellow("\u25B2")} ${ink2(text)}`);
+}
+function droneError(text) {
+  console.log(` ${red("\u2716")} ${ink2(text)}`);
+}
+function droneCancel(text) {
+  console.log(` ${red("\u2716")} ${ink3(text)}`);
+}
+function droneSpinner() {
+  let active = null;
+  return {
+    start(message) {
+      active = createTtySpinner({
+        label: message,
+        frames: MICRO_DRONE_FRAMES,
+        styleFrame: (frame) => renderMicroDroneFrame(Math.max(0, MICRO_DRONE_FRAMES.indexOf(frame)))
+      });
+    },
+    stop(message) {
+      active?.stop(message ? ` ${accent("\u25C6")} ${ink2(message)}` : undefined);
+      active = null;
+    },
+    error(message) {
+      active?.stop(message ? ` ${red("\u2716")} ${ink2(message)}` : undefined);
+      active = null;
+    }
+  };
+}
+var SELECT_THEME = {
+  selectedPrefix: (text) => accent(text),
+  selectedText: (text) => bold(ink(text)),
+  description: (text) => ink3(text),
+  scrollInfo: (text) => ink4(text),
+  noMatch: (text) => ink3(text)
+};
+async function runMiniTui(build) {
+  const terminal = new ProcessTerminal;
+  const tui = new TUI(terminal);
+  let settled = false;
+  return await new Promise((resolve) => {
+    const finish = (result) => {
+      if (settled)
+        return;
+      settled = true;
+      tui.stop();
+      resolve(result);
+    };
+    build(tui, finish);
+    tui.start();
+  });
+}
+async function droneSelect(input) {
+  if (!isTty() || input.options.length === 0) {
+    return input.initialValue ?? input.options[0]?.value ?? null;
+  }
+  return runMiniTui((tui, finish) => {
+    tui.addChild(new Text(` ${accent("\u258D")}${bold(ink(input.message))}`));
+    const items = input.options.map((option) => ({
+      value: option.value,
+      label: option.label,
+      ...option.hint ? { description: option.hint } : {}
+    }));
+    const list = new SelectList(items, Math.min(items.length, 12), SELECT_THEME);
+    const initialIndex = input.initialValue ? items.findIndex((item) => item.value === input.initialValue) : -1;
+    if (initialIndex > 0)
+      list.setSelectedIndex(initialIndex);
+    list.onSelect = (item) => finish(item.value);
+    list.onCancel = () => finish(null);
+    tui.addChild(list);
+    tui.addChild(new Text(ink4(" \u2191\u2193 navigate \xB7 enter select \xB7 esc cancel")));
+    tui.setFocus(list);
+    tui.addInputListener((data) => {
+      if (matchesKey(data, "ctrl+c") || matchesKey(data, "escape")) {
+        finish(null);
+        return { consume: true };
+      }
+      return;
+    });
+  });
+}
+async function droneText(input) {
+  if (!isTty())
+    return input.initialValue ?? null;
+  return runMiniTui((tui, finish) => {
+    tui.addChild(new Text(` ${accent("\u258D")}${bold(ink(input.message))}${input.placeholder ? ink4(`  (${input.placeholder})`) : ""}`));
+    const field = new Input;
+    if (input.initialValue)
+      field.setValue(input.initialValue);
+    field.onSubmit = (value) => finish(value);
+    field.onEscape = () => finish(null);
+    tui.addChild(field);
+    tui.addChild(new Text(ink4(" enter submit \xB7 esc cancel")));
+    tui.setFocus(field);
+    tui.addInputListener((data) => {
+      if (matchesKey(data, "ctrl+c")) {
+        finish(null);
+        return { consume: true };
+      }
+      return;
+    });
+  });
+}
+async function droneConfirm(input) {
+  const answer = await droneSelect({
+    message: input.message,
+    options: [
+      { value: "yes", label: "Yes" },
+      { value: "no", label: "No" }
+    ],
+    initialValue: input.initialValue === false ? "no" : "yes"
+  });
+  return answer === null ? null : answer === "yes";
+}
+export {
+  droneWarn,
+  droneText,
+  droneStep,
+  droneSpinner,
+  droneSelect,
+  droneOutro,
+  droneNote,
+  droneIntro,
+  droneInfo,
+  droneError,
+  droneConfirm,
+  droneCancel
+};

package/dist/src/app/theme.d.ts

@@ -0,0 +1,47 @@
+export declare const RIG_PALETTE: {
+    /** --ink: primary text */
+    readonly ink: "#f2f3f6";
+    /** --ink-2: body text */
+    readonly ink2: "#aeb0ba";
+    /** --ink-3: muted */
+    readonly ink3: "#6c6e79";
+    /** --ink-4: faint */
+    readonly ink4: "#44464f";
+    /** --ac: acid green accent */
+    readonly accent: "#ccff4d";
+    /** --ac-dim */
+    readonly accentDim: "#a9d63f";
+    /** --ac-2: cyan secondary */
+    readonly cyan: "#56d8ff";
+    /** status colors tuned to sit on the dark site bg */
+    readonly red: "#ff5d5d";
+    readonly yellow: "#ffd24d";
+};
+/** 24-bit foreground colorizer. */
+export declare function fg(hex: string): (text: string) => string;
+export declare const ink: (text: string) => string;
+export declare const ink2: (text: string) => string;
+export declare const ink3: (text: string) => string;
+export declare const ink4: (text: string) => string;
+export declare const accent: (text: string) => string;
+export declare const accentDim: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const red: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare function bold(text: string): string;
+/** Run-status color, matching the site's pipeline color story. */
+export declare function statusColor(status: string): (text: string) => string;
+/** The braille spinner the site's hero terminal mirrors. */
+export declare const RIG_SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/**
+ * Render one animation frame of the drone. `tick` drives rotor rotation and
+ * the eye pulse — call with an incrementing counter (the site advances the
+ * rotor every 4 ticks and pulses the eye on a sine).
+ */
+export declare function renderDroneFrame(tick: number): string[];
+export declare const DRONE_WIDTH: number;
+export declare const DRONE_HEIGHT: 18;
+export declare function microDroneFrame(tick: number): string;
+export declare const MICRO_DRONE_FRAMES: readonly string[];
+/** Truecolor micro-drone: cyan rotors, acid eye — site colors. */
+export declare function renderMicroDroneFrame(tick: number): string;

package/dist/src/app/theme.js

@@ -0,0 +1,150 @@
+// @bun
+// packages/cli/src/app/theme.ts
+var RIG_PALETTE = {
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  accent: "#ccff4d",
+  accentDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d"
+};
+function hexToRgb(hex) {
+  const value = hex.replace("#", "");
+  return [
+    Number.parseInt(value.slice(0, 2), 16),
+    Number.parseInt(value.slice(2, 4), 16),
+    Number.parseInt(value.slice(4, 6), 16)
+  ];
+}
+function fg(hex) {
+  const [r, g, b] = hexToRgb(hex);
+  return (text) => `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+var ink = fg(RIG_PALETTE.ink);
+var ink2 = fg(RIG_PALETTE.ink2);
+var ink3 = fg(RIG_PALETTE.ink3);
+var ink4 = fg(RIG_PALETTE.ink4);
+var accent = fg(RIG_PALETTE.accent);
+var accentDim = fg(RIG_PALETTE.accentDim);
+var cyan = fg(RIG_PALETTE.cyan);
+var red = fg(RIG_PALETTE.red);
+var yellow = fg(RIG_PALETTE.yellow);
+function bold(text) {
+  return `\x1B[1m${text}\x1B[22m`;
+}
+function statusColor(status) {
+  switch (status) {
+    case "running":
+      return accent;
+    case "preparing":
+    case "created":
+    case "validating":
+    case "reviewing":
+    case "closing-out":
+      return cyan;
+    case "needs-attention":
+    case "needs_attention":
+      return yellow;
+    case "failed":
+      return red;
+    default:
+      return ink3;
+  }
+}
+var RIG_SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var DRONE_ART = [
+  "  .-=-.                   .-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'._               _.'-=-'   ",
+  "        '._           _.'         ",
+  "           '=$$$$$$$=.'           ",
+  "          =$$$$$$$$$$$=           ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "        $$$@@        @@$$$        ",
+  "        $$@    ?     @$$$         ",
+  "        $$$@   '-'   @$$$         ",
+  "        $$$@@        @@$$$        ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "          =$$$$$$$$$$$=           ",
+  "           '=$$$$$$$=.'           ",
+  "        _.'           '._         ",
+  "  .-=-.'                 '.-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'                   '-=-'   "
+];
+var BLADE_FRAMES = ["---", "\\\\\\", "|||", "///"];
+var EYE_FRAMES = ["@", "o", "."];
+function droneCharColor(char) {
+  if (char === "$" || char === "@")
+    return accent;
+  if (char === "=" || char === "%")
+    return accentDim;
+  if (char === "\\" || char === "/")
+    return ink3;
+  return ink4;
+}
+function renderDroneFrame(tick) {
+  const blade = BLADE_FRAMES[Math.floor(tick / 4) % BLADE_FRAMES.length];
+  const pulse = Math.sin(tick * 0.07);
+  const eye = pulse > 0.45 ? EYE_FRAMES[0] : pulse > -0.1 ? EYE_FRAMES[1] : EYE_FRAMES[2];
+  return DRONE_ART.map((line) => {
+    let out = "";
+    let index = 0;
+    while (index < line.length) {
+      if (line.startsWith("!!!", index)) {
+        out += cyan(blade);
+        index += 3;
+        continue;
+      }
+      const char = line[index];
+      if (char === "?") {
+        out += bold(cyan(eye));
+      } else if (char !== " ") {
+        out += droneCharColor(char)(char);
+      } else {
+        out += " ";
+      }
+      index += 1;
+    }
+    return out;
+  });
+}
+var DRONE_WIDTH = DRONE_ART[0].length;
+var DRONE_HEIGHT = DRONE_ART.length;
+var MICRO_BLADES = ["---", "\\\\\\", "|||", "///"];
+function microDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `(${blade})${eye}(${blade})`;
+}
+var MICRO_DRONE_FRAMES = Array.from({ length: 12 }, (_, index) => microDroneFrame(index));
+function renderMicroDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `${ink4("(")}${cyan(blade)}${ink4(")")}${bold(accent(eye))}${ink4("(")}${cyan(blade)}${ink4(")")}`;
+}
+export {
+  yellow,
+  statusColor,
+  renderMicroDroneFrame,
+  renderDroneFrame,
+  red,
+  microDroneFrame,
+  ink4,
+  ink3,
+  ink2,
+  ink,
+  fg,
+  cyan,
+  bold,
+  accentDim,
+  accent,
+  RIG_SPINNER_FRAMES,
+  RIG_PALETTE,
+  MICRO_DRONE_FRAMES,
+  DRONE_WIDTH,
+  DRONE_HEIGHT
+};

package/dist/src/commands/_async-ui.d.ts

@@ -0,0 +1,13 @@
+import type { OutputMode } from "@rig/runtime/control-plane/runtime/types";
+export type SpinnerOutput = Pick<NodeJS.WriteStream, "write"> & {
+    readonly isTTY?: boolean;
+};
+export type WithSpinnerOptions = {
+    /** Final line left behind on success. Default: the spinner line is erased. */
+    readonly doneLabel?: string;
+    /** Pass context.outputMode; "json" suppresses all spinner output. */
+    readonly outputMode?: OutputMode;
+    /** Stream override for tests. Defaults to process.stderr. */
+    readonly output?: SpinnerOutput;
+};
+export declare function withSpinner<T>(label: string, work: (update: (label: string) => void) => Promise<T>, options?: WithSpinnerOptions): Promise<T>;