@h-rig/cli-surface-plugin 0.0.6-alpha.146

package/README.md

@@ -0,0 +1 @@
+# @h-rig/cli-surface-plugin

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

@@ -0,0 +1,34 @@
+type DroneSelectOption<T extends string> = {
+    readonly value: T;
+    readonly label: string;
+    readonly hint?: string;
+};
+type DroneSpinner = {
+    start(message: string): void;
+    stop(message?: string): void;
+    error(message?: string): void;
+};
+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;
+export declare function droneSpinner(): DroneSpinner;
+export declare function droneSelect<T extends string>(input: {
+    readonly message: string;
+    readonly options: readonly DroneSelectOption<T>[];
+    readonly initialValue?: T;
+}): Promise<T | null>;
+export declare function droneText(input: {
+    readonly message: string;
+    readonly placeholder?: string;
+    readonly initialValue?: string;
+}): Promise<string | null>;
+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,278 @@
+// @bun
+// packages/cli-surface-plugin/src/app/drone-ui.ts
+import { Input, matchesKey, ProcessTerminal, SelectList, Text, TUI } from "@oh-my-pi/pi-tui";
+
+// packages/cli-surface-plugin/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 ?? 16) : 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-surface-plugin/src/app/drone-ui.ts
+var 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.charCodeAt(0) === 35 ? hex.slice(1) : hex;
+  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(PALETTE.ink);
+var ink2 = fg(PALETTE.ink2);
+var ink3 = fg(PALETTE.ink3);
+var ink4 = fg(PALETTE.ink4);
+var accent = fg(PALETTE.accent);
+var accentDim = fg(PALETTE.accentDim);
+var cyan = fg(PALETTE.cyan);
+var red = fg(PALETTE.red);
+var yellow = fg(PALETTE.yellow);
+var MICRO_BLADES = ["---", "\\\\\\", "|||", "///"];
+var EYE_FRAMES = ["@", "o", "."];
+var MICRO_DRONE_FRAMES = Array.from({ length: 12 }, (_, index) => {
+  const blade = MICRO_BLADES[index % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(index / 2) % EYE_FRAMES.length];
+  return `(${blade})${eye}(${blade})`;
+});
+function bold(text) {
+  return `\x1B[1m${text}\x1B[22m`;
+}
+function renderMicroDroneFrame(frame) {
+  const tick = Math.max(0, MICRO_DRONE_FRAMES.indexOf(frame));
+  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(")")}`;
+}
+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: renderMicroDroneFrame
+      });
+    },
+    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 DRONE_SYMBOLS = {
+  cursor: "\u2192",
+  inputCursor: "\u258F",
+  boxRound: { topLeft: "\u256D", topRight: "\u256E", bottomLeft: "\u2570", bottomRight: "\u256F", horizontal: "\u2500", vertical: "\u2502" },
+  boxSharp: { topLeft: "\u250C", topRight: "\u2510", bottomLeft: "\u2514", bottomRight: "\u2518", horizontal: "\u2500", vertical: "\u2502", teeDown: "\u252C", teeUp: "\u2534", teeLeft: "\u2524", teeRight: "\u251C", cross: "\u253C" },
+  table: { topLeft: "\u250C", topRight: "\u2510", bottomLeft: "\u2514", bottomRight: "\u2518", horizontal: "\u2500", vertical: "\u2502", teeDown: "\u252C", teeUp: "\u2534", teeLeft: "\u2524", teeRight: "\u251C", cross: "\u253C" },
+  quoteBorder: "\u2502",
+  hrChar: "\u2500",
+  spinnerFrames: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"]
+};
+var DRONE_SELECT_THEME = {
+  selectedPrefix: (text) => accent(text),
+  selectedText: (text) => bold(ink(text)),
+  description: (text) => ink3(text),
+  scrollInfo: (text) => ink4(text),
+  noMatch: (text) => ink3(text),
+  symbols: DRONE_SYMBOLS,
+  hovered: (text) => bold(ink(text))
+};
+async function runMiniTui(build) {
+  const tui = new TUI(new ProcessTerminal);
+  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 (!process.stdout.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), DRONE_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 (!process.stdout.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/commands/_async-ui.d.ts

@@ -0,0 +1,10 @@
+import type { OutputMode } from "@rig/runtime";
+export type SpinnerOutput = Pick<NodeJS.WriteStream, "write"> & {
+    readonly isTTY?: boolean;
+};
+export type WithSpinnerOptions = {
+    readonly doneLabel?: string;
+    readonly outputMode?: OutputMode;
+    readonly output?: SpinnerOutput;
+};
+export declare function withSpinner<T>(label: string, work: (update: (label: string) => void) => Promise<T>, options?: WithSpinnerOptions): Promise<T>;

package/dist/src/commands/_async-ui.js

@@ -0,0 +1,121 @@
+// @bun
+// packages/cli-surface-plugin/src/commands/_async-ui.ts
+import pc from "picocolors";
+
+// packages/cli-surface-plugin/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 ?? 16) : 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-surface-plugin/src/commands/_async-ui.ts
+var FRAMES = ["\u25D0", "\u25D3", "\u25D1", "\u25D2"];
+var DONE_SYMBOL = pc.green("\u25C7");
+var FAIL_SYMBOL = pc.red("\u25A0");
+var activeUpdate = null;
+async function withSpinner(label, work, options = {}) {
+  if (options.outputMode === "json") {
+    return work(() => {
+      return;
+    });
+  }
+  if (activeUpdate) {
+    activeUpdate(label);
+    return work(activeUpdate);
+  }
+  const output = options.output ?? process.stderr;
+  const isTty = output.isTTY === true;
+  let lastLabel = label;
+  if (!isTty) {
+    output.write(`${label}
+`);
+    const update2 = (next) => {
+      lastLabel = next;
+    };
+    activeUpdate = update2;
+    try {
+      return await work(update2);
+    } finally {
+      activeUpdate = null;
+    }
+  }
+  const spinner = createTtySpinner({
+    label,
+    output,
+    frames: FRAMES,
+    styleFrame: (frame) => pc.cyan(frame)
+  });
+  const update = (next) => {
+    lastLabel = next;
+    spinner.setLabel(next);
+  };
+  activeUpdate = update;
+  try {
+    const result = await work(update);
+    spinner.stop(options.doneLabel ? `${DONE_SYMBOL} ${options.doneLabel}` : undefined);
+    return result;
+  } catch (error) {
+    spinner.stop(`${FAIL_SYMBOL} ${lastLabel}`);
+    throw error;
+  } finally {
+    activeUpdate = null;
+  }
+}
+export {
+  withSpinner
+};

package/dist/src/commands/_cli-format.d.ts

@@ -0,0 +1,56 @@
+export type CliTaskLike = Record<string, unknown>;
+export type CliRunLike = Record<string, unknown>;
+export declare function printFormattedOutput(message: string): void;
+export declare function formatStatusPill(status: string): string;
+export declare function formatSection(title: string, subtitle?: string): string;
+export declare function formatSuccessCard(title: string, rows?: Array<[string, string | number | null | undefined]>): string;
+export declare function formatNextSteps(steps: readonly string[]): string[];
+export declare function formatTaskList(tasks: readonly CliTaskLike[], options?: {
+    raw?: boolean;
+}): string;
+export declare function formatTaskCard(task: CliTaskLike, options?: {
+    title?: string;
+    selected?: boolean;
+}): string;
+export declare function formatTaskDetails(task: CliTaskLike): string;
+export declare function formatRunList(runs: readonly CliRunLike[], options?: {
+    source?: "local" | "server";
+}): string;
+export declare function formatSubmittedRun(input: {
+    runId: string;
+    taskId?: string | null;
+    title?: string | null;
+    queuePosition?: number | null;
+}): string;
+export declare function formatRunCard(run: CliRunLike, options?: {
+    title?: string;
+}): string;
+export declare function formatRunStatus(summary: {
+    activeRuns?: CliRunLike[];
+    recentRuns?: CliRunLike[];
+    runs?: CliRunLike[];
+}, options?: {
+    source?: "local" | "server";
+}): string;
+export declare function formatInboxList(kind: "approvals" | "inputs", entries: readonly Record<string, unknown>[]): string;
+export declare function formatConnectionList(connections: Record<string, {
+    kind: string;
+    baseUrl?: string;
+    mode?: string;
+}>): string;
+export declare function formatConnectionStatus(selected: string, connections: Record<string, {
+    kind: string;
+    baseUrl?: string;
+    mode?: string;
+}>, repo?: {
+    project?: string;
+    serverProjectRoot?: string;
+} | null, remoteProjectLink?: {
+    ok?: boolean;
+    status?: string;
+    serverProjectRoot?: string;
+    message?: string;
+    hint?: string;
+} | null): string;
+export declare function formatStatsTable(rows: Array<[string, unknown]>): string;
+export declare function readOptionalCount(record: Record<string, unknown>, key: string): number | null;