@rangojs/router 0.15.1 → 0.17.0

package/dist/vite/index.js

@@ -22,26 +22,26 @@ function createRangoDebugger(namespace) {
   if (shadow.enabled) return shadow;
   return void 0;
 }
-async function timed(debug14, label, fn) {
-  if (!debug14) return await fn();
+async function timed(debug13, label, fn) {
+  if (!debug13) return await fn();
   const start = performance.now();
   try {
     return await fn();
   } finally {
-    debug14("%s (%sms)", label, (performance.now() - start).toFixed(1));
+    debug13("%s (%sms)", label, (performance.now() - start).toFixed(1));
   }
 }
-function timedSync(debug14, label, fn) {
-  if (!debug14) return fn();
+function timedSync(debug13, label, fn) {
+  if (!debug13) return fn();
   const start = performance.now();
   try {
     return fn();
   } finally {
-    debug14("%s (%sms)", label, (performance.now() - start).toFixed(1));
+    debug13("%s (%sms)", label, (performance.now() - start).toFixed(1));
   }
 }
-function createCounter(debug14, label) {
-  if (!debug14) return void 0;
+function createCounter(debug13, label) {
+  if (!debug13) return void 0;
   let n = 0;
   let totalMs = 0;
   let slowestMs = 0;
@@ -75,7 +75,7 @@ function createCounter(debug14, label) {
     },
     flush() {
       if (n === 0) return;
-      debug14(
+      debug13(
         "%s: %d files, %sms total, slowest %sms %s",
         label,
         n,
@@ -158,7 +158,7 @@ function transformClientRefs(code, projectRoot) {
   return hasReplacement ? result : null;
 }
 function hashClientRefs(projectRoot) {
-  const counter = createCounter(debug7, "hash-client-refs");
+  const counter = createCounter(debug6, "hash-client-refs");
   return {
     name: "@rangojs/router:hash-client-refs",
     enforce: "post",
@@ -180,12 +180,12 @@ function hashClientRefs(projectRoot) {
     }
   };
 }
-var debug7, CLIENT_PKG_PROXY_PREFIX, CLIENT_IN_SERVER_PKG_PROXY_PREFIX, FS_PREFIX, REGISTER_CLIENT_REF_RE;
+var debug6, CLIENT_PKG_PROXY_PREFIX, CLIENT_IN_SERVER_PKG_PROXY_PREFIX, FS_PREFIX, REGISTER_CLIENT_REF_RE;
 var init_client_ref_hashing = __esm({
   "src/vite/plugins/client-ref-hashing.ts"() {
     "use strict";
     init_debug();
-    debug7 = createRangoDebugger(NS.transform);
+    debug6 = createRangoDebugger(NS.transform);
     CLIENT_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-package-proxy/";
     CLIENT_IN_SERVER_PKG_PROXY_PREFIX = "/@id/__x00__virtual:vite-rsc/client-in-server-package-proxy/";
     FS_PREFIX = "/@fs/";
@@ -193,6 +193,30 @@ var init_client_ref_hashing = __esm({
   }
 });
 
+// src/internal-debug.ts
+var INTERNAL_RANGO_DEBUG;
+var init_internal_debug = __esm({
+  "src/internal-debug.ts"() {
+    "use strict";
+    INTERNAL_RANGO_DEBUG = typeof process !== "undefined" && Boolean(process.env?.INTERNAL_RANGO_DEBUG);
+  }
+});
+
+// src/browser/logging.ts
+function debugLog(msg, ...args) {
+  if (INTERNAL_RANGO_DEBUG) {
+    console.log(msg, ...args);
+  }
+}
+var IS_BROWSER_DEBUG;
+var init_logging = __esm({
+  "src/browser/logging.ts"() {
+    "use strict";
+    init_internal_debug();
+    IS_BROWSER_DEBUG = INTERNAL_RANGO_DEBUG;
+  }
+});
+
 // src/browser/notify-listeners.ts
 function notifyListeners(entries, notify, isActive, shouldContinue) {
   const errors = [];
@@ -627,30 +651,6 @@ var init_policy = __esm({
   }
 });
 
-// src/internal-debug.ts
-var INTERNAL_RANGO_DEBUG;
-var init_internal_debug = __esm({
-  "src/internal-debug.ts"() {
-    "use strict";
-    INTERNAL_RANGO_DEBUG = typeof process !== "undefined" && Boolean(process.env?.INTERNAL_RANGO_DEBUG);
-  }
-});
-
-// src/browser/logging.ts
-function debugLog(msg, ...args) {
-  if (INTERNAL_RANGO_DEBUG) {
-    console.log(msg, ...args);
-  }
-}
-var IS_BROWSER_DEBUG;
-var init_logging = __esm({
-  "src/browser/logging.ts"() {
-    "use strict";
-    init_internal_debug();
-    IS_BROWSER_DEBUG = INTERNAL_RANGO_DEBUG;
-  }
-});
-
 // src/redirect-origin.ts
 var init_redirect_origin = __esm({
   "src/redirect-origin.ts"() {
@@ -3050,17 +3050,12 @@ ${lazyImports.join(",\n")}
 
 // src/vite/plugins/use-cache-transform.ts
 import path5 from "node:path";
-import MagicString4 from "magic-string";
-init_debug();
-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() {
+function useCacheTransform(counter) {
   let projectRoot = "";
   let isBuild = false;
-  let rscTransforms = null;
-  const counter = createCounter(debug4, "use-cache");
   return {
     name: "@rangojs/router:use-cache",
     enforce: "post",
@@ -3073,62 +3068,73 @@ function useCacheTransform() {
     },
     async transform(code, id) {
       if (this.environment?.name !== "rsc") return;
-      if (!code.includes("use cache")) return;
-      if (id.includes("/node_modules/") || id.startsWith("\0")) return;
-      if (!/\.(tsx?|jsx?|mjs)$/.test(id)) return;
+      if (!isUseCacheCandidate(code, id)) return;
       const start = counter ? performance.now() : 0;
       try {
-        if (!rscTransforms) {
-          try {
-            rscTransforms = await import("@vitejs/plugin-rsc/transforms");
-          } catch {
-            return;
-          }
-        }
-        const {
-          hasDirective: hasDirective2,
-          transformWrapExport,
-          transformHoistInlineDirective
-        } = rscTransforms;
-        let ast;
-        try {
-          const { parseAst: parseAst6 } = await import("vite");
-          ast = parseAst6(code, { lang: "tsx" });
-        } catch {
-          return;
-        }
-        stripNullDirectiveFields(ast);
-        const filePath = normalizePath(path5.relative(projectRoot, id));
-        const isLayoutOrTemplate = LAYOUT_TEMPLATE_PATTERN.test(id);
-        if (hasDirective2(ast.body, "use cache")) {
-          return transformFileLevelUseCache(
-            code,
-            ast,
-            filePath,
-            id,
-            isBuild,
-            isLayoutOrTemplate,
-            transformWrapExport,
-            hasDirective2
-          );
-        }
-        const functionResult = transformFunctionLevelUseCache(
-          code,
-          ast,
-          filePath,
-          id,
+        return await transformUseCache(code, id, {
+          root: projectRoot,
           isBuild,
-          transformHoistInlineDirective
-        );
-        warnOnNearMissDirectives(ast, id, this.warn.bind(this));
-        if (functionResult) return functionResult;
+          warn: (message) => this.warn(message)
+        });
       } finally {
         counter?.record(id, performance.now() - start);
       }
     }
   };
 }
-function transformFileLevelUseCache(code, ast, filePath, sourceId, isBuild, isLayoutOrTemplate, transformWrapExport, hasDirective2) {
+function isUseCacheCandidate(code, id) {
+  return (
+    // Quick bail: no "use cache" in source
+    code.includes("use cache") && // Skip node_modules and virtual modules
+    !id.includes("/node_modules/") && !id.startsWith("\0") && // Only JS/TS files
+    /\.(tsx?|jsx?|mjs)$/.test(id)
+  );
+}
+var rscTransforms = null;
+async function transformUseCache(code, id, options) {
+  if (!rscTransforms) {
+    try {
+      rscTransforms = await import("@vitejs/plugin-rsc/transforms");
+    } catch (error) {
+      options.onTransformsError?.(error);
+      return;
+    }
+  }
+  const { hasDirective: hasDirective2, transformWrapExport, transformHoistInlineDirective } = rscTransforms;
+  let ast;
+  try {
+    const { parseAst: parseAst6 } = await import("vite");
+    ast = parseAst6(code, { lang: "tsx" });
+  } catch {
+    return;
+  }
+  stripNullDirectiveFields(ast);
+  const filePath = normalizePath(path5.relative(options.root, id));
+  const isLayoutOrTemplate = LAYOUT_TEMPLATE_PATTERN.test(id);
+  if (hasDirective2(ast.body, "use cache")) {
+    return transformFileLevelUseCache(
+      code,
+      ast,
+      filePath,
+      id,
+      options.isBuild,
+      isLayoutOrTemplate,
+      transformWrapExport,
+      hasDirective2
+    );
+  }
+  const functionResult = transformFunctionLevelUseCache(
+    code,
+    ast,
+    filePath,
+    id,
+    options.isBuild,
+    transformHoistInlineDirective
+  );
+  warnOnNearMissDirectives(ast, id, options.warn);
+  if (functionResult) return functionResult;
+}
+async function transformFileLevelUseCache(code, ast, filePath, sourceId, isBuild, isLayoutOrTemplate, transformWrapExport, hasDirective2) {
   const unconfirmedExports = [];
   const { exportNames, output } = transformWrapExport(code, ast, {
     runtime: (value, name) => {
@@ -3157,6 +3163,7 @@ function transformFileLevelUseCache(code, ast, filePath, sourceId, isBuild, isLa
     );
   }
   if (exportNames.length === 0) {
+    const { default: MagicString4 } = await import("magic-string");
     const s = new MagicString4(code);
     const directive2 = findFileLevelDirective(ast);
     if (directive2) {
@@ -3285,7 +3292,7 @@ function warnOnNearMissDirectives(ast, fileId, warn) {
 init_debug();
 import { existsSync, readFileSync } from "node:fs";
 import { isAbsolute, join, normalize, relative } from "node:path";
-var debug5 = createRangoDebugger(NS.transform);
+var debug4 = 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) {
@@ -3462,8 +3469,8 @@ function clientRefDedup() {
       resolvePackage = config.createResolver({ scan: true });
     },
     buildEnd() {
-      if (debug5 && dedupedPackages.size > 0) {
-        debug5(
+      if (debug4 && dedupedPackages.size > 0) {
+        debug4(
           "client-ref-dedup: redirected %d package(s) (%s)",
           dedupedPackages.size,
           [...dedupedPackages].join(",")
@@ -3505,7 +3512,7 @@ function clientRefDedup() {
       }
       return specifierPromise.then((specifier) => {
         if (!specifier) return;
-        if (debug5) dedupedPackages.add(packageName);
+        if (debug4) dedupedPackages.add(packageName);
         return `${DEDUP_PREFIX}${encodeURIComponent(specifier)}`;
       });
     },
@@ -3795,7 +3802,7 @@ import { resolve } from "node:path";
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.15.1",
+  version: "0.17.0",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -3993,7 +4000,7 @@ var package_default = {
   },
   dependencies: {
     "@types/debug": "^4.1.12",
-    "@vitejs/plugin-rsc": "^0.5.34",
+    "@vitejs/plugin-rsc": "^0.5.35",
     debug: "^4.4.1",
     "magic-string": "^0.30.17",
     picomatch: "^4.0.4",
@@ -4006,7 +4013,7 @@ var package_default = {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^2.9.0",
     "@opentelemetry/sdk-trace-base": "^2.9.0",
-    "@playwright/test": "^1.49.1",
+    "@playwright/test": "^1.62.0",
     "@shared/e2e": "workspace:*",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
@@ -4026,7 +4033,7 @@ var package_default = {
     "@playwright/test": "^1.49.1",
     "@testing-library/react": ">=16",
     "@vercel/functions": "^3.0.0",
-    "@vitejs/plugin-rsc": "^0.5.34",
+    "@vitejs/plugin-rsc": "^0.5.35",
     react: ">=19.2.8 <20",
     "react-dom": ">=19.2.8 <20",
     vite: "^8.0.16",
@@ -5482,7 +5489,7 @@ import { isAbsolute as isAbsolute2, resolve as resolve4 } from "node:path";
 // src/vite/plugins/performance-tracks.ts
 init_debug();
 import { readFile } from "node:fs/promises";
-var debug6 = createRangoDebugger(NS.transform);
+var debug5 = createRangoDebugger(NS.transform);
 var RSDW_PATCH_RE = /((?:var|let|const)\s+\w+\s*=\s*root\._children\s*,\s*(\w+)\s*=\s*root\._debugInfo\s*[;,])/;
 function buildPatchReplacement(match, debugInfoVar) {
   return `${match}
@@ -5517,7 +5524,7 @@ function performanceTracksOptimizeDepsPlugin() {
   };
 }
 function performanceTracksPlugin() {
-  const counter = createCounter(debug6, "performance-tracks");
+  const counter = createCounter(debug5, "performance-tracks");
   return {
     name: "@rangojs/router:performance-tracks",
     buildEnd() {
@@ -5529,7 +5536,7 @@ function performanceTracksPlugin() {
       try {
         const patched = patchRsdwClientDebugInfoRecovery(code);
         if (!patched.debugInfoVar) return;
-        debug6?.("patched RSDW client (var: %s)", patched.debugInfoVar);
+        debug5?.("patched RSDW client (var: %s)", patched.debugInfoVar);
         return patched.code;
       } finally {
         counter?.record(id, performance.now() - start);
@@ -6060,7 +6067,7 @@ function createVersionInjectorPlugin(rscEntryPath) {
 
 // src/vite/plugins/cjs-to-esm.ts
 init_debug();
-var debug8 = createRangoDebugger(NS.transform);
+var debug7 = createRangoDebugger(NS.transform);
 function createCjsToEsmPlugin() {
   let isProduction = false;
   return {
@@ -6074,7 +6081,7 @@ function createCjsToEsmPlugin() {
       if (cleanId.includes("vendor/react-server-dom/client.browser.js")) {
         const isProd = isProduction;
         const cjsFile = isProd ? "./cjs/react-server-dom-webpack-client.browser.production.js" : "./cjs/react-server-dom-webpack-client.browser.development.js";
-        debug8?.("cjs-to-esm entry redirect %s", id);
+        debug7?.("cjs-to-esm entry redirect %s", id);
         return {
           code: `export * from "${cjsFile}";`,
           map: null
@@ -6110,7 +6117,7 @@ function createCjsToEsmPlugin() {
           "export const $1 ="
         );
         transformed = license + "\n" + transformed;
-        debug8?.("cjs-to-esm body rewrite %s", id);
+        debug7?.("cjs-to-esm body rewrite %s", id);
         return {
           code: transformed,
           map: null
@@ -6138,17 +6145,35 @@ var DEV_DISCOVERY_EPOCH_HEADER = "x-rango-dev-discovery-epoch";
 import React from "react";
 
 // src/server/context.ts
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "node:async_hooks";
+
+// src/cache/cache-exec-scope.ts
 import { AsyncLocalStorage } from "node:async_hooks";
+
+// src/cache/taint.ts
+var cacheExecScopeProbe = () => false;
+function _setCacheExecScopeProbe(probe) {
+  cacheExecScopeProbe = probe;
+}
+
+// src/cache/cache-exec-scope.ts
+var cacheExecStorage = new AsyncLocalStorage();
+function isInsideCacheExecScope() {
+  return cacheExecStorage.getStore() !== void 0;
+}
+_setCacheExecScopeProbe(isInsideCacheExecScope);
+
+// src/server/context.ts
 var RSC_CONTEXT_KEY = /* @__PURE__ */ Symbol.for("rangojs-router:rsc-context");
-var RangoContext = globalThis[RSC_CONTEXT_KEY] ??= new AsyncLocalStorage();
+var RangoContext = globalThis[RSC_CONTEXT_KEY] ??= new AsyncLocalStorage2();
 var LOADER_SCOPE_KEY = /* @__PURE__ */ Symbol.for("rangojs-router:loader-scope");
-var loaderScopeALS = globalThis[LOADER_SCOPE_KEY] ??= new AsyncLocalStorage();
+var loaderScopeALS = globalThis[LOADER_SCOPE_KEY] ??= new AsyncLocalStorage2();
 var LOADER_BODY_SCOPE_KEY = /* @__PURE__ */ Symbol.for("rangojs-router:loader-body-scope");
-var loaderBodyScopeALS = globalThis[LOADER_BODY_SCOPE_KEY] ??= new AsyncLocalStorage();
+var loaderBodyScopeALS = globalThis[LOADER_BODY_SCOPE_KEY] ??= new AsyncLocalStorage2();
 var PUSH_CALLBACK_SCOPE_KEY = /* @__PURE__ */ Symbol.for(
   "rangojs-router:push-callback-scope"
 );
-var pushCallbackScopeALS = globalThis[PUSH_CALLBACK_SCOPE_KEY] ??= new AsyncLocalStorage();
+var pushCallbackScopeALS = globalThis[PUSH_CALLBACK_SCOPE_KEY] ??= new AsyncLocalStorage2();
 
 // src/rsc/shell-capture-constants.ts
 var SHELL_CAPTURE_MAX_WAIT_MS = 15e3;
@@ -6325,7 +6350,7 @@ init_client_ref_hashing();
 // src/vite/plugins/server-ref-hashing.ts
 init_debug();
 init_client_ref_hashing();
-var debug9 = createRangoDebugger(NS.transform);
+var debug8 = createRangoDebugger(NS.transform);
 function transformServerRefs(code, projectRoot) {
   if (!code.includes("registerServerReference")) return null;
   let hasReplacement = false;
@@ -6342,7 +6367,7 @@ function transformServerRefs(code, projectRoot) {
   return hasReplacement ? result : null;
 }
 function hashServerRefs(projectRoot) {
-  const counter = createCounter(debug9, "hash-server-refs");
+  const counter = createCounter(debug8, "hash-server-refs");
   return {
     name: "@rangojs/router:hash-server-refs",
     enforce: "post",
@@ -7207,11 +7232,11 @@ function copyStagedBuildAssets(projectRoot, fileNames) {
 
 // src/vite/discovery/prerender-collection.ts
 init_debug();
-var debug10 = createRangoDebugger(NS.prerender);
+var debug9 = createRangoDebugger(NS.prerender);
 async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
   if (!state.opts?.enableBuildPrerender || !state.isBuildMode) return;
-  const overallStart = debug10 ? performance.now() : 0;
-  debug10?.(
+  const overallStart = debug9 ? performance.now() : 0;
+  debug9?.(
     "expandPrerenderRoutes: start (%d router manifest(s))",
     allManifests.length
   );
@@ -7264,7 +7289,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
           });
         } else {
           if (def?.getParams) {
-            const getParamsStart = debug10 ? performance.now() : 0;
+            const getParamsStart = debug9 ? performance.now() : 0;
             try {
               const buildVars = {};
               const buildEnv = state.resolvedBuildEnv;
@@ -7283,7 +7308,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
                 }
               };
               const paramsList = await def.getParams(getParamsCtx);
-              debug10?.(
+              debug9?.(
                 "getParams %s -> %d params (%sms)",
                 routeName,
                 paramsList.length,
@@ -7355,7 +7380,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
     }
   }
   if (entries.length === 0) {
-    debug10?.(
+    debug9?.(
       "no prerender entries (done in %sms)",
       (performance.now() - overallStart).toFixed(1)
     );
@@ -7366,7 +7391,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
   console.log(
     `[rango] Pre-rendering ${entries.length} URL(s)${concurrencyNote}...`
   );
-  debug10?.(
+  debug9?.(
     "prerender loop: %d entries, max concurrency %d",
     entries.length,
     maxConcurrency
@@ -7474,7 +7499,7 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
   console.log(
     `[rango] Pre-render complete: ${parts.join(", ")} (${totalElapsed}ms total)`
   );
-  debug10?.(
+  debug9?.(
     "expandPrerenderRoutes done: %d done, %d skipped, %sms (overall %sms)",
     doneCount,
     skipCount,
@@ -7485,8 +7510,8 @@ async function expandPrerenderRoutes(state, rscEnv, registry, allManifests) {
 async function renderStaticHandlers(state, rscEnv, registry) {
   if (!state.opts?.enableBuildPrerender || !state.isBuildMode || !state.resolvedStaticModules?.size)
     return;
-  const overallStart = debug10 ? performance.now() : 0;
-  debug10?.(
+  const overallStart = debug9 ? performance.now() : 0;
+  debug9?.(
     "renderStaticHandlers: start (%d static module(s))",
     state.resolvedStaticModules.size
   );
@@ -7576,7 +7601,7 @@ async function renderStaticHandlers(state, rscEnv, registry) {
   console.log(
     `[rango] Static render complete: ${staticParts.join(", ")} (${totalStaticElapsed}ms total)`
   );
-  debug10?.(
+  debug9?.(
     "renderStaticHandlers done: %d done, %d skipped, %sms (overall %sms)",
     staticDone,
     staticSkip,
@@ -7707,103 +7732,405 @@ import {
   Suspense as Suspense2
 } from "react";
 
-// src/outlet-context.ts
-import { createContext } from "react";
-var OutletContext = createContext(null);
-
-// src/route-content-wrapper.tsx
-import { Component, Suspense, use } from "react";
-
-// src/outlet-provider.tsx
-import { useContext, useMemo } from "react";
-import { jsx } from "react/jsx-runtime";
-
-// src/decode-loader-results.ts
-import { createElement as createElement2 } from "react";
-
-// src/loader-redirect.tsx
-import { useEffect } from "react";
-
-// src/browser/react/use-router.ts
-import { useContext as useContext3, useMemo as useMemo2 } from "react";
-
-// src/browser/react/context.ts
-import { createContext as createContext2 } from "react";
-var NavigationStoreContext = createContext2(null);
-
-// src/browser/react/use-mount.ts
-import { useContext as useContext2 } from "react";
-
-// src/browser/react/mount-context.ts
+// src/browser/react/use-handle.ts
 import {
-  createContext as createContext3,
-  createElement
+  useContext,
+  useState,
+  useEffect,
+  useRef,
+  useOptimistic,
+  startTransition
 } from "react";
-var MountContext = createContext3("/");
 
-// src/browser/react/use-router.ts
-init_loader();
-
-// src/browser/app-version.ts
-var currentVersion2;
-function getAppVersion() {
-  return currentVersion2;
+// src/missing-id-error.ts
+var SELF_FILES = /* @__PURE__ */ new Set([
+  "missing-id-error",
+  "loader",
+  "loader.rsc",
+  "handle"
+]);
+function findUserCallSite() {
+  try {
+    const stack = new Error().stack;
+    if (!stack) return void 0;
+    for (const frame of stack.split("\n").slice(1)) {
+      const m = frame.match(
+        /(?:\(|@|\s)(?:file:\/\/)?((?:\/|[A-Za-z]:[\\/])[^()\s]+?\.(?:ts|tsx|js|jsx|mts|cts)):(\d+):(\d+)\)?/
+      );
+      if (!m) continue;
+      const path6 = m[1];
+      if (path6.includes("node_modules") || path6.includes("@rangojs/router")) {
+        continue;
+      }
+      const base = path6.split(/[\\/]/).pop().replace(/\.(?:ts|tsx|js|jsx|mts|cts)$/, "");
+      if (SELF_FILES.has(base)) continue;
+      return `${path6}:${m[2]}:${m[3]}`;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function missingInjectedIdError(kind, fnName) {
+  const site = findUserCallSite();
+  const at = site ? ` (created at ${site})` : "";
+  return new Error(
+    `[rango] ${kind} is missing $$id${at}.
+The @rangojs/router:expose-internal-ids Vite transform injects ${fnName}()'s stable $$id from an EXPORTED const declaration only:
+  export const X = ${fnName}(...)
+  const X = ${fnName}(...); export { X }
+A non-exported const, an \`export let/var\`, or an inline ${fnName}(...) call gets no $$id \u2014 export it as \`export const\`. (A matching "Unsupported ${fnName} shape" warning names the exact file:line.)`
+  );
 }
 
-// src/loader-redirect.tsx
-init_validate_redirect_origin();
-init_redirect_origin();
-
-// src/route-content-wrapper.tsx
-import { jsx as jsx2 } from "react/jsx-runtime";
+// src/handle.ts
+function defaultCollect(segments) {
+  return segments;
+}
+var collectRegistry = /* @__PURE__ */ new Map();
+var runtimeHandleIdCounter = 0;
+function createHandle(collect, __injectedId) {
+  let handleId = __injectedId ?? "";
+  if (!handleId) {
+    if (isUnderTestRunner()) {
+      handleId = `__rango_runtime_handle_${runtimeHandleIdCounter++}`;
+    } else if (process.env.NODE_ENV !== "production") {
+      throw missingInjectedIdError("Handle", "createHandle");
+    } else {
+      throw new Error(
+        "[rango] Handle is missing $$id \u2014 the build plugin did not inject one. Export it as `export const X = createHandle(...)`."
+      );
+    }
+  }
+  const collectFn = collect ?? defaultCollect;
+  collectRegistry.set(
+    handleId,
+    collectFn
+  );
+  return {
+    __brand: "handle",
+    $$id: handleId
+  };
+}
 
-// src/use-loader.tsx
-import {
-  isValidElement,
-  startTransition,
-  use as use2,
-  useCallback,
-  useContext as useContext4,
-  useEffect as useEffect2,
-  useMemo as useMemo3,
-  useRef,
-  useState
-} from "react";
+// src/browser/react/context.ts
+import { createContext } from "react";
+var NavigationStoreContext = createContext(null);
 
-// src/loader-store.ts
-var EMPTY_SNAPSHOT = Object.freeze({
-  value: void 0,
-  hasValue: false,
-  error: null,
-  isLoading: false,
-  requestId: 0
-});
-function normalizeGroups(group) {
-  if (group === void 0) return [];
-  if (typeof group === "string") return [group];
-  return [...new Set(group)];
+// src/handles/meta.ts
+function isUnsetDescriptor(descriptor) {
+  return typeof descriptor === "object" && descriptor !== null && "unset" in descriptor && typeof descriptor.unset === "string";
 }
-var LoaderStore = class {
-  constructor() {
-    this.entries = /* @__PURE__ */ new Map();
-    /** loader.$$id -> set of bucket keys, so clearFamily() can reach every bucket. */
-    this.families = /* @__PURE__ */ new Map();
-    /** refresh group name -> set of bucket keys, for refreshGroups(). */
-    this.groups = /* @__PURE__ */ new Map();
+function isTitleDescriptor(descriptor) {
+  return typeof descriptor === "object" && descriptor !== null && "title" in descriptor;
+}
+function isTitleTemplate(title) {
+  return typeof title === "object" && title !== null && "template" in title && "default" in title;
+}
+function isAbsoluteTitle(title) {
+  return typeof title === "object" && title !== null && "absolute" in title;
+}
+function getMetaKey(descriptor) {
+  if (isUnsetDescriptor(descriptor)) {
+    return void 0;
   }
-  getOrCreate(bucketKey) {
-    let e = this.entries.get(bucketKey);
-    if (!e) {
-      e = {
-        snapshot: EMPTY_SNAPSHOT,
-        listeners: /* @__PURE__ */ new Set(),
-        latestRequestId: 0,
-        loaderId: bucketKey,
-        sticky: false,
+  if ("charSet" in descriptor) {
+    return "charSet";
+  }
+  if ("title" in descriptor) {
+    return "title";
+  }
+  if ("name" in descriptor && "content" in descriptor) {
+    return `name:${descriptor.name}`;
+  }
+  if ("property" in descriptor && "content" in descriptor) {
+    return `property:${descriptor.property}`;
+  }
+  if ("httpEquiv" in descriptor && "content" in descriptor) {
+    return `httpEquiv:${descriptor.httpEquiv}`;
+  }
+  if ("script:ld+json" in descriptor) {
+    return void 0;
+  }
+  if ("tagName" in descriptor) {
+    if (descriptor.tagName === "link" && "rel" in descriptor) {
+      const uniqueRels = ["canonical", "icon", "apple-touch-icon"];
+      if (uniqueRels.includes(descriptor.rel)) {
+        return `link:${descriptor.rel}`;
+      }
+    }
+    return void 0;
+  }
+  return void 0;
+}
+var defaultMetaDescriptors = [
+  { charSet: "utf-8" },
+  { name: "viewport", content: "width=device-width, initial-scale=1" }
+];
+function addOrReplace(result, keyToIndex, descriptor, key) {
+  if (key !== void 0 && keyToIndex.has(key)) {
+    result[keyToIndex.get(key)] = descriptor;
+  } else {
+    if (key !== void 0) {
+      keyToIndex.set(key, result.length);
+    }
+    result.push(descriptor);
+  }
+}
+function updateIndicesAfterRemoval(keyToIndex, removedIndex) {
+  for (const [key, index] of keyToIndex) {
+    if (index > removedIndex) {
+      keyToIndex.set(key, index - 1);
+    }
+  }
+}
+function collectMeta(segments) {
+  const result = [];
+  const keyToIndex = /* @__PURE__ */ new Map();
+  let titleTemplate;
+  for (const descriptor of defaultMetaDescriptors) {
+    const key = getMetaKey(descriptor);
+    if (key !== void 0) {
+      keyToIndex.set(key, result.length);
+    }
+    result.push(descriptor);
+  }
+  for (const descriptors of segments) {
+    for (const descriptor of descriptors) {
+      if (isUnsetDescriptor(descriptor)) {
+        const keyToRemove = descriptor.unset;
+        if (keyToIndex.has(keyToRemove)) {
+          const idx = keyToIndex.get(keyToRemove);
+          result.splice(idx, 1);
+          keyToIndex.delete(keyToRemove);
+          updateIndicesAfterRemoval(keyToIndex, idx);
+        }
+        continue;
+      }
+      if (isTitleDescriptor(descriptor)) {
+        const titleValue = descriptor.title;
+        if (isTitleTemplate(titleValue)) {
+          titleTemplate = titleValue.template;
+          addOrReplace(
+            result,
+            keyToIndex,
+            { title: titleValue.default },
+            "title"
+          );
+          continue;
+        }
+        if (isAbsoluteTitle(titleValue)) {
+          addOrReplace(
+            result,
+            keyToIndex,
+            { title: titleValue.absolute },
+            "title"
+          );
+          continue;
+        }
+        const finalTitle = titleTemplate ? titleTemplate.split("%s").join(titleValue) : titleValue;
+        addOrReplace(
+          result,
+          keyToIndex,
+          { title: finalTitle },
+          "title"
+        );
+        continue;
+      }
+      const key = getMetaKey(descriptor);
+      addOrReplace(result, keyToIndex, descriptor, key);
+    }
+  }
+  return result;
+}
+var Meta = createHandle(collectMeta, "__rsc_router_meta__");
+
+// src/theme/theme-context.ts
+import { createContext as createContext2, useContext as useContext2 } from "react";
+var ThemeContext = createContext2(null);
+
+// src/browser/react/nonce-context.ts
+import { createContext as createContext3, useContext as useContext3 } from "react";
+var NonceContext = createContext3(void 0);
+
+// src/handles/MetaTags.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+// src/handles/Scripts.tsx
+import { useState as useState2 } from "react";
+
+// src/handles/script.ts
+function validateConfigDev(config) {
+  if (process.env.NODE_ENV === "production") return;
+  const c = config;
+  if (c.src != null && c.children != null) {
+    console.warn(
+      `[Script] A config has both "src" and "children"; they are mutually exclusive \u2014 "src" wins and the inline body is ignored.`
+    );
+  } else if (c.src == null && c.children == null) {
+    console.warn(
+      `[Script] A config has neither "src" nor "children"; it injects nothing.`
+    );
+  } else if (c.src == null && c.id == null) {
+    console.warn(
+      `[Script] An inline script was pushed without an "id" and cannot be deduplicated. Pass an "id" so a layout + child pushing the same script inject it only once.`
+    );
+  }
+  if (c.async && c.defer) {
+    console.warn(
+      `[Script] A config has both "async" and "defer"; they are mutually exclusive.`
+    );
+  }
+}
+function collectScripts(segments) {
+  const result = [];
+  const keyToIndex = /* @__PURE__ */ new Map();
+  for (const configs of segments) {
+    for (const config of configs) {
+      validateConfigDev(config);
+      const isAsyncResource = config.src != null && config.async === true;
+      const key = isAsyncResource ? config.src : config.id ?? config.src;
+      if (key === void 0) {
+        result.push(config);
+        continue;
+      }
+      const existing = keyToIndex.get(key);
+      if (existing !== void 0) {
+        result[existing] = config;
+      } else {
+        keyToIndex.set(key, result.length);
+        result.push(config);
+      }
+    }
+  }
+  return result;
+}
+var Script = createHandle(collectScripts, "__rsc_router_script__");
+
+// src/handles/Scripts.tsx
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+
+// src/browser/react/ScrollRestoration.tsx
+import { useEffect as useEffect2 } from "react";
+
+// src/browser/scroll-restoration.ts
+init_logging();
+
+// src/outlet-context.ts
+import { createContext as createContext4 } from "react";
+var OutletContext = createContext4(null);
+
+// src/route-content-wrapper.tsx
+import { Component, Suspense, use } from "react";
+
+// src/outlet-provider.tsx
+import { useContext as useContext4, useMemo } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+
+// src/decode-loader-results.ts
+import { createElement as createElement2 } from "react";
+
+// src/loader-redirect.tsx
+import { useEffect as useEffect3 } from "react";
+
+// src/browser/react/use-router.ts
+import { useContext as useContext6, useMemo as useMemo2 } from "react";
+
+// src/browser/react/use-mount.ts
+import { useContext as useContext5 } from "react";
+
+// src/browser/react/mount-context.ts
+import {
+  createContext as createContext5,
+  createElement
+} from "react";
+var MountContext = createContext5("/");
+
+// src/browser/react/use-router.ts
+init_loader();
+
+// src/browser/app-version.ts
+var currentVersion2;
+function getAppVersion() {
+  return currentVersion2;
+}
+
+// src/loader-redirect.tsx
+init_validate_redirect_origin();
+init_redirect_origin();
+
+// src/route-content-wrapper.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+
+// src/use-loader.tsx
+import {
+  isValidElement,
+  startTransition as startTransition2,
+  use as use2,
+  useCallback,
+  useContext as useContext7,
+  useEffect as useEffect4,
+  useMemo as useMemo3,
+  useOptimistic as useOptimistic2,
+  useRef as useRef2,
+  useState as useState3
+} from "react";
+
+// src/thenable-status.ts
+function unwrapsSynchronously(stream) {
+  const status = stream.status;
+  return status === "fulfilled" || status === "resolved_model" || status === "resolved_module";
+}
+
+// src/loader-store.ts
+var EMPTY_SNAPSHOT = Object.freeze({
+  value: void 0,
+  hasValue: false,
+  error: null,
+  isLoading: false,
+  requestId: 0
+});
+function normalizeGroups(group) {
+  if (group === void 0) return [];
+  if (typeof group === "string") return [group];
+  return [...new Set(group)];
+}
+var LoaderStore = class {
+  constructor() {
+    this.entries = /* @__PURE__ */ new Map();
+    /** loader.$$id -> set of bucket keys, so clearFamily() can reach every bucket. */
+    this.families = /* @__PURE__ */ new Map();
+    /** refresh group name -> set of bucket keys, for refreshGroups(). */
+    this.groups = /* @__PURE__ */ new Map();
+    /**
+     * loader.$$id -> per-loader streams a committed navigation is still
+     * receiving. Registered and announced by announcePendingStreams(), which
+     * browser/partial-update.ts calls INSIDE every transition commit, so a
+     * reader whose content is held on screen by that transition pins
+     * `isLoading: true` for the data it is still showing until the transition
+     * lands (use-loader.tsx). Family-keyed on purpose: a persisting layout
+     * reader of the same createLoader the child is re-running is pinned too
+     * (the loader is in flight; not "this segment's copy is being replaced" —
+     * issue #862, working as designed). The new tree's own read of the loader
+     * suspends at the read site and never observes the flag. A Set, not a
+     * flag: overlapping navigations (second click before the first stream
+     * lands) keep the family pending until the LAST stream settles.
+     */
+    this.pendingStreams = /* @__PURE__ */ new Map();
+  }
+  getOrCreate(bucketKey) {
+    let e = this.entries.get(bucketKey);
+    if (!e) {
+      e = {
+        snapshot: EMPTY_SNAPSHOT,
+        listeners: /* @__PURE__ */ new Set(),
+        latestRequestId: 0,
+        loaderId: bucketKey,
+        sticky: false,
         pendingClear: false,
         clearWhenSettled: false,
         groups: /* @__PURE__ */ new Map(),
-        refetch: void 0
+        refetch: void 0,
+        streamPendingListeners: /* @__PURE__ */ new Set()
       };
       this.entries.set(bucketKey, e);
     }
@@ -7837,8 +8164,11 @@ var LoaderStore = class {
     e.pendingClear = false;
     e.clearWhenSettled = false;
     e.listeners.add(cb);
+    const onStreamPending = options?.onStreamPending;
+    if (onStreamPending) e.streamPendingListeners.add(onStreamPending);
     return () => {
       e.listeners.delete(cb);
+      if (onStreamPending) e.streamPendingListeners.delete(onStreamPending);
       for (const group of groups) this.releaseGroup(group, bucketKey, e);
       this.maybeScheduleRefcountClear(bucketKey, e);
     };
@@ -8081,7 +8411,64 @@ var LoaderStore = class {
     for (const cb of e.listeners) cb();
   }
   /**
-   * Test-only escape hatch. Drops every entry. Production code should never
+   * Register a still-streaming per-loader result for `loaderId`. No-op for a
+   * settled Flight chunk (unwrapsSynchronously / "rejected"): the forceAwait
+   * and action lanes commit settled chunks, and a { ssr: false } loader is
+   * awaited before flush. Released as the stream settles, either way.
+   */
+  trackPendingStream(loaderId, stream) {
+    if (unwrapsSynchronously(stream) || stream.status === "rejected") {
+      return;
+    }
+    let set = this.pendingStreams.get(loaderId);
+    if (set?.has(stream)) return;
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.pendingStreams.set(loaderId, set);
+    }
+    set.add(stream);
+    const release = () => {
+      const current = this.pendingStreams.get(loaderId);
+      if (!current || !current.delete(stream)) return;
+      if (current.size === 0) this.pendingStreams.delete(loaderId);
+    };
+    stream.then(release, release);
+  }
+  /** True while any navigation stream for `loaderId` is still pending. */
+  isStreamPending(loaderId) {
+    return this.pendingStreams.has(loaderId);
+  }
+  /**
+   * Register the loader segments of a tree being committed whose data is
+   * still a pending promise, then fire `onStreamPending` on every subscriber
+   * of every family with a pending stream. MUST run inside the startTransition
+   * that commits the tree: the hook answers with a useOptimistic update, which
+   * React reverts exactly when that transition commits — so the held reader
+   * reports isLoading:true for as long as its data stays on screen and not a
+   * frame longer. Outside a transition React reverts an optimistic update on
+   * the next render, pinning nothing useful. Registering here rather than in
+   * the tree build keeps register + announce in one call; settled chunks
+   * (cached/reused segments, forceAwait lanes) are skipped by
+   * trackPendingStream.
+   */
+  announcePendingStreams(segments) {
+    for (const segment of segments) {
+      if (segment.type === "loader" && segment.loaderId && segment.loaderData instanceof Promise) {
+        this.trackPendingStream(segment.loaderId, segment.loaderData);
+      }
+    }
+    for (const loaderId of this.pendingStreams.keys()) {
+      const fam = this.families.get(loaderId);
+      if (!fam) continue;
+      for (const bucketKey of fam) {
+        const e = this.entries.get(bucketKey);
+        if (!e) continue;
+        for (const cb of e.streamPendingListeners) cb();
+      }
+    }
+  }
+  /**
+   * Test-only escape hatch. Drops every entry. Production code should never
    * call this; the store is process-scoped and lives for the tab's lifetime.
    * @internal
    */
@@ -8089,85 +8476,78 @@ var LoaderStore = class {
     this.entries.clear();
     this.families.clear();
     this.groups.clear();
+    this.pendingStreams.clear();
   }
 };
 var loaderStore = new LoaderStore();
 
 // src/browser/react/use-navigation.ts
 import {
-  useContext as useContext5,
-  useState as useState2,
-  useEffect as useEffect3,
-  useOptimistic,
-  startTransition as startTransition2,
-  useRef as useRef2
+  useContext as useContext8,
+  useState as useState4,
+  useEffect as useEffect5,
+  useOptimistic as useOptimistic3,
+  startTransition as startTransition3,
+  useRef as useRef3
 } from "react";
 
 // src/browser/react/use-pathname.ts
-import { useContext as useContext6, useState as useState3, useEffect as useEffect4, useRef as useRef3 } from "react";
+import { useContext as useContext9, useState as useState5, useEffect as useEffect6, useRef as useRef4 } from "react";
 
 // src/client-urls/optimistic-location.ts
-import { createContext as createContext4 } from "react";
-var OptimisticLocationContext = createContext4(null);
+import { createContext as createContext6 } from "react";
+var OptimisticLocationContext = createContext6(null);
 
 // src/browser/react/use-search-params.ts
 import {
   useCallback as useCallback2,
-  useContext as useContext7,
-  useEffect as useEffect5,
+  useContext as useContext10,
+  useEffect as useEffect7,
   useMemo as useMemo4,
-  useRef as useRef4,
-  useState as useState4
+  useRef as useRef5,
+  useState as useState6
 } from "react";
 
 // src/browser/react/use-params.ts
-import { useContext as useContext8, useState as useState5, useEffect as useEffect6, useRef as useRef5 } from "react";
+import { useContext as useContext11, useState as useState7, useEffect as useEffect8, useRef as useRef6 } from "react";
 var EMPTY_PARAMS = Object.freeze({});
 
-// src/browser/react/nonce-context.ts
-import { createContext as createContext5, useContext as useContext9 } from "react";
-var NonceContext = createContext5(void 0);
-
 // src/browser/react/use-action.ts
 import {
-  useContext as useContext10,
-  useState as useState6,
-  useEffect as useEffect7,
-  useRef as useRef6,
-  useOptimistic as useOptimistic2,
-  startTransition as startTransition3
+  useContext as useContext12,
+  useState as useState8,
+  useEffect as useEffect9,
+  useRef as useRef7,
+  useOptimistic as useOptimistic4,
+  startTransition as startTransition4
 } from "react";
 
 // src/browser/react/use-segments.ts
-import { useContext as useContext11, useState as useState7, useEffect as useEffect8, useRef as useRef7 } from "react";
+import { useContext as useContext13, useState as useState9, useEffect as useEffect10, useRef as useRef8 } from "react";
 
 // src/browser/react/NavigationProvider.tsx
 import {
-  useState as useState10,
-  useEffect as useEffect10,
+  useState as useState12,
+  useEffect as useEffect12,
   useLayoutEffect,
   useCallback as useCallback4,
   useMemo as useMemo6,
-  useRef as useRef9,
+  useRef as useRef10,
   use as use3
 } from "react";
 
 // src/root-error-boundary.tsx
-import { Component as Component2, useState as useState8 } from "react";
-import { jsx as jsx3, jsxs } from "react/jsx-runtime";
+import { Component as Component2, useState as useState10 } from "react";
+import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
 
 // src/theme/ThemeProvider.tsx
 import {
   useCallback as useCallback3,
-  useEffect as useEffect9,
+  useEffect as useEffect11,
   useMemo as useMemo5,
-  useState as useState9
+  useState as useState11
 } from "react";
 
-// src/theme/theme-context.ts
-import { createContext as createContext6, useContext as useContext12 } from "react";
-var ThemeContext = createContext6(null);
-
 // src/theme/constants.ts
 var THEME_COOKIE = {
   maxAge: 60 * 60 * 24 * 365,
@@ -8177,15 +8557,10 @@ var THEME_COOKIE = {
 };
 
 // src/theme/ThemeProvider.tsx
-import { jsx as jsx4 } from "react/jsx-runtime";
+import { jsx as jsx6 } from "react/jsx-runtime";
 
 // src/browser/react/NavigationProvider.tsx
 init_loader();
-
-// src/browser/scroll-restoration.ts
-init_logging();
-
-// src/browser/react/NavigationProvider.tsx
 init_logging();
 
 // src/browser/navigation-store.ts
@@ -8193,28 +8568,28 @@ init_cache();
 init_rango_state();
 
 // src/browser/react/NavigationProvider.tsx
-import { jsx as jsx5 } from "react/jsx-runtime";
+import { jsx as jsx7 } from "react/jsx-runtime";
 
 // src/browser/react/Link.tsx
 import {
   forwardRef,
   useCallback as useCallback5,
-  useContext as useContext14,
-  useEffect as useEffect13,
+  useContext as useContext15,
+  useEffect as useEffect15,
   useMemo as useMemo7,
-  useRef as useRef12,
+  useRef as useRef13,
   useSyncExternalStore
 } from "react";
 
 // src/browser/react/use-link-status.ts
 import {
   createContext as createContext7,
-  useContext as useContext13,
-  useState as useState11,
-  useEffect as useEffect11,
-  useRef as useRef10,
-  useOptimistic as useOptimistic3,
-  startTransition as startTransition4
+  useContext as useContext14,
+  useState as useState13,
+  useEffect as useEffect13,
+  useRef as useRef11,
+  useOptimistic as useOptimistic5,
+  startTransition as startTransition5
 } from "react";
 var LinkContext = createContext7(
   null
@@ -8443,496 +8818,230 @@ function isPrefetchScopeDisabled(element) {
 }
 
 // src/browser/react/location-state.ts
-import { useState as useState12, useEffect as useEffect12, useRef as useRef11 } from "react";
-
-// src/browser/react/location-state-shared.ts
-function isLocationStateEntry(value) {
-  return value !== null && typeof value === "object" && "__rsc_ls_key" in value && "__rsc_ls_value" in value && typeof value.__rsc_ls_key === "string";
-}
-function resolveLocationStateEntries(entries) {
-  const result = {};
-  for (const entry of entries) {
-    result[entry.__rsc_ls_key] = entry.__rsc_ls_lazy ? entry.__rsc_ls_value() : entry.__rsc_ls_value;
-  }
-  return result;
-}
+import { useState as useState14, useEffect as useEffect14, useRef as useRef12 } from "react";
 
-// src/browser/react/Link.tsx
-init_loader();
-import { jsx as jsx6 } from "react/jsx-runtime";
-var IGNORE_STRATEGY_CHANGES = (_listener) => () => {
-};
-function isExternalUrl(href2, origin) {
-  if (href2.startsWith("//")) return true;
-  if (href2.startsWith("http://") || href2.startsWith("https://")) {
-    if (!origin) return false;
-    try {
-      return new URL(href2).origin !== origin;
-    } catch {
-      return false;
-    }
-  }
-  if (/^[a-z][a-z0-9+.-]*:/i.test(href2)) {
-    return true;
-  }
-  return false;
-}
-var Link = forwardRef(function Link2({
-  to,
-  replace = false,
-  scroll = true,
-  reloadDocument = false,
-  revalidate: revalidate2,
-  prefetch,
-  prefetchKey,
-  state,
-  children,
-  onClick,
-  ...props
-}, ref) {
-  const ctx = useContext14(NavigationStoreContext);
-  const storeLocation = ctx?.eventController.getState().location;
-  const origin = storeLocation?.origin ?? (typeof window !== "undefined" ? window.location.origin : void 0);
-  const isExternal = isExternalUrl(to, origin);
-  const resolvedTo = useMemo7(() => {
-    if (isExternal) return to;
-    const bn = ctx?.basename;
-    if (!bn || !to.startsWith("/") || to.startsWith(bn + "/") || to === bn)
-      return to;
-    return to === "/" ? bn : bn + to;
-  }, [to, isExternal, ctx?.basename]);
-  const configuredStrategy = prefetch ?? ctx?.defaultPrefetch ?? getDefaultPrefetchStrategy();
-  const resolvedStrategy = useSyncExternalStore(
-    configuredStrategy === "adaptive" ? subscribeToAdaptiveStrategyChange : IGNORE_STRATEGY_CHANGES,
-    () => resolveAdaptiveStrategy(configuredStrategy),
-    () => configuredStrategy === "adaptive" ? "hover" : configuredStrategy
-  );
-  const internalRef = useRef12(null);
-  const setRef = useCallback5(
-    (node) => {
-      internalRef.current = node;
-      if (typeof ref === "function") {
-        ref(node);
-      } else if (ref) {
-        ref.current = node;
-      }
-    },
-    [ref]
-  );
-  const stateRef = useRef12(state);
-  stateRef.current = state;
-  const handleClick = useCallback5(
-    (e) => {
-      onClick?.(e);
-      if (e.defaultPrevented) return;
-      if (isExternal) return;
-      if (reloadDocument) return;
-      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
-      if (e.currentTarget.hasAttribute("download"))
-        return;
-      const target = e.currentTarget.target;
-      if (target && target !== "_self") return;
-      if (isHashOnlyNavigation(e.currentTarget)) {
-        return;
-      }
-      if (!ctx?.navigate) {
-        return;
-      }
-      e.preventDefault();
-      e.stopPropagation();
-      const currentState = stateRef.current;
-      let resolvedState;
-      if (Array.isArray(currentState) && currentState.length > 0 && isLocationStateEntry(currentState[0])) {
-        resolvedState = resolveLocationStateEntries(
-          currentState
-        );
-      } else if (typeof currentState === "function") {
-        resolvedState = currentState();
-      } else if (currentState != null) {
-        resolvedState = currentState;
-      }
-      ctx.navigate(resolvedTo, {
-        replace,
-        scroll,
-        state: resolvedState,
-        revalidate: revalidate2
-      });
-    },
-    [
-      resolvedTo,
-      isExternal,
-      reloadDocument,
-      replace,
-      scroll,
-      revalidate2,
-      ctx,
-      onClick
-    ]
-  );
-  const handleMouseEnter = useCallback5(() => {
-    const element = internalRef.current;
-    if ((resolvedStrategy === "hover" || resolvedStrategy === "viewport") && !isExternal && ctx?.store && (!element || !isHashOnlyNavigation(element) && !isPrefetchScopeDisabled(element))) {
-      const segmentState = ctx.store.getSegmentState();
-      prefetchDirect2(
-        resolvedTo,
-        segmentState.currentSegmentIds,
-        getAppVersion(),
-        ctx.store.getRouterId?.(),
-        prefetchKey
-      );
-    }
-  }, [resolvedStrategy, resolvedTo, isExternal, ctx, prefetchKey]);
-  useEffect13(() => {
-    if (isExternal || !ctx?.store) return;
-    const isViewport = resolvedStrategy === "viewport";
-    const isRender = resolvedStrategy === "render";
-    if (!isViewport && !isRender) return;
-    const armPrefetch = () => {
-      const element2 = internalRef.current;
-      if (element2 && (isHashOnlyNavigation(element2) || isPrefetchScopeDisabled(element2))) {
-        return () => {
-        };
-      }
-      let cancelled = false;
-      let unsubIdle;
-      let stopObserving;
-      const triggerPrefetch = () => {
-        if (cancelled) return;
-        const currentElement = internalRef.current;
-        if (currentElement && isPrefetchScopeDisabled(currentElement)) return;
-        const segmentState = ctx.store.getSegmentState();
-        prefetchQueued2(
-          resolvedTo,
-          segmentState.currentSegmentIds,
-          getAppVersion(),
-          ctx.store.getRouterId?.(),
-          prefetchKey
-        );
-      };
-      if (isRender) {
-        unsubIdle = schedulePrefetchWhenRouterIdle(
-          ctx.eventController,
-          triggerPrefetch
-        );
-      } else {
-        const viewportElement = internalRef.current;
-        if (viewportElement) {
-          stopObserving = observeForPrefetch(viewportElement, () => {
-            unsubIdle = schedulePrefetchWhenRouterIdle(
-              ctx.eventController,
-              triggerPrefetch
-            );
-          });
-        }
-      }
-      return () => {
-        cancelled = true;
-        unsubIdle?.();
-        stopObserving?.();
-      };
-    };
-    let disarmPrefetch = armPrefetch();
-    const element = internalRef.current;
-    const unsubscribeScope = element ? subscribeToPrefetchScopeChange(element, () => {
-      disarmPrefetch();
-      disarmPrefetch = armPrefetch();
-    }) : void 0;
-    const unsubscribeLocation = subscribeToLocationChange(
-      ctx.eventController,
-      () => {
-        disarmPrefetch();
-        disarmPrefetch = armPrefetch();
-      }
-    );
-    return () => {
-      unsubscribeScope?.();
-      unsubscribeLocation();
-      disarmPrefetch();
-    };
-  }, [resolvedStrategy, resolvedTo, isExternal, ctx, prefetchKey]);
-  return /* @__PURE__ */ jsx6(
-    "a",
-    {
-      ref: setRef,
-      href: resolvedTo,
-      onClick: handleClick,
-      onMouseEnter: handleMouseEnter,
-      "data-link-component": true,
-      "data-external": isExternal ? "" : void 0,
-      "data-scroll": scroll === false ? "false" : void 0,
-      "data-replace": replace ? "true" : void 0,
-      "data-revalidate": revalidate2 === false ? "false" : void 0,
-      ...props,
-      children: /* @__PURE__ */ jsx6(LinkContext.Provider, { value: resolvedTo, children })
-    }
-  );
-});
-
-// src/browser/react/ScrollRestoration.tsx
-import { useEffect as useEffect14 } from "react";
-
-// src/browser/react/use-handle.ts
-import {
-  useContext as useContext15,
-  useState as useState13,
-  useEffect as useEffect15,
-  useRef as useRef13,
-  useOptimistic as useOptimistic4,
-  startTransition as startTransition5
-} from "react";
-
-// src/missing-id-error.ts
-var SELF_FILES = /* @__PURE__ */ new Set([
-  "missing-id-error",
-  "loader",
-  "loader.rsc",
-  "handle"
-]);
-function findUserCallSite() {
-  try {
-    const stack = new Error().stack;
-    if (!stack) return void 0;
-    for (const frame of stack.split("\n").slice(1)) {
-      const m = frame.match(
-        /(?:\(|@|\s)(?:file:\/\/)?((?:\/|[A-Za-z]:[\\/])[^()\s]+?\.(?:ts|tsx|js|jsx|mts|cts)):(\d+):(\d+)\)?/
-      );
-      if (!m) continue;
-      const path6 = m[1];
-      if (path6.includes("node_modules") || path6.includes("@rangojs/router")) {
-        continue;
-      }
-      const base = path6.split(/[\\/]/).pop().replace(/\.(?:ts|tsx|js|jsx|mts|cts)$/, "");
-      if (SELF_FILES.has(base)) continue;
-      return `${path6}:${m[2]}:${m[3]}`;
-    }
-  } catch {
-  }
-  return void 0;
-}
-function missingInjectedIdError(kind, fnName) {
-  const site = findUserCallSite();
-  const at = site ? ` (created at ${site})` : "";
-  return new Error(
-    `[rango] ${kind} is missing $$id${at}.
-The @rangojs/router:expose-internal-ids Vite transform injects ${fnName}()'s stable $$id from an EXPORTED const declaration only:
-  export const X = ${fnName}(...)
-  const X = ${fnName}(...); export { X }
-A non-exported const, an \`export let/var\`, or an inline ${fnName}(...) call gets no $$id \u2014 export it as \`export const\`. (A matching "Unsupported ${fnName} shape" warning names the exact file:line.)`
-  );
-}
-
-// src/handle.ts
-function defaultCollect(segments) {
-  return segments;
-}
-var collectRegistry = /* @__PURE__ */ new Map();
-var runtimeHandleIdCounter = 0;
-function createHandle(collect, __injectedId) {
-  let handleId = __injectedId ?? "";
-  if (!handleId) {
-    if (isUnderTestRunner()) {
-      handleId = `__rango_runtime_handle_${runtimeHandleIdCounter++}`;
-    } else if (process.env.NODE_ENV !== "production") {
-      throw missingInjectedIdError("Handle", "createHandle");
-    } else {
-      throw new Error(
-        "[rango] Handle is missing $$id \u2014 the build plugin did not inject one. Export it as `export const X = createHandle(...)`."
-      );
-    }
-  }
-  const collectFn = collect ?? defaultCollect;
-  collectRegistry.set(
-    handleId,
-    collectFn
-  );
-  return {
-    __brand: "handle",
-    $$id: handleId
-  };
-}
-
-// src/handles/meta.ts
-function isUnsetDescriptor(descriptor) {
-  return typeof descriptor === "object" && descriptor !== null && "unset" in descriptor && typeof descriptor.unset === "string";
-}
-function isTitleDescriptor(descriptor) {
-  return typeof descriptor === "object" && descriptor !== null && "title" in descriptor;
-}
-function isTitleTemplate(title) {
-  return typeof title === "object" && title !== null && "template" in title && "default" in title;
-}
-function isAbsoluteTitle(title) {
-  return typeof title === "object" && title !== null && "absolute" in title;
-}
-function getMetaKey(descriptor) {
-  if (isUnsetDescriptor(descriptor)) {
-    return void 0;
-  }
-  if ("charSet" in descriptor) {
-    return "charSet";
-  }
-  if ("title" in descriptor) {
-    return "title";
-  }
-  if ("name" in descriptor && "content" in descriptor) {
-    return `name:${descriptor.name}`;
-  }
-  if ("property" in descriptor && "content" in descriptor) {
-    return `property:${descriptor.property}`;
-  }
-  if ("httpEquiv" in descriptor && "content" in descriptor) {
-    return `httpEquiv:${descriptor.httpEquiv}`;
-  }
-  if ("script:ld+json" in descriptor) {
-    return void 0;
-  }
-  if ("tagName" in descriptor) {
-    if (descriptor.tagName === "link" && "rel" in descriptor) {
-      const uniqueRels = ["canonical", "icon", "apple-touch-icon"];
-      if (uniqueRels.includes(descriptor.rel)) {
-        return `link:${descriptor.rel}`;
-      }
-    }
-    return void 0;
-  }
-  return void 0;
-}
-var defaultMetaDescriptors = [
-  { charSet: "utf-8" },
-  { name: "viewport", content: "width=device-width, initial-scale=1" }
-];
-function addOrReplace(result, keyToIndex, descriptor, key) {
-  if (key !== void 0 && keyToIndex.has(key)) {
-    result[keyToIndex.get(key)] = descriptor;
-  } else {
-    if (key !== void 0) {
-      keyToIndex.set(key, result.length);
-    }
-    result.push(descriptor);
-  }
-}
-function updateIndicesAfterRemoval(keyToIndex, removedIndex) {
-  for (const [key, index] of keyToIndex) {
-    if (index > removedIndex) {
-      keyToIndex.set(key, index - 1);
-    }
-  }
-}
-function collectMeta(segments) {
-  const result = [];
-  const keyToIndex = /* @__PURE__ */ new Map();
-  let titleTemplate;
-  for (const descriptor of defaultMetaDescriptors) {
-    const key = getMetaKey(descriptor);
-    if (key !== void 0) {
-      keyToIndex.set(key, result.length);
-    }
-    result.push(descriptor);
-  }
-  for (const descriptors of segments) {
-    for (const descriptor of descriptors) {
-      if (isUnsetDescriptor(descriptor)) {
-        const keyToRemove = descriptor.unset;
-        if (keyToIndex.has(keyToRemove)) {
-          const idx = keyToIndex.get(keyToRemove);
-          result.splice(idx, 1);
-          keyToIndex.delete(keyToRemove);
-          updateIndicesAfterRemoval(keyToIndex, idx);
-        }
-        continue;
-      }
-      if (isTitleDescriptor(descriptor)) {
-        const titleValue = descriptor.title;
-        if (isTitleTemplate(titleValue)) {
-          titleTemplate = titleValue.template;
-          addOrReplace(
-            result,
-            keyToIndex,
-            { title: titleValue.default },
-            "title"
-          );
-          continue;
-        }
-        if (isAbsoluteTitle(titleValue)) {
-          addOrReplace(
-            result,
-            keyToIndex,
-            { title: titleValue.absolute },
-            "title"
-          );
-          continue;
-        }
-        const finalTitle = titleTemplate ? titleTemplate.split("%s").join(titleValue) : titleValue;
-        addOrReplace(
-          result,
-          keyToIndex,
-          { title: finalTitle },
-          "title"
-        );
-        continue;
-      }
-      const key = getMetaKey(descriptor);
-      addOrReplace(result, keyToIndex, descriptor, key);
-    }
+// src/browser/react/location-state-shared.ts
+function isLocationStateEntry(value) {
+  return value !== null && typeof value === "object" && "__rsc_ls_key" in value && "__rsc_ls_value" in value && typeof value.__rsc_ls_key === "string";
+}
+function resolveLocationStateEntries(entries) {
+  const result = {};
+  for (const entry of entries) {
+    result[entry.__rsc_ls_key] = entry.__rsc_ls_lazy ? entry.__rsc_ls_value() : entry.__rsc_ls_value;
   }
   return result;
 }
-var Meta = createHandle(collectMeta, "__rsc_router_meta__");
-
-// src/handles/MetaTags.tsx
-import { Fragment, jsx as jsx7, jsxs as jsxs2 } from "react/jsx-runtime";
 
-// src/handles/script.ts
-function validateConfigDev(config) {
-  if (process.env.NODE_ENV === "production") return;
-  const c = config;
-  if (c.src != null && c.children != null) {
-    console.warn(
-      `[Script] A config has both "src" and "children"; they are mutually exclusive \u2014 "src" wins and the inline body is ignored.`
-    );
-  } else if (c.src == null && c.children == null) {
-    console.warn(
-      `[Script] A config has neither "src" nor "children"; it injects nothing.`
-    );
-  } else if (c.src == null && c.id == null) {
-    console.warn(
-      `[Script] An inline script was pushed without an "id" and cannot be deduplicated. Pass an "id" so a layout + child pushing the same script inject it only once.`
-    );
+// src/browser/react/Link.tsx
+init_loader();
+import { jsx as jsx8 } from "react/jsx-runtime";
+var IGNORE_STRATEGY_CHANGES = (_listener) => () => {
+};
+function isExternalUrl(href2, origin) {
+  if (href2.startsWith("//")) return true;
+  if (href2.startsWith("http://") || href2.startsWith("https://")) {
+    if (!origin) return false;
+    try {
+      return new URL(href2).origin !== origin;
+    } catch {
+      return false;
+    }
   }
-  if (c.async && c.defer) {
-    console.warn(
-      `[Script] A config has both "async" and "defer"; they are mutually exclusive.`
-    );
+  if (/^[a-z][a-z0-9+.-]*:/i.test(href2)) {
+    return true;
   }
+  return false;
 }
-function collectScripts(segments) {
-  const result = [];
-  const keyToIndex = /* @__PURE__ */ new Map();
-  for (const configs of segments) {
-    for (const config of configs) {
-      validateConfigDev(config);
-      const isAsyncResource = config.src != null && config.async === true;
-      const key = isAsyncResource ? config.src : config.id ?? config.src;
-      if (key === void 0) {
-        result.push(config);
-        continue;
+var Link = forwardRef(function Link2({
+  to,
+  replace = false,
+  scroll = true,
+  reloadDocument = false,
+  revalidate: revalidate2,
+  prefetch,
+  prefetchKey,
+  state,
+  children,
+  onClick,
+  ...props
+}, ref) {
+  const ctx = useContext15(NavigationStoreContext);
+  const storeLocation = ctx?.eventController.getState().location;
+  const origin = storeLocation?.origin ?? (typeof window !== "undefined" ? window.location.origin : void 0);
+  const isExternal = isExternalUrl(to, origin);
+  const resolvedTo = useMemo7(() => {
+    if (isExternal) return to;
+    const bn = ctx?.basename;
+    if (!bn || !to.startsWith("/") || to.startsWith(bn + "/") || to === bn)
+      return to;
+    return to === "/" ? bn : bn + to;
+  }, [to, isExternal, ctx?.basename]);
+  const configuredStrategy = prefetch ?? ctx?.defaultPrefetch ?? getDefaultPrefetchStrategy();
+  const resolvedStrategy = useSyncExternalStore(
+    configuredStrategy === "adaptive" ? subscribeToAdaptiveStrategyChange : IGNORE_STRATEGY_CHANGES,
+    () => resolveAdaptiveStrategy(configuredStrategy),
+    () => configuredStrategy === "adaptive" ? "hover" : configuredStrategy
+  );
+  const internalRef = useRef13(null);
+  const setRef = useCallback5(
+    (node) => {
+      internalRef.current = node;
+      if (typeof ref === "function") {
+        ref(node);
+      } else if (ref) {
+        ref.current = node;
       }
-      const existing = keyToIndex.get(key);
-      if (existing !== void 0) {
-        result[existing] = config;
+    },
+    [ref]
+  );
+  const stateRef = useRef13(state);
+  stateRef.current = state;
+  const handleClick = useCallback5(
+    (e) => {
+      onClick?.(e);
+      if (e.defaultPrevented) return;
+      if (isExternal) return;
+      if (reloadDocument) return;
+      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+      if (e.currentTarget.hasAttribute("download"))
+        return;
+      const target = e.currentTarget.target;
+      if (target && target !== "_self") return;
+      if (isHashOnlyNavigation(e.currentTarget)) {
+        return;
+      }
+      if (!ctx?.navigate) {
+        return;
+      }
+      e.preventDefault();
+      e.stopPropagation();
+      const currentState = stateRef.current;
+      let resolvedState;
+      if (Array.isArray(currentState) && currentState.length > 0 && isLocationStateEntry(currentState[0])) {
+        resolvedState = resolveLocationStateEntries(
+          currentState
+        );
+      } else if (typeof currentState === "function") {
+        resolvedState = currentState();
+      } else if (currentState != null) {
+        resolvedState = currentState;
+      }
+      ctx.navigate(resolvedTo, {
+        replace,
+        scroll,
+        state: resolvedState,
+        revalidate: revalidate2
+      });
+    },
+    [
+      resolvedTo,
+      isExternal,
+      reloadDocument,
+      replace,
+      scroll,
+      revalidate2,
+      ctx,
+      onClick
+    ]
+  );
+  const handleMouseEnter = useCallback5(() => {
+    const element = internalRef.current;
+    if ((resolvedStrategy === "hover" || resolvedStrategy === "viewport") && !isExternal && ctx?.store && (!element || !isHashOnlyNavigation(element) && !isPrefetchScopeDisabled(element))) {
+      const segmentState = ctx.store.getSegmentState();
+      prefetchDirect2(
+        resolvedTo,
+        segmentState.currentSegmentIds,
+        getAppVersion(),
+        ctx.store.getRouterId?.(),
+        prefetchKey
+      );
+    }
+  }, [resolvedStrategy, resolvedTo, isExternal, ctx, prefetchKey]);
+  useEffect15(() => {
+    if (isExternal || !ctx?.store) return;
+    const isViewport = resolvedStrategy === "viewport";
+    const isRender = resolvedStrategy === "render";
+    if (!isViewport && !isRender) return;
+    const armPrefetch = () => {
+      const element2 = internalRef.current;
+      if (element2 && (isHashOnlyNavigation(element2) || isPrefetchScopeDisabled(element2))) {
+        return () => {
+        };
+      }
+      let cancelled = false;
+      let unsubIdle;
+      let stopObserving;
+      const triggerPrefetch = () => {
+        if (cancelled) return;
+        const currentElement = internalRef.current;
+        if (currentElement && isPrefetchScopeDisabled(currentElement)) return;
+        const segmentState = ctx.store.getSegmentState();
+        prefetchQueued2(
+          resolvedTo,
+          segmentState.currentSegmentIds,
+          getAppVersion(),
+          ctx.store.getRouterId?.(),
+          prefetchKey
+        );
+      };
+      if (isRender) {
+        unsubIdle = schedulePrefetchWhenRouterIdle(
+          ctx.eventController,
+          triggerPrefetch
+        );
       } else {
-        keyToIndex.set(key, result.length);
-        result.push(config);
+        const viewportElement = internalRef.current;
+        if (viewportElement) {
+          stopObserving = observeForPrefetch(viewportElement, () => {
+            unsubIdle = schedulePrefetchWhenRouterIdle(
+              ctx.eventController,
+              triggerPrefetch
+            );
+          });
+        }
+      }
+      return () => {
+        cancelled = true;
+        unsubIdle?.();
+        stopObserving?.();
+      };
+    };
+    let disarmPrefetch = armPrefetch();
+    const element = internalRef.current;
+    const unsubscribeScope = element ? subscribeToPrefetchScopeChange(element, () => {
+      disarmPrefetch();
+      disarmPrefetch = armPrefetch();
+    }) : void 0;
+    const unsubscribeLocation = subscribeToLocationChange(
+      ctx.eventController,
+      () => {
+        disarmPrefetch();
+        disarmPrefetch = armPrefetch();
       }
+    );
+    return () => {
+      unsubscribeScope?.();
+      unsubscribeLocation();
+      disarmPrefetch();
+    };
+  }, [resolvedStrategy, resolvedTo, isExternal, ctx, prefetchKey]);
+  return /* @__PURE__ */ jsx8(
+    "a",
+    {
+      ref: setRef,
+      href: resolvedTo,
+      onClick: handleClick,
+      onMouseEnter: handleMouseEnter,
+      "data-link-component": true,
+      "data-external": isExternal ? "" : void 0,
+      "data-scroll": scroll === false ? "false" : void 0,
+      "data-replace": replace ? "true" : void 0,
+      "data-revalidate": revalidate2 === false ? "false" : void 0,
+      ...props,
+      children: /* @__PURE__ */ jsx8(LinkContext.Provider, { value: resolvedTo, children })
     }
-  }
-  return result;
-}
-var Script = createHandle(collectScripts, "__rsc_router_script__");
-
-// src/handles/Scripts.tsx
-import { useState as useState14 } from "react";
-import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs3 } from "react/jsx-runtime";
+  );
+});
 
 // src/handles/breadcrumbs.ts
 function collectBreadcrumbs(segments) {
@@ -9024,15 +9133,18 @@ var ALL_USE_ITEM_TYPES = new Set(
 );
 
 // src/server/request-context.ts
-import { AsyncLocalStorage as AsyncLocalStorage3 } from "node:async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage4 } from "node:async_hooks";
 init_cookie_name();
 
+// src/server/handle-store.ts
+var LOADER_SLOT = Object.freeze({ loader: true });
+
 // src/router/router-context.ts
-import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
-var routerContext = new AsyncLocalStorage2();
+import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
+var routerContext = new AsyncLocalStorage3();
 
 // src/server/request-context.ts
-var requestContextStorage = new AsyncLocalStorage3();
+var requestContextStorage = new AsyncLocalStorage4();
 
 // src/route-definition/redirect.ts
 init_redirect_origin();
@@ -9226,7 +9338,7 @@ function serializeClientUrlPatterns(patterns) {
 // src/vite/discovery/client-urls-projection.ts
 init_client_ref_hashing();
 init_debug();
-var debug11 = createRangoDebugger(NS.discovery);
+var debug10 = createRangoDebugger(NS.discovery);
 function hasDefaultExport(code) {
   let program;
   try {
@@ -9315,7 +9427,7 @@ async function refreshRecordedClientUrlProjections(state, ssrEnv, serverMod) {
     const projection = serializeClientUrlPatterns(
       definition
     );
-    debug11?.(
+    debug10?.(
       "pre-entry refresh %s -> [%s]",
       source,
       projection.routes.map((route2) => route2.pattern).join(", ")
@@ -9397,21 +9509,21 @@ async function discoverClientUrlProjections(state, ssrEnv, serverMod) {
 }
 
 // src/vite/discovery/discover-routers.ts
-var debug12 = createRangoDebugger(NS.discovery);
+var debug11 = createRangoDebugger(NS.discovery);
 async function discoverRouters(state, rscEnv, ssrEnv) {
   if (!state.resolvedEntryPath) return;
   const serverMod = await timed(
-    debug12,
+    debug11,
     "inner: import @rangojs/router/server",
     () => rscEnv.runner.import("@rangojs/router/server")
   );
   await timed(
-    debug12,
+    debug11,
     "inner: refresh recorded client URL projections",
     () => refreshRecordedClientUrlProjections(state, ssrEnv, serverMod)
   );
   await timed(
-    debug12,
+    debug11,
     "inner: import entry",
     () => rscEnv.runner.import(state.resolvedEntryPath)
   );
@@ -9427,7 +9539,7 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
         const handlerErrors = await resolveHostRouterHandlers(hostRegistry);
         discoveryErrors.push(...handlerErrors);
         for (const { context, error } of handlerErrors) {
-          debug12?.("caught error while resolving %s: %O", context, error);
+          debug11?.("caught error while resolving %s: %O", context, error);
         }
         const freshServerMod = await rscEnv.runner.import(
           "@rangojs/router/server"
@@ -9446,17 +9558,17 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
     }
   }
   await timed(
-    debug12,
+    debug11,
     "inner: discover client URL projections",
     () => discoverClientUrlProjections(state, ssrEnv, serverMod)
   );
   const buildMod = await timed(
-    debug12,
+    debug11,
     "inner: import @rangojs/router/build",
     () => rscEnv.runner.import("@rangojs/router/build")
   );
   const generateManifestFull = buildMod.generateManifestFull;
-  debug12?.("inner: found %d router(s) in registry", registry.size);
+  debug11?.("inner: found %d router(s) in registry", registry.size);
   const nestedRouterConflict = findNestedRouterConflict(
     [...registry.values()].map((router) => router.__sourceFile).filter(
       (sourceFile) => typeof sourceFile === "string"
@@ -9481,7 +9593,7 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
       collectFallbackClientRefs(node, collectClientFallbackRef);
     }
   };
-  const manifestGenStart = debug12 ? performance.now() : 0;
+  const manifestGenStart = debug11 ? performance.now() : 0;
   for (const [id, router] of registry) {
     if (!generateManifestFull) {
       continue;
@@ -9559,12 +9671,12 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
       );
     }
   }
-  debug12?.(
+  debug11?.(
     "inner: generated manifests for %d router(s) (%sms)",
     allManifests.length,
     (performance.now() - manifestGenStart).toFixed(1)
   );
-  const trieStart = debug12 ? performance.now() : 0;
+  const trieStart = debug11 ? performance.now() : 0;
   if (Object.keys(newMergedRouteManifest).length > 0) {
     for (const { id, manifest } of allManifests) {
       const perRouterTrie = buildPerRouterTrie(manifest);
@@ -9573,7 +9685,7 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
       }
     }
   }
-  debug12?.(
+  debug11?.(
     "inner: trie build done (%sms)",
     (performance.now() - trieStart).toFixed(1)
   );
@@ -9608,7 +9720,7 @@ function buildShellManifestKey(pathname) {
 
 // src/vite/discovery/shell-prerender-phase.ts
 init_debug();
-var debug13 = createRangoDebugger(NS.prerender);
+var debug12 = createRangoDebugger(NS.prerender);
 async function runShellPrerenderPhase(s, builder) {
   const tempServer = s.shellPhaseTempServer;
   if (!s.isBuildMode || !s.shellCandidates?.length || !tempServer) return;
@@ -9664,7 +9776,7 @@ async function runShellPrerenderPhase(s, builder) {
     const base = builder?.config?.base ?? "/";
     const normalizedBase = base.endsWith("/") ? base : `${base}/`;
     const bootstrapContent = `import("${normalizedBase}assets/${entryFile}")`;
-    debug13?.("shell prerender bootstrap: %s", bootstrapContent);
+    debug12?.("shell prerender bootstrap: %s", bootstrapContent);
     const minimalPlugin = (tempServer.config?.plugins ?? []).find(
       (p) => p?.name === "rsc:minimal"
     );
@@ -9751,7 +9863,7 @@ async function runShellPrerenderPhase(s, builder) {
             buildEnv: s.resolvedBuildEnv,
             buildVersion,
             captureShellHTML,
-            debug: !!debug13
+            debug: !!debug12
           });
           if (res.outcome === "route-mismatch") {
             mismatches.push(res.matchedRouteName ?? "(no match)");
@@ -10333,7 +10445,7 @@ function postprocessBundle(state) {
 }
 
 // src/vite/discovery/gate-state.ts
-function createDiscoveryGate(s, debug14) {
+function createDiscoveryGate(s, debug13) {
   let gatePending = false;
   let gateResolver = () => {
   };
@@ -10350,7 +10462,7 @@ function createDiscoveryGate(s, debug14) {
   const resolveGate = () => {
     if (!gatePending) return;
     if (inProgress || queued2 || pendingEvents) {
-      debug14?.(
+      debug13?.(
         "hmr: resolveGate deferred \u2014 work in flight (inProgress=%s queued=%s pendingEvents=%s)",
         inProgress,
         queued2,
@@ -10359,7 +10471,7 @@ function createDiscoveryGate(s, debug14) {
       return;
     }
     gatePending = false;
-    debug14?.("hmr: discoveryDone resolved");
+    debug13?.("hmr: discoveryDone resolved");
     gateResolver();
   };
   const noteRouteEvent = () => {
@@ -10369,7 +10481,7 @@ function createDiscoveryGate(s, debug14) {
   const runRefreshCycle = async (work) => {
     if (inProgress) {
       queued2 = true;
-      debug14?.("hmr: rediscovery in flight \u2014 queued for a follow-up cycle");
+      debug13?.("hmr: rediscovery in flight \u2014 queued for a follow-up cycle");
       return;
     }
     pendingEvents = false;
@@ -10380,16 +10492,16 @@ function createDiscoveryGate(s, debug14) {
       inProgress = false;
       if (queued2) {
         queued2 = false;
-        debug14?.("hmr: consuming queued rediscovery");
+        debug13?.("hmr: consuming queued rediscovery");
         runRefreshCycle(work).catch((err) => {
-          debug14?.(
+          debug13?.(
             "hmr: queued cycle rejected \u2014 releasing gate (%s)",
             err instanceof Error ? err.message : String(err)
           );
           resolveGate();
         });
       } else if (pendingEvents) {
-        debug14?.(
+        debug13?.(
           "hmr: holding gate for pending events (debounce not yet fired)"
         );
       } else {
@@ -12356,7 +12468,11 @@ If this is a multi-app host router, export a createHostRouter() instance and set
   plugins.push(createLoaderDirectiveGuardPlugin());
   plugins.push(createLoaderScanStubPlugin());
   plugins.push(exposeActionId());
-  plugins.push(useCacheTransform());
+  plugins.push(
+    useCacheTransform(
+      createCounter(createRangoDebugger(NS.transform), "use-cache")
+    )
+  );
   plugins.push(exposeInternalIds());
   plugins.push(exposeRouterId());
   plugins.push(createVersionPlugin());
@@ -12400,7 +12516,7 @@ function poke() {
     apply: "serve",
     configureServer(server) {
       const stdin = process.stdin;
-      const debug14 = process.env.RANGO_POKE_DEBUG === "1";
+      const debug13 = process.env.RANGO_POKE_DEBUG === "1";
       const triggerReload = (source) => {
         server.hot.send({ type: "full-reload", path: "*" });
         server.config.logger.info(`  browser reload (${source})`, {
@@ -12433,7 +12549,7 @@ function poke() {
         lines.pop();
         return lines;
       };
-      if (debug14) {
+      if (debug13) {
         server.config.logger.info(
           `  poke debug enabled (isTTY=${stdin.isTTY ? "yes" : "no"}, isRaw=${stdin.isTTY ? stdin.isRaw ? "yes" : "no" : "n/a"})`,
           { timestamp: true }
@@ -12446,7 +12562,7 @@ function poke() {
         );
       }
       const onData = (data) => {
-        if (debug14) {
+        if (debug13) {
           server.config.logger.info(`  poke stdin ${formatChunk(data)}`, {
             timestamp: true
           });