@visual-z/xeno 0.1.4 → 0.2.1

package/src/apps/startup-input.ts

@@ -0,0 +1,94 @@
+/** Startup owns raw input until a Pi screen can own it (D19). */
+import { StdinBuffer } from "../vendor/pi-tui/stdin-buffer.ts";
+import { isKeyRelease, matchesKey } from "../vendor/pi-tui/keys.ts";
+import { resolveEscapeTimeoutMs } from "../vendor/pi-tui/terminal.ts";
+
+type StartupStdin = Pick<NodeJS.ReadStream, "isTTY" | "isRaw" | "setRawMode" | "setEncoding" | "on" | "off" | "resume" | "pause" | "unshift">;
+export interface StartupInput {
+  phase(name: string): void;
+  /** Pause, restore the shell's mode and replay held bytes to the next input owner. */
+  handoff(): void;
+  /** Final cleanup discards unsubmitted input instead of leaking it to the shell. */
+  restore(): void;
+  runWithTerminal<T>(run: (handoff: () => void) => Promise<T>): Promise<T>;
+}
+
+export function createStartupInput(opts: {
+  interactive: boolean;
+  stdin?: StartupStdin;
+  signals?: NodeJS.EventEmitter;
+  report?: (message: string) => void;
+  exit?: (code: number) => void;
+}): StartupInput {
+  const stdin = opts.stdin ?? process.stdin;
+  if (!opts.interactive || stdin.isTTY !== true) return {
+    phase() {}, handoff() {}, restore() {}, runWithTerminal: run => run(() => {}),
+  };
+  const signals = opts.signals ?? process;
+  const report = opts.report ?? (message => console.error(message));
+  const exit = opts.exit ?? (code => process.exit(code));
+  const wasRaw = stdin.isRaw === true;
+  let active = false, closed = false, announced = false;
+  let phase = "Reading configuration";
+  let pending: string[] = [];
+  let parser: StdinBuffer | undefined;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+
+  const release = () => {
+    if (!active) return;
+    active = false;
+    clearTimeout(timer);
+    stdin.pause();
+    stdin.off("data", receive);
+    signals.off("SIGINT", interrupt); signals.off("SIGTERM", terminate); signals.off("SIGHUP", hangup);
+    parser?.destroy(); parser = undefined;
+    stdin.setRawMode(wasRaw);
+  };
+  const restore = () => { closed = true; release(); pending = []; };
+  const cancel = (code: number) => {
+    if (!active) return;
+    restore();
+    if (code === 130) report("Startup cancelled.");
+    exit(code);
+  };
+  const interrupt = () => cancel(130), terminate = () => cancel(143), hangup = () => cancel(129);
+  const receive = (data: string) => {
+    // Keep original chunks, including partial escapes/pastes, for Pi's own decoder.
+    // The temporary parser only recognizes cancellation outside bracketed paste.
+    pending.push(data);
+    parser?.process(data);
+  };
+  const announce = () => { if (active) { announced = true; report(`  Starting xeno: ${phase} (Ctrl+C to cancel)`); } };
+  const capture = () => {
+    if (closed || active) return;
+    active = true; announced = false;
+    parser = new StdinBuffer({ escapeTimeout: resolveEscapeTimeoutMs() });
+    parser.on("data", (data: string) => { if (!isKeyRelease(data) && matchesKey(data, "ctrl+c")) interrupt(); });
+    stdin.setEncoding("utf8");
+    stdin.on("data", receive);
+    signals.on("SIGINT", interrupt); signals.on("SIGTERM", terminate); signals.on("SIGHUP", hangup);
+    stdin.setRawMode(true);
+    stdin.resume();
+    // Assumed UI grace period, not a work deadline: fast starts stay quiet;
+    // a slow stage remains visible without truncating or abandoning its work.
+    timer = setTimeout(announce, 750);
+    timer.unref();
+  };
+  const handoff = () => {
+    if (!active) return;
+    release();
+    const buffered = pending.join(""); pending = [];
+    if (buffered) stdin.unshift(buffered);
+  };
+  capture();
+  return {
+    phase(name) { if (name === phase) return; phase = name; if (announced) announce(); },
+    handoff, restore,
+    async runWithTerminal(run) {
+      // A selector can load settings/history before mounting. Keep owning input
+      // until its synchronous screen.start(), then reacquire only after stop().
+      try { return await run(handoff); }
+      finally { capture(); }
+    },
+  };
+}