Function startViteChild

apps/local/src/serve.ts:129–218

()

}

async function startViteChild(): Promise<ViteChild> {
  const vitePort = await allocatePort();
  const cwd = resolve(import.meta.dirname, "..");
  const viteEntrypoint = resolve(cwd, "node_modules/vite/bin/vite.js");
  const env = { ...process.env };
  delete env.PORT;
  // Run Vite directly under Bun, matching the `dev:vite` script without a
  // bunx wrapper that can outlive its child. --strictPort keeps the URL stable.
  const child: Subprocess = Bun.spawn(
    [
      process.execPath,
      viteEntrypoint,
      "dev",
      "--port",
      String(vitePort),
      "--strictPort",
      "--host",
      "127.0.0.1",
    ],
    {
      cwd,
      // EXECUTOR_DEV_VITE_PORT — vite.config reads this and points the
      // HMR client at vite's real port. The browser loads HTML through
      // the daemon proxy but opens the HMR WebSocket directly to vite,
      // sidestepping the daemon's lack of WS proxying.
      env: {
        ...env,
        EXECUTOR_DEV_VITE_PORT: String(vitePort),
      },
      stdout: "inherit",
      stderr: "inherit",
    },
  );

  let stopping = false;
  const stop = async (): Promise<void> => {
    if (stopping) {
      await child.exited;
      return;
    }
    stopping = true;
    for (const signal of viteChildSignals) process.off(signal, stopOnParentSignal);
    if (child.exitCode === null) child.kill();
    await Promise.race([child.exited, Bun.sleep(5_000)]);
    if (child.exitCode === null) child.kill("SIGKILL");
    await child.exited;
  };
  const stopOnParentSignal = (): void => {
    // A PTY/session teardown can signal the CLI while Vite is still optimizing
    // dependencies, before the server's normal stop handle exists. Reap the
    // owned child immediately; the CLI's signal waiter performs full cleanup
    // once startup has completed.
    void stop();
  };
  for (const signal of viteChildSignals) process.once(signal, stopOnParentSignal);

  const url = `http://127.0.0.1:${vitePort}`;
  const deadline = Date.now() + 30_000;