@rsc-kit/core 0.20.7 → 0.20.10

package/dist/js/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/js/errors.ts"],"names":[],"mappings":"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","sourcesContent":["export class ServerValidationError extends Error {\n  public readonly errors: Record<string, string[]>;\n\n  constructor(message: string, errors: Record<string, string[]>) {\n    super(message);\n    this.name = \"ServerValidationError\";\n    this.errors = errors;\n  }\n}\n\n/** An action answered with a location instead of a result. */\n/**\n * The redirect the last action answered with, for the one caller that asks.\n *\n * An action that redirects resolves - the navigation is already under way\n * and the caller has nothing to do - which leaves a form that wants to know\n * whether to say \"saved\" with no way to tell a redirect from a void answer.\n * callServer notes the destination here; <Form> reads and clears it right\n * after its await. Nothing else needs to.\n */\nlet lastRedirect: string | null = null;\n\nexport function noteRedirected(location: string): void {\n  lastRedirect = location;\n}\n\n/** The redirect the action just performed, if it did - read once. */\nexport function redirectedTo(): string | null {\n  const location = lastRedirect;\n\n  lastRedirect = null;\n\n  return location;\n}\n\nexport class ServerRedirectError extends Error {\n  public readonly location: string;\n\n  constructor(location: string) {\n    super(`Server action redirected to ${location}`);\n    this.name = \"ServerRedirectError\";\n    this.location = location;\n  }\n}\n\nexport class ServerAuthenticationError extends Error {\n  constructor(message: string = \"Unauthenticated.\") {\n    super(message);\n    this.name = \"ServerAuthenticationError\";\n  }\n}\n\nexport class ServerAuthorizationError extends Error {\n  constructor(message: string = \"This action is unauthorized.\") {\n    super(message);\n    this.name = \"ServerAuthorizationError\";\n  }\n}\n\nexport class ServerDumpError extends Error {\n  constructor() {\n    super(\"Server returned a dump response.\");\n    this.name = \"ServerDumpError\";\n  }\n}\n\nexport class ServerSessionExpiredError extends Error {\n  constructor(message: string = \"Your session has expired. Please refresh the page.\") {\n    super(message);\n    this.name = \"ServerSessionExpiredError\";\n  }\n}\n\n/**\n * Turn a failed server-action response into the error it describes.\n *\n * A server action that does not succeed answers with JSON or a redirect\n * header rather than a Flight stream. Passing one of those to the Flight\n * decoder does not produce the server's message — it produces an internal\n * parser failure (\"enqueueModel is not a function\") or a truncated read\n * (\"Connection closed.\"), which is what reached onError before this existed.\n *\n * Returns without throwing when the response is a stream to be decoded.\n */\nexport async function throwForFailedAction(response: Response): Promise<void> {\n  // Before the status: a redirect the action asked for is a 204 with the\n  // destination in this header - an ok answer with no Flight in it - and\n  // an expired session's is a 401. Read first, the header decides for both.\n  // Read after `ok`, the 204 fell through to the Flight decoder with an\n  // empty body, and the form waited forever.\n  const location = response.headers.get(\"X-RSC-Redirect\");\n\n  if (location !== null && location !== \"\") {\n    throw new ServerRedirectError(location);\n  }\n\n  if (response.ok) return;\n\n  if (response.status === 422) {\n    const payload = (await response.json().catch(() => null)) as\n      | { message?: string; errors?: Record<string, string[]> }\n      | null;\n\n    throw new ServerValidationError(\n      payload?.message ?? \"Validation failed\",\n      payload?.errors ?? {},\n    );\n  }\n\n  if (response.status === 413) {\n    throw new Error(\n      \"Server action refused: the request body is larger than the server accepts. \" +\n        \"A file upload is the usual cause; the limit is the host's maxActionBody.\",\n    );\n  }\n\n  throw new Error(`Server action failed with ${response.status}`);\n}\n\n/**\n * Reject a payload response that is not one.\n *\n * The page a PPR route serves is a static shell: real HTML, status 200, with\n * its Suspense fallbacks showing. Everything below them arrives in a second\n * request. If that request fails there is nothing on screen to say so — the\n * skeletons simply stay, for ever — and handing the failure body to the Flight\n * decoder reports the decoder's confusion rather than the status.\n */\nexport function throwForFailedPayload(response: Response): void {\n  if (response.ok) return;\n\n  throw new Error(`RSC payload request failed with ${response.status}`);\n}\n\n/**\n * Announce a failure that nothing else will.\n *\n * Dispatched as well as logged: an app that wants to replace a stuck skeleton\n * with something honest has no other way to find out.\n */\nexport function reportClientFailure(scope: string, error: unknown): void {\n  if (typeof window !== \"undefined\") {\n    window.dispatchEvent(new CustomEvent(\"rsc-client-error\", { detail: { scope, error } }));\n  }\n\n  console.error(`[rsc-kit] ${scope}`, error);\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/js/errors.ts"],"names":[],"mappings":"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","sourcesContent":["export class ServerValidationError extends Error {\n  public readonly errors: Record<string, string[]>;\n\n  constructor(message: string, errors: Record<string, string[]>) {\n    super(message);\n    this.name = \"ServerValidationError\";\n    this.errors = errors;\n  }\n}\n\n/** An action answered with a location instead of a result. */\n/**\n * The redirect the last action answered with, for the one caller that asks.\n *\n * An action that redirects resolves - the navigation is already under way\n * and the caller has nothing to do - which leaves a form that wants to know\n * whether to say \"saved\" with no way to tell a redirect from a void answer.\n * callServer notes the destination here; <Form> reads and clears it right\n * after its await. Nothing else needs to.\n */\nlet lastRedirect: string | null = null;\n\nexport function noteRedirected(location: string): void {\n  lastRedirect = location;\n}\n\n/** The redirect the action just performed, if it did - read once. */\nexport function redirectedTo(): string | null {\n  const location = lastRedirect;\n\n  lastRedirect = null;\n\n  return location;\n}\n\nexport class ServerRedirectError extends Error {\n  public readonly location: string;\n\n  constructor(location: string) {\n    super(`Server action redirected to ${location}`);\n    this.name = \"ServerRedirectError\";\n    this.location = location;\n  }\n}\n\nexport class ServerAuthenticationError extends Error {\n  constructor(message: string = \"Unauthenticated.\") {\n    super(message);\n    this.name = \"ServerAuthenticationError\";\n  }\n}\n\nexport class ServerAuthorizationError extends Error {\n  constructor(message: string = \"This action is unauthorized.\") {\n    super(message);\n    this.name = \"ServerAuthorizationError\";\n  }\n}\n\nexport class ServerDumpError extends Error {\n  constructor() {\n    super(\"Server returned a dump response.\");\n    this.name = \"ServerDumpError\";\n  }\n}\n\nexport class ServerSessionExpiredError extends Error {\n  constructor(message: string = \"Your session has expired. Please refresh the page.\") {\n    super(message);\n    this.name = \"ServerSessionExpiredError\";\n  }\n}\n\n/**\n * Turn a failed server-action response into the error it describes.\n *\n * A server action that does not succeed answers with JSON or a redirect\n * header rather than a Flight stream. Passing one of those to the Flight\n * decoder does not produce the server's message — it produces an internal\n * parser failure (\"enqueueModel is not a function\") or a truncated read\n * (\"Connection closed.\"), which is what reached onError before this existed.\n *\n * Returns without throwing when the response is a stream to be decoded.\n */\nexport async function throwForFailedAction(response: Response): Promise<void> {\n  // Before the status: a redirect the action asked for is a 204 with the\n  // destination in this header - an ok answer with no Flight in it - and\n  // an expired session's is a 401. Read first, the header decides for both.\n  // Read after `ok`, the 204 fell through to the Flight decoder with an\n  // empty body, and the form waited forever.\n  const location = response.headers.get(\"X-RSC-Redirect\");\n\n  if (location !== null && location !== \"\") {\n    throw new ServerRedirectError(location);\n  }\n\n  if (response.ok) return;\n\n  if (response.status === 422) {\n    const payload = (await response.json().catch(() => null)) as\n      | { message?: string; errors?: Record<string, string[]> }\n      | null;\n\n    throw new ServerValidationError(\n      payload?.message ?? \"Validation failed\",\n      payload?.errors ?? {},\n    );\n  }\n\n  if (response.status === 413) {\n    throw new Error(\n      \"Server action refused: the request body is larger than the server accepts. \" +\n        \"A file upload is the usual cause; the limit is the host's maxActionBody.\",\n    );\n  }\n\n  throw new Error(`Server action failed with ${response.status}`);\n}\n\n/**\n * Reject a payload response that is not one.\n *\n * The page a PPR route serves is a static shell: real HTML, status 200, with\n * its Suspense fallbacks showing. Everything below them arrives in a second\n * request. If that request fails there is nothing on screen to say so — the\n * skeletons simply stay, for ever — and handing the failure body to the Flight\n * decoder reports the decoder's confusion rather than the status.\n */\nexport function throwForFailedPayload(response: Response): void {\n  if (response.ok) return;\n\n  // A 404 that is a payload is the not-found page, rendered: a url a\n  // pattern's shell answered with a 200 and a page that, run for real,\n  // found no row - a subcategory under the wrong category. The page is\n  // what the visitor should see; refusing it left the shell's content on\n  // screen with nothing hydrated behind it, and every tap dead.\n  if (isPayload(response)) return;\n\n  throw new Error(`RSC payload request failed with ${response.status}`);\n}\n\n/** Whether a response is a Flight payload, whatever its status. */\nexport function isPayload(response: Response): boolean {\n  return (response.headers.get(\"Content-Type\") ?? \"\").includes(\"text/x-component\");\n}\n\n/**\n * Announce a failure that nothing else will.\n *\n * Dispatched as well as logged: an app that wants to replace a stuck skeleton\n * with something honest has no other way to find out.\n */\nexport function reportClientFailure(scope: string, error: unknown): void {\n  if (typeof window !== \"undefined\") {\n    window.dispatchEvent(new CustomEvent(\"rsc-client-error\", { detail: { scope, error } }));\n  }\n\n  console.error(`[rsc-kit] ${scope}`, error);\n}\n"]}

package/dist/js/imagePreload.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The pictures a prefetched page shows, fetched before the click.
+ *
+ * A payload names them: every <img> the page renders is a row in it, src
+ * and srcSet included. The page is rendered hidden on touch, and a hidden
+ * page's images do load then - but a touch leads its click by a few hundred
+ * milliseconds, and a product picture on a phone's connection takes
+ * longer. The original of a port fetched the next page's image list from a
+ * route as each link came into view; here the list is already in the
+ * payload the router holds, so the images are asked for as it lands, at low
+ * priority, and the click finds them decoded.
+ *
+ * Only the ones the page would load at once: an <img loading="lazy"> waits
+ * for the viewport on the page too. Bounded per payload, and each url once
+ * per document; nothing under Save-Data.
+ */
+export type Priority = 'low' | 'high';
+export interface ImageProps {
+    src?: string;
+    srcSet?: string;
+    sizes?: string;
+    loading?: string;
+    alt?: string;
+}
+/** The props of every <img> element row in a flight payload, in order. */
+export declare function imagesIn(payload: string): ImageProps[];
+/**
+ * Ask the browser for the eager images a payload names.
+ *
+ * Low as the payload lands on sight, behind everything the page itself is
+ * loading. High on intent - the touch, the settled hover - when this is the
+ * page about to show: a listing's two dozen tiles each preload their
+ * product's picture, and the one tapped first was queued behind the rest,
+ * for three hundred milliseconds on a phone; asked again as urgent, the
+ * browser moves it to the front, ahead of the pictures nobody touched.
+ */
+export declare function preloadImages(payload: string, priority?: Priority): number;

package/dist/js/imagePreload.js

@@ -0,0 +1,116 @@
+/**
+ * The pictures a prefetched page shows, fetched before the click.
+ *
+ * A payload names them: every <img> the page renders is a row in it, src
+ * and srcSet included. The page is rendered hidden on touch, and a hidden
+ * page's images do load then - but a touch leads its click by a few hundred
+ * milliseconds, and a product picture on a phone's connection takes
+ * longer. The original of a port fetched the next page's image list from a
+ * route as each link came into view; here the list is already in the
+ * payload the router holds, so the images are asked for as it lands, at low
+ * priority, and the click finds them decoded.
+ *
+ * Only the ones the page would load at once: an <img loading="lazy"> waits
+ * for the viewport on the page too. Bounded per payload, and each url once
+ * per document; nothing under Save-Data.
+ */
+/**
+ * Per payload, the first few: the pictures a page shows first are the ones
+ * at the top of its payload - a product's own picture before its related
+ * ones. Twenty-four a page, times the dozen pages a listing prefetches on
+ * sight, was three hundred requests on a phone's radio the moment the home
+ * page settled, and the next tap's payload queued behind them: "clicking a
+ * category breaks navigation for a few seconds".
+ */
+const PER_PAGE = 6;
+/** Across the document: a home page with five hundred links in view is not five hundred pages of pictures. */
+const PER_DOCUMENT = 96;
+/** Each picture asked for, and how urgently. */
+const asked = new Map();
+/** The props of every <img> element row in a flight payload, in order. */
+export function imagesIn(payload) {
+    const found = [];
+    let at = 0;
+    while (found.length < PER_PAGE) {
+        const start = payload.indexOf('["$","img",', at);
+        if (start === -1)
+            break;
+        // Past the key: `["$","img","key",{` or `["$","img",null,{`.
+        const brace = payload.indexOf('{', start);
+        if (brace === -1)
+            break;
+        const end = closingBrace(payload, brace);
+        at = end === -1 ? brace + 1 : end + 1;
+        if (end === -1)
+            continue;
+        try {
+            found.push(JSON.parse(payload.slice(brace, end + 1)));
+        }
+        catch {
+            // A props object with a reference in it that is not JSON; not a picture worth guessing at.
+        }
+    }
+    return found;
+}
+/** The index of the brace closing the object opened at `open`, honouring strings. */
+function closingBrace(text, open) {
+    let depth = 0;
+    let inString = false;
+    for (let i = open; i < text.length; i++) {
+        const c = text[i];
+        if (inString) {
+            if (c === '\\')
+                i++;
+            else if (c === '"')
+                inString = false;
+            continue;
+        }
+        if (c === '"')
+            inString = true;
+        else if (c === '{')
+            depth++;
+        else if (c === '}' && --depth === 0)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Ask the browser for the eager images a payload names.
+ *
+ * Low as the payload lands on sight, behind everything the page itself is
+ * loading. High on intent - the touch, the settled hover - when this is the
+ * page about to show: a listing's two dozen tiles each preload their
+ * product's picture, and the one tapped first was queued behind the rest,
+ * for three hundred milliseconds on a phone; asked again as urgent, the
+ * browser moves it to the front, ahead of the pictures nobody touched.
+ */
+export function preloadImages(payload, priority = 'low') {
+    if (typeof document === 'undefined')
+        return 0;
+    if (navigator.connection?.saveData)
+        return 0;
+    let started = 0;
+    for (const props of imagesIn(payload)) {
+        if (asked.size >= PER_DOCUMENT && priority === 'low')
+            break;
+        if (props.loading === 'lazy' || !props.src)
+            continue;
+        const key = props.srcSet ?? props.src;
+        const before = asked.get(key);
+        if (before === 'high' || before === priority)
+            continue;
+        asked.set(key, priority);
+        const img = new Image();
+        img.decoding = 'async';
+        img.fetchPriority = priority;
+        // sizes before srcset before src: the browser chooses on assignment.
+        if (props.sizes)
+            img.sizes = props.sizes;
+        if (props.srcSet)
+            img.srcset = props.srcSet;
+        img.src = props.src;
+        started++;
+    }
+    return started;
+}
+//# sourceMappingURL=imagePreload.js.map

package/dist/js/imagePreload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imagePreload.js","sourceRoot":"","sources":["../../src/js/imagePreload.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The pictures a prefetched page shows, fetched before the click.\n *\n * A payload names them: every <img> the page renders is a row in it, src\n * and srcSet included. The page is rendered hidden on touch, and a hidden\n * page's images do load then - but a touch leads its click by a few hundred\n * milliseconds, and a product picture on a phone's connection takes\n * longer. The original of a port fetched the next page's image list from a\n * route as each link came into view; here the list is already in the\n * payload the router holds, so the images are asked for as it lands, at low\n * priority, and the click finds them decoded.\n *\n * Only the ones the page would load at once: an <img loading=\"lazy\"> waits\n * for the viewport on the page too. Bounded per payload, and each url once\n * per document; nothing under Save-Data.\n */\n\n/**\n * Per payload, the first few: the pictures a page shows first are the ones\n * at the top of its payload - a product's own picture before its related\n * ones. Twenty-four a page, times the dozen pages a listing prefetches on\n * sight, was three hundred requests on a phone's radio the moment the home\n * page settled, and the next tap's payload queued behind them: \"clicking a\n * category breaks navigation for a few seconds\".\n */\nconst PER_PAGE = 6\n/** Across the document: a home page with five hundred links in view is not five hundred pages of pictures. */\nconst PER_DOCUMENT = 96\n/** Each picture asked for, and how urgently. */\nconst asked = new Map<string, Priority>()\n\nexport type Priority = 'low' | 'high'\n\nexport interface ImageProps {\n  src?: string\n  srcSet?: string\n  sizes?: string\n  loading?: string\n  alt?: string\n}\n\n/** The props of every <img> element row in a flight payload, in order. */\nexport function imagesIn(payload: string): ImageProps[] {\n  const found: ImageProps[] = []\n  let at = 0\n\n  while (found.length < PER_PAGE) {\n    const start = payload.indexOf('[\"$\",\"img\",', at)\n\n    if (start === -1) break\n\n    // Past the key: `[\"$\",\"img\",\"key\",{` or `[\"$\",\"img\",null,{`.\n    const brace = payload.indexOf('{', start)\n\n    if (brace === -1) break\n\n    const end = closingBrace(payload, brace)\n\n    at = end === -1 ? brace + 1 : end + 1\n\n    if (end === -1) continue\n\n    try {\n      found.push(JSON.parse(payload.slice(brace, end + 1)) as ImageProps)\n    } catch {\n      // A props object with a reference in it that is not JSON; not a picture worth guessing at.\n    }\n  }\n\n  return found\n}\n\n/** The index of the brace closing the object opened at `open`, honouring strings. */\nfunction closingBrace(text: string, open: number): number {\n  let depth = 0\n  let inString = false\n\n  for (let i = open; i < text.length; i++) {\n    const c = text[i]\n\n    if (inString) {\n      if (c === '\\\\') i++\n      else if (c === '\"') inString = false\n\n      continue\n    }\n\n    if (c === '\"') inString = true\n    else if (c === '{') depth++\n    else if (c === '}' && --depth === 0) return i\n  }\n\n  return -1\n}\n\n/**\n * Ask the browser for the eager images a payload names.\n *\n * Low as the payload lands on sight, behind everything the page itself is\n * loading. High on intent - the touch, the settled hover - when this is the\n * page about to show: a listing's two dozen tiles each preload their\n * product's picture, and the one tapped first was queued behind the rest,\n * for three hundred milliseconds on a phone; asked again as urgent, the\n * browser moves it to the front, ahead of the pictures nobody touched.\n */\nexport function preloadImages(payload: string, priority: Priority = 'low'): number {\n  if (typeof document === 'undefined') return 0\n  if ((navigator as { connection?: { saveData?: boolean } }).connection?.saveData) return 0\n\n  let started = 0\n\n  for (const props of imagesIn(payload)) {\n    if (asked.size >= PER_DOCUMENT && priority === 'low') break\n    if (props.loading === 'lazy' || !props.src) continue\n\n    const key = props.srcSet ?? props.src\n    const before = asked.get(key)\n\n    if (before === 'high' || before === priority) continue\n\n    asked.set(key, priority)\n\n    const img = new Image()\n\n    img.decoding = 'async'\n    ;(img as { fetchPriority?: string }).fetchPriority = priority\n    // sizes before srcset before src: the browser chooses on assignment.\n    if (props.sizes) img.sizes = props.sizes\n    if (props.srcSet) img.srcset = props.srcSet\n    img.src = props.src\n    started++\n  }\n\n  return started\n}\n"]}

package/dist/js/navigate.d.ts

@@ -37,6 +37,20 @@ 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 setReplaceRootHandler(fn: ((tree: ReactNode) => void) | null): void;
+export declare function setHeldHandlers(held: ((key: string, maxAge?: number) => boolean) | null, drop: (() => void) | null): void;
+/**
+ * Everything the router holds about pages other than the one on screen,
+ * dropped: prefetched payloads, and pages kept behind this one.
+ *
+ * After an action that revalidated. The list a link prefetched before the
+ * mutation still shows the table without the new row - visit() landed on
+ * it with no request made, and a reload showed the row. What was fetched
+ * before a write is not a cache of what is true after it; the pages held
+ * for the back button are from before it too.
+ */
+export declare function forgetOtherPages(): void;
+export declare function setPrerenderHandler(fn: ((tree: ReactNode, key: string, segmentDepth: number) => void) | null): void;
 /**
  * How the router reveals a page that is still mounted behind the current one.
  *
@@ -88,6 +102,25 @@ export declare function navigate(url: Route, opts?: {
  * is the same apply path a navigation uses — without a request, a url change
  * or a history entry.
  */
+/**
+ * Whether the page an action was invoked from is the one on screen.
+ *
+ * The one underneath, when an interception is showing: a modal opened after
+ * the submit sits over the same page.
+ */
+export declare function stillShowing(url: string): boolean;
+/**
+ * Put what an action re-rendered on screen.
+ *
+ * `from` is the url the action was invoked on - what the host rendered the
+ * trees for. A tap that left the page while the action was in flight has
+ * changed what is showing, and a document rendered for the page before
+ * cannot go under the url after: "Add to cart", then the brand link at
+ * once, showed the home page and then, when the answer landed, the product
+ * again under `/`. The write still happened, and the page on screen was
+ * fetched before it - so that page is asked for again, whole, instead.
+ */
+export declare function applyRevalidations(from: string, revalidated: Record<string, ReactNode>): void;
 export declare function applyRevalidated(target: string, tree: ReactNode): void;
 /**
  * Ask the server for part of this page again.

package/dist/js/navigate.js

@@ -5,9 +5,10 @@
  * The Flight deserializer is injected by createViteRscApp to avoid
  * duplicate bundling of react-server-dom-webpack.
  */
-import { isStaleAssetError, loadDocumentOnce } from "./staleAssets";
+import { announceDocumentLoad, isStaleAssetError, loadDocumentOnce, } from "./staleAssets";
 import { isUpdated, markStale } from "./updateStore";
 import { navigationAbandoned, navigationCommitted, navigationReached, navigationStarted } from "./perf";
+import { preloadImages } from "./imagePreload";
 import { isSafeRedirect } from "../safeUrl.js";
 import { reportReachable } from "./onlineStore";
 import { clearSlots, setSlot } from "./slotStore";
@@ -19,6 +20,22 @@ let version = "";
 const navigating = new Set();
 let onNavigate = null;
 let onRestore = null;
+/**
+ * Re-render the whole document in place, for revalidate("all"): the page the
+ * visitor is on, not a page they went to. Without one registered, the
+ * navigation handler at depth 0 is used, which shows the tree as a page.
+ */
+let onReplaceRoot = null;
+/** Whether a navigation to the key would reveal a held page, asked without revealing it. */
+let isHeldPage = null;
+/** Drop the pages held behind the one on screen - after a mutation. */
+let dropHeld = null;
+/**
+ * Render a decoded page in the background, hidden, before the click - see
+ * warm(). Given the same tree the navigation will hand to onNavigate, so
+ * that the navigation is a reveal of work already done rather than a render.
+ */
+let onPrerender = null;
 /**
  * How stale a held page may be and still be revealed by a link.
  *
@@ -42,6 +59,33 @@ let interceptManifest = [];
 // The layout chain currently mounted, outermost first. Sent so the server can
 // skip re-rendering the layouts still on screen.
 let heldLayouts = [];
+/**
+ * The chain each page was shown under, by retention key.
+ *
+ * A held page revealed - the back button, or a link to the page just left -
+ * puts its layouts back on screen, and the chain has to say so. It used to
+ * keep the chain of the page being left: home, a category, back to home,
+ * then another category claimed the first category's layout as mounted. The
+ * server sent the page alone, and the client put it in the boundary that
+ * layout owns - inside the hidden category. The url changed and the page did
+ * not, and every tap after it did the same, until a reload. The demo froze
+ * on a phone within a dozen taps.
+ *
+ * Bounded like the payload cache: a key that is no longer held is never
+ * asked for, so the oldest can go.
+ */
+const chainOf = new Map();
+const MAX_CHAINS = 64;
+function rememberChain(key) {
+    chainOf.delete(key);
+    chainOf.set(key, heldLayouts);
+    while (chainOf.size > MAX_CHAINS) {
+        const oldest = chainOf.keys().next().value;
+        if (oldest === undefined)
+            break;
+        chainOf.delete(oldest);
+    }
+}
 /**
  * The boundary depth an interception was rendered at, while one is showing.
  *
@@ -61,6 +105,11 @@ let interceptedAtDepth = null;
  * screen with everything the user typed into it.
  */
 let interceptedOver = null;
+/**
+ * The url an interception was opened from, whichever way it was rendered -
+ * the page still on screen under the modal. Only stillShowing asks.
+ */
+let interceptedFrom = null;
 const DEFAULT_PREFETCH_TTL = 30_000;
 /**
  * How long a payload the host marked `public` is kept.
@@ -130,6 +179,7 @@ export function seedStaticChain(url) {
     if (!segments)
         return false;
     heldLayouts = segments.chain;
+    rememberChain(retentionKey(url, null));
     return true;
 }
 /**
@@ -218,6 +268,7 @@ async function tellWorkerServerBuild(build) {
  */
 export function setHeldLayouts(chain) {
     heldLayouts = chain;
+    rememberChain(retentionKey(window.location.href, null));
 }
 export function getHeldLayouts() {
     return heldLayouts;
@@ -225,6 +276,34 @@ export function getHeldLayouts() {
 export function setNavigateHandler(fn) {
     onNavigate = fn;
 }
+export function setReplaceRootHandler(fn) {
+    onReplaceRoot = fn;
+}
+export function setHeldHandlers(held, drop) {
+    isHeldPage = held;
+    dropHeld = drop;
+}
+/**
+ * Everything the router holds about pages other than the one on screen,
+ * dropped: prefetched payloads, and pages kept behind this one.
+ *
+ * After an action that revalidated. The list a link prefetched before the
+ * mutation still shows the table without the new row - visit() landed on
+ * it with no request made, and a reload showed the row. What was fetched
+ * before a write is not a cache of what is true after it; the pages held
+ * for the back button are from before it too.
+ */
+export function forgetOtherPages() {
+    for (const [key, controller] of prefetchControllers) {
+        controller.abort();
+        prefetchControllers.delete(key);
+    }
+    cache.clear();
+    dropHeld?.();
+}
+export function setPrerenderHandler(fn) {
+    onPrerender = fn;
+}
 /**
  * How the router reveals a page that is still mounted behind the current one.
  *
@@ -491,6 +570,7 @@ export async function navigate(url, opts) {
     // advice. Not for a restore: going back to a page still held asks the
     // server for nothing.
     if (!opts?.restore && isUpdated()) {
+        announceDocumentLoad(url, "newer-build");
         window.location.href = url;
         return;
     }
@@ -499,12 +579,14 @@ export async function navigate(url, opts) {
     }
     // External URLs can't be fetched (CORS) — go directly to full page navigation
     if (isExternalUrl(url)) {
+        announceDocumentLoad(url, "external");
         window.location.href = url;
         return;
     }
     // A route.ts answers with a Response, not a page: a download, a redirect
     // that decides where someone belongs, a sign-out. The browser goes there.
     if (isApiRoute(url)) {
+        announceDocumentLoad(url, "api-route");
         window.location.href = url;
         return;
     }
@@ -550,6 +632,7 @@ export async function navigate(url, opts) {
         retentionKey(url, null) === retentionKey(interceptedOver, null)) {
         clearSlots();
         interceptedOver = null;
+        interceptedFrom = null;
         interceptedAtDepth = null;
         if (opts?.replace) {
             history.replaceState({ rscUrl: url }, "", url);
@@ -581,8 +664,14 @@ export async function navigate(url, opts) {
         onRestore?.(activityKey, opts?.restore ? undefined : revealWithin)) {
         // A restored tree carries its own slot contents, so the flag only has to
         // reflect whether what is now showing is an intercepted view.
-        if (!interceptSlot)
+        if (!interceptSlot) {
             interceptedAtDepth = null;
+            interceptedFrom = null;
+        }
+        // Its layouts are the ones on screen now - see chainOf.
+        const chain = chainOf.get(activityKey);
+        if (chain)
+            heldLayouts = chain;
         // opts?.replace, not opts.replace: this branch used to be reachable only
         // with opts.restore set, so opts was always there. A link reaches it now
         // with nothing passed at all.
@@ -665,6 +754,7 @@ export async function navigate(url, opts) {
             const contentType = response.headers.get("Content-Type") ?? "";
             if (staticPayloadSuffix === null &&
                 !contentType.includes("text/x-component")) {
+                announceDocumentLoad(url, `not-a-payload:${response.status}:${contentType.split(";")[0]}`);
                 window.location.href = url;
                 return;
             }
@@ -729,6 +819,7 @@ export async function navigate(url, opts) {
         }
         if (nextLayouts !== null)
             heldLayouts = nextLayouts;
+        rememberChain(activityKey);
         // The answer is one region, not a piece of the page: the host rendered
         // only the interceptor because the page underneath is already mounted and
         // still correct. Putting it in the slot leaves that page — and everything
@@ -736,6 +827,7 @@ export async function navigate(url, opts) {
         if (slotPayload !== null) {
             setSlot(slotPayload, tree);
             interceptedOver = interceptedOver ?? previousUrl;
+            interceptedFrom = interceptedFrom ?? previousUrl;
             interceptedAtDepth = null;
             return;
         }
@@ -744,6 +836,7 @@ export async function navigate(url, opts) {
         clearSlots();
         interceptedOver = null;
         interceptedAtDepth = interceptSlot ? segmentDepth : null;
+        interceptedFrom = interceptSlot ? (interceptedFrom ?? previousUrl) : null;
         navigationReached("applied");
         onNavigate?.(tree, activityKey, segmentDepth);
         if (!opts?.preserveScroll && !interceptSlot) {
@@ -762,6 +855,7 @@ export async function navigate(url, opts) {
         // A chunk the deploy no longer serves: the browser would have loaded the
         // document, and the new names with it. Do what it would have done.
         if (isStaleAssetError(err)) {
+            announceDocumentLoad(url, `stale-asset:${String(err?.message ?? err).slice(0, 120)}`);
             window.location.href = url;
             return;
         }
@@ -785,12 +879,51 @@ export async function navigate(url, opts) {
  * is the same apply path a navigation uses — without a request, a url change
  * or a history entry.
  */
+/**
+ * Whether the page an action was invoked from is the one on screen.
+ *
+ * The one underneath, when an interception is showing: a modal opened after
+ * the submit sits over the same page.
+ */
+export function stillShowing(url) {
+    const key = retentionKey(url, null);
+    const now = retentionKey(window.location.pathname + window.location.search, null);
+    return key === now || (interceptedFrom !== null && key === retentionKey(interceptedFrom, null));
+}
+/**
+ * Put what an action re-rendered on screen.
+ *
+ * `from` is the url the action was invoked on - what the host rendered the
+ * trees for. A tap that left the page while the action was in flight has
+ * changed what is showing, and a document rendered for the page before
+ * cannot go under the url after: "Add to cart", then the brand link at
+ * once, showed the home page and then, when the answer landed, the product
+ * again under `/`. The write still happened, and the page on screen was
+ * fetched before it - so that page is asked for again, whole, instead.
+ */
+export function applyRevalidations(from, revalidated) {
+    // What was fetched or held before the write is from before it.
+    forgetOtherPages();
+    if (!stillShowing(from)) {
+        void refresh("all");
+        return;
+    }
+    for (const [target, tree] of Object.entries(revalidated)) {
+        applyRevalidated(target, tree);
+    }
+}
 export function applyRevalidated(target, tree) {
     const url = window.location.pathname + window.location.search;
     const key = retentionKey(url, null);
     if (target === "all") {
-        // Depth 0 replaces the root, which is what re-rendering the layouts means.
-        onNavigate?.(tree, key, 0);
+        // The whole document again, in place. Not a navigation to this url:
+        // the visible entry may be keyed by the url the document loaded with,
+        // and showing the tree under the current one made a second entry and
+        // remounted the app under it.
+        if (onReplaceRoot)
+            onReplaceRoot(tree);
+        else
+            onNavigate?.(tree, key, 0);
         return;
     }
     if (target === "page") {
@@ -818,6 +951,9 @@ export function applyRevalidated(target, tree) {
  */
 export async function refresh(target = "page") {
     const url = window.location.pathname + window.location.search;
+    // Asked because the data moved on; what was fetched or held before is
+    // from before.
+    forgetOtherPages();
     if (target !== "page" && target !== "all") {
         const response = await fetch(payloadUrl(url), {
             headers: {
@@ -941,6 +1077,11 @@ export function prefetch(url, cacheForMs, intent = false) {
     // in view, was a 14 KB payload for the page already on screen.
     if (retentionKey(url, null) === retentionKey(window.location.href, null))
         return;
+    // Nor a page still held behind this one, which a navigation would reveal
+    // rather than fetch: the page just left, whose link is on every page,
+    // was one wasted payload per navigation.
+    if (!matchIntercept(url) && isHeldPage?.(retentionKey(url, null), revealWithin))
+        return;
     // Nor anything, once this page is known to be the previous build: the
     // next navigation is a document load, and a payload it would not use is
     // a 409 for nothing - one per tap, measured.
@@ -958,15 +1099,57 @@ export function prefetch(url, cacheForMs, intent = false) {
         prefetchUrl(cacheKey, url, ttl, interceptSlot, currentUrl, held);
     }
     else {
-        prefetchUrl(url, url, ttl, undefined, undefined, held);
+        prefetchUrl(retentionKeyFor(url, null), url, ttl, undefined, undefined, held);
     }
 }
-/** Decode a held payload now, so the chunks it names are loading before the tap. */
-function warm(entry) {
+/**
+ * Do the click's work now: decode the held payload, which loads the chunks
+ * it names, and render the page hidden so the click is a reveal.
+ *
+ * The numbers this came from, on an iPhone with everything prefetched: a
+ * first visit to the landing page was 107 ms from tap to paint, 4 of them
+ * decoding and 87 rendering; a page still held from a visit before was
+ * 15 ms, a reveal. The render is the page's size on the phone's CPU, and
+ * nothing in the payload's path shrinks it - but it can be paid before the
+ * finger lifts. A touch leads its click by 100-300 ms; a settled hover, by
+ * 200 or more. React renders a hidden Activity at idle priority, so the
+ * work yields to scrolling, and the navigation then hands the boundary the
+ * same tree it prerendered: React bails out of the whole subtree and flips
+ * it visible.
+ *
+ * Only a segment at depth 1 or more, rendered against the chain held now: a
+ * whole document replaces the root, and a slot is a region of a page not on
+ * screen yet. A prefetch that landed on a redirect - a guarded link, on a
+ * landing page all of them - warms the destination it prefetched instead:
+ * the tap on Sign in decoded the login page and loaded its chunks after the
+ * click, 154 ms of a 225 ms tap.
+ */
+function warm(entry, cacheKey) {
     // The tree is read by the navigation that takes the entry, and a decode
     // that fails - a chunk the deploy no longer serves - fails there, where it
     // is handled. Here the rejection has nobody to reach.
-    entry.tree.catch(() => { });
+    entry.body
+        .then((text) => {
+        if (entry.redirectTo) {
+            const destination = cache.get(retentionKeyFor(entry.redirectTo, matchIntercept(entry.redirectTo)));
+            if (destination)
+                warm(destination, retentionKeyFor(entry.redirectTo, matchIntercept(entry.redirectTo)));
+            return;
+        }
+        if (text === null)
+            return;
+        // The page about to show: its pictures ahead of every other page's.
+        preloadImages(text, "high");
+        return entry.tree.then((tree) => {
+            if (entry.slot !== null ||
+                entry.segmentDepth === 0 ||
+                !isUsable(entry, claimedChain(null)) ||
+                cache.get(cacheKey) !== entry)
+                return;
+            onPrerender?.(tree, cacheKey, entry.segmentDepth);
+        });
+    })
+        .catch(() => { });
 }
 function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl, held = { intent: false, explicitTtl: false }) {
     const chain = claimedChain(interceptSlot ?? null);
@@ -974,7 +1157,7 @@ function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl, held = { int
     if (existing && existing.expiresAt > Date.now()) {
         // Fetched as it came into view, undecoded; the touch says decode it.
         if (held.intent)
-            warm(existing);
+            warm(existing, cacheKey);
         return;
     }
     // A navigation is already fetching it; the answer is on its way.
@@ -1043,8 +1226,13 @@ function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl, held = { int
             entry.expiresAt = Math.max(entry.expiresAt, Date.now() + STATIC_PREFETCH_TTL);
         }
         // The bytes, not the page: decoding is the navigation's, see CacheEntry
-        // - unless the visitor is already on the way, see prefetch().
-        return response.text();
+        // - unless the visitor is already on the way, see prefetch(). The
+        // pictures the page shows are asked for now, though: on a phone they
+        // take longer than the touch-to-click a hidden render has.
+        return response.text().then((text) => {
+            preloadImages(text);
+            return text;
+        });
     })
         .catch(() => {
         entry.failed = true;
@@ -1060,7 +1248,7 @@ function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl, held = { int
     });
     cache.set(cacheKey, entry);
     if (held.intent)
-        warm(entry);
+        warm(entry, cacheKey);
 }
 /**
  * Drop a prefetch that is still in flight — the pointer left the link.