@rshono/core 1.0.0-rc.12 → 1.0.0-rc.14

package/dist/deploy/presets.js

@@ -1,9 +1,8 @@
 import { finalizeCloudflareBuild } from './cloudflare/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 settings in `builder/rspack-config.ts` (`target: 'node'`, the externals
- * policy, ESM chunk output) are the Node ones by default.
+ * Node: a long-lived server process. The generated config is already this shape — `target: 'node'`, the
+ * externals policy and ESM chunk output are all defaults — so the preset has nothing to contribute.
  */
 export const NODE_PRESET = {
     name: 'node',
@@ -13,12 +12,10 @@ export const NODE_PRESET = {
 /**
  * Cloudflare Workers: the host owns the process, the CDN owns the assets, and there is no filesystem.
  *
- * Every compiler setting here follows from `workerd` not being Node. Dependencies are bundled because
- * nothing resolves `node_modules` at runtime; `node:` and `cloudflare:` imports stay external because
- * the runtime provides them (`nodejs_compat`, which the scaffolded config enables for
- * `AsyncLocalStorage`); and async chunks are inlined because Wrangler's bundler cannot follow the
- * computed specifier Rspack's ESM chunk loader emits — a split bundle would deploy and then fail on
- * the first page render.
+ * Every setting here follows from `workerd` not being Node. Dependencies are bundled because nothing resolves
+ * `node_modules` at runtime; `node:` and `cloudflare:` imports stay external because the runtime provides
+ * them under `nodejs_compat`; and async chunks are inlined because Wrangler's bundler cannot follow the
+ * computed specifier Rspack's ESM chunk loader emits — a split bundle deploys and then fails on first render.
  */
 const CLOUDFLARE_PRESET = {
     name: 'cloudflare',
@@ -35,28 +32,50 @@ const CLOUDFLARE_PRESET = {
     finalize: finalizeCloudflareBuild,
 };
 /**
- * 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.
+ * Bundles the app's dependencies into the server output instead of importing them from `node_modules`.
+ *
+ * The generated config externalizes them, which is right where the bundle runs *inside* the project — but a
+ * serverless function is uploaded as a directory rather than installed into one, so nothing resolves
+ * `node_modules` at request time and an externalized `import 'some-package'` is a cold start that dies on
+ * `ERR_MODULE_NOT_FOUND`. Node's own builtins stay external either way, through the `node` externals preset
+ * that `target: 'node'` already enables.
+ *
+ * The cost is a dependency that cannot be bundled — a native addon, or one that reads its own files off disk
+ * relative to `__dirname`. Those now fail the build rather than the deploy, which is the same constraint
+ * `cloudflare` has always had; the `rspack` hook in `rshono.config.ts` is the way out.
+ */
+function bundleDependencies(config) {
+    config.externals = [];
+}
+/**
+ * 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 silently undoes
+ * streamed SSR.
+ *
+ * Only `dist/server` is uploaded with the function, which is why dependencies are bundled: see
+ * {@link bundleDependencies}.
  */
 const VERCEL_PRESET = {
     name: 'vercel',
     runtimeModule: 'deploy/vercel/runtime.js',
     deployHint: 'deploy with `vercel deploy --prebuilt`',
+    configureServer: bundleDependencies,
     finalize: finalizeVercelBuild,
 };
 /**
- * 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. The
+ * runtime wraps the app in `awslambda.streamifyResponse`; the buffered alternative would deploy fine and then
+ * hold every page until its last byte rendered.
  *
- * 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.
+ * The deployment package is `dist/` and nothing else, which is why dependencies are bundled: see
+ * {@link bundleDependencies}.
  */
 const AWS_LAMBDA_PRESET = {
     name: 'aws-lambda',
     runtimeModule: 'deploy/aws-lambda/runtime.js',
     deployHint: 'zip dist/ with the handler at dist/server/main.mjs',
+    configureServer: bundleDependencies,
 };
 const PRESETS = {
     node: NODE_PRESET,
@@ -67,18 +86,16 @@ const PRESETS = {
 /** Every target `deploy` accepts, for error messages and docs. */
 export const DEPLOY_TARGETS = Object.keys(PRESETS);
 /**
- * How to deploy what a given target built, or `null` for a name this rshono does not know — which a
- * `dist/` produced by a newer version can legitimately carry.
+ * How to deploy what a given target built, or `null` for a name this rshono does not know — which a `dist/`
+ * from a newer version can legitimately carry.
  */
 export function deployHintFor(target) {
     return PRESETS[target]?.deployHint ?? null;
 }
 /**
- * Resolves the preset to build with: the flag wins over the environment, which wins over the config
- * file, which wins over the `node` default.
- *
- * Blank values are ignored at every level, so an unset-but-present `RSHONO_DEPLOY=` in a CI
- * environment falls through to the config file instead of failing the build.
+ * Resolves the preset to build with: the flag wins over the environment, which wins over the config file,
+ * which wins over the `node` default. Blank values are ignored at every level, so an unset-but-present
+ * `RSHONO_DEPLOY=` in CI falls through rather than failing the build.
  */
 export function resolveDeployPreset(sources = {}) {
     const target = sources.flag?.trim() || sources.env?.trim() || sources.config?.trim();

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,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"]}
+{"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;AAoDxD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,wBAAwB;IACvC,UAAU,EAAE,oBAAoB;CACjC,CAAC;AAEF;;;;;;;GAOG;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;;;;;;;;;;;;GAYG;AACH,SAAS,kBAAkB,CAAC,MAAqB;IAC/C,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAiB;IAClC,IAAI,EAAE,QAAQ;IACd,aAAa,EAAE,0BAA0B;IACzC,UAAU,EAAE,wCAAwC;IACpD,eAAe,EAAE,kBAAkB;IACnC,QAAQ,EAAE,mBAAmB;CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAAiB;IACtC,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,8BAA8B;IAC7C,UAAU,EAAE,oDAAoD;IAChE,eAAe,EAAE,kBAAkB;CACpC,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;;;;GAIG;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 compiler has\n * to change to produce something the platform can run, and how the output is arranged once it exists.\n *\n * The runtime half is `DeployRuntime`, in its own file because it is compiled *into* the app bundle — this\n * 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 — what picks the right build of React\n   * and the RSC runtime, both of which ship one per runtime. Omit to accept whatever the Rspack target\n   * 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 shape.\n   * Mutates in place, and runs before the user's `rspack` hook so that hook keeps the last word.\n   */\n  configureServer?(config: RspackOptions): void;\n  /**\n   * Arranges the finished build for the platform: assembles the directory layout it expects, emits its config\n   * file, and prints how to deploy. Runs last, so everything it 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 — `target: 'node'`, the\n * externals policy and ESM chunk output are all defaults — so the preset has nothing to contribute.\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 setting here follows from `workerd` not being Node. Dependencies are bundled because nothing resolves\n * `node_modules` at runtime; `node:` and `cloudflare:` imports stay external because the runtime provides\n * them under `nodejs_compat`; and async chunks are inlined because Wrangler's bundler cannot follow the\n * computed specifier Rspack's ESM chunk loader emits — a split bundle deploys and then fails on first 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 * Bundles the app's dependencies into the server output instead of importing them from `node_modules`.\n *\n * The generated config externalizes them, which is right where the bundle runs *inside* the project — but a\n * serverless function is uploaded as a directory rather than installed into one, so nothing resolves\n * `node_modules` at request time and an externalized `import 'some-package'` is a cold start that dies on\n * `ERR_MODULE_NOT_FOUND`. Node's own builtins stay external either way, through the `node` externals preset\n * that `target: 'node'` already enables.\n *\n * The cost is a dependency that cannot be bundled — a native addon, or one that reads its own files off disk\n * relative to `__dirname`. Those now fail the build rather than the deploy, which is the same constraint\n * `cloudflare` has always had; the `rspack` hook in `rshono.config.ts` is the way out.\n */\nfunction bundleDependencies(config: RspackOptions): void {\n  config.externals = [];\n}\n\n/**\n * Vercel: one Node function behind the platform's CDN, which serves the assets and reaches the function only\n * 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 silently undoes\n * streamed SSR.\n *\n * Only `dist/server` is uploaded with the function, which is why dependencies are bundled: see\n * {@link bundleDependencies}.\n */\nconst VERCEL_PRESET: DeployPreset = {\n  name: 'vercel',\n  runtimeModule: 'deploy/vercel/runtime.js',\n  deployHint: 'deploy with `vercel deploy --prebuilt`',\n  configureServer: bundleDependencies,\n  finalize: finalizeVercelBuild,\n};\n\n/**\n * AWS Lambda behind a Function URL in `RESPONSE_STREAM` mode — the AWS shape that keeps streaming. The\n * runtime wraps the app in `awslambda.streamifyResponse`; the buffered alternative would deploy fine and then\n * hold every page until its last byte rendered.\n *\n * The deployment package is `dist/` and nothing else, which is why dependencies are bundled: see\n * {@link bundleDependencies}.\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  configureServer: bundleDependencies,\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 `dist/`\n * from 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  /** The `deploy` field in `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 file,\n * which wins over the `node` default. Blank values are ignored at every level, so an unset-but-present\n * `RSHONO_DEPLOY=` in CI falls through rather than 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/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/deploy/vercel/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA6BxD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChF"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/deploy/vercel/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA0BxD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4ChF"}

package/dist/deploy/vercel/build.js

@@ -2,23 +2,20 @@ import { cpSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { rm } from 'node:fs/promises';
 import { join } from 'node:path';
 /**
- * The Build Output API v3 layout, which is what `vercel deploy --prebuilt` uploads verbatim. Producing
- * it directly means Vercel runs no build of its own — everything it needs already exists.
+ * The Build Output API v3 layout, which `vercel deploy --prebuilt` uploads verbatim — producing it directly
+ * means Vercel runs no build of its own.
  */
 const OUTPUT_DIR = join('.vercel', 'output');
 const FUNCTION_DIR = join('functions', 'index.func');
 /**
- * The function's own view of the build.
- *
- * `dist/server/main.mjs` is kept at that exact path inside the function because the runtime derives the
- * project root from where the bundle sits (see `deploy/filesystem.ts`) — so `dist/ssg` and `dist/public`
- * land where it already looks for them, and no runtime code needs to know it is on Vercel.
+ * The bundle keeps this exact path inside the function because the runtime derives the project root from where
+ * it sits (see `deploy/filesystem.ts`), so `dist/ssg` and `dist/public` land where it already looks — and no
+ * runtime code needs to know it is on Vercel.
  */
 const HANDLER = 'dist/server/main.mjs';
 /**
- * Routes, in the order Vercel evaluates them: hashed assets get the immutable header the CDN cannot
- * infer, then anything present in the static output is served from it, and whatever is left is the
- * app's to render.
+ * Routes, in the order Vercel evaluates them: hashed assets get the immutable header the CDN cannot infer,
+ * then anything in the static output is served from it, and whatever is left is the app's to render.
  */
 const ROUTES = [
     { src: '^/_static/(.*)$', headers: { 'cache-control': 'public, max-age=31536000, immutable' }, continue: true },
@@ -29,7 +26,7 @@ export async function finalizeVercelBuild(ctx) {
     const outputDir = join(ctx.rootDir, OUTPUT_DIR);
     const staticOut = join(outputDir, 'static');
     const functionDir = join(outputDir, FUNCTION_DIR);
-    // Rebuilt from scratch, so a deleted page or asset cannot survive in the uploaded output.
+    // From scratch, so a deleted page or asset cannot survive in the uploaded output.
     await rm(outputDir, { recursive: true, force: true });
     mkdirSync(staticOut, { recursive: true });
     mkdirSync(functionDir, { recursive: true });
@@ -37,17 +34,23 @@ export async function finalizeVercelBuild(ctx) {
     cpSync(ctx.staticDir, join(staticOut, '_static'), { recursive: true });
     if (ctx.publicDir)
         cpSync(ctx.publicDir, staticOut, { recursive: true });
-    // Shipped inside the function: the bundle, plus the two things it reads from disk at request time.
+    // Shipped inside the function: the bundle, and the one thing it reads from disk at request time.
+    //
+    // `public/` is deliberately *not* among them, though it is on the filesystem targets. It went into the
+    // static output above, and `{ handle: 'filesystem' }` sits ahead of the catch-all route, so the platform
+    // answers those paths before the function is invoked — a copy here is bytes uploaded and unpacked on every
+    // cold start that nothing can ever read. `vercel/runtime.ts` turns the matching mount off to say so.
     cpSync(join(ctx.distDir, 'server'), join(functionDir, 'dist', 'server'), { recursive: true });
     if (existsSync(ctx.ssgDir))
         cpSync(ctx.ssgDir, join(functionDir, 'dist', 'ssg'), { recursive: true });
-    if (ctx.publicDir)
-        cpSync(ctx.publicDir, join(functionDir, 'dist', 'public'), { recursive: true });
     writeFileSync(join(functionDir, '.vc-config.json'), `${JSON.stringify({
-        runtime: 'nodejs22.x',
+        // The Node the build ran on, so the function runs the runtime the app was tested against — and so
+        // this does not become a hard-coded version the platform retires on a date the framework does not
+        // control. A major Vercel does not offer is an explicit error from the deploy rather than a mismatch.
+        runtime: `nodejs${process.versions.node.split('.')[0]}.x`,
         handler: HANDLER,
         launcherType: 'Nodejs',
-        // Without this the platform buffers the whole response, which would undo streamed SSR.
+        // Without this the platform buffers the whole response, undoing streamed SSR.
         supportsResponseStreaming: true,
     }, null, 2)}\n`);
     writeFileSync(join(outputDir, 'config.json'), `${JSON.stringify({ version: 3, routes: ROUTES }, null, 2)}\n`);

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

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/deploy/vercel/build.ts"],"names":[],"mappings":"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","sourcesContent":["import { cpSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { DeployBuildContext } from '../presets.js';\n\n/**\n * The Build Output API v3 layout, which is what `vercel deploy --prebuilt` uploads verbatim. Producing\n * it directly means Vercel runs no build of its own — everything it needs already exists.\n */\nconst OUTPUT_DIR = join('.vercel', 'output');\nconst FUNCTION_DIR = join('functions', 'index.func');\n\n/**\n * The function's own view of the build.\n *\n * `dist/server/main.mjs` is kept at that exact path inside the function because the runtime derives the\n * project root from where the bundle sits (see `deploy/filesystem.ts`) — so `dist/ssg` and `dist/public`\n * land where it already looks for them, and no runtime code needs to know it is on Vercel.\n */\nconst HANDLER = 'dist/server/main.mjs';\n\n/**\n * Routes, in the order Vercel evaluates them: hashed assets get the immutable header the CDN cannot\n * infer, then anything present in the static output is served from it, and whatever is left is the\n * app's to render.\n */\nconst ROUTES = [\n  { src: '^/_static/(.*)$', headers: { 'cache-control': 'public, max-age=31536000, immutable' }, continue: true },\n  { handle: 'filesystem' },\n  { src: '/(.*)', dest: '/index' },\n];\n\nexport async function finalizeVercelBuild(ctx: DeployBuildContext): Promise<void> {\n  const outputDir = join(ctx.rootDir, OUTPUT_DIR);\n  const staticOut = join(outputDir, 'static');\n  const functionDir = join(outputDir, FUNCTION_DIR);\n\n  // Rebuilt from scratch, so a deleted page or asset cannot survive in the uploaded output.\n  await rm(outputDir, { recursive: true, force: true });\n  mkdirSync(staticOut, { recursive: true });\n  mkdirSync(functionDir, { recursive: true });\n\n  // Served by the CDN: the hashed bundle under its public path, and `public/` at the web root.\n  cpSync(ctx.staticDir, join(staticOut, '_static'), { recursive: true });\n  if (ctx.publicDir) cpSync(ctx.publicDir, staticOut, { recursive: true });\n\n  // Shipped inside the function: the bundle, plus the two things it reads from disk at request time.\n  cpSync(join(ctx.distDir, 'server'), join(functionDir, 'dist', 'server'), { recursive: true });\n  if (existsSync(ctx.ssgDir)) cpSync(ctx.ssgDir, join(functionDir, 'dist', 'ssg'), { recursive: true });\n  if (ctx.publicDir) cpSync(ctx.publicDir, join(functionDir, 'dist', 'public'), { recursive: true });\n\n  writeFileSync(\n    join(functionDir, '.vc-config.json'),\n    `${JSON.stringify(\n      {\n        runtime: 'nodejs22.x',\n        handler: HANDLER,\n        launcherType: 'Nodejs',\n        // Without this the platform buffers the whole response, which would undo streamed SSR.\n        supportsResponseStreaming: true,\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n\n  writeFileSync(join(outputDir, 'config.json'), `${JSON.stringify({ version: 3, routes: ROUTES }, null, 2)}\\n`);\n\n  console.log(`  • assembled ${OUTPUT_DIR} (Build Output API v3)`);\n}\n"]}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/deploy/vercel/build.ts"],"names":[],"mappings":"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","sourcesContent":["import { cpSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { DeployBuildContext } from '../presets.js';\n\n/**\n * The Build Output API v3 layout, which `vercel deploy --prebuilt` uploads verbatim — producing it directly\n * means Vercel runs no build of its own.\n */\nconst OUTPUT_DIR = join('.vercel', 'output');\nconst FUNCTION_DIR = join('functions', 'index.func');\n\n/**\n * The bundle keeps this exact path inside the function because the runtime derives the project root from where\n * it sits (see `deploy/filesystem.ts`), so `dist/ssg` and `dist/public` land where it already looks — and no\n * runtime code needs to know it is on Vercel.\n */\nconst HANDLER = 'dist/server/main.mjs';\n\n/**\n * Routes, in the order Vercel evaluates them: hashed assets get the immutable header the CDN cannot infer,\n * then anything in the static output is served from it, and whatever is left is the app's to render.\n */\nconst ROUTES = [\n  { src: '^/_static/(.*)$', headers: { 'cache-control': 'public, max-age=31536000, immutable' }, continue: true },\n  { handle: 'filesystem' },\n  { src: '/(.*)', dest: '/index' },\n];\n\nexport async function finalizeVercelBuild(ctx: DeployBuildContext): Promise<void> {\n  const outputDir = join(ctx.rootDir, OUTPUT_DIR);\n  const staticOut = join(outputDir, 'static');\n  const functionDir = join(outputDir, FUNCTION_DIR);\n\n  // From scratch, so a deleted page or asset cannot survive in the uploaded output.\n  await rm(outputDir, { recursive: true, force: true });\n  mkdirSync(staticOut, { recursive: true });\n  mkdirSync(functionDir, { recursive: true });\n\n  // Served by the CDN: the hashed bundle under its public path, and `public/` at the web root.\n  cpSync(ctx.staticDir, join(staticOut, '_static'), { recursive: true });\n  if (ctx.publicDir) cpSync(ctx.publicDir, staticOut, { recursive: true });\n\n  // Shipped inside the function: the bundle, and the one thing it reads from disk at request time.\n  //\n  // `public/` is deliberately *not* among them, though it is on the filesystem targets. It went into the\n  // static output above, and `{ handle: 'filesystem' }` sits ahead of the catch-all route, so the platform\n  // answers those paths before the function is invoked — a copy here is bytes uploaded and unpacked on every\n  // cold start that nothing can ever read. `vercel/runtime.ts` turns the matching mount off to say so.\n  cpSync(join(ctx.distDir, 'server'), join(functionDir, 'dist', 'server'), { recursive: true });\n  if (existsSync(ctx.ssgDir)) cpSync(ctx.ssgDir, join(functionDir, 'dist', 'ssg'), { recursive: true });\n\n  writeFileSync(\n    join(functionDir, '.vc-config.json'),\n    `${JSON.stringify(\n      {\n        // The Node the build ran on, so the function runs the runtime the app was tested against — and so\n        // this does not become a hard-coded version the platform retires on a date the framework does not\n        // control. A major Vercel does not offer is an explicit error from the deploy rather than a mismatch.\n        runtime: `nodejs${process.versions.node.split('.')[0]}.x`,\n        handler: HANDLER,\n        launcherType: 'Nodejs',\n        // Without this the platform buffers the whole response, undoing streamed SSR.\n        supportsResponseStreaming: true,\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n\n  writeFileSync(join(outputDir, 'config.json'), `${JSON.stringify({ version: 3, routes: ROUTES }, null, 2)}\\n`);\n\n  console.log(`  • assembled ${OUTPUT_DIR} (Build Output API v3)`);\n}\n"]}

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

@@ -2,13 +2,10 @@ import type { DeployRuntime } from '../contract.js';
 /**
  * Vercel, as a single Node function fed by the platform's own router.
  *
- * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler
- * ahead of the function — so the CDN answers them and the function is never invoked for an asset,
- * which is why mounting them here would only be dead weight.
- *
- * Prerendered pages are *not* static output: one URL answers with a document or a flight payload
- * depending on `Accept`, and a path-keyed CDN cannot choose. They ship inside the function instead and
- * are read from its read-only disk, exactly as on a server.
+ * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler ahead of the
+ * function, so mounting them here would be dead weight. Prerendered pages are *not* static output — one URL
+ * answers with a document or a flight payload on the `RSC` request header, and a path-keyed CDN cannot choose — so
+ * they ship inside the function and are read from its read-only disk, exactly as on a server.
  */
 export declare const runtime: DeployRuntime;
 //# sourceMappingURL=runtime.d.ts.map

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,aAUrB,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;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,aAoBrB,CAAC"}

package/dist/deploy/vercel/runtime.js

@@ -3,19 +3,25 @@ import { fileSystemRuntime } from '../filesystem.js';
 /**
  * Vercel, as a single Node function fed by the platform's own router.
  *
- * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler
- * ahead of the function — so the CDN answers them and the function is never invoked for an asset,
- * which is why mounting them here would only be dead weight.
- *
- * Prerendered pages are *not* static output: one URL answers with a document or a flight payload
- * depending on `Accept`, and a path-keyed CDN cannot choose. They ship inside the function instead and
- * are read from its read-only disk, exactly as on a server.
+ * `/_static` and `public/` are in the static output, and `config.json` puts the filesystem handler ahead of the
+ * function, so mounting them here would be dead weight. Prerendered pages are *not* static output — one URL
+ * answers with a document or a flight payload on the `RSC` request header, and a path-keyed CDN cannot choose — so
+ * they ship inside the function and are read from its read-only disk, exactly as on a server.
  */
 export const runtime = {
     ...fileSystemRuntime,
     mountStaticAssets() {
         // Served from `.vercel/output/static` before the function runs.
     },
+    mountPublicFallback() {
+        // As above: `public/` is in the static output and `{ handle: 'filesystem' }` is matched ahead of this
+        // function, so nothing here could ever answer for one of those paths. Stated as an override rather than
+        // left to fall out of `dist/public` not being uploaded, because that would make the behaviour incidental
+        // to a `cpSync` in `build.ts` instead of a decision.
+        //
+        // The one thing this hands to the platform: resolving a directory to its `index.html`. Vercel's static
+        // handler does that; `serveStatic`, which the filesystem targets use, is no longer in the path.
+    },
     serveApp(app) {
         return handle(app);
     },

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;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"]}
+{"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;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,GAAG,iBAAiB;IAEpB,iBAAiB;QACf,gEAAgE;IAClE,CAAC;IAED,mBAAmB;QACjB,sGAAsG;QACtG,wGAAwG;QACxG,yGAAyG;QACzG,qDAAqD;QACrD,EAAE;QACF,uGAAuG;QACvG,gGAAgG;IAClG,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 ahead of the\n * function, so mounting them here would be dead weight. Prerendered pages are *not* static output — one URL\n * answers with a document or a flight payload on the `RSC` request header, and a path-keyed CDN cannot choose — so\n * they ship inside the function and 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  mountPublicFallback(): void {\n    // As above: `public/` is in the static output and `{ handle: 'filesystem' }` is matched ahead of this\n    // function, so nothing here could ever answer for one of those paths. Stated as an override rather than\n    // left to fall out of `dist/public` not being uploaded, because that would make the behaviour incidental\n    // to a `cpSync` in `build.ts` instead of a decision.\n    //\n    // The one thing this hands to the platform: resolving a directory to its `index.html`. Vercel's static\n    // handler does that; `serveStatic`, which the filesystem targets use, is no longer in the path.\n  },\n\n  serveApp(app: Hono): unknown {\n    return handle(app);\n  },\n};\n"]}

package/dist/index.d.ts

@@ -1,14 +1,18 @@
 /**
- * `@rshono/core` — the build-time surface: route and config declaration plus the types
- * your pages and endpoints are written against. Everything here is safe to
- * import from server code; none of it pulls in runtime machinery.
+ * `@rshono/core` — the build-time surface: route and config declaration, plus the types
+ * your pages and endpoints are written against. Nothing here pulls in runtime machinery.
  *
- * The two companion entry points are runtime-only:
- * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside
- *   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`, `AsyncBoundary`, `CatchBoundary`).
+ * Two companion entry points are runtime-only:
+ * - `@rshono/core/server` — request context, `redirect`, `notFound`, `onServerError`.
+ * - `@rshono/core/client` — `useNavigation`, `AsyncBoundary`, `CatchBoundary`.
+ *
+ * @example
+ * ```ts
+ * // src/routes.ts
+ * import { defineRoutes } from '@rshono/core';
+ *
+ * export const routes = defineRoutes([{ path: '/', component: () => import('./components/home') }]);
+ * ```
  *
  * @see {@link https://www.rshono.com/docs/api | Docs — API reference}
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;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

@@ -1,14 +1,18 @@
 /**
- * `@rshono/core` — the build-time surface: route and config declaration plus the types
- * your pages and endpoints are written against. Everything here is safe to
- * import from server code; none of it pulls in runtime machinery.
+ * `@rshono/core` — the build-time surface: route and config declaration, plus the types
+ * your pages and endpoints are written against. Nothing here pulls in runtime machinery.
  *
- * The two companion entry points are runtime-only:
- * - `@rshono/core/server` — {@link https://hono.dev | Hono} request context inside
- *   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`, `AsyncBoundary`, `CatchBoundary`).
+ * Two companion entry points are runtime-only:
+ * - `@rshono/core/server` — request context, `redirect`, `notFound`, `onServerError`.
+ * - `@rshono/core/client` — `useNavigation`, `AsyncBoundary`, `CatchBoundary`.
+ *
+ * @example
+ * ```ts
+ * // src/routes.ts
+ * import { defineRoutes } from '@rshono/core';
+ *
+ * export const routes = defineRoutes([{ path: '/', component: () => import('./components/home') }]);
+ * ```
  *
  * @see {@link https://www.rshono.com/docs/api | Docs — API reference}
  *
@@ -16,7 +20,6 @@
  */
 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.
+// Hono's `Context` and `Handler` are deliberately not re-exported — `hono` is a peer dependency, so
+// endpoints import them from there rather than from 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;;;;;;;;;;;;;;;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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,YAAY,GAab,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAC;AAItF,oGAAoG;AACpG,oFAAoF","sourcesContent":["/**\n * `@rshono/core` — the build-time surface: route and config declaration, plus the types\n * your pages and endpoints are written against. Nothing here pulls in runtime machinery.\n *\n * Two companion entry points are runtime-only:\n * - `@rshono/core/server` — request context, `redirect`, `notFound`, `onServerError`.\n * - `@rshono/core/client` — `useNavigation`, `AsyncBoundary`, `CatchBoundary`.\n *\n * @example\n * ```ts\n * // src/routes.ts\n * import { defineRoutes } from '@rshono/core';\n *\n * export const routes = defineRoutes([{ path: '/', component: () => import('./components/home') }]);\n * ```\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, so\n// endpoints import them from there rather than from two spellings of the same type.\n"]}