@rsc-kit/core 0.22.4 → 0.22.6

package/dist/js/SegmentBoundary.js

@@ -44,8 +44,22 @@ const addTransitionType = React.addTransitionType ??
     React
         .unstable_addTransitionType;
 import { RedirectBoundary } from "./RedirectBoundary";
+import { retentionKey } from "../routing";
 import { navigationCommitted } from "./perf";
 import { getSegmentState, replaceActive, navigatedOnce, seedSegment, subscribeToSegment, } from "./segmentStore";
+/**
+ * The key the page this document arrived with is filed under: the url's,
+ * query included, when the url is that page - which is always, in an app,
+ * because the server keys a page by the document's own pathname. Anything
+ * else keeps the server's key rather than guess.
+ */
+function seedKey(pageKey) {
+    if (typeof window === "undefined")
+        return pageKey;
+    return retentionKey(window.location.pathname, null) === retentionKey(pageKey, null)
+        ? retentionKey(window.location.pathname + window.location.search, null)
+        : pageKey;
+}
 export function SegmentBoundary({ depth, pageKey, children, }) {
     // The store still addresses the boundary; the render reads React state, so
     // the update can be a transition. Initialised from the store on the client
@@ -76,8 +90,13 @@ export function SegmentBoundary({ depth, pageKey, children, }) {
     useEffect(() => {
         if (getSegmentState(depth))
             replaceActive(depth, children);
+        // Filed under the url's key, path and query, which is what every
+        // navigation and refresh looks it up by; mounted under the server's, the
+        // pathname the shell was frozen with. Seeded under the server's alone,
+        // the first refresh of a page loaded at ?c=25 found nothing, mounted a
+        // second copy, and showed every fallback in it.
         else if (pageKey)
-            seedSegment(depth, pageKey, children);
+            seedSegment(depth, seedKey(pageKey), children, pageKey);
     }, [depth, pageKey, children]);
     // Wrapped here rather than around the whole app because this is the closest
     // client component above a page: a redirect thrown inside the page's own
@@ -109,6 +128,6 @@ export function SegmentBoundary({ depth, pageKey, children, }) {
     if (!state) {
         return (_jsx(Activity, { mode: "visible", children: _jsx(RedirectBoundary, { children: children }) }, pageKey));
     }
-    return (_jsx(_Fragment, { children: state.entries.map((entry) => (_jsx(Activity, { mode: entry.key === state.activeKey ? "visible" : "hidden", children: _jsx(RedirectBoundary, { active: entry.key === state.activeKey, children: entry.tree }) }, entry.key))) }));
+    return (_jsx(_Fragment, { children: state.entries.map((entry) => (_jsx(Activity, { mode: entry.key === state.activeKey ? "visible" : "hidden", children: _jsx(RedirectBoundary, { active: entry.key === state.activeKey, children: entry.tree }) }, entry.identity ?? entry.key))) }));
 }
 //# sourceMappingURL=SegmentBoundary.js.map

package/dist/js/SegmentBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentBoundary.js","sourceRoot":"","sources":["../../src/js/SegmentBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * The point in the tree a navigation can replace on its own.\n *\n * Sits between a layout and its children, so showing a different segment\n * re-renders from here down and leaves the layouts above it mounted. Server\n * components cannot be re-rendered on the client, which is why the seam has to\n * be a client component reading from a store rather than the layout itself.\n *\n * Pages it has already shown stay mounted behind <Activity mode=\"hidden\">.\n * Hidden is not unmounted: effects are torn down but state survives, so\n * returning to a page brings back the form you were filling in. Rendering only\n * the current one would throw that away, which is what replacing the root did.\n */\n\nimport * as React from \"react\";\nimport { Activity, startTransition, useEffect, useState } from \"react\";\n\n/**\n * The transition type a navigation carries.\n *\n * The engine does not animate a navigation itself; React's own\n * <ViewTransition> does, wherever an app puts one. What the app cannot do\n * from outside is tell a navigation from the seed after hydration - the\n * boundary taking over its own server-rendered children, which animated\n * would be the page fading into itself on every load. So a navigation's\n * update carries this type, and the seed's does not: a boundary keyed on it,\n * `default={{ \"rsc-navigation\": \"page\", default: \"none\" }}`, animates\n * navigations and nothing else.\n *\n * An earlier shape wrapped the segment in a boundary of the engine's own,\n * behind a flag. React names every top-level element under a boundary and\n * morphs each from where it was to where it is, so the stylesheet pulled\n * them back into one root fade - and fought React over the root, which it\n * cancels when nothing outside a boundary changed: a captured root with a\n * hidden group, a dark viewport on the first navigation. One wrapper element\n * under the app's own boundary is one snapshot pair, which is the dissolve\n * wanted, with nothing to fight.\n */\nexport const NAVIGATION_TRANSITION_TYPE = \"rsc-navigation\";\n\n// Exported by React 19.3; `unstable_` before it. Read at call time from the\n// namespace rather than imported by name, so a React that lacks it still\n// loads this module and simply does not mark the type.\nconst addTransitionType: ((type: string) => void) | undefined =\n  (React as { addTransitionType?: (type: string) => void }).addTransitionType ??\n  (React as { unstable_addTransitionType?: (type: string) => void })\n    .unstable_addTransitionType;\nimport type { ReactNode } from \"react\";\nimport { RedirectBoundary } from \"./RedirectBoundary\";\nimport { navigationCommitted } from \"./perf\";\nimport {\n  getSegmentState,\n  replaceActive,\n  navigatedOnce,\n  seedSegment,\n  subscribeToSegment,\n} from \"./segmentStore\";\n\nexport function SegmentBoundary({\n  depth,\n  pageKey,\n  children,\n}: {\n  depth: number;\n  /** The page these server-rendered children belong to. */\n  pageKey?: string;\n  children: ReactNode;\n}) {\n  // The store still addresses the boundary; the render reads React state, so\n  // the update can be a transition. Initialised from the store on the client\n  // and null on the server — exactly what getServerSnapshot did.\n  const [state, setState] = useState<ReturnType<typeof getSegmentState>>(() =>\n    typeof window === \"undefined\" ? null : getSegmentState(depth),\n  );\n\n  useEffect(\n    () =>\n      subscribeToSegment(depth, () => {\n        startTransition(() => {\n          // A navigation, not the seed: the seed is the page taking over\n          // its own server-rendered children, and fading that is the page\n          // fading into itself.\n          if (navigatedOnce()) addTransitionType?.(NAVIGATION_TRANSITION_TYPE);\n\n          setState(getSegmentState(depth));\n        });\n      }),\n    [depth],\n  );\n\n  // The commit that put a navigated segment on screen: the end of the\n  // navigation's measure, see perf.ts. Not on the first render, which is the\n  // seed.\n  useEffect(() => {\n    if (state !== null) navigationCommitted();\n  }, [state]);\n\n  // Record the page we arrived on, so a later navigation away and back can\n  // return to it. Without this the first page is the one page you cannot keep.\n  // New children while the store already holds this depth is the document\n  // rendered again in place - revalidate(\"all\") - and the page on screen\n  // takes them under the key it has; see replaceActive.\n  useEffect(() => {\n    if (getSegmentState(depth)) replaceActive(depth, children);\n    else if (pageKey) seedSegment(depth, pageKey, children);\n  }, [depth, pageKey, children]);\n\n  // Wrapped here rather than around the whole app because this is the closest\n  // client component above a page: a redirect thrown inside the page's own\n  // Suspense boundary surfaces at the nearest error boundary, and catching it\n  // here leaves the layouts above mounted while the navigation runs. One\n  // boundary per page, inside its Activity, not one around them all: a\n  // boundary that catches renders its fallback in place of everything it\n  // wraps, and one around them all unmounted every page being kept alive\n  // behind the one redirecting - the destination among them, when it was\n  // held - and then kept showing the fallback over the destination once it\n  // arrived. The port's report was a sidebar and a breadcrumb over an empty\n  // main.\n  // The same shape before and after the seed. The server's render and the\n  // first client render already place the children inside the retention\n  // wrapper, keyed by the page, so when the store takes over after hydration\n  // the tree changes state but not shape - and React keeps the DOM instead of\n  // remounting the page, which was blank, then content, on every load.\n  //\n  // The Activity is there whether or not there is a page key to hang it on.\n  // A parameterised route's PPR shell is rendered for every url it matches\n  // and so carries no key - and the boundary used to leave the Activity out\n  // then, so the shell had no <!--&--> markers where the client, hydrating\n  // from the payload for the real url, rendered one. React 19.2 does not\n  // recover from a hydration mismatch at an Activity: the boundary retries\n  // hydrating, mismatches again, and the main thread never returns. A port\n  // found /agent/tools/3 freezing the tab on every document load. The\n  // markup of an Activity does not depend on its key, so the shell and the\n  // client agree whenever both render one.\n  if (!state) {\n    return (\n      <Activity key={pageKey} mode=\"visible\">\n        <RedirectBoundary>{children}</RedirectBoundary>\n      </Activity>\n    );\n  }\n\n  return (\n    <>\n      {state.entries.map((entry) => (\n        <Activity\n          key={entry.key}\n          mode={entry.key === state.activeKey ? \"visible\" : \"hidden\"}\n        >\n          <RedirectBoundary active={entry.key === state.activeKey}>\n            {entry.tree as ReactNode}\n          </RedirectBoundary>\n        </Activity>\n      ))}\n    </>\n  );\n}\n"]}
+{"version":3,"file":"SegmentBoundary.js","sourceRoot":"","sources":["../../src/js/SegmentBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * The point in the tree a navigation can replace on its own.\n *\n * Sits between a layout and its children, so showing a different segment\n * re-renders from here down and leaves the layouts above it mounted. Server\n * components cannot be re-rendered on the client, which is why the seam has to\n * be a client component reading from a store rather than the layout itself.\n *\n * Pages it has already shown stay mounted behind <Activity mode=\"hidden\">.\n * Hidden is not unmounted: effects are torn down but state survives, so\n * returning to a page brings back the form you were filling in. Rendering only\n * the current one would throw that away, which is what replacing the root did.\n */\n\nimport * as React from \"react\";\nimport { Activity, startTransition, useEffect, useState } from \"react\";\n\n/**\n * The transition type a navigation carries.\n *\n * The engine does not animate a navigation itself; React's own\n * <ViewTransition> does, wherever an app puts one. What the app cannot do\n * from outside is tell a navigation from the seed after hydration - the\n * boundary taking over its own server-rendered children, which animated\n * would be the page fading into itself on every load. So a navigation's\n * update carries this type, and the seed's does not: a boundary keyed on it,\n * `default={{ \"rsc-navigation\": \"page\", default: \"none\" }}`, animates\n * navigations and nothing else.\n *\n * An earlier shape wrapped the segment in a boundary of the engine's own,\n * behind a flag. React names every top-level element under a boundary and\n * morphs each from where it was to where it is, so the stylesheet pulled\n * them back into one root fade - and fought React over the root, which it\n * cancels when nothing outside a boundary changed: a captured root with a\n * hidden group, a dark viewport on the first navigation. One wrapper element\n * under the app's own boundary is one snapshot pair, which is the dissolve\n * wanted, with nothing to fight.\n */\nexport const NAVIGATION_TRANSITION_TYPE = \"rsc-navigation\";\n\n// Exported by React 19.3; `unstable_` before it. Read at call time from the\n// namespace rather than imported by name, so a React that lacks it still\n// loads this module and simply does not mark the type.\nconst addTransitionType: ((type: string) => void) | undefined =\n  (React as { addTransitionType?: (type: string) => void }).addTransitionType ??\n  (React as { unstable_addTransitionType?: (type: string) => void })\n    .unstable_addTransitionType;\nimport type { ReactNode } from \"react\";\nimport { RedirectBoundary } from \"./RedirectBoundary\";\nimport { retentionKey } from \"../routing\";\nimport { navigationCommitted } from \"./perf\";\nimport {\n  getSegmentState,\n  replaceActive,\n  navigatedOnce,\n  seedSegment,\n  subscribeToSegment,\n} from \"./segmentStore\";\n\n/**\n * The key the page this document arrived with is filed under: the url's,\n * query included, when the url is that page - which is always, in an app,\n * because the server keys a page by the document's own pathname. Anything\n * else keeps the server's key rather than guess.\n */\nfunction seedKey(pageKey: string): string {\n  if (typeof window === \"undefined\") return pageKey;\n\n  return retentionKey(window.location.pathname, null) === retentionKey(pageKey, null)\n    ? retentionKey(window.location.pathname + window.location.search, null)\n    : pageKey;\n}\n\nexport function SegmentBoundary({\n  depth,\n  pageKey,\n  children,\n}: {\n  depth: number;\n  /** The page these server-rendered children belong to. */\n  pageKey?: string;\n  children: ReactNode;\n}) {\n  // The store still addresses the boundary; the render reads React state, so\n  // the update can be a transition. Initialised from the store on the client\n  // and null on the server — exactly what getServerSnapshot did.\n  const [state, setState] = useState<ReturnType<typeof getSegmentState>>(() =>\n    typeof window === \"undefined\" ? null : getSegmentState(depth),\n  );\n\n  useEffect(\n    () =>\n      subscribeToSegment(depth, () => {\n        startTransition(() => {\n          // A navigation, not the seed: the seed is the page taking over\n          // its own server-rendered children, and fading that is the page\n          // fading into itself.\n          if (navigatedOnce()) addTransitionType?.(NAVIGATION_TRANSITION_TYPE);\n\n          setState(getSegmentState(depth));\n        });\n      }),\n    [depth],\n  );\n\n  // The commit that put a navigated segment on screen: the end of the\n  // navigation's measure, see perf.ts. Not on the first render, which is the\n  // seed.\n  useEffect(() => {\n    if (state !== null) navigationCommitted();\n  }, [state]);\n\n  // Record the page we arrived on, so a later navigation away and back can\n  // return to it. Without this the first page is the one page you cannot keep.\n  // New children while the store already holds this depth is the document\n  // rendered again in place - revalidate(\"all\") - and the page on screen\n  // takes them under the key it has; see replaceActive.\n  useEffect(() => {\n    if (getSegmentState(depth)) replaceActive(depth, children);\n    // Filed under the url's key, path and query, which is what every\n    // navigation and refresh looks it up by; mounted under the server's, the\n    // pathname the shell was frozen with. Seeded under the server's alone,\n    // the first refresh of a page loaded at ?c=25 found nothing, mounted a\n    // second copy, and showed every fallback in it.\n    else if (pageKey) seedSegment(depth, seedKey(pageKey), children, pageKey);\n  }, [depth, pageKey, children]);\n\n  // Wrapped here rather than around the whole app because this is the closest\n  // client component above a page: a redirect thrown inside the page's own\n  // Suspense boundary surfaces at the nearest error boundary, and catching it\n  // here leaves the layouts above mounted while the navigation runs. One\n  // boundary per page, inside its Activity, not one around them all: a\n  // boundary that catches renders its fallback in place of everything it\n  // wraps, and one around them all unmounted every page being kept alive\n  // behind the one redirecting - the destination among them, when it was\n  // held - and then kept showing the fallback over the destination once it\n  // arrived. The port's report was a sidebar and a breadcrumb over an empty\n  // main.\n  // The same shape before and after the seed. The server's render and the\n  // first client render already place the children inside the retention\n  // wrapper, keyed by the page, so when the store takes over after hydration\n  // the tree changes state but not shape - and React keeps the DOM instead of\n  // remounting the page, which was blank, then content, on every load.\n  //\n  // The Activity is there whether or not there is a page key to hang it on.\n  // A parameterised route's PPR shell is rendered for every url it matches\n  // and so carries no key - and the boundary used to leave the Activity out\n  // then, so the shell had no <!--&--> markers where the client, hydrating\n  // from the payload for the real url, rendered one. React 19.2 does not\n  // recover from a hydration mismatch at an Activity: the boundary retries\n  // hydrating, mismatches again, and the main thread never returns. A port\n  // found /agent/tools/3 freezing the tab on every document load. The\n  // markup of an Activity does not depend on its key, so the shell and the\n  // client agree whenever both render one.\n  if (!state) {\n    return (\n      <Activity key={pageKey} mode=\"visible\">\n        <RedirectBoundary>{children}</RedirectBoundary>\n      </Activity>\n    );\n  }\n\n  return (\n    <>\n      {state.entries.map((entry) => (\n        <Activity\n          key={entry.identity ?? entry.key}\n          mode={entry.key === state.activeKey ? \"visible\" : \"hidden\"}\n        >\n          <RedirectBoundary active={entry.key === state.activeKey}>\n            {entry.tree as ReactNode}\n          </RedirectBoundary>\n        </Activity>\n      ))}\n    </>\n  );\n}\n"]}

package/dist/js/createViteRscApp.js

@@ -327,12 +327,12 @@ export async function createViteRscApp(container = document, interceptEntries =
     // Depth 0 is a whole document and replaces the root. Anything deeper is one
     // segment: handing it to the boundary at that depth leaves the layouts above
     // it mounted, which is the point of asking for a partial render at all.
-    setNavigateHandler((tree, key, segmentDepth) => {
+    setNavigateHandler((tree, key, segmentDepth, inPlaceOf) => {
         const newTree = tree;
         // From here on the boundary animates; the seed commit before this did not.
         noteNavigation();
         if (segmentDepth > 0) {
-            setSegment(segmentDepth, key, newTree);
+            setSegment(segmentDepth, key, newTree, inPlaceOf);
             return;
         }
         clearSegments();

package/dist/js/createViteRscApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"createViteRscApp.js","sourceRoot":"","sources":["../../src/js/createViteRscApp.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite-engine client bootstrap. Uses @vitejs/plugin-rsc's browser runtime as\n// the Flight deserializer + action encoder, and drives the package's engine-agnostic\n// navigate.ts SPA engine (Link, prefetch, popstate) through it. This replaces\n// the bun engine's createRscApp + the hand-rolled webpack shim — the plugin\n// resolves client references itself.\nimport { SEARCH_PARAMS_FALLBACK } from \"./useSearchParams\";\nimport { recoverFromStaleAssets } from \"./staleAssets\";\nimport { afterHydration, replayEarlyClicks } from \"./earlyClicks\";\nimport { parseRedirectDigest } from \"../redirectDigest.js\";\nimport { showDevNotice } from \"./devNotice\";\nimport { caughtByLoading } from \"./fallbackReport\";\nimport { noteNavigation } from \"./segmentStore\";\nimport type { Route } from \"../routes.js\";\nimport { isSafeRedirect } from \"../safeUrl.js\";\nimport {\n  createFromReadableStream,\n  encodeReply,\n  setServerCallback,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { createElement, startTransition } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { activityMarkersIn } from \"./activityMarkers\";\nimport { ActivityRoot } from \"./ActivityRouter\";\nimport { ServerRedirectError, noteRedirected, throwForFailedAction } from \"./errors\";\nimport { fetchPagePayload } from \"./pagePayload\";\nimport { claimRead, setQueryCodec } from \"./queryClient\";\nimport { clearSegments, dropHidden, isHeld, prerenderSegment, restoreSegments, setSegment } from \"./segmentStore\";\nimport type { ReactNode } from \"react\";\nimport {\n  cancelPrefetch,\n  isPrefetched,\n  navigate,\n  setApiRoutes,\n  refresh,\n  applyRevalidations,\n  prefetch,\n  retentionKey,\n  setCallServer,\n  setHeldLayouts,\n  setStaticPayloads,\n  setStaticRoutes,\n  seedStaticChain,\n  payloadUrl,\n  setDeserializer,\n  setInterceptManifest,\n  getHeldLayouts,\n  setNavigateHandler,\n  setHeldHandlers,\n  setPrerenderHandler,\n  setReplaceRootHandler,\n  setRestoreHandler,\n  setVersion,\n} from \"./navigate\";\n\n\n/**\n * A redirect that travelled as an error: the digest of the error itself, or\n * of the cause React wraps it in when it reports client-rendering a boundary\n * the server had already failed.\n */\nfunction isRedirect(error: unknown): boolean {\n  const digest = (error as { digest?: unknown } | null)?.digest;\n  const cause = (error as { cause?: { digest?: unknown } } | null)?.cause;\n\n  return parseRedirectDigest(digest) !== null || parseRedirectDigest(cause?.digest) !== null;\n}\n\nexport async function createViteRscApp(\n  container: Document | Element = document,\n  interceptEntries: { urlPattern: string; slot: string }[] = [],\n  options: { staticPayloads?: string | null; routes?: unknown[] | null; apiRoutes?: string[] } = {},\n): Promise<void> {\n  // The urls a route.ts answers: a link to one is an anchor, never a\n  // prefetch, never a payload fetch.\n  if (options.apiRoutes) setApiRoutes(options.apiRoutes);\n  // An exported build has no server to negotiate with, so payloads live at\n  // their own urls rather than behind a header on the page's url.\n  setStaticPayloads(options.staticPayloads ?? null);\n  // Only an exported build ships this: with no server to negotiate with, the\n  // client works out for itself how much of a page it still holds.\n  if (options.routes) setStaticRoutes(options.routes as never);\n  // The router has to recognise an intercepted link before it asks the server,\n  // so the patterns are baked into the generated browser entry. Without them\n  // every intercepted route falls through to a full-page navigation.\n  setInterceptManifest(interceptEntries);\n\n  async function callServer(id: string, args: unknown[]): Promise<unknown> {\n    // A read opened a slot before calling the reference, and this is the first\n    // point at which the id exists on the client — React keeps it private and\n    // hands it over only here. Claiming the slot enqueues the read for the\n    // batched GET instead of posting it.\n    const read = claimRead(id, args);\n\n    if (read) return await read;\n\n    const encoded = await encodeReply(args);\n\n    // encodeReply returns FormData as soon as an argument contains a File.\n    // Sending that as multipart would make PHP consume php://input while\n    // parsing it, leaving the action with an empty body — so serialize it to\n    // raw bytes under an opaque content-type and send the real one in\n    // X-RSC-Content-Type for the worker to rebuild FormData from.\n    let body: BodyInit;\n    let realContentType: string;\n\n    if (encoded instanceof FormData) {\n      const serialized = new Response(encoded);\n      body = await serialized.arrayBuffer();\n      realContentType =\n        serialized.headers.get(\"content-type\") ?? \"multipart/form-data\";\n    } else {\n      body = encoded as BodyInit;\n      realContentType = \"text/plain;charset=UTF-8\";\n    }\n\n    // Where the action was invoked from. The host resolves it to the\n    // components that render the page, so anything the action says it\n    // invalidated can come back with the answer instead of being fetched\n    // afterwards - and what comes back is for this page, not whichever is\n    // showing when it lands.\n    const from = window.location.pathname + window.location.search;\n\n    const res = await fetch(\"/_rsc/action\", {\n      method: \"POST\",\n      headers: {\n        \"X-RSC-Action\": id,\n        \"X-RSC-Referer\": from,\n        \"X-RSC-Content-Type\": realContentType,\n        \"Content-Type\": \"application/octet-stream\",\n        \"X-XSRF-TOKEN\": decodeURIComponent(\n          document.cookie.match(/XSRF-TOKEN=([^;]+)/)?.[1] ?? \"\",\n        ),\n      },\n      body,\n    });\n\n    // A failed action does not answer with a Flight stream, and the decoder\n    // cannot tell — it reports its own parse failure instead of what the\n    // server said.\n    try {\n      await throwForFailedAction(res);\n    } catch (err) {\n      // A redirect is an instruction, not something for a form to display:\n      // an expired session answers this way, and the destination is the login\n      // page rather than a message about one.\n      if (err instanceof ServerRedirectError) {\n        // The destination came off a response header, so it is checked here\n        // too — the engine refuses these at the source, but a proxy or a host\n        // in front of it can write whatever it likes. A navigation, not a\n        // document load: the layouts stay mounted and the history entry the\n        // form was on is replaced, the way a redirect after a POST should\n        // be - Back does not return to the submitted form.\n        if (isSafeRedirect(err.location)) {\n          void navigate(err.location as Route, { replace: true });\n        }\n\n        // Performed, so resolved - not thrown. The call's answer is \"you are\n        // being taken somewhere\": an object saying so, the shape an action's\n        // result already has, so a caller reading result.validationErrors\n        // reads undefined rather than throwing. A caller that awaited the\n        // action in a plain startTransition had no catch for a throw, the\n        // rejection reached React, and the root unmounted to a white page\n        // on every logout.\n        noteRedirected(err.location);\n\n        return { redirected: err.location };\n      }\n\n      throw err;\n    }\n\n    const answer = await createFromReadableStream(res.body!, { callServer });\n\n    return unwrapRevalidated(answer, from);\n  }\n\n  /**\n   * Put anything the action re-rendered on screen, and hand back its result.\n   *\n   * The trees travel with the answer rather than being fetched afterwards, so\n   * the caller sees only what its action returned and never knows the page\n   * was updated around it.\n   */\n  function unwrapRevalidated(answer: unknown, from: string): unknown {\n    if (\n      answer === null ||\n      typeof answer !== \"object\" ||\n      !(\"__rscRevalidated\" in answer)\n    ) {\n      return answer;\n    }\n\n    const envelope = answer as {\n      __rscRevalidated: Record<string, unknown>;\n      result: unknown;\n    };\n\n    applyRevalidations(from, envelope.__rscRevalidated as Record<string, ReactNode>);\n\n    return envelope.result;\n  }\n\n  setDeserializer(createFromReadableStream as never);\n  // The query transport speaks Flight too, and reaches the runtime through here\n  // rather than importing it: a second import of the browser runtime from the\n  // client-component graph is a second client-reference registry, and the\n  // symptom is components that render as undefined with nothing logged.\n  setQueryCodec({\n    deserialize: (stream) =>\n      createFromReadableStream(stream, { callServer }) as Promise<unknown>,\n    encode: (args) => encodeReply(args) as Promise<string | FormData>,\n    // The way back when a read cannot ride in a url. Re-entering callServer is\n    // safe: the slot was cleared the moment the reference returned, so this\n    // takes the ordinary POST path rather than claiming a read again.\n    asAction: (id, args) => callServer(id, args),\n  });\n  setCallServer(callServer);\n  // The plugin's own \"use server\" client stubs route through its registered\n  // server callback — register the same transport there too.\n  setServerCallback(callServer as never);\n\n  // Link / Form / router live in a separate build graph and reach the SPA\n  // engine through these globals.\n  (window as unknown as { __rsc_navigate: typeof navigate }).__rsc_navigate =\n    navigate;\n  (window as unknown as { __rsc_prefetch: typeof prefetch }).__rsc_prefetch =\n    prefetch;\n  (\n    window as unknown as { __rsc_cancel_prefetch: typeof cancelPrefetch }\n  ).__rsc_cancel_prefetch = cancelPrefetch;\n  (\n    window as unknown as { __rsc_is_prefetched: typeof isPrefetched }\n  ).__rsc_is_prefetched = isPrefetched;\n  (window as unknown as { __rsc_refresh: typeof refresh }).__rsc_refresh =\n    refresh;\n\n  // Hydrate from the RSC endpoint (same url + X-RSC, no version header).\n  //\n  // Everything from here to the decode is failure handling, because this is\n  // the one request with nothing watching it. A page whose shell is already\n  // rendered looks fine while this fails, and its fallbacks stay on screen\n  // indefinitely with nothing reported anywhere.\n  const res = await fetchPagePayload(payloadUrl(window.location.href));\n\n  // Seed the router with the build this DOCUMENT is, so a redeploy is caught\n  // on the next navigation: the host answers 409 to a client of another\n  // build, and the document is loaded again. From the document's own meta\n  // first - a document a service worker served from its cache is the last\n  // build's, while the payload just fetched is this one's, and seeding from\n  // the payload would have the old client claim to be new. The header is\n  // the fallback for a document with no meta.\n  const documentBuild = document.querySelector('meta[name=\"rsc-kit:build\"]')?.getAttribute(\"content\");\n  const servedVersion = documentBuild || res.headers.get(\"X-RSC-Version\");\n\n  if (servedVersion) {\n    setVersion(servedVersion);\n  }\n\n  // The chain this page is built from, so the next navigation can say what is\n  // already mounted and be sent only what changed.\n  // A server says what this page is built from; a file server says nothing,\n  // so an exported build works it out from the table it was given.\n  const servedLayouts = res.headers.get(\"X-RSC-Layouts\");\n\n  if (servedLayouts !== null) {\n    setHeldLayouts(servedLayouts.split(\",\"));\n  } else if (!seedStaticChain(window.location.href)) {\n    setHeldLayouts([]);\n  }\n  const tree = await createFromReadableStream(res.body!, { callServer });\n\n  // Retaining the previous page behind <Activity> needs a wrapper above the\n  // page, and React will not hydrate a *document* container through one: the\n  // root child of a document has to be <html>, and wrapping it hangs the\n  // renderer outright (React 19.2.7). An app whose root layout owns <html>\n  // therefore hydrates the tree directly and navigations replace it, as before.\n  //\n  // Apps that hydrate into an element get retention. Giving it to document-\n  // rooted apps means SPA navigation returning only the changed segment rather\n  // than a whole document, which is an engine change, not a client one.\n  const retains = container !== document;\n\n  const shell = retains\n    ? createElement(ActivityRoot, {\n        initialKey: retentionKey(window.location.href, null),\n        initialTree: tree as ReactNode,\n      })\n    : (tree as ReactNode);\n\n  // A document that cannot be hydrated by this tree is client-rendered\n  // instead - a repaint, not a freeze. React 19.2 does not recover from a\n  // hydration mismatch at an <Activity>: it retries hydrating the boundary,\n  // mismatches again, and never returns to the main thread. Every segment\n  // boundary is an Activity, one per layout, so a document with none where\n  // the page has layouts is that mismatch, guaranteed, before React starts.\n  // What produced one: a parameterised route's PPR shell, rendered without\n  // a page key and, by a build before this one, without the Activities too.\n  // None rather than fewer: a boundary inside a Suspense hole the shell left\n  // unfinished has no marker and is client-rendered by React on its own,\n  // which is not a mismatch. The stale-asset reload does not apply - the\n  // document would come back the same.\n  const missing = retains && getHeldLayouts().length > 0 && activityMarkersIn(container) === 0;\n\n  if (missing) {\n    console.warn(\n      \"[rsc-kit] The document has no <Activity> boundaries where the page has layouts, so it cannot be hydrated; rendering the page instead. A PPR shell built by an earlier release lacks them - rebuild.\",\n    );\n  }\n\n  // The payload answered with an error status - the not-found page for a\n  // url the shell was served for anyway. It is not the document on screen,\n  // so it is rendered, not hydrated: a mismatch at an Activity is the loop\n  // above, and this one is certain.\n  const disagrees = !res.ok;\n\n  const onRecoverableError = (error: unknown, errorInfo: unknown) => {\n      // A client component whose chunk the server no longer has fails while\n      // hydrating, and React reports that as recoverable: the page is loaded\n      // again, with the current names.\n      if (recoverFromStaleAssets(error)) return;\n\n      // A redirect decided inside a boundary: the server's row carried it as\n      // the digest, React client-renders the boundary and reports that it\n      // did, and the RedirectBoundary is already performing it. Nothing to\n      // read in the console about a page doing what it was told.\n      if (isRedirect(error)) return;\n\n      // A PPR shell is served with its Suspense boundaries deliberately\n      // unfinished — the build aborts the render once the static part is out.\n      // React reports that as #419 and client-renders the boundary from the\n      // Flight payload, which is the intended path, not a fault to report.\n      const message = String((error as { message?: string })?.message ?? error);\n\n      if (\n        message.includes(\"419\") ||\n        message.includes(\"did not finish this Suspense boundary\")\n      ) {\n        return;\n      }\n\n      // A view transition the browser cancelled because the tab was not\n      // visible. React reports it here; the update still landed, and a tab\n      // in the background is not a fault in the page.\n      if (message.includes(\"Transition was aborted\")) return;\n\n      // A navigation another one overtook: its request was aborted, and a\n      // row of its payload that a component was still reading rejects with\n      // the abort. React recovers by rendering the root again synchronously\n      // and reports the recovery here as #520, with the abort as the cause.\n      // The page it recovered to is the one the second navigation asked for;\n      // the abort was the design, not a fault.\n      const cause = (error as { cause?: { name?: string; message?: string } } | null)?.cause;\n\n      if (\n        cause?.name === \"AbortError\" ||\n        /\\baborted\\b/i.test(cause?.message ?? \"\") ||\n        /\\baborted\\b/i.test(message)\n      ) {\n        return;\n      }\n      // A page whose query string was read under a boundary carries the\n      // fallback there; React reports the recovery on hydration. Under a\n      // boundary the developer wrote, that is the designed path and nothing\n      // is said. With nothing closer than a loading.tsx, the whole segment\n      // showed the fallback until the query arrived - said here, in the\n      // page and the console, for whoever is looking at either. Production\n      // has no stack to tell the two apart; the build's note on the route is\n      // the record there.\n      if (\n        (error as { digest?: string })?.digest === SEARCH_PARAMS_FALLBACK ||\n        message.includes(\"useSearchParams()\")\n      ) {\n        const stack = (errorInfo as { componentStack?: string } | null)\n          ?.componentStack;\n\n        if (!caughtByLoading(stack)) return;\n\n        const hint =\n          \"useSearchParams() was read on the server with nothing closer than a loading.tsx, so the \" +\n          \"whole segment showed that fallback until the query arrived. A <Suspense> around the \" +\n          \"component that reads keeps the rest of the page painted.\";\n\n        showDevNotice(hint, stack);\n        console.error(new Error(hint), errorInfo);\n\n        return;\n      }\n\n      console.error(error, errorInfo);\n  };\n\n  const rootOptions = {\n    onRecoverableError,\n    // A chunk the deploy no longer serves is not a fault in the page; the\n    // document is loaded again, and the new names come with it. Anything\n    // else is reported the way React would have.\n    onUncaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n\n      console.error(error, errorInfo);\n    },\n    onCaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n      // Caught by the RedirectBoundary, which is performing it.\n      if (isRedirect(error)) return;\n\n      console.error(error, errorInfo);\n    },\n  };\n\n  const root = missing || disagrees\n    ? (() => {\n        const created = createRoot(container as Element, rootOptions);\n\n        created.render(shell);\n\n        return created;\n      })()\n    : hydrateRoot(container, shell, rootOptions);\n\n  // Depth 0 is a whole document and replaces the root. Anything deeper is one\n  // segment: handing it to the boundary at that depth leaves the layouts above\n  // it mounted, which is the point of asking for a partial render at all.\n  setNavigateHandler((tree: unknown, key: string, segmentDepth: number) => {\n    const newTree = tree as ReactNode;\n\n    // From here on the boundary animates; the seed commit before this did not.\n    noteNavigation();\n\n    if (segmentDepth > 0) {\n      setSegment(segmentDepth, key, newTree);\n\n      return;\n    }\n\n    clearSegments();\n    root.render(newTree);\n  });\n\n  // The whole document again, in place - revalidate(\"all\"). Not through the\n  // handler above: that clears the boundaries and renders the tree as a new\n  // page, and a boundary emptied re-keys its Activity to the current url and\n  // remounts everything under it. A port's \"added to cart\" went with the\n  // form's state that way, on every product reached by a link. Here the root\n  // takes the tree in a transition and each boundary hands its page the new\n  // children under the key it has - see replaceActive.\n  setReplaceRootHandler((tree: unknown) => {\n    startTransition(() => root.render(tree as ReactNode));\n  });\n\n  // Back and forward reveal a page the boundaries are still holding, with the\n  // form you were filling in still filled in, and without asking the server.\n  setRestoreHandler((key: string, maxAge?: number) =>\n    restoreSegments(key, maxAge),\n  );\n  setHeldHandlers(isHeld, dropHidden);\n\n  // A touch or a settled hover: the page is rendered hidden now, and the\n  // click reveals it. See warm() in navigate.ts and prerenderSegment.\n  setPrerenderHandler((tree: unknown, key: string, segmentDepth: number) => {\n    prerenderSegment(segmentDepth, key, tree as ReactNode);\n  });\n\n  window.addEventListener(\"popstate\", () => {\n    // restore: back and forward reveal the page you were on, with its state.\n    // Wherever the browser just went; not a literal this app wrote.\n    navigate(window.location.href as Route, { replace: true, restore: true });\n  });\n\n  history.replaceState(\n    { rscUrl: window.location.href },\n    \"\",\n    window.location.href,\n  );\n\n  // A tap held by the bootstrap script, navigated to once hydration has\n  // committed - not now: the runtime's script running is seconds before\n  // React can dispatch a click on a phone still downloading chunks, and\n  // a tap in that window would be the browser's. See earlyClicks.ts.\n  afterHydration(() => replayEarlyClicks((url) => navigate(url as Route)));\n}\n\n"]}
+{"version":3,"file":"createViteRscApp.js","sourceRoot":"","sources":["../../src/js/createViteRscApp.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite-engine client bootstrap. Uses @vitejs/plugin-rsc's browser runtime as\n// the Flight deserializer + action encoder, and drives the package's engine-agnostic\n// navigate.ts SPA engine (Link, prefetch, popstate) through it. This replaces\n// the bun engine's createRscApp + the hand-rolled webpack shim — the plugin\n// resolves client references itself.\nimport { SEARCH_PARAMS_FALLBACK } from \"./useSearchParams\";\nimport { recoverFromStaleAssets } from \"./staleAssets\";\nimport { afterHydration, replayEarlyClicks } from \"./earlyClicks\";\nimport { parseRedirectDigest } from \"../redirectDigest.js\";\nimport { showDevNotice } from \"./devNotice\";\nimport { caughtByLoading } from \"./fallbackReport\";\nimport { noteNavigation } from \"./segmentStore\";\nimport type { Route } from \"../routes.js\";\nimport { isSafeRedirect } from \"../safeUrl.js\";\nimport {\n  createFromReadableStream,\n  encodeReply,\n  setServerCallback,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { createElement, startTransition } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { activityMarkersIn } from \"./activityMarkers\";\nimport { ActivityRoot } from \"./ActivityRouter\";\nimport { ServerRedirectError, noteRedirected, throwForFailedAction } from \"./errors\";\nimport { fetchPagePayload } from \"./pagePayload\";\nimport { claimRead, setQueryCodec } from \"./queryClient\";\nimport { clearSegments, dropHidden, isHeld, prerenderSegment, restoreSegments, setSegment } from \"./segmentStore\";\nimport type { ReactNode } from \"react\";\nimport {\n  cancelPrefetch,\n  isPrefetched,\n  navigate,\n  setApiRoutes,\n  refresh,\n  applyRevalidations,\n  prefetch,\n  retentionKey,\n  setCallServer,\n  setHeldLayouts,\n  setStaticPayloads,\n  setStaticRoutes,\n  seedStaticChain,\n  payloadUrl,\n  setDeserializer,\n  setInterceptManifest,\n  getHeldLayouts,\n  setNavigateHandler,\n  setHeldHandlers,\n  setPrerenderHandler,\n  setReplaceRootHandler,\n  setRestoreHandler,\n  setVersion,\n} from \"./navigate\";\n\n\n/**\n * A redirect that travelled as an error: the digest of the error itself, or\n * of the cause React wraps it in when it reports client-rendering a boundary\n * the server had already failed.\n */\nfunction isRedirect(error: unknown): boolean {\n  const digest = (error as { digest?: unknown } | null)?.digest;\n  const cause = (error as { cause?: { digest?: unknown } } | null)?.cause;\n\n  return parseRedirectDigest(digest) !== null || parseRedirectDigest(cause?.digest) !== null;\n}\n\nexport async function createViteRscApp(\n  container: Document | Element = document,\n  interceptEntries: { urlPattern: string; slot: string }[] = [],\n  options: { staticPayloads?: string | null; routes?: unknown[] | null; apiRoutes?: string[] } = {},\n): Promise<void> {\n  // The urls a route.ts answers: a link to one is an anchor, never a\n  // prefetch, never a payload fetch.\n  if (options.apiRoutes) setApiRoutes(options.apiRoutes);\n  // An exported build has no server to negotiate with, so payloads live at\n  // their own urls rather than behind a header on the page's url.\n  setStaticPayloads(options.staticPayloads ?? null);\n  // Only an exported build ships this: with no server to negotiate with, the\n  // client works out for itself how much of a page it still holds.\n  if (options.routes) setStaticRoutes(options.routes as never);\n  // The router has to recognise an intercepted link before it asks the server,\n  // so the patterns are baked into the generated browser entry. Without them\n  // every intercepted route falls through to a full-page navigation.\n  setInterceptManifest(interceptEntries);\n\n  async function callServer(id: string, args: unknown[]): Promise<unknown> {\n    // A read opened a slot before calling the reference, and this is the first\n    // point at which the id exists on the client — React keeps it private and\n    // hands it over only here. Claiming the slot enqueues the read for the\n    // batched GET instead of posting it.\n    const read = claimRead(id, args);\n\n    if (read) return await read;\n\n    const encoded = await encodeReply(args);\n\n    // encodeReply returns FormData as soon as an argument contains a File.\n    // Sending that as multipart would make PHP consume php://input while\n    // parsing it, leaving the action with an empty body — so serialize it to\n    // raw bytes under an opaque content-type and send the real one in\n    // X-RSC-Content-Type for the worker to rebuild FormData from.\n    let body: BodyInit;\n    let realContentType: string;\n\n    if (encoded instanceof FormData) {\n      const serialized = new Response(encoded);\n      body = await serialized.arrayBuffer();\n      realContentType =\n        serialized.headers.get(\"content-type\") ?? \"multipart/form-data\";\n    } else {\n      body = encoded as BodyInit;\n      realContentType = \"text/plain;charset=UTF-8\";\n    }\n\n    // Where the action was invoked from. The host resolves it to the\n    // components that render the page, so anything the action says it\n    // invalidated can come back with the answer instead of being fetched\n    // afterwards - and what comes back is for this page, not whichever is\n    // showing when it lands.\n    const from = window.location.pathname + window.location.search;\n\n    const res = await fetch(\"/_rsc/action\", {\n      method: \"POST\",\n      headers: {\n        \"X-RSC-Action\": id,\n        \"X-RSC-Referer\": from,\n        \"X-RSC-Content-Type\": realContentType,\n        \"Content-Type\": \"application/octet-stream\",\n        \"X-XSRF-TOKEN\": decodeURIComponent(\n          document.cookie.match(/XSRF-TOKEN=([^;]+)/)?.[1] ?? \"\",\n        ),\n      },\n      body,\n    });\n\n    // A failed action does not answer with a Flight stream, and the decoder\n    // cannot tell — it reports its own parse failure instead of what the\n    // server said.\n    try {\n      await throwForFailedAction(res);\n    } catch (err) {\n      // A redirect is an instruction, not something for a form to display:\n      // an expired session answers this way, and the destination is the login\n      // page rather than a message about one.\n      if (err instanceof ServerRedirectError) {\n        // The destination came off a response header, so it is checked here\n        // too — the engine refuses these at the source, but a proxy or a host\n        // in front of it can write whatever it likes. A navigation, not a\n        // document load: the layouts stay mounted and the history entry the\n        // form was on is replaced, the way a redirect after a POST should\n        // be - Back does not return to the submitted form.\n        if (isSafeRedirect(err.location)) {\n          void navigate(err.location as Route, { replace: true });\n        }\n\n        // Performed, so resolved - not thrown. The call's answer is \"you are\n        // being taken somewhere\": an object saying so, the shape an action's\n        // result already has, so a caller reading result.validationErrors\n        // reads undefined rather than throwing. A caller that awaited the\n        // action in a plain startTransition had no catch for a throw, the\n        // rejection reached React, and the root unmounted to a white page\n        // on every logout.\n        noteRedirected(err.location);\n\n        return { redirected: err.location };\n      }\n\n      throw err;\n    }\n\n    const answer = await createFromReadableStream(res.body!, { callServer });\n\n    return unwrapRevalidated(answer, from);\n  }\n\n  /**\n   * Put anything the action re-rendered on screen, and hand back its result.\n   *\n   * The trees travel with the answer rather than being fetched afterwards, so\n   * the caller sees only what its action returned and never knows the page\n   * was updated around it.\n   */\n  function unwrapRevalidated(answer: unknown, from: string): unknown {\n    if (\n      answer === null ||\n      typeof answer !== \"object\" ||\n      !(\"__rscRevalidated\" in answer)\n    ) {\n      return answer;\n    }\n\n    const envelope = answer as {\n      __rscRevalidated: Record<string, unknown>;\n      result: unknown;\n    };\n\n    applyRevalidations(from, envelope.__rscRevalidated as Record<string, ReactNode>);\n\n    return envelope.result;\n  }\n\n  setDeserializer(createFromReadableStream as never);\n  // The query transport speaks Flight too, and reaches the runtime through here\n  // rather than importing it: a second import of the browser runtime from the\n  // client-component graph is a second client-reference registry, and the\n  // symptom is components that render as undefined with nothing logged.\n  setQueryCodec({\n    deserialize: (stream) =>\n      createFromReadableStream(stream, { callServer }) as Promise<unknown>,\n    encode: (args) => encodeReply(args) as Promise<string | FormData>,\n    // The way back when a read cannot ride in a url. Re-entering callServer is\n    // safe: the slot was cleared the moment the reference returned, so this\n    // takes the ordinary POST path rather than claiming a read again.\n    asAction: (id, args) => callServer(id, args),\n  });\n  setCallServer(callServer);\n  // The plugin's own \"use server\" client stubs route through its registered\n  // server callback — register the same transport there too.\n  setServerCallback(callServer as never);\n\n  // Link / Form / router live in a separate build graph and reach the SPA\n  // engine through these globals.\n  (window as unknown as { __rsc_navigate: typeof navigate }).__rsc_navigate =\n    navigate;\n  (window as unknown as { __rsc_prefetch: typeof prefetch }).__rsc_prefetch =\n    prefetch;\n  (\n    window as unknown as { __rsc_cancel_prefetch: typeof cancelPrefetch }\n  ).__rsc_cancel_prefetch = cancelPrefetch;\n  (\n    window as unknown as { __rsc_is_prefetched: typeof isPrefetched }\n  ).__rsc_is_prefetched = isPrefetched;\n  (window as unknown as { __rsc_refresh: typeof refresh }).__rsc_refresh =\n    refresh;\n\n  // Hydrate from the RSC endpoint (same url + X-RSC, no version header).\n  //\n  // Everything from here to the decode is failure handling, because this is\n  // the one request with nothing watching it. A page whose shell is already\n  // rendered looks fine while this fails, and its fallbacks stay on screen\n  // indefinitely with nothing reported anywhere.\n  const res = await fetchPagePayload(payloadUrl(window.location.href));\n\n  // Seed the router with the build this DOCUMENT is, so a redeploy is caught\n  // on the next navigation: the host answers 409 to a client of another\n  // build, and the document is loaded again. From the document's own meta\n  // first - a document a service worker served from its cache is the last\n  // build's, while the payload just fetched is this one's, and seeding from\n  // the payload would have the old client claim to be new. The header is\n  // the fallback for a document with no meta.\n  const documentBuild = document.querySelector('meta[name=\"rsc-kit:build\"]')?.getAttribute(\"content\");\n  const servedVersion = documentBuild || res.headers.get(\"X-RSC-Version\");\n\n  if (servedVersion) {\n    setVersion(servedVersion);\n  }\n\n  // The chain this page is built from, so the next navigation can say what is\n  // already mounted and be sent only what changed.\n  // A server says what this page is built from; a file server says nothing,\n  // so an exported build works it out from the table it was given.\n  const servedLayouts = res.headers.get(\"X-RSC-Layouts\");\n\n  if (servedLayouts !== null) {\n    setHeldLayouts(servedLayouts.split(\",\"));\n  } else if (!seedStaticChain(window.location.href)) {\n    setHeldLayouts([]);\n  }\n  const tree = await createFromReadableStream(res.body!, { callServer });\n\n  // Retaining the previous page behind <Activity> needs a wrapper above the\n  // page, and React will not hydrate a *document* container through one: the\n  // root child of a document has to be <html>, and wrapping it hangs the\n  // renderer outright (React 19.2.7). An app whose root layout owns <html>\n  // therefore hydrates the tree directly and navigations replace it, as before.\n  //\n  // Apps that hydrate into an element get retention. Giving it to document-\n  // rooted apps means SPA navigation returning only the changed segment rather\n  // than a whole document, which is an engine change, not a client one.\n  const retains = container !== document;\n\n  const shell = retains\n    ? createElement(ActivityRoot, {\n        initialKey: retentionKey(window.location.href, null),\n        initialTree: tree as ReactNode,\n      })\n    : (tree as ReactNode);\n\n  // A document that cannot be hydrated by this tree is client-rendered\n  // instead - a repaint, not a freeze. React 19.2 does not recover from a\n  // hydration mismatch at an <Activity>: it retries hydrating the boundary,\n  // mismatches again, and never returns to the main thread. Every segment\n  // boundary is an Activity, one per layout, so a document with none where\n  // the page has layouts is that mismatch, guaranteed, before React starts.\n  // What produced one: a parameterised route's PPR shell, rendered without\n  // a page key and, by a build before this one, without the Activities too.\n  // None rather than fewer: a boundary inside a Suspense hole the shell left\n  // unfinished has no marker and is client-rendered by React on its own,\n  // which is not a mismatch. The stale-asset reload does not apply - the\n  // document would come back the same.\n  const missing = retains && getHeldLayouts().length > 0 && activityMarkersIn(container) === 0;\n\n  if (missing) {\n    console.warn(\n      \"[rsc-kit] The document has no <Activity> boundaries where the page has layouts, so it cannot be hydrated; rendering the page instead. A PPR shell built by an earlier release lacks them - rebuild.\",\n    );\n  }\n\n  // The payload answered with an error status - the not-found page for a\n  // url the shell was served for anyway. It is not the document on screen,\n  // so it is rendered, not hydrated: a mismatch at an Activity is the loop\n  // above, and this one is certain.\n  const disagrees = !res.ok;\n\n  const onRecoverableError = (error: unknown, errorInfo: unknown) => {\n      // A client component whose chunk the server no longer has fails while\n      // hydrating, and React reports that as recoverable: the page is loaded\n      // again, with the current names.\n      if (recoverFromStaleAssets(error)) return;\n\n      // A redirect decided inside a boundary: the server's row carried it as\n      // the digest, React client-renders the boundary and reports that it\n      // did, and the RedirectBoundary is already performing it. Nothing to\n      // read in the console about a page doing what it was told.\n      if (isRedirect(error)) return;\n\n      // A PPR shell is served with its Suspense boundaries deliberately\n      // unfinished — the build aborts the render once the static part is out.\n      // React reports that as #419 and client-renders the boundary from the\n      // Flight payload, which is the intended path, not a fault to report.\n      const message = String((error as { message?: string })?.message ?? error);\n\n      if (\n        message.includes(\"419\") ||\n        message.includes(\"did not finish this Suspense boundary\")\n      ) {\n        return;\n      }\n\n      // A view transition the browser cancelled because the tab was not\n      // visible. React reports it here; the update still landed, and a tab\n      // in the background is not a fault in the page.\n      if (message.includes(\"Transition was aborted\")) return;\n\n      // A navigation another one overtook: its request was aborted, and a\n      // row of its payload that a component was still reading rejects with\n      // the abort. React recovers by rendering the root again synchronously\n      // and reports the recovery here as #520, with the abort as the cause.\n      // The page it recovered to is the one the second navigation asked for;\n      // the abort was the design, not a fault.\n      const cause = (error as { cause?: { name?: string; message?: string } } | null)?.cause;\n\n      if (\n        cause?.name === \"AbortError\" ||\n        /\\baborted\\b/i.test(cause?.message ?? \"\") ||\n        /\\baborted\\b/i.test(message)\n      ) {\n        return;\n      }\n      // A page whose query string was read under a boundary carries the\n      // fallback there; React reports the recovery on hydration. Under a\n      // boundary the developer wrote, that is the designed path and nothing\n      // is said. With nothing closer than a loading.tsx, the whole segment\n      // showed the fallback until the query arrived - said here, in the\n      // page and the console, for whoever is looking at either. Production\n      // has no stack to tell the two apart; the build's note on the route is\n      // the record there.\n      if (\n        (error as { digest?: string })?.digest === SEARCH_PARAMS_FALLBACK ||\n        message.includes(\"useSearchParams()\")\n      ) {\n        const stack = (errorInfo as { componentStack?: string } | null)\n          ?.componentStack;\n\n        if (!caughtByLoading(stack)) return;\n\n        const hint =\n          \"useSearchParams() was read on the server with nothing closer than a loading.tsx, so the \" +\n          \"whole segment showed that fallback until the query arrived. A <Suspense> around the \" +\n          \"component that reads keeps the rest of the page painted.\";\n\n        showDevNotice(hint, stack);\n        console.error(new Error(hint), errorInfo);\n\n        return;\n      }\n\n      console.error(error, errorInfo);\n  };\n\n  const rootOptions = {\n    onRecoverableError,\n    // A chunk the deploy no longer serves is not a fault in the page; the\n    // document is loaded again, and the new names come with it. Anything\n    // else is reported the way React would have.\n    onUncaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n\n      console.error(error, errorInfo);\n    },\n    onCaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n      // Caught by the RedirectBoundary, which is performing it.\n      if (isRedirect(error)) return;\n\n      console.error(error, errorInfo);\n    },\n  };\n\n  const root = missing || disagrees\n    ? (() => {\n        const created = createRoot(container as Element, rootOptions);\n\n        created.render(shell);\n\n        return created;\n      })()\n    : hydrateRoot(container, shell, rootOptions);\n\n  // Depth 0 is a whole document and replaces the root. Anything deeper is one\n  // segment: handing it to the boundary at that depth leaves the layouts above\n  // it mounted, which is the point of asking for a partial render at all.\n  setNavigateHandler((tree: unknown, key: string, segmentDepth: number, inPlaceOf?: string | null) => {\n    const newTree = tree as ReactNode;\n\n    // From here on the boundary animates; the seed commit before this did not.\n    noteNavigation();\n\n    if (segmentDepth > 0) {\n      setSegment(segmentDepth, key, newTree, inPlaceOf);\n\n      return;\n    }\n\n    clearSegments();\n    root.render(newTree);\n  });\n\n  // The whole document again, in place - revalidate(\"all\"). Not through the\n  // handler above: that clears the boundaries and renders the tree as a new\n  // page, and a boundary emptied re-keys its Activity to the current url and\n  // remounts everything under it. A port's \"added to cart\" went with the\n  // form's state that way, on every product reached by a link. Here the root\n  // takes the tree in a transition and each boundary hands its page the new\n  // children under the key it has - see replaceActive.\n  setReplaceRootHandler((tree: unknown) => {\n    startTransition(() => root.render(tree as ReactNode));\n  });\n\n  // Back and forward reveal a page the boundaries are still holding, with the\n  // form you were filling in still filled in, and without asking the server.\n  setRestoreHandler((key: string, maxAge?: number) =>\n    restoreSegments(key, maxAge),\n  );\n  setHeldHandlers(isHeld, dropHidden);\n\n  // A touch or a settled hover: the page is rendered hidden now, and the\n  // click reveals it. See warm() in navigate.ts and prerenderSegment.\n  setPrerenderHandler((tree: unknown, key: string, segmentDepth: number) => {\n    prerenderSegment(segmentDepth, key, tree as ReactNode);\n  });\n\n  window.addEventListener(\"popstate\", () => {\n    // restore: back and forward reveal the page you were on, with its state.\n    // Wherever the browser just went; not a literal this app wrote.\n    navigate(window.location.href as Route, { replace: true, restore: true });\n  });\n\n  history.replaceState(\n    { rscUrl: window.location.href },\n    \"\",\n    window.location.href,\n  );\n\n  // A tap held by the bootstrap script, navigated to once hydration has\n  // committed - not now: the runtime's script running is seconds before\n  // React can dispatch a click on a phone still downloading chunks, and\n  // a tap in that window would be the browser's. See earlyClicks.ts.\n  afterHydration(() => replayEarlyClicks((url) => navigate(url as Route)));\n}\n\n"]}

package/dist/js/navigate.d.ts

@@ -36,7 +36,7 @@ export declare function setVersion(v: string): void;
  */
 export declare function setHeldLayouts(chain: string[]): void;
 export declare function getHeldLayouts(): string[];
-export declare function setNavigateHandler(fn: (tree: ReactNode, key: string, segmentDepth: number) => void): void;
+export declare function setNavigateHandler(fn: (tree: ReactNode, key: string, segmentDepth: number, inPlaceOf?: string | null) => void): void;
 export declare function setReplaceRootHandler(fn: ((tree: ReactNode) => void) | null): void;
 export declare function setHeldHandlers(held: ((key: string, maxAge?: number) => boolean) | null, drop: (() => void) | null): void;
 /**

package/dist/js/navigate.js

@@ -839,7 +839,15 @@ export async function navigate(url, opts) {
         interceptedAtDepth = interceptSlot ? segmentDepth : null;
         interceptedFrom = interceptSlot ? (interceptedFrom ?? previousUrl) : null;
         navigationReached("applied");
-        onNavigate?.(tree, activityKey, segmentDepth);
+        // A replace to the same path with a new query is the page it replaces,
+        // moved: the entry left behind can never be gone back to, and mounting a
+        // new one showed every fallback in the page - a new chat's first message
+        // redirects /chat to /chat?c=25 this way. A push keeps its own page, so
+        // Back still restores the one it came from.
+        const inPlaceOf = opts?.replace && !interceptSlot && new URL(url, window.location.origin).pathname === new URL(previousUrl, window.location.origin).pathname
+            ? retentionKey(previousUrl, null)
+            : null;
+        onNavigate?.(tree, activityKey, segmentDepth, inPlaceOf);
         if (!opts?.preserveScroll && !interceptSlot) {
             // Wait for React to commit the DOM update before scrolling.
             // Intercepted navigations preserve scroll (e.g. modal over current page).