@rangojs/router 0.16.0 → 0.18.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.16.0",
+  version: "0.18.0",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -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",
@@ -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,26 +6145,51 @@ 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/rsc/shell-capture-constants.ts
+var SHELL_CAPTURE_MAX_WAIT_MS = 15e3;
+
+// 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();
+function getLoaderBodyTags() {
+  return loaderBodyScopeALS.getStore()?.tags;
+}
+function getCurrentLoaderBodyId() {
+  return loaderBodyScopeALS.getStore()?.loaderId;
+}
 var PUSH_CALLBACK_SCOPE_KEY = /* @__PURE__ */ Symbol.for(
   "rangojs-router:push-callback-scope"
 );
-var pushCallbackScopeALS = globalThis[PUSH_CALLBACK_SCOPE_KEY] ??= new AsyncLocalStorage();
-
-// src/rsc/shell-capture-constants.ts
-var SHELL_CAPTURE_MAX_WAIT_MS = 15e3;
+var pushCallbackScopeALS = globalThis[PUSH_CALLBACK_SCOPE_KEY] ??= new AsyncLocalStorage2();
 
 // src/rsc/shell-serve.ts
 var DEV_SHELL_PROBE_TIMEOUT_MS = 1e4;
 function normalizeCaptureTimeout(value) {
   return typeof value === "number" && Number.isFinite(value) && value >= 1 ? Math.min(value, SHELL_CAPTURE_MAX_WAIT_MS) : void 0;
 }
+var SHELL_PRELUDE_CHUNK_BYTES = 32 * 1024;
 
 // src/vite/inject-client-debug.ts
 function isRouterInternalDebugId(id) {
@@ -6325,7 +6357,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 +6374,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 +7239,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 +7296,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 +7315,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 +7387,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 +7398,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 +7506,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 +7517,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 +7608,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,1313 +7739,1316 @@ 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,
-  useOptimistic,
-  useRef,
-  useState
-} from "react";
+// src/browser/react/context.ts
+import { createContext } from "react";
+var NavigationStoreContext = createContext(null);
 
-// src/thenable-status.ts
-function unwrapsSynchronously(stream) {
-  const status = stream.status;
-  return status === "fulfilled" || status === "resolved_model" || status === "resolved_module";
+// src/handles/meta.ts
+function isUnsetDescriptor(descriptor) {
+  return typeof descriptor === "object" && descriptor !== null && "unset" in descriptor && typeof descriptor.unset === "string";
 }
-
-// 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)];
+function isTitleDescriptor(descriptor) {
+  return typeof descriptor === "object" && descriptor !== null && "title" in descriptor;
 }
-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). 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();
+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,
-        pendingClear: false,
-        clearWhenSettled: false,
-        groups: /* @__PURE__ */ new Map(),
-        refetch: void 0,
-        streamPendingListeners: /* @__PURE__ */ new Set()
-      };
-      this.entries.set(bucketKey, e);
-    }
-    return e;
+  if ("charSet" in descriptor) {
+    return "charSet";
   }
-  registerFamily(loaderId, bucketKey) {
-    let fam = this.families.get(loaderId);
-    if (!fam) {
-      fam = /* @__PURE__ */ new Set();
-      this.families.set(loaderId, fam);
-    }
-    fam.add(bucketKey);
+  if ("title" in descriptor) {
+    return "title";
   }
-  /**
-   * Subscribe to entry changes for `bucketKey`.
-   * Returns an unsubscribe function. A sticky bucket's entry is kept around even
-   * after the last subscriber leaves so that an in-flight `load()` can still
-   * commit if the consumer remounts. An ephemeral bucket is dropped once its
-   * last subscriber leaves (deferred, see maybeScheduleRefcountClear).
-   */
-  subscribe(bucketKey, cb, options) {
-    const e = this.getOrCreate(bucketKey);
-    const loaderId = options?.loaderId ?? bucketKey;
-    e.loaderId = loaderId;
-    this.registerFamily(loaderId, bucketKey);
-    if (options?.ephemeral !== true) e.sticky = true;
-    const groups = normalizeGroups(options?.group);
-    for (const group of groups) {
-      this.addToGroup(group, bucketKey, e, options?.refetch);
-    }
-    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);
-    };
+  if ("name" in descriptor && "content" in descriptor) {
+    return `name:${descriptor.name}`;
   }
-  addToGroup(group, bucketKey, e, refetch) {
-    e.groups.set(group, (e.groups.get(group) ?? 0) + 1);
-    if (refetch) e.refetch = refetch;
-    let members = this.groups.get(group);
-    if (!members) {
-      members = /* @__PURE__ */ new Set();
-      this.groups.set(group, members);
-    }
-    members.add(bucketKey);
+  if ("property" in descriptor && "content" in descriptor) {
+    return `property:${descriptor.property}`;
   }
-  releaseGroup(group, bucketKey, e) {
-    const next = (e.groups.get(group) ?? 0) - 1;
-    if (next > 0) {
-      e.groups.set(group, next);
-      return;
-    }
-    e.groups.delete(group);
-    const members = this.groups.get(group);
-    if (members) {
-      members.delete(bucketKey);
-      if (members.size === 0) this.groups.delete(group);
-    }
+  if ("httpEquiv" in descriptor && "content" in descriptor) {
+    return `httpEquiv:${descriptor.httpEquiv}`;
   }
-  /** Remove a bucket from every group it belongs to (used when it is dropped). */
-  removeFromAllGroups(bucketKey, e) {
-    for (const group of e.groups.keys()) {
-      const members = this.groups.get(group);
-      if (members) {
-        members.delete(bucketKey);
-        if (members.size === 0) this.groups.delete(group);
+  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}`;
       }
     }
-    e.groups.clear();
+    return void 0;
   }
-  /**
-   * Refresh every currently-mounted bucket tagged with ANY of the given group
-   * names, with a plain GET (no params/body). Accepts a single name or an array
-   * of names. A bucket that belongs to more than one of the named groups is
-   * refreshed exactly once (members are unioned and deduped by bucket key), as
-   * are multiple reads of one bucket. Resolves when all refreshes settle; rejects
-   * with an `AggregateError` of the failures if any member fails — each failing
-   * member also records its error on its own snapshot.
-   */
-  async refreshGroups(groups) {
-    const names = typeof groups === "string" ? [groups] : groups;
-    const buckets = /* @__PURE__ */ new Set();
-    for (const name of names) {
-      const members = this.groups.get(name);
-      if (!members) continue;
-      for (const bucketKey of members) buckets.add(bucketKey);
-    }
-    if (buckets.size === 0) return;
-    const thunks = [];
-    for (const bucketKey of buckets) {
-      const e = this.entries.get(bucketKey);
-      if (!e || e.listeners.size === 0 || !e.refetch) continue;
-      thunks.push(e.refetch);
-    }
-    if (thunks.length === 0) return;
-    const results = await Promise.allSettled(thunks.map((t) => t()));
-    const reasons = results.filter((r) => r.status === "rejected").map((r) => r.reason);
-    if (reasons.length > 0) {
-      const label = names.map((n) => `"${n}"`).join(", ");
-      throw new AggregateError(
-        reasons,
-        `refreshGroups(${label}) had ${reasons.length} failure(s)`
-      );
+  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);
   }
-  /**
-   * Schedule a deferred drop for an ad-hoc (never-sticky) bucket whose last
-   * subscriber just left. Deferred to a microtask so a StrictMode / transition
-   * remount that resubscribes in the same tick cancels it.
-   */
-  maybeScheduleRefcountClear(bucketKey, e) {
-    if (e.listeners.size > 0) return;
-    if (e.sticky) return;
-    if (e.pendingClear) return;
-    e.pendingClear = true;
-    queueMicrotask(() => {
-      if (!e.pendingClear) return;
-      e.pendingClear = false;
-      if (e.listeners.size > 0) return;
-      if (e.snapshot.isLoading) {
-        e.clearWhenSettled = true;
-        return;
-      }
-      this.dropBucket(bucketKey);
-    });
+}
+function updateIndicesAfterRemoval(keyToIndex, removedIndex) {
+  for (const [key, index] of keyToIndex) {
+    if (index > removedIndex) {
+      keyToIndex.set(key, index - 1);
+    }
   }
-  /** Remove a bucket entry entirely and prune it from its family/group indexes. */
-  dropBucket(bucketKey) {
-    const e = this.entries.get(bucketKey);
-    if (!e) return;
-    this.removeFromAllGroups(bucketKey, e);
-    this.entries.delete(bucketKey);
-    const fam = this.families.get(e.loaderId);
-    if (fam) {
-      fam.delete(bucketKey);
-      if (fam.size === 0) this.families.delete(e.loaderId);
+}
+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);
   }
-  /** Drop an ephemeral bucket that settled with no subscribers left. */
-  dropIfSettled(bucketKey, e) {
-    if (e.clearWhenSettled && e.listeners.size === 0) {
-      e.clearWhenSettled = false;
-      this.dropBucket(bucketKey);
+  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);
     }
   }
-  /**
-   * Returns the current snapshot for `bucketKey`. Stable reference between
-   * mutations — subscribers rely on this to avoid spurious re-renders.
-   * Returns `EMPTY_SNAPSHOT` (a singleton) when the entry has never been
-   * mutated or has been cleared.
-   */
-  getSnapshot(bucketKey) {
-    return this.entries.get(bucketKey)?.snapshot ?? EMPTY_SNAPSHOT;
-  }
-  /**
-   * Reserve a fresh request id for an upcoming `load()` call. The returned id
-   * is the new "latest"; any older in-flight requests will fail their gating
-   * check on `finishData` / `finishError` / `finishLoading` and be dropped.
-   *
-   * Callers should follow with `beginRequest(id, requestId)` to flip the
-   * loading flag on AND clear any leftover error from a previous attempt
-   * — the latter matters for `throwOnError: false` consumers, which would
-   * otherwise keep showing the stale error throughout the retry.
-   */
-  reserveRequestId(bucketKey) {
-    const e = this.getOrCreate(bucketKey);
-    e.latestRequestId++;
-    return e.latestRequestId;
-  }
-  /**
-   * Mark the request as in-flight: `isLoading = true`, `error = null`.
-   * Combines the two operations so a retry doesn't render the previous
-   * error during the new request. Gated on `requestId === latestRequestId`
-   * for symmetry with the other mutators.
-   */
-  beginRequest(bucketKey, requestId) {
-    const e = this.entries.get(bucketKey);
-    if (!e || requestId !== e.latestRequestId) return;
-    if (e.snapshot.isLoading && e.snapshot.error === null) return;
-    e.snapshot = Object.freeze({
-      value: e.snapshot.value,
-      hasValue: e.snapshot.hasValue,
-      error: null,
-      isLoading: true,
-      requestId
-    });
-    this.notify(e);
-  }
-  /**
-   * Commit a successful result. No-op if `requestId` is not the latest
-   * (a newer `load()` was issued or `clear()` ran). Clearing `error` is
-   * intentional: a successful refetch should hide the previous failure.
-   */
-  finishData(bucketKey, requestId, value) {
-    const e = this.entries.get(bucketKey);
-    if (!e || requestId !== e.latestRequestId) return;
-    e.snapshot = Object.freeze({
-      value,
-      hasValue: true,
-      error: null,
-      isLoading: false,
-      requestId
-    });
-    this.notify(e);
-    this.dropIfSettled(bucketKey, e);
-  }
-  /**
-   * Commit an error. Preserves the last good `value` so consumers can keep
-   * showing previous data while displaying the error if they choose. No-op
-   * if `requestId` is not the latest.
-   */
-  finishError(bucketKey, requestId, error) {
-    const e = this.entries.get(bucketKey);
-    if (!e || requestId !== e.latestRequestId) return;
-    e.snapshot = Object.freeze({
-      value: e.snapshot.value,
-      hasValue: e.snapshot.hasValue,
-      error,
-      isLoading: false,
-      requestId
-    });
-    this.notify(e);
-    this.dropIfSettled(bucketKey, e);
-  }
-  /**
-   * Update loading flag. Gated on `requestId` to fix the race where an old
-   * load() finishes after a new one started — its `setLoading(false)` would
-   * otherwise hide the new request's spinner.
-   */
-  setLoading(bucketKey, requestId, isLoading) {
-    const e = this.entries.get(bucketKey);
-    if (!e || requestId !== e.latestRequestId) return;
-    if (e.snapshot.isLoading === isLoading) return;
-    e.snapshot = Object.freeze({
-      ...e.snapshot,
-      isLoading
-    });
-    this.notify(e);
-  }
-  /**
-   * Reset a single bucket entry. Bumps `latestRequestId` so any in-flight
-   * `load()` whose promise is still pending will fail its gate when it resolves
-   * and be dropped — prevents pre-navigation loads from clobbering the new
-   * route's context. The entry itself is kept (sticky-bucket semantics).
-   */
-  clear(bucketKey) {
-    const e = this.entries.get(bucketKey);
-    if (!e) return;
-    e.latestRequestId++;
-    if (e.snapshot === EMPTY_SNAPSHOT) return;
-    e.snapshot = EMPTY_SNAPSHOT;
-    this.notify(e);
-  }
-  /**
-   * Reset every sticky bucket belonging to `loaderId`. Called on navigation /
-   * route-context change: all route-registered reads of the loader (keyed or
-   * not) drop back to seeding from fresh `loaderData`. Ephemeral buckets are
-   * intentionally left alone — they are governed by subscriber refcount, so a
-   * persistent keyed reader outside the outlet keeps its value across a
-   * navigation rather than blanking out.
-   */
-  clearFamily(loaderId) {
-    const fam = this.families.get(loaderId);
-    if (!fam) return;
-    for (const bucketKey of fam) {
-      const e = this.entries.get(bucketKey);
-      if (!e || !e.sticky) continue;
-      this.clear(bucketKey);
-    }
-  }
-  notify(e) {
-    for (const cb of e.listeners) cb();
-  }
-  /**
-   * 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);
+  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.`
+    );
   }
-  /** True while any navigation stream for `loaderId` is still pending. */
-  isStreamPending(loaderId) {
-    return this.pendingStreams.has(loaderId);
+  if (c.async && c.defer) {
+    console.warn(
+      `[Script] A config has both "async" and "defer"; they are mutually exclusive.`
+    );
   }
-  /**
-   * 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);
+}
+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;
       }
-    }
-    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();
+      const existing = keyToIndex.get(key);
+      if (existing !== void 0) {
+        result[existing] = config;
+      } else {
+        keyToIndex.set(key, result.length);
+        result.push(config);
       }
     }
   }
-  /**
-   * 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
-   */
-  reset() {
-    this.entries.clear();
-    this.families.clear();
-    this.groups.clear();
-    this.pendingStreams.clear();
-  }
-};
-var loaderStore = new LoaderStore();
+  return result;
+}
+var Script = createHandle(collectScripts, "__rsc_router_script__");
 
-// src/browser/react/use-navigation.ts
-import {
-  useContext as useContext5,
-  useState as useState2,
-  useEffect as useEffect3,
-  useOptimistic as useOptimistic2,
-  startTransition as startTransition2,
-  useRef as useRef2
-} from "react";
+// src/handles/Scripts.tsx
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 
-// src/browser/react/use-pathname.ts
-import { useContext as useContext6, useState as useState3, useEffect as useEffect4, useRef as useRef3 } from "react";
+// src/browser/react/ScrollRestoration.tsx
+import { useEffect as useEffect2 } from "react";
 
-// src/client-urls/optimistic-location.ts
+// src/browser/scroll-restoration.ts
+init_logging();
+
+// src/outlet-context.ts
 import { createContext as createContext4 } from "react";
-var OptimisticLocationContext = createContext4(null);
+var OutletContext = createContext4(null);
 
-// src/browser/react/use-search-params.ts
-import {
-  useCallback as useCallback2,
-  useContext as useContext7,
-  useEffect as useEffect5,
-  useMemo as useMemo4,
-  useRef as useRef4,
-  useState as useState4
-} from "react";
-
-// src/browser/react/use-params.ts
-import { useContext as useContext8, useState as useState5, useEffect as useEffect6, useRef as useRef5 } from "react";
-var EMPTY_PARAMS = Object.freeze({});
+// src/route-content-wrapper.tsx
+import { Component, Suspense, use } from "react";
 
-// src/browser/react/nonce-context.ts
-import { createContext as createContext5, useContext as useContext9 } from "react";
-var NonceContext = createContext5(void 0);
+// src/outlet-provider.tsx
+import { useContext as useContext4, useMemo } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
 
-// src/browser/react/use-action.ts
-import {
-  useContext as useContext10,
-  useState as useState6,
-  useEffect as useEffect7,
-  useRef as useRef6,
-  useOptimistic as useOptimistic3,
-  startTransition as startTransition3
-} from "react";
+// src/decode-loader-results.ts
+import { createElement as createElement2 } from "react";
 
-// src/browser/react/use-segments.ts
-import { useContext as useContext11, useState as useState7, useEffect as useEffect8, useRef as useRef7 } from "react";
+// src/loader-redirect.tsx
+import { useEffect as useEffect3 } from "react";
 
-// src/browser/react/NavigationProvider.tsx
-import {
-  useState as useState10,
-  useEffect as useEffect10,
-  useLayoutEffect,
-  useCallback as useCallback4,
-  useMemo as useMemo6,
-  useRef as useRef9,
-  use as use3
-} from "react";
+// src/browser/react/use-router.ts
+import { useContext as useContext6, useMemo as useMemo2 } 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";
+// src/browser/react/use-mount.ts
+import { useContext as useContext5 } from "react";
 
-// src/theme/ThemeProvider.tsx
+// src/browser/react/mount-context.ts
 import {
-  useCallback as useCallback3,
-  useEffect as useEffect9,
-  useMemo as useMemo5,
-  useState as useState9
+  createContext as createContext5,
+  createElement
 } from "react";
+var MountContext = createContext5("/");
 
-// 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,
-  // 1 year
-  path: "/",
-  sameSite: "lax"
-};
-
-// src/theme/ThemeProvider.tsx
-import { jsx as jsx4 } from "react/jsx-runtime";
-
-// src/browser/react/NavigationProvider.tsx
+// src/browser/react/use-router.ts
 init_loader();
 
-// src/browser/scroll-restoration.ts
-init_logging();
-
-// src/browser/react/NavigationProvider.tsx
-init_logging();
-
-// src/browser/navigation-store.ts
-init_cache();
-init_rango_state();
+// src/browser/app-version.ts
+var currentVersion2;
+function getAppVersion() {
+  return currentVersion2;
+}
 
-// src/browser/react/NavigationProvider.tsx
-import { jsx as jsx5 } from "react/jsx-runtime";
+// src/loader-redirect.tsx
+init_validate_redirect_origin();
+init_redirect_origin();
 
-// src/browser/react/Link.tsx
-import {
-  forwardRef,
-  useCallback as useCallback5,
-  useContext as useContext14,
-  useEffect as useEffect13,
-  useMemo as useMemo7,
-  useRef as useRef12,
-  useSyncExternalStore
-} from "react";
+// src/route-content-wrapper.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
 
-// src/browser/react/use-link-status.ts
+// src/use-loader.tsx
 import {
-  createContext as createContext7,
-  useContext as useContext13,
-  useState as useState11,
-  useEffect as useEffect11,
-  useRef as useRef10,
-  useOptimistic as useOptimistic4,
-  startTransition as startTransition4
+  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";
-var LinkContext = createContext7(
-  null
-);
 
-// src/browser/event-controller.ts
-init_notify_listeners();
-if (typeof Symbol.dispose === "undefined") {
-  Symbol.dispose = /* @__PURE__ */ Symbol("Symbol.dispose");
+// src/thenable-status.ts
+function unwrapsSynchronously(stream) {
+  const status = stream.status;
+  return status === "fulfilled" || status === "resolved_model" || status === "resolved_module";
 }
-if (typeof Symbol.asyncDispose === "undefined") {
-  Symbol.asyncDispose = /* @__PURE__ */ Symbol("Symbol.asyncDispose");
+
+// 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 locationChangeSubscriptions = /* @__PURE__ */ new WeakMap();
-function subscribeToLocationChange(eventController, listener) {
-  let subscription = locationChangeSubscriptions.get(eventController);
-  if (!subscription) {
-    subscription = {
-      registrations: /* @__PURE__ */ new Map(),
-      notificationVersion: 0,
-      unsubscribe: () => {
-      }
-    };
-    locationChangeSubscriptions.set(eventController, subscription);
-    const currentSubscription = subscription;
-    subscription.unsubscribe = eventController.subscribe(() => {
-      const notificationVersion = ++currentSubscription.notificationVersion;
-      const nextHref = eventController.getState().location.href;
-      notifyListeners(
-        [...currentSubscription.registrations],
-        ([, registration]) => {
-          if (registration.href === nextHref) return;
-          registration.href = nextHref;
-          registration.listener(nextHref);
-        },
-        ([token2, registration]) => currentSubscription.registrations.get(token2) === registration,
-        () => notificationVersion === currentSubscription.notificationVersion
-      );
-    });
+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();
   }
-  const token = /* @__PURE__ */ Symbol();
-  subscription.registrations.set(token, {
-    href: eventController.getState().location.href,
-    listener
-  });
-  let active2 = true;
-  return () => {
-    if (!active2) return;
-    active2 = false;
-    subscription.registrations.delete(token);
-    if (subscription.registrations.size > 0) return;
-    if (locationChangeSubscriptions.get(eventController) === subscription) {
-      locationChangeSubscriptions.delete(eventController);
+  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,
+        streamPendingListeners: /* @__PURE__ */ new Set()
+      };
+      this.entries.set(bucketKey, e);
     }
-    subscription.unsubscribe();
-  };
-}
-
-// src/browser/prefetch/default-strategy.ts
-var hoverNoneQuery = null;
-var defaultStrategy = process.env.NODE_ENV === "production" ? "viewport" : "none";
-function getHoverNoneQuery() {
-  if (typeof window === "undefined") return null;
-  if (!hoverNoneQuery) {
-    hoverNoneQuery = window.matchMedia("(hover: none)");
+    return e;
   }
-  return hoverNoneQuery;
-}
-function getDefaultPrefetchStrategy() {
-  return defaultStrategy;
-}
-function resolveAdaptiveStrategy(strategy) {
-  if (strategy !== "adaptive") return strategy;
-  return getHoverNoneQuery()?.matches ? "viewport" : "hover";
-}
-function subscribeToAdaptiveStrategyChange(listener) {
-  const query = getHoverNoneQuery();
-  if (!query) return () => {
-  };
-  if (typeof query.addEventListener === "function") {
-    query.addEventListener("change", listener);
-    return () => query.removeEventListener("change", listener);
+  registerFamily(loaderId, bucketKey) {
+    let fam = this.families.get(loaderId);
+    if (!fam) {
+      fam = /* @__PURE__ */ new Set();
+      this.families.set(loaderId, fam);
+    }
+    fam.add(bucketKey);
   }
-  query.addListener(listener);
-  return () => query.removeListener(listener);
-}
-
-// src/browser/prefetch/observer.ts
-init_notify_listeners();
-var callbacks = /* @__PURE__ */ new Map();
-var observer = null;
-function getObserver() {
-  if (!observer) {
-    observer = new IntersectionObserver(
-      (entries, currentObserver) => {
-        function* intersectingCallbacks() {
-          for (const entry of entries) {
-            if (entry.isIntersecting) {
-              const subscriptions = callbacks.get(entry.target);
-              if (subscriptions) {
-                currentObserver.unobserve(entry.target);
-                callbacks.delete(entry.target);
-                for (const [subscription, callback] of subscriptions) {
-                  yield [subscriptions, subscription, callback];
-                }
-              }
-            }
-          }
-        }
-        notifyListeners(
-          intersectingCallbacks(),
-          ([, , callback]) => callback(),
-          ([subscriptions, subscription]) => subscriptions.has(subscription)
-        );
-      },
-      { rootMargin: "200px" }
-    );
-    for (const element of callbacks.keys()) observer.observe(element);
-  }
-  return observer;
-}
-function observeForPrefetch(element, onVisible) {
-  if (typeof IntersectionObserver === "undefined") return () => {
-  };
-  const currentObserver = getObserver();
-  let subscriptions = callbacks.get(element);
-  if (!subscriptions) {
-    subscriptions = /* @__PURE__ */ new Map();
-    callbacks.set(element, subscriptions);
-  }
-  const subscription = /* @__PURE__ */ Symbol();
-  subscriptions.set(subscription, onVisible);
-  if (subscriptions.size === 1) currentObserver.observe(element);
-  return () => {
-    const current = callbacks.get(element);
-    subscriptions.delete(subscription);
-    if (current !== subscriptions) return;
-    if (current.size > 0) return;
-    callbacks.delete(element);
-    observer?.unobserve(element);
-  };
-}
-
-// src/browser/link-interceptor.ts
-init_invalidation();
-init_notify_listeners();
-var ELIGIBILITY_ATTRIBUTES = {
-  href: "href",
-  target: "target",
-  download: "download",
-  noIntercept: "data-no-intercept",
-  linkComponent: "data-link-component",
-  external: "data-external",
-  prefetch: "data-prefetch",
-  prefetchScope: "data-prefetch-scope"
-};
-var ELIGIBILITY_ATTRIBUTE_FILTER = Object.values(ELIGIBILITY_ATTRIBUTES);
-var ELIGIBLE_ANCHOR_SELECTOR = `a[${ELIGIBILITY_ATTRIBUTES.href}]`;
-var LINK_COMPONENT_SELECTOR = `a[${ELIGIBILITY_ATTRIBUTES.linkComponent}]`;
-var PREFETCH_SCOPE_OPT_OUT_SELECTOR = `[${ELIGIBILITY_ATTRIBUTES.prefetchScope}="false"],[${ELIGIBILITY_ATTRIBUTES.prefetchScope}="none"]`;
-function isElementNode(value) {
-  return typeof value === "object" && value !== null && value.nodeType === 1 && typeof value.matches === "function";
-}
-var prefetchScopeObservers = /* @__PURE__ */ new WeakMap();
-function createPrefetchScopeObserverState(ownerDocument) {
-  if (typeof MutationObserver === "undefined" || !ownerDocument.documentElement) {
-    return void 0;
-  }
-  const subscriptions = /* @__PURE__ */ new Map();
-  const observer2 = new MutationObserver((mutations) => {
-    const affected = /* @__PURE__ */ new Set();
-    const collect = (element) => {
-      subscriptions.get(element)?.forEach((listener) => affected.add(listener));
-    };
-    for (const mutation of mutations) {
-      if (!isElementNode(mutation.target)) continue;
-      collect(mutation.target);
-      mutation.target.querySelectorAll(LINK_COMPONENT_SELECTOR).forEach(collect);
+  /**
+   * Subscribe to entry changes for `bucketKey`.
+   * Returns an unsubscribe function. A sticky bucket's entry is kept around even
+   * after the last subscriber leaves so that an in-flight `load()` can still
+   * commit if the consumer remounts. An ephemeral bucket is dropped once its
+   * last subscriber leaves (deferred, see maybeScheduleRefcountClear).
+   */
+  subscribe(bucketKey, cb, options) {
+    const e = this.getOrCreate(bucketKey);
+    const loaderId = options?.loaderId ?? bucketKey;
+    e.loaderId = loaderId;
+    this.registerFamily(loaderId, bucketKey);
+    if (options?.ephemeral !== true) e.sticky = true;
+    const groups = normalizeGroups(options?.group);
+    for (const group of groups) {
+      this.addToGroup(group, bucketKey, e, options?.refetch);
     }
-    notifyListeners(affected, (listener) => listener());
-  });
-  observer2.observe(ownerDocument.documentElement, {
-    subtree: true,
-    attributes: true,
-    attributeFilter: [ELIGIBILITY_ATTRIBUTES.prefetchScope]
-  });
-  return { observer: observer2, subscriptions };
-}
-function subscribeToPrefetchScopeChange(element, listener) {
-  const ownerDocument = element.ownerDocument;
-  let state = prefetchScopeObservers.get(ownerDocument);
-  if (!state) {
-    state = createPrefetchScopeObserverState(ownerDocument);
-    if (!state) return () => {
+    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);
     };
-    prefetchScopeObservers.set(ownerDocument, state);
   }
-  let listeners = state.subscriptions.get(element);
-  if (!listeners) {
-    listeners = /* @__PURE__ */ new Set();
-    state.subscriptions.set(element, listeners);
+  addToGroup(group, bucketKey, e, refetch) {
+    e.groups.set(group, (e.groups.get(group) ?? 0) + 1);
+    if (refetch) e.refetch = refetch;
+    let members = this.groups.get(group);
+    if (!members) {
+      members = /* @__PURE__ */ new Set();
+      this.groups.set(group, members);
+    }
+    members.add(bucketKey);
   }
-  listeners.add(listener);
-  let active2 = true;
-  return () => {
-    if (!active2) return;
-    active2 = false;
-    listeners.delete(listener);
-    if (listeners.size === 0 && state.subscriptions.get(element) === listeners) {
-      state.subscriptions.delete(element);
+  releaseGroup(group, bucketKey, e) {
+    const next = (e.groups.get(group) ?? 0) - 1;
+    if (next > 0) {
+      e.groups.set(group, next);
+      return;
     }
-    if (state.subscriptions.size === 0 && prefetchScopeObservers.get(ownerDocument) === state) {
-      state.observer.disconnect();
-      prefetchScopeObservers.delete(ownerDocument);
+    e.groups.delete(group);
+    const members = this.groups.get(group);
+    if (members) {
+      members.delete(bucketKey);
+      if (members.size === 0) this.groups.delete(group);
     }
-  };
-}
-function isHashOnlyNavigationToPath(anchor, pathname) {
-  return pathname === window.location.pathname && anchor.search === window.location.search && !!anchor.hash;
-}
-function isHashOnlyNavigation(anchor) {
-  return isHashOnlyNavigationToPath(anchor, anchor.pathname);
-}
-function isPrefetchScopeDisabled(element) {
-  return typeof element.closest === "function" && element.closest(PREFETCH_SCOPE_OPT_OUT_SELECTOR) !== null;
-}
-
-// 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;
-}
-
-// 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;
+  /** Remove a bucket from every group it belongs to (used when it is dropped). */
+  removeFromAllGroups(bucketKey, e) {
+    for (const group of e.groups.keys()) {
+      const members = this.groups.get(group);
+      if (members) {
+        members.delete(bucketKey);
+        if (members.size === 0) this.groups.delete(group);
+      }
     }
+    e.groups.clear();
   }
-  if (/^[a-z][a-z0-9+.-]*:/i.test(href2)) {
-    return true;
+  /**
+   * Refresh every currently-mounted bucket tagged with ANY of the given group
+   * names, with a plain GET (no params/body). Accepts a single name or an array
+   * of names. A bucket that belongs to more than one of the named groups is
+   * refreshed exactly once (members are unioned and deduped by bucket key), as
+   * are multiple reads of one bucket. Resolves when all refreshes settle; rejects
+   * with an `AggregateError` of the failures if any member fails — each failing
+   * member also records its error on its own snapshot.
+   */
+  async refreshGroups(groups) {
+    const names = typeof groups === "string" ? [groups] : groups;
+    const buckets = /* @__PURE__ */ new Set();
+    for (const name of names) {
+      const members = this.groups.get(name);
+      if (!members) continue;
+      for (const bucketKey of members) buckets.add(bucketKey);
+    }
+    if (buckets.size === 0) return;
+    const thunks = [];
+    for (const bucketKey of buckets) {
+      const e = this.entries.get(bucketKey);
+      if (!e || e.listeners.size === 0 || !e.refetch) continue;
+      thunks.push(e.refetch);
+    }
+    if (thunks.length === 0) return;
+    const results = await Promise.allSettled(thunks.map((t) => t()));
+    const reasons = results.filter((r) => r.status === "rejected").map((r) => r.reason);
+    if (reasons.length > 0) {
+      const label = names.map((n) => `"${n}"`).join(", ");
+      throw new AggregateError(
+        reasons,
+        `refreshGroups(${label}) had ${reasons.length} failure(s)`
+      );
+    }
   }
-  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) {
+  /**
+   * Schedule a deferred drop for an ad-hoc (never-sticky) bucket whose last
+   * subscriber just left. Deferred to a microtask so a StrictMode / transition
+   * remount that resubscribes in the same tick cancels it.
+   */
+  maybeScheduleRefcountClear(bucketKey, e) {
+    if (e.listeners.size > 0) return;
+    if (e.sticky) return;
+    if (e.pendingClear) return;
+    e.pendingClear = true;
+    queueMicrotask(() => {
+      if (!e.pendingClear) return;
+      e.pendingClear = false;
+      if (e.listeners.size > 0) return;
+      if (e.snapshot.isLoading) {
+        e.clearWhenSettled = true;
         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
-      );
+      this.dropBucket(bucketKey);
+    });
+  }
+  /** Remove a bucket entry entirely and prune it from its family/group indexes. */
+  dropBucket(bucketKey) {
+    const e = this.entries.get(bucketKey);
+    if (!e) return;
+    this.removeFromAllGroups(bucketKey, e);
+    this.entries.delete(bucketKey);
+    const fam = this.families.get(e.loaderId);
+    if (fam) {
+      fam.delete(bucketKey);
+      if (fam.size === 0) this.families.delete(e.loaderId);
     }
-  }, [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?.();
-      };
+  }
+  /** Drop an ephemeral bucket that settled with no subscribers left. */
+  dropIfSettled(bucketKey, e) {
+    if (e.clearWhenSettled && e.listeners.size === 0) {
+      e.clearWhenSettled = false;
+      this.dropBucket(bucketKey);
+    }
+  }
+  /**
+   * Returns the current snapshot for `bucketKey`. Stable reference between
+   * mutations — subscribers rely on this to avoid spurious re-renders.
+   * Returns `EMPTY_SNAPSHOT` (a singleton) when the entry has never been
+   * mutated or has been cleared.
+   */
+  getSnapshot(bucketKey) {
+    return this.entries.get(bucketKey)?.snapshot ?? EMPTY_SNAPSHOT;
+  }
+  /**
+   * Reserve a fresh request id for an upcoming `load()` call. The returned id
+   * is the new "latest"; any older in-flight requests will fail their gating
+   * check on `finishData` / `finishError` / `finishLoading` and be dropped.
+   *
+   * Callers should follow with `beginRequest(id, requestId)` to flip the
+   * loading flag on AND clear any leftover error from a previous attempt
+   * — the latter matters for `throwOnError: false` consumers, which would
+   * otherwise keep showing the stale error throughout the retry.
+   */
+  reserveRequestId(bucketKey) {
+    const e = this.getOrCreate(bucketKey);
+    e.latestRequestId++;
+    return e.latestRequestId;
+  }
+  /**
+   * Mark the request as in-flight: `isLoading = true`, `error = null`.
+   * Combines the two operations so a retry doesn't render the previous
+   * error during the new request. Gated on `requestId === latestRequestId`
+   * for symmetry with the other mutators.
+   */
+  beginRequest(bucketKey, requestId) {
+    const e = this.entries.get(bucketKey);
+    if (!e || requestId !== e.latestRequestId) return;
+    if (e.snapshot.isLoading && e.snapshot.error === null) return;
+    e.snapshot = Object.freeze({
+      value: e.snapshot.value,
+      hasValue: e.snapshot.hasValue,
+      error: null,
+      isLoading: true,
+      requestId
+    });
+    this.notify(e);
+  }
+  /**
+   * Commit a successful result. No-op if `requestId` is not the latest
+   * (a newer `load()` was issued or `clear()` ran). Clearing `error` is
+   * intentional: a successful refetch should hide the previous failure.
+   */
+  finishData(bucketKey, requestId, value) {
+    const e = this.entries.get(bucketKey);
+    if (!e || requestId !== e.latestRequestId) return;
+    e.snapshot = Object.freeze({
+      value,
+      hasValue: true,
+      error: null,
+      isLoading: false,
+      requestId
+    });
+    this.notify(e);
+    this.dropIfSettled(bucketKey, e);
+  }
+  /**
+   * Commit an error. Preserves the last good `value` so consumers can keep
+   * showing previous data while displaying the error if they choose. No-op
+   * if `requestId` is not the latest.
+   */
+  finishError(bucketKey, requestId, error) {
+    const e = this.entries.get(bucketKey);
+    if (!e || requestId !== e.latestRequestId) return;
+    e.snapshot = Object.freeze({
+      value: e.snapshot.value,
+      hasValue: e.snapshot.hasValue,
+      error,
+      isLoading: false,
+      requestId
+    });
+    this.notify(e);
+    this.dropIfSettled(bucketKey, e);
+  }
+  /**
+   * Update loading flag. Gated on `requestId` to fix the race where an old
+   * load() finishes after a new one started — its `setLoading(false)` would
+   * otherwise hide the new request's spinner.
+   */
+  setLoading(bucketKey, requestId, isLoading) {
+    const e = this.entries.get(bucketKey);
+    if (!e || requestId !== e.latestRequestId) return;
+    if (e.snapshot.isLoading === isLoading) return;
+    e.snapshot = Object.freeze({
+      ...e.snapshot,
+      isLoading
+    });
+    this.notify(e);
+  }
+  /**
+   * Reset a single bucket entry. Bumps `latestRequestId` so any in-flight
+   * `load()` whose promise is still pending will fail its gate when it resolves
+   * and be dropped — prevents pre-navigation loads from clobbering the new
+   * route's context. The entry itself is kept (sticky-bucket semantics).
+   */
+  clear(bucketKey) {
+    const e = this.entries.get(bucketKey);
+    if (!e) return;
+    e.latestRequestId++;
+    if (e.snapshot === EMPTY_SNAPSHOT) return;
+    e.snapshot = EMPTY_SNAPSHOT;
+    this.notify(e);
+  }
+  /**
+   * Reset every sticky bucket belonging to `loaderId`. Called on navigation /
+   * route-context change: all route-registered reads of the loader (keyed or
+   * not) drop back to seeding from fresh `loaderData`. Ephemeral buckets are
+   * intentionally left alone — they are governed by subscriber refcount, so a
+   * persistent keyed reader outside the outlet keeps its value across a
+   * navigation rather than blanking out.
+   */
+  clearFamily(loaderId) {
+    const fam = this.families.get(loaderId);
+    if (!fam) return;
+    for (const bucketKey of fam) {
+      const e = this.entries.get(bucketKey);
+      if (!e || !e.sticky) continue;
+      this.clear(bucketKey);
+    }
+  }
+  notify(e) {
+    for (const cb of e.listeners) cb();
+  }
+  /**
+   * 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);
     };
-    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();
+    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();
       }
-    );
-    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 })
     }
-  );
-});
+  }
+  /**
+   * 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
+   */
+  reset() {
+    this.entries.clear();
+    this.families.clear();
+    this.groups.clear();
+    this.pendingStreams.clear();
+  }
+};
+var loaderStore = new LoaderStore();
 
-// src/browser/react/ScrollRestoration.tsx
-import { useEffect as useEffect14 } from "react";
+// src/browser/react/use-navigation.ts
+import {
+  useContext as useContext8,
+  useState as useState4,
+  useEffect as useEffect5,
+  useOptimistic as useOptimistic3,
+  startTransition as startTransition3,
+  useRef as useRef3
+} from "react";
 
-// src/browser/react/use-handle.ts
+// src/browser/react/use-pathname.ts
+import { useContext as useContext9, useState as useState5, useEffect as useEffect6, useRef as useRef4 } from "react";
+
+// src/client-urls/optimistic-location.ts
+import { createContext as createContext6 } from "react";
+var OptimisticLocationContext = createContext6(null);
+
+// src/browser/react/use-search-params.ts
+import {
+  useCallback as useCallback2,
+  useContext as useContext10,
+  useEffect as useEffect7,
+  useMemo as useMemo4,
+  useRef as useRef5,
+  useState as useState6
+} from "react";
+
+// src/browser/react/use-params.ts
+import { useContext as useContext11, useState as useState7, useEffect as useEffect8, useRef as useRef6 } from "react";
+var EMPTY_PARAMS = Object.freeze({});
+
+// src/browser/react/use-action.ts
+import {
+  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 useContext13, useState as useState9, useEffect as useEffect10, useRef as useRef8 } from "react";
+
+// src/browser/react/NavigationProvider.tsx
+import {
+  useState as useState12,
+  useEffect as useEffect12,
+  useLayoutEffect,
+  useCallback as useCallback4,
+  useMemo as useMemo6,
+  useRef as useRef10,
+  use as use3
+} from "react";
+
+// src/root-error-boundary.tsx
+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 useEffect11,
+  useMemo as useMemo5,
+  useState as useState11
+} from "react";
+
+// src/theme/constants.ts
+var THEME_COOKIE = {
+  maxAge: 60 * 60 * 24 * 365,
+  // 1 year
+  path: "/",
+  sameSite: "lax"
+};
+
+// src/theme/ThemeProvider.tsx
+import { jsx as jsx6 } from "react/jsx-runtime";
+
+// src/browser/react/NavigationProvider.tsx
+init_loader();
+init_logging();
+
+// src/browser/navigation-store.ts
+init_cache();
+init_rango_state();
+
+// src/browser/react/NavigationProvider.tsx
+import { jsx as jsx7 } from "react/jsx-runtime";
+
+// src/browser/react/Link.tsx
 import {
+  forwardRef,
+  useCallback as useCallback5,
   useContext as useContext15,
-  useState as useState13,
   useEffect as useEffect15,
+  useMemo as useMemo7,
   useRef as useRef13,
+  useSyncExternalStore
+} from "react";
+
+// src/browser/react/use-link-status.ts
+import {
+  createContext as createContext7,
+  useContext as useContext14,
+  useState as useState13,
+  useEffect as useEffect13,
+  useRef as useRef11,
   useOptimistic as useOptimistic5,
   startTransition as startTransition5
 } from "react";
+var LinkContext = createContext7(
+  null
+);
 
-// 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;
+// src/browser/event-controller.ts
+init_notify_listeners();
+if (typeof Symbol.dispose === "undefined") {
+  Symbol.dispose = /* @__PURE__ */ Symbol("Symbol.dispose");
+}
+if (typeof Symbol.asyncDispose === "undefined") {
+  Symbol.asyncDispose = /* @__PURE__ */ Symbol("Symbol.asyncDispose");
+}
+var locationChangeSubscriptions = /* @__PURE__ */ new WeakMap();
+function subscribeToLocationChange(eventController, listener) {
+  let subscription = locationChangeSubscriptions.get(eventController);
+  if (!subscription) {
+    subscription = {
+      registrations: /* @__PURE__ */ new Map(),
+      notificationVersion: 0,
+      unsubscribe: () => {
       }
-      const base = path6.split(/[\\/]/).pop().replace(/\.(?:ts|tsx|js|jsx|mts|cts)$/, "");
-      if (SELF_FILES.has(base)) continue;
-      return `${path6}:${m[2]}:${m[3]}`;
+    };
+    locationChangeSubscriptions.set(eventController, subscription);
+    const currentSubscription = subscription;
+    subscription.unsubscribe = eventController.subscribe(() => {
+      const notificationVersion = ++currentSubscription.notificationVersion;
+      const nextHref = eventController.getState().location.href;
+      notifyListeners(
+        [...currentSubscription.registrations],
+        ([, registration]) => {
+          if (registration.href === nextHref) return;
+          registration.href = nextHref;
+          registration.listener(nextHref);
+        },
+        ([token2, registration]) => currentSubscription.registrations.get(token2) === registration,
+        () => notificationVersion === currentSubscription.notificationVersion
+      );
+    });
+  }
+  const token = /* @__PURE__ */ Symbol();
+  subscription.registrations.set(token, {
+    href: eventController.getState().location.href,
+    listener
+  });
+  let active2 = true;
+  return () => {
+    if (!active2) return;
+    active2 = false;
+    subscription.registrations.delete(token);
+    if (subscription.registrations.size > 0) return;
+    if (locationChangeSubscriptions.get(eventController) === subscription) {
+      locationChangeSubscriptions.delete(eventController);
     }
-  } catch {
+    subscription.unsubscribe();
+  };
+}
+
+// src/browser/prefetch/default-strategy.ts
+var hoverNoneQuery = null;
+var defaultStrategy = process.env.NODE_ENV === "production" ? "viewport" : "none";
+function getHoverNoneQuery() {
+  if (typeof window === "undefined") return null;
+  if (!hoverNoneQuery) {
+    hoverNoneQuery = window.matchMedia("(hover: none)");
+  }
+  return hoverNoneQuery;
+}
+function getDefaultPrefetchStrategy() {
+  return defaultStrategy;
+}
+function resolveAdaptiveStrategy(strategy) {
+  if (strategy !== "adaptive") return strategy;
+  return getHoverNoneQuery()?.matches ? "viewport" : "hover";
+}
+function subscribeToAdaptiveStrategyChange(listener) {
+  const query = getHoverNoneQuery();
+  if (!query) return () => {
+  };
+  if (typeof query.addEventListener === "function") {
+    query.addEventListener("change", listener);
+    return () => query.removeEventListener("change", listener);
+  }
+  query.addListener(listener);
+  return () => query.removeListener(listener);
+}
+
+// src/browser/prefetch/observer.ts
+init_notify_listeners();
+var callbacks = /* @__PURE__ */ new Map();
+var observer = null;
+function getObserver() {
+  if (!observer) {
+    observer = new IntersectionObserver(
+      (entries, currentObserver) => {
+        function* intersectingCallbacks() {
+          for (const entry of entries) {
+            if (entry.isIntersecting) {
+              const subscriptions = callbacks.get(entry.target);
+              if (subscriptions) {
+                currentObserver.unobserve(entry.target);
+                callbacks.delete(entry.target);
+                for (const [subscription, callback] of subscriptions) {
+                  yield [subscriptions, subscription, callback];
+                }
+              }
+            }
+          }
+        }
+        notifyListeners(
+          intersectingCallbacks(),
+          ([, , callback]) => callback(),
+          ([subscriptions, subscription]) => subscriptions.has(subscription)
+        );
+      },
+      { rootMargin: "200px" }
+    );
+    for (const element of callbacks.keys()) observer.observe(element);
   }
-  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;
+  return observer;
 }
-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(...)`."
-      );
-    }
+function observeForPrefetch(element, onVisible) {
+  if (typeof IntersectionObserver === "undefined") return () => {
+  };
+  const currentObserver = getObserver();
+  let subscriptions = callbacks.get(element);
+  if (!subscriptions) {
+    subscriptions = /* @__PURE__ */ new Map();
+    callbacks.set(element, subscriptions);
   }
-  const collectFn = collect ?? defaultCollect;
-  collectRegistry.set(
-    handleId,
-    collectFn
-  );
-  return {
-    __brand: "handle",
-    $$id: handleId
+  const subscription = /* @__PURE__ */ Symbol();
+  subscriptions.set(subscription, onVisible);
+  if (subscriptions.size === 1) currentObserver.observe(element);
+  return () => {
+    const current = callbacks.get(element);
+    subscriptions.delete(subscription);
+    if (current !== subscriptions) return;
+    if (current.size > 0) return;
+    callbacks.delete(element);
+    observer?.unobserve(element);
   };
 }
 
-// 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;
+// src/browser/link-interceptor.ts
+init_invalidation();
+init_notify_listeners();
+var ELIGIBILITY_ATTRIBUTES = {
+  href: "href",
+  target: "target",
+  download: "download",
+  noIntercept: "data-no-intercept",
+  linkComponent: "data-link-component",
+  external: "data-external",
+  prefetch: "data-prefetch",
+  prefetchScope: "data-prefetch-scope"
+};
+var ELIGIBILITY_ATTRIBUTE_FILTER = Object.values(ELIGIBILITY_ATTRIBUTES);
+var ELIGIBLE_ANCHOR_SELECTOR = `a[${ELIGIBILITY_ATTRIBUTES.href}]`;
+var LINK_COMPONENT_SELECTOR = `a[${ELIGIBILITY_ATTRIBUTES.linkComponent}]`;
+var PREFETCH_SCOPE_OPT_OUT_SELECTOR = `[${ELIGIBILITY_ATTRIBUTES.prefetchScope}="false"],[${ELIGIBILITY_ATTRIBUTES.prefetchScope}="none"]`;
+function isElementNode(value) {
+  return typeof value === "object" && value !== null && value.nodeType === 1 && typeof value.matches === "function";
 }
-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) {
+var prefetchScopeObservers = /* @__PURE__ */ new WeakMap();
+function createPrefetchScopeObserverState(ownerDocument) {
+  if (typeof MutationObserver === "undefined" || !ownerDocument.documentElement) {
     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}`;
-      }
+  const subscriptions = /* @__PURE__ */ new Map();
+  const observer2 = new MutationObserver((mutations) => {
+    const affected = /* @__PURE__ */ new Set();
+    const collect = (element) => {
+      subscriptions.get(element)?.forEach((listener) => affected.add(listener));
+    };
+    for (const mutation of mutations) {
+      if (!isElementNode(mutation.target)) continue;
+      collect(mutation.target);
+      mutation.target.querySelectorAll(LINK_COMPONENT_SELECTOR).forEach(collect);
     }
-    return void 0;
-  }
-  return void 0;
+    notifyListeners(affected, (listener) => listener());
+  });
+  observer2.observe(ownerDocument.documentElement, {
+    subtree: true,
+    attributes: true,
+    attributeFilter: [ELIGIBILITY_ATTRIBUTES.prefetchScope]
+  });
+  return { observer: observer2, subscriptions };
 }
-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 subscribeToPrefetchScopeChange(element, listener) {
+  const ownerDocument = element.ownerDocument;
+  let state = prefetchScopeObservers.get(ownerDocument);
+  if (!state) {
+    state = createPrefetchScopeObserverState(ownerDocument);
+    if (!state) return () => {
+    };
+    prefetchScopeObservers.set(ownerDocument, state);
   }
-}
-function updateIndicesAfterRemoval(keyToIndex, removedIndex) {
-  for (const [key, index] of keyToIndex) {
-    if (index > removedIndex) {
-      keyToIndex.set(key, index - 1);
-    }
+  let listeners = state.subscriptions.get(element);
+  if (!listeners) {
+    listeners = /* @__PURE__ */ new Set();
+    state.subscriptions.set(element, listeners);
   }
-}
-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);
+  listeners.add(listener);
+  let active2 = true;
+  return () => {
+    if (!active2) return;
+    active2 = false;
+    listeners.delete(listener);
+    if (listeners.size === 0 && state.subscriptions.get(element) === listeners) {
+      state.subscriptions.delete(element);
     }
-    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);
+    if (state.subscriptions.size === 0 && prefetchScopeObservers.get(ownerDocument) === state) {
+      state.observer.disconnect();
+      prefetchScopeObservers.delete(ownerDocument);
     }
+  };
+}
+function isHashOnlyNavigationToPath(anchor, pathname) {
+  return pathname === window.location.pathname && anchor.search === window.location.search && !!anchor.hash;
+}
+function isHashOnlyNavigation(anchor) {
+  return isHashOnlyNavigationToPath(anchor, anchor.pathname);
+}
+function isPrefetchScopeDisabled(element) {
+  return typeof element.closest === "function" && element.closest(PREFETCH_SCOPE_OPT_OUT_SELECTOR) !== null;
+}
+
+// src/browser/react/location-state.ts
+import { useState as useState14, useEffect as useEffect14, useRef as useRef12 } 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;
 }
-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) {
@@ -9105,15 +9140,36 @@ var ALL_USE_ITEM_TYPES = new Set(
 );
 
 // src/server/request-context.ts
-import { AsyncLocalStorage as AsyncLocalStorage3 } from "node:async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage5 } from "node:async_hooks";
 init_cookie_name();
 
+// src/server/handle-store.ts
+var LOADER_SLOT = Object.freeze({ loader: true });
+
+// src/cache/cache-tag.ts
+import { AsyncLocalStorage as AsyncLocalStorage3 } from "node:async_hooks";
+var cacheTagStorage = new AsyncLocalStorage3();
+var segmentOwnerStorage = new AsyncLocalStorage3();
+var recordedTagCapture = globalThis[/* @__PURE__ */ Symbol.for("rangojs-router:recorded-tag-capture")] ??= new AsyncLocalStorage3();
+var identityReads = globalThis[/* @__PURE__ */ Symbol.for("rangojs-router:identity-reads")] ??= /* @__PURE__ */ new WeakMap();
+function activeTagSet() {
+  const capture = recordedTagCapture.getStore();
+  const body = getLoaderBodyTags();
+  if (capture && capture.outer === body) return capture.into;
+  return body ?? capture?.into;
+}
+globalThis[/* @__PURE__ */ Symbol.for("rangojs-router:identity-read-recorder")] = (surface, verb) => {
+  const set = activeTagSet();
+  if (set === void 0 || identityReads.has(set)) return;
+  identityReads.set(set, { surface, verb, bodyId: getCurrentLoaderBodyId() });
+};
+
 // src/router/router-context.ts
-import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
-var routerContext = new AsyncLocalStorage2();
+import { AsyncLocalStorage as AsyncLocalStorage4 } from "async_hooks";
+var routerContext = new AsyncLocalStorage4();
 
 // src/server/request-context.ts
-var requestContextStorage = new AsyncLocalStorage3();
+var requestContextStorage = new AsyncLocalStorage5();
 
 // src/route-definition/redirect.ts
 init_redirect_origin();
@@ -9307,7 +9363,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 {
@@ -9396,7 +9452,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(", ")
@@ -9478,21 +9534,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)
   );
@@ -9508,7 +9564,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"
@@ -9527,17 +9583,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"
@@ -9562,7 +9618,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;
@@ -9640,12 +9696,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);
@@ -9654,7 +9710,7 @@ async function discoverRouters(state, rscEnv, ssrEnv) {
       }
     }
   }
-  debug12?.(
+  debug11?.(
     "inner: trie build done (%sms)",
     (performance.now() - trieStart).toFixed(1)
   );
@@ -9689,13 +9745,15 @@ 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;
   const candidates = s.shellCandidates;
   const startTotal = performance.now();
   console.log(`[rango] Shell-prerendering ${candidates.length} URL(s)...`);
+  const keepAlive = setInterval(() => {
+  }, 6e4);
   let restoreClientRequire;
   try {
     const rscEnv = tempServer.environments?.rsc;
@@ -9745,7 +9803,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"
     );
@@ -9832,7 +9890,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)");
@@ -9903,6 +9961,7 @@ async function runShellPrerenderPhase(s, builder) {
   } finally {
     delete globalThis.__loadPrerenderManifestModule;
     restoreClientRequire?.();
+    clearInterval(keepAlive);
   }
 }
 function writeShellManifest(s, rscOutDir, staged) {
@@ -10414,7 +10473,7 @@ function postprocessBundle(state) {
 }
 
 // src/vite/discovery/gate-state.ts
-function createDiscoveryGate(s, debug14) {
+function createDiscoveryGate(s, debug13) {
   let gatePending = false;
   let gateResolver = () => {
   };
@@ -10431,7 +10490,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,
@@ -10440,7 +10499,7 @@ function createDiscoveryGate(s, debug14) {
       return;
     }
     gatePending = false;
-    debug14?.("hmr: discoveryDone resolved");
+    debug13?.("hmr: discoveryDone resolved");
     gateResolver();
   };
   const noteRouteEvent = () => {
@@ -10450,7 +10509,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;
@@ -10461,16 +10520,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 {
@@ -10572,7 +10631,16 @@ async function createTempRscServer(state, options = {}) {
   return createViteServer({
     root: state.projectRoot,
     configFile: false,
-    server: { middlewareMode: true },
+    server: {
+      middlewareMode: true,
+      // Build mode: no file watching. buildStart installs the per-router tries
+      // into this realm and runShellPrerenderPhase reuses it after the bundles
+      // are written. A watched write in between (writeRouteTypesFiles' own
+      // <router>.named-routes.gen.ts, which every router file imports) can
+      // make Vite full-reload the RSC runner; the shell phase then matches in
+      // a fresh realm with no tries and a root path("/*") wins (#947).
+      ...options.forceBuild ? { watch: null } : {}
+    },
     appType: "custom",
     logLevel: "silent",
     resolve: resolveConfig,
@@ -12437,7 +12505,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());
@@ -12481,7 +12553,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})`, {
@@ -12514,7 +12586,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 }
@@ -12527,7 +12599,7 @@ function poke() {
         );
       }
       const onData = (data) => {
-        if (debug14) {
+        if (debug13) {
           server.config.logger.info(`  poke stdin ${formatChunk(data)}`, {
             timestamp: true
           });