@rshono/core 1.0.0-rc.0

package/dist/deploy/presets.d.ts

@@ -0,0 +1,88 @@
+import type { RspackOptions } from '@rspack/core';
+import type { DeployTarget } from './contract.js';
+/** What a preset's {@link DeployPreset.finalize} is told about the build it is arranging. */
+export interface DeployBuildContext {
+    /** The project root — where `rshono build` ran, and what a platform config file is written next to. */
+    rootDir: string;
+    /** `<root>/dist`. */
+    distDir: string;
+    /** The hashed client bundle, `<root>/dist/static` — served at `/_static`. */
+    staticDir: string;
+    /** The copy of the app's `public/`, or `null` when it has none. Served at the web root. */
+    publicDir: string | null;
+    /** Prerendered pages, `<root>/dist/ssg` — empty when the app has no `render: 'static'` routes. */
+    ssgDir: string;
+}
+/**
+ * The build-time half of a deploy target: which runtime module the bundle gets, how the server
+ * compiler has to change to produce something the platform can run, and how the output is arranged
+ * once it exists.
+ *
+ * The runtime half is {@link DeployRuntime}, in its own file because it is compiled *into* the app
+ * bundle — this side only ever runs in the CLI.
+ */
+export interface DeployPreset {
+    readonly name: DeployTarget;
+    /**
+     * The module `@rshono/deploy` resolves to, as a path relative to the framework's own `dist/`.
+     * Slash-separated and split on use, so it stays a valid path on Windows too.
+     */
+    readonly runtimeModule: string;
+    /** How to run what was just built, completing the "build complete —" line. */
+    readonly deployHint: string;
+    /**
+     * Extra resolve conditions for the server bundle, most specific first.
+     *
+     * This is what picks the right build of React and the RSC runtime: both ship one per runtime behind
+     * `workerd` / `deno` / `edge-light` / `node` conditions. Omit it to accept whatever the Rspack
+     * target implies, which is correct for Node.
+     */
+    readonly resolveConditions?: readonly string[];
+    /** browserslist-style targets for the server bundle's swc pass. Defaults to Node. */
+    readonly syntaxTargets?: readonly string[];
+    /**
+     * Adjusts the generated server Rspack config for this platform — target, externals policy, output
+     * shape. Mutates in place, and runs *before* the user's `rspack` hook so that hook keeps the last
+     * word.
+     */
+    configureServer?(config: RspackOptions): void;
+    /**
+     * Arranges the finished build for the platform: assembles whatever directory layout it expects,
+     * emits its config file, and prints how to deploy.
+     *
+     * Runs last — after both bundles, the `public/` copy and the prerender pass — so everything it
+     * needs to move is already on disk.
+     */
+    finalize?(ctx: DeployBuildContext): Promise<void> | void;
+}
+/**
+ * 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.
+ */
+export declare const NODE_PRESET: DeployPreset;
+/** Every target `deploy` accepts, for error messages and docs. */
+export declare const DEPLOY_TARGETS: DeployTarget[];
+/**
+ * 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.
+ */
+export declare function deployHintFor(target: string): string | null;
+/** Where a deploy target can be named, in precedence order. */
+export interface DeploySources {
+    /** The `--deploy` flag. */
+    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`. */
+    config?: string;
+}
+/**
+ * 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.
+ */
+export declare function resolveDeployPreset(sources?: DeploySources): DeployPreset;
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +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"}

package/dist/deploy/presets.js

@@ -0,0 +1,110 @@
+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.
+ */
+export const NODE_PRESET = {
+    name: 'node',
+    runtimeModule: 'deploy/node/runtime.js',
+    deployHint: 'run `rshono start`',
+};
+/**
+ * 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.
+ */
+const CLOUDFLARE_PRESET = {
+    name: 'cloudflare',
+    runtimeModule: 'deploy/cloudflare/runtime.js',
+    deployHint: 'deploy with `wrangler deploy`',
+    resolveConditions: ['workerd'],
+    syntaxTargets: ['chrome 120'],
+    configureServer(config) {
+        config.target = 'webworker';
+        config.externalsType = 'module-import';
+        config.externals = [/^(?:node|cloudflare):/];
+        config.output = { ...config.output, asyncChunks: false };
+    },
+    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.
+ */
+const VERCEL_PRESET = {
+    name: 'vercel',
+    runtimeModule: 'deploy/vercel/runtime.js',
+    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. */
+const AWS_LAMBDA_PRESET = {
+    name: 'aws-lambda',
+    runtimeModule: 'deploy/aws-lambda/runtime.js',
+    deployHint: 'zip dist/ with the handler at dist/server/main.mjs',
+};
+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. */
+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.
+ */
+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.
+ */
+export function resolveDeployPreset(sources = {}) {
+    const target = sources.flag?.trim() || sources.env?.trim() || sources.config?.trim();
+    if (!target)
+        return NODE_PRESET;
+    const preset = PRESETS[target];
+    if (!preset) {
+        throw new Error(`[rshono] unknown deploy target ${JSON.stringify(target)} — expected one of: ${DEPLOY_TARGETS.join(', ')}.`);
+    }
+    return preset;
+}
+//# sourceMappingURL=presets.js.map

package/dist/deploy/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/deploy/presets.ts"],"names":[],"mappings":"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","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"]}

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

@@ -0,0 +1,3 @@
+import type { DeployBuildContext } from '../presets.js';
+export declare function finalizeVercelBuild(ctx: DeployBuildContext): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +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"}

package/dist/deploy/vercel/build.js

@@ -0,0 +1,56 @@
+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.
+ */
+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.
+ */
+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.
+ */
+const ROUTES = [
+    { src: '^/_static/(.*)$', headers: { 'cache-control': 'public, max-age=31536000, immutable' }, continue: true },
+    { handle: 'filesystem' },
+    { src: '/(.*)', dest: '/index' },
+];
+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.
+    await rm(outputDir, { recursive: true, force: true });
+    mkdirSync(staticOut, { recursive: true });
+    mkdirSync(functionDir, { recursive: true });
+    // Served by the CDN: the hashed bundle under its public path, and `public/` at the web root.
+    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.
+    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',
+        handler: HANDLER,
+        launcherType: 'Nodejs',
+        // Without this the platform buffers the whole response, which would undo streamed SSR.
+        supportsResponseStreaming: true,
+    }, null, 2)}\n`);
+    writeFileSync(join(outputDir, 'config.json'), `${JSON.stringify({ version: 3, routes: ROUTES }, null, 2)}\n`);
+    console.log(`  • assembled ${OUTPUT_DIR} (Build Output API v3)`);
+}
+//# sourceMappingURL=build.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,14 @@
+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.
+ */
+export declare const runtime: DeployRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +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"}

package/dist/deploy/vercel/runtime.js

@@ -0,0 +1,26 @@
+import { handle } from 'hono/vercel';
+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.
+ */
+export const runtime = {
+    ...fileSystemRuntime,
+    mountStaticAssets() {
+        // Served from `.vercel/output/static` before the function runs.
+    },
+    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

@@ -0,0 +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"]}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `@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.
+ *
+ * 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
+ *   `onServerError` for reporting the errors the framework catches.
+ * - `@rshono/core/client` — hooks and components for `'use client'` modules
+ *   (`useNavigation`, `Boundary`, `ErrorBoundary`, `NavigationProgress`).
+ *
+ * @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 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

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@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.
+ *
+ * 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
+ *   `onServerError` for reporting the errors the framework catches.
+ * - `@rshono/core/client` — hooks and components for `'use client'` modules
+ *   (`useNavigation`, `Boundary`, `ErrorBoundary`, `NavigationProgress`).
+ *
+ * @packageDocumentation
+ */
+export { defineRoutes, isPageRoute, } from './router.js';
+export { defineConfig } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}