@rshono/core 1.0.0-rc.1 → 1.0.0-rc.10

package/dist/deploy/node/runtime.d.ts

@@ -2,6 +2,10 @@ import type { DeployRuntime } from '../contract.js';
 /**
  * Node: a long-lived process that owns its own port, with a filesystem behind every asset. The shape
  * the framework was built against, and the only target `rshono dev` ever produces.
+ *
+ * Anything that runs a Node process runs this build — a VPS, a container, a PaaS — and Bun and Deno
+ * are expected to as well, since the listener below is `@hono/node-server` and both implement the
+ * `node:` APIs it needs.
  */
 export declare const runtime: DeployRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/deploy/node/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/deploy/node/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,aA2BrB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/deploy/node/runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAqBpD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,aA4BrB,CAAC"}

package/dist/deploy/node/runtime.js

@@ -1,11 +1,31 @@
 import { serve } from '@hono/node-server';
 import { parentPort, workerData } from 'node:worker_threads';
+import { SERVER_DEFAULTS } from '../../server/server-config.js';
 import { onShutdown } from '../../server/shutdown.js';
 import { fileSystemRuntime } from '../filesystem.js';
-import { listenAddress, readyMessage } from '../listen.js';
+/** Bound to every interface — so the address printed on start is `localhost`, not this. */
+const WILDCARD_HOST = '0.0.0.0';
+/**
+ * Resolves the address to listen on: an explicit override (the dev server, which picks the port for its
+ * worker) beats the environment, which beats the built-in default.
+ *
+ * `PORT` and `HOST` are the whole interface, because that is the deployment convention everywhere
+ * this runs. `??` rather than `||` so an explicit `PORT=0`, meaning "any free port", is honoured.
+ */
+function listenAddress(overrides) {
+    const envPort = process.env.PORT !== undefined ? Number(process.env.PORT) : undefined;
+    return {
+        port: overrides?.port ?? envPort ?? SERVER_DEFAULTS.port,
+        hostname: overrides?.hostname ?? process.env.HOST ?? SERVER_DEFAULTS.host,
+    };
+}
 /**
  * Node: a long-lived process that owns its own port, with a filesystem behind every asset. The shape
  * the framework was built against, and the only target `rshono dev` ever produces.
+ *
+ * Anything that runs a Node process runs this build — a VPS, a container, a PaaS — and Bun and Deno
+ * are expected to as well, since the listener below is `@hono/node-server` and both implement the
+ * `node:` APIs it needs.
  */
 export const runtime = {
     ...fileSystemRuntime,
@@ -16,7 +36,7 @@ export const runtime = {
         if (process.env.RSHONO_PRERENDER)
             return;
         // The dev server runs this bundle in a worker thread and picks the port itself, so its choice wins
-        // over both the environment and the config file.
+        // over the environment.
         const devWorker = workerData;
         const address = listenAddress(devWorker ?? undefined);
         const server = serve({ fetch: app.fetch, ...address }, (info) => {
@@ -24,7 +44,8 @@ export const runtime = {
                 parentPort.postMessage({ type: 'ready', port: info.port });
             }
             else {
-                console.log(readyMessage({ ...address, port: info.port }));
+                const host = address.hostname === WILDCARD_HOST ? 'localhost' : address.hostname;
+                console.log(`  ➜ rshono serving on http://${host}:${info.port}`);
             }
         });
         onShutdown(() => {

package/dist/deploy/node/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/deploy/node/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,GAAG,iBAAiB;IAEpB,QAAQ,CAAC,GAAS;QAChB,+FAA+F;QAC/F,+FAA+F;QAC/F,0BAA0B;QAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;YAAE,OAAO;QAEzC,mGAAmG;QACnG,iDAAiD;QACjD,MAAM,SAAS,GAAG,UAAyD,CAAC;QAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC","sourcesContent":["import { serve } from '@hono/node-server';\nimport type { Hono } from 'hono';\nimport { parentPort, workerData } from 'node:worker_threads';\nimport { onShutdown } from '../../server/shutdown.js';\nimport type { DeployRuntime } from '../contract.js';\nimport { fileSystemRuntime } from '../filesystem.js';\nimport { listenAddress, readyMessage } from '../listen.js';\n\n/**\n * Node: a long-lived process that owns its own port, with a filesystem behind every asset. The shape\n * the framework was built against, and the only target `rshono dev` ever produces.\n */\nexport const runtime: DeployRuntime = {\n  ...fileSystemRuntime,\n\n  serveApp(app: Hono): undefined {\n    // `rshono build` imports this bundle to prerender `render: 'static'` routes. That pass renders\n    // through `app.fetch` directly and must not bind a port — nothing is listening for it, and the\n    // build would never exit.\n    if (process.env.RSHONO_PRERENDER) return;\n\n    // The dev server runs this bundle in a worker thread and picks the port itself, so its choice wins\n    // over both the environment and the config file.\n    const devWorker = workerData as { port?: number; hostname?: string } | null;\n    const address = listenAddress(devWorker ?? undefined);\n\n    const server = serve({ fetch: app.fetch, ...address }, (info) => {\n      if (parentPort) {\n        parentPort.postMessage({ type: 'ready', port: info.port });\n      } else {\n        console.log(readyMessage({ ...address, port: info.port }));\n      }\n    });\n\n    onShutdown(() => {\n      server.close(() => process.exit(0));\n      setTimeout(() => process.exit(0), 3000).unref();\n    });\n  },\n};\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/deploy/node/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,2FAA2F;AAC3F,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,SAAgD;IACrE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,OAAO;QACL,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,OAAO,IAAI,eAAe,CAAC,IAAI;QACxD,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI;KAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,GAAG,iBAAiB;IAEpB,QAAQ,CAAC,GAAS;QAChB,+FAA+F;QAC/F,+FAA+F;QAC/F,0BAA0B;QAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;YAAE,OAAO;QAEzC,mGAAmG;QACnG,wBAAwB;QACxB,MAAM,SAAS,GAAG,UAAyD,CAAC;QAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACjF,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC","sourcesContent":["import { serve } from '@hono/node-server';\nimport type { Hono } from 'hono';\nimport { parentPort, workerData } from 'node:worker_threads';\nimport { SERVER_DEFAULTS } from '../../server/server-config.js';\nimport { onShutdown } from '../../server/shutdown.js';\nimport type { DeployRuntime } from '../contract.js';\nimport { fileSystemRuntime } from '../filesystem.js';\n\n/** Bound to every interface — so the address printed on start is `localhost`, not this. */\nconst WILDCARD_HOST = '0.0.0.0';\n\n/**\n * Resolves the address to listen on: an explicit override (the dev server, which picks the port for its\n * worker) beats the environment, which beats the built-in default.\n *\n * `PORT` and `HOST` are the whole interface, because that is the deployment convention everywhere\n * this runs. `??` rather than `||` so an explicit `PORT=0`, meaning \"any free port\", is honoured.\n */\nfunction listenAddress(overrides?: { port?: number; hostname?: string }): { port: number; hostname: string } {\n  const envPort = process.env.PORT !== undefined ? Number(process.env.PORT) : undefined;\n  return {\n    port: overrides?.port ?? envPort ?? SERVER_DEFAULTS.port,\n    hostname: overrides?.hostname ?? process.env.HOST ?? SERVER_DEFAULTS.host,\n  };\n}\n\n/**\n * Node: a long-lived process that owns its own port, with a filesystem behind every asset. The shape\n * the framework was built against, and the only target `rshono dev` ever produces.\n *\n * Anything that runs a Node process runs this build — a VPS, a container, a PaaS — and Bun and Deno\n * are expected to as well, since the listener below is `@hono/node-server` and both implement the\n * `node:` APIs it needs.\n */\nexport const runtime: DeployRuntime = {\n  ...fileSystemRuntime,\n\n  serveApp(app: Hono): undefined {\n    // `rshono build` imports this bundle to prerender `render: 'static'` routes. That pass renders\n    // through `app.fetch` directly and must not bind a port — nothing is listening for it, and the\n    // build would never exit.\n    if (process.env.RSHONO_PRERENDER) return;\n\n    // The dev server runs this bundle in a worker thread and picks the port itself, so its choice wins\n    // over the environment.\n    const devWorker = workerData as { port?: number; hostname?: string } | null;\n    const address = listenAddress(devWorker ?? undefined);\n\n    const server = serve({ fetch: app.fetch, ...address }, (info) => {\n      if (parentPort) {\n        parentPort.postMessage({ type: 'ready', port: info.port });\n      } else {\n        const host = address.hostname === WILDCARD_HOST ? 'localhost' : address.hostname;\n        console.log(`  ➜ rshono serving on http://${host}:${info.port}`);\n      }\n    });\n\n    onShutdown(() => {\n      server.close(() => process.exit(0));\n      setTimeout(() => process.exit(0), 3000).unref();\n    });\n  },\n};\n"]}

package/dist/deploy/presets.d.ts

@@ -57,8 +57,8 @@ export interface DeployPreset {
 }
 /**
  * Node: a long-lived server process. The generated config is already this shape, so the preset has
- * nothing to contribute — the platform-specific settings still living in `builder/rspack-config.ts`
- * (`target: 'node'`, the externals policy, ESM chunk output) are the Node ones by default.
+ * nothing to contribute — the settings in `builder/rspack-config.ts` (`target: 'node'`, the externals
+ * policy, ESM chunk output) are the Node ones by default.
  */
 export declare const NODE_PRESET: DeployPreset;
 /** Every target `deploy` accepts, for error messages and docs. */
@@ -74,7 +74,7 @@ export interface DeploySources {
     flag?: string;
     /** The `RSHONO_DEPLOY` env var — for a CI job that deploys the same app to more than one place. */
     env?: string;
-    /** {@link RSHonoConfig.deploy} from `rshono.config.ts`. */
+    /** {@link RshonoConfig.deploy} from `rshono.config.ts`. */
     config?: string;
 }
 /**

package/dist/deploy/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/deploy/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;OAIG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,YAIzB,CAAC;AA+EF,kEAAkE;AAClE,eAAO,MAAM,cAAc,EAA2B,YAAY,EAAE,CAAC;AAErE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAS7E"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/deploy/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;OAIG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,YAIzB,CAAC;AA4DF,kEAAkE;AAClE,eAAO,MAAM,cAAc,EAA2B,YAAY,EAAE,CAAC;AAErE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAS7E"}

package/dist/deploy/presets.js

@@ -1,10 +1,9 @@
 import { finalizeCloudflareBuild } from './cloudflare/build.js';
-import { finalizeNetlifyBuild } from './netlify/build.js';
 import { finalizeVercelBuild } from './vercel/build.js';
 /**
  * Node: a long-lived server process. The generated config is already this shape, so the preset has
- * nothing to contribute — the platform-specific settings still living in `builder/rspack-config.ts`
- * (`target: 'node'`, the externals policy, ESM chunk output) are the Node ones by default.
+ * nothing to contribute — the settings in `builder/rspack-config.ts` (`target: 'node'`, the externals
+ * policy, ESM chunk output) are the Node ones by default.
  */
 export const NODE_PRESET = {
     name: 'node',
@@ -36,23 +35,11 @@ const CLOUDFLARE_PRESET = {
     finalize: finalizeCloudflareBuild,
 };
 /**
- * Bun and Deno: like Node, but the runtime opens the socket from the module's default export. Their
- * `node:` compatibility covers everything `server/` uses, so the bundle is Node's — only the handoff
- * differs, which is precisely the thing an app cannot do for itself.
- */
-const BUN_PRESET = {
-    name: 'bun',
-    runtimeModule: 'deploy/bun/runtime.js',
-    deployHint: 'run `bun dist/server/main.mjs`',
-};
-const DENO_PRESET = {
-    name: 'deno',
-    runtimeModule: 'deploy/deno/runtime.js',
-    deployHint: 'run `deno serve -A dist/server/main.mjs`',
-};
-/**
- * Vercel and Netlify: one Node function behind the platform's CDN, which serves the assets and reaches
- * the function only for a page. Both `finalize` hooks assemble the layout the platform uploads.
+ * Vercel: one Node function behind the platform's CDN, which serves the assets and reaches the function
+ * only for a page. `finalize` assembles the Build Output API layout the platform uploads — including the
+ * `supportsResponseStreaming` flag, without which Vercel buffers the whole response and streamed SSR is
+ * silently undone. That flag, and the exact path the bundle has to keep, are the reason this is a preset
+ * rather than a snippet in the docs.
  */
 const VERCEL_PRESET = {
     name: 'vercel',
@@ -60,13 +47,12 @@ const VERCEL_PRESET = {
     deployHint: 'deploy with `vercel deploy --prebuilt`',
     finalize: finalizeVercelBuild,
 };
-const NETLIFY_PRESET = {
-    name: 'netlify',
-    runtimeModule: 'deploy/netlify/runtime.js',
-    deployHint: 'deploy with `netlify deploy --build=false --dir=.netlify/publish`',
-    finalize: finalizeNetlifyBuild,
-};
-/** AWS Lambda behind a Function URL in `RESPONSE_STREAM` mode — the AWS shape that keeps streaming. */
+/**
+ * AWS Lambda behind a Function URL in `RESPONSE_STREAM` mode — the AWS shape that keeps streaming.
+ *
+ * Same reasoning as Vercel: the runtime wraps the app in `awslambda.streamifyResponse`, and the buffered
+ * alternative would deploy fine and then hold every page until its last byte rendered.
+ */
 const AWS_LAMBDA_PRESET = {
     name: 'aws-lambda',
     runtimeModule: 'deploy/aws-lambda/runtime.js',
@@ -75,10 +61,7 @@ const AWS_LAMBDA_PRESET = {
 const PRESETS = {
     node: NODE_PRESET,
     cloudflare: CLOUDFLARE_PRESET,
-    bun: BUN_PRESET,
-    deno: DENO_PRESET,
     vercel: VERCEL_PRESET,
-    netlify: NETLIFY_PRESET,
     'aws-lambda': AWS_LAMBDA_PRESET,
 };
 /** Every target `deploy` accepts, for error messages and docs. */

package/dist/deploy/presets.js.map

@@ -1 +1 @@
-{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/deploy/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA2DxD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,wBAAwB;IACvC,UAAU,EAAE,oBAAoB;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAiB;IACtC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,8BAA8B;IAC7C,UAAU,EAAE,+BAA+B;IAC3C,iBAAiB,EAAE,CAAC,SAAS,CAAC;IAC9B,aAAa,EAAE,CAAC,YAAY,CAAC;IAC7B,eAAe,CAAC,MAAM;QACpB,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5B,MAAM,CAAC,aAAa,GAAG,eAAe,CAAC;QACvC,MAAM,CAAC,SAAS,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,QAAQ,EAAE,uBAAuB;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,GAAiB;IAC/B,IAAI,EAAE,KAAK;IACX,aAAa,EAAE,uBAAuB;IACtC,UAAU,EAAE,gCAAgC;CAC7C,CAAC;AAEF,MAAM,WAAW,GAAiB;IAChC,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,wBAAwB;IACvC,UAAU,EAAE,0CAA0C;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,aAAa,GAAiB;IAClC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,0BAA0B;IACzC,UAAU,EAAE,wCAAwC;IACpD,QAAQ,EAAE,mBAAmB;CAC9B,CAAC;AAEF,MAAM,cAAc,GAAiB;IACnC,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,2BAA2B;IAC1C,UAAU,EAAE,mEAAmE;IAC/E,QAAQ,EAAE,oBAAoB;CAC/B,CAAC;AAEF,uGAAuG;AACvG,MAAM,iBAAiB,GAAiB;IACtC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,8BAA8B;IAC7C,UAAU,EAAE,oDAAoD;CACjE,CAAC;AAEF,MAAM,OAAO,GAAuC;IAClD,IAAI,EAAE,WAAW;IACjB,UAAU,EAAE,iBAAiB;IAC7B,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,cAAc;IACvB,YAAY,EAAE,iBAAiB;CAChC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAmB,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAQ,OAAoD,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,IAAI,CAAC;AAC3F,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAkB,EAAE;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACrF,IAAI,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC;IAEhC,MAAM,MAAM,GAAI,OAAoD,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,uBAAuB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { RspackOptions } from '@rspack/core';\nimport { finalizeCloudflareBuild } from './cloudflare/build.js';\nimport type { DeployTarget } from './contract.js';\nimport { finalizeNetlifyBuild } from './netlify/build.js';\nimport { finalizeVercelBuild } from './vercel/build.js';\n\n/** What a preset's {@link DeployPreset.finalize} is told about the build it is arranging. */\nexport interface DeployBuildContext {\n  /** The project root — where `rshono build` ran, and what a platform config file is written next to. */\n  rootDir: string;\n  /** `<root>/dist`. */\n  distDir: string;\n  /** The hashed client bundle, `<root>/dist/static` — served at `/_static`. */\n  staticDir: string;\n  /** The copy of the app's `public/`, or `null` when it has none. Served at the web root. */\n  publicDir: string | null;\n  /** Prerendered pages, `<root>/dist/ssg` — empty when the app has no `render: 'static'` routes. */\n  ssgDir: string;\n}\n\n/**\n * The build-time half of a deploy target: which runtime module the bundle gets, how the server\n * compiler has to change to produce something the platform can run, and how the output is arranged\n * once it exists.\n *\n * The runtime half is {@link DeployRuntime}, in its own file because it is compiled *into* the app\n * bundle — this side only ever runs in the CLI.\n */\nexport interface DeployPreset {\n  readonly name: DeployTarget;\n  /**\n   * The module `@rshono/deploy` resolves to, as a path relative to the framework's own `dist/`.\n   * Slash-separated and split on use, so it stays a valid path on Windows too.\n   */\n  readonly runtimeModule: string;\n  /** How to run what was just built, completing the \"build complete —\" line. */\n  readonly deployHint: string;\n  /**\n   * Extra resolve conditions for the server bundle, most specific first.\n   *\n   * This is what picks the right build of React and the RSC runtime: both ship one per runtime behind\n   * `workerd` / `deno` / `edge-light` / `node` conditions. Omit it to accept whatever the Rspack\n   * target implies, which is correct for Node.\n   */\n  readonly resolveConditions?: readonly string[];\n  /** browserslist-style targets for the server bundle's swc pass. Defaults to Node. */\n  readonly syntaxTargets?: readonly string[];\n  /**\n   * Adjusts the generated server Rspack config for this platform — target, externals policy, output\n   * shape. Mutates in place, and runs *before* the user's `rspack` hook so that hook keeps the last\n   * word.\n   */\n  configureServer?(config: RspackOptions): void;\n  /**\n   * Arranges the finished build for the platform: assembles whatever directory layout it expects,\n   * emits its config file, and prints how to deploy.\n   *\n   * Runs last — after both bundles, the `public/` copy and the prerender pass — so everything it\n   * needs to move is already on disk.\n   */\n  finalize?(ctx: DeployBuildContext): Promise<void> | void;\n}\n\n/**\n * Node: a long-lived server process. The generated config is already this shape, so the preset has\n * nothing to contribute — the platform-specific settings still living in `builder/rspack-config.ts`\n * (`target: 'node'`, the externals policy, ESM chunk output) are the Node ones by default.\n */\nexport const NODE_PRESET: DeployPreset = {\n  name: 'node',\n  runtimeModule: 'deploy/node/runtime.js',\n  deployHint: 'run `rshono start`',\n};\n\n/**\n * Cloudflare Workers: the host owns the process, the CDN owns the assets, and there is no filesystem.\n *\n * Every compiler setting here follows from `workerd` not being Node. Dependencies are bundled because\n * nothing resolves `node_modules` at runtime; `node:` and `cloudflare:` imports stay external because\n * the runtime provides them (`nodejs_compat`, which the scaffolded config enables for\n * `AsyncLocalStorage`); and async chunks are inlined because Wrangler's bundler cannot follow the\n * computed specifier Rspack's ESM chunk loader emits — a split bundle would deploy and then fail on\n * the first page render.\n */\nconst CLOUDFLARE_PRESET: DeployPreset = {\n  name: 'cloudflare',\n  runtimeModule: 'deploy/cloudflare/runtime.js',\n  deployHint: 'deploy with `wrangler deploy`',\n  resolveConditions: ['workerd'],\n  syntaxTargets: ['chrome 120'],\n  configureServer(config) {\n    config.target = 'webworker';\n    config.externalsType = 'module-import';\n    config.externals = [/^(?:node|cloudflare):/];\n    config.output = { ...config.output, asyncChunks: false };\n  },\n  finalize: finalizeCloudflareBuild,\n};\n\n/**\n * Bun and Deno: like Node, but the runtime opens the socket from the module's default export. Their\n * `node:` compatibility covers everything `server/` uses, so the bundle is Node's — only the handoff\n * differs, which is precisely the thing an app cannot do for itself.\n */\nconst BUN_PRESET: DeployPreset = {\n  name: 'bun',\n  runtimeModule: 'deploy/bun/runtime.js',\n  deployHint: 'run `bun dist/server/main.mjs`',\n};\n\nconst DENO_PRESET: DeployPreset = {\n  name: 'deno',\n  runtimeModule: 'deploy/deno/runtime.js',\n  deployHint: 'run `deno serve -A dist/server/main.mjs`',\n};\n\n/**\n * Vercel and Netlify: one Node function behind the platform's CDN, which serves the assets and reaches\n * the function only for a page. Both `finalize` hooks assemble the layout the platform uploads.\n */\nconst VERCEL_PRESET: DeployPreset = {\n  name: 'vercel',\n  runtimeModule: 'deploy/vercel/runtime.js',\n  deployHint: 'deploy with `vercel deploy --prebuilt`',\n  finalize: finalizeVercelBuild,\n};\n\nconst NETLIFY_PRESET: DeployPreset = {\n  name: 'netlify',\n  runtimeModule: 'deploy/netlify/runtime.js',\n  deployHint: 'deploy with `netlify deploy --build=false --dir=.netlify/publish`',\n  finalize: finalizeNetlifyBuild,\n};\n\n/** AWS Lambda behind a Function URL in `RESPONSE_STREAM` mode — the AWS shape that keeps streaming. */\nconst AWS_LAMBDA_PRESET: DeployPreset = {\n  name: 'aws-lambda',\n  runtimeModule: 'deploy/aws-lambda/runtime.js',\n  deployHint: 'zip dist/ with the handler at dist/server/main.mjs',\n};\n\nconst PRESETS: Record<DeployTarget, DeployPreset> = {\n  node: NODE_PRESET,\n  cloudflare: CLOUDFLARE_PRESET,\n  bun: BUN_PRESET,\n  deno: DENO_PRESET,\n  vercel: VERCEL_PRESET,\n  netlify: NETLIFY_PRESET,\n  'aws-lambda': AWS_LAMBDA_PRESET,\n};\n\n/** Every target `deploy` accepts, for error messages and docs. */\nexport const DEPLOY_TARGETS = Object.keys(PRESETS) as DeployTarget[];\n\n/**\n * How to deploy what a given target built, or `null` for a name this rshono does not know — which a\n * `dist/` produced by a newer version can legitimately carry.\n */\nexport function deployHintFor(target: string): string | null {\n  return (PRESETS as Record<string, DeployPreset | undefined>)[target]?.deployHint ?? null;\n}\n\n/** Where a deploy target can be named, in precedence order. */\nexport interface DeploySources {\n  /** The `--deploy` flag. */\n  flag?: string;\n  /** The `RSHONO_DEPLOY` env var — for a CI job that deploys the same app to more than one place. */\n  env?: string;\n  /** {@link RSHonoConfig.deploy} from `rshono.config.ts`. */\n  config?: string;\n}\n\n/**\n * Resolves the preset to build with: the flag wins over the environment, which wins over the config\n * file, which wins over the `node` default.\n *\n * Blank values are ignored at every level, so an unset-but-present `RSHONO_DEPLOY=` in a CI\n * environment falls through to the config file instead of failing the build.\n */\nexport function resolveDeployPreset(sources: DeploySources = {}): DeployPreset {\n  const target = sources.flag?.trim() || sources.env?.trim() || sources.config?.trim();\n  if (!target) return NODE_PRESET;\n\n  const preset = (PRESETS as Record<string, DeployPreset | undefined>)[target];\n  if (!preset) {\n    throw new Error(`[rshono] unknown deploy target ${JSON.stringify(target)} — expected one of: ${DEPLOY_TARGETS.join(', ')}.`);\n  }\n  return preset;\n}\n"]}
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/deploy/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA2DxD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,wBAAwB;IACvC,UAAU,EAAE,oBAAoB;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAiB;IACtC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,8BAA8B;IAC7C,UAAU,EAAE,+BAA+B;IAC3C,iBAAiB,EAAE,CAAC,SAAS,CAAC;IAC9B,aAAa,EAAE,CAAC,YAAY,CAAC;IAC7B,eAAe,CAAC,MAAM;QACpB,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5B,MAAM,CAAC,aAAa,GAAG,eAAe,CAAC;QACvC,MAAM,CAAC,SAAS,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,QAAQ,EAAE,uBAAuB;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,aAAa,GAAiB;IAClC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,0BAA0B;IACzC,UAAU,EAAE,wCAAwC;IACpD,QAAQ,EAAE,mBAAmB;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAiB;IACtC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,8BAA8B;IAC7C,UAAU,EAAE,oDAAoD;CACjE,CAAC;AAEF,MAAM,OAAO,GAAuC;IAClD,IAAI,EAAE,WAAW;IACjB,UAAU,EAAE,iBAAiB;IAC7B,MAAM,EAAE,aAAa;IACrB,YAAY,EAAE,iBAAiB;CAChC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAmB,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAQ,OAAoD,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,IAAI,CAAC;AAC3F,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAkB,EAAE;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACrF,IAAI,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC;IAEhC,MAAM,MAAM,GAAI,OAAoD,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,uBAAuB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { RspackOptions } from '@rspack/core';\nimport { finalizeCloudflareBuild } from './cloudflare/build.js';\nimport type { DeployTarget } from './contract.js';\nimport { finalizeVercelBuild } from './vercel/build.js';\n\n/** What a preset's {@link DeployPreset.finalize} is told about the build it is arranging. */\nexport interface DeployBuildContext {\n  /** The project root — where `rshono build` ran, and what a platform config file is written next to. */\n  rootDir: string;\n  /** `<root>/dist`. */\n  distDir: string;\n  /** The hashed client bundle, `<root>/dist/static` — served at `/_static`. */\n  staticDir: string;\n  /** The copy of the app's `public/`, or `null` when it has none. Served at the web root. */\n  publicDir: string | null;\n  /** Prerendered pages, `<root>/dist/ssg` — empty when the app has no `render: 'static'` routes. */\n  ssgDir: string;\n}\n\n/**\n * The build-time half of a deploy target: which runtime module the bundle gets, how the server\n * compiler has to change to produce something the platform can run, and how the output is arranged\n * once it exists.\n *\n * The runtime half is {@link DeployRuntime}, in its own file because it is compiled *into* the app\n * bundle — this side only ever runs in the CLI.\n */\nexport interface DeployPreset {\n  readonly name: DeployTarget;\n  /**\n   * The module `@rshono/deploy` resolves to, as a path relative to the framework's own `dist/`.\n   * Slash-separated and split on use, so it stays a valid path on Windows too.\n   */\n  readonly runtimeModule: string;\n  /** How to run what was just built, completing the \"build complete —\" line. */\n  readonly deployHint: string;\n  /**\n   * Extra resolve conditions for the server bundle, most specific first.\n   *\n   * This is what picks the right build of React and the RSC runtime: both ship one per runtime behind\n   * `workerd` / `deno` / `edge-light` / `node` conditions. Omit it to accept whatever the Rspack\n   * target implies, which is correct for Node.\n   */\n  readonly resolveConditions?: readonly string[];\n  /** browserslist-style targets for the server bundle's swc pass. Defaults to Node. */\n  readonly syntaxTargets?: readonly string[];\n  /**\n   * Adjusts the generated server Rspack config for this platform — target, externals policy, output\n   * shape. Mutates in place, and runs *before* the user's `rspack` hook so that hook keeps the last\n   * word.\n   */\n  configureServer?(config: RspackOptions): void;\n  /**\n   * Arranges the finished build for the platform: assembles whatever directory layout it expects,\n   * emits its config file, and prints how to deploy.\n   *\n   * Runs last — after both bundles, the `public/` copy and the prerender pass — so everything it\n   * needs to move is already on disk.\n   */\n  finalize?(ctx: DeployBuildContext): Promise<void> | void;\n}\n\n/**\n * Node: a long-lived server process. The generated config is already this shape, so the preset has\n * nothing to contribute — the settings in `builder/rspack-config.ts` (`target: 'node'`, the externals\n * policy, ESM chunk output) are the Node ones by default.\n */\nexport const NODE_PRESET: DeployPreset = {\n  name: 'node',\n  runtimeModule: 'deploy/node/runtime.js',\n  deployHint: 'run `rshono start`',\n};\n\n/**\n * Cloudflare Workers: the host owns the process, the CDN owns the assets, and there is no filesystem.\n *\n * Every compiler setting here follows from `workerd` not being Node. Dependencies are bundled because\n * nothing resolves `node_modules` at runtime; `node:` and `cloudflare:` imports stay external because\n * the runtime provides them (`nodejs_compat`, which the scaffolded config enables for\n * `AsyncLocalStorage`); and async chunks are inlined because Wrangler's bundler cannot follow the\n * computed specifier Rspack's ESM chunk loader emits — a split bundle would deploy and then fail on\n * the first page render.\n */\nconst CLOUDFLARE_PRESET: DeployPreset = {\n  name: 'cloudflare',\n  runtimeModule: 'deploy/cloudflare/runtime.js',\n  deployHint: 'deploy with `wrangler deploy`',\n  resolveConditions: ['workerd'],\n  syntaxTargets: ['chrome 120'],\n  configureServer(config) {\n    config.target = 'webworker';\n    config.externalsType = 'module-import';\n    config.externals = [/^(?:node|cloudflare):/];\n    config.output = { ...config.output, asyncChunks: false };\n  },\n  finalize: finalizeCloudflareBuild,\n};\n\n/**\n * Vercel: one Node function behind the platform's CDN, which serves the assets and reaches the function\n * only for a page. `finalize` assembles the Build Output API layout the platform uploads — including the\n * `supportsResponseStreaming` flag, without which Vercel buffers the whole response and streamed SSR is\n * silently undone. That flag, and the exact path the bundle has to keep, are the reason this is a preset\n * rather than a snippet in the docs.\n */\nconst VERCEL_PRESET: DeployPreset = {\n  name: 'vercel',\n  runtimeModule: 'deploy/vercel/runtime.js',\n  deployHint: 'deploy with `vercel deploy --prebuilt`',\n  finalize: finalizeVercelBuild,\n};\n\n/**\n * AWS Lambda behind a Function URL in `RESPONSE_STREAM` mode — the AWS shape that keeps streaming.\n *\n * Same reasoning as Vercel: the runtime wraps the app in `awslambda.streamifyResponse`, and the buffered\n * alternative would deploy fine and then hold every page until its last byte rendered.\n */\nconst AWS_LAMBDA_PRESET: DeployPreset = {\n  name: 'aws-lambda',\n  runtimeModule: 'deploy/aws-lambda/runtime.js',\n  deployHint: 'zip dist/ with the handler at dist/server/main.mjs',\n};\n\nconst PRESETS: Record<DeployTarget, DeployPreset> = {\n  node: NODE_PRESET,\n  cloudflare: CLOUDFLARE_PRESET,\n  vercel: VERCEL_PRESET,\n  'aws-lambda': AWS_LAMBDA_PRESET,\n};\n\n/** Every target `deploy` accepts, for error messages and docs. */\nexport const DEPLOY_TARGETS = Object.keys(PRESETS) as DeployTarget[];\n\n/**\n * How to deploy what a given target built, or `null` for a name this rshono does not know — which a\n * `dist/` produced by a newer version can legitimately carry.\n */\nexport function deployHintFor(target: string): string | null {\n  return (PRESETS as Record<string, DeployPreset | undefined>)[target]?.deployHint ?? null;\n}\n\n/** Where a deploy target can be named, in precedence order. */\nexport interface DeploySources {\n  /** The `--deploy` flag. */\n  flag?: string;\n  /** The `RSHONO_DEPLOY` env var — for a CI job that deploys the same app to more than one place. */\n  env?: string;\n  /** {@link RshonoConfig.deploy} from `rshono.config.ts`. */\n  config?: string;\n}\n\n/**\n * Resolves the preset to build with: the flag wins over the environment, which wins over the config\n * file, which wins over the `node` default.\n *\n * Blank values are ignored at every level, so an unset-but-present `RSHONO_DEPLOY=` in a CI\n * environment falls through to the config file instead of failing the build.\n */\nexport function resolveDeployPreset(sources: DeploySources = {}): DeployPreset {\n  const target = sources.flag?.trim() || sources.env?.trim() || sources.config?.trim();\n  if (!target) return NODE_PRESET;\n\n  const preset = (PRESETS as Record<string, DeployPreset | undefined>)[target];\n  if (!preset) {\n    throw new Error(`[rshono] unknown deploy target ${JSON.stringify(target)} — expected one of: ${DEPLOY_TARGETS.join(', ')}.`);\n  }\n  return preset;\n}\n"]}

package/dist/deploy/vercel/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/deploy/vercel/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,EAAE,aAcrB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/deploy/vercel/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,EAAE,aAUrB,CAAC"}

package/dist/deploy/vercel/runtime.js

@@ -19,8 +19,5 @@ export const runtime = {
     serveApp(app) {
         return handle(app);
     },
-    // Vercel compresses at the edge. Its Node runtime does support streaming, so the framework's own
-    // streamed SSR still reaches the browser progressively.
-    compress: null,
 };
 //# sourceMappingURL=runtime.js.map

package/dist/deploy/vercel/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/deploy/vercel/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,GAAG,iBAAiB;IAEpB,iBAAiB;QACf,gEAAgE;IAClE,CAAC;IAED,QAAQ,CAAC,GAAS;QAChB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,iGAAiG;IACjG,wDAAwD;IACxD,QAAQ,EAAE,IAAI;CACf,CAAC","sourcesContent":["import type { Hono } from 'hono';\nimport { handle } from 'hono/vercel';\nimport type { DeployRuntime } from '../contract.js';\nimport { fileSystemRuntime } from '../filesystem.js';\n\n/**\n * Vercel, as a single Node function fed by the platform's own router.\n *\n * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler\n * ahead of the function — so the CDN answers them and the function is never invoked for an asset,\n * which is why mounting them here would only be dead weight.\n *\n * Prerendered pages are *not* static output: one URL answers with a document or a flight payload\n * depending on `Accept`, and a path-keyed CDN cannot choose. They ship inside the function instead and\n * are read from its read-only disk, exactly as on a server.\n */\nexport const runtime: DeployRuntime = {\n  ...fileSystemRuntime,\n\n  mountStaticAssets(): void {\n    // Served from `.vercel/output/static` before the function runs.\n  },\n\n  serveApp(app: Hono): unknown {\n    return handle(app);\n  },\n\n  // Vercel compresses at the edge. Its Node runtime does support streaming, so the framework's own\n  // streamed SSR still reaches the browser progressively.\n  compress: null,\n};\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/deploy/vercel/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,GAAG,iBAAiB;IAEpB,iBAAiB;QACf,gEAAgE;IAClE,CAAC;IAED,QAAQ,CAAC,GAAS;QAChB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;CACF,CAAC","sourcesContent":["import type { Hono } from 'hono';\nimport { handle } from 'hono/vercel';\nimport type { DeployRuntime } from '../contract.js';\nimport { fileSystemRuntime } from '../filesystem.js';\n\n/**\n * Vercel, as a single Node function fed by the platform's own router.\n *\n * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler\n * ahead of the function — so the CDN answers them and the function is never invoked for an asset,\n * which is why mounting them here would only be dead weight.\n *\n * Prerendered pages are *not* static output: one URL answers with a document or a flight payload\n * depending on `Accept`, and a path-keyed CDN cannot choose. They ship inside the function instead and\n * are read from its read-only disk, exactly as on a server.\n */\nexport const runtime: DeployRuntime = {\n  ...fileSystemRuntime,\n\n  mountStaticAssets(): void {\n    // Served from `.vercel/output/static` before the function runs.\n  },\n\n  serveApp(app: Hono): unknown {\n    return handle(app);\n  },\n};\n"]}

package/dist/index.d.ts

@@ -5,19 +5,16 @@
  *
  * The two companion entry points are runtime-only:
  * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside
- *   server components and actions (`getContext`, `redirect`, `notFound`), plus
+ *   server components and actions (`getRequestContext`, `redirect`, `notFound`), plus
  *   `onServerError` for reporting the errors the framework catches.
  * - `@rshono/core/client` — hooks and components for `'use client'` modules
- *   (`useNavigation`, `Boundary`, `ErrorBoundary`, `NavigationProgress`).
+ *   (`useNavigation`, `AsyncBoundary`, `CatchBoundary`).
+ *
+ * @see {@link https://www.rshono.com/docs/api | Docs — API reference}
  *
  * @packageDocumentation
  */
-export { defineRoutes, isPageRoute, type EndpointRoute, type EndpointServerModule, type ErrorInfo, type ErrorPageProps, type FallbackPage, type HTTPMethod, type PageComponent, type PageProps, type PageRoute, type PathParams, type Route, type RouteConfig, } from './router.js';
-export { defineConfig, type RSHonoConfig, type RspackHookContext } from './config.js';
+export { defineRoutes, type EndpointRoute, type EndpointServerModule, type ErrorPageInfo, type ErrorPageProps, type FallbackPage, type HTTPMethod, type PageComponent, type PageProps, type PageRoute, type PathParams, type Route, type RouteConfig, } from './router.js';
+export { defineConfig, type RshonoConfig, type RspackHookContext } from './config.js';
 export type { DeployTarget } from './deploy/contract.js';
-/**
- * Re-exported from Hono for convenience, so an endpoint module can type its
- * `handler` without depending on `hono` directly.
- */
-export type { Context, Handler } from 'hono';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtF,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtF,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -5,13 +5,18 @@
  *
  * The two companion entry points are runtime-only:
  * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside
- *   server components and actions (`getContext`, `redirect`, `notFound`), plus
+ *   server components and actions (`getRequestContext`, `redirect`, `notFound`), plus
  *   `onServerError` for reporting the errors the framework catches.
  * - `@rshono/core/client` — hooks and components for `'use client'` modules
- *   (`useNavigation`, `Boundary`, `ErrorBoundary`, `NavigationProgress`).
+ *   (`useNavigation`, `AsyncBoundary`, `CatchBoundary`).
+ *
+ * @see {@link https://www.rshono.com/docs/api | Docs — API reference}
  *
  * @packageDocumentation
  */
-export { defineRoutes, isPageRoute, } from './router.js';
+export { defineRoutes, } from './router.js';
 export { defineConfig } from './config.js';
+// Hono's `Context` and `Handler` are deliberately not re-exported: `hono` is a peer dependency every
+// app already has, so an endpoint module imports them from there rather than choosing between two
+// spellings of the same type.
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,YAAY,EACZ,WAAW,GAaZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAC","sourcesContent":["/**\n * `@rshono/core` — the build-time surface: route and config declaration plus the types\n * your pages and endpoints are written against. Everything here is safe to\n * import from server code; none of it pulls in runtime machinery.\n *\n * The two companion entry points are runtime-only:\n * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside\n *   server components and actions (`getContext`, `redirect`, `notFound`), plus\n *   `onServerError` for reporting the errors the framework catches.\n * - `@rshono/core/client` — hooks and components for `'use client'` modules\n *   (`useNavigation`, `Boundary`, `ErrorBoundary`, `NavigationProgress`).\n *\n * @packageDocumentation\n */\n\nexport {\n  defineRoutes,\n  isPageRoute,\n  type EndpointRoute,\n  type EndpointServerModule,\n  type ErrorInfo,\n  type ErrorPageProps,\n  type FallbackPage,\n  type HTTPMethod,\n  type PageComponent,\n  type PageProps,\n  type PageRoute,\n  type PathParams,\n  type Route,\n  type RouteConfig,\n} from './router.js';\n\nexport { defineConfig, type RSHonoConfig, type RspackHookContext } from './config.js';\n\nexport type { DeployTarget } from './deploy/contract.js';\n\n/**\n * Re-exported from Hono for convenience, so an endpoint module can type its\n * `handler` without depending on `hono` directly.\n */\nexport type { Context, Handler } from 'hono';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,YAAY,GAab,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAC;AAItF,qGAAqG;AACrG,kGAAkG;AAClG,8BAA8B","sourcesContent":["/**\n * `@rshono/core` — the build-time surface: route and config declaration plus the types\n * your pages and endpoints are written against. Everything here is safe to\n * import from server code; none of it pulls in runtime machinery.\n *\n * The two companion entry points are runtime-only:\n * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside\n *   server components and actions (`getRequestContext`, `redirect`, `notFound`), plus\n *   `onServerError` for reporting the errors the framework catches.\n * - `@rshono/core/client` — hooks and components for `'use client'` modules\n *   (`useNavigation`, `AsyncBoundary`, `CatchBoundary`).\n *\n * @see {@link https://www.rshono.com/docs/api | Docs — API reference}\n *\n * @packageDocumentation\n */\n\nexport {\n  defineRoutes,\n  type EndpointRoute,\n  type EndpointServerModule,\n  type ErrorPageInfo,\n  type ErrorPageProps,\n  type FallbackPage,\n  type HTTPMethod,\n  type PageComponent,\n  type PageProps,\n  type PageRoute,\n  type PathParams,\n  type Route,\n  type RouteConfig,\n} from './router.js';\n\nexport { defineConfig, type RshonoConfig, type RspackHookContext } from './config.js';\n\nexport type { DeployTarget } from './deploy/contract.js';\n\n// Hono's `Context` and `Handler` are deliberately not re-exported: `hono` is a peer dependency every\n// app already has, so an endpoint module imports them from there rather than choosing between two\n// spellings of the same type.\n"]}

package/dist/router.d.ts

@@ -1,7 +1,7 @@
 import type { Env, Handler } from 'hono';
 import type { ParamKeys, ParamKeyToRecord } from 'hono/types';
 import type { ReactNode } from 'react';
-import type { Ctx } from './runtime/context.js';
+import type { RequestContext } from './runtime/context.js';
 type Simplify<T> = {
     [K in keyof T]: T[K];
 } & {};
@@ -19,6 +19,8 @@ type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) exten
  * ```ts
  * type P = PathParams<'/users/:id/posts/:postId'>; // { id: string; postId: string }
  * ```
+ *
+ * @see {@link https://hono.dev/docs/api/routing#path-parameter | Hono — path parameters}
  */
 export type PathParams<P extends string> = ParamKeys<P> extends never ? Record<string, never> : Simplify<UnionToIntersection<ParamKeyToRecord<ParamKeys<P>>>>;
 /**
@@ -34,8 +36,8 @@ export type PathParams<P extends string> = ParamKeys<P> extends never ? Record<s
  * the server/client line is a copy-paste.
  *
  * @typeParam Path - The literal path this page is mounted at, e.g. `'/profile/:id'`.
- * @typeParam E - The app's Hono {@link Env}, to type {@link Ctx.var} and
- *   {@link Ctx.env} on {@link PageProps.ctx}.
+ * @typeParam E - The app's Hono {@link Env}, to type {@link RequestContext.var} and
+ *   {@link RequestContext.env} on {@link PageProps.ctx}.
  *
  * @example
  * ```tsx
@@ -47,6 +49,8 @@ export type PathParams<P extends string> = ParamKeys<P> extends never ? Record<s
  *   return <Layout>{user.name} — {tab}</Layout>;
  * }
  * ```
+ *
+ * @see {@link https://www.rshono.com/docs/pages#page-props | Docs — page props}
  */
 export interface PageProps<Path extends string = string, E extends Env = Env> {
     /**
@@ -55,42 +59,35 @@ export interface PageProps<Path extends string = string, E extends Env = Env> {
      * the rest off it.
      *
      * A fresh instance per request that nothing else holds, so mutating it is local
-     * to the page — but note it is *not* serializable, so a `'use client'` component
-     * has to be handed `url.href` rather than `url`.
+     * to the page. It is not serializable, so a `'use client'` component has to be
+     * handed `url.href` rather than `url`.
      *
-     * On a prerendered page it is the build-time URL: a `render: 'static'` route is
-     * rendered once, against `siteUrl` and with no query string, and that one file
-     * then answers every request whatever its own query. So `url.searchParams` is
-     * always empty there — read the query from `useNavigation().url` in a
-     * `'use client'` component instead, or mark the route `render: 'dynamic'`.
+     * On a `render: 'static'` route this is the build-time URL — rendered once
+     * against `siteUrl` with no query string, and that one file answers every
+     * request whatever its own query. So `url.searchParams` is always empty there:
+     * read the query from `useNavigation().url` in a `'use client'` component
+     * instead, or mark the route `render: 'dynamic'`.
      */
     url: URL;
     /** Matched route params for this request, e.g. `{ id: '42' }` for `/profile/:id`. */
     params: string extends Path ? Record<string, string> : PathParams<Path>;
     /**
-     * The request context — the very object `getContext()` returns, handed to the
+     * The request context — the very object `getRequestContext()` returns, handed to the
      * page so cookies, headers, env and middleware variables are reachable without
      * an import.
      *
-     * Server-only, and never serialized: React renders a server component and puts
-     * its *output* on the wire, not its props. It is also deliberately a
-     * non-enumerable property, which has three consequences worth knowing:
-     *
-     * - It **cannot be handed to a `'use client'` component** — it wraps the live
-     *   request and response, which do not exist in the browser. Passing it
-     *   explicitly (`<Counter ctx={ctx} />`) fails the render with React's *"Only
-     *   plain objects … can be passed to Client Components"*. Read what you need on
-     *   the server and pass plain values down.
-     * - Spreading the page's props instead (`<Counter {...props} />`) drops `ctx`
-     *   silently rather than failing, since the spread copies enumerables only.
-     *   (That spread still fails, mind — on `url`, which is enumerable and just as
-     *   unserializable. Pass the values you need.)
-     * - `Object.keys(props)`, `JSON.stringify(props)` and friends don't see it.
+     * Server-only and never serialized: React puts a server component's *output* on
+     * the wire, not its props. It is also deliberately **non-enumerable**, so
+     * `Object.keys(props)`, `JSON.stringify(props)` and a `{...props}` spread all
+     * skip it. Handing it to a `'use client'` component directly
+     * (`<Counter ctx={ctx} />`) fails the render — it wraps the live request and
+     * response, which do not exist in the browser. Read what you need here and pass
+     * plain values down.
      *
      * Reading it on a `render: 'static'` route throws: a prerendered page has no
-     * per-request context at build time. Mark the route `render: 'dynamic'` (or use
-     * the `url` / `params` props, which are available either way — with the
-     * build-time caveats noted on `url`).
+     * per-request context at build time. Mark the route `render: 'dynamic'`, or use
+     * the `url` / `params` props — available either way, with the build-time caveat
+     * noted on `url`.
      *
      * @example
      * ```tsx
@@ -101,7 +98,7 @@ export interface PageProps<Path extends string = string, E extends Env = Env> {
      * }
      * ```
      */
-    ctx: Ctx<E>;
+    ctx: RequestContext<E>;
 }
 /**
  * A page: a React **server component** that renders the entire document
@@ -112,6 +109,9 @@ export interface PageProps<Path extends string = string, E extends Env = Env> {
  * belong in `'use client'` components the page imports — only those ship JS.
  *
  * @typeParam P - The component's props; for a page these are {@link PageProps}.
+ *
+ * @see {@link https://react.dev/reference/rsc/server-components | React — Server Components}
+ * @see {@link https://www.rshono.com/docs/pages | Docs — pages}
  */
 export type PageComponent<P = any> = (props: P) => ReactNode | Promise<ReactNode>;
 /**
@@ -122,13 +122,21 @@ export type PageComponent<P = any> = (props: P) => ReactNode | Promise<ReactNode
  * @example
  * ```ts
  * // src/health.ts
- * import type { Handler } from '@rshono/core';
+ * import type { Handler } from 'hono';
  *
  * export const handler: Handler = (c) => c.json({ ok: true });
  * ```
+ *
+ * @see {@link https://www.rshono.com/docs/routing#endpoint-routes | Docs — endpoint routes}
  */
 export interface EndpointServerModule {
-    /** A Hono {@link Handler} handling every request matched by the route. */
+    /**
+     * A Hono {@link Handler} handling every request matched by the route. It is passed Hono's
+     * `Context`, so the request, response builders (`c.json`, `c.text`, `c.body`) and middleware
+     * variables are all reached through it.
+     *
+     * @see {@link https://hono.dev/docs/api/context | Hono — Context}
+     */
     handler: Handler;
 }
 /**
@@ -143,7 +151,12 @@ export interface EndpointServerModule {
 export interface PageRoute {
     /** Discriminates a page from an endpoint; optional because `'page'` is the default. */
     type?: 'page';
-    /** Hono-style path pattern, e.g. `/`, `/profile/:id`, `/files/*`. */
+    /**
+     * Hono-style path pattern, e.g. `/`, `/profile/:id`, `/files/*`. Routes are matched in
+     * declaration order.
+     *
+     * @see {@link https://hono.dev/docs/api/routing | Hono — routing}
+     */
     path: string;
     /**
      * Dynamic import of the page module, whose default export is the
@@ -156,6 +169,8 @@ export interface PageRoute {
      * component up any other way — a variable, a barrel re-export, a computed
      * specifier — add `'use server-entry'` as the first line of the page module
      * yourself; the framework throws a descriptive error when neither happened.
+     *
+     * @see {@link https://www.rshono.com/docs/pages#the-use-server-entry-directive | Docs — the `'use server-entry'` directive}
      */
     component: () => Promise<{
         default: PageComponent;
@@ -180,6 +195,8 @@ export interface PageRoute {
      *   staticPaths: async () => (await db.docs.all()).map((d) => ({ slug: d.slug })),
      * }
      * ```
+     *
+     * @see {@link https://www.rshono.com/docs/routing#static-rendering | Docs — static rendering}
      */
     staticPaths?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
 }
@@ -192,11 +209,17 @@ export interface PageRoute {
  * ```ts
  * { type: 'endpoint', path: '/api/health', server: () => import('./health') }
  * ```
+ *
+ * @see {@link https://www.rshono.com/docs/routing#endpoint-routes | Docs — endpoint routes}
  */
 export interface EndpointRoute {
     /** Marks this route as an endpoint rather than a page. Required. */
     type: 'endpoint';
-    /** Hono-style path pattern, e.g. `/api/health`, `/api/users/:id`. */
+    /**
+     * Hono-style path pattern, e.g. `/api/health`, `/api/users/:id`.
+     *
+     * @see {@link https://hono.dev/docs/api/routing | Hono — routing}
+     */
     path: string;
     /** HTTP method to match. Defaults to `'all'` — every method. */
     method?: HTTPMethod;
@@ -211,12 +234,10 @@ export type Route = PageRoute | EndpointRoute;
  * Type guard narrowing a {@link Route} to a {@link PageRoute}. Because `type` is
  * optional on page routes, anything not explicitly `'endpoint'` is a page.
  *
- * @example
- * ```ts
- * for (const route of routes) {
- *   if (isPageRoute(route)) console.log(route.render ?? 'dynamic');
- * }
- * ```
+ * Framework internal — not re-exported from `index.ts`. The request renderer and
+ * the SSG pass use it to split the route table.
+ *
+ * @internal
  */
 export declare function isPageRoute(route: Route): route is PageRoute;
 /**
@@ -235,7 +256,7 @@ export interface FallbackPage {
  * message is a generic `'Internal Server Error'` and there is no `stack`. In dev
  * you get the real message plus the stack.
  */
-export interface ErrorInfo {
+export interface ErrorPageInfo {
     /** The thrown error's message in dev; `'Internal Server Error'` in production. */
     message: string;
     /** The stack trace. Present in dev only. */
@@ -243,7 +264,7 @@ export interface ErrorInfo {
 }
 /**
  * Props for the `error` page declared in {@link RouteConfig.error} — the usual
- * {@link PageProps} plus the redaction-aware {@link ErrorInfo}.
+ * {@link PageProps} plus the redaction-aware {@link ErrorPageInfo}.
  *
  * @typeParam E - The app's Hono {@link Env}, forwarded to {@link PageProps.ctx}.
  *
@@ -257,7 +278,8 @@ export interface ErrorInfo {
  * ```
  */
 export type ErrorPageProps<E extends Env = Env> = PageProps<string, E> & {
-    error: ErrorInfo;
+    /** The error that failed the request, redacted in production — see {@link ErrorPageInfo}. */
+    error: ErrorPageInfo;
 };
 /**
  * The object form accepted by {@link defineRoutes}: the route table plus the two
@@ -265,6 +287,8 @@ export type ErrorPageProps<E extends Env = Env> = PageProps<string, E> & {
  *
  * @typeParam TRoutes - Inferred tuple of route literals, which is what makes the
  *   per-route `path` → props check possible.
+ *
+ * @see {@link https://www.rshono.com/docs/routing#notfound-and-error | Docs — notFound and error pages}
  */
 export interface RouteConfig<TRoutes extends readonly Route[] = readonly Route[]> {
     /** Every page and endpoint in the app, matched in order. */
@@ -298,8 +322,10 @@ type ValidateRoutes<TRoutes extends readonly Route[]> = {
  * PageProps<'/…'>`. Fix it by matching the page's `PageProps<Path>` type
  * argument to the path it's mounted at.
  *
- * @param config - A {@link RouteConfig}, or a bare {@link Route} array as
- *   shorthand when there are no `notFound` / `error` pages.
+ * A bare {@link Route} array is accepted as shorthand — see the second overload.
+ *
+ * @param config - A {@link RouteConfig}: the `routes` array plus the optional
+ *   `notFound` and `error` pages.
  * @returns The config, unchanged and fully typed.
  *
  * @example
@@ -324,14 +350,25 @@ type ValidateRoutes<TRoutes extends readonly Route[]> = {
  * });
  * ```
  *
- * @example Array shorthand
- * ```ts
- * export const routes = defineRoutes([{ path: '/', component: () => import('./components/home') }]);
- * ```
+ * @see {@link https://www.rshono.com/docs/routing | Docs — routing}
  */
 export declare function defineRoutes<const TRoutes extends readonly Route[]>(config: RouteConfig<TRoutes> & {
     routes: ValidateRoutes<TRoutes>;
 }): RouteConfig<TRoutes>;
+/**
+ * Array shorthand for {@link defineRoutes} — equivalent to `defineRoutes({ routes })`, for an app
+ * with no `notFound` or `error` page.
+ *
+ * @param routes - The {@link Route} array; each page is checked against its own `path`.
+ * @returns A {@link RouteConfig} wrapping them.
+ *
+ * @example
+ * ```ts
+ * export const routes = defineRoutes([{ path: '/', component: () => import('./components/home') }]);
+ * ```
+ *
+ * @see {@link https://www.rshono.com/docs/routing | Docs — routing}
+ */
 export declare function defineRoutes<const TRoutes extends readonly Route[]>(routes: TRoutes & ValidateRoutes<TRoutes>): RouteConfig<TRoutes>;
 export {};
 //# sourceMappingURL=router.d.ts.map