@rangojs/router 0.0.0-experimental.39 → 0.0.0-experimental.3b1deca8

package/dist/vite/index.js

@@ -9,18 +9,18 @@ import fs from "node:fs";
 
 // src/vite/plugins/expose-id-utils.ts
 import path from "node:path";
-import crypto from "node:crypto";
+import crypto2 from "node:crypto";
 function normalizePath(p) {
   return p.split(path.sep).join("/");
 }
 function hashId(filePath, exportName) {
   const input = `${filePath}#${exportName}`;
-  const hash = crypto.createHash("sha256").update(input).digest("hex");
+  const hash = crypto2.createHash("sha256").update(input).digest("hex");
   return `${hash.slice(0, 8)}#${exportName}`;
 }
 function hashInlineId(filePath, lineNumber, index) {
   const input = index !== void 0 && index > 0 ? `${filePath}:${lineNumber}:${index}` : `${filePath}:${lineNumber}`;
-  return crypto.createHash("sha256").update(input).digest("hex").slice(0, 8);
+  return crypto2.createHash("sha256").update(input).digest("hex").slice(0, 8);
 }
 function buildExportMap(program) {
   const exportMap = /* @__PURE__ */ new Map();
@@ -292,7 +292,7 @@ function exposeActionId() {
       }
       if (!rscPluginApi) {
         throw new Error(
-          "[rsc-router] Could not find @vitejs/plugin-rsc. @rangojs/router requires the Vite RSC plugin.\nThe RSC plugin should be included automatically. If you disabled it with\nrango({ rsc: false }), add rsc() before rango() in your config."
+          "[rsc-router] Could not find @vitejs/plugin-rsc. @rangojs/router requires the Vite RSC plugin, which is included automatically by rango()."
         );
       }
       if (!isBuild) return;
@@ -1745,7 +1745,7 @@ import { resolve } from "node:path";
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.0.0-experimental.39",
+  version: "0.0.0-experimental.3b1deca8",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -2095,31 +2095,7 @@ declare global {
 }
 
 // src/build/route-types/scan-filter.ts
-import { join, relative } from "node:path";
 import picomatch from "picomatch";
-var DEFAULT_EXCLUDE_PATTERNS = [
-  "**/__tests__/**",
-  "**/__mocks__/**",
-  "**/dist/**",
-  "**/coverage/**",
-  "**/*.test.{ts,tsx,js,jsx}",
-  "**/*.spec.{ts,tsx,js,jsx}"
-];
-function createScanFilter(root, opts) {
-  const { include, exclude } = opts;
-  const hasInclude = include && include.length > 0;
-  const hasCustomExclude = exclude !== void 0;
-  if (!hasInclude && !hasCustomExclude) return void 0;
-  const effectiveExclude = exclude ?? DEFAULT_EXCLUDE_PATTERNS;
-  const includeMatcher = hasInclude ? picomatch(include) : null;
-  const excludeMatcher = effectiveExclude.length > 0 ? picomatch(effectiveExclude) : null;
-  return (absolutePath) => {
-    const rel = relative(root, absolutePath);
-    if (excludeMatcher && excludeMatcher(rel)) return false;
-    if (includeMatcher) return includeMatcher(rel);
-    return true;
-  };
-}
 
 // src/build/route-types/per-module-writer.ts
 import ts4 from "typescript";
@@ -2386,7 +2362,7 @@ import {
   readdirSync
 } from "node:fs";
 import {
-  join as join2,
+  join,
   dirname as dirname2,
   resolve as resolve3,
   sep,
@@ -2406,7 +2382,7 @@ function countPublicRouteEntries(source) {
 }
 var ROUTER_CALL_PATTERN = /\bcreateRouter\s*[<(]/;
 function isRoutableSourceFile(name) {
-  return (name.endsWith(".ts") || name.endsWith(".tsx") || name.endsWith(".js") || name.endsWith(".jsx")) && !name.includes(".gen.");
+  return (name.endsWith(".ts") || name.endsWith(".tsx") || name.endsWith(".js") || name.endsWith(".jsx")) && !name.includes(".gen.") && !name.includes(".test.") && !name.includes(".spec.");
 }
 function findRouterFilesRecursive(dir, filter, results) {
   let entries;
@@ -2421,9 +2397,10 @@ function findRouterFilesRecursive(dir, filter, results) {
   const childDirs = [];
   const routerFilesInDir = [];
   for (const entry of entries) {
-    const fullPath = join2(dir, entry.name);
+    const fullPath = join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+      if (entry.name === "node_modules" || entry.name === "dist" || entry.name === "coverage" || entry.name === "__tests__" || entry.name === "__mocks__" || entry.name.startsWith("."))
+        continue;
       childDirs.push(fullPath);
       continue;
     }
@@ -2547,7 +2524,7 @@ function findRouterFiles(root, filter) {
 }
 function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
   try {
-    const oldCombinedPath = join2(root, "src", "named-routes.gen.ts");
+    const oldCombinedPath = join(root, "src", "named-routes.gen.ts");
     if (existsSync3(oldCombinedPath)) {
       unlinkSync(oldCombinedPath);
       console.log(
@@ -2587,7 +2564,7 @@ function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
       /\.(tsx?|jsx?)$/,
       ""
     );
-    const outPath = join2(
+    const outPath = join(
       dirname2(routerFilePath),
       `${routerBasename}.named-routes.gen.ts`
     );
@@ -2717,8 +2694,9 @@ function createVersionPlugin() {
   let isDev = false;
   let server = null;
   const clientModuleSignatures = /* @__PURE__ */ new Map();
+  let versionCounter = 0;
   const bumpVersion = (reason) => {
-    currentVersion = Date.now().toString(16);
+    currentVersion = Date.now().toString(16) + String(++versionCounter);
     console.log(`[rsc-router] ${reason}, version updated: ${currentVersion}`);
     const rscEnv = server?.environments?.rsc;
     const versionMod = rscEnv?.moduleGraph?.getModuleById(
@@ -2774,6 +2752,9 @@ function createVersionPlugin() {
       if (!isDev) return;
       const isRscModule = this.environment?.name === "rsc";
       if (!isRscModule) return;
+      if (ctx.modules.length === 1 && ctx.modules[0].id === "\0" + VIRTUAL_IDS.version) {
+        return;
+      }
       if (isCodeModule(ctx.file)) {
         const filePath = normalizeModuleId(ctx.file);
         const previousSignature = clientModuleSignatures.get(filePath);
@@ -2903,11 +2884,11 @@ ${dim} \u2571${reset}    ${bold}\u2554\u2550\u2557${reset}${dim}      *      \u2
 ${dim}      ${reset}${bold}\u2551 \u2551${reset} ${bold}\u2554\u2550\u2557${reset}${dim}                    *                \u2727.   \u2571${reset}
 ${dim}   ${reset}${bold}\u2554\u2557 \u2551 \u2551 \u2551 \u2551${reset}${dim}                          *               \u2571${reset}
 ${dim}   ${reset}${bold}\u2551\u2551 \u2551 \u2551 \u2551 \u2551  \u2566\u2550\u2557\u2554\u2550\u2557\u2554\u2557\u2554\u2554\u2550\u2557\u2554\u2550\u2557${reset}${dim}             \u2727              \u2726${reset}
-${dim}  ${reset}${bold}\u2550\u2563\u2551 \u2551 \u2560\u2550\u255D \u2551  \u2560\u2566\u255D\u2560\u2550\u2563\u2551\u2551\u2551\u2551 \u2566\u2551 \u2551${reset}${dim}        *           \u2727${reset}
+${dim}   ${reset}${bold}\u2551\u2551 \u2551 \u2560\u2550\u255D \u2551  \u2560\u2566\u255D\u2560\u2550\u2563\u2551\u2551\u2551\u2551 \u2566\u2551 \u2551${reset}${dim}        *           \u2727${reset}
 ${dim}   ${reset}${bold}\u2551\u255A\u2550\u255D \u2554\u2550\u2550\u2550\u255D  \u2569\u255A\u2550\u2569 \u2569\u255D\u255A\u255D\u255A\u2550\u255D\u255A\u2550\u255D${reset}${dim}            \u2726          .      *${reset}
 ${dim}   ${reset}${bold}\u255A\u2550\u2550\u2557 \u2551${reset}${dim} *      RSC Wrangler         \u2727                \u2726${reset}
-${dim}  *   ${reset}${bold}\u2551 \u2560\u2550${reset}${dim}                         *            \u2727.    \u2571${reset}
-${bold}\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2569\u2550\u2550\u2550${reset}${dim}                  \u2726            *${reset}
+${dim}  *   ${reset}${bold}\u2551 \u2551${reset}${dim}                          *            \u2727.    \u2571${reset}
+${dim}   ${reset}${bold}\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550${reset}${dim}                           \u2726            *${reset}
 
    v${version} \xB7 ${preset} \xB7 ${mode}
 `;
@@ -3052,7 +3033,7 @@ function createVirtualStubPlugin() {
 }
 
 // src/vite/plugins/client-ref-hashing.ts
-import { relative as relative2 } from "node:path";
+import { relative } from "node:path";
 import { createHash as createHash2 } from "node:crypto";
 var CLIENT_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-package-proxy/";
 var CLIENT_IN_SERVER_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-in-server-package-proxy/";
@@ -3065,10 +3046,10 @@ function computeProductionHash(projectRoot, refKey) {
     const absPath = decodeURIComponent(
       refKey.slice(CLIENT_IN_SERVER_PKG_PROXY_PREFIX.length)
     );
-    toHash = relative2(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith(FS_PREFIX)) {
     const absPath = refKey.slice(FS_PREFIX.length - 1);
-    toHash = relative2(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith("/")) {
     toHash = refKey.slice(1);
   } else {
@@ -3293,8 +3274,17 @@ function jsonParseExpression(value) {
 }
 
 // src/context-var.ts
+var NON_CACHEABLE_KEYS = /* @__PURE__ */ Symbol.for(
+  "rango:non-cacheable-keys"
+);
+function getNonCacheableKeys(variables) {
+  if (!variables[NON_CACHEABLE_KEYS]) {
+    variables[NON_CACHEABLE_KEYS] = /* @__PURE__ */ new Set();
+  }
+  return variables[NON_CACHEABLE_KEYS];
+}
 var FORBIDDEN_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
-function contextSet(variables, keyOrVar, value) {
+function contextSet(variables, keyOrVar, value, options) {
   if (typeof keyOrVar === "string") {
     if (FORBIDDEN_KEYS.has(keyOrVar)) {
       throw new Error(
@@ -3302,8 +3292,14 @@ function contextSet(variables, keyOrVar, value) {
       );
     }
     variables[keyOrVar] = value;
+    if (options?.cache === false) {
+      getNonCacheableKeys(variables).add(keyOrVar);
+    }
   } else {
     variables[keyOrVar.key] = value;
+    if (options?.cache === false) {
+      getNonCacheableKeys(variables).add(keyOrVar.key);
+    }
   }
 }
 
@@ -3937,7 +3933,7 @@ async function discoverRouters(state, rscEnv) {
 }
 
 // src/vite/discovery/route-types-writer.ts
-import { dirname as dirname3, basename, join as join3, resolve as resolve6 } from "node:path";
+import { dirname as dirname3, basename, 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 = {};
@@ -3958,7 +3954,7 @@ function writeCombinedRouteTypesWithTracking(state, opts) {
       /\.(tsx?|jsx?)$/,
       ""
     );
-    const outPath = join3(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
     try {
       preContent.set(outPath, readFileSync4(outPath, "utf-8"));
     } catch {
@@ -3971,7 +3967,7 @@ function writeCombinedRouteTypesWithTracking(state, opts) {
       /\.(tsx?|jsx?)$/,
       ""
     );
-    const outPath = join3(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
     if (!existsSync5(outPath)) continue;
     try {
       const content = readFileSync4(outPath, "utf-8");
@@ -3988,7 +3984,7 @@ function writeRouteTypesFiles(state) {
     const entryDir = dirname3(
       resolve6(state.projectRoot, state.resolvedEntryPath)
     );
-    const oldCombinedPath = join3(entryDir, "named-routes.gen.ts");
+    const oldCombinedPath = join2(entryDir, "named-routes.gen.ts");
     if (existsSync5(oldCombinedPath)) {
       unlinkSync2(oldCombinedPath);
       console.log(
@@ -4013,7 +4009,7 @@ Set an explicit \`id\` on createRouter() or check the call site.`
     }
     const routerDir = dirname3(sourceFile);
     const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const outPath = join3(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
     const userRoutes = filterUserNamedRoutes(routeManifest);
     let effectiveSearchSchemas = routeSearchSchemas;
     if ((!effectiveSearchSchemas || Object.keys(effectiveSearchSchemas).length === 0) && sourceFile) {
@@ -4078,7 +4074,7 @@ function supplementGenFilesWithRuntimeRoutes(state) {
     }
     const routerDir = dirname3(sourceFile);
     const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const outPath = join3(routerDir, `${routerBasename}.named-routes.gen.ts`);
+    const outPath = join2(routerDir, `${routerBasename}.named-routes.gen.ts`);
     const source = generateRouteTypesSource(
       mergedRoutes,
       Object.keys(mergedSearchSchemas).length > 0 ? mergedSearchSchemas : void 0
@@ -4092,7 +4088,7 @@ function supplementGenFilesWithRuntimeRoutes(state) {
 }
 
 // src/vite/discovery/virtual-module-codegen.ts
-import { dirname as dirname4, basename as basename2, join as join4 } from "node:path";
+import { dirname as dirname4, basename as basename2, join as join3 } from "node:path";
 function generateRoutesManifestModule(state) {
   const hasManifest = state.mergedRouteManifest && Object.keys(state.mergedRouteManifest).length > 0;
   if (hasManifest) {
@@ -4107,7 +4103,7 @@ function generateRoutesManifestModule(state) {
           /\.(tsx?|jsx?)$/,
           ""
         );
-        const genPath = join4(
+        const genPath = join3(
           routerDir,
           `${routerBasename}.named-routes.gen.js`
         ).replaceAll("\\", "/");
@@ -4204,7 +4200,7 @@ function generatePerRouterModule(state, routerId) {
       /\.(tsx?|jsx?)$/,
       ""
     );
-    const genPath = join4(
+    const genPath = join3(
       routerDir,
       `${routerBasename}.named-routes.gen.js`
     ).replaceAll("\\", "/");
@@ -4445,12 +4441,6 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
           s.resolvedEntryPath = entries[0];
         }
       }
-      if (opts?.include || opts?.exclude) {
-        s.scanFilter = createScanFilter(s.projectRoot, {
-          include: opts.include,
-          exclude: opts.exclude
-        });
-      }
       if (opts?.staticRouteTypesGeneration !== false) {
         s.cachedRouterFiles = findRouterFiles(s.projectRoot, s.scanFilter);
         writeCombinedRouteTypesWithTracking(s, { preserveIfLarger: true });
@@ -4871,6 +4861,139 @@ ${details}`
   };
 }
 
+// src/vite/plugins/performance-tracks.ts
+import { Module } from "node:module";
+var DEBUG_ID_HEADER = "X-RSC-Debug-Id";
+var DEBUG_S2C_EVENT = "rango:perf-s2c";
+var DEBUG_C2S_EVENT = "rango:perf-c2s";
+var GLOBAL_KEY = "__RANGO_DEBUG_CHANNELS__";
+function getRegistry() {
+  return Module[GLOBAL_KEY] ??= {
+    channels: /* @__PURE__ */ new Map(),
+    sessions: /* @__PURE__ */ new Map()
+  };
+}
+var bytesToBase64 = (bytes) => Buffer.from(bytes).toString("base64");
+var base64ToBytes = (base64) => new Uint8Array(Buffer.from(base64, "base64"));
+function performanceTracksPlugin() {
+  return {
+    name: "@rangojs/router:performance-tracks",
+    apply: "serve",
+    enforce: "pre",
+    configureServer(server) {
+      const hot = server.environments.client.hot;
+      const registry = getRegistry();
+      const sessions = registry.sessions;
+      const sendChunk = (debugId, chunk) => {
+        hot.send(DEBUG_S2C_EVENT, {
+          i: debugId,
+          b: bytesToBase64(chunk)
+        });
+      };
+      const cleanupIfEnded = (debugId, session) => {
+        if (session.pendingChunks || !session.ended) return;
+        sessions.delete(debugId);
+        hot.send(DEBUG_S2C_EVENT, {
+          i: debugId,
+          d: true
+        });
+      };
+      const registerDebugChannel = (debugId) => {
+        let session = sessions.get(debugId);
+        if (!session) {
+          session = { pendingChunks: [], ended: false };
+          sessions.set(debugId, session);
+        }
+        const readable = new ReadableStream({
+          start(controller) {
+            session.cmdController = controller;
+          },
+          cancel() {
+            delete session.cmdController;
+          }
+        });
+        const writable = new WritableStream({
+          write(chunk) {
+            if (session.pendingChunks) {
+              session.pendingChunks.push(chunk);
+            } else {
+              sendChunk(debugId, chunk);
+            }
+          },
+          close() {
+            session.ended = true;
+            cleanupIfEnded(debugId, session);
+          },
+          abort() {
+            session.ended = true;
+            cleanupIfEnded(debugId, session);
+          }
+        });
+        registry.channels.set(debugId, { readable, writable });
+      };
+      hot.on(DEBUG_C2S_EVENT, (raw) => {
+        const payload = raw;
+        const session = sessions.get(payload.i);
+        if (payload.d) {
+          if (session?.cmdController) {
+            try {
+              session.cmdController.close();
+            } catch {
+            }
+            delete session.cmdController;
+          }
+          return;
+        }
+        if (payload.b) {
+          if (session?.cmdController) {
+            try {
+              session.cmdController.enqueue(base64ToBytes(payload.b));
+            } catch {
+              delete session.cmdController;
+            }
+          }
+          return;
+        }
+        if (session) {
+          if (session.pendingChunks) {
+            for (const chunk of session.pendingChunks) {
+              sendChunk(payload.i, chunk);
+            }
+            delete session.pendingChunks;
+          }
+          cleanupIfEnded(payload.i, session);
+        } else {
+          sessions.set(payload.i, { ended: false });
+        }
+      });
+      server.middlewares.use((req, _res, next) => {
+        const existingId = req.headers[DEBUG_ID_HEADER.toLowerCase()];
+        const isHtml = req.headers.accept?.includes("text/html");
+        if (!existingId && !isHtml) {
+          next();
+          return;
+        }
+        const debugId = existingId || crypto.randomUUID();
+        if (!existingId) {
+          const lowerName = DEBUG_ID_HEADER.toLowerCase();
+          req.headers[lowerName] = debugId;
+          if (req.rawHeaders) {
+            req.rawHeaders.push(DEBUG_ID_HEADER, debugId);
+          }
+        }
+        registerDebugChannel(debugId);
+        console.log(
+          "[perf-tracks] middleware: created channel for",
+          debugId,
+          "from",
+          existingId ? "client header" : "SSR inject"
+        );
+        next();
+      });
+    }
+  };
+}
+
 // src/vite/rango.ts
 async function rango(options) {
   const resolvedOptions = options ?? { preset: "node" };
@@ -4879,7 +5002,6 @@ async function rango(options) {
   const plugins = [];
   const rangoAliases = getPackageAliases();
   const excludeDeps = getExcludeDeps();
-  let rscEntryPath = null;
   const routerRef = { path: void 0 };
   const prerenderEnabled = true;
   if (preset === "cloudflare") {
@@ -4983,153 +5105,121 @@ async function rango(options) {
     );
     plugins.push(clientRefDedup());
   } else {
-    const nodeOptions = resolvedOptions;
-    routerRef.path = nodeOptions.router;
-    if (!routerRef.path) {
-      plugins.push({
-        name: "@rangojs/router:auto-discover",
-        config(userConfig) {
-          if (routerRef.path) return;
-          const root = userConfig.root ? resolve9(process.cwd(), userConfig.root) : process.cwd();
-          const filter = createScanFilter(root, {
-            include: resolvedOptions.include,
-            exclude: resolvedOptions.exclude
-          });
-          const candidates = findRouterFiles(root, filter);
-          if (candidates.length === 1) {
-            const abs = candidates[0];
-            routerRef.path = (abs.startsWith(root) ? "./" + abs.slice(root.length + 1) : abs).replaceAll("\\", "/");
-          } else if (candidates.length > 1) {
-            const list = candidates.map(
-              (f) => "  - " + (f.startsWith(root) ? f.slice(root.length + 1) : f)
-            ).join("\n");
-            throw new Error(
-              `[rsc-router] Multiple routers found. Specify \`router\` to choose one:
-${list}`
-            );
-          }
+    plugins.push({
+      name: "@rangojs/router:auto-discover",
+      config(userConfig) {
+        if (routerRef.path) return;
+        const root = userConfig.root ? resolve9(process.cwd(), userConfig.root) : process.cwd();
+        const candidates = findRouterFiles(root);
+        if (candidates.length === 1) {
+          const abs = candidates[0];
+          routerRef.path = (abs.startsWith(root) ? "./" + abs.slice(root.length + 1) : abs).replaceAll("\\", "/");
+        } else if (candidates.length > 1) {
+          const list = candidates.map(
+            (f) => "  - " + (f.startsWith(root) ? f.slice(root.length + 1) : f)
+          ).join("\n");
+          throw new Error(`[rsc-router] Multiple routers found:
+${list}`);
         }
-      });
-    }
-    const rscOption = nodeOptions.rsc ?? true;
-    if (rscOption !== false) {
-      const { default: rsc } = await import("@vitejs/plugin-rsc");
-      const userEntries = typeof rscOption === "boolean" ? {} : rscOption.entries || {};
-      const finalEntries = {
-        client: userEntries.client ?? VIRTUAL_IDS.browser,
-        ssr: userEntries.ssr ?? VIRTUAL_IDS.ssr,
-        rsc: userEntries.rsc ?? VIRTUAL_IDS.rsc
-      };
-      rscEntryPath = userEntries.rsc ?? null;
-      let hasWarnedDuplicate = false;
-      plugins.push({
-        name: "@rangojs/router:rsc-integration",
-        enforce: "pre",
-        config() {
-          const useVirtualClient = finalEntries.client === VIRTUAL_IDS.browser;
-          const useVirtualSSR = finalEntries.ssr === VIRTUAL_IDS.ssr;
-          const useVirtualRSC = finalEntries.rsc === VIRTUAL_IDS.rsc;
-          return {
-            // Exclude rsc-router modules from optimization to prevent module duplication
-            // This ensures the same Context instance is used by both browser entry and RSC proxy modules
-            optimizeDeps: {
-              exclude: excludeDeps,
-              esbuildOptions: sharedEsbuildOptions
-            },
-            build: {
-              rollupOptions: { onwarn }
-            },
-            resolve: {
-              alias: rangoAliases
-            },
-            environments: {
-              client: {
-                build: {
-                  rollupOptions: {
-                    output: {
-                      manualChunks: getManualChunks
-                    }
-                  }
-                },
-                // Always exclude rsc-router modules, conditionally add virtual entry
-                optimizeDeps: {
-                  // Pre-bundle React and rsc-html-stream to prevent late discovery
-                  // triggering ERR_OUTDATED_OPTIMIZED_DEP on cold starts
-                  include: [
-                    "react",
-                    "react-dom",
-                    "react/jsx-runtime",
-                    "react/jsx-dev-runtime",
-                    "rsc-html-stream/client"
-                  ],
-                  exclude: excludeDeps,
-                  esbuildOptions: sharedEsbuildOptions,
-                  ...useVirtualClient && {
-                    // Tell Vite to scan the virtual entry for dependencies
-                    entries: [VIRTUAL_IDS.browser]
-                  }
-                }
-              },
-              ...useVirtualSSR && {
-                ssr: {
-                  optimizeDeps: {
-                    entries: [VIRTUAL_IDS.ssr],
-                    // Pre-bundle all SSR deps to prevent late discovery triggering ERR_OUTDATED_OPTIMIZED_DEP
-                    include: [
-                      "react",
-                      "react-dom",
-                      "react-dom/server.edge",
-                      "react-dom/static.edge",
-                      "react/jsx-runtime",
-                      "react/jsx-dev-runtime",
-                      "@vitejs/plugin-rsc/vendor/react-server-dom/client.edge"
-                    ],
-                    exclude: excludeDeps,
-                    esbuildOptions: sharedEsbuildOptions
+      }
+    });
+    const finalEntries = {
+      client: VIRTUAL_IDS.browser,
+      ssr: VIRTUAL_IDS.ssr,
+      rsc: VIRTUAL_IDS.rsc
+    };
+    const { default: rsc } = await import("@vitejs/plugin-rsc");
+    let hasWarnedDuplicate = false;
+    plugins.push({
+      name: "@rangojs/router:rsc-integration",
+      enforce: "pre",
+      config() {
+        return {
+          optimizeDeps: {
+            exclude: excludeDeps,
+            esbuildOptions: sharedEsbuildOptions
+          },
+          build: {
+            rollupOptions: { onwarn }
+          },
+          resolve: {
+            alias: rangoAliases
+          },
+          environments: {
+            client: {
+              build: {
+                rollupOptions: {
+                  output: {
+                    manualChunks: getManualChunks
                   }
                 }
               },
-              ...useVirtualRSC && {
-                rsc: {
-                  optimizeDeps: {
-                    entries: [VIRTUAL_IDS.rsc],
-                    // Pre-bundle all RSC deps to prevent late discovery triggering ERR_OUTDATED_OPTIMIZED_DEP
-                    include: [
-                      "react",
-                      "react/jsx-runtime",
-                      "react/jsx-dev-runtime",
-                      "@vitejs/plugin-rsc/vendor/react-server-dom/server.edge"
-                    ],
-                    esbuildOptions: sharedEsbuildOptions
-                  }
-                }
+              optimizeDeps: {
+                include: [
+                  "react",
+                  "react-dom",
+                  "react/jsx-runtime",
+                  "react/jsx-dev-runtime",
+                  "rsc-html-stream/client"
+                ],
+                exclude: excludeDeps,
+                esbuildOptions: sharedEsbuildOptions,
+                entries: [VIRTUAL_IDS.browser]
+              }
+            },
+            ssr: {
+              optimizeDeps: {
+                entries: [VIRTUAL_IDS.ssr],
+                include: [
+                  "react",
+                  "react-dom",
+                  "react-dom/server.edge",
+                  "react-dom/static.edge",
+                  "react/jsx-runtime",
+                  "react/jsx-dev-runtime",
+                  "@vitejs/plugin-rsc/vendor/react-server-dom/client.edge"
+                ],
+                exclude: excludeDeps,
+                esbuildOptions: sharedEsbuildOptions
+              }
+            },
+            rsc: {
+              optimizeDeps: {
+                entries: [VIRTUAL_IDS.rsc],
+                include: [
+                  "react",
+                  "react/jsx-runtime",
+                  "react/jsx-dev-runtime",
+                  "@vitejs/plugin-rsc/vendor/react-server-dom/server.edge"
+                ],
+                esbuildOptions: sharedEsbuildOptions
               }
             }
-          };
-        },
-        configResolved(config) {
-          if (showBanner) {
-            const mode = config.command === "serve" ? process.argv.includes("preview") ? "preview" : "dev" : "build";
-            printBanner(mode, "node", rangoVersion);
-          }
-          const rscMinimalCount = config.plugins.filter(
-            (p) => p.name === "rsc:minimal"
-          ).length;
-          if (rscMinimalCount > 1 && !hasWarnedDuplicate) {
-            hasWarnedDuplicate = true;
-            console.warn(
-              "[rsc-router] Duplicate @vitejs/plugin-rsc detected. Remove rsc() from your config or use rango({ rsc: false }) for manual configuration."
-            );
           }
+        };
+      },
+      configResolved(config) {
+        if (showBanner) {
+          const mode = config.command === "serve" ? process.argv.includes("preview") ? "preview" : "dev" : "build";
+          printBanner(mode, "node", rangoVersion);
         }
-      });
-      plugins.push(createVirtualEntriesPlugin(finalEntries, routerRef));
-      plugins.push(
-        rsc({
-          entries: finalEntries
-        })
-      );
-    }
+        const rscMinimalCount = config.plugins.filter(
+          (p) => p.name === "rsc:minimal"
+        ).length;
+        if (rscMinimalCount > 1 && !hasWarnedDuplicate) {
+          hasWarnedDuplicate = true;
+          console.warn(
+            "[rsc-router] Duplicate @vitejs/plugin-rsc detected. Remove rsc() from your vite config \u2014 rango() includes it automatically."
+          );
+        }
+      }
+    });
+    plugins.push(createVirtualEntriesPlugin(finalEntries, routerRef));
+    plugins.push(
+      rsc({
+        entries: finalEntries
+      })
+    );
     plugins.push(clientRefDedup());
   }
   plugins.push({
@@ -5157,20 +5247,18 @@ ${list}`
   plugins.push(createVersionPlugin());
   const discoveryEntryPath = preset !== "cloudflare" ? routerRef.path : void 0;
   const discoveryRouterRef = preset !== "cloudflare" ? routerRef : void 0;
-  const injectorEntryPath = rscEntryPath ?? (preset === "cloudflare" ? void 0 : null);
-  if (injectorEntryPath !== null) {
-    plugins.push(createVersionInjectorPlugin(injectorEntryPath));
+  if (preset === "cloudflare") {
+    plugins.push(createVersionInjectorPlugin(void 0));
   }
   plugins.push(createCjsToEsmPlugin());
   plugins.push(
     createRouterDiscoveryPlugin(discoveryEntryPath, {
       routerPathRef: discoveryRouterRef,
       enableBuildPrerender: prerenderEnabled,
-      staticRouteTypesGeneration: resolvedOptions.staticRouteTypesGeneration,
-      include: resolvedOptions.include,
-      exclude: resolvedOptions.exclude
+      staticRouteTypesGeneration: resolvedOptions.staticRouteTypesGeneration
     })
   );
+  plugins.push(performanceTracksPlugin());
   return plugins;
 }