skybridge 0.0.0-dev.feb36b5 → 0.0.0-dev.febcf34

package/dist/cli/tunnel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.test.js","sourceRoot":"","sources":["../../src/cli/tunnel.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { Readable } from \"node:stream\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { parseStdoutLine, TunnelManager, type TunnelState } from \"./tunnel.js\";\n\ndescribe(\"parseStdoutLine\", () => {\n  it(\"returns a connected event when the forwarding line is seen\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"strips a trailing slash from the forwarded URL\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example/ -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"returns a starting event for any other non-empty line\", () => {\n    expect(parseStdoutLine(\"Opening tunnel...\")).toEqual({\n      kind: \"starting\",\n      message: \"Opening tunnel...\",\n    });\n  });\n\n  it(\"returns null for empty lines\", () => {\n    expect(parseStdoutLine(\"\")).toBeNull();\n    expect(parseStdoutLine(\"   \")).toBeNull();\n  });\n});\n\ntype FakeChild = EventEmitter & {\n  stdout: Readable;\n  stderr: Readable;\n  kill: ReturnType<typeof vi.fn<() => boolean>>;\n};\n\nfunction makeFakeChild(): FakeChild {\n  const child = new EventEmitter() as FakeChild;\n  child.stdout = new Readable({ read() {} });\n  child.stderr = new Readable({ read() {} });\n  child.kill = vi.fn<() => boolean>(() => true);\n  return child;\n}\n\ndescribe(\"TunnelManager\", () => {\n  beforeEach(() => {\n    vi.useFakeTimers();\n  });\n  afterEach(() => {\n    vi.useRealTimers();\n  });\n\n  it(\"starts idle\", () => {\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => makeFakeChild(),\n    });\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"transitions idle -> starting -> connected as stdout reports progress\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const states: string[] = [];\n    manager.on(\"state\", (s: TunnelState) => states.push(s.status));\n\n    manager.start();\n    child.stdout.emit(\"data\", Buffer.from(\"Opening tunnel...\\n\"));\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    expect(states).toEqual([\"starting\", \"starting\", \"connected\"]);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"emits activity events for stdout lines after connect\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const activity: Array<{ text: string; level: string }> = [];\n    manager.on(\"activity\", (a: { text: string; level: string }) =>\n      activity.push({ text: a.text, level: a.level }),\n    );\n\n    manager.start();\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n    child.stdout.emit(\"data\", Buffer.from(\"GET /widgets/foo\\n\"));\n    child.stderr.emit(\"data\", Buffer.from(\"connection wobble\\n\"));\n\n    expect(activity).toEqual([\n      { text: \"GET /widgets/foo\", level: \"log\" },\n      { text: \"connection wobble\", level: \"error\" },\n    ]);\n  });\n\n  it(\"calling start twice does not spawn twice\", () => {\n    const spawn = vi.fn(() => makeFakeChild());\n    const manager = new TunnelManager({ getPort: () => 3000, spawn });\n    manager.start();\n    manager.start();\n    expect(spawn).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"transitions to error when the connection times out\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n\n    expect(manager.getState().status).toBe(\"error\");\n    expect(child.kill).toHaveBeenCalled();\n  });\n\n  it(\"preserves the timeout error message when the killed child later emits close\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n    // The killed child emits a non-zero close after the timeout fired.\n    child.emit(\"close\", 1);\n\n    expect(manager.getState()).toEqual({\n      status: \"error\",\n      message: \"Tunnel connection timed out after one minute\",\n    });\n  });\n\n  it(\"stop() kills the subprocess and goes idle\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    manager.stop();\n    expect(child.kill).toHaveBeenCalled();\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"subscribers get the current state on subscribe\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    child.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    let received: TunnelState | undefined;\n    const unsubscribe = manager.subscribe((s) => {\n      received = s;\n    });\n    expect(received).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n    unsubscribe();\n  });\n\n  it(\"ignores deferred close from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n\n    // Stale close from childA arrives only now — must not clobber state.\n    childA.emit(\"close\", null);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"ignores deferred error from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    childA.emit(\"error\", new Error(\"late spawn failure\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n});\n"]}

package/dist/cli/types.d.ts

@@ -0,0 +1,5 @@
+export type Message = {
+    id: string;
+    text: string;
+    type: "log" | "restart" | "error";
+};

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Message = {\n  id: string;\n  text: string;\n  type: \"log\" | \"restart\" | \"error\";\n};\n"]}

package/dist/cli/use-execute-steps.d.ts

@@ -0,0 +1,11 @@
+export interface CommandStep {
+    label: string;
+    command?: string;
+    run?: () => void | Promise<void>;
+}
+export declare const useExecuteSteps: (steps: CommandStep[]) => {
+    currentStep: number;
+    status: "error" | "running" | "success";
+    error: string | null;
+    execute: () => Promise<void>;
+};

package/dist/cli/use-execute-steps.js

@@ -0,0 +1,36 @@
+import { useCallback, useState } from "react";
+import { runCommand } from "./run-command.js";
+export const useExecuteSteps = (steps) => {
+    const [currentStep, setCurrentStep] = useState(0);
+    const [status, setStatus] = useState("running");
+    const [error, setError] = useState(null);
+    const execute = useCallback(async () => {
+        try {
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                if (step) {
+                    setCurrentStep(i);
+                    if (step.run) {
+                        await step.run();
+                    }
+                    if (step.command) {
+                        await runCommand(step.command);
+                    }
+                }
+            }
+            setStatus("success");
+            setImmediate(() => {
+                process.exit(0);
+            });
+        }
+        catch (err) {
+            setStatus("error");
+            setError(err instanceof Error ? err.message : String(err));
+            setImmediate(() => {
+                process.exit(1);
+            });
+        }
+    }, [steps]);
+    return { currentStep, status, error, execute };
+};
+//# sourceMappingURL=use-execute-steps.js.map

package/dist/cli/use-execute-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-execute-steps.js","sourceRoot":"","sources":["../../src/cli/use-execute-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAoB,EAAE,EAAE;IACtD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,SAAS,CACV,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,CAAC;YACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,EAAE,CAAC;oBACT,cAAc,CAAC,CAAC,CAAC,CAAC;oBAClB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;wBACb,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;oBACnB,CAAC;oBACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC,CAAC","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { runCommand } from \"./run-command.js\";\n\nexport interface CommandStep {\n  label: string;\n  command?: string;\n  run?: () => void | Promise<void>;\n}\n\nexport const useExecuteSteps = (steps: CommandStep[]) => {\n  const [currentStep, setCurrentStep] = useState<number>(0);\n  const [status, setStatus] = useState<\"running\" | \"success\" | \"error\">(\n    \"running\",\n  );\n  const [error, setError] = useState<string | null>(null);\n\n  const execute = useCallback(async () => {\n    try {\n      for (let i = 0; i < steps.length; i++) {\n        const step = steps[i];\n        if (step) {\n          setCurrentStep(i);\n          if (step.run) {\n            await step.run();\n          }\n          if (step.command) {\n            await runCommand(step.command);\n          }\n        }\n      }\n      setStatus(\"success\");\n      setImmediate(() => {\n        process.exit(0);\n      });\n    } catch (err) {\n      setStatus(\"error\");\n      setError(err instanceof Error ? err.message : String(err));\n      setImmediate(() => {\n        process.exit(1);\n      });\n    }\n  }, [steps]);\n\n  return { currentStep, status, error, execute };\n};\n"]}

package/dist/cli/use-messages.d.ts

@@ -0,0 +1,3 @@
+import type { Message } from "./types.js";
+export type PushMessage = (text: string, type: Message["type"]) => void;
+export declare function useMessages(): [Array<Message>, PushMessage];

package/dist/cli/use-messages.js

@@ -0,0 +1,11 @@
+import { randomUUID } from "node:crypto";
+import { useCallback, useState } from "react";
+const MAX_MESSAGES = 10;
+export function useMessages() {
+    const [messages, setMessages] = useState([]);
+    const push = useCallback((text, type) => {
+        setMessages((prev) => [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES));
+    }, []);
+    return [messages, push];
+}
+//# sourceMappingURL=use-messages.js.map

package/dist/cli/use-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-messages.js","sourceRoot":"","sources":["../../src/cli/use-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,MAAM,YAAY,GAAG,EAAE,CAAC;AAIxB,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAE7D,MAAM,IAAI,GAAG,WAAW,CAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACnD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CACjE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { useCallback, useState } from \"react\";\nimport type { Message } from \"./types.js\";\n\nconst MAX_MESSAGES = 10;\n\nexport type PushMessage = (text: string, type: Message[\"type\"]) => void;\n\nexport function useMessages(): [Array<Message>, PushMessage] {\n  const [messages, setMessages] = useState<Array<Message>>([]);\n\n  const push = useCallback<PushMessage>((text, type) => {\n    setMessages((prev) =>\n      [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES),\n    );\n  }, []);\n\n  return [messages, push];\n}\n"]}

package/dist/cli/use-nodemon.d.ts

@@ -0,0 +1,16 @@
+import type { PushMessage } from "./use-messages.js";
+export interface NodemonHandlers {
+    /** A raw chunk of server stdout, forwarded untouched. */
+    onStdout: (chunk: Buffer) => void;
+    /** A (filtered) chunk of server stderr. */
+    onStderr: (message: string) => void;
+    /** The server restarted because the listed files changed. */
+    onRestart: (files: string[]) => void;
+}
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export declare function startNodemon(env: NodeJS.ProcessEnv, handlers: NodemonHandlers): () => void;
+export declare function useNodemon(env: NodeJS.ProcessEnv, pushMessage: PushMessage): void;

package/dist/cli/use-nodemon.js

@@ -0,0 +1,84 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import nodemonOriginal from "nodemon";
+import { useEffect } from "react";
+const nodemon = nodemonOriginal;
+const SOURCEMAP_WARNING = /^Sourcemap for ".*" points to missing source files$/;
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export function startNodemon(env, handlers) {
+    const configFile = resolve(process.cwd(), "nodemon.json");
+    const config = existsSync(configFile)
+        ? {
+            configFile,
+        }
+        : {
+            watch: ["src"],
+            ext: "ts,json",
+            exec: "tsx src/server.ts",
+        };
+    nodemon({ ...config, env, stdout: false });
+    const handleStdoutData = (chunk) => {
+        handlers.onStdout(chunk);
+    };
+    const handleStderrData = (chunk) => {
+        const message = chunk.toString().trim();
+        if (!message) {
+            return;
+        }
+        // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.
+        const filtered = message
+            .split("\n")
+            .filter((line) => !SOURCEMAP_WARNING.test(line))
+            .join("\n");
+        if (filtered) {
+            handlers.onStderr(filtered);
+        }
+    };
+    const setupStdoutListener = () => {
+        if (nodemon.stdout) {
+            nodemon.stdout.off("data", handleStdoutData);
+            nodemon.stdout.on("data", handleStdoutData);
+        }
+    };
+    const setupStderrListener = () => {
+        if (nodemon.stderr) {
+            nodemon.stderr.off("data", handleStderrData);
+            nodemon.stderr.on("data", handleStderrData);
+        }
+    };
+    nodemon.on("readable", () => {
+        setupStdoutListener();
+        setupStderrListener();
+    });
+    nodemon.on("restart", (files) => {
+        handlers.onRestart(files);
+        setupStdoutListener();
+        setupStderrListener();
+    });
+    return () => {
+        if (nodemon.stdout) {
+            nodemon.stdout.off("data", handleStdoutData);
+        }
+        if (nodemon.stderr) {
+            nodemon.stderr.off("data", handleStderrData);
+        }
+        nodemon.emit("quit");
+    };
+}
+export function useNodemon(env, pushMessage) {
+    useEffect(() => startNodemon(env, {
+        onStdout: (chunk) => {
+            const message = chunk.toString().trim();
+            if (message) {
+                pushMessage(message, "log");
+            }
+        },
+        onStderr: (message) => pushMessage(message, "error"),
+        onRestart: (files) => pushMessage(`Server restarted due to file changes: ${files.join(", ")}`, "restart"),
+    }), [env, pushMessage]);
+}
+//# sourceMappingURL=use-nodemon.js.map

package/dist/cli/use-nodemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nodemon.js","sourceRoot":"","sources":["../../src/cli/use-nodemon.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport nodemonOriginal from \"nodemon\";\nimport { useEffect } from \"react\";\nimport type { ExtendedNodemon } from \"./nodemon.d.ts\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nconst nodemon = nodemonOriginal as ExtendedNodemon;\n\nconst SOURCEMAP_WARNING = /^Sourcemap for \".*\" points to missing source files$/;\n\nexport interface NodemonHandlers {\n  /** A raw chunk of server stdout, forwarded untouched. */\n  onStdout: (chunk: Buffer) => void;\n  /** A (filtered) chunk of server stderr. */\n  onStderr: (message: string) => void;\n  /** The server restarted because the listed files changed. */\n  onRestart: (files: string[]) => void;\n}\n\n/**\n * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a\n * cleanup function that detaches the listeners and quits nodemon. Shared by the\n * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.\n */\nexport function startNodemon(\n  env: NodeJS.ProcessEnv,\n  handlers: NodemonHandlers,\n): () => void {\n  const configFile = resolve(process.cwd(), \"nodemon.json\");\n\n  const config = existsSync(configFile)\n    ? {\n        configFile,\n      }\n    : {\n        watch: [\"src\"],\n        ext: \"ts,json\",\n        exec: \"tsx src/server.ts\",\n      };\n\n  nodemon({ ...config, env, stdout: false });\n\n  const handleStdoutData = (chunk: Buffer) => {\n    handlers.onStdout(chunk);\n  };\n\n  const handleStderrData = (chunk: Buffer) => {\n    const message = chunk.toString().trim();\n    if (!message) {\n      return;\n    }\n    // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.\n    const filtered = message\n      .split(\"\\n\")\n      .filter((line) => !SOURCEMAP_WARNING.test(line))\n      .join(\"\\n\");\n    if (filtered) {\n      handlers.onStderr(filtered);\n    }\n  };\n\n  const setupStdoutListener = () => {\n    if (nodemon.stdout) {\n      nodemon.stdout.off(\"data\", handleStdoutData);\n      nodemon.stdout.on(\"data\", handleStdoutData);\n    }\n  };\n\n  const setupStderrListener = () => {\n    if (nodemon.stderr) {\n      nodemon.stderr.off(\"data\", handleStderrData);\n      nodemon.stderr.on(\"data\", handleStderrData);\n    }\n  };\n\n  nodemon.on(\"readable\", () => {\n    setupStdoutListener();\n    setupStderrListener();\n  });\n\n  nodemon.on(\"restart\", (files: string[]) => {\n    handlers.onRestart(files);\n    setupStdoutListener();\n    setupStderrListener();\n  });\n\n  return () => {\n    if (nodemon.stdout) {\n      nodemon.stdout.off(\"data\", handleStdoutData);\n    }\n    if (nodemon.stderr) {\n      nodemon.stderr.off(\"data\", handleStderrData);\n    }\n    nodemon.emit(\"quit\");\n  };\n}\n\nexport function useNodemon(\n  env: NodeJS.ProcessEnv,\n  pushMessage: PushMessage,\n): void {\n  useEffect(\n    () =>\n      startNodemon(env, {\n        onStdout: (chunk) => {\n          const message = chunk.toString().trim();\n          if (message) {\n            pushMessage(message, \"log\");\n          }\n        },\n        onStderr: (message) => pushMessage(message, \"error\"),\n        onRestart: (files) =>\n          pushMessage(\n            `Server restarted due to file changes: ${files.join(\", \")}`,\n            \"restart\",\n          ),\n      }),\n    [env, pushMessage],\n  );\n}\n"]}

package/dist/cli/use-open-browser.d.ts

@@ -0,0 +1 @@
+export declare function useOpenBrowser(port: number, enabled: boolean): void;

package/dist/cli/use-open-browser.js

@@ -0,0 +1,44 @@
+import net from "node:net";
+import open from "open";
+import { useEffect, useRef } from "react";
+const POLL_INTERVAL_MS = 200;
+const POLL_TIMEOUT_MS = 5_000;
+const isPortListening = (port) => new Promise((resolve) => {
+    const socket = net.createConnection({ port, host: "127.0.0.1" });
+    socket.once("connect", () => {
+        socket.end();
+        resolve(true);
+    });
+    socket.once("error", () => {
+        socket.destroy();
+        resolve(false);
+    });
+});
+export function useOpenBrowser(port, enabled) {
+    const opened = useRef(false);
+    useEffect(() => {
+        if (!enabled || opened.current) {
+            return;
+        }
+        let cancelled = false;
+        const deadline = Date.now() + POLL_TIMEOUT_MS;
+        const tick = async () => {
+            while (!cancelled && Date.now() < deadline) {
+                if (await isPortListening(port)) {
+                    if (cancelled || opened.current) {
+                        return;
+                    }
+                    opened.current = true;
+                    await open(`http://localhost:${port}/`).catch(() => { });
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            }
+        };
+        void tick();
+        return () => {
+            cancelled = true;
+        };
+    }, [port, enabled]);
+}
+//# sourceMappingURL=use-open-browser.js.map

package/dist/cli/use-open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-browser.js","sourceRoot":"","sources":["../../src/cli/use-open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAM,eAAe,GAAG,CAAC,IAAY,EAAoB,EAAE,CACzD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;QAE9C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC3C,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChC,IAAI,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBAChC,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;oBACtB,MAAM,IAAI,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACxD,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QAEZ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import net from \"node:net\";\nimport open from \"open\";\nimport { useEffect, useRef } from \"react\";\n\nconst POLL_INTERVAL_MS = 200;\nconst POLL_TIMEOUT_MS = 5_000;\n\nconst isPortListening = (port: number): Promise<boolean> =>\n  new Promise((resolve) => {\n    const socket = net.createConnection({ port, host: \"127.0.0.1\" });\n    socket.once(\"connect\", () => {\n      socket.end();\n      resolve(true);\n    });\n    socket.once(\"error\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n  });\n\nexport function useOpenBrowser(port: number, enabled: boolean): void {\n  const opened = useRef(false);\n\n  useEffect(() => {\n    if (!enabled || opened.current) {\n      return;\n    }\n\n    let cancelled = false;\n    const deadline = Date.now() + POLL_TIMEOUT_MS;\n\n    const tick = async () => {\n      while (!cancelled && Date.now() < deadline) {\n        if (await isPortListening(port)) {\n          if (cancelled || opened.current) {\n            return;\n          }\n          opened.current = true;\n          await open(`http://localhost:${port}/`).catch(() => {});\n          return;\n        }\n        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));\n      }\n    };\n\n    void tick();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [port, enabled]);\n}\n"]}

package/dist/cli/use-tunnel.d.ts

@@ -0,0 +1,14 @@
+import type { PushMessage } from "./use-messages.js";
+export type TunnelState = {
+    status: "idle";
+} | {
+    status: "starting";
+    message: string;
+} | {
+    status: "connected";
+    url: string;
+} | {
+    status: "error";
+    message: string;
+};
+export declare function useTunnel(port: number | null, pushMessage: PushMessage, verbose: boolean, autoStart: boolean): TunnelState;

package/dist/cli/use-tunnel.js

@@ -0,0 +1,131 @@
+import { useEffect, useState } from "react";
+const POST_RETRY_DELAY_MS = 250;
+export function useTunnel(port, pushMessage, verbose, autoStart) {
+    const [state, setState] = useState(port !== null && autoStart
+        ? { status: "starting", message: "Starting tunnel…" }
+        : { status: "idle" });
+    useEffect(() => {
+        if (port === null) {
+            return;
+        }
+        const baseUrl = `http://localhost:${port}`;
+        const controller = new AbortController();
+        let cancelled = false;
+        const pushLog = (text, type) => {
+            const time = new Date().toLocaleTimeString("en-US", {
+                hour: "numeric",
+                minute: "2-digit",
+                second: "2-digit",
+                hour12: true,
+            });
+            pushMessage(`${time} [tunnel] ${text}`, type);
+        };
+        const handleEvent = (event, data) => {
+            if (event === "state") {
+                const next = JSON.parse(data);
+                setState(next);
+                return;
+            }
+            if (event === "activity") {
+                if (!verbose) {
+                    return;
+                }
+                const activity = JSON.parse(data);
+                pushLog(activity.text, activity.level);
+            }
+        };
+        const consumeSse = async () => {
+            const res = await fetch(`${baseUrl}/__skybridge/tunnel/events`, {
+                signal: controller.signal,
+                headers: { Accept: "text/event-stream" },
+            });
+            if (!res.ok || !res.body) {
+                throw new Error(`SSE connection failed (${res.status})`);
+            }
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (!cancelled) {
+                const { value, done } = await reader.read();
+                if (done) {
+                    return;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // SSE frames are separated by a blank line ("\n\n").
+                let sep = buffer.indexOf("\n\n");
+                while (sep !== -1) {
+                    const frame = buffer.slice(0, sep);
+                    buffer = buffer.slice(sep + 2);
+                    let eventName = "message";
+                    const dataLines = [];
+                    for (const rawLine of frame.split("\n")) {
+                        const line = rawLine.replace(/\r$/, "");
+                        if (line.startsWith("event:")) {
+                            eventName = line.slice(6).trim();
+                        }
+                        else if (line.startsWith("data:")) {
+                            dataLines.push(line.slice(5).trimStart());
+                        }
+                    }
+                    if (dataLines.length > 0) {
+                        handleEvent(eventName, dataLines.join("\n"));
+                    }
+                    sep = buffer.indexOf("\n\n");
+                }
+            }
+        };
+        const postUntilStarted = async () => {
+            // Retry indefinitely until POST lands once. Bounded by the effect
+            // lifetime via controller.abort() on unmount. Once the manager has
+            // been started, this returns and never POSTs again — a user-driven
+            // DELETE /tunnel won't be auto-undone.
+            while (!cancelled) {
+                try {
+                    const res = await fetch(`${baseUrl}/__skybridge/tunnel`, {
+                        method: "POST",
+                        signal: controller.signal,
+                    });
+                    if (res.ok) {
+                        return;
+                    }
+                }
+                catch {
+                    // dev server not up yet (or restarting under nodemon) — wait, retry
+                }
+                await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));
+            }
+        };
+        // Always observe the tunnel state so external triggers (curl, future
+        // devtools UI) update the cli UI. `autoStart` only decides whether we
+        // also POST /tunnel on mount. Reconnects indefinitely so we survive
+        // dev-server boot delay and nodemon restarts; the cli owns the actual
+        // subprocess so a temporarily-unreachable dev server is fine.
+        const observe = async () => {
+            while (!cancelled) {
+                try {
+                    await consumeSse();
+                }
+                catch {
+                    // network error or stream ended abnormally — fall through to retry
+                }
+                if (cancelled) {
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));
+            }
+        };
+        // observe() always runs — it owns the cli's view of tunnel state. POST is
+        // a fire-and-forget side-effect that nudges the manager into starting and
+        // retries until it lands at least once.
+        if (autoStart) {
+            void postUntilStarted();
+        }
+        void observe();
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, [port, pushMessage, verbose, autoStart]);
+    return state;
+}
+//# sourceMappingURL=use-tunnel.js.map

package/dist/cli/use-tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tunnel.js","sourceRoot":"","sources":["../../src/cli/use-tunnel.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nexport type TunnelState =\n  | { status: \"idle\" }\n  | { status: \"starting\"; message: string }\n  | { status: \"connected\"; url: string }\n  | { status: \"error\"; message: string };\n\ntype TunnelActivity = {\n  time: string;\n  text: string;\n  level: \"log\" | \"error\";\n};\n\nconst POST_RETRY_DELAY_MS = 250;\n\nexport function useTunnel(\n  port: number | null,\n  pushMessage: PushMessage,\n  verbose: boolean,\n  autoStart: boolean,\n): TunnelState {\n  const [state, setState] = useState<TunnelState>(\n    port !== null && autoStart\n      ? { status: \"starting\", message: \"Starting tunnel…\" }\n      : { status: \"idle\" },\n  );\n\n  useEffect(() => {\n    if (port === null) {\n      return;\n    }\n\n    const baseUrl = `http://localhost:${port}`;\n    const controller = new AbortController();\n    let cancelled = false;\n\n    const pushLog = (text: string, type: \"log\" | \"error\") => {\n      const time = new Date().toLocaleTimeString(\"en-US\", {\n        hour: \"numeric\",\n        minute: \"2-digit\",\n        second: \"2-digit\",\n        hour12: true,\n      });\n      pushMessage(`${time} [tunnel] ${text}`, type);\n    };\n\n    const handleEvent = (event: string, data: string) => {\n      if (event === \"state\") {\n        const next = JSON.parse(data) as TunnelState;\n        setState(next);\n        return;\n      }\n      if (event === \"activity\") {\n        if (!verbose) {\n          return;\n        }\n        const activity = JSON.parse(data) as TunnelActivity;\n        pushLog(activity.text, activity.level);\n      }\n    };\n\n    const consumeSse = async () => {\n      const res = await fetch(`${baseUrl}/__skybridge/tunnel/events`, {\n        signal: controller.signal,\n        headers: { Accept: \"text/event-stream\" },\n      });\n      if (!res.ok || !res.body) {\n        throw new Error(`SSE connection failed (${res.status})`);\n      }\n\n      const reader = res.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = \"\";\n\n      while (!cancelled) {\n        const { value, done } = await reader.read();\n        if (done) {\n          return;\n        }\n        buffer += decoder.decode(value, { stream: true });\n\n        // SSE frames are separated by a blank line (\"\\n\\n\").\n        let sep = buffer.indexOf(\"\\n\\n\");\n        while (sep !== -1) {\n          const frame = buffer.slice(0, sep);\n          buffer = buffer.slice(sep + 2);\n          let eventName = \"message\";\n          const dataLines: string[] = [];\n          for (const rawLine of frame.split(\"\\n\")) {\n            const line = rawLine.replace(/\\r$/, \"\");\n            if (line.startsWith(\"event:\")) {\n              eventName = line.slice(6).trim();\n            } else if (line.startsWith(\"data:\")) {\n              dataLines.push(line.slice(5).trimStart());\n            }\n          }\n          if (dataLines.length > 0) {\n            handleEvent(eventName, dataLines.join(\"\\n\"));\n          }\n          sep = buffer.indexOf(\"\\n\\n\");\n        }\n      }\n    };\n\n    const postUntilStarted = async () => {\n      // Retry indefinitely until POST lands once. Bounded by the effect\n      // lifetime via controller.abort() on unmount. Once the manager has\n      // been started, this returns and never POSTs again — a user-driven\n      // DELETE /tunnel won't be auto-undone.\n      while (!cancelled) {\n        try {\n          const res = await fetch(`${baseUrl}/__skybridge/tunnel`, {\n            method: \"POST\",\n            signal: controller.signal,\n          });\n          if (res.ok) {\n            return;\n          }\n        } catch {\n          // dev server not up yet (or restarting under nodemon) — wait, retry\n        }\n        await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));\n      }\n    };\n\n    // Always observe the tunnel state so external triggers (curl, future\n    // devtools UI) update the cli UI. `autoStart` only decides whether we\n    // also POST /tunnel on mount. Reconnects indefinitely so we survive\n    // dev-server boot delay and nodemon restarts; the cli owns the actual\n    // subprocess so a temporarily-unreachable dev server is fine.\n    const observe = async () => {\n      while (!cancelled) {\n        try {\n          await consumeSse();\n        } catch {\n          // network error or stream ended abnormally — fall through to retry\n        }\n        if (cancelled) {\n          return;\n        }\n        await new Promise((r) => setTimeout(r, POST_RETRY_DELAY_MS));\n      }\n    };\n\n    // observe() always runs — it owns the cli's view of tunnel state. POST is\n    // a fire-and-forget side-effect that nudges the manager into starting and\n    // retries until it lands at least once.\n    if (autoStart) {\n      void postUntilStarted();\n    }\n    void observe();\n\n    return () => {\n      cancelled = true;\n      controller.abort();\n    };\n  }, [port, pushMessage, verbose, autoStart]);\n\n  return state;\n}\n"]}

package/dist/cli/use-typescript-check.d.ts

@@ -0,0 +1,15 @@
+export type TsError = {
+    file: string;
+    line: number;
+    col: number;
+    code: string;
+    message: string;
+};
+/**
+ * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`
+ * (empty array when the check is clean). Returns a cleanup function that kills
+ * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})
+ * and the `--plain` runner.
+ */
+export declare function startTypeScriptCheck(onErrors: (errors: Array<TsError>) => void): () => void;
+export declare function useTypeScriptCheck(): Array<TsError>;

package/dist/cli/use-typescript-check.js

@@ -0,0 +1,97 @@
+import { isAbsolute, relative } from "node:path";
+import spawn from "cross-spawn";
+import { useEffect, useState } from "react";
+// TypeScript nests from general to specific — the deepest line is the root cause.
+function extractBestMessage(message, continuationLines) {
+    if (!continuationLines.length) {
+        return message;
+    }
+    let maxIndent = 0;
+    for (const line of continuationLines) {
+        const indent = line.length - line.trimStart().length;
+        if (indent > maxIndent) {
+            maxIndent = indent;
+        }
+    }
+    const deepest = continuationLines
+        .filter((l) => l.length - l.trimStart().length === maxIndent)
+        .map((l) => l.trim())
+        .filter(Boolean)[0];
+    return deepest ?? message;
+}
+/**
+ * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`
+ * (empty array when the check is clean). Returns a cleanup function that kills
+ * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})
+ * and the `--plain` runner.
+ */
+export function startTypeScriptCheck(onErrors) {
+    const tsProcess = spawn("npx", ["tsc", "--noEmit", "--watch", "--pretty", "false"], {
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: true,
+    });
+    let outputBuffer = "";
+    let currentErrors = [];
+    let pendingError = null;
+    let continuationLines = [];
+    const flushPending = () => {
+        if (!pendingError) {
+            return;
+        }
+        pendingError.message = extractBestMessage(pendingError.message, continuationLines);
+        currentErrors.push(pendingError);
+        pendingError = null;
+        continuationLines = [];
+    };
+    const processOutput = (data) => {
+        outputBuffer += data.toString();
+        const lines = outputBuffer.split("\n");
+        outputBuffer = lines.pop() || "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            const errorMatch = trimmed.match(/^(.+?)\((\d+),(\d+)\):\s+error\s+(TS\d+)?\s*:?\s*(.+)$/);
+            if (errorMatch) {
+                flushPending();
+                const [, file, lineStr, colStr, code, message] = errorMatch;
+                if (file && lineStr && colStr && message) {
+                    let cleanFile = file.trim();
+                    if (isAbsolute(cleanFile)) {
+                        cleanFile = relative(process.cwd(), cleanFile);
+                    }
+                    pendingError = {
+                        file: cleanFile,
+                        line: Number.parseInt(lineStr, 10),
+                        col: Number.parseInt(colStr, 10),
+                        code: code ?? "",
+                        message: message.trim(),
+                    };
+                }
+                continue;
+            }
+            if (pendingError && line.startsWith(" ")) {
+                continuationLines.push(line);
+                continue;
+            }
+            if (trimmed.includes("Found") && trimmed.includes("error")) {
+                flushPending();
+                onErrors(trimmed.match(/Found 0 error/) ? [] : [...currentErrors]);
+                currentErrors = [];
+            }
+        }
+    };
+    if (tsProcess.stdout) {
+        tsProcess.stdout.on("data", processOutput);
+    }
+    if (tsProcess.stderr) {
+        tsProcess.stderr.on("data", processOutput);
+    }
+    return () => {
+        tsProcess.kill();
+    };
+}
+export function useTypeScriptCheck() {
+    const [tsErrors, setTsErrors] = useState([]);
+    useEffect(() => startTypeScriptCheck(setTsErrors), []);
+    return tsErrors;
+}
+//# sourceMappingURL=use-typescript-check.js.map

package/dist/cli/use-typescript-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-typescript-check.js","sourceRoot":"","sources":["../../src/cli/use-typescript-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAU5C,kFAAkF;AAClF,SAAS,kBAAkB,CACzB,OAAe,EACf,iBAAgC;IAEhC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;QACrD,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;YACvB,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,OAAO,IAAI,OAAO,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA0C;IAE1C,MAAM,SAAS,GAAG,KAAK,CACrB,KAAK,EACL,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EACnD;QACE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,KAAK,EAAE,IAAI;KACZ,CACF,CAAC;IAEF,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,aAAa,GAAmB,EAAE,CAAC;IACvC,IAAI,YAAY,GAAmB,IAAI,CAAC;IACxC,IAAI,iBAAiB,GAAkB,EAAE,CAAC;IAE1C,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,YAAY,CAAC,OAAO,GAAG,kBAAkB,CACvC,YAAY,CAAC,OAAO,EACpB,iBAAiB,CAClB,CAAC;QACF,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,YAAY,GAAG,IAAI,CAAC;QACpB,iBAAiB,GAAG,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE;QACrC,YAAY,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,YAAY,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAC9B,wDAAwD,CACzD,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;gBAC5D,IAAI,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;oBACzC,IAAI,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC1B,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;oBACjD,CAAC;oBACD,YAAY,GAAG;wBACb,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;wBAClC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;wBAChC,IAAI,EAAE,IAAI,IAAI,EAAE;wBAChB,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;qBACxB,CAAC;gBACJ,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,YAAY,EAAE,CAAC;gBACf,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;gBACnE,aAAa,GAAG,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { isAbsolute, relative } from \"node:path\";\nimport spawn from \"cross-spawn\";\nimport { useEffect, useState } from \"react\";\n\nexport type TsError = {\n  file: string;\n  line: number;\n  col: number;\n  code: string;\n  message: string;\n};\n\n// TypeScript nests from general to specific — the deepest line is the root cause.\nfunction extractBestMessage(\n  message: string,\n  continuationLines: Array<string>,\n): string {\n  if (!continuationLines.length) {\n    return message;\n  }\n  let maxIndent = 0;\n  for (const line of continuationLines) {\n    const indent = line.length - line.trimStart().length;\n    if (indent > maxIndent) {\n      maxIndent = indent;\n    }\n  }\n  const deepest = continuationLines\n    .filter((l) => l.length - l.trimStart().length === maxIndent)\n    .map((l) => l.trim())\n    .filter(Boolean)[0];\n  return deepest ?? message;\n}\n\n/**\n * Spawn `tsc --noEmit --watch` and report each completed check via `onErrors`\n * (empty array when the check is clean). Returns a cleanup function that kills\n * the watcher. Shared by the Ink-based dev UI (via {@link useTypeScriptCheck})\n * and the `--plain` runner.\n */\nexport function startTypeScriptCheck(\n  onErrors: (errors: Array<TsError>) => void,\n): () => void {\n  const tsProcess = spawn(\n    \"npx\",\n    [\"tsc\", \"--noEmit\", \"--watch\", \"--pretty\", \"false\"],\n    {\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      shell: true,\n    },\n  );\n\n  let outputBuffer = \"\";\n  let currentErrors: Array<TsError> = [];\n  let pendingError: TsError | null = null;\n  let continuationLines: Array<string> = [];\n\n  const flushPending = () => {\n    if (!pendingError) {\n      return;\n    }\n    pendingError.message = extractBestMessage(\n      pendingError.message,\n      continuationLines,\n    );\n    currentErrors.push(pendingError);\n    pendingError = null;\n    continuationLines = [];\n  };\n\n  const processOutput = (data: Buffer) => {\n    outputBuffer += data.toString();\n    const lines = outputBuffer.split(\"\\n\");\n    outputBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n\n      const errorMatch = trimmed.match(\n        /^(.+?)\\((\\d+),(\\d+)\\):\\s+error\\s+(TS\\d+)?\\s*:?\\s*(.+)$/,\n      );\n      if (errorMatch) {\n        flushPending();\n        const [, file, lineStr, colStr, code, message] = errorMatch;\n        if (file && lineStr && colStr && message) {\n          let cleanFile = file.trim();\n          if (isAbsolute(cleanFile)) {\n            cleanFile = relative(process.cwd(), cleanFile);\n          }\n          pendingError = {\n            file: cleanFile,\n            line: Number.parseInt(lineStr, 10),\n            col: Number.parseInt(colStr, 10),\n            code: code ?? \"\",\n            message: message.trim(),\n          };\n        }\n        continue;\n      }\n\n      if (pendingError && line.startsWith(\" \")) {\n        continuationLines.push(line);\n        continue;\n      }\n\n      if (trimmed.includes(\"Found\") && trimmed.includes(\"error\")) {\n        flushPending();\n        onErrors(trimmed.match(/Found 0 error/) ? [] : [...currentErrors]);\n        currentErrors = [];\n      }\n    }\n  };\n\n  if (tsProcess.stdout) {\n    tsProcess.stdout.on(\"data\", processOutput);\n  }\n  if (tsProcess.stderr) {\n    tsProcess.stderr.on(\"data\", processOutput);\n  }\n\n  return () => {\n    tsProcess.kill();\n  };\n}\n\nexport function useTypeScriptCheck(): Array<TsError> {\n  const [tsErrors, setTsErrors] = useState<Array<TsError>>([]);\n\n  useEffect(() => startTypeScriptCheck(setTsErrors), []);\n\n  return tsErrors;\n}\n"]}

package/dist/commands/build.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class Build extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}