@rangojs/router 0.19.1 → 0.21.0

package/dist/vite/index.js

@@ -22,26 +22,26 @@ function createRangoDebugger(namespace) {
   if (shadow.enabled) return shadow;
   return void 0;
 }
-async function timed(debug13, label, fn) {
-  if (!debug13) return await fn();
+async function timed(debug14, label, fn) {
+  if (!debug14) return await fn();
   const start = performance.now();
   try {
     return await fn();
   } finally {
-    debug13("%s (%sms)", label, (performance.now() - start).toFixed(1));
+    debug14("%s (%sms)", label, (performance.now() - start).toFixed(1));
   }
 }
-function timedSync(debug13, label, fn) {
-  if (!debug13) return fn();
+function timedSync(debug14, label, fn) {
+  if (!debug14) return fn();
   const start = performance.now();
   try {
     return fn();
   } finally {
-    debug13("%s (%sms)", label, (performance.now() - start).toFixed(1));
+    debug14("%s (%sms)", label, (performance.now() - start).toFixed(1));
   }
 }
-function createCounter(debug13, label) {
-  if (!debug13) return void 0;
+function createCounter(debug14, label) {
+  if (!debug14) return void 0;
   let n = 0;
   let totalMs = 0;
   let slowestMs = 0;
@@ -75,7 +75,7 @@ function createCounter(debug13, label) {
     },
     flush() {
       if (n === 0) return;
-      debug13(
+      debug14(
         "%s: %d files, %sms total, slowest %sms %s",
         label,
         n,
@@ -119,7 +119,7 @@ __export(client_ref_hashing_exports, {
   hashRefKey: () => hashRefKey,
   transformClientRefs: () => transformClientRefs
 });
-import { relative as relative3 } from "node:path";
+import { relative as relative2 } from "node:path";
 import { createHash as createHash2 } from "node:crypto";
 function hashRefKey(relativeId) {
   return createHash2("sha256").update(relativeId).digest("hex").slice(0, 12);
@@ -132,10 +132,10 @@ function computeProductionHash(projectRoot, refKey) {
     const absPath = decodeURIComponent(
       refKey.slice(CLIENT_IN_SERVER_PKG_PROXY_PREFIX.length)
     );
-    toHash = relative3(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative2(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith(FS_PREFIX)) {
     const absPath = refKey.slice(FS_PREFIX.length - 1);
-    toHash = relative3(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative2(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith("/")) {
     toHash = refKey.slice(1);
   } else {
@@ -158,7 +158,7 @@ function transformClientRefs(code, projectRoot) {
   return hasReplacement ? result : null;
 }
 function hashClientRefs(projectRoot) {
-  const counter = createCounter(debug6, "hash-client-refs");
+  const counter = createCounter(debug5, "hash-client-refs");
   return {
     name: "@rangojs/router:hash-client-refs",
     enforce: "post",
@@ -180,12 +180,12 @@ function hashClientRefs(projectRoot) {
     }
   };
 }
-var debug6, CLIENT_PKG_PROXY_PREFIX, CLIENT_IN_SERVER_PKG_PROXY_PREFIX, FS_PREFIX, REGISTER_CLIENT_REF_RE;
+var debug5, CLIENT_PKG_PROXY_PREFIX, CLIENT_IN_SERVER_PKG_PROXY_PREFIX, FS_PREFIX, REGISTER_CLIENT_REF_RE;
 var init_client_ref_hashing = __esm({
   "src/vite/plugins/client-ref-hashing.ts"() {
     "use strict";
     init_debug();
-    debug6 = createRangoDebugger(NS.transform);
+    debug5 = createRangoDebugger(NS.transform);
     CLIENT_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-package-proxy/";
     CLIENT_IN_SERVER_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-in-server-package-proxy/";
     FS_PREFIX = "/@fs/";
@@ -492,12 +492,12 @@ function waitForViewportImages() {
     return rect.bottom > 0 && rect.right > 0 && rect.top < window.innerHeight && rect.left < window.innerWidth;
   });
   if (pending.length === 0) return Promise.resolve();
-  return new Promise((resolve14) => {
+  return new Promise((resolve15) => {
     const settled = /* @__PURE__ */ new Set();
     const settle = (img) => {
       if (settled.has(img)) return;
       settled.add(img);
-      if (settled.size >= pending.length) resolve14();
+      if (settled.size >= pending.length) resolve15();
     };
     for (const img of pending) {
       img.addEventListener("load", () => settle(img), { once: true });
@@ -507,16 +507,16 @@ function waitForViewportImages() {
   });
 }
 function wait(ms) {
-  return new Promise((resolve14) => setTimeout(resolve14, ms));
+  return new Promise((resolve15) => setTimeout(resolve15, ms));
 }
 function waitForIdle(timeout = 200) {
   if (typeof window !== "undefined" && "requestIdleCallback" in window) {
-    return new Promise((resolve14) => {
-      window.requestIdleCallback(() => resolve14(), { timeout });
+    return new Promise((resolve15) => {
+      window.requestIdleCallback(() => resolve15(), { timeout });
     });
   }
-  return new Promise((resolve14) => {
-    setTimeout(resolve14, 0);
+  return new Promise((resolve15) => {
+    setTimeout(resolve15, 0);
   });
 }
 var init_resource_ready = __esm({
@@ -766,7 +766,7 @@ function isSamePage(url) {
     return false;
   }
 }
-function buildPrefetchUrl(url, segmentIds, version, routerId) {
+function buildPrefetchUrl(url, segmentIds, version, routerId2) {
   let targetUrl;
   try {
     targetUrl = new URL(url, window.location.origin);
@@ -783,8 +783,8 @@ function buildPrefetchUrl(url, segmentIds, version, routerId) {
   if (version) {
     targetUrl.searchParams.set("_rsc_v", version);
   }
-  if (routerId) {
-    targetUrl.searchParams.set("_rsc_rid", routerId);
+  if (routerId2) {
+    targetUrl.searchParams.set("_rsc_rid", routerId2);
   }
   return targetUrl;
 }
@@ -843,8 +843,8 @@ function executePrefetchFetch(wildcardKey, sourceKey, fetchUrl, forceSourceScope
     const storageKey = scope === "source" ? sourceKey : wildcardKey;
     let resolveStreamComplete;
     let endedCleanly = false;
-    const streamComplete = new Promise((resolve14) => {
-      resolveStreamComplete = resolve14;
+    const streamComplete = new Promise((resolve15) => {
+      resolveStreamComplete = resolve15;
     });
     const tracked = teeWithCompletion(
       response,
@@ -908,9 +908,9 @@ function executePrefetchFetch(wildcardKey, sourceKey, fetchUrl, forceSourceScope
 function hasPrefetchHit(forceSourceScope, wildcardKey, sourceKey) {
   return forceSourceScope ? hasPrefetch(sourceKey) : hasPrefetch(wildcardKey) || hasPrefetch(sourceKey);
 }
-function prefetchDirect(url, segmentIds, version, routerId, prefetchKey) {
+function prefetchDirect(url, segmentIds, version, routerId2, prefetchKey) {
   if (!shouldPrefetch()) return;
-  const targetUrl = buildPrefetchUrl(url, segmentIds, version, routerId);
+  const targetUrl = buildPrefetchUrl(url, segmentIds, version, routerId2);
   if (!targetUrl) return;
   const forceSourceScope = prefetchKey === ":source";
   if (!forceSourceScope && isSamePage(url)) {
@@ -946,12 +946,12 @@ function prefetchDirect(url, segmentIds, version, routerId, prefetchKey) {
     targetUrl.toString(),
     forceSourceScope,
     rangoState,
-    routerId
+    routerId2
   );
 }
-function prefetchQueued(url, segmentIds, version, routerId, prefetchKey) {
+function prefetchQueued(url, segmentIds, version, routerId2, prefetchKey) {
   if (!shouldPrefetch()) return "";
-  const targetUrl = buildPrefetchUrl(url, segmentIds, version, routerId);
+  const targetUrl = buildPrefetchUrl(url, segmentIds, version, routerId2);
   if (!targetUrl) return "";
   const forceSourceScope = prefetchKey === ":source";
   if (!forceSourceScope && isSamePage(url)) {
@@ -987,7 +987,7 @@ function prefetchQueued(url, segmentIds, version, routerId, prefetchKey) {
       fetchUrlStr,
       forceSourceScope,
       rangoState,
-      routerId,
+      routerId2,
       signal
     ).then(() => {
     });
@@ -1061,14 +1061,14 @@ function withRuntime(run) {
   }).catch(() => {
   });
 }
-function prefetchDirect2(url, segmentIds, version, routerId, prefetchKey) {
+function prefetchDirect2(url, segmentIds, version, routerId2, prefetchKey) {
   withRuntime(
-    (loaded) => loaded.prefetchDirect(url, segmentIds, version, routerId, prefetchKey)
+    (loaded) => loaded.prefetchDirect(url, segmentIds, version, routerId2, prefetchKey)
   );
 }
-function prefetchQueued2(url, segmentIds, version, routerId, prefetchKey) {
+function prefetchQueued2(url, segmentIds, version, routerId2, prefetchKey) {
   withRuntime(
-    (loaded) => loaded.prefetchQueued(url, segmentIds, version, routerId, prefetchKey)
+    (loaded) => loaded.prefetchQueued(url, segmentIds, version, routerId2, prefetchKey)
   );
 }
 function schedulePrefetchWhenRouterIdle(eventController, callback) {
@@ -1098,8 +1098,8 @@ var init_loader = __esm({
 });
 
 // src/vite/rango.ts
-import { readFileSync as readFileSync10, existsSync as existsSync11 } from "node:fs";
-import { resolve as resolve13 } from "node:path";
+import { readFileSync as readFileSync12, existsSync as existsSync13 } from "node:fs";
+import { resolve as resolve14 } from "node:path";
 
 // src/vite/plugins/expose-action-id.ts
 import { getPluginApi } from "@vitejs/plugin-rsc";
@@ -1569,10 +1569,56 @@ function exposeActionId() {
 
 // src/vite/encryption-key.ts
 import { randomBytes } from "node:crypto";
-var cachedKey;
+var AES_KEY_BYTES = /* @__PURE__ */ new Set([16, 24, 32]);
+var EXPECTED = "a base64-encoded AES key of 16, 24 or 32 bytes (openssl rand -base64 32)";
+var resolvedKey;
+function assertValidEncryptionKey(value, source) {
+  if (typeof value !== "string") {
+    throw new Error(
+      `[rango] ${source} must be a string, received ${typeof value}. Expected ${EXPECTED}.`
+    );
+  }
+  if (value === "") {
+    throw new Error(
+      `[rango] ${source} is an empty string. Unset it to generate a key per build, or set it to ${EXPECTED}.`
+    );
+  }
+  const bytes = /^[A-Za-z0-9+/]+={0,2}$/.test(value) ? Buffer.from(value, "base64") : void 0;
+  if (!bytes || bytes.toString("base64").replace(/=+$/, "") !== value.replace(/=+$/, "")) {
+    throw new Error(
+      `[rango] ${source} is not valid base64. Expected ${EXPECTED}.`
+    );
+  }
+  if (!AES_KEY_BYTES.has(bytes.length)) {
+    throw new Error(
+      `[rango] ${source} decodes to ${bytes.length} bytes. Expected ${EXPECTED}.`
+    );
+  }
+}
+function configureEncryptionKey(option) {
+  if (option !== void 0) {
+    assertValidEncryptionKey(option, "rango({ encryptionKey })");
+    resolvedKey = { key: option, stable: true };
+    return;
+  }
+  const fromEnv = process.env.RANGO_ENCRYPTION_KEY;
+  if (fromEnv !== void 0) {
+    assertValidEncryptionKey(fromEnv, "RANGO_ENCRYPTION_KEY");
+    resolvedKey = { key: fromEnv, stable: true };
+    return;
+  }
+  if (resolvedKey && !resolvedKey.stable) return;
+  resolvedKey = { key: randomBytes(32).toString("base64"), stable: false };
+}
+function resolved() {
+  if (!resolvedKey) configureEncryptionKey(void 0);
+  return resolvedKey;
+}
 function buildEncryptionKey() {
-  cachedKey ??= process.env.RANGO_ENCRYPTION_KEY ?? randomBytes(32).toString("base64");
-  return cachedKey;
+  return resolved().key;
+}
+function isEncryptionKeyStable() {
+  return resolved().stable;
 }
 function defineEncryptionKeyExpr() {
   return JSON.stringify(buildEncryptionKey());
@@ -1587,10 +1633,10 @@ import path4 from "node:path";
 function isDirectivePrologueStatement(node) {
   return node?.type === "ExpressionStatement" && typeof node.directive === "string";
 }
-function findImportInsertionPos(code, parseAst7) {
+function findImportInsertionPos(code, parseAst8) {
   let program;
   try {
-    program = parseAst7(code, { lang: "tsx" });
+    program = parseAst8(code, { lang: "tsx" });
   } catch {
     return 0;
   }
@@ -1627,10 +1673,10 @@ function walkNode(node, parent, ancestors, enter) {
   }
   ancestors.pop();
 }
-function findHandlerCalls(code, fnName, parseAst7) {
+function findHandlerCalls(code, fnName, parseAst8) {
   let program;
   try {
-    program = parseAst7(code, { lang: "tsx" });
+    program = parseAst8(code, { lang: "tsx" });
   } catch {
     return [];
   }
@@ -1702,18 +1748,18 @@ function getImportedLocalNamesFromProgram(program, importedName) {
   }
   return localNames;
 }
-function getImportedLocalNames(code, importedName, parseAst7) {
+function getImportedLocalNames(code, importedName, parseAst8) {
   try {
-    const program = parseAst7(code, { lang: "tsx" });
+    const program = parseAst8(code, { lang: "tsx" });
     return getImportedLocalNamesFromProgram(program, importedName);
   } catch {
     return /* @__PURE__ */ new Set();
   }
 }
-function extractImportDeclarations(code, parseAst7) {
+function extractImportDeclarations(code, parseAst8) {
   let program;
   try {
-    program = parseAst7(code, { lang: "tsx" });
+    program = parseAst8(code, { lang: "tsx" });
   } catch {
     return [];
   }
@@ -1770,10 +1816,10 @@ function isSafeVariableDeclaration(node, handlerNames) {
     (d) => isSafeDeclaratorInit(d.init) && !(d.init?.type === "CallExpression" && d.init.callee?.type === "Identifier" && handlerNames.has(d.init.callee.name))
   );
 }
-function extractModuleLevelDeclarations(code, parseAst7, handlerNames) {
+function extractModuleLevelDeclarations(code, parseAst8, handlerNames) {
   let program;
   try {
-    program = parseAst7(code, { lang: "tsx" });
+    program = parseAst8(code, { lang: "tsx" });
   } catch {
     return [];
   }
@@ -1804,17 +1850,17 @@ function extractModuleLevelDeclarations(code, parseAst7, handlerNames) {
   }
   return declarations;
 }
-function transformInlineHandlers(fnName, virtualPrefix, s, code, filePath, virtualRegistry, moduleId, parseAst7) {
-  const sites = findHandlerCalls(code, fnName, parseAst7);
+function transformInlineHandlers(fnName, virtualPrefix, s, code, filePath, virtualRegistry, moduleId, parseAst8) {
+  const sites = findHandlerCalls(code, fnName, parseAst8);
   const inlineSites = sites.filter((site) => site.exportInfo === null);
   if (inlineSites.length === 0) return false;
-  const imports = extractImportDeclarations(code, parseAst7);
-  const staticNames = getImportedLocalNames(code, "Static", parseAst7);
-  const prerenderNames = getImportedLocalNames(code, "Prerender", parseAst7);
+  const imports = extractImportDeclarations(code, parseAst8);
+  const staticNames = getImportedLocalNames(code, "Static", parseAst8);
+  const prerenderNames = getImportedLocalNames(code, "Prerender", parseAst8);
   const handlerNames = /* @__PURE__ */ new Set([...staticNames, ...prerenderNames]);
   const declarations = extractModuleLevelDeclarations(
     code,
-    parseAst7,
+    parseAst8,
     handlerNames
   );
   const importStatements = [];
@@ -1837,7 +1883,7 @@ function transformInlineHandlers(fnName, virtualPrefix, s, code, filePath, virtu
   }
   if (importStatements.length > 0) {
     const importBlock = importStatements.join("\n") + "\n";
-    const insertionPos = findImportInsertionPos(code, parseAst7);
+    const insertionPos = findImportInsertionPos(code, parseAst8);
     if (insertionPos === 0) {
       s.prepend(importBlock);
     } else {
@@ -2379,6 +2425,57 @@ ${binding.localName}.$$id = "${handlerId}";`;
 // src/vite/plugins/expose-internal-ids.ts
 init_debug();
 
+// src/vite/utils/compare-strings.ts
+function compareStrings(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+
+// src/vite/discovery/state.ts
+var VIRTUAL_ROUTES_MANIFEST_ID = "virtual:rsc-router/routes-manifest";
+var VIRTUAL_LOADER_MANIFEST_ID = "virtual:rsc-router/loader-manifest";
+function createDiscoveryState(entryPath, opts) {
+  return {
+    resolvedEntryPath: entryPath,
+    projectRoot: "",
+    isBuildMode: false,
+    userResolveAlias: void 0,
+    userRunnerConfig: void 0,
+    userResolvePlugins: [],
+    scanFilter: void 0,
+    cachedRouterFiles: void 0,
+    opts,
+    mergedRouteManifest: null,
+    perRouterManifests: [],
+    perRouterTrieMap: /* @__PURE__ */ new Map(),
+    perRouterPrecomputedMap: /* @__PURE__ */ new Map(),
+    perRouterManifestDataMap: /* @__PURE__ */ new Map(),
+    clientUrlSourceByReferenceId: /* @__PURE__ */ new Map(),
+    clientUrlProjectionMap: /* @__PURE__ */ new Map(),
+    prerenderManifestEntries: null,
+    staticManifestEntries: null,
+    shellCandidates: null,
+    prerenderPayloadValues: null,
+    shellPhaseTempServer: null,
+    serverBuildGraph: null,
+    clientBuildGraph: null,
+    ssrBundle: null,
+    versionModuleFiles: /* @__PURE__ */ new Map(),
+    buildData: [],
+    handlerChunkInfoMap: /* @__PURE__ */ new Map(),
+    staticHandlerChunkInfoMap: /* @__PURE__ */ new Map(),
+    rscEntryFileName: null,
+    resolvedPrerenderModules: void 0,
+    resolvedStaticModules: void 0,
+    discoveryDone: null,
+    devDiscoveryEpoch: opts?.preset === "cloudflare" ? Date.now() : void 0,
+    devServerOrigin: null,
+    devServer: null,
+    selfWrittenGenFiles: /* @__PURE__ */ new Map(),
+    SELF_WRITE_WINDOW_MS: 5e3,
+    lastDiscoveryError: null
+  };
+}
+
 // src/vite/plugins/expose-ids/router-transform.ts
 import MagicString2 from "magic-string";
 import path3 from "node:path";
@@ -2401,15 +2498,16 @@ function skipLeadingTrivia(code, start, end) {
   }
   return i;
 }
+function routerId(filePath, callIndex) {
+  return createHash("sha256").update(`${filePath}#${callIndex}`).digest("hex").slice(0, 8);
+}
 function transformRouter(code, filePath, routerFnNames, absolutePath, warn) {
-  const pat = new RegExp(
-    `\\b(?:${routerFnNames.map(escapeRegExp).join("|")})\\b`,
-    "g"
-  );
+  const pat = createCallPattern(routerFnNames);
   let match;
   const s = new MagicString2(code);
   let changed = false;
   const unsupportedSites = [];
+  let callIndex = -1;
   const basename2 = path3.basename(filePath).replace(/\.(tsx?|jsx?)$/, "");
   const routeNamesImport = `./${basename2}.named-routes.gen.js`;
   const routeNamesVar = `__rsc_rn`;
@@ -2421,13 +2519,12 @@ function transformRouter(code, filePath, routerFnNames, absolutePath, warn) {
     const calleeEnd = match.index + match[0].length;
     const parenPos = findCallParenAfterGenerics(code, calleeEnd);
     if (parenPos === -1) continue;
+    callIndex++;
     const closeParen = findMatchingParen(code, parenPos + 1);
     const callArgs = code.slice(parenPos + 1, closeParen);
     if (callArgs.includes(`$$routeNames: ${routeNamesVar}`)) continue;
     const sourceFilePath = absolutePath ?? filePath;
-    const lineNumber = code.slice(0, callStart).split("\n").length;
-    const hash = createHash("sha256").update(`${filePath}:${lineNumber}`).digest("hex").slice(0, 8);
-    const injected = ` $$id: "${hash}", $$sourceFile: "${sourceFilePath}", $$routeNames: ${routeNamesVar},`;
+    const injected = ` $$id: "${routerId(filePath, callIndex)}", $$sourceFile: "${sourceFilePath}", $$routeNames: ${routeNamesVar},`;
     const argsContentStart = skipLeadingTrivia(code, parenPos + 1, closeParen);
     const firstArgChar = code[argsContentStart];
     if (firstArgChar === "{") {
@@ -2437,9 +2534,7 @@ function transformRouter(code, filePath, routerFnNames, absolutePath, warn) {
       changed = true;
       s.appendRight(parenPos + 1, `{${injected} }`);
     } else {
-      const lastNl = code.lastIndexOf("\n", callStart - 1);
-      const column = callStart - (lastNl + 1) + 1;
-      unsupportedSites.push({ line: lineNumber, column });
+      unsupportedSites.push(offsetToLineColumn(code, callStart));
     }
   }
   if (unsupportedSites.length > 0 && warn) {
@@ -2459,11 +2554,13 @@ function transformRouter(code, filePath, routerFnNames, absolutePath, warn) {
 }
 function exposeRouterId() {
   let projectRoot = "";
+  let rootRelativeSourceFile = false;
   const counter = createCounter(debug2, "expose-router-id");
   return {
     name: "@rangojs/router:expose-router-id",
     configResolved(config) {
       projectRoot = config.root;
+      rootRelativeSourceFile = config.command === "build";
     },
     buildEnd() {
       counter?.flush();
@@ -2485,7 +2582,7 @@ function exposeRouterId() {
           code,
           filePath,
           routerFnNames,
-          normalizePath(id),
+          rootRelativeSourceFile ? void 0 : normalizePath(id),
           warn
         );
       } finally {
@@ -2497,7 +2594,7 @@ function exposeRouterId() {
 
 // src/vite/plugins/expose-internal-ids.ts
 var debug3 = createRangoDebugger(NS.transform);
-var VIRTUAL_LOADER_MANIFEST = "virtual:rsc-router/loader-manifest";
+var VIRTUAL_LOADER_MANIFEST = VIRTUAL_LOADER_MANIFEST_ID;
 var RESOLVED_VIRTUAL_LOADER_MANIFEST = "\0" + VIRTUAL_LOADER_MANIFEST;
 var VIRTUAL_HANDLER_PREFIX = "virtual:handler-extract:";
 function createLoaderScanStubPlugin() {
@@ -2568,8 +2665,8 @@ function exposeInternalIds(options) {
       prerenderHandlerModules,
       staticHandlerModules
     },
-    configResolved(resolved) {
-      config = resolved;
+    configResolved(resolved2) {
+      config = resolved2;
       isBuild = options?.forceBuild || config.command === "build";
       projectRoot = config.root;
     },
@@ -2607,7 +2704,10 @@ setLoaderImports({});
 `;
       }
       const lazyImports = [];
-      for (const [hashedId, { filePath, exportName }] of loaderRegistry) {
+      const sortedLoaders = [...loaderRegistry].sort(
+        ([a], [b]) => compareStrings(a, b)
+      );
+      for (const [hashedId, { filePath, exportName }] of sortedLoaders) {
         lazyImports.push(
           `  "${hashedId}": () => import("/${filePath}").then(m => m.${exportName})`
         );
@@ -3103,8 +3203,8 @@ async function transformUseCache(code, id, options) {
   const { hasDirective: hasDirective2, transformWrapExport, transformHoistInlineDirective } = rscTransforms;
   let ast;
   try {
-    const { parseAst: parseAst7 } = await import("vite");
-    ast = parseAst7(code, { lang: "tsx" });
+    const { parseAst: parseAst8 } = await import("vite");
+    ast = parseAst8(code, { lang: "tsx" });
   } catch {
     return;
   }
@@ -3395,37 +3495,37 @@ function analyzeScopes(program) {
     if (!pattern) return;
     switch (pattern.type) {
       case "Identifier":
-        if (pattern.typeAnnotation) walk2(pattern.typeAnnotation, scope, true);
+        if (pattern.typeAnnotation) walk3(pattern.typeAnnotation, scope, true);
         return;
       case "ObjectPattern":
         for (const prop of pattern.properties) {
           if (prop.type === "RestElement") {
             walkPattern(prop.argument, scope, typeOnly);
           } else {
-            if (prop.computed) walk2(prop.key, scope, typeOnly);
+            if (prop.computed) walk3(prop.key, scope, typeOnly);
             walkPattern(prop.value, scope, typeOnly);
           }
         }
-        if (pattern.typeAnnotation) walk2(pattern.typeAnnotation, scope, true);
+        if (pattern.typeAnnotation) walk3(pattern.typeAnnotation, scope, true);
         return;
       case "ArrayPattern":
         for (const element of pattern.elements) {
           walkPattern(element, scope, typeOnly);
         }
-        if (pattern.typeAnnotation) walk2(pattern.typeAnnotation, scope, true);
+        if (pattern.typeAnnotation) walk3(pattern.typeAnnotation, scope, true);
         return;
       case "RestElement":
         walkPattern(pattern.argument, scope, typeOnly);
         return;
       case "AssignmentPattern":
         walkPattern(pattern.left, scope, typeOnly);
-        walk2(pattern.right, scope, typeOnly);
+        walk3(pattern.right, scope, typeOnly);
         return;
       case "TSParameterProperty":
         walkPattern(pattern.parameter, scope, typeOnly);
         return;
       default:
-        walk2(pattern, scope, typeOnly);
+        walk3(pattern, scope, typeOnly);
     }
   };
   const hoistDeclarations = (statements, scope) => {
@@ -3459,44 +3559,44 @@ function analyzeScopes(program) {
       }
     }
   };
-  const walk2 = (node, scope, typeOnly) => {
+  const walk3 = (node, scope, typeOnly) => {
     if (!node || typeof node !== "object") return;
     if (Array.isArray(node)) {
-      for (const item of node) walk2(item, scope, typeOnly);
+      for (const item of node) walk3(item, scope, typeOnly);
       return;
     }
     if (typeof node.type !== "string") return;
     switch (node.type) {
       case "Identifier":
         references.push({ node, scope, typeOnly });
-        if (node.typeAnnotation) walk2(node.typeAnnotation, scope, true);
+        if (node.typeAnnotation) walk3(node.typeAnnotation, scope, true);
         return;
       case "ImportDeclaration":
       case "ExportAllDeclaration":
         return;
       case "ExportNamedDeclaration":
-        if (node.declaration) walk2(node.declaration, scope, typeOnly);
+        if (node.declaration) walk3(node.declaration, scope, typeOnly);
         else if (!node.source) {
           for (const spec of node.specifiers) {
-            walk2(spec.local, scope, typeOnly || node.exportKind === "type");
+            walk3(spec.local, scope, typeOnly || node.exportKind === "type");
           }
         }
         return;
       case "MemberExpression":
-        walk2(node.object, scope, typeOnly);
-        if (node.computed) walk2(node.property, scope, typeOnly);
+        walk3(node.object, scope, typeOnly);
+        if (node.computed) walk3(node.property, scope, typeOnly);
         return;
       case "Property":
       case "MethodDefinition":
       case "PropertyDefinition":
       case "TSPropertySignature":
       case "TSMethodSignature":
-        if (node.computed) walk2(node.key, scope, typeOnly);
-        walk2(node.value, scope, typeOnly);
-        if (node.typeAnnotation) walk2(node.typeAnnotation, scope, true);
+        if (node.computed) walk3(node.key, scope, typeOnly);
+        walk3(node.value, scope, typeOnly);
+        if (node.typeAnnotation) walk3(node.typeAnnotation, scope, true);
         return;
       case "LabeledStatement":
-        walk2(node.body, scope, typeOnly);
+        walk3(node.body, scope, typeOnly);
         return;
       case "BreakStatement":
       case "ContinueStatement":
@@ -3506,25 +3606,25 @@ function analyzeScopes(program) {
       case "JSXClosingElement": {
         const ref = jsxNameReference(node.name);
         if (ref) references.push({ node: ref, scope, typeOnly });
-        walk2(node.typeArguments, scope, true);
-        walk2(node.attributes, scope, typeOnly);
+        walk3(node.typeArguments, scope, true);
+        walk3(node.attributes, scope, typeOnly);
         return;
       }
       case "TSQualifiedName":
-        walk2(node.left, scope, typeOnly);
+        walk3(node.left, scope, typeOnly);
         return;
       case "TSEnumMember":
-        walk2(node.initializer, scope, typeOnly);
+        walk3(node.initializer, scope, typeOnly);
         return;
       case "TSTypeAliasDeclaration":
       case "TSInterfaceDeclaration":
-        walk2(node.typeParameters, scope, true);
-        walk2(node.typeAnnotation ?? node.body, scope, true);
-        walk2(node.extends, scope, true);
+        walk3(node.typeParameters, scope, true);
+        walk3(node.typeAnnotation ?? node.body, scope, true);
+        walk3(node.extends, scope, true);
         return;
       case "VariableDeclarator":
         walkPattern(node.id, scope, typeOnly);
-        walk2(node.init, scope, typeOnly);
+        walk3(node.init, scope, typeOnly);
         return;
       case "FunctionDeclaration":
       case "FunctionExpression":
@@ -3535,14 +3635,14 @@ function analyzeScopes(program) {
           fnScope.declarations.add(node.id.name);
         }
         for (const param of node.params) declarePattern(param, fnScope);
-        walk2(node.typeParameters, fnScope, true);
+        walk3(node.typeParameters, fnScope, true);
         for (const param of node.params) walkPattern(param, fnScope, typeOnly);
-        walk2(node.returnType, fnScope, true);
+        walk3(node.returnType, fnScope, true);
         if (node.body?.type === "BlockStatement") {
           hoistDeclarations(node.body.body, fnScope);
-          walk2(node.body.body, fnScope, typeOnly);
+          walk3(node.body.body, fnScope, typeOnly);
         } else {
-          walk2(node.body, fnScope, typeOnly);
+          walk3(node.body, fnScope, typeOnly);
         }
         return;
       }
@@ -3554,11 +3654,11 @@ function analyzeScopes(program) {
           classScope.declarations.add(node.id.name);
           scopeOf.set(node, classScope);
         }
-        walk2(node.superClass, classScope, typeOnly);
-        walk2(node.superTypeArguments, classScope, true);
-        walk2(node.typeParameters, classScope, true);
-        walk2(node.implements, classScope, true);
-        walk2(node.body, classScope, typeOnly);
+        walk3(node.superClass, classScope, typeOnly);
+        walk3(node.superTypeArguments, classScope, true);
+        walk3(node.typeParameters, classScope, true);
+        walk3(node.implements, classScope, true);
+        walk3(node.body, classScope, typeOnly);
         return;
       }
       case "BlockStatement":
@@ -3566,7 +3666,7 @@ function analyzeScopes(program) {
         const blockScope = new Scope(scope, false, node);
         scopeOf.set(node, blockScope);
         hoistDeclarations(node.body, blockScope);
-        walk2(node.body, blockScope, typeOnly);
+        walk3(node.body, blockScope, typeOnly);
         return;
       }
       case "ForStatement":
@@ -3579,12 +3679,12 @@ function analyzeScopes(program) {
           hoistDeclarations([head], loopScope);
         }
         for (const key of ["init", "left", "right", "test", "update", "body"]) {
-          walk2(node[key], loopScope, typeOnly);
+          walk3(node[key], loopScope, typeOnly);
         }
         return;
       }
       case "SwitchStatement": {
-        walk2(node.discriminant, scope, typeOnly);
+        walk3(node.discriminant, scope, typeOnly);
         const switchScope = new Scope(scope, false, node);
         scopeOf.set(node, switchScope);
         hoistDeclarations(
@@ -3592,8 +3692,8 @@ function analyzeScopes(program) {
           switchScope
         );
         for (const c of node.cases) {
-          walk2(c.test, switchScope, typeOnly);
-          walk2(c.consequent, switchScope, typeOnly);
+          walk3(c.test, switchScope, typeOnly);
+          walk3(c.consequent, switchScope, typeOnly);
         }
         return;
       }
@@ -3604,17 +3704,17 @@ function analyzeScopes(program) {
           declarePattern(node.param, catchScope);
           walkPattern(node.param, catchScope, typeOnly);
         }
-        walk2(node.body, catchScope, typeOnly);
+        walk3(node.body, catchScope, typeOnly);
         return;
       }
     }
     for (const key of Object.keys(node)) {
       if (key === "type" || key === "start" || key === "end") continue;
-      walk2(node[key], scope, typeOnly || TYPE_KEYS.has(key));
+      walk3(node[key], scope, typeOnly || TYPE_KEYS.has(key));
     }
   };
   hoistDeclarations(program.body, moduleScope);
-  walk2(program.body, moduleScope, false);
+  walk3(program.body, moduleScope, false);
   return { moduleScope, references, scopeOf };
 }
 function collectImports(program) {
@@ -4044,9 +4144,9 @@ function transitionWhenHoistPlugin() {
       emitted.delete(file);
       const result = await hoistTransitionWhens(code, id, {
         isServerOnlyImport: async (source) => {
-          const resolved = await this.resolve(source, id);
-          if (!resolved || resolved.external) return false;
-          const target = resolved.id.split("?", 1)[0];
+          const resolved2 = await this.resolve(source, id);
+          if (!resolved2 || resolved2.external) return false;
+          const target = resolved2.id.split("?", 1)[0];
           if (target.includes("/node_modules/") || target.startsWith("\0")) {
             return false;
           }
@@ -4207,9 +4307,9 @@ async function resolvePublicSpecifier(source, metadata, installedSpecifier, reso
       source
     )) {
       try {
-        const resolved = await resolvePackage(candidate, importer);
-        if (!resolved) continue;
-        const resolvedId = stripQueryAndHash(resolved);
+        const resolved2 = await resolvePackage(candidate, importer);
+        if (!resolved2) continue;
+        const resolvedId = stripQueryAndHash(resolved2);
         if (normalize(resolvedId) === normalize(source) && belongsToPackage(resolvedId, metadata.root)) {
           return candidate;
         }
@@ -4309,6 +4409,26 @@ function clientRefDedup() {
   };
 }
 
+// src/vite/plugins/stable-rsc-output.ts
+import { parseAst as parseAst4 } from "vite";
+
+// src/vite/discovery/build-versions.ts
+import { createHash as createHash3 } from "node:crypto";
+import { isBuiltin } from "node:module";
+import { posix, relative as relative3 } from "node:path";
+
+// src/router-versions.ts
+var DEFAULT_ROUTER_VERSIONS_KEY = "*";
+function uniformVersions(version) {
+  return { data: version, document: version };
+}
+function resolveVersionsFrom(table, routerId2, override) {
+  if (override !== void 0) return uniformVersions(override);
+  if (!table) return void 0;
+  const pair = (routerId2 !== void 0 && Object.hasOwn(table, routerId2) ? table[routerId2] : void 0) ?? table[DEFAULT_ROUTER_VERSIONS_KEY];
+  return pair ? { data: pair[0], document: pair[1] } : void 0;
+}
+
 // src/vite/plugins/virtual-entries.ts
 var VIRTUAL_ENTRY_BROWSER = `
 import {
@@ -4369,7 +4489,12 @@ function emitProgressiveChunkSize(value) {
   return JSON.stringify(value);
 }
 function getVirtualEntrySSR(headScripts = "preinit", progressiveChunkSize) {
-  const preinit = headScripts !== "preload";
+  if (headScripts !== "preinit" && headScripts !== "preload") {
+    throw new Error(
+      `rango({ headScripts }) must be "preinit" or "preload", received ${JSON.stringify(headScripts)}`
+    );
+  }
+  const preinit = headScripts === "preinit";
   const depsImportNames = preinit ? "createFromReadableStream,\n  setOnClientReference,\n  getClientEntryUrl," : "createFromReadableStream,";
   const ssrImportNames = preinit ? "\n  installClientReferencePreinit," : "";
   const install = preinit ? `
@@ -4452,12 +4577,11 @@ import {
 // consults them at router-module evaluation. Router-first would silently push
 // every clientUrls() app onto the deferred-subscription path and change mount
 // registration order with no error. The custom-entry injector keeps the same
-// guarantee by PREPENDING this list at file top (version-injector.ts).
+// guarantee by PREPENDING this list at file top (entry-bootstrap-injector.ts).
 ${bootstrapImports}
 
 import { router } from "${routerPath}";
 import { createRSCHandler } from "@rangojs/router/internal/rsc-handler";
-import { VERSION } from "@rangojs/router:version";
 
 // Lazily create the handler on first request so that ESM live bindings
 // have resolved by the time we read \`router\`. During HMR the module may
@@ -4467,7 +4591,6 @@ export default function handler(request, env) {
   if (!_handler) {
     _handler = createRSCHandler({
       router,
-      version: VERSION,
       // Forward the router's CSP nonce provider. createRSCHandler reads the
       // provider only from options.nonce; without this, createRouter({ nonce })
       // is silently dropped on the Node preset (the Cloudflare path wires it via
@@ -4567,7 +4690,726 @@ var VIRTUAL_IDS = {
   version: "@rangojs/router:version"
 };
 function getVirtualVersionContent(version) {
-  return `export const VERSION = ${JSON.stringify(version)};`;
+  return [
+    `export const VERSION = ${JSON.stringify(version)};`,
+    `export const ROUTER_VERSIONS = undefined;`
+  ].join("\n");
+}
+var ROUTER_VERSIONS_PLACEHOLDER = "__RANGO_ROUTER_VERSIONS__";
+function getVirtualBuildVersionContent() {
+  return [
+    `export const ROUTER_VERSIONS = ${ROUTER_VERSIONS_PLACEHOLDER};`,
+    `export const VERSION = ROUTER_VERSIONS[${JSON.stringify(DEFAULT_ROUTER_VERSIONS_KEY)}][1];`
+  ].join("\n");
+}
+
+// src/vite/utils/client-chunks.ts
+init_debug();
+init_client_ref_hashing();
+import { gzipSync } from "node:zlib";
+var debugChunks = createRangoDebugger(NS.chunks);
+function isSharedRuntime(meta) {
+  return [meta.id, meta.normalizedId].some(
+    (path6) => path6.includes("/node_modules/") || /\/@rangojs\/router\//.test(path6) || /\/packages\/(rangojs-router|rsc-router)\/(src|dist)\//.test(path6)
+  );
+}
+function sanitizeGroup(name) {
+  return name.replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/^_+|_+$/g, "") || "app";
+}
+var ROUTE_ROOT_DIRS = /* @__PURE__ */ new Set([
+  "routes",
+  "route",
+  "pages",
+  "page",
+  "app",
+  "features",
+  "feature",
+  "views",
+  "view",
+  "handlers",
+  "urls",
+  "modules",
+  "screens",
+  "sections"
+]);
+var SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set(["app"]);
+function directoryClientChunks(meta, ctx) {
+  if (isSharedRuntime(meta)) {
+    return void 0;
+  }
+  if (ctx?.fallbackRefs.size && ctx.fallbackRefs.has(hashRefKey(meta.normalizedId))) {
+    debugChunks?.("fallback %s -> app-fallback", meta.normalizedId);
+    return "app-fallback";
+  }
+  const segments = meta.normalizedId.split("/").filter(Boolean);
+  const dirCount = segments.length - 1;
+  const isMarkerAt = (i) => i < dirCount - 1 && ROUTE_ROOT_DIRS.has(segments[i].toLowerCase());
+  for (let i = 0; i < dirCount - 1; i++) {
+    if (!isMarkerAt(i)) continue;
+    const marker = SOURCE_ROOT_DIRS.has(segments[i].toLowerCase()) && isMarkerAt(i + 1) ? i + 1 : i;
+    const group = `app-${sanitizeGroup(segments[marker + 1])}`;
+    debugChunks?.("split %s -> %s", meta.normalizedId, group);
+    return group;
+  }
+  debugChunks?.(
+    "shared %s (no route-root marker; inherits default grouping)",
+    meta.normalizedId
+  );
+  return void 0;
+}
+function resolveClientChunks(option, ctx) {
+  if (!option) return void 0;
+  if (option === true) return (meta) => directoryClientChunks(meta, ctx);
+  return option;
+}
+var CLIENT_REFERENCES_MODULE_ID = "\0virtual:vite-rsc/client-references";
+var CLIENT_GROUP_PREFIX = `${CLIENT_REFERENCES_MODULE_ID}/group/`;
+function clientChunksReport(log = debugChunks) {
+  if (!log) return void 0;
+  return {
+    name: "@rangojs/router:client-chunks-report",
+    apply: "build",
+    applyToEnvironment: (env) => env.name === "client",
+    generateBundle(_options, bundle) {
+      for (const chunk of Object.values(bundle)) {
+        if (chunk.type !== "chunk") continue;
+        const facade = chunk.facadeModuleId;
+        if (!facade?.startsWith(CLIENT_GROUP_PREFIX)) continue;
+        log(
+          "group %s: %d client reference(s), %d B (%d B gzip) -> %s",
+          facade.slice(CLIENT_GROUP_PREFIX.length).replaceAll("\0", "\\0"),
+          this.getModuleInfo(facade)?.importedIds.length ?? 0,
+          Buffer.byteLength(chunk.code),
+          gzipSync(chunk.code).length,
+          chunk.fileName
+        );
+      }
+    }
+  };
+}
+
+// src/vite/discovery/build-versions.ts
+function identifier(name) {
+  return new RegExp(`(?<![\\w$.])${escapeRegExp(name)}(?![\\w$])`, "g");
+}
+var ENCRYPTION_RUNTIME_ID = "/utils/encryption-runtime";
+var ENCRYPTION_RUNTIME_IMPORT = /import\s*\*\s*as\s+([A-Za-z_$][\w$]*)\s+from\s*["'][^"'\n]*\/utils\/encryption-runtime[^"'\n]*["']/;
+function usesEncryptionRuntime(code) {
+  if (code == null) return true;
+  const local = code.match(ENCRYPTION_RUNTIME_IMPORT)?.[1];
+  if (local === void 0) return true;
+  let occurrences = 0;
+  for (const _ of code.matchAll(identifier(local))) {
+    if (++occurrences > 1) return true;
+  }
+  return false;
+}
+function recordModuleEdges(context) {
+  const modules = /* @__PURE__ */ new Map();
+  for (const id of context.getModuleIds()) {
+    const info = context.getModuleInfo(id);
+    const imports = info?.importedIds ?? [];
+    const encryptsBoundArgs = imports.some((imported) => imported.includes(ENCRYPTION_RUNTIME_ID)) && usesEncryptionRuntime(info?.code);
+    modules.set(id, {
+      imports,
+      dynamicImports: info?.dynamicallyImportedIds ?? [],
+      ...encryptsBoundArgs ? { encryptsBoundArgs } : void 0
+    });
+  }
+  return modules;
+}
+function recordBundleFiles(bundle) {
+  const chunks = [];
+  const assets = [];
+  for (const file of Object.values(bundle)) {
+    if (file.type === "chunk") {
+      chunks.push({
+        fileName: file.fileName,
+        name: file.name ?? file.fileName,
+        moduleIds: file.moduleIds ?? [],
+        externalImports: [
+          ...file.imports ?? [],
+          ...file.dynamicImports ?? []
+        ].filter((specifier) => !Object.hasOwn(bundle, specifier))
+      });
+    } else {
+      assets.push({
+        fileName: file.fileName,
+        name: file.names?.[0] ?? file.fileName
+      });
+    }
+  }
+  return { chunks, assets };
+}
+function recordServerGraph(context, bundle) {
+  return { modules: recordModuleEdges(context), ...recordBundleFiles(bundle) };
+}
+function recordClientGraph(context, bundle) {
+  return {
+    modules: recordModuleEdges(context),
+    fileNames: Object.values(bundle).map((file) => file.fileName)
+  };
+}
+var SERVER_REFERENCES_MODULE_ID = "\0virtual:vite-rsc/server-references";
+var LOADER_REGISTRY = "\0" + VIRTUAL_LOADER_MANIFEST_ID;
+var ROUTES_REGISTRY = "\0" + VIRTUAL_ROUTES_MANIFEST_ID;
+var VERSION_MODULE = "\0" + VIRTUAL_IDS.version;
+var ENCRYPTION_KEY_FILE = "__vite_rsc_encryption_key.js";
+function isRegistryModule(id) {
+  return id === SERVER_REFERENCES_MODULE_ID || id === LOADER_REGISTRY || id === ROUTES_REGISTRY || id.startsWith(ROUTES_REGISTRY + "/") || id === CLIENT_REFERENCES_MODULE_ID || id.startsWith(CLIENT_REFERENCES_MODULE_ID + "/");
+}
+function routeManifestModuleId(routerId2) {
+  return `${ROUTES_REGISTRY}/${routerId2}`;
+}
+function walk(modules, roots, reached) {
+  const stack = [...roots];
+  while (stack.length > 0) {
+    const id = stack.pop();
+    if (reached.has(id)) continue;
+    reached.add(id);
+    if (isRegistryModule(id)) continue;
+    const edges = modules.get(id);
+    if (!edges) continue;
+    for (const next of edges.imports) {
+      if (!reached.has(next)) stack.push(next);
+    }
+    for (const next of edges.dynamicImports) {
+      if (!reached.has(next)) stack.push(next);
+    }
+  }
+}
+function registryTargets(server) {
+  const targets = /* @__PURE__ */ new Set();
+  for (const id of [SERVER_REFERENCES_MODULE_ID, LOADER_REGISTRY]) {
+    for (const target of server.modules.get(id)?.dynamicImports ?? []) {
+      targets.add(target);
+    }
+  }
+  return targets;
+}
+function ownersOf(subjects, reachOf) {
+  const owners = /* @__PURE__ */ new Set();
+  for (const [routerId2, reached] of reachOf) {
+    if (subjects.some((id) => reached.has(id))) owners.add(routerId2);
+  }
+  return owners.size > 0 ? owners : void 0;
+}
+function extendReach(server, client, targets, reach, roots) {
+  walk(server.modules, roots, reach.server);
+  if (!client || targets.size === 0) return;
+  for (; ; ) {
+    const seeds = [];
+    for (const id of reach.server) {
+      if (!reach.client.has(id) && client.modules.has(id)) seeds.push(id);
+    }
+    if (seeds.length === 0) return;
+    walk(client.modules, seeds, reach.client);
+    const found = [];
+    for (const target of targets) {
+      if (reach.client.has(target) && !reach.server.has(target)) {
+        found.push(target);
+      }
+    }
+    if (found.length === 0) return;
+    walk(server.modules, found, reach.server);
+  }
+}
+function findModuleId(modules, path6) {
+  if (modules.has(path6)) return path6;
+  for (const id of modules.keys()) {
+    const query = id.indexOf("?");
+    if (query !== -1 && id.slice(0, query) === path6) return id;
+  }
+  return void 0;
+}
+function staticImporters(modules) {
+  const importers = /* @__PURE__ */ new Map();
+  for (const [id, edges] of modules) {
+    if (isRegistryModule(id)) continue;
+    for (const imported of edges.imports) {
+      const list = importers.get(imported);
+      if (list) list.push(id);
+      else importers.set(imported, [id]);
+    }
+  }
+  return importers;
+}
+function resolveRouterMembers(server, client, routers) {
+  const targets = registryTargets(server);
+  const importers = staticImporters(server.modules);
+  const reachByRouter = /* @__PURE__ */ new Map();
+  for (const router of routers) {
+    const moduleId = router.moduleId !== void 0 ? findModuleId(server.modules, router.moduleId) : void 0;
+    if (moduleId === void 0) continue;
+    const climbed = /* @__PURE__ */ new Set();
+    const stack = [moduleId];
+    while (stack.length > 0) {
+      const id = stack.pop();
+      if (climbed.has(id)) continue;
+      climbed.add(id);
+      for (const importer of importers.get(id) ?? []) stack.push(importer);
+    }
+    const reach = { server: /* @__PURE__ */ new Set(), client: /* @__PURE__ */ new Set() };
+    extendReach(server, client, targets, reach, climbed);
+    reachByRouter.set(router.id, reach);
+  }
+  const serverReach = new Map(
+    [...reachByRouter].map(([routerId2, reach]) => [routerId2, reach.server])
+  );
+  const unattributed = [...targets].filter(
+    (target) => ownersOf([target], serverReach) === void 0
+  );
+  if (unattributed.length > 0) {
+    for (const reach of reachByRouter.values()) {
+      extendReach(server, client, targets, reach, unattributed);
+    }
+  }
+  const chunkOfModule = /* @__PURE__ */ new Map();
+  for (const chunk of server.chunks) {
+    for (const id of chunk.moduleIds) chunkOfModule.set(id, chunk.fileName);
+  }
+  const members = /* @__PURE__ */ new Map();
+  for (const [routerId2, { server: modules }] of reachByRouter) {
+    const chunkFiles = /* @__PURE__ */ new Set();
+    for (const id of modules) {
+      const fileName = chunkOfModule.get(id);
+      if (fileName !== void 0) chunkFiles.add(fileName);
+    }
+    const manifestChunk = chunkOfModule.get(routeManifestModuleId(routerId2));
+    if (manifestChunk !== void 0) chunkFiles.add(manifestChunk);
+    members.set(routerId2, { modules, chunkFiles });
+  }
+  return members;
+}
+function sha256(value) {
+  return createHash3("sha256").update(value).digest("hex");
+}
+var baseName = posix.basename;
+function isAbsolutePath(path6) {
+  return path6.startsWith("/") || /^[A-Za-z]:[\\/]/.test(path6);
+}
+var PNPM_PEER_SUFFIX = /(\/\.pnpm\/[^/]+?@[^/_]+)_[^/]+(?=\/)/g;
+function withoutWorkingDirectory(id) {
+  const kind = /(?:facade|shared):/.exec(id);
+  const virtual = id.indexOf("\0");
+  if (!kind || virtual === -1) return id;
+  const facade = kind.index + kind[0].length;
+  return virtual < facade ? id : id.slice(0, facade) + id.slice(virtual);
+}
+function portableModuleId(id, projectRoot) {
+  const path6 = id.startsWith("\0") ? id.slice(1) : id;
+  const nodeModules = path6.indexOf("/node_modules/");
+  if (nodeModules !== -1) {
+    return path6.slice(nodeModules + 1).replace(PNPM_PEER_SUFFIX, "$1");
+  }
+  if (isAbsolutePath(path6)) {
+    return relative3(projectRoot, path6).replaceAll("\\", "/");
+  }
+  return withoutWorkingDirectory(path6).replace(
+    /([?&][^=&]+=)([^&]+)/g,
+    (whole, name, value) => {
+      let decoded;
+      try {
+        decoded = decodeURIComponent(value);
+      } catch {
+        return whole;
+      }
+      return isAbsolutePath(decoded) ? name + portableModuleId(decoded, projectRoot) : whole;
+    }
+  );
+}
+var SERVER_CSS_MODULE = /^virtual:vite-rsc\/css\?type=rsc&id=([^&]+)/;
+function isSourceMap(fileName) {
+  return fileName.endsWith(".map");
+}
+var SERVER_REFERENCES_REGION_START = `//#region \\0${SERVER_REFERENCES_MODULE_ID.slice(1)}
+`;
+var REGION_END = "//#endregion";
+function stripServerReferenceMap(source) {
+  const start = source.indexOf(SERVER_REFERENCES_REGION_START);
+  if (start === -1) return source;
+  const bodyStart = start + SERVER_REFERENCES_REGION_START.length;
+  const end = source.indexOf(REGION_END, bodyStart);
+  if (end === -1) return source;
+  return source.slice(0, bodyStart) + source.slice(end);
+}
+var REGION_LINE = /^\/\/#region .*$/gm;
+function stripRegionPaths(source) {
+  return source.replace(REGION_LINE, "//#region");
+}
+var FILE_REFERENCE = "\0";
+var FOREIGN_FILE = "~";
+function digestBundle(bundle, projectRoot, read, label) {
+  const named = [];
+  for (const chunk of bundle.chunks) {
+    const ids = chunk.moduleIds.map((id) => portableModuleId(id, projectRoot)).sort();
+    const ext = posix.extname(chunk.fileName);
+    named.push({
+      fileName: chunk.fileName,
+      identity: `${chunk.name}~${sha256(ids.join("\n")).slice(0, 8)}${ext}`,
+      hashedName: baseName(chunk.fileName) !== chunk.name + ext,
+      chunk
+    });
+  }
+  for (const asset of bundle.assets) {
+    if (isSourceMap(asset.fileName)) continue;
+    named.push({
+      fileName: asset.fileName,
+      identity: asset.name,
+      hashedName: baseName(asset.fileName) !== baseName(asset.name)
+    });
+  }
+  const fileOfBaseName = /* @__PURE__ */ new Map();
+  for (const file of named) {
+    if (file.hashedName) {
+      fileOfBaseName.set(baseName(file.fileName), file.fileName);
+    }
+  }
+  const reference = fileOfBaseName.size > 0 ? new RegExp(
+    [...fileOfBaseName.keys()].sort((a, b) => b.length - a.length).map(escapeRegExp).join("|"),
+    "g"
+  ) : void 0;
+  const decoder3 = new TextDecoder();
+  return named.map(({ fileName, identity, chunk }) => {
+    const bytes = read(fileName);
+    if (bytes === void 0) {
+      throw new Error(
+        `the ${label} bundle lists ${fileName}, which is not in its output directory`
+      );
+    }
+    if (!chunk) {
+      return {
+        fileName,
+        identity,
+        base: sha256(bytes),
+        references: [],
+        externalImports: []
+      };
+    }
+    const references = [];
+    const text = stripRegionPaths(
+      stripServerReferenceMap(decoder3.decode(bytes))
+    );
+    const blanked = reference ? text.replace(reference, (name) => {
+      references.push(fileOfBaseName.get(name));
+      return FILE_REFERENCE;
+    }) : text;
+    return {
+      fileName,
+      identity,
+      base: sha256(blanked),
+      references,
+      externalImports: chunk.externalImports ?? []
+    };
+  });
+}
+function digestAsOwned(file, identityOf, owned) {
+  if (file.references.length === 0) return file.base;
+  return sha256(
+    JSON.stringify([
+      file.base,
+      ...file.references.map(
+        (name) => owned.has(name) ? identityOf.get(name) : FOREIGN_FILE
+      )
+    ])
+  );
+}
+var RUNTIME_SCHEME = /^(?:node|cloudflare|workerd|bun):/;
+var REPLACED_MARKER = /^(?:__CLOUDFLARE_MODULE__.*__CLOUDFLARE_MODULE__|virtual:vite-rsc\/assets-manifest)$/;
+var PACKAGE_NAME = /^(?:@[\w.~-]+\/)?[A-Za-z0-9~-][\w.~-]*$/;
+function classifyExternal(specifier) {
+  if (/^[./\\]/.test(specifier) || isAbsolutePath(specifier)) {
+    return { kind: "file" };
+  }
+  if (RUNTIME_SCHEME.test(specifier) || specifier.startsWith("data:") || isBuiltin(specifier) || REPLACED_MARKER.test(specifier)) {
+    return { kind: "provided" };
+  }
+  if (specifier.includes(":")) return { kind: "unknown" };
+  const parts = specifier.split("/");
+  const name = specifier.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+  return PACKAGE_NAME.test(name) ? { kind: "package", name } : { kind: "unknown" };
+}
+function externalInputs(file, context) {
+  const { externals, undetermined } = context;
+  const inputs = [];
+  const add = (name, value) => {
+    if (value === void 0) undetermined.add(name);
+    inputs.push([
+      `external ${name}`,
+      sha256(value ?? `undetermined ${externals.buildId}`)
+    ]);
+  };
+  for (const specifier of file.externalImports) {
+    const external = classifyExternal(specifier);
+    if (external.kind === "package") {
+      add(external.name, externals.describePackage(external.name));
+    } else if (external.kind === "file") {
+      if (isAbsolutePath(specifier)) {
+        const inProject = portableModuleId(specifier, context.projectRoot);
+        add(
+          inProject.startsWith("..") ? specifier : inProject,
+          externals.readFile(specifier)
+        );
+      } else {
+        const fileName = posix.join(
+          posix.dirname(file.fileName),
+          specifier.replaceAll("\\", "/")
+        );
+        add(fileName, context.read(fileName));
+      }
+    } else if (external.kind === "unknown") {
+      add(specifier, void 0);
+    }
+  }
+  return inputs;
+}
+var VERSION_HEX_LENGTH = 16;
+function byName(a, b) {
+  return compareStrings(a[0], b[0]) || compareStrings(a[1], b[1]);
+}
+function distinct(inputs) {
+  const sorted = [...inputs].sort(byName);
+  return sorted.filter(
+    (item, index) => index === 0 || byName(item, sorted[index - 1]) !== 0
+  );
+}
+function hashInputs(label, inputs) {
+  return sha256(`${label}
+${JSON.stringify(inputs)}`).slice(
+    0,
+    VERSION_HEX_LENGTH
+  );
+}
+function serverCssRecords(server, projectRoot, serverResources) {
+  if (serverResources.size === 0) return [];
+  const moduleOf = /* @__PURE__ */ new Map();
+  for (const id of server.modules.keys()) {
+    const key = portableModuleId(id, projectRoot).match(SERVER_CSS_MODULE)?.[1];
+    if (key !== void 0) moduleOf.set(key, id);
+  }
+  return [...serverResources].map(([key, entry]) => ({
+    kind: "server-css",
+    key,
+    digest: sha256(entry),
+    moduleId: moduleOf.get(key)
+  }));
+}
+function computeRouterVersions(input) {
+  const { server, projectRoot } = input;
+  const undetermined = /* @__PURE__ */ new Set();
+  const files = digestBundle(server, projectRoot, input.readServerFile, "RSC");
+  const identityOf = new Map(
+    files.map((file) => [file.fileName, file.identity])
+  );
+  const assetFiles = new Set(server.assets.map((asset) => asset.fileName));
+  const externalContext = {
+    projectRoot,
+    externals: input.externals,
+    read: input.readServerFile,
+    undetermined
+  };
+  const externalsOf = new Map(
+    files.map((file) => [file.fileName, externalInputs(file, externalContext)])
+  );
+  const members = resolveRouterMembers(server, input.client, input.routers);
+  const reachOf = new Map(
+    [...members].map(([routerId2, member]) => [routerId2, member.modules])
+  );
+  const owned = [
+    ...input.buildData,
+    ...serverCssRecords(
+      server,
+      projectRoot,
+      input.serverResources ?? /* @__PURE__ */ new Map()
+    )
+  ].map(
+    (record) => ({
+      input: [`${record.kind} ${record.key}`, record.digest],
+      version: record.kind === "prerender" ? "document" : "data",
+      owners: record.routerId !== void 0 ? /* @__PURE__ */ new Set([record.routerId]) : ownersOf(
+        record.moduleId === void 0 ? [] : [record.moduleId],
+        reachOf
+      )
+    })
+  );
+  const encrypting = [...server.modules].filter(([, edges]) => edges.encryptsBoundArgs).map(([id]) => id);
+  const keyFile = input.readServerFile(ENCRYPTION_KEY_FILE);
+  if (keyFile !== void 0) {
+    owned.push({
+      input: ["encryption-key", sha256(keyFile)],
+      version: "data",
+      owners: ownersOf(encrypting, reachOf)
+    });
+  } else if (encrypting.length > 0) {
+    throw new Error(
+      `${encrypting.length} server module(s) encrypt action arguments (${portableModuleId(encrypting[0], projectRoot)}), but ${ENCRYPTION_KEY_FILE} is not in the RSC output directory, so the key cannot be made part of their cache version. The installed @vitejs/plugin-rsc keeps the key somewhere @rangojs/router does not know. Report it with the plugin-rsc version.`
+    );
+  }
+  const keyInput = owned.find((item) => item.input[0] === "encryption-key");
+  const ssrFiles = digestBundle(
+    input.ssr,
+    projectRoot,
+    input.readSsrFile,
+    "SSR"
+  );
+  const ssrIdentityOf = new Map(
+    ssrFiles.map((file) => [file.fileName, file.identity])
+  );
+  const everySsrFile = new Set(ssrFiles.map((file) => file.fileName));
+  const ssrAndClient = {
+    base: input.base,
+    ssr: distinct(
+      ssrFiles.map((file) => [
+        file.identity,
+        digestAsOwned(file, ssrIdentityOf, everySsrFile)
+      ])
+    ),
+    externals: distinct(
+      ssrFiles.flatMap(
+        (file) => externalInputs(file, { ...externalContext, read: input.readSsrFile })
+      )
+    ),
+    client: [...input.client.fileNames].sort()
+  };
+  const documentDigest = sha256(JSON.stringify(ssrAndClient));
+  const table = {};
+  const details = [];
+  const ownedByARouter = /* @__PURE__ */ new Set();
+  const add = (routerId2, chunkFiles) => {
+    const whole = chunkFiles === void 0;
+    const ownedFiles = new Set(
+      chunkFiles ?? files.map((file) => file.fileName)
+    );
+    for (const file of files) {
+      if (!ownedFiles.has(file.fileName)) continue;
+      for (const name of file.references) {
+        if (assetFiles.has(name)) ownedFiles.add(name);
+      }
+    }
+    const inputs = {
+      data: [],
+      document: [["ssr-and-client", documentDigest]]
+    };
+    for (const file of files) {
+      if (!ownedFiles.has(file.fileName)) continue;
+      if (!whole) ownedByARouter.add(file.fileName);
+      inputs.data.push(
+        [`file ${file.identity}`, digestAsOwned(file, identityOf, ownedFiles)],
+        ...externalsOf.get(file.fileName)
+      );
+    }
+    for (const item of owned) {
+      if (whole || item.owners === void 0 || item.owners.has(routerId2)) {
+        inputs[item.version].push(item.input);
+      }
+    }
+    const dataInputs = distinct(inputs.data);
+    const documentInputs = distinct(inputs.document);
+    const data = hashInputs("rango-data-version", dataInputs);
+    const document2 = hashInputs(
+      `rango-document-version
+${data}`,
+      documentInputs
+    );
+    table[routerId2] = [data, document2];
+    details.push({
+      routerId: routerId2,
+      data,
+      document: document2,
+      dataInputs,
+      documentInputs,
+      usesEncryptionKey: keyInput !== void 0 && (whole || keyInput.owners === void 0 || keyInput.owners.has(routerId2))
+    });
+  };
+  for (const router of input.routers) {
+    const member = members.get(router.id);
+    if (member) add(router.id, member.chunkFiles);
+  }
+  add(DEFAULT_ROUTER_VERSIONS_KEY);
+  return {
+    table,
+    details,
+    ssrAndClient,
+    unownedFiles: files.filter((file) => !ownedByARouter.has(file.fileName)).map((file) => file.identity).sort(),
+    undetermined: [...undetermined].sort()
+  };
+}
+function recordVersionModuleFiles(bundle) {
+  return Object.values(bundle).filter(
+    (file) => file.type === "chunk" && file.moduleIds?.includes(VERSION_MODULE)
+  ).map((file) => file.fileName);
+}
+function fillRouterVersions(source, table) {
+  if (!source.includes(ROUTER_VERSIONS_PLACEHOLDER)) return void 0;
+  const json = JSON.stringify(table);
+  return source.replaceAll(ROUTER_VERSIONS_PLACEHOLDER, () => json);
+}
+
+// src/vite/plugins/stable-rsc-output.ts
+function literalProperties(object) {
+  if (object?.type !== "ObjectExpression") return void 0;
+  const properties = [];
+  for (const property of object.properties ?? []) {
+    const key = property?.type === "Property" && !property.computed ? property.key?.value ?? property.key?.name : void 0;
+    if (typeof key !== "string") return void 0;
+    properties.push({
+      key,
+      start: property.start,
+      end: property.end,
+      value: property.value
+    });
+  }
+  return properties;
+}
+function defaultExportProperties(code) {
+  let program;
+  try {
+    program = parseAst4(code);
+  } catch {
+    return void 0;
+  }
+  return literalProperties(
+    (program.body ?? []).find(
+      (node) => node?.type === "ExportDefaultDeclaration"
+    )?.declaration
+  );
+}
+function sortDefaultExportProperties(code) {
+  const properties = defaultExportProperties(code);
+  if (!properties || properties.length < 2) return void 0;
+  const sorted = [...properties].sort((a, b) => compareStrings(a.key, b.key));
+  if (sorted.every((property, index) => property === properties[index])) {
+    return void 0;
+  }
+  return code.slice(0, properties[0].start) + sorted.map((property) => code.slice(property.start, property.end)).join(",\n") + code.slice(properties[properties.length - 1].end);
+}
+var ASSETS_MANIFEST_ID = "virtual:vite-rsc/assets-manifest";
+var ASSETS_MANIFEST_IMPORT = /import\s+([A-Za-z_$][\w$]*)\s+from\s*["']virtual:vite-rsc\/assets-manifest["']/;
+var ASSETS_MANIFEST_BINDING = "assetsManifest";
+var GENERATED_BINDINGS = /* @__PURE__ */ new Set([
+  "__vite_rsc_assets_manifest__",
+  "__vite_rsc_assets_manifest"
+]);
+function identifier2(name) {
+  return new RegExp(`(?<![\\w$.])${escapeRegExp(name)}(?![\\w$])`, "g");
+}
+function canonicalAssetsManifestBinding(code) {
+  const local = code.match(ASSETS_MANIFEST_IMPORT)?.[1];
+  if (local === void 0 || !GENERATED_BINDINGS.has(local)) return void 0;
+  if (identifier2(ASSETS_MANIFEST_BINDING).test(code)) return void 0;
+  return code.replace(identifier2(local), ASSETS_MANIFEST_BINDING);
+}
+function stableRscOutput() {
+  return {
+    name: "@rangojs/router:stable-rsc-output",
+    apply: "build",
+    // After plugin-rsc's transforms, which add the manifest import.
+    enforce: "post",
+    transform(code, id) {
+      const stable = id === SERVER_REFERENCES_MODULE_ID ? sortDefaultExportProperties(code) : code.includes(ASSETS_MANIFEST_ID) ? canonicalAssetsManifestBinding(code) : void 0;
+      return stable === void 0 ? null : { code: stable, map: null };
+    }
+  };
 }
 
 // src/vite/utils/package-resolution.ts
@@ -4578,7 +5420,7 @@ import { resolve } from "node:path";
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.19.1",
+  version: "0.21.0",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -4809,7 +5651,6 @@ var package_default = {
     "@playwright/test": "^1.49.1",
     "@testing-library/react": ">=16",
     "@vercel/functions": "^3.0.0",
-    "@vitejs/plugin-rsc": "^0.5.35",
     react: ">=19.2.8 <20",
     "react-dom": ">=19.2.8 <20",
     vite: "^8.0.16",
@@ -4889,7 +5730,8 @@ function getVendorAliases() {
   const specs = [
     "@vitejs/plugin-rsc/vendor/react-server-dom/client.browser",
     "@vitejs/plugin-rsc/vendor/react-server-dom/client.edge",
-    "@vitejs/plugin-rsc/vendor/react-server-dom/server.edge"
+    "@vitejs/plugin-rsc/vendor/react-server-dom/server.edge",
+    "@vitejs/plugin-rsc/vendor/react-server-dom/static.edge"
   ];
   const aliases = {};
   for (const spec of specs) {
@@ -5028,7 +5870,7 @@ declare global {
 }
 
 // src/build/route-types/scan-filter.ts
-import { join as join2, relative as relative2 } from "node:path";
+import { join as join2, relative as relative4 } from "node:path";
 import { readdirSync } from "node:fs";
 import picomatch from "picomatch";
 var DEFAULT_EXCLUDE_PATTERNS = [
@@ -5048,7 +5890,7 @@ function createScanFilter(root, opts) {
   const includeMatcher = hasInclude ? picomatch(include) : null;
   const excludeMatcher = effectiveExclude.length > 0 ? picomatch(effectiveExclude) : null;
   return (absolutePath) => {
-    const rel = relative2(root, absolutePath);
+    const rel = relative4(root, absolutePath);
     if (excludeMatcher && excludeMatcher(rel)) return false;
     if (includeMatcher) return includeMatcher(rel);
     return true;
@@ -5227,7 +6069,7 @@ function extractIncludesWithDiagnostics(code, sourceFileArg) {
     true,
     ts3.ScriptKind.TSX
   );
-  const resolved = [];
+  const resolved2 = [];
   const unresolvable = [];
   function visit(node) {
     if (ts3.isCallExpression(node)) {
@@ -5246,13 +6088,13 @@ function extractIncludesWithDiagnostics(code, sourceFileArg) {
         const namePrefix = extractNamePrefixFromInclude(node);
         const dynamicImportSpec = extractDynamicImportSpecifier(secondArg);
         if (ts3.isIdentifier(secondArg)) {
-          resolved.push({
+          resolved2.push({
             pathPrefix,
             variableName: secondArg.text,
             namePrefix
           });
         } else if (dynamicImportSpec !== null) {
-          resolved.push({
+          resolved2.push({
             pathPrefix,
             moduleSpecifier: dynamicImportSpec,
             namePrefix
@@ -5278,7 +6120,7 @@ function extractIncludesWithDiagnostics(code, sourceFileArg) {
     ts3.forEachChild(node, visit);
   }
   visit(sourceFile);
-  return { resolved, unresolvable };
+  return { resolved: resolved2, unresolvable };
 }
 function resolveImportedVariable(code, localName) {
   const defaultImportRegex = /import\s+([\w$]+)\s*(?:,\s*\{[^}]*\})?\s+from\s*["']([^"']+)["']/g;
@@ -5419,7 +6261,7 @@ function buildRouteMapFromBlock(block, fullSource, filePath, visited, searchSche
         );
       } else {
         const variableName = def.variableName;
-        const resolved = resolveIncludedVariable({
+        const resolved2 = resolveIncludedVariable({
           variableName,
           resolutionFile: targetFile,
           resolutionSource: targetSource,
@@ -5432,12 +6274,12 @@ function buildRouteMapFromBlock(block, fullSource, filePath, visited, searchSche
           fileNotFoundDetail: (specifier) => `import("${inc.moduleSpecifier}") default re-exports "${variableName}" from "${specifier}", which resolved to no file`,
           notFoundDetail: () => `import("${inc.moduleSpecifier}") default "${variableName}" not found in its imports or same-file scope`
         });
-        if (!resolved) continue;
-        childResult = resolved;
+        if (!resolved2) continue;
+        childResult = resolved2;
       }
     } else if (inc.variableName) {
       const variableName = inc.variableName;
-      const resolved = resolveIncludedVariable({
+      const resolved2 = resolveIncludedVariable({
         variableName,
         resolutionFile: filePath,
         resolutionSource: fullSource,
@@ -5450,8 +6292,8 @@ function buildRouteMapFromBlock(block, fullSource, filePath, visited, searchSche
         fileNotFoundDetail: (specifier) => `import "${specifier}" resolved to no file`,
         notFoundDetail: () => `variable "${variableName}" not found in imports or same-file scope`
       });
-      if (!resolved) continue;
-      childResult = resolved;
+      if (!resolved2) continue;
+      childResult = resolved2;
     } else {
       continue;
     }
@@ -6036,14 +6878,14 @@ function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
 }
 
 // src/vite/plugins/version-plugin.ts
-import { parseAst as parseAst5 } from "vite";
+import { parseAst as parseAst6 } from "vite";
 
 // src/vite/utils/directive-prologue.ts
-import { parseAst as parseAst4 } from "vite";
+import { parseAst as parseAst5 } from "vite";
 function hasUseClientDirective2(source) {
   let program;
   try {
-    program = parseAst4(source, { lang: "tsx" });
+    program = parseAst5(source, { lang: "tsx" });
   } catch {
     return false;
   }
@@ -6068,7 +6910,7 @@ function getClientModuleSignature(source) {
   if (!hasUseClientDirective2(source)) return void 0;
   let program;
   try {
-    program = parseAst5(source, { lang: "tsx" });
+    program = parseAst6(source, { lang: "tsx" });
   } catch {
     return void 0;
   }
@@ -6136,8 +6978,7 @@ function getClientModuleSignature(source) {
   };
 }
 function createVersionPlugin() {
-  const buildVersion = Date.now().toString(16);
-  let currentVersion3 = buildVersion;
+  let currentVersion3 = Date.now().toString(16);
   let isDev = false;
   let server = null;
   let resolvedCacheDir;
@@ -6157,13 +6998,6 @@ function createVersionPlugin() {
   return {
     name: "@rangojs/router:version",
     enforce: "pre",
-    // The build-time shell capture phase (producer B, #699) stamps entries
-    // with THIS instance's version — the value folded into the shipped worker
-    // — never the discovery temp server's own version-plugin value (a
-    // different Date.now() stamp that would fail the serve-side gate).
-    api: {
-      getBuildVersion: () => currentVersion3
-    },
     configResolved(config) {
       isDev = config.command === "serve";
       resolvedCacheDir = config.cacheDir ? String(config.cacheDir).replace(/\\/g, "/") : void 0;
@@ -6185,7 +7019,7 @@ function createVersionPlugin() {
     },
     load(id) {
       if (id === "\0" + VIRTUAL_IDS.version) {
-        return getVirtualVersionContent(currentVersion3);
+        return isDev ? getVirtualVersionContent(currentVersion3) : getVirtualBuildVersionContent();
       }
       return null;
     },
@@ -6256,7 +7090,7 @@ import { isAbsolute as isAbsolute2, resolve as resolve4 } from "node:path";
 // src/vite/plugins/performance-tracks.ts
 init_debug();
 import { readFile as readFile2 } from "node:fs/promises";
-var debug5 = createRangoDebugger(NS.transform);
+var debug6 = createRangoDebugger(NS.transform);
 var RSDW_PATCH_RE = /((?:var|let|const)\s+\w+\s*=\s*root\._children\s*,\s*(\w+)\s*=\s*root\._debugInfo\s*[;,])/;
 function buildPatchReplacement(match, debugInfoVar) {
   return `${match}
@@ -6291,7 +7125,7 @@ function performanceTracksOptimizeDepsPlugin() {
   };
 }
 function performanceTracksPlugin() {
-  const counter = createCounter(debug5, "performance-tracks");
+  const counter = createCounter(debug6, "performance-tracks");
   return {
     name: "@rangojs/router:performance-tracks",
     buildEnd() {
@@ -6303,7 +7137,7 @@ function performanceTracksPlugin() {
       try {
         const patched = patchRsdwClientDebugInfoRecovery(code);
         if (!patched.debugInfoVar) return;
-        debug5?.("patched RSDW client (var: %s)", patched.debugInfoVar);
+        debug6?.("patched RSDW client (var: %s)", patched.debugInfoVar);
         return patched.code;
       } finally {
         counter?.record(id, performance.now() - start);
@@ -6440,65 +7274,6 @@ function getManualChunks(id) {
   return void 0;
 }
 
-// src/vite/utils/client-chunks.ts
-init_debug();
-init_client_ref_hashing();
-var debugChunks = createRangoDebugger(NS.chunks);
-function isSharedRuntime(meta) {
-  return [meta.id, meta.normalizedId].some(
-    (path6) => path6.includes("/node_modules/") || /\/@rangojs\/router\//.test(path6) || /\/packages\/(rangojs-router|rsc-router)\/(src|dist)\//.test(path6)
-  );
-}
-function sanitizeGroup(name) {
-  return name.replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/^_+|_+$/g, "") || "app";
-}
-var ROUTE_ROOT_DIRS = /* @__PURE__ */ new Set([
-  "routes",
-  "route",
-  "pages",
-  "page",
-  "app",
-  "features",
-  "feature",
-  "views",
-  "view",
-  "handlers",
-  "urls",
-  "modules",
-  "screens",
-  "sections"
-]);
-function directoryClientChunks(meta, ctx) {
-  if (isSharedRuntime(meta)) {
-    return void 0;
-  }
-  if (ctx?.fallbackRefs.size && ctx.fallbackRefs.has(hashRefKey(meta.normalizedId))) {
-    debugChunks?.("fallback %s -> app-fallback", meta.normalizedId);
-    return "app-fallback";
-  }
-  const segments = meta.normalizedId.split("/").filter(Boolean);
-  const dirCount = segments.length - 1;
-  if (dirCount >= 1) {
-    for (let i = 0; i < dirCount - 1; i++) {
-      if (ROUTE_ROOT_DIRS.has(segments[i].toLowerCase())) {
-        const group = `app-${sanitizeGroup(segments[i + 1])}`;
-        debugChunks?.("split %s -> %s", meta.normalizedId, group);
-        return group;
-      }
-    }
-  }
-  debugChunks?.(
-    "shared %s (no route-root marker; inherits default grouping)",
-    meta.normalizedId
-  );
-  return void 0;
-}
-function resolveClientChunks(option, ctx) {
-  if (!option) return void 0;
-  if (option === true) return (meta) => directoryClientChunks(meta, ctx);
-  return option;
-}
-
 // src/vite/plugins/vercel-output.ts
 import { rm, mkdir, cp, writeFile } from "node:fs/promises";
 import { existsSync as existsSync5 } from "node:fs";
@@ -6775,13 +7550,13 @@ ${dim}   ${reset}${bold}\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550$
   console.log(banner);
 }
 
-// src/vite/plugins/version-injector.ts
+// src/vite/plugins/entry-bootstrap-injector.ts
 import { resolve as resolve6 } from "node:path";
 import * as Vite2 from "vite";
-function createVersionInjectorPlugin(rscEntryPath) {
+function createEntryBootstrapInjectorPlugin(rscEntryPath) {
   let resolvedEntryPath = "";
   return {
-    name: "@rangojs/router:version-injector",
+    name: "@rangojs/router:entry-bootstrap-injector",
     enforce: "pre",
     configResolved(config) {
       let entryPath = rscEntryPath;
@@ -6800,16 +7575,7 @@ function createVersionInjectorPlugin(rscEntryPath) {
       const prepend = RSC_ENTRY_BOOTSTRAP_IMPORTS.map(
         (id2) => `import "${id2}";`
       );
-      let newCode = code;
-      const needsVersion = code.includes("createRSCHandler") && !code.includes("@rangojs/router:version") && /createRSCHandler\s*\(\s*\{/.test(code);
-      if (needsVersion) {
-        prepend.push(`import { VERSION } from "@rangojs/router:version";`);
-        newCode = newCode.replace(
-          /createRSCHandler\s*\(\s*\{/,
-          "createRSCHandler({\n  version: VERSION,"
-        );
-      }
-      const lines = newCode.split("\n");
+      const lines = code.split("\n");
       let insertAt = 0;
       while (insertAt < lines.length) {
         const trimmed = lines[insertAt].trim();
@@ -6819,7 +7585,7 @@ function createVersionInjectorPlugin(rscEntryPath) {
           break;
         }
       }
-      newCode = [
+      const newCode = [
         ...lines.slice(0, insertAt),
         ...prepend,
         ...lines.slice(insertAt)
@@ -6897,8 +7663,8 @@ function createCjsToEsmPlugin() {
 
 // src/vite/router-discovery.ts
 import { createServer as createViteServer } from "vite";
-import { resolve as resolve12 } from "node:path";
-import { readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname7, join as join10, resolve as resolve13 } from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync11 } from "node:fs";
 import { createRequire as createRequire3, register } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 
@@ -7081,7 +7847,7 @@ function createCloudflareProtocolStubPlugin() {
         return null;
       }
       const hits = [];
-      walk(ast, (node) => {
+      walk2(ast, (node) => {
         if (!IMPORT_NODE_TYPES.has(node.type)) return;
         const source = node.source;
         if (!source || source.type !== "Literal") return;
@@ -7119,10 +7885,10 @@ function createCloudflareProtocolStubPlugin() {
     }
   };
 }
-function walk(node, visit) {
+function walk2(node, visit) {
   if (!node || typeof node !== "object") return;
   if (Array.isArray(node)) {
-    for (const child of node) walk(child, visit);
+    for (const child of node) walk2(child, visit);
     return;
   }
   const n = node;
@@ -7132,7 +7898,7 @@ function walk(node, visit) {
     if (key === "loc" || key === "start" || key === "end" || key === "range") {
       continue;
     }
-    walk(n[key], visit);
+    walk2(n[key], visit);
   }
 }
 
@@ -7264,51 +8030,11 @@ function evictHandlerCode(code, exports, fnName, brand) {
   };
 }
 
-// src/vite/discovery/state.ts
-var VIRTUAL_ROUTES_MANIFEST_ID = "virtual:rsc-router/routes-manifest";
-function createDiscoveryState(entryPath, opts) {
-  return {
-    resolvedEntryPath: entryPath,
-    projectRoot: "",
-    isBuildMode: false,
-    userResolveAlias: void 0,
-    userRunnerConfig: void 0,
-    userResolvePlugins: [],
-    scanFilter: void 0,
-    cachedRouterFiles: void 0,
-    opts,
-    mergedRouteManifest: null,
-    perRouterManifests: [],
-    perRouterTrieMap: /* @__PURE__ */ new Map(),
-    perRouterPrecomputedMap: /* @__PURE__ */ new Map(),
-    perRouterManifestDataMap: /* @__PURE__ */ new Map(),
-    clientUrlSourceByReferenceId: /* @__PURE__ */ new Map(),
-    clientUrlProjectionMap: /* @__PURE__ */ new Map(),
-    prerenderManifestEntries: null,
-    staticManifestEntries: null,
-    shellCandidates: null,
-    prerenderPayloadValues: null,
-    shellPhaseTempServer: null,
-    handlerChunkInfoMap: /* @__PURE__ */ new Map(),
-    staticHandlerChunkInfoMap: /* @__PURE__ */ new Map(),
-    rscEntryFileName: null,
-    resolvedPrerenderModules: void 0,
-    resolvedStaticModules: void 0,
-    discoveryDone: null,
-    devDiscoveryEpoch: opts?.preset === "cloudflare" ? Date.now() : void 0,
-    devServerOrigin: null,
-    devServer: null,
-    selfWrittenGenFiles: /* @__PURE__ */ new Map(),
-    SELF_WRITE_WINDOW_MS: 5e3,
-    lastDiscoveryError: null
-  };
-}
-
 // src/vite/discovery/self-gen-tracking.ts
-import { createHash as createHash3 } from "node:crypto";
+import { createHash as createHash4 } from "node:crypto";
 import { readFileSync as readFileSync4 } from "node:fs";
 function markSelfGenWrite(state, filePath, content) {
-  const hash = createHash3("sha256").update(content).digest("hex");
+  const hash = createHash4("sha256").update(content).digest("hex");
   state.selfWrittenGenFiles.set(filePath, { at: Date.now(), hash });
 }
 function consumeSelfGenWrite(state, filePath) {
@@ -7326,7 +8052,7 @@ function checkSelfGenWrite(state, filePath, consume) {
   }
   try {
     const current = readFileSync4(filePath, "utf-8");
-    const currentHash = createHash3("sha256").update(current).digest("hex");
+    const currentHash = createHash4("sha256").update(current).digest("hex");
     if (currentHash === info.hash) {
       if (consume) state.selfWrittenGenFiles.delete(filePath);
       return true;
@@ -7820,7 +8546,7 @@ function contextSet(variables, keyOrVar, value, options) {
 }
 
 // src/vite/utils/prerender-utils.ts
-import { createHash as createHash4 } from "node:crypto";
+import { createHash as createHash5 } from "node:crypto";
 import {
   copyFileSync,
   existsSync as existsSync6,
@@ -7984,15 +8710,16 @@ function resolvePrerenderError(registry, error, onError, label, elapsed, phase,
   notifyOnError(registry, error, phase, routeKey, pathname);
   throw error;
 }
+var RANGO_BUILD_DIR = "node_modules/.rangojs-router-build";
 function getStagedAssetDir(projectRoot) {
-  return resolve7(projectRoot, "node_modules/.rangojs-router-build/rsc-assets");
+  return resolve7(projectRoot, RANGO_BUILD_DIR, "rsc-assets");
 }
 function resetStagedBuildAssets(projectRoot) {
   rmSync(getStagedAssetDir(projectRoot), { recursive: true, force: true });
 }
 function writeBuildAssetModule(dir, prefix, exportValue) {
   mkdirSync(dir, { recursive: true });
-  const contentHash = createHash4("sha256").update(exportValue).digest("hex").slice(0, 8);
+  const contentHash = createHash5("sha256").update(exportValue).digest("hex").slice(0, 8);
   const fileName = `${prefix}-${contentHash}.js`;
   const filePath = resolve7(dir, fileName);
   if (!existsSync6(filePath)) {
@@ -8025,6 +8752,14 @@ function copyStagedBuildAssets(projectRoot, fileNames) {
 // src/vite/discovery/prerender-collection.ts
 init_debug();
 var debug9 = createRangoDebugger(NS.prerender);
+function recordBuildData(state, kind, key, value, owner) {
+  state.buildData.push({
+    kind,
+    key,
+    digest: sha256(value),
+    ...owner
+  });
+}
 async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
   if (!state.opts?.enableBuildPrerender || !state.isBuildMode) return;
   const overallStart = debug9 ? performance.now() : 0;
@@ -8201,7 +8936,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
       group.concurrency,
       async (entry) => {
         const startUrl = performance.now();
-        for (const [, routerInstance] of registry) {
+        for (const [routerId2, routerInstance] of registry) {
           if (!routerInstance.matchForPrerender) continue;
           try {
             const result = await routerInstance.matchForPrerender(
@@ -8231,6 +8966,9 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
               "__pr",
               mainValue
             );
+            recordBuildData(state, "prerender", mainKey, mainValue, {
+              routerId: routerId2
+            });
             if (result.ppr !== void 0 && result.ppr !== false) {
               (state.shellCandidates ??= []).push({
                 urlPath: entry.urlPath,
@@ -8256,6 +8994,15 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
                 "__pr",
                 interceptValue
               );
+              recordBuildData(
+                state,
+                "prerender",
+                interceptKey,
+                interceptValue,
+                {
+                  routerId: routerId2
+                }
+              );
             }
             const elapsed = (performance.now() - startUrl).toFixed(0);
             console.log(
@@ -8358,6 +9105,9 @@ async function renderStaticHandlers(state, rscEnv, registry) {
               "__st",
               exportValue
             );
+            recordBuildData(state, "static", def.$$id, exportValue, {
+              moduleId
+            });
             const elapsed = (performance.now() - startHandler).toFixed(0);
             console.log(`[rango]   OK   ${name.padEnd(40)} (${elapsed}ms)`);
             staticDone++;
@@ -8504,8 +9254,8 @@ init_client_ref_hashing();
 
 // src/vite/discovery/client-urls-projection.ts
 import { existsSync as existsSync7, readFileSync as readFileSync5 } from "node:fs";
-import { isAbsolute as isAbsolute3, relative as relative4, resolve as resolve8 } from "node:path";
-import { normalizePath as normalizePath5, parseAst as parseAst6 } from "vite";
+import { isAbsolute as isAbsolute3, relative as relative5, resolve as resolve8 } from "node:path";
+import { normalizePath as normalizePath5, parseAst as parseAst7 } from "vite";
 
 // src/client-urls/server-projection.ts
 import * as React5 from "react";
@@ -8519,7 +9269,7 @@ function isUnderTestRunner() {
 import {
   Component as Component3,
   createElement as createElement3,
-  useContext as useContext16,
+  useContext as useContext17,
   useMemo as useMemo8,
   Suspense as Suspense2
 } from "react";
@@ -8531,6 +9281,7 @@ import {
   useEffect,
   useRef,
   useOptimistic,
+  useSyncExternalStore,
   startTransition
 } from "react";
 
@@ -8607,6 +9358,11 @@ function createHandle(collect, __injectedId) {
 // src/browser/react/context.ts
 import { createContext } from "react";
 var NavigationStoreContext = createContext(null);
+var LocationStateContext = createContext(void 0);
+
+// src/browser/react/subscribe-to-nothing.ts
+var subscribeToNothing = () => () => {
+};
 
 // src/handles/meta.ts
 function isUnsetDescriptor(descriptor) {
@@ -9375,7 +10131,7 @@ import {
   useEffect as useEffect14,
   useMemo as useMemo7,
   useRef as useRef12,
-  useSyncExternalStore
+  useSyncExternalStore as useSyncExternalStore2
 } from "react";
 
 // src/browser/react/use-link-status.ts
@@ -9617,8 +10373,6 @@ function isPrefetchScopeDisabled(element) {
 // src/browser/react/Link.tsx
 init_loader();
 import { jsx as jsx8 } from "react/jsx-runtime";
-var IGNORE_STRATEGY_CHANGES = (_listener) => () => {
-};
 function isExternalUrl(href2, origin) {
   if (href2.startsWith("//")) return true;
   if (href2.startsWith("http://") || href2.startsWith("https://")) {
@@ -9660,8 +10414,8 @@ var Link = forwardRef(function Link2({
     return to === "/" ? bn : bn + to;
   }, [to, isExternal, ctx?.basename]);
   const configuredStrategy = prefetch ?? ctx?.defaultPrefetch ?? getDefaultPrefetchStrategy();
-  const resolvedStrategy = useSyncExternalStore(
-    configuredStrategy === "adaptive" ? subscribeToAdaptiveStrategyChange : IGNORE_STRATEGY_CHANGES,
+  const resolvedStrategy = useSyncExternalStore2(
+    configuredStrategy === "adaptive" ? subscribeToAdaptiveStrategyChange : subscribeToNothing,
     () => resolveAdaptiveStrategy(configuredStrategy),
     () => configuredStrategy === "adaptive" ? "hover" : configuredStrategy
   );
@@ -9848,7 +10602,7 @@ var Breadcrumbs = createHandle(
 );
 
 // src/browser/react/location-state.ts
-import { useState as useState14, useEffect as useEffect15, useRef as useRef13 } from "react";
+import { useContext as useContext16, useEffect as useEffect15, useSyncExternalStore as useSyncExternalStore3 } from "react";
 
 // src/href-client.ts
 function href(path6, mount) {
@@ -9995,7 +10749,7 @@ import {
   useDeferredValue,
   useEffect as useEffect16,
   useMemo as useMemo9,
-  useState as useState15
+  useState as useState14
 } from "react";
 
 // src/client-urls/navigation.ts
@@ -10181,7 +10935,7 @@ var debug10 = createRangoDebugger(NS.discovery);
 function hasDefaultExport(code) {
   let program;
   try {
-    program = parseAst6(code, { lang: "tsx" });
+    program = parseAst7(code, { lang: "tsx" });
   } catch {
     return false;
   }
@@ -10209,7 +10963,7 @@ function recordClientUrlsModule(state, code, id) {
   }
   const source = normalizeSource(state, id);
   const projectRoot = normalizePath5(resolve8(state.projectRoot));
-  const relativeId = normalizePath5(relative4(projectRoot, source));
+  const relativeId = normalizePath5(relative5(projectRoot, source));
   const outsideProject = relativeId === ".." || relativeId.startsWith("../") || isAbsolute3(relativeId);
   const devReferenceKey = outsideProject ? `/@fs${source}` : `/${relativeId}`;
   const sourceByReferenceId = state.clientUrlSourceByReferenceId ??= /* @__PURE__ */ new Map();
@@ -10544,7 +11298,7 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
   for (const [map2, fn] of perRouterSetters) {
     const setter = serverMod[fn];
     if (typeof setter !== "function") continue;
-    for (const [routerId, value] of map2) setter(routerId, value);
+    for (const [routerId2, value] of map2) setter(routerId2, value);
   }
   await expandPrerenderRoutes(state, rscEnv, registry, allManifests);
   await renderStaticHandlers(state, rscEnv, registry);
@@ -10552,20 +11306,337 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
 }
 
 // src/vite/discovery/shell-prerender-phase.ts
-import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join5, resolve as resolve9 } from "node:path";
+import { existsSync as existsSync9, readdirSync as readdirSync4, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join7, resolve as resolve10 } from "node:path";
 
 // src/prerender/shell-manifest-key.ts
 function buildShellManifestKey(pathname) {
   return pathname;
 }
 
+// src/vite/discovery/router-versions-phase.ts
+import { randomUUID } from "node:crypto";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync7, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname4, join as join6, resolve as resolve9 } from "node:path";
+init_debug();
+
+// src/vite/discovery/installed-packages.ts
+import { createHash as createHash6 } from "node:crypto";
+import {
+  existsSync as existsSync8,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync6,
+  realpathSync,
+  statSync as statSync2
+} from "node:fs";
+import { dirname as dirname3, join as join5, sep as sep2 } from "node:path";
+function linkTarget(path6) {
+  try {
+    return statSync2(path6);
+  } catch {
+    return void 0;
+  }
+}
+function digestDirectory(dir) {
+  const hash = createHash6("sha256");
+  const entered = /* @__PURE__ */ new Set();
+  const visit = (current, prefix) => {
+    const real = realpathSync(current);
+    if (entered.has(real)) return;
+    entered.add(real);
+    const entries = readdirSync3(current, { withFileTypes: true }).sort(
+      (a, b) => compareStrings(a.name, b.name)
+    );
+    for (const entry of entries) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
+      const path6 = join5(current, entry.name);
+      const name = `${prefix}${entry.name}`;
+      const kind = entry.isSymbolicLink() ? linkTarget(path6) : entry;
+      if (kind?.isDirectory()) {
+        visit(path6, `${name}/`);
+      } else if (kind?.isFile()) {
+        const bytes = readFileSync6(path6);
+        hash.update(`${name}\0${bytes.byteLength}\0`);
+        hash.update(bytes);
+      }
+    }
+  };
+  visit(dir, "");
+  return hash.digest("hex");
+}
+function findPackageDir(name, from) {
+  for (let dir = from; ; ) {
+    const candidate = join5(dir, "node_modules", name);
+    if (existsSync8(join5(candidate, "package.json"))) {
+      return realpathSync(candidate);
+    }
+    const parent = dirname3(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function createInstalledPackageDescriber(projectRoot) {
+  const packages = /* @__PURE__ */ new Map();
+  const read = (dir) => {
+    if (packages.has(dir)) return packages.get(dir);
+    let manifest;
+    try {
+      manifest = JSON.parse(readFileSync6(join5(dir, "package.json"), "utf-8"));
+    } catch {
+      packages.set(dir, void 0);
+      return void 0;
+    }
+    const linked = !dir.split(sep2).includes("node_modules");
+    const found = {
+      label: `${manifest.name}@${manifest.version}` + (linked ? ` files:${digestDirectory(dir)}` : ""),
+      dependencies: Object.keys({
+        ...manifest.dependencies,
+        ...manifest.optionalDependencies,
+        ...manifest.peerDependencies
+      })
+    };
+    packages.set(dir, found);
+    return found;
+  };
+  const located = /* @__PURE__ */ new Map();
+  const locate = (name, from) => {
+    const key = `${from}\0${name}`;
+    if (!located.has(key)) located.set(key, findPackageDir(name, from));
+    return located.get(key);
+  };
+  const described = /* @__PURE__ */ new Map();
+  return (name) => {
+    if (described.has(name)) return described.get(name);
+    const labels = /* @__PURE__ */ new Set();
+    const seen = /* @__PURE__ */ new Set();
+    const pending = [[name, projectRoot]];
+    while (pending.length > 0) {
+      const [dependency, from] = pending.pop();
+      const dir = locate(dependency, from);
+      if (dir === void 0 || seen.has(dir)) continue;
+      seen.add(dir);
+      const installed = read(dir);
+      if (!installed) continue;
+      labels.add(installed.label);
+      for (const next of installed.dependencies) pending.push([next, dir]);
+    }
+    const text = labels.size > 0 ? [...labels].sort().join("\n") : void 0;
+    described.set(name, text);
+    return text;
+  };
+}
+
+// src/vite/discovery/router-versions-phase.ts
+var debug12 = createRangoDebugger(NS.build);
+var ASSETS_MANIFEST_FILE = "__vite_rsc_assets_manifest.js";
+var EMPTY_SERVER_RESOURCES = /"serverResources":\s*\{\s*\}/;
+function environmentOutDir(builder, projectRoot, environment) {
+  return resolve9(
+    projectRoot,
+    builder?.environments?.[environment]?.config?.build?.outDir ?? join6("dist", environment)
+  );
+}
+var VERSIONS_REPORT_FILE = `${RANGO_BUILD_DIR}/cache-versions.json`;
+function readIfPresent(path6) {
+  try {
+    return readFileSync7(path6);
+  } catch (err) {
+    if (err?.code === "ENOENT") return void 0;
+    throw err;
+  }
+}
+function readServerResources(manifest) {
+  if (EMPTY_SERVER_RESOURCES.test(manifest)) return /* @__PURE__ */ new Map();
+  const entries = literalProperties(
+    defaultExportProperties(manifest)?.find(
+      (property) => property.key === "serverResources"
+    )?.value
+  );
+  if (!entries) {
+    throw new Error(
+      `${ASSETS_MANIFEST_FILE} has no serverResources object literal: the installed @vitejs/plugin-rsc writes a manifest @rangojs/router cannot read. Report it with the plugin-rsc version.`
+    );
+  }
+  return new Map(
+    entries.map((entry) => [
+      entry.key,
+      manifest.slice(entry.value.start, entry.value.end)
+    ])
+  );
+}
+function clientUrlRecords(s) {
+  const projectionOf = /* @__PURE__ */ new Map();
+  for (const [referenceId2, projection] of s.clientUrlProjectionMap ?? []) {
+    projectionOf.set(
+      s.clientUrlSourceByReferenceId?.get(referenceId2) ?? referenceId2,
+      JSON.stringify(projection)
+    );
+  }
+  return [...projectionOf].map(([source, projection]) => ({
+    kind: "client-urls",
+    key: portableModuleId(source, s.projectRoot),
+    digest: sha256(projection),
+    moduleId: source
+  }));
+}
+function writeVersionsReport(projectRoot, computed, sourceOf) {
+  const routers = {};
+  for (const detail of computed.details) {
+    routers[detail.routerId] = {
+      source: sourceOf.get(detail.routerId) ?? "",
+      data: detail.data,
+      document: detail.document,
+      dataInputs: Object.fromEntries(detail.dataInputs),
+      documentInputs: Object.fromEntries(detail.documentInputs)
+    };
+  }
+  const report = {
+    routers,
+    ssrAndClient: {
+      base: computed.ssrAndClient.base,
+      ssr: Object.fromEntries(computed.ssrAndClient.ssr),
+      externals: Object.fromEntries(computed.ssrAndClient.externals),
+      client: computed.ssrAndClient.client
+    },
+    unownedFiles: computed.unownedFiles
+  };
+  try {
+    const path6 = resolve9(projectRoot, VERSIONS_REPORT_FILE);
+    mkdirSync2(dirname4(path6), { recursive: true });
+    writeFileSync3(path6, JSON.stringify(report, null, 2) + "\n");
+  } catch (err) {
+    debug12?.("could not write %s: %s", VERSIONS_REPORT_FILE, err?.message);
+  }
+}
+function runRouterVersionsPhase(s, builder) {
+  if (!s.isBuildMode) return void 0;
+  const { serverBuildGraph: server, clientBuildGraph: client } = s;
+  const ssr = s.ssrBundle;
+  const rscVersionFiles = s.versionModuleFiles.get("rsc") ?? [];
+  if (!server || !client || !ssr || rscVersionFiles.length === 0) {
+    const missing = [
+      !server && "the RSC bundle",
+      !client && "the client bundle",
+      !ssr && "the SSR bundle",
+      rscVersionFiles.length === 0 && "the RSC chunk that holds the version module"
+    ].filter(Boolean);
+    throw new Error(
+      `[rango] The build did not record ${missing.join(", ")}, so the cache versions cannot be computed. This is a bug in @rangojs/router; please report it.`
+    );
+  }
+  const start = performance.now();
+  const rscOutDir = environmentOutDir(builder, s.projectRoot, "rsc");
+  const ssrOutDir = environmentOutDir(builder, s.projectRoot, "ssr");
+  let computed;
+  try {
+    const assetsManifest = readIfPresent(join6(rscOutDir, ASSETS_MANIFEST_FILE));
+    if (assetsManifest === void 0) {
+      throw new Error(
+        `${ASSETS_MANIFEST_FILE} is not in the RSC output directory, so the stylesheets server components link cannot be read`
+      );
+    }
+    computed = computeRouterVersions({
+      projectRoot: s.projectRoot,
+      server,
+      client,
+      // plugin-rsc writes its manifest next to the SSR bundle, not into it.
+      ssr: {
+        chunks: ssr.chunks,
+        assets: [
+          ...ssr.assets.filter(
+            (asset) => asset.fileName !== ASSETS_MANIFEST_FILE
+          ),
+          { fileName: ASSETS_MANIFEST_FILE, name: ASSETS_MANIFEST_FILE }
+        ]
+      },
+      routers: s.perRouterManifests.map((entry) => ({
+        id: entry.id,
+        moduleId: entry.sourceFile
+      })),
+      buildData: [...s.buildData, ...clientUrlRecords(s)],
+      readServerFile: (fileName) => readIfPresent(join6(rscOutDir, fileName)),
+      readSsrFile: (fileName) => readIfPresent(join6(ssrOutDir, fileName)),
+      base: builder?.config?.base ?? "/",
+      serverResources: readServerResources(assetsManifest.toString("utf-8")),
+      externals: {
+        describePackage: createInstalledPackageDescriber(s.projectRoot),
+        readFile: readIfPresent,
+        buildId: randomUUID()
+      }
+    });
+  } catch (err) {
+    throw new Error(
+      `[rango] Could not compute the cache versions: ${err?.message ?? err}`,
+      { cause: err }
+    );
+  }
+  const { table, details } = computed;
+  for (const [environment, fileNames] of s.versionModuleFiles) {
+    const outDir = environmentOutDir(builder, s.projectRoot, environment);
+    let filled = 0;
+    for (const fileName of fileNames) {
+      const path6 = join6(outDir, fileName);
+      const source = readIfPresent(path6);
+      const next = source === void 0 ? void 0 : fillRouterVersions(source.toString("utf-8"), table);
+      if (next === void 0) continue;
+      writeFileSync3(path6, next);
+      filled++;
+    }
+    if (environment === "rsc" && filled === 0) {
+      throw new Error(
+        `[rango] Could not write the cache versions into the server build: no placeholder in ${fileNames.join(", ")} under ${outDir}. The build would fail to start. This is a bug in @rangojs/router; please report it.`
+      );
+    }
+  }
+  const elapsed = (performance.now() - start).toFixed(1);
+  const sourceOf = new Map(
+    s.perRouterManifests.map((entry) => [
+      entry.id,
+      entry.sourceFile ? portableModuleId(entry.sourceFile, s.projectRoot) : ""
+    ])
+  );
+  const detailOf = new Map(details.map((detail) => [detail.routerId, detail]));
+  const wholeBuild = detailOf.get(DEFAULT_ROUTER_VERSIONS_KEY);
+  let keyed = 0;
+  if (s.perRouterManifests.length > 0) {
+    console.log(
+      `[rango] Cache versions for ${s.perRouterManifests.length} router(s), data / document (${elapsed}ms):`
+    );
+    for (const { id } of s.perRouterManifests) {
+      const own = detailOf.get(id);
+      const detail = own ?? wholeBuild;
+      if (detail.usesEncryptionKey) keyed++;
+      console.log(
+        `[rango]   ${detail.data} / ${detail.document}  ${sourceOf.get(id) || id}${own ? "" : " (whole build)"}`
+      );
+    }
+  }
+  debug12?.(
+    "router versions: %d server file(s), %sms, table=%o",
+    server.chunks.length + server.assets.length,
+    elapsed,
+    table
+  );
+  writeVersionsReport(s.projectRoot, computed, sourceOf);
+  if (computed.undetermined.length > 0) {
+    console.log(
+      `[rango] ${computed.undetermined.length} import(s) the server build leaves external could not be read at build time (${computed.undetermined.join(", ")}): a package that is not installed where the build can find it, a path that does not resolve, or a URL. What they resolve to at run time is unknown, so the routers importing them get a new cache version on every build.`
+    );
+  }
+  if (keyed > 0 && !isEncryptionKeyStable()) {
+    console.log(
+      `[rango] No stable encryption key: ${keyed} router(s) encrypt server-action arguments with a key generated for this build, so their cache version changes on every build and each deploy clears their cache. To keep it, set rango({ encryptionKey: process.env.RANGO_ENCRYPTION_KEY }) with a base64 32-byte key (openssl rand -base64 32).`
+    );
+  }
+  return table;
+}
+
 // src/vite/discovery/shell-prerender-phase.ts
 init_debug();
-var debug12 = createRangoDebugger(NS.prerender);
-async function runShellPrerenderPhase(s, builder) {
+var debug13 = createRangoDebugger(NS.prerender);
+async function runShellPrerenderPhase(s, builder, versionsTable) {
   const tempServer = s.shellPhaseTempServer;
-  if (!s.isBuildMode || !s.shellCandidates?.length || !tempServer) return;
+  if (!versionsTable || !s.shellCandidates?.length || !tempServer) return;
   const candidates = s.shellCandidates;
   const startTotal = performance.now();
   console.log(`[rango] Shell-prerendering ${candidates.length} URL(s)...`);
@@ -10581,16 +11652,6 @@ async function runShellPrerenderPhase(s, builder) {
       );
       return;
     }
-    const versionPlugin = (builder?.config?.plugins ?? []).find(
-      (p) => p?.name === "@rangojs/router:version"
-    );
-    const buildVersion = versionPlugin?.api?.getBuildVersion?.();
-    if (!buildVersion) {
-      console.warn(
-        "[rango] shell prerender: main build version unavailable; skipping \u2014 routes keep runtime shell capture."
-      );
-      return;
-    }
     const payloads = s.prerenderPayloadValues ?? /* @__PURE__ */ new Map();
     const fetchedKeys = /* @__PURE__ */ new Set();
     globalThis.__loadPrerenderManifestModule = async () => ({
@@ -10608,9 +11669,9 @@ async function runShellPrerenderPhase(s, builder) {
     const htmlStream = await ssrRunner.import(
       "@rangojs/router/internal/deps/html-stream-server"
     );
-    const clientOutDir = builder?.environments?.client?.config?.build?.outDir ?? resolve9(s.projectRoot, "dist/client");
-    const clientAssetsDir = join5(clientOutDir, "assets");
-    const entryFile = existsSync8(clientAssetsDir) ? readdirSync3(clientAssetsDir).find((f) => /^index-.*\.js$/.test(f)) : void 0;
+    const clientOutDir = environmentOutDir(builder, s.projectRoot, "client");
+    const clientAssetsDir = join7(clientOutDir, "assets");
+    const entryFile = existsSync9(clientAssetsDir) ? readdirSync4(clientAssetsDir).find((f) => /^index-.*\.js$/.test(f)) : void 0;
     if (!entryFile) {
       console.warn(
         `[rango] shell prerender: built client entry not found under ${clientAssetsDir}; skipping \u2014 routes keep runtime shell capture.`
@@ -10620,7 +11681,7 @@ async function runShellPrerenderPhase(s, builder) {
     const base = builder?.config?.base ?? "/";
     const normalizedBase = base.endsWith("/") ? base : `${base}/`;
     const bootstrapContent = `import("${normalizedBase}assets/${entryFile}")`;
-    debug12?.("shell prerender bootstrap: %s", bootstrapContent);
+    debug13?.("shell prerender bootstrap: %s", bootstrapContent);
     const minimalPlugin = (tempServer.config?.plugins ?? []).find(
       (p) => p?.name === "rsc:minimal"
     );
@@ -10691,8 +11752,13 @@ async function runShellPrerenderPhase(s, builder) {
       const mainKey = `${cand.routeName}/${cand.paramHash}`;
       let handled = false;
       const mismatches = [];
-      for (const [, routerInstance] of registry) {
+      for (const [routerId2, routerInstance] of registry) {
         if (typeof routerInstance.match !== "function") continue;
+        const versions = resolveVersionsFrom(
+          versionsTable,
+          routerId2,
+          routerInstance.version
+        );
         try {
           const res = await captureMod.captureShellForBuild({
             router: routerInstance,
@@ -10705,9 +11771,9 @@ async function runShellPrerenderPhase(s, builder) {
             maxSnapshotBytes: policy.maxSnapshotBytes,
             captureTimeout: policy.captureTimeout,
             buildEnv: s.resolvedBuildEnv,
-            buildVersion,
+            versions,
             captureShellHTML,
-            debug: !!debug12
+            debug: !!debug13
           });
           if (res.outcome === "route-mismatch") {
             mismatches.push(res.matchedRouteName ?? "(no match)");
@@ -10760,8 +11826,11 @@ async function runShellPrerenderPhase(s, builder) {
       }
     }
     if (staged.length > 0) {
-      const rscOutDir = builder?.environments?.rsc?.config?.build?.outDir ?? resolve9(s.projectRoot, "dist/rsc");
-      writeShellManifest(s, rscOutDir, staged);
+      writeShellManifest(
+        s,
+        environmentOutDir(builder, s.projectRoot, "rsc"),
+        staged
+      );
     }
     const totalElapsed = (performance.now() - startTotal).toFixed(0);
     const parts = [`${staged.length} done`];
@@ -10780,14 +11849,14 @@ async function runShellPrerenderPhase(s, builder) {
   }
 }
 function writeShellManifest(s, rscOutDir, staged) {
-  const rscEntryPath = resolve9(rscOutDir, s.rscEntryFileName ?? "index.js");
-  if (!existsSync8(rscEntryPath)) {
+  const rscEntryPath = resolve10(rscOutDir, s.rscEntryFileName ?? "index.js");
+  if (!existsSync9(rscEntryPath)) {
     console.warn(
       `[rango] shell prerender: RSC entry not found at ${rscEntryPath}; entries not persisted \u2014 routes keep runtime capture.`
     );
     return;
   }
-  const assetsDir = resolve9(rscOutDir, "assets");
+  const assetsDir = resolve10(rscOutDir, "assets");
   let totalBytes = 0;
   const manifestMap = {};
   const countedFiles = /* @__PURE__ */ new Set();
@@ -10805,13 +11874,13 @@ function writeShellManifest(s, rscOutDir, staged) {
     `export default m;`,
     ""
   ].join("\n");
-  writeFileSync3(resolve9(rscOutDir, "__shell-manifest.js"), manifestCode);
+  writeFileSync4(resolve10(rscOutDir, "__shell-manifest.js"), manifestCode);
   totalBytes += Buffer.byteLength(manifestCode);
-  const rscCode = readFileSync6(rscEntryPath, "utf-8");
+  const rscCode = readFileSync8(rscEntryPath, "utf-8");
   if (!rscCode.includes("__shell-manifest.js")) {
     const injection = `globalThis.__loadShellManifestModule = () => import("./__shell-manifest.js");
 `;
-    writeFileSync3(rscEntryPath, injection + rscCode);
+    writeFileSync4(rscEntryPath, injection + rscCode);
   }
   const totalKB = (totalBytes / 1024).toFixed(1);
   console.log(
@@ -10857,8 +11926,8 @@ function createDevPrerenderCache(maxEntriesPerRouter = MAX_ENTRIES_PER_ROUTER) {
 }
 
 // src/vite/discovery/route-types-writer.ts
-import { dirname as dirname3, join as join6, resolve as resolve10 } from "node:path";
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync4, existsSync as existsSync9, unlinkSync as unlinkSync2 } from "node:fs";
+import { dirname as dirname5, join as join8, resolve as resolve11 } from "node:path";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync5, existsSync as existsSync10, unlinkSync as unlinkSync2 } from "node:fs";
 function filterUserNamedRoutes(manifest) {
   const filtered = {};
   for (const [name, pattern] of Object.entries(manifest)) {
@@ -10869,10 +11938,10 @@ function filterUserNamedRoutes(manifest) {
   return filtered;
 }
 function writeGenFileIfChanged(state, outPath, source, opts) {
-  const existing = existsSync9(outPath) ? readFileSync7(outPath, "utf-8") : null;
+  const existing = existsSync10(outPath) ? readFileSync9(outPath, "utf-8") : null;
   if (existing === source) return;
   markSelfGenWrite(state, outPath, source);
-  writeFileSync4(outPath, source);
+  writeFileSync5(outPath, source);
   if (opts?.log) console.log(`[rango] Generated route types -> ${outPath}`);
 }
 function writeCombinedRouteTypesWithTracking(state, opts) {
@@ -10886,11 +11955,11 @@ function writeCombinedRouteTypesWithTracking(state, opts) {
 function writeRouteTypesFiles(state) {
   if (state.perRouterManifests.length === 0) return;
   try {
-    const entryDir = dirname3(
-      resolve10(state.projectRoot, state.resolvedEntryPath)
+    const entryDir = dirname5(
+      resolve11(state.projectRoot, state.resolvedEntryPath)
     );
-    const oldCombinedPath = join6(entryDir, "named-routes.gen.ts");
-    if (existsSync9(oldCombinedPath)) {
+    const oldCombinedPath = join8(entryDir, "named-routes.gen.ts");
+    if (existsSync10(oldCombinedPath)) {
       unlinkSync2(oldCombinedPath);
       console.log(
         `[rango] Removed stale combined route types: ${oldCombinedPath}`
@@ -10971,8 +12040,8 @@ function supplementGenFilesWithRuntimeRoutes(state) {
 }
 
 // src/vite/discovery/virtual-module-codegen.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname4, basename, join as join7 } from "node:path";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname6, basename, join as join9 } from "node:path";
 var MANIFEST_EXTERNALIZE_THRESHOLD = 512 * 1024;
 var TRANSITION_WHEN_VALIDATION = `enableTransitionWhenValidation();`;
 function devDiscoveryBootstrap(state) {
@@ -10991,12 +12060,12 @@ function generateRoutesManifestModule(state) {
     let varIdx = 0;
     for (const entry of state.perRouterManifests) {
       if (entry.sourceFile) {
-        const routerDir = dirname4(entry.sourceFile);
+        const routerDir = dirname6(entry.sourceFile);
         const routerBasename = basename(entry.sourceFile).replace(
           /\.(tsx?|jsx?)$/,
           ""
         );
-        const genPath = join7(
+        const genPath = join9(
           routerDir,
           `${routerBasename}.named-routes.gen.js`
         ).replaceAll("\\", "/");
@@ -11030,7 +12099,10 @@ function generateRoutesManifestModule(state) {
     ];
     if (hasClientUrlModules) {
       lines2.push(`clearClientUrlProjections();`);
-      for (const [referenceId2, projection] of state.clientUrlProjectionMap ?? []) {
+      const projections = [...state.clientUrlProjectionMap ?? []].sort(
+        ([a], [b]) => compareStrings(a, b)
+      );
+      for (const [referenceId2, projection] of projections) {
         lines2.push(
           `setClientUrlProjection(${JSON.stringify(referenceId2)}, ${jsonParseExpression(projection)});`
         );
@@ -11062,9 +12134,9 @@ function generateRoutesManifestModule(state) {
       );
     }
     if (state.isBuildMode) {
-      for (const routerId of state.perRouterManifestDataMap.keys()) {
+      for (const routerId2 of state.perRouterManifestDataMap.keys()) {
         lines2.push(
-          `registerRouterManifestLoader(${JSON.stringify(routerId)}, () => import(${JSON.stringify(VIRTUAL_ROUTES_MANIFEST_ID + "/" + routerId)}));`
+          `registerRouterManifestLoader(${JSON.stringify(routerId2)}, () => import(${JSON.stringify(VIRTUAL_ROUTES_MANIFEST_ID + "/" + routerId2)}));`
         );
       }
     }
@@ -11101,17 +12173,17 @@ function shortHash(input) {
   }
   return (h >>> 0).toString(36);
 }
-function generatePerRouterModule(state, routerId) {
+function generatePerRouterModule(state, routerId2) {
   const sourceFile = state.perRouterManifests.find(
-    (e) => e.id === routerId
+    (e) => e.id === routerId2
   )?.sourceFile;
-  const trie = state.perRouterTrieMap.get(routerId);
-  const entries = state.perRouterPrecomputedMap.get(routerId);
+  const trie = state.perRouterTrieMap.get(routerId2);
+  const entries = state.perRouterPrecomputedMap.get(routerId2);
   const lines = [];
   if (sourceFile) {
-    const routerDir = dirname4(sourceFile);
+    const routerDir = dirname6(sourceFile);
     const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const genPath = join7(
+    const genPath = join9(
       routerDir,
       `${routerBasename}.named-routes.gen.js`
     ).replaceAll("\\", "/");
@@ -11125,11 +12197,11 @@ function generatePerRouterModule(state, routerId) {
   const payloadJson = hasTrie || hasEntries ? JSON.stringify(payload) : "";
   const useTextModule = state.isBuildMode && preset === "cloudflare" && override !== "0" && (hasTrie || hasEntries) && (override === "1" || payloadJson.length >= MANIFEST_EXTERNALIZE_THRESHOLD);
   if (useTextModule) {
-    const dir = join7(state.projectRoot, "node_modules", ".rango");
-    mkdirSync2(dir, { recursive: true });
-    const safeId = `${routerId.replace(/[^a-zA-Z0-9_-]/g, "_")}-${shortHash(routerId)}`;
-    const filePath = join7(dir, `manifest-${safeId}.txt`).replaceAll("\\", "/");
-    writeFileSync5(filePath, payloadJson);
+    const dir = join9(state.projectRoot, "node_modules", ".rango");
+    mkdirSync3(dir, { recursive: true });
+    const safeId = `${routerId2.replace(/[^a-zA-Z0-9_-]/g, "_")}-${shortHash(routerId2)}`;
+    const filePath = join9(dir, `manifest-${safeId}.txt`).replaceAll("\\", "/");
+    writeFileSync6(filePath, payloadJson);
     lines.push(`import __manifestJson from ${JSON.stringify(filePath)};`);
     lines.push(`const __manifestData = JSON.parse(__manifestJson);`);
     emitManifestExports(lines, hasTrie, hasEntries);
@@ -11158,13 +12230,13 @@ function emitManifestExports(lines, hasTrie, hasEntries) {
 }
 
 // src/vite/discovery/bundle-postprocess.ts
-import { resolve as resolve11 } from "node:path";
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync10 } from "node:fs";
+import { resolve as resolve12 } from "node:path";
+import { readFileSync as readFileSync10, writeFileSync as writeFileSync7, existsSync as existsSync11 } from "node:fs";
 function postprocessBundle(state) {
   const hasPrerenderData = state.prerenderManifestEntries && Object.keys(state.prerenderManifestEntries).length > 0;
   const hasStaticData = state.staticManifestEntries && Object.keys(state.staticManifestEntries).length > 0;
   if (!hasPrerenderData && !hasStaticData) return;
-  const rscEntryPath = resolve11(
+  const rscEntryPath = resolve12(
     state.projectRoot,
     "dist/rsc",
     state.rscEntryFileName ?? "index.js"
@@ -11185,9 +12257,9 @@ function postprocessBundle(state) {
   ];
   for (const target of evictionTargets) {
     for (const info of target.infos) {
-      const chunkPath = resolve11(state.projectRoot, "dist/rsc", info.fileName);
+      const chunkPath = resolve12(state.projectRoot, "dist/rsc", info.fileName);
       try {
-        const code = readFileSync8(chunkPath, "utf-8");
+        const code = readFileSync10(chunkPath, "utf-8");
         const result = evictHandlerCode(
           code,
           info.exports,
@@ -11195,7 +12267,7 @@ function postprocessBundle(state) {
           target.brand
         );
         if (result) {
-          writeFileSync6(chunkPath, result.code);
+          writeFileSync7(chunkPath, result.code);
           const savedKB = (result.savedBytes / 1024).toFixed(1);
           console.log(
             `[rango] Evicted ${target.label} (${savedKB} KB saved): ${info.fileName}`
@@ -11210,8 +12282,8 @@ function postprocessBundle(state) {
   }
   state.handlerChunkInfoMap.clear();
   state.staticHandlerChunkInfoMap.clear();
-  if (hasPrerenderData && existsSync10(rscEntryPath)) {
-    const rscCode = readFileSync8(rscEntryPath, "utf-8");
+  if (hasPrerenderData && existsSync11(rscEntryPath)) {
+    const rscCode = readFileSync10(rscEntryPath, "utf-8");
     if (!rscCode.includes("__prerender-manifest.js")) {
       try {
         let totalBytes = copyStagedBuildAssets(
@@ -11230,15 +12302,15 @@ function postprocessBundle(state) {
           `export default m;`,
           ""
         ].join("\n");
-        const manifestPath = resolve11(
+        const manifestPath = resolve12(
           state.projectRoot,
           "dist/rsc/__prerender-manifest.js"
         );
-        writeFileSync6(manifestPath, manifestCode);
+        writeFileSync7(manifestPath, manifestCode);
         totalBytes += Buffer.byteLength(manifestCode);
         const injection = `globalThis.__loadPrerenderManifestModule = () => import("./__prerender-manifest.js");
 `;
-        writeFileSync6(rscEntryPath, injection + rscCode);
+        writeFileSync7(rscEntryPath, injection + rscCode);
         const totalKB = (totalBytes / 1024).toFixed(1);
         console.log(
           `[rango] Wrote prerender assets (${totalKB} KB total, ${Object.keys(state.prerenderManifestEntries).length} entries)`
@@ -11250,8 +12322,8 @@ function postprocessBundle(state) {
       }
     }
   }
-  if (hasStaticData && existsSync10(rscEntryPath)) {
-    const rscCode = readFileSync8(rscEntryPath, "utf-8");
+  if (hasStaticData && existsSync11(rscEntryPath)) {
+    const rscCode = readFileSync10(rscEntryPath, "utf-8");
     if (!rscCode.includes("__static-manifest.js")) {
       try {
         const manifestEntries = [];
@@ -11268,15 +12340,15 @@ function postprocessBundle(state) {
         }
         const manifestCode = `const m={${manifestEntries.join(",")}};globalThis.__STATIC_MANIFEST=m;export default m;
 `;
-        const manifestPath = resolve11(
+        const manifestPath = resolve12(
           state.projectRoot,
           "dist/rsc/__static-manifest.js"
         );
-        writeFileSync6(manifestPath, manifestCode);
+        writeFileSync7(manifestPath, manifestCode);
         totalBytes += Buffer.byteLength(manifestCode);
         const injection = `globalThis.__loadStaticManifestModule = () => import("./__static-manifest.js");
 `;
-        writeFileSync6(rscEntryPath, injection + rscCode);
+        writeFileSync7(rscEntryPath, injection + rscCode);
         const totalKB = (totalBytes / 1024).toFixed(1);
         console.log(
           `[rango] Wrote static assets (${totalKB} KB total, ${Object.keys(state.staticManifestEntries).length} entries)`
@@ -11291,7 +12363,7 @@ function postprocessBundle(state) {
 }
 
 // src/vite/discovery/gate-state.ts
-function createDiscoveryGate(s, debug13) {
+function createDiscoveryGate(s, debug14) {
   let gatePending = false;
   let gateResolver = () => {
   };
@@ -11300,15 +12372,15 @@ function createDiscoveryGate(s, debug13) {
   let pendingEvents = false;
   const beginGate = () => {
     if (gatePending) return;
-    s.discoveryDone = new Promise((resolve14) => {
-      gateResolver = resolve14;
+    s.discoveryDone = new Promise((resolve15) => {
+      gateResolver = resolve15;
     });
     gatePending = true;
   };
   const resolveGate = () => {
     if (!gatePending) return;
     if (inProgress || queued2 || pendingEvents) {
-      debug13?.(
+      debug14?.(
         "hmr: resolveGate deferred \u2014 work in flight (inProgress=%s queued=%s pendingEvents=%s)",
         inProgress,
         queued2,
@@ -11317,7 +12389,7 @@ function createDiscoveryGate(s, debug13) {
       return;
     }
     gatePending = false;
-    debug13?.("hmr: discoveryDone resolved");
+    debug14?.("hmr: discoveryDone resolved");
     gateResolver();
   };
   const noteRouteEvent = () => {
@@ -11327,7 +12399,7 @@ function createDiscoveryGate(s, debug13) {
   const runRefreshCycle = async (work) => {
     if (inProgress) {
       queued2 = true;
-      debug13?.("hmr: rediscovery in flight \u2014 queued for a follow-up cycle");
+      debug14?.("hmr: rediscovery in flight \u2014 queued for a follow-up cycle");
       return;
     }
     pendingEvents = false;
@@ -11338,16 +12410,16 @@ function createDiscoveryGate(s, debug13) {
       inProgress = false;
       if (queued2) {
         queued2 = false;
-        debug13?.("hmr: consuming queued rediscovery");
+        debug14?.("hmr: consuming queued rediscovery");
         runRefreshCycle(work).catch((err) => {
-          debug13?.(
+          debug14?.(
             "hmr: queued cycle rejected \u2014 releasing gate (%s)",
             err instanceof Error ? err.message : String(err)
           );
           resolveGate();
         });
       } else if (pendingEvents) {
-        debug13?.(
+        debug14?.(
           "hmr: holding gate for pending events (debounce not yet fired)"
         );
       } else {
@@ -11393,15 +12465,15 @@ function selectForwardableResolvePlugins(plugins) {
 }
 function pickForwardedRunnerConfig(config) {
   const r = config.resolve ?? {};
-  const resolve14 = {};
-  if (r.alias !== void 0) resolve14.alias = r.alias;
-  if (r.dedupe !== void 0) resolve14.dedupe = r.dedupe;
-  if (r.conditions !== void 0) resolve14.conditions = r.conditions;
-  if (r.mainFields !== void 0) resolve14.mainFields = r.mainFields;
-  if (r.extensions !== void 0) resolve14.extensions = r.extensions;
+  const resolve15 = {};
+  if (r.alias !== void 0) resolve15.alias = r.alias;
+  if (r.dedupe !== void 0) resolve15.dedupe = r.dedupe;
+  if (r.conditions !== void 0) resolve15.conditions = r.conditions;
+  if (r.mainFields !== void 0) resolve15.mainFields = r.mainFields;
+  if (r.extensions !== void 0) resolve15.extensions = r.extensions;
   if (r.preserveSymlinks !== void 0)
-    resolve14.preserveSymlinks = r.preserveSymlinks;
-  if (r.tsconfigPaths !== void 0) resolve14.tsconfigPaths = r.tsconfigPaths;
+    resolve15.preserveSymlinks = r.preserveSymlinks;
+  if (r.tsconfigPaths !== void 0) resolve15.tsconfigPaths = r.tsconfigPaths;
   const userOxc = config.oxc;
   const userJsx = userOxc && typeof userOxc === "object" && typeof userOxc.jsx === "object" && userOxc.jsx !== null ? userOxc.jsx : {};
   const oxc = userOxc && typeof userOxc === "object" ? {
@@ -11409,7 +12481,7 @@ function pickForwardedRunnerConfig(config) {
     jsx: { ...userJsx, runtime: "automatic", importSource: "react" }
   } : { jsx: { runtime: "automatic", importSource: "react" } };
   return {
-    resolve: resolve14,
+    resolve: resolve15,
     define: config.define,
     oxc
   };
@@ -11531,6 +12603,26 @@ async function createTempRscServer(state, options = {}) {
     ]
   });
 }
+var WRANGLER_CONFIG_NAMES = [
+  "wrangler.json",
+  "wrangler.jsonc",
+  "wrangler.toml"
+];
+function wranglerProxyOptions(root) {
+  const viteRoot = resolve13(root);
+  for (let dir = viteRoot; ; dir = dirname7(dir)) {
+    for (const name of WRANGLER_CONFIG_NAMES) {
+      const configPath = join10(dir, name);
+      if (existsSync12(configPath)) {
+        return {
+          configPath,
+          persist: { path: join10(viteRoot, ".wrangler", "state", "v3") }
+        };
+      }
+    }
+    if (dirname7(dir) === dir) return void 0;
+  }
+}
 async function resolveBuildEnv(option, factoryCtx) {
   if (!option) return null;
   if (option === "auto") {
@@ -11541,11 +12633,13 @@ async function resolveBuildEnv(option, factoryCtx) {
     }
     try {
       const userRequire = createRequire3(
-        resolve12(factoryCtx.root, "package.json")
+        resolve13(factoryCtx.root, "package.json")
       );
       const wranglerPath = userRequire.resolve("wrangler");
       const { getPlatformProxy } = await import(pathToFileURL2(wranglerPath).href);
-      const proxy = await getPlatformProxy();
+      const proxy = await getPlatformProxy(
+        wranglerProxyOptions(factoryCtx.root)
+      );
       return {
         env: proxy.env,
         dispose: proxy.dispose
@@ -11583,6 +12677,7 @@ function resetPrerenderCollection(s) {
   s.staticManifestEntries = null;
   s.shellCandidates = null;
   s.prerenderPayloadValues = null;
+  s.buildData = [];
 }
 async function releaseBuildEnv(s) {
   if (s.buildEnvDispose) {
@@ -11727,8 +12822,8 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
       }
       server.middlewares.use(internalDebugNoCacheMiddleware());
       let resolveDiscovery;
-      const discoveryPromise = new Promise((resolve14) => {
-        resolveDiscovery = resolve14;
+      const discoveryPromise = new Promise((resolve15) => {
+        resolveDiscovery = resolve15;
       });
       const gate = createDiscoveryGate(s, debugDiscovery);
       const beginDiscoveryGate = gate.beginGate;
@@ -12027,7 +13122,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
         for (const [map2, fn] of perRouterSetters) {
           const setter = serverMod[fn];
           if (typeof setter !== "function") continue;
-          for (const [routerId, value] of map2) setter(routerId, value);
+          for (const [routerId2, value] of map2) setter(routerId2, value);
         }
       };
       server.middlewares.use("/__rsc_prerender", async (req, res) => {
@@ -12310,7 +13405,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
               maxSnapshotBytes,
               captureTimeout,
               buildEnv: s.resolvedBuildEnv,
-              buildVersion: version,
+              versions: uniformVersions(version),
               captureShellHTML: ssrModule.captureShellHTML,
               debug: !!debugDiscovery
             });
@@ -12495,7 +13590,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
               if (devServerClosed || expectedEpoch !== s.devDiscoveryEpoch) {
                 return;
               }
-              await new Promise((resolve14) => setTimeout(resolve14, 25));
+              await new Promise((resolve15) => setTimeout(resolve15, 25));
               if (devServerClosed || expectedEpoch !== s.devDiscoveryEpoch) {
                 return;
               }
@@ -12613,7 +13708,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
           }
           const inRecoveryMode = !!s.lastDiscoveryError;
           try {
-            const source = readFileSync9(filePath, "utf-8");
+            const source = readFileSync11(filePath, "utf-8");
             const trimmed = source.trimStart();
             const isUseClient = trimmed.startsWith('"use client"') || trimmed.startsWith("'use client'");
             let hasClientUrls = source.includes("clientUrls(");
@@ -12655,11 +13750,11 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
               if (rscGraph?.getModulesByFile) {
                 const routerSourceFiles = /* @__PURE__ */ new Set();
                 if (s.resolvedEntryPath) {
-                  routerSourceFiles.add(resolve12(s.resolvedEntryPath));
+                  routerSourceFiles.add(resolve13(s.resolvedEntryPath));
                 }
                 for (const entry of s.perRouterManifests) {
                   if (entry.sourceFile) {
-                    routerSourceFiles.add(resolve12(entry.sourceFile));
+                    routerSourceFiles.add(resolve13(entry.sourceFile));
                   }
                 }
                 const seen = /* @__PURE__ */ new Set();
@@ -12688,7 +13783,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
             if (hasCreateRouter) {
               const nestedRouterConflict = findNestedRouterConflict([
                 ...s.cachedRouterFiles ?? [],
-                resolve12(filePath)
+                resolve13(filePath)
               ]);
               if (nestedRouterConflict) {
                 server.config.logger.error(
@@ -12811,18 +13906,27 @@ ${details}`,
         );
       }
     },
-    // Post-build PPR shell capture (producer B, #699): runs after EVERY
-    // environment bundle is written — the shell prelude embeds built client
-    // asset URLs (bootstrap entry), which do not exist at buildStart. The
-    // kept temp server and the buildEnv were deferred AS A PAIR in
-    // buildStart's finally; this finally is the pair's success-path owner
-    // (buildEnd below owns the aborted-build path) — the phase itself is a
-    // pure producer and tears down only the globals it installs.
+    // Post-build phases, after EVERY environment bundle is written.
+    //
+    // 1. Cache versions (discovery/router-versions-phase.ts): hashes the
+    //    server output as postprocessBundle left it and writes the per-router
+    //    table into the built version module. First, because phase 2 stamps
+    //    its entries with these versions and reads the same RSC out dir.
+    // 2. PPR shell capture (producer B, #699): the shell prelude embeds built
+    //    client asset URLs (bootstrap entry), which do not exist at
+    //    buildStart. The kept temp server and the buildEnv were deferred AS A
+    //    PAIR in buildStart's finally; this finally is the pair's success-path
+    //    owner (buildEnd below owns the aborted-build path) — the phase itself
+    //    is a pure producer and tears down only the globals it installs.
     buildApp: {
       order: "post",
       async handler(builder) {
         try {
-          await runShellPrerenderPhase(s, builder);
+          await runShellPrerenderPhase(
+            s,
+            builder,
+            runRouterVersionsPhase(s, builder)
+          );
         } finally {
           if (s.isBuildMode) {
             const tempServer = s.shellPhaseTempServer;
@@ -12911,11 +14015,11 @@ ${details}`,
             () => s.discoveryDone
           );
         }
-        const routerId = id.slice(perRouterPrefix.length);
+        const routerId2 = id.slice(perRouterPrefix.length);
         const code = await timed(
           debugRoutes,
-          `generatePerRouterModule ${routerId}`,
-          () => generatePerRouterModule(s, routerId)
+          `generatePerRouterModule ${routerId2}`,
+          () => generatePerRouterModule(s, routerId2)
         );
         return code;
       }
@@ -12924,6 +14028,19 @@ ${details}`,
     // Record handler chunk metadata and RSC entry filename during RSC build.
     // Used by closeBundle for handler code eviction and prerender data injection.
     generateBundle(_options, bundle) {
+      if (s.isBuildMode) {
+        const envName = this.environment?.name;
+        if (envName) {
+          s.versionModuleFiles.set(envName, recordVersionModuleFiles(bundle));
+        }
+        if (envName === "rsc") {
+          s.serverBuildGraph = recordServerGraph(this, bundle);
+        } else if (envName === "client") {
+          s.clientBuildGraph = recordClientGraph(this, bundle);
+        } else if (envName === "ssr") {
+          s.ssrBundle = recordBundleFiles(bundle);
+        }
+      }
       if (this.environment?.name !== "rsc") return;
       const genStart = debugBuild ? performance.now() : 0;
       for (const [fileName, chunk] of Object.entries(bundle)) {
@@ -13013,10 +14130,12 @@ ${details}`,
 init_debug();
 var debugConfig = createRangoDebugger(NS.config);
 var SERVER_BUILD_TARGET = "esnext";
+var RSC_ENTRY_SIGNATURES = "strict";
 async function rango(options) {
   const rangoStart = performance.now();
   const resolvedOptions = options ?? { preset: "node" };
   const preset = resolvedOptions.preset ?? "node";
+  configureEncryptionKey(resolvedOptions.encryptionKey);
   const showBanner = resolvedOptions.banner ?? true;
   const clientChunksOption = resolvedOptions.clientChunks ?? true;
   const useBuiltInClientChunks = clientChunksOption === true;
@@ -13160,14 +14279,14 @@ async function rango(options) {
       name: "@rangojs/router:auto-discover",
       config(userConfig) {
         if (routerRef.path) return;
-        const root = userConfig.root ? resolve13(process.cwd(), userConfig.root) : process.cwd();
+        const root = userConfig.root ? resolve14(process.cwd(), userConfig.root) : process.cwd();
         const toRootRelative = (abs) => (abs.startsWith(root) ? "./" + abs.slice(root.length + 1) : abs).replaceAll("\\", "/");
         const bulletList = (files) => files.map((f) => "  - " + toRootRelative(f)).join("\n");
         if (explicitHostRouter) {
           routerRef.path = normalizeHostRouterEntry(
             explicitHostRouter,
             root,
-            existsSync11
+            existsSync13
           );
           routerRef.kind = "host";
           return;
@@ -13287,7 +14406,10 @@ If this is a multi-app host router, export a createHostRouter() instance and set
             rsc: {
               ...vercelServerEnv ?? {},
               build: {
-                target: SERVER_BUILD_TARGET
+                target: SERVER_BUILD_TARGET,
+                rollupOptions: {
+                  preserveEntrySignatures: RSC_ENTRY_SIGNATURES
+                }
               },
               optimizeDeps: {
                 entries: [VIRTUAL_IDS.rsc],
@@ -13349,6 +14471,8 @@ If this is a multi-app host router, export a createHostRouter() instance and set
     );
     plugins.push(clientRefDedup());
   }
+  plugins.push(clientChunksReport());
+  plugins.push(stableRscOutput());
   plugins.push({
     name: "@rangojs/router:client-component-hmr",
     hotUpdate(ctx) {
@@ -13358,7 +14482,7 @@ If this is a multi-app host router, export a createHostRouter() instance and set
       if (!file.endsWith(".tsx") && !file.endsWith(".ts") && !file.endsWith(".jsx") && !file.endsWith(".js"))
         return;
       try {
-        const source = readFileSync10(file, "utf-8");
+        const source = readFileSync12(file, "utf-8");
         if (hasUseClientDirective2(source)) {
           return [];
         }
@@ -13381,7 +14505,7 @@ If this is a multi-app host router, export a createHostRouter() instance and set
   const discoveryEntryPath = preset !== "cloudflare" ? routerRef.path : void 0;
   const discoveryRouterRef = preset !== "cloudflare" ? routerRef : void 0;
   if (preset === "cloudflare") {
-    plugins.push(createVersionInjectorPlugin(void 0));
+    plugins.push(createEntryBootstrapInjectorPlugin(void 0));
   }
   plugins.push(createCjsToEsmPlugin());
   plugins.push(
@@ -13418,7 +14542,7 @@ function poke() {
     apply: "serve",
     configureServer(server) {
       const stdin = process.stdin;
-      const debug13 = process.env.RANGO_POKE_DEBUG === "1";
+      const debug14 = process.env.RANGO_POKE_DEBUG === "1";
       const triggerReload = (source) => {
         server.hot.send({ type: "full-reload", path: "*" });
         server.config.logger.info(`  browser reload (${source})`, {
@@ -13451,7 +14575,7 @@ function poke() {
         lines.pop();
         return lines;
       };
-      if (debug13) {
+      if (debug14) {
         server.config.logger.info(
           `  poke debug enabled (isTTY=${stdin.isTTY ? "yes" : "no"}, isRaw=${stdin.isTTY ? stdin.isRaw ? "yes" : "no" : "n/a"})`,
           { timestamp: true }
@@ -13464,7 +14588,7 @@ function poke() {
         );
       }
       const onData = (data) => {
-        if (debug13) {
+        if (debug14) {
           server.config.logger.info(`  poke stdin ${formatChunk(data)}`, {
             timestamp: true
           });