@rangojs/router 0.0.0-experimental.111 → 0.0.0-experimental.113

package/dist/vite/index.js

@@ -465,7 +465,7 @@ function exposeActionId() {
 
 // src/vite/plugins/expose-internal-ids.ts
 import { parseAst as parseAst2 } from "vite";
-import MagicString4 from "magic-string";
+import MagicString3 from "magic-string";
 import path4 from "node:path";
 
 // src/vite/utils/ast-handler-extract.ts
@@ -960,7 +960,7 @@ function generateClientLoaderStubs(bindings, code, filePath, isBuild) {
   const lines = [];
   for (const binding of bindings) {
     for (const name of binding.exportNames) {
-      const loaderId = isBuild ? hashId(filePath, name) : `${filePath}#${name}`;
+      const loaderId = makeStubId(filePath, name, isBuild);
       lines.push(
         `export const ${name} = { __brand: "loader", $$id: "${loaderId}" };`
       );
@@ -972,7 +972,7 @@ function transformLoaders(bindings, s, filePath, isBuild) {
   let hasChanges = false;
   for (const binding of bindings) {
     const exportName = binding.exportNames[0];
-    const loaderId = isBuild ? hashId(filePath, exportName) : `${filePath}#${exportName}`;
+    const loaderId = makeStubId(filePath, exportName, isBuild);
     const paramInjection = binding.argCount === 1 ? `, undefined, "${loaderId}"` : `, "${loaderId}"`;
     s.appendLeft(binding.callCloseParenPos, paramInjection);
     const propInjection = `
@@ -984,7 +984,6 @@ ${binding.localName}.$$id = "${loaderId}";`;
 }
 
 // src/vite/plugins/expose-ids/handler-transform.ts
-import MagicString2 from "magic-string";
 function analyzeCreateHandleArgs(code, startPos, endPos) {
   const content = code.slice(startPos, endPos).trim();
   return { hasArgs: content.length > 0 };
@@ -998,7 +997,7 @@ function transformHandles(bindings, s, code, filePath, isBuild) {
       binding.callOpenParenPos + 1,
       binding.callCloseParenPos
     );
-    const handleId = isBuild ? hashId(filePath, exportName) : `${filePath}#${exportName}`;
+    const handleId = makeStubId(filePath, exportName, isBuild);
     let paramInjection;
     if (!args.hasArgs) {
       paramInjection = `undefined, "${handleId}"`;
@@ -1017,7 +1016,7 @@ function transformLocationState(bindings, s, filePath, isBuild) {
   let hasChanges = false;
   for (const binding of bindings) {
     const exportName = binding.exportNames[0];
-    const stateKey = isBuild ? hashId(filePath, exportName) : `${filePath}#${exportName}`;
+    const stateKey = makeStubId(filePath, exportName, isBuild);
     const propInjection = `
 ${binding.localName}.__rsc_ls_key = "__rsc_ls_${stateKey}";`;
     s.appendRight(binding.statementEnd, propInjection);
@@ -1029,7 +1028,7 @@ function generateWholeFileStubs(cfg, bindings, code, filePath, isBuild) {
   if (!isExportOnlyFile(code, bindings)) return null;
   const exportNames = bindings.flatMap((b) => b.exportNames);
   const stubs = exportNames.map((name) => {
-    const handlerId = isBuild ? hashId(filePath, name) : `${filePath}#${name}`;
+    const handlerId = makeStubId(filePath, name, isBuild);
     return `export const ${name} = { __brand: "${cfg.brand}", $$id: "${handlerId}" };`;
   });
   return { code: stubs.join("\n") + "\n", map: null };
@@ -1038,7 +1037,7 @@ function stubHandlerExprs(cfg, bindings, s, filePath, isBuild) {
   let hasChanges = false;
   for (const binding of bindings) {
     const exportName = binding.exportNames[0];
-    const handlerId = isBuild ? hashId(filePath, exportName) : `${filePath}#${exportName}`;
+    const handlerId = makeStubId(filePath, exportName, isBuild);
     s.overwrite(
       binding.callExprStart,
       binding.callCloseParenPos + 1,
@@ -1052,7 +1051,7 @@ function transformHandlerIds(cfg, bindings, s, filePath, isBuild) {
   let hasChanges = false;
   for (const binding of bindings) {
     const exportName = binding.exportNames[0];
-    const handlerId = isBuild ? hashId(filePath, exportName) : `${filePath}#${exportName}`;
+    const handlerId = makeStubId(filePath, exportName, isBuild);
     let paramInjection;
     if (binding.argCount === 0) {
       paramInjection = `undefined, "${handlerId}"`;
@@ -1071,7 +1070,7 @@ ${binding.localName}.$$id = "${handlerId}";`;
 }
 
 // src/vite/plugins/expose-ids/router-transform.ts
-import MagicString3 from "magic-string";
+import MagicString2 from "magic-string";
 import path3 from "node:path";
 import { createHash } from "node:crypto";
 var debug2 = createRangoDebugger(NS.transform);
@@ -1081,10 +1080,10 @@ function transformRouter(code, filePath, routerFnNames, absolutePath) {
     "g"
   );
   let match;
-  const s = new MagicString3(code);
+  const s = new MagicString2(code);
   let changed = false;
-  const basename3 = path3.basename(filePath).replace(/\.(tsx?|jsx?)$/, "");
-  const routeNamesImport = `./${basename3}.named-routes.gen.js`;
+  const basename2 = path3.basename(filePath).replace(/\.(tsx?|jsx?)$/, "");
+  const routeNamesImport = `./${basename2}.named-routes.gen.js`;
   const routeNamesVar = `__rsc_rn`;
   while ((match = pat.exec(code)) !== null) {
     const callStart = match.index;
@@ -1410,15 +1409,6 @@ ${lazyImports.join(",\n")}
           );
           if (wholeFile) return wholeFile;
         }
-        if (hasPrerenderHandlerCode && isRscEnv && isBuild) {
-          const fnNames = getFnNames(PRERENDER_CONFIG.fnName);
-          const exportNames = getBindings(code, fnNames).map(
-            (b) => b.exportNames[0]
-          );
-          if (exportNames.length > 0) {
-            prerenderHandlerModules.set(id, exportNames);
-          }
-        }
         let changed = false;
         const handlerConfigs = [
           hasStaticHandlerCode && STATIC_CONFIG,
@@ -1431,7 +1421,7 @@ ${lazyImports.join(",\n")}
           const totalCalls = countCreateCallsForNames(code, fnNames);
           const supportedBindings = getBindings(code, fnNames).length;
           if (totalCalls > supportedBindings) {
-            const iterS = new MagicString4(code);
+            const iterS = new MagicString3(code);
             const result = transformInlineHandlers(
               cfg.fnName,
               VIRTUAL_HANDLER_PREFIX,
@@ -1596,16 +1586,24 @@ ${lazyImports.join(",\n")}
             return { code: lines.join("\n") + "\n", map: null };
           }
         }
-        if (hasStaticHandlerCode && isRscEnv && isBuild) {
-          const fnNames = getFnNames(STATIC_CONFIG.fnName);
-          const exportNames = getBindings(code, fnNames).map(
-            (b) => b.exportNames[0]
-          );
-          if (exportNames.length > 0) {
-            staticHandlerModules.set(id, exportNames);
+        if (isRscEnv && isBuild) {
+          const trackTypes = [
+            [
+              hasPrerenderHandlerCode,
+              PRERENDER_CONFIG,
+              prerenderHandlerModules
+            ],
+            [hasStaticHandlerCode, STATIC_CONFIG, staticHandlerModules]
+          ];
+          for (const [has2, cfg, trackMap] of trackTypes) {
+            if (!has2) continue;
+            const exportNames = getBindings(code, getFnNames(cfg.fnName)).map(
+              (b) => b.exportNames[0]
+            );
+            if (exportNames.length > 0) trackMap.set(id, exportNames);
           }
         }
-        const s = new MagicString4(code);
+        const s = new MagicString3(code);
         if (hasLoaderCode) {
           const fnNames = getFnNames("createLoader");
           changed = transformLoaders(
@@ -1634,41 +1632,13 @@ ${lazyImports.join(",\n")}
             isBuild
           ) || changed;
         }
-        if (hasPrerenderHandlerCode) {
-          const fnNames = getFnNames(PRERENDER_CONFIG.fnName);
-          const bindings = getBindings(code, fnNames);
-          if (isRscEnv) {
-            changed = transformHandlerIds(
-              PRERENDER_CONFIG,
-              bindings,
-              s,
-              filePath,
-              isBuild
-            ) || changed;
-          } else {
-            changed = stubHandlerExprs(
-              PRERENDER_CONFIG,
-              bindings,
-              s,
-              filePath,
-              isBuild
-            ) || changed;
-          }
-        }
-        if (hasStaticHandlerCode) {
-          const fnNames = getFnNames(STATIC_CONFIG.fnName);
-          const bindings = getBindings(code, fnNames);
-          if (isRscEnv) {
-            changed = transformHandlerIds(
-              STATIC_CONFIG,
-              bindings,
-              s,
-              filePath,
-              isBuild
-            ) || changed;
-          } else {
-            changed = stubHandlerExprs(STATIC_CONFIG, bindings, s, filePath, isBuild) || changed;
-          }
+        const finalHandlerConfigs = [
+          hasPrerenderHandlerCode && PRERENDER_CONFIG,
+          hasStaticHandlerCode && STATIC_CONFIG
+        ].filter((c) => !!c);
+        for (const cfg of finalHandlerConfigs) {
+          const bindings = getBindings(code, getFnNames(cfg.fnName));
+          changed = (isRscEnv ? transformHandlerIds(cfg, bindings, s, filePath, isBuild) : stubHandlerExprs(cfg, bindings, s, filePath, isBuild)) || changed;
         }
         if (!changed) return;
         return {
@@ -1684,10 +1654,11 @@ ${lazyImports.join(",\n")}
 
 // src/vite/plugins/use-cache-transform.ts
 import path5 from "node:path";
-import MagicString5 from "magic-string";
+import MagicString4 from "magic-string";
 var debug4 = createRangoDebugger(NS.transform);
 var CACHE_RUNTIME_IMPORT = "@rangojs/router/cache-runtime";
 var LAYOUT_TEMPLATE_PATTERN = /\/(layout|template)\.(tsx?|jsx?)$/;
+var USE_CACHE_DIRECTIVE_RE = /^use cache(:\s*[\w-]+)?$/;
 function useCacheTransform() {
   let projectRoot = "";
   let isBuild = false;
@@ -1781,7 +1752,7 @@ function transformFileLevelUseCache(code, ast, filePath, sourceId, isBuild, isLa
     );
   }
   if (exportNames.length === 0) {
-    const s = new MagicString5(code);
+    const s = new MagicString4(code);
     const directive2 = findFileLevelDirective(ast);
     if (directive2) {
       s.overwrite(
@@ -1816,7 +1787,7 @@ function transformFileLevelUseCache(code, ast, filePath, sourceId, isBuild, isLa
 function transformFunctionLevelUseCache(code, ast, filePath, sourceId, isBuild, transformHoistInlineDirective) {
   try {
     const { output, names } = transformHoistInlineDirective(code, ast, {
-      directive: /^use cache(:\s*[\w-]+)?$/,
+      directive: USE_CACHE_DIRECTIVE_RE,
       runtime: (value, name, meta) => {
         const funcId = isBuild ? hashId(filePath, name) : `${filePath}#${name}`;
         const profileMatch = meta.directiveMatch[1];
@@ -1846,14 +1817,13 @@ function findFileLevelDirective(ast) {
   }
   return null;
 }
-var VALID_DIRECTIVE_RE = /^use cache(:\s*[\w-]+)?$/;
 var NEAR_MISS_RE = /^use cache:\s*.+$/;
 function warnOnNearMissDirectives(ast, fileId, warn) {
   const visit = (node) => {
     if (!node || typeof node !== "object") return;
     if (node.type === "ExpressionStatement" && node.expression?.type === "Literal" && typeof node.expression.value === "string") {
       const value = node.expression.value;
-      if (value.startsWith("use cache") && NEAR_MISS_RE.test(value) && !VALID_DIRECTIVE_RE.test(value)) {
+      if (value.startsWith("use cache") && NEAR_MISS_RE.test(value) && !USE_CACHE_DIRECTIVE_RE.test(value)) {
         const profilePart = value.slice("use cache:".length).trim();
         warn(
           `[rango:use-cache] "${value}" in ${fileId} has an invalid profile name "${profilePart}". Profile names must match [a-zA-Z0-9_-]+. This directive will be ignored.`
@@ -2049,7 +2019,7 @@ import { resolve } from "node:path";
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.0.0-experimental.111",
+  version: "0.0.0-experimental.113",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -2187,6 +2157,7 @@ var package_default = {
     typecheck: "tsc --noEmit && tsc -p tsconfig.strict-check.json --noEmit && tsc -p tsconfig.augment-check.json --noEmit",
     test: "playwright test",
     "test:ui": "playwright test --ui",
+    "test:hmr-local": "playwright test --project=dev-warmup --project=hmr-routes --project=hmr-basename --project=hmr-prerender --no-deps --workers=1",
     "test:unit": "vitest run",
     "test:unit:watch": "vitest"
   },
@@ -2200,6 +2171,7 @@ var package_default = {
   },
   devDependencies: {
     "@playwright/test": "^1.49.1",
+    "@shared/e2e": "workspace:*",
     "@types/node": "^24.10.1",
     "@types/react": "catalog:",
     "@types/react-dom": "catalog:",
@@ -2866,19 +2838,38 @@ function extractBasenameFromRouter(code) {
   visit(sourceFile);
   return result;
 }
-function applyBasenameToRoutes(result, basename3) {
+function applyBasenameToRoutes(result, basename2) {
   const prefixed = {};
   for (const [name, pattern] of Object.entries(result.routes)) {
     if (pattern === "/") {
-      prefixed[name] = basename3;
-    } else if (basename3.endsWith("/") && pattern.startsWith("/")) {
-      prefixed[name] = basename3 + pattern.slice(1);
+      prefixed[name] = basename2;
+    } else if (basename2.endsWith("/") && pattern.startsWith("/")) {
+      prefixed[name] = basename2 + pattern.slice(1);
     } else {
-      prefixed[name] = basename3 + pattern;
+      prefixed[name] = basename2 + pattern;
     }
   }
   return { routes: prefixed, searchSchemas: result.searchSchemas };
 }
+function genFileTsPath(sourceFile) {
+  const base = pathBasename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
+  return join(dirname2(sourceFile), `${base}.named-routes.gen.ts`);
+}
+function resolveSearchSchemas(publicRouteNames, runtimeSchemas, sourceFile) {
+  if (runtimeSchemas && Object.keys(runtimeSchemas).length > 0) {
+    return runtimeSchemas;
+  }
+  const staticParsed = buildCombinedRouteMapForRouterFile(sourceFile);
+  if (Object.keys(staticParsed.searchSchemas).length === 0) {
+    return runtimeSchemas;
+  }
+  const filtered = {};
+  for (const name of publicRouteNames) {
+    const schema = staticParsed.searchSchemas[name];
+    if (schema) filtered[name] = schema;
+  }
+  return Object.keys(filtered).length > 0 ? filtered : runtimeSchemas;
+}
 function buildCombinedRouteMapForRouterFile(routerFilePath) {
   let routerSource;
   try {
@@ -2891,7 +2882,7 @@ function buildCombinedRouteMapForRouterFile(routerFilePath) {
     return { routes: {}, searchSchemas: {} };
   }
   const rawBasename = extractBasenameFromRouter(routerSource);
-  const basename3 = rawBasename ? ("/" + rawBasename.replace(/^\/+|\/+$/g, "")).replace(/^\/$/, "") : void 0;
+  const basename2 = rawBasename ? ("/" + rawBasename.replace(/^\/+|\/+$/g, "")).replace(/^\/$/, "") : void 0;
   let result;
   if (extraction.kind === "inline") {
     result = buildCombinedRouteMapWithSearch(
@@ -2916,8 +2907,8 @@ function buildCombinedRouteMapForRouterFile(routerFilePath) {
       result = buildCombinedRouteMapWithSearch(routerFilePath, extraction.name);
     }
   }
-  if (basename3) {
-    result = applyBasenameToRoutes(result, basename3);
+  if (basename2) {
+    result = applyBasenameToRoutes(result, basename2);
   }
   return result;
 }
@@ -2954,18 +2945,12 @@ function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
       }
       if (!extractUrlsFromRouter(routerSource)) continue;
     }
-    const routerBasename = pathBasename(routerFilePath).replace(
-      /\.(tsx?|jsx?)$/,
-      ""
-    );
-    const outPath = join(
-      dirname2(routerFilePath),
-      `${routerBasename}.named-routes.gen.ts`
-    );
+    const outPath = genFileTsPath(routerFilePath);
     const existing = existsSync3(outPath) ? readFileSync2(outPath, "utf-8") : null;
     if (Object.keys(result.routes).length === 0) {
       if (!existing) {
         const emptySource = generateRouteTypesSource({});
+        opts?.onWrite?.(outPath, emptySource);
         writeFileSync(outPath, emptySource);
       }
       continue;
@@ -2985,6 +2970,7 @@ function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
           continue;
         }
       }
+      opts?.onWrite?.(outPath, source);
       writeFileSync(outPath, source);
       console.log(
         `[rango] Generated route types (${Object.keys(result.routes).length} routes) -> ${outPath}`
@@ -3255,6 +3241,12 @@ function performanceTracksPlugin() {
 }
 
 // src/vite/utils/shared-utils.ts
+function resolveRscEntryFromConfig(config) {
+  const entries = config.environments?.["rsc"]?.optimizeDeps?.entries;
+  if (typeof entries === "string") return entries;
+  if (Array.isArray(entries) && entries.length > 0) return entries[0];
+  return void 0;
+}
 var versionRolldownPlugin = {
   name: "@rangojs/router-version",
   resolveId(id) {
@@ -3373,15 +3365,7 @@ function createVersionInjectorPlugin(rscEntryPath) {
     enforce: "pre",
     configResolved(config) {
       let entryPath = rscEntryPath;
-      if (!entryPath) {
-        const rscEnvConfig = config.environments?.["rsc"];
-        const entries = rscEnvConfig?.optimizeDeps?.entries;
-        if (typeof entries === "string") {
-          entryPath = entries;
-        } else if (Array.isArray(entries) && entries.length > 0) {
-          entryPath = entries[0];
-        }
-      }
+      if (!entryPath) entryPath = resolveRscEntryFromConfig(config);
       if (entryPath) {
         resolvedEntryPath = resolve4(config.root, entryPath);
       }
@@ -3435,8 +3419,8 @@ function createCjsToEsmPlugin() {
     name: "@rangojs/router:cjs-to-esm",
     enforce: "pre",
     transform(code, id) {
-      const cleanId = id.split("?")[0];
-      if (cleanId.includes("vendor/react-server-dom/client.browser.js") || cleanId.includes("vendor\\react-server-dom\\client.browser.js")) {
+      const cleanId = id.split("?")[0].replaceAll("\\", "/");
+      if (cleanId.includes("vendor/react-server-dom/client.browser.js")) {
         const isProd = process.env.NODE_ENV === "production";
         const cjsFile = isProd ? "./cjs/react-server-dom-webpack-client.browser.production.js" : "./cjs/react-server-dom-webpack-client.browser.development.js";
         debug7?.("cjs-to-esm entry redirect %s", id);
@@ -3445,7 +3429,7 @@ function createCjsToEsmPlugin() {
           map: null
         };
       }
-      if ((cleanId.includes("vendor/react-server-dom/cjs/") || cleanId.includes("vendor\\react-server-dom\\cjs\\")) && cleanId.includes("client.browser")) {
+      if (cleanId.includes("vendor/react-server-dom/cjs/") && cleanId.includes("client.browser")) {
         let transformed = code;
         const licenseMatch = transformed.match(/^\/\*\*[\s\S]*?\*\//);
         const license = licenseMatch ? licenseMatch[0] : "";
@@ -4696,10 +4680,10 @@ async function discoverRouters(state, rscEnv) {
         newMergedRouteManifest,
         mergedRouteAncestry,
         routeToStaticPrefix,
-        Object.keys(mergedRouteTrailingSlash).length > 0 ? mergedRouteTrailingSlash : void 0,
-        prerenderRouteNames.size > 0 ? prerenderRouteNames : void 0,
-        passthroughRouteNames.size > 0 ? passthroughRouteNames : void 0,
-        Object.keys(mergedResponseTypeRoutes).length > 0 ? mergedResponseTypeRoutes : void 0
+        mergedRouteTrailingSlash,
+        prerenderRouteNames,
+        passthroughRouteNames,
+        mergedResponseTypeRoutes
       );
       for (const { id, manifest } of allManifests) {
         if (!manifest._routeAncestry || Object.keys(manifest._routeAncestry).length === 0)
@@ -4715,10 +4699,10 @@ async function discoverRouters(state, rscEnv) {
           manifest.routeManifest,
           manifest._routeAncestry,
           perRouterStaticPrefix,
-          manifest.routeTrailingSlash && Object.keys(manifest.routeTrailingSlash).length > 0 ? manifest.routeTrailingSlash : void 0,
-          perRouterPrerenderNames && perRouterPrerenderNames.size > 0 ? perRouterPrerenderNames : void 0,
-          perRouterPassthroughNames && perRouterPassthroughNames.size > 0 ? perRouterPassthroughNames : void 0,
-          manifest.responseTypeRoutes && Object.keys(manifest.responseTypeRoutes).length > 0 ? manifest.responseTypeRoutes : void 0
+          manifest.routeTrailingSlash,
+          perRouterPrerenderNames,
+          perRouterPassthroughNames,
+          manifest.responseTypeRoutes
         );
         newPerRouterTrieMap.set(id, perRouterTrie);
       }
@@ -4741,7 +4725,7 @@ async function discoverRouters(state, rscEnv) {
 }
 
 // src/vite/discovery/route-types-writer.ts
-import { dirname as dirname3, basename, join as join2, resolve as resolve6 } from "node:path";
+import { dirname as dirname3, join as join2, resolve as resolve6 } from "node:path";
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, existsSync as existsSync5, unlinkSync as unlinkSync2 } from "node:fs";
 function filterUserNamedRoutes(manifest) {
   const filtered = {};
@@ -4752,39 +4736,20 @@ function filterUserNamedRoutes(manifest) {
   }
   return filtered;
 }
+function writeGenFileIfChanged(state, outPath, source, opts) {
+  const existing = existsSync5(outPath) ? readFileSync4(outPath, "utf-8") : null;
+  if (existing === source) return;
+  markSelfGenWrite(state, outPath, source);
+  writeFileSync3(outPath, source);
+  if (opts?.log) console.log(`[rango] Generated route types -> ${outPath}`);
+}
 function writeCombinedRouteTypesWithTracking(state, opts) {
   const routerFiles = state.cachedRouterFiles ?? findRouterFiles(state.projectRoot, state.scanFilter);
   state.cachedRouterFiles = routerFiles;
-  const preContent = /* @__PURE__ */ new Map();
-  for (const routerFilePath of routerFiles) {
-    const routerDir = dirname3(routerFilePath);
-    const routerBasename = basename(routerFilePath).replace(
-      /\.(tsx?|jsx?)$/,
-      ""
-    );
-    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
-    try {
-      preContent.set(outPath, readFileSync4(outPath, "utf-8"));
-    } catch {
-    }
-  }
-  writeCombinedRouteTypes(state.projectRoot, routerFiles, opts);
-  for (const routerFilePath of routerFiles) {
-    const routerDir = dirname3(routerFilePath);
-    const routerBasename = basename(routerFilePath).replace(
-      /\.(tsx?|jsx?)$/,
-      ""
-    );
-    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
-    if (!existsSync5(outPath)) continue;
-    try {
-      const content = readFileSync4(outPath, "utf-8");
-      if (content !== preContent.get(outPath)) {
-        markSelfGenWrite(state, outPath, content);
-      }
-    } catch {
-    }
-  }
+  writeCombinedRouteTypes(state.projectRoot, routerFiles, {
+    ...opts,
+    onWrite: (outPath, content) => markSelfGenWrite(state, outPath, content)
+  });
 }
 function writeRouteTypesFiles(state) {
   if (state.perRouterManifests.length === 0) return;
@@ -4815,34 +4780,18 @@ This means createRouter() stack trace parsing matched a Vite internal frame.
 Set an explicit \`id\` on createRouter() or check the call site.`
       );
     }
-    const routerDir = dirname3(sourceFile);
-    const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = genFileTsPath(sourceFile);
     const userRoutes = filterUserNamedRoutes(routeManifest);
-    let effectiveSearchSchemas = routeSearchSchemas;
-    if ((!effectiveSearchSchemas || Object.keys(effectiveSearchSchemas).length === 0) && sourceFile) {
-      const staticParsed = buildCombinedRouteMapForRouterFile(sourceFile);
-      if (Object.keys(staticParsed.searchSchemas).length > 0) {
-        const filtered = {};
-        for (const name of Object.keys(userRoutes)) {
-          const schema = staticParsed.searchSchemas[name];
-          if (schema) filtered[name] = schema;
-        }
-        if (Object.keys(filtered).length > 0) {
-          effectiveSearchSchemas = filtered;
-        }
-      }
-    }
+    const effectiveSearchSchemas = resolveSearchSchemas(
+      Object.keys(userRoutes),
+      routeSearchSchemas,
+      sourceFile
+    );
     const source = generateRouteTypesSource(
       userRoutes,
       effectiveSearchSchemas && Object.keys(effectiveSearchSchemas).length > 0 ? effectiveSearchSchemas : void 0
     );
-    const existing = existsSync5(outPath) ? readFileSync4(outPath, "utf-8") : null;
-    if (existing !== source) {
-      markSelfGenWrite(state, outPath, source);
-      writeFileSync3(outPath, source);
-      console.log(`[rango] Generated route types -> ${outPath}`);
-    }
+    writeGenFileIfChanged(state, outPath, source, { log: true });
   }
 }
 function supplementGenFilesWithRuntimeRoutes(state) {
@@ -4880,23 +4829,17 @@ function supplementGenFilesWithRuntimeRoutes(state) {
         }
       }
     }
-    const routerDir = dirname3(sourceFile);
-    const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = genFileTsPath(sourceFile);
     const source = generateRouteTypesSource(
       mergedRoutes,
       Object.keys(mergedSearchSchemas).length > 0 ? mergedSearchSchemas : void 0
     );
-    const existing = existsSync5(outPath) ? readFileSync4(outPath, "utf-8") : null;
-    if (existing !== source) {
-      markSelfGenWrite(state, outPath, source);
-      writeFileSync3(outPath, source);
-    }
+    writeGenFileIfChanged(state, outPath, source);
   }
 }
 
 // src/vite/discovery/virtual-module-codegen.ts
-import { dirname as dirname4, basename as basename2, join as join3 } from "node:path";
+import { dirname as dirname4, basename, join as join3 } from "node:path";
 function generateRoutesManifestModule(state) {
   const hasManifest = state.mergedRouteManifest && Object.keys(state.mergedRouteManifest).length > 0;
   if (hasManifest) {
@@ -4907,7 +4850,7 @@ function generateRoutesManifestModule(state) {
     for (const entry of state.perRouterManifests) {
       if (entry.sourceFile) {
         const routerDir = dirname4(entry.sourceFile);
-        const routerBasename = basename2(entry.sourceFile).replace(
+        const routerBasename = basename(entry.sourceFile).replace(
           /\.(tsx?|jsx?)$/,
           ""
         );
@@ -4992,7 +4935,7 @@ function generatePerRouterModule(state, routerId) {
   const lines = [];
   if (routerEntry?.sourceFile) {
     const routerDir = dirname4(routerEntry.sourceFile);
-    const routerBasename = basename2(routerEntry.sourceFile).replace(
+    const routerBasename = basename(routerEntry.sourceFile).replace(
       /\.(tsx?|jsx?)$/,
       ""
     );
@@ -5430,13 +5373,8 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
         s.resolvedEntryPath = opts.routerPathRef.path;
       }
       if (!s.resolvedEntryPath) {
-        const rscEnvConfig = config.environments?.["rsc"];
-        const entries = rscEnvConfig?.optimizeDeps?.entries;
-        if (typeof entries === "string") {
-          s.resolvedEntryPath = entries;
-        } else if (Array.isArray(entries) && entries.length > 0) {
-          s.resolvedEntryPath = entries[0];
-        }
+        const entry = resolveRscEntryFromConfig(config);
+        if (entry) s.resolvedEntryPath = entry;
       }
       if (opts?.staticRouteTypesGeneration !== false) {
         s.cachedRouterFiles = findRouterFiles(s.projectRoot, s.scanFilter);
@@ -5727,20 +5665,15 @@ ${err.stack}`
         if (s.mergedRouteTrie && serverMod.setRouteTrie) {
           serverMod.setRouteTrie(s.mergedRouteTrie);
         }
-        if (serverMod.setRouterManifest) {
-          for (const [routerId, manifest] of s.perRouterManifestDataMap) {
-            serverMod.setRouterManifest(routerId, manifest);
-          }
-        }
-        if (serverMod.setRouterTrie) {
-          for (const [routerId, trie] of s.perRouterTrieMap) {
-            serverMod.setRouterTrie(routerId, trie);
-          }
-        }
-        if (serverMod.setRouterPrecomputedEntries) {
-          for (const [routerId, entries] of s.perRouterPrecomputedMap) {
-            serverMod.setRouterPrecomputedEntries(routerId, entries);
-          }
+        const perRouterSetters = [
+          [s.perRouterManifestDataMap, "setRouterManifest"],
+          [s.perRouterTrieMap, "setRouterTrie"],
+          [s.perRouterPrecomputedMap, "setRouterPrecomputedEntries"]
+        ];
+        for (const [map, fn] of perRouterSetters) {
+          const setter = serverMod[fn];
+          if (typeof setter !== "function") continue;
+          for (const [routerId, value] of map) setter(routerId, value);
         }
       };
       server.middlewares.use("/__rsc_prerender", async (req, res) => {
@@ -5910,6 +5843,7 @@ ${err.stack}`
                 );
                 s.lastDiscoveryError = null;
               }
+              if (rscEnv && !rscEnv.runner) forceCloudflareWorkerReload(rscEnv);
             } catch (err) {
               s.lastDiscoveryError = {
                 message: err?.message ?? String(err),
@@ -5930,6 +5864,25 @@ ${err.stack}`
             }
           });
         };
+        const forceCloudflareWorkerReload = (rscEnv) => {
+          if (!rscEnv?.hot) return;
+          try {
+            const graph = rscEnv.moduleGraph;
+            if (graph?.invalidateAll) {
+              graph.invalidateAll();
+              debugDiscovery?.("hmr: invalidated workerd rsc module graph");
+            }
+            rscEnv.hot.send({ type: "full-reload" });
+            debugDiscovery?.(
+              "hmr: forced workerd rsc env reload (full-reload)"
+            );
+          } catch (err) {
+            debugDiscovery?.(
+              "hmr: workerd reload failed: %s",
+              err?.message ?? err
+            );
+          }
+        };
         const scheduleRouteRegeneration = () => {
           clearTimeout(routeChangeTimer);
           routeChangeTimer = setTimeout(() => {