refactor(cli): centralize command execution flow (#841)

src/cli/commands/runner.ts

@@ -0,0 +1,107 @@
+import type { MutableRefObject } from "react";
+import type { Buffers, Line } from "../helpers/accumulator";
+
+export type CommandPhase = "running" | "waiting" | "finished";
+
+export type CommandUpdate = {
+  output: string;
+  phase?: CommandPhase;
+  success?: boolean;
+  dimOutput?: boolean;
+  preformatted?: boolean;
+};
+
+export type CommandHandle = {
+  id: string;
+  input: string;
+  update: (update: CommandUpdate) => void;
+  finish: (
+    output: string,
+    success?: boolean,
+    dimOutput?: boolean,
+    preformatted?: boolean,
+  ) => void;
+  fail: (output: string) => void;
+};
+
+type CreateId = (prefix: string) => string;
+
+type RunnerDeps = {
+  buffersRef: MutableRefObject<Buffers>;
+  refreshDerived: () => void;
+  createId: CreateId;
+};
+
+function upsertCommandLine(
+  buffers: Buffers,
+  id: string,
+  input: string,
+  update: CommandUpdate,
+): void {
+  const existing = buffers.byId.get(id);
+  const next: Line = {
+    kind: "command",
+    id,
+    input: existing?.kind === "command" ? existing.input : input,
+    output: update.output,
+    phase: update.phase ?? "running",
+    success: update.success,
+    dimOutput: update.dimOutput,
+    preformatted: update.preformatted,
+  };
+  buffers.byId.set(id, next);
+}
+
+export function createCommandRunner({
+  buffersRef,
+  refreshDerived,
+  createId,
+}: RunnerDeps) {
+  function getHandle(id: string, input: string): CommandHandle {
+    const update = (updateData: CommandUpdate) => {
+      upsertCommandLine(buffersRef.current, id, input, updateData);
+      if (!buffersRef.current.order.includes(id)) {
+        buffersRef.current.order.push(id);
+      }
+      refreshDerived();
+    };
+
+    const finish = (
+      finalOutput: string,
+      success = true,
+      dimOutput?: boolean,
+      preformatted?: boolean,
+    ) =>
+      update({
+        output: finalOutput,
+        phase: "finished",
+        success,
+        dimOutput,
+        preformatted,
+      });
+
+    const fail = (finalOutput: string) =>
+      update({
+        output: finalOutput,
+        phase: "finished",
+        success: false,
+      });
+
+    return { id, input, update, finish, fail };
+  }
+
+  function start(input: string, output: string): CommandHandle {
+    const id = createId("cmd");
+    const buffers = buffersRef.current;
+    upsertCommandLine(buffers, id, input, {
+      output,
+      phase: "running",
+    });
+    buffers.order.push(id);
+    refreshDerived();
+
+    return getHandle(id, input);
+  }
+
+  return { start, getHandle };
+}