@rangojs/router 0.6.0 → 0.8.0

package/dist/vite/index.js

@@ -119,7 +119,7 @@ __export(client_ref_hashing_exports, {
   hashRefKey: () => hashRefKey,
   transformClientRefs: () => transformClientRefs
 });
-import { relative as relative2 } from "node:path";
+import { relative as relative3 } 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 = relative2(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative3(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith(FS_PREFIX)) {
     const absPath = refKey.slice(FS_PREFIX.length - 1);
-    toHash = relative2(projectRoot, absPath).replaceAll("\\", "/");
+    toHash = relative3(projectRoot, absPath).replaceAll("\\", "/");
   } else if (refKey.startsWith("/")) {
     toHash = refKey.slice(1);
   } else {
@@ -1098,10 +1098,11 @@ var init_loader = __esm({
 });
 
 // src/vite/rango.ts
-import { readFileSync as readFileSync9, existsSync as existsSync10 } from "node:fs";
+import { readFileSync as readFileSync10, existsSync as existsSync11 } from "node:fs";
 import { resolve as resolve13 } from "node:path";
 
 // src/vite/plugins/expose-action-id.ts
+import { getPluginApi } from "@vitejs/plugin-rsc";
 import MagicString from "magic-string";
 import path2 from "node:path";
 import fs from "node:fs";
@@ -1358,17 +1359,36 @@ function registerServerReferenceRegex() {
 // src/vite/plugins/expose-action-id.ts
 init_debug();
 var debug = createRangoDebugger(NS.transform);
+function getServerReferenceMetaEntries(manager) {
+  if (manager?.serverReferences?.metaMap) {
+    return manager.serverReferences.metaMap;
+  }
+  if (manager?.serverReferenceMetaMap) {
+    return Object.entries(manager.serverReferenceMetaMap);
+  }
+  throw new Error(
+    "[rango] Unsupported @vitejs/plugin-rsc server reference metadata shape. Expected manager.serverReferences.metaMap or manager.serverReferenceMetaMap."
+  );
+}
 function getRscPluginApi(config) {
-  let plugin = config.plugins.find((p) => p.name === "rsc:minimal");
-  if (!plugin) {
-    plugin = config.plugins.find(
-      (p) => p.api?.manager?.serverReferenceMetaMap !== void 0
-    );
-    if (plugin) {
-      console.warn(
-        `[rango:expose-action-id] RSC plugin found by API structure (name: "${plugin.name}"). Consider updating the name lookup if the plugin was renamed.`
+  const pluginApi = getPluginApi(config);
+  if (pluginApi) {
+    return pluginApi;
+  }
+  const plugin = config.plugins.find((p) => {
+    try {
+      getServerReferenceMetaEntries(
+        p.api?.manager
       );
+      return true;
+    } catch {
+      return false;
     }
+  });
+  if (plugin) {
+    console.warn(
+      `[rango:expose-action-id] RSC plugin found by API structure (name: "${plugin.name}"). Consider updating the name lookup if the plugin was renamed.`
+    );
   }
   return plugin?.api;
 }
@@ -1472,9 +1492,8 @@ function exposeActionId() {
       }
       if (!isBuild) return;
       hashToFileMap = /* @__PURE__ */ new Map();
-      const { serverReferenceMetaMap } = rscPluginApi.manager;
-      for (const [absolutePath, meta] of Object.entries(
-        serverReferenceMetaMap
+      for (const [absolutePath, meta] of getServerReferenceMetaEntries(
+        rscPluginApi.manager
       )) {
         if (!isUseServerModule(absolutePath)) {
           continue;
@@ -3166,8 +3185,11 @@ function warnOnNearMissDirectives(ast, fileId, warn) {
 
 // src/vite/plugins/client-ref-dedup.ts
 init_debug();
+import { existsSync, readFileSync } from "node:fs";
+import { isAbsolute, join, normalize, relative } from "node:path";
 var debug5 = createRangoDebugger(NS.transform);
 var CLIENT_IN_SERVER_PROXY_PREFIX = "virtual:vite-rsc/client-in-server-package-proxy/";
+var DEDUP_PREFIX = "\0rango:dedup/";
 function extractPackageName(absolutePath) {
   const marker = "/node_modules/";
   const idx = absolutePath.lastIndexOf(marker);
@@ -3181,9 +3203,156 @@ function extractPackageName(absolutePath) {
   const name = afterModules.split("/")[0];
   return name || null;
 }
+function stripQueryAndHash(id) {
+  const suffixIndex = id.search(/[?#]/);
+  return suffixIndex === -1 ? id : id.slice(0, suffixIndex);
+}
+function getPackageRoot(source) {
+  const packageName = extractPackageName(source);
+  if (!packageName) return;
+  const marker = "/node_modules/";
+  const markerIndex = source.lastIndexOf(marker);
+  return source.slice(0, markerIndex + marker.length) + packageName;
+}
+function readPackageMetadata(source, cache3) {
+  const root = getPackageRoot(source);
+  if (!root) return;
+  const cached = cache3.get(root);
+  if (cached !== void 0) return cached ?? void 0;
+  const packageJsonPath = join(root, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    cache3.set(root, null);
+    return;
+  }
+  try {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    if (typeof packageJson.name !== "string" || !packageJson.name) {
+      cache3.set(root, null);
+      return;
+    }
+    const metadata = {
+      root,
+      selfName: packageJson.name,
+      exports: packageJson.exports
+    };
+    cache3.set(root, metadata);
+    return metadata;
+  } catch {
+    cache3.set(root, null);
+    return;
+  }
+}
+function collectStringTargets(value, targets) {
+  if (typeof value === "string") {
+    targets.push(value);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectStringTargets(item, targets);
+    return;
+  }
+  if (typeof value !== "object" || value === null) return;
+  for (const target of Object.values(value)) {
+    collectStringTargets(target, targets);
+  }
+}
+function singleStarParts(value) {
+  const starIndex = value.indexOf("*");
+  if (starIndex === -1 || value.indexOf("*", starIndex + 1) !== -1) return;
+  return [value.slice(0, starIndex), value.slice(starIndex + 1)];
+}
+function targetCanMapToSource(target, sourceRelative) {
+  const targetStar = singleStarParts(target);
+  if (!targetStar) return target === sourceRelative;
+  const [prefix, suffix] = targetStar;
+  return sourceRelative.startsWith(prefix) && sourceRelative.endsWith(suffix) && sourceRelative.length >= prefix.length + suffix.length;
+}
+function getPublicSpecifierCandidates(metadata, packageSpecifier, source) {
+  if (typeof metadata.exports !== "object" || metadata.exports === null || Array.isArray(metadata.exports)) {
+    return [];
+  }
+  const candidates = /* @__PURE__ */ new Set();
+  const sourceRelative = `./${relative(metadata.root, source).replaceAll("\\", "/")}`;
+  if (sourceRelative.startsWith("./../") || isAbsolute(sourceRelative.slice(2))) {
+    return [];
+  }
+  for (const [exportKey, target] of Object.entries(metadata.exports)) {
+    if (!exportKey.startsWith("./") || exportKey === ".") continue;
+    const keyStar = singleStarParts(exportKey);
+    if (!keyStar) {
+      const targets2 = [];
+      collectStringTargets(target, targets2);
+      if (targets2.some((target2) => targetCanMapToSource(target2, sourceRelative))) {
+        candidates.add(`${packageSpecifier}${exportKey.slice(1)}`);
+      }
+      continue;
+    }
+    const captures = /* @__PURE__ */ new Set();
+    const targets = [];
+    collectStringTargets(target, targets);
+    for (const targetPattern of targets) {
+      const targetStar = singleStarParts(targetPattern);
+      if (!targetStar) continue;
+      const [prefix, suffix] = targetStar;
+      if (!sourceRelative.startsWith(prefix) || !sourceRelative.endsWith(suffix) || sourceRelative.length < prefix.length + suffix.length) {
+        continue;
+      }
+      captures.add(
+        sourceRelative.slice(
+          prefix.length,
+          sourceRelative.length - suffix.length
+        )
+      );
+    }
+    if (captures.size === 1) {
+      const capture = captures.values().next().value;
+      if (capture !== void 0) {
+        const publicSubpath = `${keyStar[0]}${capture}${keyStar[1]}`;
+        candidates.add(`${packageSpecifier}${publicSubpath.slice(1)}`);
+      }
+    }
+  }
+  return [...candidates];
+}
+function belongsToPackage(resolvedId, packageRoot) {
+  return normalize(getPackageRoot(resolvedId) ?? "") === normalize(packageRoot);
+}
+async function resolvePublicSpecifier(source, metadata, installedSpecifier, resolvePackage, importer) {
+  const packageSpecifiers = installedSpecifier === metadata.selfName ? [installedSpecifier] : [installedSpecifier, metadata.selfName];
+  for (const packageSpecifier of packageSpecifiers) {
+    for (const candidate of getPublicSpecifierCandidates(
+      metadata,
+      packageSpecifier,
+      source
+    )) {
+      try {
+        const resolved = await resolvePackage(candidate, importer);
+        if (!resolved) continue;
+        const resolvedId = stripQueryAndHash(resolved);
+        if (normalize(resolvedId) === normalize(source) && belongsToPackage(resolvedId, metadata.root)) {
+          return candidate;
+        }
+      } catch {
+        continue;
+      }
+    }
+    try {
+      const rootResolved = await resolvePackage(packageSpecifier, importer);
+      if (rootResolved && belongsToPackage(stripQueryAndHash(rootResolved), metadata.root)) {
+        return packageSpecifier;
+      }
+    } catch {
+      continue;
+    }
+  }
+}
 function clientRefDedup() {
   let clientExclude = [];
+  let rootImporter = "";
+  let resolvePackage;
   const dedupedPackages = /* @__PURE__ */ new Set();
+  const packageMetadataCache = /* @__PURE__ */ new Map();
+  const publicSpecifierCache = /* @__PURE__ */ new Map();
   return {
     name: "@rangojs/router:client-ref-dedup",
     enforce: "pre",
@@ -3191,6 +3360,8 @@ function clientRefDedup() {
     configResolved(config) {
       const clientEnv = config.environments?.["client"];
       clientExclude = clientEnv?.optimizeDeps?.exclude ?? config.optimizeDeps?.exclude ?? [];
+      rootImporter = join(config.root, "index.html");
+      resolvePackage = config.createResolver({ scan: true });
     },
     buildEnd() {
       if (debug5 && dedupedPackages.size > 0) {
@@ -3205,18 +3376,52 @@ function clientRefDedup() {
       if (this.environment?.name !== "client") return;
       if (!importer?.includes(CLIENT_IN_SERVER_PROXY_PREFIX)) return;
       if (!source.includes("/node_modules/")) return;
-      const packageName = extractPackageName(source);
-      if (!packageName) return;
+      const cleanSource = stripQueryAndHash(source);
+      const packageName = extractPackageName(cleanSource);
+      if (!packageName || !resolvePackage) return;
       if (clientExclude.includes(packageName)) return;
-      if (debug5) dedupedPackages.add(packageName);
-      return `\0rango:dedup/${packageName}`;
+      const metadata = readPackageMetadata(cleanSource, packageMetadataCache);
+      if (!metadata || clientExclude.includes(metadata.selfName)) return;
+      let specifierPromise = publicSpecifierCache.get(cleanSource);
+      if (!specifierPromise) {
+        specifierPromise = resolvePublicSpecifier(
+          cleanSource,
+          metadata,
+          packageName,
+          resolvePackage,
+          rootImporter
+        );
+        publicSpecifierCache.set(cleanSource, specifierPromise);
+        void specifierPromise.then(
+          (specifier) => {
+            if (!specifier && publicSpecifierCache.get(cleanSource) === specifierPromise) {
+              publicSpecifierCache.delete(cleanSource);
+            }
+          },
+          () => {
+            if (publicSpecifierCache.get(cleanSource) === specifierPromise) {
+              publicSpecifierCache.delete(cleanSource);
+            }
+          }
+        );
+      }
+      return specifierPromise.then((specifier) => {
+        if (!specifier) return;
+        if (debug5) dedupedPackages.add(packageName);
+        return `${DEDUP_PREFIX}${encodeURIComponent(specifier)}`;
+      });
     },
     load(id) {
-      if (!id.startsWith("\0rango:dedup/")) return;
-      const packageName = id.slice("\0rango:dedup/".length);
+      if (!id.startsWith(DEDUP_PREFIX)) return;
+      let specifier;
+      try {
+        specifier = decodeURIComponent(id.slice(DEDUP_PREFIX.length));
+      } catch {
+        return;
+      }
       return [
-        `export * from ${JSON.stringify(packageName)};`,
-        `import * as __all__ from ${JSON.stringify(packageName)};`,
+        `export * from ${JSON.stringify(specifier)};`,
+        `import * as __all__ from ${JSON.stringify(specifier)};`,
         `export default __all__.default;`
       ].join("\n");
     }
@@ -3473,14 +3678,14 @@ function getVirtualVersionContent(version) {
 }
 
 // src/vite/utils/package-resolution.ts
-import { existsSync } from "node:fs";
+import { existsSync as existsSync2 } from "node:fs";
 import { createRequire } from "node:module";
 import { resolve } from "node:path";
 
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.6.0",
+  version: "0.8.0",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -3662,6 +3867,7 @@ var package_default = {
     prepublishOnly: "pnpm build",
     typecheck: "tsc --noEmit && tsc -p tsconfig.strict-check.json --noEmit && tsc -p tsconfig.augment-check.json --noEmit",
     test: "playwright test",
+    "test:preload": "playwright test --config=playwright.preload.config.ts",
     "test:ui": "playwright test --ui",
     "test:hmr-local": "playwright test --project=dev-warmup --project=hmr-basename --project=hmr-prerender --no-deps --workers=1 && RANGO_E2E_ROUTE_HMR_ONLY=1 playwright test --project=hmr-routes --no-deps --workers=1",
     "test:hmr-routes-local": "RANGO_E2E_ROUTE_HMR_ONLY=1 playwright test --project=hmr-routes --no-deps --workers=1",
@@ -3671,7 +3877,7 @@ var package_default = {
   },
   dependencies: {
     "@types/debug": "^4.1.12",
-    "@vitejs/plugin-rsc": "^0.5.30",
+    "@vitejs/plugin-rsc": "^0.5.31",
     debug: "^4.4.1",
     "magic-string": "^0.30.17",
     picomatch: "^4.0.4",
@@ -3704,9 +3910,9 @@ var package_default = {
     "@playwright/test": "^1.49.1",
     "@testing-library/react": ">=16",
     "@vercel/functions": "^3.0.0",
-    "@vitejs/plugin-rsc": "^0.5.30",
-    react: ">=19.2.6 <20",
-    "react-dom": ">=19.2.6 <20",
+    "@vitejs/plugin-rsc": "^0.5.31",
+    react: ">=19.2.8 <20",
+    "react-dom": ">=19.2.8 <20",
     vite: "^8.0.16",
     vitest: ">=3"
   },
@@ -3746,7 +3952,7 @@ function getPublishedPackageName() {
 }
 function isInstalledFromNpm() {
   const packageName = getPublishedPackageName();
-  return existsSync(resolve(process.cwd(), "node_modules", packageName));
+  return existsSync2(resolve(process.cwd(), "node_modules", packageName));
 }
 function isWorkspaceDevelopment() {
   return !isInstalledFromNpm();
@@ -3932,7 +4138,7 @@ declare global {
 }
 
 // src/build/route-types/scan-filter.ts
-import { join, relative } from "node:path";
+import { join as join2, relative as relative2 } from "node:path";
 import { readdirSync } from "node:fs";
 import picomatch from "picomatch";
 var DEFAULT_EXCLUDE_PATTERNS = [
@@ -3952,7 +4158,7 @@ function createScanFilter(root, opts) {
   const includeMatcher = hasInclude ? picomatch(include) : null;
   const excludeMatcher = effectiveExclude.length > 0 ? picomatch(effectiveExclude) : null;
   return (absolutePath) => {
-    const rel = relative(root, absolutePath);
+    const rel = relative2(root, absolutePath);
     if (excludeMatcher && excludeMatcher(rel)) return false;
     if (includeMatcher) return includeMatcher(rel);
     return true;
@@ -3970,7 +4176,7 @@ function findTsFiles(dir, filter) {
     return results;
   }
   for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
+    const fullPath = join2(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".") || entry.name === "dist" || entry.name === "build" || entry.name === "coverage")
         continue;
@@ -3987,7 +4193,7 @@ function findTsFiles(dir, filter) {
 import ts4 from "typescript";
 
 // src/build/route-types/include-resolution.ts
-import { readFileSync, existsSync as existsSync2 } from "node:fs";
+import { readFileSync as readFileSync2, existsSync as existsSync3 } from "node:fs";
 import { dirname, resolve as resolve2 } from "node:path";
 import ts3 from "typescript";
 function createScanMemo() {
@@ -4013,7 +4219,7 @@ function readSourceMemoized(memo, realPath) {
     const cached = memo.files.get(realPath);
     if (cached !== void 0) return cached;
   }
-  const source = readFileSync(realPath, "utf-8");
+  const source = readFileSync2(realPath, "utf-8");
   if (memo) memo.files.set(realPath, source);
   return source;
 }
@@ -4225,7 +4431,7 @@ function resolveImportPath(importSpec, fromFile) {
     resolve2(dir, base + "/index.jsx")
   ];
   for (const candidate of candidates) {
-    if (existsSync2(candidate)) return candidate;
+    if (existsSync3(candidate)) return candidate;
   }
   return null;
 }
@@ -4526,14 +4732,14 @@ function buildCombinedRouteMapWithSearch(filePath, variableName, visited, diagno
 
 // src/build/route-types/router-processing.ts
 import {
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   writeFileSync,
-  existsSync as existsSync3,
+  existsSync as existsSync4,
   unlinkSync,
   readdirSync as readdirSync2
 } from "node:fs";
 import {
-  join as join2,
+  join as join3,
   dirname as dirname2,
   resolve as resolve3,
   sep,
@@ -4572,7 +4778,7 @@ function findCallSiteFilesRecursive(dir, pattern, patternG, stopAtMatchDir, filt
   const childDirs = [];
   const matchesInDir = [];
   for (const entry of entries) {
-    const fullPath = join2(dir, entry.name);
+    const fullPath = join3(dir, entry.name);
     if (entry.isDirectory()) {
       if (!isExcludedScanDir(entry.name)) childDirs.push(fullPath);
       continue;
@@ -4580,7 +4786,7 @@ function findCallSiteFilesRecursive(dir, pattern, patternG, stopAtMatchDir, filt
     if (!isRoutableSourceFile(entry.name)) continue;
     if (filter && !filter(fullPath)) continue;
     try {
-      const source = readFileSync2(fullPath, "utf-8");
+      const source = readFileSync3(fullPath, "utf-8");
       if (pattern.test(source) && firstCodeMatchIndex(source, patternG) >= 0) {
         matchesInDir.push(fullPath);
       }
@@ -4802,7 +5008,7 @@ function mergeRouteMaps(target, source) {
 }
 function genFileTsPath(sourceFile) {
   const base = pathBasename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-  return join2(dirname2(sourceFile), `${base}.named-routes.gen.ts`);
+  return join3(dirname2(sourceFile), `${base}.named-routes.gen.ts`);
 }
 function resolveSearchSchemas(publicRouteNames, runtimeSchemas, sourceFile) {
   if (runtimeSchemas && Object.keys(runtimeSchemas).length > 0) {
@@ -4822,7 +5028,7 @@ function resolveSearchSchemas(publicRouteNames, runtimeSchemas, sourceFile) {
 function buildCombinedRouteMapForRouterFile(routerFilePath) {
   let routerSource;
   try {
-    routerSource = readFileSync2(routerFilePath, "utf-8");
+    routerSource = readFileSync3(routerFilePath, "utf-8");
   } catch {
     return { routes: {}, searchSchemas: {} };
   }
@@ -4879,8 +5085,8 @@ function findHostRouterFiles(root, filter) {
 }
 function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
   try {
-    const oldCombinedPath = join2(root, "src", "named-routes.gen.ts");
-    if (existsSync3(oldCombinedPath)) {
+    const oldCombinedPath = join3(root, "src", "named-routes.gen.ts");
+    if (existsSync4(oldCombinedPath)) {
       unlinkSync(oldCombinedPath);
       console.log(
         `[rango] Removed stale combined route types: ${oldCombinedPath}`
@@ -4899,14 +5105,14 @@ function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
     if (Object.keys(result.routes).length === 0 && Object.keys(result.searchSchemas).length === 0) {
       let routerSource;
       try {
-        routerSource = readFileSync2(routerFilePath, "utf-8");
+        routerSource = readFileSync3(routerFilePath, "utf-8");
       } catch {
         continue;
       }
       if (!extractUrlsFromRouter(routerSource)) continue;
     }
     const outPath = genFileTsPath(routerFilePath);
-    const existing = existsSync3(outPath) ? readFileSync2(outPath, "utf-8") : null;
+    const existing = existsSync4(outPath) ? readFileSync3(outPath, "utf-8") : null;
     if (Object.keys(result.routes).length === 0) {
       if (!existing) {
         const emptySource = generateRouteTypesSource({});
@@ -5155,7 +5361,7 @@ function isViteDepCachePath(filePath, cacheDir) {
 
 // src/vite/utils/shared-utils.ts
 import * as Vite from "vite";
-import { isAbsolute, resolve as resolve4 } from "node:path";
+import { isAbsolute as isAbsolute2, resolve as resolve4 } from "node:path";
 
 // src/vite/plugins/performance-tracks.ts
 init_debug();
@@ -5242,7 +5448,7 @@ var sharedRolldownOptions = {
 function normalizeHostRouterEntry(rawInput, root, exists) {
   const raw = rawInput.replaceAll("\\", "/");
   const isRelative = raw.startsWith("./") || raw.startsWith("../");
-  const isRooted = raw.startsWith("/") || isAbsolute(rawInput);
+  const isRooted = raw.startsWith("/") || isAbsolute2(rawInput);
   if (isRooted) return raw;
   if (isRelative) {
     if (!exists(resolve4(root, raw))) {
@@ -5402,8 +5608,8 @@ function resolveClientChunks(option, ctx) {
 
 // src/vite/plugins/vercel-output.ts
 import { rm, mkdir, cp, writeFile } from "node:fs/promises";
-import { existsSync as existsSync4 } from "node:fs";
-import { resolve as resolve5, join as join3 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { resolve as resolve5, join as join4 } from "node:path";
 import { createRequire as createRequire2 } from "node:module";
 import { pathToFileURL } from "node:url";
 var LAUNCHER_SOURCE = `import { toNodeHandler } from "srvx/node";
@@ -5476,14 +5682,14 @@ async function assemble(root, options, assetsDir, publicDir) {
   const vercel = options.vercel ?? {};
   assertVercelNodeRuntime(vercel.runtime);
   const assetsPrefix = assetsDir.replace(/^\/+|\/+$/g, "");
-  if (publicDir && assetsPrefix && existsSync4(join3(publicDir, assetsPrefix))) {
+  if (publicDir && assetsPrefix && existsSync5(join4(publicDir, assetsPrefix))) {
     console.warn(
-      `[rango] preset "vercel": ${join3(publicDir, assetsPrefix)} exists. Files under public/${assetsPrefix}/ share the /${assetsPrefix}/ URL prefix with hashed build assets and will be served with a one-year immutable cache-control header. Move un-hashed public files out of "${assetsPrefix}/".`
+      `[rango] preset "vercel": ${join4(publicDir, assetsPrefix)} exists. Files under public/${assetsPrefix}/ share the /${assetsPrefix}/ URL prefix with hashed build assets and will be served with a one-year immutable cache-control header. Move un-hashed public files out of "${assetsPrefix}/".`
     );
   }
-  const dist = join3(root, "dist");
+  const dist = join4(root, "dist");
   for (const dir of ["client", "rsc", "ssr"]) {
-    if (!existsSync4(join3(dist, dir))) {
+    if (!existsSync5(join4(dist, dir))) {
       throw new Error(
         `[rango] preset "vercel": missing dist/${dir}. Run the production build first.`
       );
@@ -5491,15 +5697,15 @@ async function assemble(root, options, assetsDir, publicDir) {
   }
   const functionName = vercel.functionName ?? "index";
   assertValidVercelFunctionName(functionName);
-  const out = join3(root, ".vercel", "output");
-  const funcDir = join3(out, "functions", `${functionName}.func`);
+  const out = join4(root, ".vercel", "output");
+  const funcDir = join4(out, "functions", `${functionName}.func`);
   await rm(out, { recursive: true, force: true });
   await mkdir(funcDir, { recursive: true });
-  await cp(join3(dist, "client"), join3(out, "static"), { recursive: true });
-  await cp(join3(dist, "rsc"), join3(funcDir, "rsc"), { recursive: true });
-  await cp(join3(dist, "ssr"), join3(funcDir, "ssr"), { recursive: true });
-  if (existsSync4(join3(dist, "static"))) {
-    await cp(join3(dist, "static"), join3(funcDir, "static"), {
+  await cp(join4(dist, "client"), join4(out, "static"), { recursive: true });
+  await cp(join4(dist, "rsc"), join4(funcDir, "rsc"), { recursive: true });
+  await cp(join4(dist, "ssr"), join4(funcDir, "ssr"), { recursive: true });
+  if (existsSync5(join4(dist, "static"))) {
+    await cp(join4(dist, "static"), join4(funcDir, "static"), {
       recursive: true
     });
   }
@@ -5512,7 +5718,7 @@ async function assemble(root, options, assetsDir, publicDir) {
       '[rango] preset "vercel" requires "srvx" (a dependency of @rangojs/router). Reinstall dependencies.'
     );
   }
-  const appRequire = createRequire2(join3(root, "package.json"));
+  const appRequire = createRequire2(join4(root, "package.json"));
   const resolveEsbuildPath = () => {
     try {
       const viteRequire = createRequire2(appRequire.resolve("vite"));
@@ -5545,7 +5751,7 @@ async function assemble(root, options, assetsDir, publicDir) {
         sourcefile: "func-entry.mjs",
         loader: "js"
       },
-      outfile: join3(funcDir, "index.mjs"),
+      outfile: join4(funcDir, "index.mjs"),
       bundle: true,
       format: "esm",
       platform: "node",
@@ -5573,15 +5779,15 @@ async function assemble(root, options, assetsDir, publicDir) {
     throw error;
   }
   await writeFile(
-    join3(funcDir, "package.json"),
+    join4(funcDir, "package.json"),
     JSON.stringify({ type: "module" }, null, 2) + "\n"
   );
   await writeFile(
-    join3(funcDir, ".vc-config.json"),
+    join4(funcDir, ".vc-config.json"),
     JSON.stringify(buildVercelVcConfig(vercel), null, 2) + "\n"
   );
   await writeFile(
-    join3(out, "config.json"),
+    join4(out, "config.json"),
     JSON.stringify(buildVercelOutputConfig(functionName, assetsDir), null, 2) + "\n"
   );
   console.log(
@@ -5764,7 +5970,7 @@ function createCjsToEsmPlugin() {
 // src/vite/router-discovery.ts
 import { createServer as createViteServer } from "vite";
 import { resolve as resolve12 } from "node:path";
-import { readFileSync as readFileSync8 } from "node:fs";
+import { readFileSync as readFileSync9 } from "node:fs";
 import { createRequire as createRequire3, register } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 
@@ -6129,7 +6335,7 @@ function createDiscoveryState(entryPath, opts) {
 
 // src/vite/discovery/self-gen-tracking.ts
 import { createHash as createHash3 } from "node:crypto";
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 function markSelfGenWrite(state, filePath, content) {
   const hash = createHash3("sha256").update(content).digest("hex");
   state.selfWrittenGenFiles.set(filePath, { at: Date.now(), hash });
@@ -6148,7 +6354,7 @@ function checkSelfGenWrite(state, filePath, consume) {
     return false;
   }
   try {
-    const current = readFileSync3(filePath, "utf-8");
+    const current = readFileSync4(filePath, "utf-8");
     const currentHash = createHash3("sha256").update(current).digest("hex");
     if (currentHash === info.hash) {
       if (consume) state.selfWrittenGenFiles.delete(filePath);
@@ -6646,7 +6852,7 @@ function contextSet(variables, keyOrVar, value, options) {
 import { createHash as createHash4 } from "node:crypto";
 import {
   copyFileSync,
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync,
   rmSync,
   statSync,
@@ -6818,7 +7024,7 @@ function writeBuildAssetModule(dir, prefix, exportValue) {
   const contentHash = createHash4("sha256").update(exportValue).digest("hex").slice(0, 8);
   const fileName = `${prefix}-${contentHash}.js`;
   const filePath = resolve7(dir, fileName);
-  if (!existsSync5(filePath)) {
+  if (!existsSync6(filePath)) {
     writeFileSync2(filePath, `export default ${exportValue};
 `);
   }
@@ -7326,8 +7532,8 @@ init_debug();
 init_client_ref_hashing();
 
 // src/vite/discovery/client-urls-projection.ts
-import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
-import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolve8 } from "node:path";
+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 normalizePath4, parseAst as parseAst5 } from "vite";
 
 // src/client-urls/server-projection.ts
@@ -8696,7 +8902,14 @@ var SEARCH_SCHEMA_VALUES = /* @__PURE__ */ new Set([
 var PROJECTION_OPTIONS = /* @__PURE__ */ new Set([
   "name",
   "search",
-  "trailingSlash"
+  "trailingSlash",
+  "ppr"
+]);
+var PPR_NUMBER_KEYS = /* @__PURE__ */ new Set([
+  "ttl",
+  "swr",
+  "captureTimeout",
+  "maxSnapshotBytes"
 ]);
 function routeDescription(route2) {
   return `route "${route2.pattern}" (${route2.id})`;
@@ -8727,9 +8940,6 @@ function serializeOptions(route2) {
   const source = route2.options;
   if (!source) return Object.freeze({});
   for (const key of Reflect.ownKeys(source)) {
-    if (key === "ppr") {
-      throw projectionError(route2, 'path option "ppr" is not supported');
-    }
     if (!PROJECTION_OPTIONS.has(key)) {
       throw projectionError(
         route2,
@@ -8744,8 +8954,50 @@ function serializeOptions(route2) {
   if (source.trailingSlash !== void 0) {
     options.trailingSlash = source.trailingSlash;
   }
+  if (source.ppr !== void 0) {
+    options.ppr = serializePpr(route2, source.ppr);
+  }
   return Object.freeze(options);
 }
+function serializePpr(route2, source) {
+  if (source === true) return true;
+  if (typeof source !== "object" || source === null || Array.isArray(source)) {
+    throw projectionError(
+      route2,
+      'path option "ppr" must be true or a PartialPrerenderProps object'
+    );
+  }
+  const out = {};
+  for (const key of Reflect.ownKeys(source)) {
+    if (PPR_NUMBER_KEYS.has(key)) {
+      const value = source[key];
+      if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw projectionError(
+          route2,
+          `path option "ppr.${String(key)}" must be a finite number`
+        );
+      }
+      out[key] = value;
+      continue;
+    }
+    if (key === "tags") {
+      const tags = source.tags;
+      if (!Array.isArray(tags) || tags.some((tag) => typeof tag !== "string" || tag === "")) {
+        throw projectionError(
+          route2,
+          'path option "ppr.tags" must be an array of non-empty strings'
+        );
+      }
+      out.tags = Object.freeze([...tags]);
+      continue;
+    }
+    throw projectionError(
+      route2,
+      `path option "ppr.${String(key)}" is not supported`
+    );
+  }
+  return Object.freeze(out);
+}
 function serializeTransition(route2) {
   const source = route2.transition;
   if (!source) return void 0;
@@ -8828,7 +9080,7 @@ function hasDefaultExport(code) {
 }
 function normalizeSource(state, id) {
   const cleanId = id.split("?", 1)[0];
-  const absoluteId = isAbsolute2(cleanId) ? cleanId : resolve8(state.projectRoot, cleanId);
+  const absoluteId = isAbsolute3(cleanId) ? cleanId : resolve8(state.projectRoot, cleanId);
   return normalizePath4(absoluteId);
 }
 function referenceId(referenceKey) {
@@ -8840,8 +9092,8 @@ function recordClientUrlsModule(state, code, id) {
   }
   const source = normalizeSource(state, id);
   const projectRoot = normalizePath4(resolve8(state.projectRoot));
-  const relativeId = normalizePath4(relative3(projectRoot, source));
-  const outsideProject = relativeId === ".." || relativeId.startsWith("../") || isAbsolute2(relativeId);
+  const relativeId = normalizePath4(relative4(projectRoot, source));
+  const outsideProject = relativeId === ".." || relativeId.startsWith("../") || isAbsolute3(relativeId);
   const devReferenceKey = outsideProject ? `/@fs${source}` : `/${relativeId}`;
   const sourceByReferenceId = state.clientUrlSourceByReferenceId ??= /* @__PURE__ */ new Map();
   sourceByReferenceId.set(referenceId(devReferenceKey), source);
@@ -8858,7 +9110,7 @@ function scanForClientUrlModules(state) {
   for (const filePath of findTsFiles(state.projectRoot, state.scanFilter)) {
     let code;
     try {
-      code = readFileSync4(filePath, "utf-8");
+      code = readFileSync5(filePath, "utf-8");
     } catch {
       continue;
     }
@@ -8940,7 +9192,7 @@ async function discoverClientUrlProjections(state, ssrEnv, serverMod) {
     try {
       module = await ssrEnv.runner.import(source);
     } catch (cause) {
-      if (!existsSync6(source)) {
+      if (!existsSync7(source)) {
         removedSources.push(source);
         continue;
       }
@@ -9180,8 +9432,8 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
 }
 
 // src/vite/discovery/shell-prerender-phase.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join4, resolve as resolve9 } from "node:path";
+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";
 
 // src/prerender/shell-manifest-key.ts
 function buildShellManifestKey(pathname) {
@@ -9235,8 +9487,8 @@ async function runShellPrerenderPhase(s, builder) {
       "@rangojs/router/internal/deps/html-stream-server"
     );
     const clientOutDir = builder?.environments?.client?.config?.build?.outDir ?? resolve9(s.projectRoot, "dist/client");
-    const clientAssetsDir = join4(clientOutDir, "assets");
-    const entryFile = existsSync7(clientAssetsDir) ? readdirSync3(clientAssetsDir).find((f) => /^index-.*\.js$/.test(f)) : void 0;
+    const clientAssetsDir = join5(clientOutDir, "assets");
+    const entryFile = existsSync8(clientAssetsDir) ? readdirSync3(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.`
@@ -9403,7 +9655,7 @@ async function runShellPrerenderPhase(s, builder) {
 }
 function writeShellManifest(s, rscOutDir, staged) {
   const rscEntryPath = resolve9(rscOutDir, s.rscEntryFileName ?? "index.js");
-  if (!existsSync7(rscEntryPath)) {
+  if (!existsSync8(rscEntryPath)) {
     console.warn(
       `[rango] shell prerender: RSC entry not found at ${rscEntryPath}; entries not persisted \u2014 routes keep runtime capture.`
     );
@@ -9429,7 +9681,7 @@ function writeShellManifest(s, rscOutDir, staged) {
   ].join("\n");
   writeFileSync3(resolve9(rscOutDir, "__shell-manifest.js"), manifestCode);
   totalBytes += Buffer.byteLength(manifestCode);
-  const rscCode = readFileSync5(rscEntryPath, "utf-8");
+  const rscCode = readFileSync6(rscEntryPath, "utf-8");
   if (!rscCode.includes("__shell-manifest.js")) {
     const injection = `globalThis.__loadShellManifestModule = () => import("./__shell-manifest.js");
 `;
@@ -9479,8 +9731,8 @@ function createDevPrerenderCache(maxEntriesPerRouter = MAX_ENTRIES_PER_ROUTER) {
 }
 
 // src/vite/discovery/route-types-writer.ts
-import { dirname as dirname3, join as join5, resolve as resolve10 } from "node:path";
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync4, existsSync as existsSync8, unlinkSync as unlinkSync2 } from "node:fs";
+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";
 function filterUserNamedRoutes(manifest) {
   const filtered = {};
   for (const [name, pattern] of Object.entries(manifest)) {
@@ -9491,7 +9743,7 @@ function filterUserNamedRoutes(manifest) {
   return filtered;
 }
 function writeGenFileIfChanged(state, outPath, source, opts) {
-  const existing = existsSync8(outPath) ? readFileSync6(outPath, "utf-8") : null;
+  const existing = existsSync9(outPath) ? readFileSync7(outPath, "utf-8") : null;
   if (existing === source) return;
   markSelfGenWrite(state, outPath, source);
   writeFileSync4(outPath, source);
@@ -9511,8 +9763,8 @@ function writeRouteTypesFiles(state) {
     const entryDir = dirname3(
       resolve10(state.projectRoot, state.resolvedEntryPath)
     );
-    const oldCombinedPath = join5(entryDir, "named-routes.gen.ts");
-    if (existsSync8(oldCombinedPath)) {
+    const oldCombinedPath = join6(entryDir, "named-routes.gen.ts");
+    if (existsSync9(oldCombinedPath)) {
       unlinkSync2(oldCombinedPath);
       console.log(
         `[rango] Removed stale combined route types: ${oldCombinedPath}`
@@ -9594,7 +9846,7 @@ 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 join6 } from "node:path";
+import { dirname as dirname4, basename, join as join7 } from "node:path";
 var MANIFEST_EXTERNALIZE_THRESHOLD = 512 * 1024;
 function devDiscoveryBootstrap(state) {
   if (state.isBuildMode || state.opts?.preset !== "cloudflare" || state.devDiscoveryEpoch === void 0) {
@@ -9617,7 +9869,7 @@ function generateRoutesManifestModule(state) {
           /\.(tsx?|jsx?)$/,
           ""
         );
-        const genPath = join6(
+        const genPath = join7(
           routerDir,
           `${routerBasename}.named-routes.gen.js`
         ).replaceAll("\\", "/");
@@ -9730,7 +9982,7 @@ function generatePerRouterModule(state, routerId) {
   if (sourceFile) {
     const routerDir = dirname4(sourceFile);
     const routerBasename = basename(sourceFile).replace(/\.(tsx?|jsx?)$/, "");
-    const genPath = join6(
+    const genPath = join7(
       routerDir,
       `${routerBasename}.named-routes.gen.js`
     ).replaceAll("\\", "/");
@@ -9744,10 +9996,10 @@ 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 = join6(state.projectRoot, "node_modules", ".rango");
+    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 = join6(dir, `manifest-${safeId}.txt`).replaceAll("\\", "/");
+    const filePath = join7(dir, `manifest-${safeId}.txt`).replaceAll("\\", "/");
     writeFileSync5(filePath, payloadJson);
     lines.push(`import __manifestJson from ${JSON.stringify(filePath)};`);
     lines.push(`const __manifestData = JSON.parse(__manifestJson);`);
@@ -9778,7 +10030,7 @@ function emitManifestExports(lines, hasTrie, hasEntries) {
 
 // src/vite/discovery/bundle-postprocess.ts
 import { resolve as resolve11 } from "node:path";
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, existsSync as existsSync9 } from "node:fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync10 } 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;
@@ -9806,7 +10058,7 @@ function postprocessBundle(state) {
     for (const info of target.infos) {
       const chunkPath = resolve11(state.projectRoot, "dist/rsc", info.fileName);
       try {
-        const code = readFileSync7(chunkPath, "utf-8");
+        const code = readFileSync8(chunkPath, "utf-8");
         const result = evictHandlerCode(
           code,
           info.exports,
@@ -9829,8 +10081,8 @@ function postprocessBundle(state) {
   }
   state.handlerChunkInfoMap.clear();
   state.staticHandlerChunkInfoMap.clear();
-  if (hasPrerenderData && existsSync9(rscEntryPath)) {
-    const rscCode = readFileSync7(rscEntryPath, "utf-8");
+  if (hasPrerenderData && existsSync10(rscEntryPath)) {
+    const rscCode = readFileSync8(rscEntryPath, "utf-8");
     if (!rscCode.includes("__prerender-manifest.js")) {
       try {
         let totalBytes = copyStagedBuildAssets(
@@ -9869,8 +10121,8 @@ function postprocessBundle(state) {
       }
     }
   }
-  if (hasStaticData && existsSync9(rscEntryPath)) {
-    const rscCode = readFileSync7(rscEntryPath, "utf-8");
+  if (hasStaticData && existsSync10(rscEntryPath)) {
+    const rscCode = readFileSync8(rscEntryPath, "utf-8");
     if (!rscCode.includes("__static-manifest.js")) {
       try {
         const manifestEntries = [];
@@ -11165,7 +11417,7 @@ function createRouterDiscoveryPlugin(entryPath, opts) {
           }
           const inRecoveryMode = !!s.lastDiscoveryError;
           try {
-            const source = readFileSync8(filePath, "utf-8");
+            const source = readFileSync9(filePath, "utf-8");
             const trimmed = source.trimStart();
             const isUseClient = trimmed.startsWith('"use client"') || trimmed.startsWith("'use client'");
             let hasClientUrls = source.includes("clientUrls(");
@@ -11725,7 +11977,7 @@ async function rango(options) {
           routerRef.path = normalizeHostRouterEntry(
             explicitHostRouter,
             root,
-            existsSync10
+            existsSync11
           );
           routerRef.kind = "host";
           return;
@@ -11915,7 +12167,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 = readFileSync9(file, "utf-8");
+        const source = readFileSync10(file, "utf-8");
         if (hasUseClientDirective(source)) {
           return [];
         }