gemi 0.90.0 → 0.91.1

package/dist/chunk-hdm74jbr.js.map

@@ -1,13 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../server/httpDev.ts", "../server/devFetch.ts", "../server/renderErrorPage.ts", "../server/hmrPort.ts"],
-  "sourcesContent": [
-    "import { join } from \"node:path\";\n\nimport { createServer } from \"vite\";\n\nimport { App } from \"../app\";\nimport gemiVite from \"../vite\";\nimport { Instrumentation } from \"./types\";\nimport { printStartupBanner } from \"./banner\";\nimport { GEMI_EXTERNAL_SPECIFIERS } from \"../internal/gemiExternals\";\nimport { createDevFetch, sendErrorToClient, ssrRunner } from \"./devFetch\";\nimport { resolveHmrPort } from \"./hmrPort\";\n\nexport { viteErrorPayload } from \"./devFetch\";\n\nconst rootDir = process.cwd();\nconst appDir = join(rootDir, \"app\");\n\n// `bun --hot` re-evaluates the module graph on every server-code change. A\n// syntax error or top-level throw in app code therefore fails during *module\n// load* — outside any request, and before `httpDev` re-runs — so Bun only\n// prints it to the console. Bun surfaces these as `unhandledRejection` (the\n// reload re-imports the entry and the failing dynamic import rejects), so hook\n// that here and forward it to the client. Registered once; process listeners\n// persist across reloads.\nif (!globalThis.__gemiErrorHooked) {\n  globalThis.__gemiErrorHooked = true;\n  process.on(\"unhandledRejection\", (reason) => {\n    console.error(reason);\n    sendErrorToClient(reason);\n  });\n  process.on(\"uncaughtException\", (err) => {\n    console.error(err);\n    sendErrorToClient(err);\n  });\n}\n\nexport async function httpDev(app: App, instrumentation: Instrumentation) {\n  // Same override the prod server honors (`httpProd.ts`). Read here rather than\n  // inline at `Bun.serve` because the HMR port is derived from it.\n  const httpPort = Number(process.env.PORT) || 5173;\n\n  // `bun --hot` re-runs this module on every server-code change, so keep a\n  // single Vite server on `globalThis` instead of spawning a new one (and a new\n  // HMR socket) on each reload.\n  const isReload = Boolean(globalThis.__gemiVite);\n  const vite = (globalThis.__gemiVite ??= await createServer({\n    // gemi owns the Vite setup — the app has no `vite.config.mjs` to discover.\n    // Register the gemi plugin explicitly instead; it loads `gemi.config.ts` and\n    // appends the app's Vite plugins (e.g. `@vitejs/plugin-react`, which serves\n    // `/@react-refresh` and the HMR preamble referenced below).\n    configFile: false,\n    plugins: [gemiVite()],\n    server: {\n      middlewareMode: true,\n      // In middleware mode Vite stands up a second HTTP server for the HMR\n      // websocket, and defaults it to a fixed port — so two `gemi dev` processes\n      // fight over one socket and the loser silently hot-reloads on the winner's\n      // file changes. Name the port instead; see `hmrPort.ts` for how it is\n      // chosen. `ws` and not the older `hmr`: `server.hmr.{port,host,…}` is\n      // deprecated in Vite 8 and warns. An app overriding either one in\n      // `gemi.config.ts` still wins — plugin config (where `gemi.config.ts`'s\n      // `vite` block is applied) is merged over this inline config, and Vite's\n      // own `hmr`→`ws` compat shim forwards the deprecated spelling here.\n      ws: { port: resolveHmrPort(httpPort) },\n      // Vite answers any host other than `localhost` and `*.localhost` with a\n      // 403, which would block a `route.domains` root such as `lvh.me` and\n      // every custom domain pointed here from `/etc/hosts`.\n      allowedHosts: app.devAllowedHosts.call(app),\n      // gemi reloads `.env` into process.env itself (see `watchEnv`). Stop Vite\n      // from *also* watching env files: Vite's env-change handler restarts the\n      // dev server, which closes the SSR module runner — but gemi keeps a single\n      // Vite instance across `bun --hot` reloads, so an in-flight view import\n      // hits the closed runner (\"Vite module runner has been closed\"). Ignoring\n      // env files here only disables the restart; env *loading* at startup (and\n      // `import.meta.env`) is unaffected.\n      watch: {\n        ignored: (file: string) => {\n          const base = file.split(/[/\\\\]/).pop() ?? \"\";\n          return base === \".env\" || base.startsWith(\".env.\");\n        },\n      },\n    },\n    appType: \"custom\",\n    // Views are loaded through this SSR graph while the renderer\n    // (react-dom/server in ViewRouteDispatcher) is imported by Bun.\n    // Dedupe so Vite can never resolve a second React copy — a mismatch makes\n    // the SSR dispatcher null (\"Invalid hook call\") after an HMR reload.\n    resolve: { dedupe: [\"react\", \"react-dom\"] },\n    // Pre-bundle the whole React surface the client uses in one pass. The client\n    // imports `react-dom/client` (`init.tsx`) and `react-dom` (`createPortal` in\n    // `HttpReload.tsx`); if only the first is discovered at startup, the first\n    // request to a module using the second triggers a *second* optimize pass,\n    // and the already-served page ends up importing a now-stale dep — surfacing\n    // as \"does not provide an export named 't'\". Listing them up front bundles\n    // them together so no re-optimization (and no version skew) happens.\n    optimizeDeps: { include: [\"react\", \"react-dom\", \"react-dom/client\"] },\n    // `gemi` is a linked package, so Vite would otherwise compile its own copy\n    // into this graph — giving views a *different* `RouteStateContext` (and\n    // other module-level singletons) than the Bun-loaded renderer's `Root`\n    // provider, so `useRouteData()` reads the empty default (`i18n` undefined).\n    // Externalizing makes view imports of `gemi/*` resolve to the one Bun\n    // instance. Vite's `ssr.external` matches exact specifiers (subpaths are NOT\n    // covered by the bare name, and regexes are ignored here), so every subpath\n    // a view might import must be listed — see `internal/gemiExternals`, the\n    // shared source of truth this and the SSR build (`vite/index.ts`) both use.\n    ssr: {\n      external: [...GEMI_EXTERNAL_SPECIFIERS],\n    },\n  }));\n\n  process.env.ROOT_DIR = rootDir;\n  process.env.APP_DIR = appDir;\n\n  const server = Bun.serve({\n    port: httpPort,\n    fetch: createDevFetch(app, instrumentation, vite),\n  });\n\n  // `bun --hot` re-evaluates its *whole* module graph on a server-code change —\n  // node_modules included — so after a reload `react`, `react-dom/server` and the\n  // Bun-loaded `gemi` are all fresh instances. This Vite server is not reloaded\n  // with them (it is deliberately kept on `globalThis` above), and its SSR runner\n  // still holds every view module it has evaluated — each bound, through the\n  // externalized `gemi/*` imports, to the *previous* `gemi` and therefore the\n  // previous `react`. The next render then sets the dispatcher on the new React\n  // while a cached view calls hooks on the old one: \"Invalid hook call\", a null\n  // `dispatcher.useContext` thrown from `useRouteData` inside a view nobody\n  // touched. Editing a *view* never showed it — Vite's own watcher invalidates\n  // that module, so it re-evaluates against the new instances. Editing a\n  // server-only file (`app/config/*`, a feature declaration, a controller) is\n  // the case with nothing to invalidate the views, so drop the evaluated\n  // modules here, once per reload.\n  //\n  // Here and not before `Bun.serve`, with nothing awaited in between, because\n  // both sides of the swap have to see a consistent pair. Until that call\n  // returns the *previous* fetch handler is still serving — old dispatcher, old\n  // `react-dom/server` — and a request landing there after an early clear would\n  // re-evaluate its views against the *new* `gemi`: the same mismatch, reversed.\n  // After it, the new handler is live and must not be given the stale ones. The\n  // two statements are synchronous neighbours, so no request can be dispatched\n  // between them.\n  //\n  // Only the *evaluated* modules go: the server-side transform cache is\n  // untouched, so this costs a re-evaluation and not a re-transform. Clearing\n  // the module graph as well would not have been enough anyway — externalized\n  // deps (`gemi`, and React through it) are cached in the runner by URL and\n  // carry no invalidation flag, which is exactly where the stale React hides.\n  if (isReload) {\n    ssrRunner(vite).clearCache();\n  }\n\n  // On a reload `app` has already been rebuilt with the new code and Bun.serve\n  // above has swapped in the new fetch handler, so the updated controllers are\n  // live *now*. Tell the client to re-run its queries only at this point —\n  // firing it from Vite's file watcher instead races Bun's reload and leaves\n  // the UI one change behind.\n  if (isReload) {\n    // We got here, so the reload succeeded. Recover from any error that was\n    // showing: a standalone error page must be fully reloaded to get the app\n    // back, whereas an overlay pushed onto a live page is cleared by the\n    // client's `http-reload` handler (no jarring full-page reload). A normal\n    // reload just re-runs client queries against the now-live controllers.\n    if (globalThis.__gemiErrorActive && globalThis.__gemiErrorPageServed) {\n      globalThis.__gemiErrorActive = false;\n      globalThis.__gemiErrorPageServed = false;\n      vite.ws.send({ type: \"full-reload\" });\n    } else {\n      globalThis.__gemiErrorActive = false;\n      vite.ws.send({ type: \"custom\", event: \"http-reload\" });\n    }\n  } else {\n    // First start (not a `bun --hot` reload) — print the startup banner once.\n    printStartupBanner({ port: server.port, rootDir });\n  }\n\n  return server;\n}\n",
-    "import { stringEraRefusal } from \"../http/Error\";\nimport { join } from \"node:path\";\nimport { IncomingMessage, ServerResponse } from \"node:http\";\nimport { Socket } from \"node:net\";\n\nimport type { RunnableDevEnvironment, ViteDevServer } from \"vite\";\n\nimport type { App } from \"../app\";\nimport { isApiPath } from \"../services/router/apiPath\";\nimport { renderErrorPage } from \"./renderErrorPage\";\nimport { createDevStyles } from \"./styles\";\nimport type { Instrumentation } from \"./types\";\n\n// Run a Web `Request` through Vite's Connect middleware.\n// Resolves to a `Response` when Vite handles the request (module transforms,\n// assets, the HMR client, ...), or `null` when it calls `next()` — which, with\n// `appType: \"custom\"`, it does for everything it doesn't own.\nfunction viteMiddleware(vite: ViteDevServer, request: Request): Promise<Response | null> {\n  const url = new URL(request.url);\n\n  const req = new IncomingMessage(new Socket());\n  req.url = url.pathname + url.search;\n  req.method = request.method;\n  req.headers = Object.fromEntries(request.headers);\n\n  const res = new ServerResponse(req);\n  const chunks: Buffer[] = [];\n\n  return new Promise((resolve) => {\n    res.write = ((chunk: any) => {\n      if (chunk) chunks.push(Buffer.from(chunk));\n      return true;\n    }) as typeof res.write;\n\n    res.end = ((chunk?: any) => {\n      if (chunk && typeof chunk !== \"function\") chunks.push(Buffer.from(chunk));\n\n      const headers = new Headers();\n      for (const [key, value] of Object.entries(res.getHeaders())) {\n        if (value == null) continue;\n        for (const v of Array.isArray(value) ? value : [value]) {\n          headers.append(key, String(v));\n        }\n      }\n\n      resolve(\n        new Response(chunks.length ? Buffer.concat(chunks) : null, {\n          status: res.statusCode,\n          headers,\n        }),\n      );\n      return res;\n    }) as typeof res.end;\n\n    vite.middlewares(req, res, () => resolve(null));\n  });\n}\n\ndeclare global {\n  // Created once and reused across `bun --hot` reloads (see below).\n  var __gemiVite: ViteDevServer | undefined;\n  // Guards one-time registration of the process error hooks across reloads.\n  var __gemiErrorHooked: boolean | undefined;\n  // An error overlay is currently showing on the client (clear it on recovery).\n  var __gemiErrorActive: boolean | undefined;\n  // We served a standalone error *page* (not just a pushed overlay), so the\n  // visible document has no live app — recovery needs a full page reload.\n  var __gemiErrorPageServed: boolean | undefined;\n}\n\n// Build the `>  1 | ...\\n     |     ^` codeframe Vite's overlay renders — must\n// match its `codeframeRE` (a `<line> | <text>` line followed by a `| ^` line,\n// each ending in a newline).\nfunction codeFrame(lineText: string, line: number, column: number) {\n  const gutter = String(line);\n  const pad = \" \".repeat(gutter.length);\n  const caret = \" \".repeat(Math.max(0, column - 1)) + \"^\";\n  return `${gutter} |  ${lineText}\\n${pad} |  ${caret}\\n`;\n}\n\n// Normalize whatever Bun/JS throws into the { message, stack, frame, loc }\n// shape Vite's error overlay consumes. Two cases matter:\n//   - a real `Error` (runtime top-level throw) carries a proper `.stack`;\n//   - a Bun `BuildMessage` (syntax error) has NO `.stack`, only a `.position`\n//     ({ file, line, column, lineText }) — so synthesize a codeframe + loc from\n//     it, otherwise the overlay shows a bare message with no location.\n// (An `Error` instance also JSON-stringifies to `{}`, so fields are copied by\n// hand either way.)\nexport function viteErrorPayload(err: any) {\n  if (err && typeof err === \"object\") {\n    const pos = err.position;\n    if (pos && typeof pos === \"object\" && typeof pos.file === \"string\") {\n      return {\n        message: typeof err.message === \"string\" ? err.message : String(err),\n        stack: \"\",\n        frame:\n          typeof pos.lineText === \"string\"\n            ? codeFrame(pos.lineText, pos.line, pos.column)\n            : undefined,\n        loc: { file: pos.file, line: pos.line, column: pos.column },\n      };\n    }\n    return {\n      message: typeof err.message === \"string\" ? err.message : String(err),\n      stack: typeof err.stack === \"string\" ? err.stack : \"\",\n    };\n  }\n  return { message: String(err), stack: \"\" };\n}\n\n// Push an error into the browser via Vite's HMR socket. `__gemiVite` persists\n// across `bun --hot` reloads, so this works even when the reload that produced\n// the error never got far enough to (re)run `httpDev`.\nexport function sendErrorToClient(err: any) {\n  const vite = globalThis.__gemiVite;\n  if (!vite) return;\n  vite.ws.send({ type: \"error\", err: viteErrorPayload(err) as any });\n  globalThis.__gemiErrorActive = true;\n}\n\n/**\n * The SSR environment's module runner — what `vite.ssrLoadModule` is a thin\n * (and, in Vite 8, deprecated) wrapper over. Going through it directly is what\n * gives `httpDev` a handle on the evaluated-module cache it has to drop after a\n * `bun --hot` reload; `ssrLoadModule` keeps its own runner private.\n *\n * Duck-typed rather than `isRunnableDevEnvironment(environment)`: this server\n * outlives the module instance that created it, and after a reload the freshly\n * evaluated `vite` brings a *new* `RunnableDevEnvironment` class object, so the\n * `instanceof` that predicate performs is false for a perfectly runnable\n * environment. (The same one-copy-per-reload rule this whole dance is about.)\n */\nexport function ssrRunner(vite: ViteDevServer) {\n  const environment = vite.environments.ssr as RunnableDevEnvironment;\n  if (typeof environment?.runner?.import !== \"function\") {\n    throw new Error(\"gemi dev requires a runnable Vite SSR environment.\");\n  }\n  return environment.runner;\n}\n\n/**\n * The two scripts the dev document's bootstrap loads that nothing on disk\n * backs: `/refresh.js` installs the React Refresh preamble, and\n * `/render-error.js` is what the dev error page loads. `null` for any other\n * path.\n *\n * Answered inside the global middleware, not in front of it as they were. They\n * have no production counterpart, but a gate that must hold in dev as well,\n * one that refuses traffic without a header, is only complete if nothing the\n * dev server answers goes around it.\n */\nfunction devScript(req: Request): Response | null {\n  const { pathname, host, protocol } = new URL(req.url);\n  if (pathname.startsWith(\"/render-error.js\")) {\n    return new Response(\"window.render_error = true\", {\n      headers: {\n        \"Content-Type\": \"application/javascript\",\n      },\n    });\n  }\n  if (pathname.startsWith(\"/refresh.js\")) {\n    return new Response(\n      `\n      import RefreshRuntime from \"${protocol}//${host}/@react-refresh\";\n      RefreshRuntime.injectIntoGlobalHook(window);\n      window.$RefreshReg$ = () => {};\n      window.$RefreshSig$ = () => (type) => type;\n      window.__vite_plugin_react_preamble_installed__ = true;\n    `,\n      {\n        headers: {\n          \"Content-Type\": \"application/javascript\",\n        },\n      },\n    );\n  }\n  return null;\n}\n\n/**\n * The dev server's `fetch` handler, apart from `Bun.serve` and from creating\n * Vite, so a test can hand it a stub Vite server and drive it with plain\n * `Request`s. `httpDev` is the only other caller. This module has no import\n * side effects, unlike `httpDev.ts`, which installs process-wide error hooks.\n */\nexport function createDevFetch(\n  app: App,\n  instrumentation: Instrumentation,\n  vite: ViteDevServer,\n): (req: Request) => Promise<Response> {\n  const appDir = join(process.cwd(), \"app\");\n\n  return async (req) => {\n    const { pathname } = new URL(req.url);\n    const errorResponse = (err: any): Response => {\n      // Errors thrown *while handling a request* (a controller throwing, a\n      // failing view import, ...) never hit `httpDev`'s module-load hooks,\n      // so surface them here: forward to the overlay for any already-open\n      // page, and render an error page for this response so a fresh load\n      // (which has no live HMR socket yet) still shows the failure.\n      console.error(err);\n      vite.ssrFixStacktrace?.(err);\n      sendErrorToClient(err);\n\n      if (isApiPath(pathname)) {\n        return new Response(\n          JSON.stringify({\n            error: stringEraRefusal(\"server_error\", err?.message ?? String(err), 500),\n          }),\n          {\n            status: 500,\n            headers: { \"Content-Type\": \"application/json\" },\n          },\n        );\n      }\n\n      // This document has no live app (so no HttpReload listener to clear the\n      // overlay) — remember that, so recovery forces a full page reload.\n      globalThis.__gemiErrorPageServed = true;\n      return new Response(renderErrorPage(viteErrorPayload(err)), {\n        status: 500,\n        headers: { \"Content-Type\": \"text/html\" },\n      });\n    };\n    const requestHandler = async (req: Request): Promise<Response> => {\n      const script = devScript(req);\n      if (script) {\n        return script;\n      }\n      try {\n        const handler = app.fetch.bind(app);\n        const result = (await viteMiddleware(vite, req)) ?? (await handler(req));\n        if (result instanceof Response) {\n          return result;\n        }\n\n        const viewImportMap = {};\n        const ogMap = {};\n        const viewModules = {};\n        const template = (viewName: string, path: string) =>\n          `\"${viewName}\": () => import(\"${path}\")`;\n        const templates = [];\n\n        for (const fileName of [\"404\", ...app.getFlatComponentTree.call(app)]) {\n          if (process.env.NODE_ENV === \"test\") {\n            break;\n          }\n          const appDir = `${process.env.APP_DIR}`;\n          const mod = await ssrRunner(vite).import(`${appDir}/views/${fileName}.tsx`);\n\n          viewImportMap[fileName] = mod.default;\n          ogMap[fileName] = mod?.OpenGraph;\n          // The whole module, so a streaming render can put the view's\n          // `Loading`/`Error` exports into the shell it sends.\n          viewModules[fileName] = mod;\n          // Emit a root-relative URL (`/app/views/Foo.tsx`), NOT the absolute\n          // filesystem path the runner import above uses. The browser's\n          // `window.loaders` preload and `client.tsx`'s `import.meta.glob` map\n          // must import the exact same URL — otherwise Vite serves the module\n          // under two URLs (`/app/views/Foo.tsx` vs `/Users/.../app/views/Foo.tsx`)\n          // and loads/instantiates the view twice.\n          templates.push(template(fileName, `/app/views/${fileName}.tsx`));\n        }\n\n        const loaders = `{${templates.join(\",\")}}`;\n\n        return await result({\n          getStyles: async (currentViews: string[]) =>\n            await createDevStyles(appDir, vite, currentViews),\n          bootstrapModules: [\"/refresh.js\", \"/app/client.tsx\", \"/@vite/client\"],\n          viewImportMap,\n          viewModules,\n          ogMap,\n          loaders,\n          cssManifest: {},\n        });\n      } catch (err: any) {\n        return errorResponse(err);\n      }\n    };\n\n    // In front of Vite's middleware, the dev scripts and the app, as\n    // `httpProd` puts the global middleware in front of its static files, so a\n    // check that passes here passes there. A throw from it is answered like\n    // one from a route. Vite's HMR websocket is the one thing it cannot cover:\n    // in middleware mode Vite serves it from a server of its own, on its own\n    // port, and those requests never reach this handler.\n    return await instrumentation(req, (req) =>\n      app.withGlobalMiddleware(req, requestHandler, errorResponse),\n    );\n  };\n}\n",
-    "function cleanupTerminalText(text) {\n  return (\n    text\n      // Remove ANSI escape sequences (colors, formatting)\n      .replace(/\\x1b\\[[0-9;]*m/g, \"\")\n      // Remove ANSI escape sequences with different format\n      .replace(/\\[[0-9;]*m/g, \"\")\n      // Remove excessive whitespace and normalize line breaks\n      .replace(/\\n\\s*\\n/g, \"\\n\")\n      // Trim each line\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter((line) => line.length > 0)\n      .join(\"\\n\")\n      .trim()\n  );\n}\n\nexport function renderErrorPage(err: any) {\n  return `\n<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta\n      name=\"viewport\"\n      content=\"width=device-width, initial-scale=1.0\"\n    />\n\n    <title>Error</title>\n    <style>\n      body {\n        font-family: Arial, sans-serif;\n        padding: 20px;\n      }\n      h1 {\n        color: red;\n      }\n    </style>\n  </head>\n  <body>\n  <div id=\"overlay\"></div>\n    <script type=\"module\" src=\"/refresh.js\"></script>\n    <script type=\"module\" src=\"/@vite/client\"></script>\n    <script>\n      ${cleanupTerminalText.toString()}\n      const err = ${JSON.stringify(err, Object.getOwnPropertyNames(err), 2)}\n\n      window.addEventListener('load', () => {\n        const container = document.getElementById('overlay')\n        const ErrorOverlay = customElements.get('vite-error-overlay')\n        if (ErrorOverlay) {\n      const overlay = new ErrorOverlay({ ...err, message: cleanupTerminalText(err.message) });\n          container.appendChild(overlay)\n        }\n      })\n    </script>\n  </body>\n</html>\n`;\n}\n",
-    "// Vite's HMR websocket needs a port of its own, and in middleware mode Vite\n// always picks the same one.\n//\n// `httpDev` runs Vite with `middlewareMode: true`, so Vite has no HTTP server of\n// its own to hang the websocket off — it stands up a second HTTP server just for\n// the upgrade. When nothing names a port, that server binds Vite's default 24678\n// in *every* `gemi dev` process. `PORT` moves the Bun server and nothing else, so\n// a second dev server logs\n//\n//   WebSocket server error: Port undefined is already in use\n//\n// and carries on with a dead socket. (Vite logs that failure rather than throwing\n// — which is why the symptom is not a crash but pages that hot-reload on the\n// *other* checkout's edits: their `/@vite/client` was told 24678, and 24678 is\n// the first server's.) So gemi names the port instead of letting Vite default it.\n//\n// Why derive from the HTTP port rather than just scan for a free one: two dev\n// servers must already differ in `PORT` to run at all, so deriving makes their\n// HMR ports differ *before* either one binds anything. A scan alone would hand\n// both the same port when they start at the same moment, each having probed\n// before the other bound. The scan is still here, for the port being taken by\n// something that is not a gemi dev server.\n\nconst VITE_DEFAULT_HTTP_PORT = 5173;\nconst VITE_DEFAULT_HMR_PORT = 24678;\n\n// A port is 16 bits.\nconst MAX_PORT = 65535;\n\n// How far to walk up from the derived port before giving up. Large enough that\n// only a pathological machine exhausts it, small enough to fail in well under a\n// second rather than appearing to hang.\nconst SEARCH_WINDOW = 64;\n\n/**\n * Bind-test a port the same way Vite will.\n *\n * Vite calls `wsHttpServer.listen(port, host)` with no host unless one is\n * configured, so its websocket server takes the wildcard address — which is what\n * this binds too. The match matters: a wildcard bind collides with a wildcard\n * *or* a loopback holder, while a loopback bind only collides with loopback. A\n * process holding `127.0.0.1:P` alone therefore reads as free here, correctly —\n * Vite would fail to bind `*:P` against it, but nothing in gemi makes Vite bind\n * loopback-only, so that case cannot arise from a second `gemi dev`.\n *\n * Only `EADDRINUSE` counts as taken. Any other failure — a permission error, an\n * unroutable address — is not something a different port would fix, so it is\n * reported free and left for Vite to surface.\n */\nfunction isPortFree(port: number): boolean {\n  try {\n    const listener = Bun.listen({\n      hostname: \"0.0.0.0\",\n      port,\n      socket: { data() {} },\n    });\n    // `true` closes active connections too. There are none — nothing has been\n    // told this port exists yet — but it also makes the close synchronous, so\n    // the port is released before the next probe or before Vite binds it.\n    listener.stop(true);\n    return true;\n  } catch (error) {\n    return (error as { code?: string })?.code !== \"EADDRINUSE\";\n  }\n}\n\n/**\n * Pick the port for Vite's HMR websocket, given the port the dev server's HTTP\n * side is on.\n *\n * `5173` returns `24678` — Vite's two defaults stay paired, so a single dev\n * server behaves exactly as it did before, and anything pointed at 24678 (a\n * firewall rule, a container port mapping, a note in a README) keeps working.\n * Every other HTTP port is offset by the same distance, so distinct `PORT`s\n * always yield distinct HMR ports.\n *\n * @param isFree Injected for tests. Production callers use the bind test above.\n */\nexport function resolveHmrPort(\n  httpPort: number,\n  isFree: (port: number) => boolean = isPortFree,\n): number {\n  let start = VITE_DEFAULT_HMR_PORT + (httpPort - VITE_DEFAULT_HTTP_PORT);\n\n  // A high `PORT` can push the derived port past the top of the range — or so\n  // close to it that the walk would run off the end. Fall back to the default\n  // and let the scan sort it out; being *adjacent* to another server's port is\n  // fine, landing *on* it is what has to be avoided, and the scan does that.\n  //\n  // There is deliberately no matching floor. The offset is only -5173, so the\n  // lowest a real HTTP port can derive is 19505 (from `PORT=0`) — a guard for\n  // the bottom of the range would be a branch no input can take.\n  if (start > MAX_PORT - SEARCH_WINDOW) {\n    start = VITE_DEFAULT_HMR_PORT;\n  }\n\n  for (let port = start; port < start + SEARCH_WINDOW; port++) {\n    if (isFree(port)) return port;\n  }\n\n  throw new Error(\n    `Could not find a free port for Vite's HMR websocket: tried ${start}-${\n      start + SEARCH_WINDOW - 1\n    }. Set one explicitly in gemi.config.ts as \\`vite: { server: { ws: { port } } }\\`.`,\n  );\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "C04C1884C64AAF6F64756E2164756E21",
-  "names": []
-}