@rsc-kit/core 0.20.6 → 0.20.7

package/dist/js/ActivityRouter.js

@@ -15,6 +15,7 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
  */
 import { Activity, useCallback, useEffect, useRef, useState } from 'react';
 import { setNavigateHandler, setRestoreHandler } from './navigate';
+import { navigationCommitted } from './perf';
 import { clearSegments, setSegment } from './segmentStore';
 /** Pages kept alive behind the visible one. Four covers ordinary back-and-forth. */
 export const DEFAULT_RETENTION = 4;
@@ -69,6 +70,10 @@ export function useActivityRouter(initial, retention = DEFAULT_RETENTION) {
  */
 export function ActivityRoot({ initialKey, initialTree }) {
     const { entries, activeKey, handle } = useActivityRouter({ key: initialKey, tree: initialTree });
+    // A whole document shown, or a held page revealed: the navigation's commit.
+    useEffect(() => {
+        navigationCommitted();
+    }, [activeKey, entries]);
     useEffect(() => {
         setNavigateHandler((tree, key, segmentDepth) => {
             // A partial payload replaces one segment inside the page that is already

package/dist/js/ActivityRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityRouter.js","sourceRoot":"","sources":["../../src/js/ActivityRouter.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keeps recently visited pages mounted but hidden, so going back restores them\n * rather than rebuilding them.\n *\n * Rendering each navigation with root.render() unmounts the previous tree, and\n * unmounting destroys client state: a half-typed form, an open disclosure, a\n * scrolled list. React's <Activity mode=\"hidden\"> hides a tree without\n * unmounting it — effects are torn down, but state survives — which is what\n * makes returning feel like the browser's own back button rather than a reload.\n *\n * Retention is bounded. Hidden trees keep their DOM, so an unbounded history\n * would grow the document for the length of the session; the least recently\n * visited entry is dropped past the limit.\n */\n\nimport { Activity, useCallback, useEffect, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { setNavigateHandler, setRestoreHandler } from './navigate'\nimport { clearSegments, setSegment } from './segmentStore'\n\nexport interface RouterEntry {\n  /** Identifies the page: its URL, or the intercept variant of one. */\n  key: string\n  tree: ReactNode\n}\n\nexport interface ActivityRouterHandle {\n  /** Show `tree` for `key`, retaining whatever was visible before. */\n  show(key: string, tree: ReactNode): void\n  /** Reveal a retained page without refetching. False when not retained. */\n  restore(key: string): boolean\n  /** Drop every retained page but the visible one. */\n  clear(): void\n}\n\n/** Pages kept alive behind the visible one. Four covers ordinary back-and-forth. */\nexport const DEFAULT_RETENTION = 4\n\nexport function useActivityRouter(\n  initial: RouterEntry,\n  retention: number = DEFAULT_RETENTION,\n): { entries: RouterEntry[]; activeKey: string; handle: ActivityRouterHandle } {\n  const [entries, setEntries] = useState<RouterEntry[]>([initial])\n  const [activeKey, setActiveKey] = useState(initial.key)\n\n  // The router calls into this from outside React, where the values captured by\n  // the last render may already be stale. Refs mirror state so those calls read\n  // what is actually mounted.\n  const entriesRef = useRef(entries)\n  const orderRef = useRef<string[]>([initial.key])\n\n  const commit = useCallback((next: RouterEntry[]) => {\n    entriesRef.current = next\n    setEntries(next)\n  }, [])\n\n  // Recency, most recent last. Retention is by visit order rather than\n  // insertion, so bouncing between two pages evicts neither.\n  const touch = useCallback(\n    (key: string) => {\n      const next = orderRef.current.filter((k) => k !== key)\n      next.push(key)\n      orderRef.current = next.slice(-Math.max(1, retention))\n\n      return orderRef.current\n    },\n    [retention],\n  )\n\n  const show = useCallback(\n    (key: string, tree: ReactNode) => {\n      const kept = touch(key)\n      const others = entriesRef.current.filter((entry) => entry.key !== key && kept.includes(entry.key))\n\n      commit([...others, { key, tree }])\n      setActiveKey(key)\n    },\n    [commit, touch],\n  )\n\n  const restore = useCallback(\n    (key: string) => {\n      if (!entriesRef.current.some((entry) => entry.key === key)) return false\n\n      touch(key)\n      setActiveKey(key)\n\n      return true\n    },\n    [touch],\n  )\n\n  const clear = useCallback(() => {\n    const kept = entriesRef.current.filter((entry) => entry.key === activeKey)\n\n    commit(kept)\n    orderRef.current = [activeKey]\n  }, [activeKey, commit])\n\n  const handleRef = useRef<ActivityRouterHandle>({ show, restore, clear })\n  handleRef.current = { show, restore, clear }\n\n  return { entries, activeKey, handle: handleRef.current }\n}\n\n/**\n * Root of the hydrated app.\n *\n * Registers itself with the navigation engine so a navigation becomes a state\n * update here rather than a fresh root.render(), which is what allows the\n * previous page to stay mounted.\n */\nexport function ActivityRoot({ initialKey, initialTree }: { initialKey: string; initialTree: ReactNode }) {\n  const { entries, activeKey, handle } = useActivityRouter({ key: initialKey, tree: initialTree })\n\n  useEffect(() => {\n    setNavigateHandler((tree, key, segmentDepth) => {\n      // A partial payload replaces one segment inside the page that is already\n      // showing; only a whole document is a new page to retain.\n      if (segmentDepth > 0) {\n        setSegment(segmentDepth, key, tree as ReactNode)\n\n        return\n      }\n\n      clearSegments()\n      handle.show(key, tree as ReactNode)\n    })\n\n    setRestoreHandler((key) => handle.restore(key))\n  }, [handle])\n\n  return (\n    <>\n      {entries.map((entry) => (\n        <Activity key={entry.key} mode={entry.key === activeKey ? 'visible' : 'hidden'}>\n          {entry.tree}\n        </Activity>\n      ))}\n    </>\n  )\n}\n"]}
+{"version":3,"file":"ActivityRouter.js","sourceRoot":"","sources":["../../src/js/ActivityRouter.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keeps recently visited pages mounted but hidden, so going back restores them\n * rather than rebuilding them.\n *\n * Rendering each navigation with root.render() unmounts the previous tree, and\n * unmounting destroys client state: a half-typed form, an open disclosure, a\n * scrolled list. React's <Activity mode=\"hidden\"> hides a tree without\n * unmounting it — effects are torn down, but state survives — which is what\n * makes returning feel like the browser's own back button rather than a reload.\n *\n * Retention is bounded. Hidden trees keep their DOM, so an unbounded history\n * would grow the document for the length of the session; the least recently\n * visited entry is dropped past the limit.\n */\n\nimport { Activity, useCallback, useEffect, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport { setNavigateHandler, setRestoreHandler } from './navigate'\nimport { navigationCommitted } from './perf'\nimport { clearSegments, setSegment } from './segmentStore'\n\nexport interface RouterEntry {\n  /** Identifies the page: its URL, or the intercept variant of one. */\n  key: string\n  tree: ReactNode\n}\n\nexport interface ActivityRouterHandle {\n  /** Show `tree` for `key`, retaining whatever was visible before. */\n  show(key: string, tree: ReactNode): void\n  /** Reveal a retained page without refetching. False when not retained. */\n  restore(key: string): boolean\n  /** Drop every retained page but the visible one. */\n  clear(): void\n}\n\n/** Pages kept alive behind the visible one. Four covers ordinary back-and-forth. */\nexport const DEFAULT_RETENTION = 4\n\nexport function useActivityRouter(\n  initial: RouterEntry,\n  retention: number = DEFAULT_RETENTION,\n): { entries: RouterEntry[]; activeKey: string; handle: ActivityRouterHandle } {\n  const [entries, setEntries] = useState<RouterEntry[]>([initial])\n  const [activeKey, setActiveKey] = useState(initial.key)\n\n  // The router calls into this from outside React, where the values captured by\n  // the last render may already be stale. Refs mirror state so those calls read\n  // what is actually mounted.\n  const entriesRef = useRef(entries)\n  const orderRef = useRef<string[]>([initial.key])\n\n  const commit = useCallback((next: RouterEntry[]) => {\n    entriesRef.current = next\n    setEntries(next)\n  }, [])\n\n  // Recency, most recent last. Retention is by visit order rather than\n  // insertion, so bouncing between two pages evicts neither.\n  const touch = useCallback(\n    (key: string) => {\n      const next = orderRef.current.filter((k) => k !== key)\n      next.push(key)\n      orderRef.current = next.slice(-Math.max(1, retention))\n\n      return orderRef.current\n    },\n    [retention],\n  )\n\n  const show = useCallback(\n    (key: string, tree: ReactNode) => {\n      const kept = touch(key)\n      const others = entriesRef.current.filter((entry) => entry.key !== key && kept.includes(entry.key))\n\n      commit([...others, { key, tree }])\n      setActiveKey(key)\n    },\n    [commit, touch],\n  )\n\n  const restore = useCallback(\n    (key: string) => {\n      if (!entriesRef.current.some((entry) => entry.key === key)) return false\n\n      touch(key)\n      setActiveKey(key)\n\n      return true\n    },\n    [touch],\n  )\n\n  const clear = useCallback(() => {\n    const kept = entriesRef.current.filter((entry) => entry.key === activeKey)\n\n    commit(kept)\n    orderRef.current = [activeKey]\n  }, [activeKey, commit])\n\n  const handleRef = useRef<ActivityRouterHandle>({ show, restore, clear })\n  handleRef.current = { show, restore, clear }\n\n  return { entries, activeKey, handle: handleRef.current }\n}\n\n/**\n * Root of the hydrated app.\n *\n * Registers itself with the navigation engine so a navigation becomes a state\n * update here rather than a fresh root.render(), which is what allows the\n * previous page to stay mounted.\n */\nexport function ActivityRoot({ initialKey, initialTree }: { initialKey: string; initialTree: ReactNode }) {\n  const { entries, activeKey, handle } = useActivityRouter({ key: initialKey, tree: initialTree })\n\n  // A whole document shown, or a held page revealed: the navigation's commit.\n  useEffect(() => {\n    navigationCommitted()\n  }, [activeKey, entries])\n\n  useEffect(() => {\n    setNavigateHandler((tree, key, segmentDepth) => {\n      // A partial payload replaces one segment inside the page that is already\n      // showing; only a whole document is a new page to retain.\n      if (segmentDepth > 0) {\n        setSegment(segmentDepth, key, tree as ReactNode)\n\n        return\n      }\n\n      clearSegments()\n      handle.show(key, tree as ReactNode)\n    })\n\n    setRestoreHandler((key) => handle.restore(key))\n  }, [handle])\n\n  return (\n    <>\n      {entries.map((entry) => (\n        <Activity key={entry.key} mode={entry.key === activeKey ? 'visible' : 'hidden'}>\n          {entry.tree}\n        </Activity>\n      ))}\n    </>\n  )\n}\n"]}

package/dist/js/Link.d.ts

@@ -28,5 +28,5 @@ interface LinkBaseProps<H extends Route> extends Omit<AnchorHTMLAttributes<HTMLA
  * here. With no schema, any scalars. See SearchFor in routes.ts.
  */
 type LinkProps<H extends Route> = LinkBaseProps<H> & SearchProp<H>;
-export default function Link<H extends Route>({ href: path, search, prefetch: prefetchProp, cacheFor, replace, preserveScroll, children, onClick, onMouseEnter, onMouseLeave, ref: callerRef, ...rest }: LinkProps<H>): import("react").JSX.Element;
+export default function Link<H extends Route>({ href: path, search, prefetch: prefetchProp, cacheFor, replace, preserveScroll, children, onClick, onMouseEnter, onMouseLeave, onMouseDown, ref: callerRef, ...rest }: LinkProps<H>): import("react").JSX.Element;
 export {};

package/dist/js/Link.js

@@ -30,7 +30,7 @@ function shouldInterceptClick(e) {
  * hover this short would not have had its payload back anyway.
  */
 const HOVER_PREFETCH_DELAY_MS = 100;
-export default function Link({ href: path, search, prefetch: prefetchProp = "hover", cacheFor, replace = false, preserveScroll = false, children, onClick, onMouseEnter, onMouseLeave, ref: callerRef, ...rest }) {
+export default function Link({ href: path, search, prefetch: prefetchProp = "hover", cacheFor, replace = false, preserveScroll = false, children, onClick, onMouseEnter, onMouseLeave, onMouseDown, ref: callerRef, ...rest }) {
     // The string the anchor and the router both use: the path, with the typed
     // search params serialised onto it.
     const href = (search ? withSearch(path, search) : path);
@@ -41,11 +41,14 @@ export default function Link({ href: path, search, prefetch: prefetchProp = "hov
         : prefetchProp === false
             ? "none"
             : prefetchProp;
-    const doPrefetch = useCallback(() => {
+    // `intent` is a hover that settled or a touch: the payload is decoded as
+    // it lands, so the chunks the page names are loading before the click. A
+    // link that only came into view fetches the bytes and stops there.
+    const doPrefetch = useCallback((intent = false) => {
         if (isExternalUrl(href))
             return;
         const fn = window.__rsc_prefetch;
-        fn?.(href, cacheFor);
+        fn?.(href, cacheFor, intent);
     }, [href, cacheFor]);
     // Only useEffect needed: prefetch on mount strategy
     useEffect(() => {
@@ -53,13 +56,13 @@ export default function Link({ href: path, search, prefetch: prefetchProp = "hov
             doPrefetch();
         }
     }, [prefetchStrategy, doPrefetch]);
-    // Where nothing can hover, the link prefetches as it comes into view -
-    // the head start a touch gives is a round trip short. See viewportPrefetch.
+    // The link prefetches as it comes into view - the bytes, so a click finds
+    // them however quick it is. See viewportPrefetch.
     const anchor = useRef(null);
     useEffect(() => {
         if (prefetchStrategy !== "hover")
             return;
-        return prefetchWhenVisible(anchor.current, doPrefetch);
+        return prefetchWhenVisible(anchor.current, () => doPrefetch());
     }, [prefetchStrategy, doPrefetch]);
     const handleClick = useCallback((e) => {
         onClick?.(e);
@@ -96,7 +99,7 @@ export default function Link({ href: path, search, prefetch: prefetchProp = "hov
             clearTimeout(hoverTimer.current);
         hoverTimer.current = setTimeout(() => {
             hoverTimer.current = null;
-            doPrefetch();
+            doPrefetch(true);
         }, HOVER_PREFETCH_DELAY_MS);
     }, [prefetchStrategy, doPrefetch, onMouseEnter]);
     const handleMouseLeave = useCallback((e) => {
@@ -115,11 +118,24 @@ export default function Link({ href: path, search, prefetch: prefetchProp = "hov
     // Touch gets no delay. There is no hovering to disambiguate — a touch is
     // already the start of a tap — and touchstart leads the click by little
     // enough that spending any of it waiting would waste the head start.
+    //
+    // And it decodes: the viewport prefetch that came before it, if one did,
+    // fetched the bytes and left the chunks for the tap. This is the tap.
     const handleTouchStart = useCallback(() => {
         if (prefetchStrategy === "hover" || prefetchStrategy === "click") {
-            doPrefetch();
+            doPrefetch(true);
         }
     }, [prefetchStrategy, doPrefetch]);
+    // A press is a click 60-100 ms from landing, and a quick one comes before
+    // the hover has settled. Whatever the hover did not, this does; whatever
+    // it did, this finds done.
+    const handleMouseDown = useCallback((e) => {
+        onMouseDown?.(e);
+        if (e.button !== 0)
+            return;
+        if (prefetchStrategy === "hover" || prefetchStrategy === "click")
+            doPrefetch(true);
+    }, [prefetchStrategy, doPrefetch, onMouseDown]);
     // A link unmounted mid-hover (navigating away) must not prefetch afterwards.
     useEffect(() => () => {
         if (hoverTimer.current !== null)
@@ -134,6 +150,6 @@ export default function Link({ href: path, search, prefetch: prefetchProp = "hov
                     callerRef(node);
                 else if (callerRef)
                     callerRef.current = node;
-            }, href: href, "data-rsc": "", onClick: handleClick, onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onTouchStart: handleTouchStart, "data-pending": pending ? "" : undefined, ...rest, children: children }) }));
+            }, href: href, "data-rsc": "", onClick: handleClick, onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onTouchStart: handleTouchStart, onMouseDown: handleMouseDown, "data-pending": pending ? "" : undefined, ...rest, children: children }) }));
 }
 //# sourceMappingURL=Link.js.map

package/dist/js/Link.js.map

@@ -1 +1 @@
-{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/js/Link.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport { LinkStatusContext } from \"./useLinkStatus\";\nimport { prefetchWhenVisible } from \"./viewportPrefetch\";\nimport { type Route, type SearchProp, withSearch } from \"../routes.js\";\nimport {\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n  type Ref,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from \"react\";\n\ntype PrefetchStrategy = \"hover\" | \"mount\" | \"click\" | \"none\" | boolean;\n\ninterface LinkBaseProps<H extends Route> extends Omit<\n  AnchorHTMLAttributes<HTMLAnchorElement>,\n  \"href\"\n> {\n  /**\n   * Where this goes. Typed to the routes the build found, so a link to a page\n   * that does not exist stops compiling; `path as Route` when it is computed.\n   */\n  href: H;\n  /**\n   * The underlying anchor.\n   *\n   * Spread onto it like any other prop — React 19 passes ref through a\n   * function component without forwardRef — but declared here because it is\n   * not part of AnchorHTMLAttributes. A link that cannot be focused is a link\n   * a dialog cannot move focus to when it opens.\n   */\n  ref?: Ref<HTMLAnchorElement>;\n  prefetch?: PrefetchStrategy;\n  cacheFor?: number;\n  replace?: boolean;\n  preserveScroll?: boolean;\n}\n\n/**\n * `search` is typed to the page's own `searchParams` schema when it exports\n * one — the same schema the page parses with, so a key it never reads or a\n * number written as text does not compile, and a key it requires is required\n * here. With no schema, any scalars. See SearchFor in routes.ts.\n */\ntype LinkProps<H extends Route> = LinkBaseProps<H> & SearchProp<H>;\n\nfunction isExternalUrl(url: string): boolean {\n  try {\n    return (\n      new URL(url, window.location.origin).origin !== window.location.origin\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction shouldInterceptClick(e: MouseEvent<HTMLAnchorElement>): boolean {\n  return (\n    !e.defaultPrevented &&\n    e.button === 0 &&\n    !e.metaKey &&\n    !e.ctrlKey &&\n    !e.shiftKey &&\n    !e.altKey\n  );\n}\n\n/**\n * How long a pointer has to settle on a link before it prefetches.\n *\n * A pointer crossing a nav bar enters every link on the way, and each one used\n * to fire a request immediately — enough to fill the browser's per-origin\n * connection limit with pages the user never meant to visit. Waiting is close\n * to free: the prefetch only has to beat the click, and a click that follows a\n * hover this short would not have had its payload back anyway.\n */\nconst HOVER_PREFETCH_DELAY_MS = 100;\n\nexport default function Link<H extends Route>({\n  href: path,\n  search,\n  prefetch: prefetchProp = \"hover\",\n  cacheFor,\n  replace = false,\n  preserveScroll = false,\n  children,\n  onClick,\n  onMouseEnter,\n  onMouseLeave,\n  ref: callerRef,\n  ...rest\n}: LinkProps<H>) {\n  // The string the anchor and the router both use: the path, with the typed\n  // search params serialised onto it.\n  const href = (search ? withSearch(path, search as object) : path) as Route;\n  const [pending, setPending] = useState(false);\n  const hoverTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const prefetchStrategy =\n    prefetchProp === true\n      ? \"hover\"\n      : prefetchProp === false\n        ? \"none\"\n        : prefetchProp;\n\n  const doPrefetch = useCallback(() => {\n    if (isExternalUrl(href)) return;\n    const fn = (window as any).__rsc_prefetch;\n    fn?.(href, cacheFor);\n  }, [href, cacheFor]);\n\n  // Only useEffect needed: prefetch on mount strategy\n  useEffect(() => {\n    if (prefetchStrategy === \"mount\") {\n      doPrefetch();\n    }\n  }, [prefetchStrategy, doPrefetch]);\n\n  // Where nothing can hover, the link prefetches as it comes into view -\n  // the head start a touch gives is a round trip short. See viewportPrefetch.\n  const anchor = useRef<HTMLAnchorElement | null>(null);\n\n  useEffect(() => {\n    if (prefetchStrategy !== \"hover\") return;\n\n    return prefetchWhenVisible(anchor.current, doPrefetch);\n  }, [prefetchStrategy, doPrefetch]);\n\n  const handleClick = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n\n      if (e.defaultPrevented) return;\n\n      const target = (e.currentTarget as HTMLAnchorElement).target;\n      if (target && target !== \"_self\") return;\n      if (!shouldInterceptClick(e) || isExternalUrl(href)) return;\n\n      // Hash-only links (#section) — let the browser scroll natively\n      if (href.startsWith(\"#\")) return;\n\n      e.preventDefault();\n      setPending(true);\n\n      // A hover that had not yet prefetched: the click is the navigation, and\n      // a prefetch of the page being left for, firing after it, is a request\n      // for nothing - seen as a stray 204 for a guarded link after landing\n      // on the login page.\n      if (hoverTimer.current !== null) {\n        clearTimeout(hoverTimer.current);\n        hoverTimer.current = null;\n      }\n\n      // navigate() returns a Promise — clear pending when it resolves or rejects\n      const nav = (window as any).__rsc_navigate;\n      const promise = nav?.(href, { replace, preserveScroll });\n      promise?.then(\n        () => setPending(false),\n        () => setPending(false),\n      );\n    },\n    [href, replace, preserveScroll, onClick],\n  );\n\n  const handleMouseEnter = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onMouseEnter?.(e);\n\n      if (prefetchStrategy !== \"hover\" && prefetchStrategy !== \"click\") return;\n\n      if (hoverTimer.current !== null) clearTimeout(hoverTimer.current);\n\n      hoverTimer.current = setTimeout(() => {\n        hoverTimer.current = null;\n        doPrefetch();\n      }, HOVER_PREFETCH_DELAY_MS);\n    },\n    [prefetchStrategy, doPrefetch, onMouseEnter],\n  );\n\n  const handleMouseLeave = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onMouseLeave?.(e);\n\n      // Never fired: the pointer passed over on its way somewhere else.\n      if (hoverTimer.current !== null) {\n        clearTimeout(hoverTimer.current);\n        hoverTimer.current = null;\n      }\n\n      // Already in flight: give the connection back to whatever the pointer is\n      // heading for. A prefetch that has landed is kept — see cancelPrefetch.\n      if (isExternalUrl(href)) return;\n      (window as any).__rsc_cancel_prefetch?.(href);\n    },\n    [href, onMouseLeave],\n  );\n\n  // Touch gets no delay. There is no hovering to disambiguate — a touch is\n  // already the start of a tap — and touchstart leads the click by little\n  // enough that spending any of it waiting would waste the head start.\n  const handleTouchStart = useCallback(() => {\n    if (prefetchStrategy === \"hover\" || prefetchStrategy === \"click\") {\n      doPrefetch();\n    }\n  }, [prefetchStrategy, doPrefetch]);\n\n  // A link unmounted mid-hover (navigating away) must not prefetch afterwards.\n  useEffect(\n    () => () => {\n      if (hoverTimer.current !== null) clearTimeout(hoverTimer.current);\n    },\n    [],\n  );\n\n  return (\n    <LinkStatusContext.Provider value={{ pending }}>\n      <a\n        // The caller's ref still fills: a dialog moving focus to its link\n        // needs the element as much as the observer above does.\n        ref={(node) => {\n          anchor.current = node;\n\n          if (typeof callerRef === \"function\") callerRef(node);\n          else if (callerRef) (callerRef as { current: HTMLAnchorElement | null }).current = node;\n        }}\n        href={href}\n        // The mark the bootstrap script's click listener looks for: a tap\n        // on this before the router exists is held for it. See earlyClicks.\n        data-rsc=\"\"\n        onClick={handleClick}\n        onMouseEnter={handleMouseEnter}\n        onMouseLeave={handleMouseLeave}\n        onTouchStart={handleTouchStart}\n        data-pending={pending ? \"\" : undefined}\n        {...rest}\n      >\n        {children}\n      </a>\n    </LinkStatusContext.Provider>\n  );\n}\n"]}
+{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/js/Link.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport { LinkStatusContext } from \"./useLinkStatus\";\nimport { prefetchWhenVisible } from \"./viewportPrefetch\";\nimport { type Route, type SearchProp, withSearch } from \"../routes.js\";\nimport {\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n  type Ref,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from \"react\";\n\ntype PrefetchStrategy = \"hover\" | \"mount\" | \"click\" | \"none\" | boolean;\n\ninterface LinkBaseProps<H extends Route> extends Omit<\n  AnchorHTMLAttributes<HTMLAnchorElement>,\n  \"href\"\n> {\n  /**\n   * Where this goes. Typed to the routes the build found, so a link to a page\n   * that does not exist stops compiling; `path as Route` when it is computed.\n   */\n  href: H;\n  /**\n   * The underlying anchor.\n   *\n   * Spread onto it like any other prop — React 19 passes ref through a\n   * function component without forwardRef — but declared here because it is\n   * not part of AnchorHTMLAttributes. A link that cannot be focused is a link\n   * a dialog cannot move focus to when it opens.\n   */\n  ref?: Ref<HTMLAnchorElement>;\n  prefetch?: PrefetchStrategy;\n  cacheFor?: number;\n  replace?: boolean;\n  preserveScroll?: boolean;\n}\n\n/**\n * `search` is typed to the page's own `searchParams` schema when it exports\n * one — the same schema the page parses with, so a key it never reads or a\n * number written as text does not compile, and a key it requires is required\n * here. With no schema, any scalars. See SearchFor in routes.ts.\n */\ntype LinkProps<H extends Route> = LinkBaseProps<H> & SearchProp<H>;\n\nfunction isExternalUrl(url: string): boolean {\n  try {\n    return (\n      new URL(url, window.location.origin).origin !== window.location.origin\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction shouldInterceptClick(e: MouseEvent<HTMLAnchorElement>): boolean {\n  return (\n    !e.defaultPrevented &&\n    e.button === 0 &&\n    !e.metaKey &&\n    !e.ctrlKey &&\n    !e.shiftKey &&\n    !e.altKey\n  );\n}\n\n/**\n * How long a pointer has to settle on a link before it prefetches.\n *\n * A pointer crossing a nav bar enters every link on the way, and each one used\n * to fire a request immediately — enough to fill the browser's per-origin\n * connection limit with pages the user never meant to visit. Waiting is close\n * to free: the prefetch only has to beat the click, and a click that follows a\n * hover this short would not have had its payload back anyway.\n */\nconst HOVER_PREFETCH_DELAY_MS = 100;\n\nexport default function Link<H extends Route>({\n  href: path,\n  search,\n  prefetch: prefetchProp = \"hover\",\n  cacheFor,\n  replace = false,\n  preserveScroll = false,\n  children,\n  onClick,\n  onMouseEnter,\n  onMouseLeave,\n  onMouseDown,\n  ref: callerRef,\n  ...rest\n}: LinkProps<H>) {\n  // The string the anchor and the router both use: the path, with the typed\n  // search params serialised onto it.\n  const href = (search ? withSearch(path, search as object) : path) as Route;\n  const [pending, setPending] = useState(false);\n  const hoverTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const prefetchStrategy =\n    prefetchProp === true\n      ? \"hover\"\n      : prefetchProp === false\n        ? \"none\"\n        : prefetchProp;\n\n  // `intent` is a hover that settled or a touch: the payload is decoded as\n  // it lands, so the chunks the page names are loading before the click. A\n  // link that only came into view fetches the bytes and stops there.\n  const doPrefetch = useCallback(\n    (intent = false) => {\n      if (isExternalUrl(href)) return;\n      const fn = (window as any).__rsc_prefetch;\n      fn?.(href, cacheFor, intent);\n    },\n    [href, cacheFor],\n  );\n\n  // Only useEffect needed: prefetch on mount strategy\n  useEffect(() => {\n    if (prefetchStrategy === \"mount\") {\n      doPrefetch();\n    }\n  }, [prefetchStrategy, doPrefetch]);\n\n  // The link prefetches as it comes into view - the bytes, so a click finds\n  // them however quick it is. See viewportPrefetch.\n  const anchor = useRef<HTMLAnchorElement | null>(null);\n\n  useEffect(() => {\n    if (prefetchStrategy !== \"hover\") return;\n\n    return prefetchWhenVisible(anchor.current, () => doPrefetch());\n  }, [prefetchStrategy, doPrefetch]);\n\n  const handleClick = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n\n      if (e.defaultPrevented) return;\n\n      const target = (e.currentTarget as HTMLAnchorElement).target;\n      if (target && target !== \"_self\") return;\n      if (!shouldInterceptClick(e) || isExternalUrl(href)) return;\n\n      // Hash-only links (#section) — let the browser scroll natively\n      if (href.startsWith(\"#\")) return;\n\n      e.preventDefault();\n      setPending(true);\n\n      // A hover that had not yet prefetched: the click is the navigation, and\n      // a prefetch of the page being left for, firing after it, is a request\n      // for nothing - seen as a stray 204 for a guarded link after landing\n      // on the login page.\n      if (hoverTimer.current !== null) {\n        clearTimeout(hoverTimer.current);\n        hoverTimer.current = null;\n      }\n\n      // navigate() returns a Promise — clear pending when it resolves or rejects\n      const nav = (window as any).__rsc_navigate;\n      const promise = nav?.(href, { replace, preserveScroll });\n      promise?.then(\n        () => setPending(false),\n        () => setPending(false),\n      );\n    },\n    [href, replace, preserveScroll, onClick],\n  );\n\n  const handleMouseEnter = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onMouseEnter?.(e);\n\n      if (prefetchStrategy !== \"hover\" && prefetchStrategy !== \"click\") return;\n\n      if (hoverTimer.current !== null) clearTimeout(hoverTimer.current);\n\n      hoverTimer.current = setTimeout(() => {\n        hoverTimer.current = null;\n        doPrefetch(true);\n      }, HOVER_PREFETCH_DELAY_MS);\n    },\n    [prefetchStrategy, doPrefetch, onMouseEnter],\n  );\n\n  const handleMouseLeave = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onMouseLeave?.(e);\n\n      // Never fired: the pointer passed over on its way somewhere else.\n      if (hoverTimer.current !== null) {\n        clearTimeout(hoverTimer.current);\n        hoverTimer.current = null;\n      }\n\n      // Already in flight: give the connection back to whatever the pointer is\n      // heading for. A prefetch that has landed is kept — see cancelPrefetch.\n      if (isExternalUrl(href)) return;\n      (window as any).__rsc_cancel_prefetch?.(href);\n    },\n    [href, onMouseLeave],\n  );\n\n  // Touch gets no delay. There is no hovering to disambiguate — a touch is\n  // already the start of a tap — and touchstart leads the click by little\n  // enough that spending any of it waiting would waste the head start.\n  //\n  // And it decodes: the viewport prefetch that came before it, if one did,\n  // fetched the bytes and left the chunks for the tap. This is the tap.\n  const handleTouchStart = useCallback(() => {\n    if (prefetchStrategy === \"hover\" || prefetchStrategy === \"click\") {\n      doPrefetch(true);\n    }\n  }, [prefetchStrategy, doPrefetch]);\n\n  // A press is a click 60-100 ms from landing, and a quick one comes before\n  // the hover has settled. Whatever the hover did not, this does; whatever\n  // it did, this finds done.\n  const handleMouseDown = useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onMouseDown?.(e);\n\n      if (e.button !== 0) return;\n      if (prefetchStrategy === \"hover\" || prefetchStrategy === \"click\") doPrefetch(true);\n    },\n    [prefetchStrategy, doPrefetch, onMouseDown],\n  );\n\n  // A link unmounted mid-hover (navigating away) must not prefetch afterwards.\n  useEffect(\n    () => () => {\n      if (hoverTimer.current !== null) clearTimeout(hoverTimer.current);\n    },\n    [],\n  );\n\n  return (\n    <LinkStatusContext.Provider value={{ pending }}>\n      <a\n        // The caller's ref still fills: a dialog moving focus to its link\n        // needs the element as much as the observer above does.\n        ref={(node) => {\n          anchor.current = node;\n\n          if (typeof callerRef === \"function\") callerRef(node);\n          else if (callerRef) (callerRef as { current: HTMLAnchorElement | null }).current = node;\n        }}\n        href={href}\n        // The mark the bootstrap script's click listener looks for: a tap\n        // on this before the router exists is held for it. See earlyClicks.\n        data-rsc=\"\"\n        onClick={handleClick}\n        onMouseEnter={handleMouseEnter}\n        onMouseLeave={handleMouseLeave}\n        onTouchStart={handleTouchStart}\n        onMouseDown={handleMouseDown}\n        data-pending={pending ? \"\" : undefined}\n        {...rest}\n      >\n        {children}\n      </a>\n    </LinkStatusContext.Provider>\n  );\n}\n"]}

package/dist/js/PageTransition.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+/**
+ * Whether this browser rasterises a transition snapshot at full element
+ * height. Apple's vendor string is WebKit's, wherever WebKit runs: Safari,
+ * every iOS browser, and WebKitGTK (Epiphany) too - all of them charge by
+ * snapshot size, so all of them are right to skip. Not a bug to "fix".
+ */
+export declare function snapshotsWholePage(): boolean;
+/** Whether the visitor asked for no motion; a transition then costs a snapshot for nothing. */
+export declare function prefersReducedMotion(): boolean;
+/** The rules a page fade needs, for the class the navigation carries. */
+export declare function pageTransitionCss(transition: string, durationMs: number): string;
+export declare function PageTransition({ children, className, transition, duration, webkit, }: {
+    children: ReactNode;
+    /** On the wrapper element the pair is made of; carry the body's layout here. */
+    className?: string;
+    /** The view-transition class a navigation gets, for CSS of your own on top. */
+    transition?: string;
+    /** How long the fade runs, in milliseconds. The group and root pairs match it. */
+    duration?: number;
+    /**
+     * What WebKit gets. `skip` for an app with long pages - the default,
+     * since a landing page usually is one; `run` for an app whose pages are
+     * a screen tall, where the snapshot is small and the fade is fine.
+     */
+    webkit?: "skip" | "run";
+}): import("react").JSX.Element;

package/dist/js/PageTransition.js

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The page-level view transition, with WebKit left out of it.
+ *
+ * WebKit - Safari, and every browser on iOS, Chrome included - rasterises
+ * the outgoing snapshot at the element's full height rather than the
+ * viewport's. A landing page 12,000 px tall is 44 megapixels at 3×: a port
+ * measured 600-900 ms with the screen frozen on every navigation away from
+ * it, and the memory can have iOS discard the tab, which comes back as a
+ * reload nobody asked for. Chromium caps the snapshot, so a desktop never
+ * shows it. Other sites' transitions work on the same phone because they
+ * name the root, which the spec clips to the viewport; React's
+ * <ViewTransition> names the element it wraps, and the page is tall.
+ *
+ * So the cross-fade runs where it is cheap and is skipped where it is not.
+ * Decided after mount, from navigator.vendor - a server render has no
+ * navigator, and a transition class only matters on an update, so the
+ * first render agrees with the server either way. Skipped, React starts
+ * no transition at all: no snapshot, no overlay, nothing to wait for.
+ *
+ * The CSS the fade needs travels with it, because every app rediscovered
+ * the same three lines on a phone: the group and root pairs keep the
+ * browser's 250 ms whatever the page pair is set to, so a "120 ms" fade
+ * ran 290; the pseudo-element tree sits over the document while it runs
+ * and swallows a second tap; and reduced motion should mean none.
+ */
+import { ViewTransition, useEffect, useState } from "react";
+/**
+ * Whether this browser rasterises a transition snapshot at full element
+ * height. Apple's vendor string is WebKit's, wherever WebKit runs: Safari,
+ * every iOS browser, and WebKitGTK (Epiphany) too - all of them charge by
+ * snapshot size, so all of them are right to skip. Not a bug to "fix".
+ */
+export function snapshotsWholePage() {
+    return typeof navigator !== "undefined" && navigator.vendor === "Apple Computer, Inc.";
+}
+/** Whether the visitor asked for no motion; a transition then costs a snapshot for nothing. */
+export function prefersReducedMotion() {
+    return typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/** The rules a page fade needs, for the class the navigation carries. */
+export function pageTransitionCss(transition, durationMs) {
+    return (`::view-transition-old(.${transition}),::view-transition-new(.${transition}),` +
+        `::view-transition-group(*),::view-transition-old(root),::view-transition-new(root){animation-duration:${durationMs}ms}` +
+        `::view-transition{pointer-events:none}` +
+        `@media (prefers-reduced-motion:reduce){::view-transition-old(*),::view-transition-new(*),::view-transition-group(*){animation:none}}`);
+}
+export function PageTransition({ children, className, transition = "page", duration = 120, webkit = "skip", }) {
+    const [skip, setSkip] = useState(false);
+    useEffect(() => {
+        if ((webkit === "skip" && snapshotsWholePage()) || prefersReducedMotion())
+            setSkip(true);
+    }, [webkit]);
+    return (_jsx(ViewTransition, { default: { "rsc-navigation": skip ? "none" : transition, default: "none" }, children: _jsxs("div", { className: className, children: [_jsx("style", { href: `rsc-kit-page-transition-${transition}`, precedence: "rsc-kit", children: pageTransitionCss(transition, duration) }), children] }) }));
+}
+//# sourceMappingURL=PageTransition.js.map

package/dist/js/PageTransition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageTransition.js","sourceRoot":"","sources":["../../src/js/PageTransition.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,MAAM,KAAK,sBAAsB,CAAC;AACzF,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AACnJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,UAAkB;IACtE,OAAO,CACL,0BAA0B,UAAU,4BAA4B,UAAU,IAAI;QAC9E,yGAAyG,UAAU,KAAK;QACxH,wCAAwC;QACxC,sIAAsI,CACvI,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,UAAU,GAAG,MAAM,EACnB,QAAQ,GAAG,GAAG,EACd,MAAM,GAAG,MAAM,GAehB;IACC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,kBAAkB,EAAE,CAAC,IAAI,oBAAoB,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,CACL,KAAC,cAAc,IAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,YACxF,eAAK,SAAS,EAAE,SAAS,aACvB,gBAAO,IAAI,EAAE,2BAA2B,UAAU,EAAE,EAAE,UAAU,EAAC,SAAS,YACvE,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,GAClC,EACP,QAAQ,IACL,GACS,CAClB,CAAC;AACJ,CAAC","sourcesContent":["\"use client\";\n\n/**\n * The page-level view transition, with WebKit left out of it.\n *\n * WebKit - Safari, and every browser on iOS, Chrome included - rasterises\n * the outgoing snapshot at the element's full height rather than the\n * viewport's. A landing page 12,000 px tall is 44 megapixels at 3×: a port\n * measured 600-900 ms with the screen frozen on every navigation away from\n * it, and the memory can have iOS discard the tab, which comes back as a\n * reload nobody asked for. Chromium caps the snapshot, so a desktop never\n * shows it. Other sites' transitions work on the same phone because they\n * name the root, which the spec clips to the viewport; React's\n * <ViewTransition> names the element it wraps, and the page is tall.\n *\n * So the cross-fade runs where it is cheap and is skipped where it is not.\n * Decided after mount, from navigator.vendor - a server render has no\n * navigator, and a transition class only matters on an update, so the\n * first render agrees with the server either way. Skipped, React starts\n * no transition at all: no snapshot, no overlay, nothing to wait for.\n *\n * The CSS the fade needs travels with it, because every app rediscovered\n * the same three lines on a phone: the group and root pairs keep the\n * browser's 250 ms whatever the page pair is set to, so a \"120 ms\" fade\n * ran 290; the pseudo-element tree sits over the document while it runs\n * and swallows a second tap; and reduced motion should mean none.\n */\n\nimport { ViewTransition, useEffect, useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\n/**\n * Whether this browser rasterises a transition snapshot at full element\n * height. Apple's vendor string is WebKit's, wherever WebKit runs: Safari,\n * every iOS browser, and WebKitGTK (Epiphany) too - all of them charge by\n * snapshot size, so all of them are right to skip. Not a bug to \"fix\".\n */\nexport function snapshotsWholePage(): boolean {\n  return typeof navigator !== \"undefined\" && navigator.vendor === \"Apple Computer, Inc.\";\n}\n\n/** Whether the visitor asked for no motion; a transition then costs a snapshot for nothing. */\nexport function prefersReducedMotion(): boolean {\n  return typeof window !== \"undefined\" && typeof window.matchMedia === \"function\" && window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n}\n\n/** The rules a page fade needs, for the class the navigation carries. */\nexport function pageTransitionCss(transition: string, durationMs: number): string {\n  return (\n    `::view-transition-old(.${transition}),::view-transition-new(.${transition}),` +\n    `::view-transition-group(*),::view-transition-old(root),::view-transition-new(root){animation-duration:${durationMs}ms}` +\n    `::view-transition{pointer-events:none}` +\n    `@media (prefers-reduced-motion:reduce){::view-transition-old(*),::view-transition-new(*),::view-transition-group(*){animation:none}}`\n  );\n}\n\nexport function PageTransition({\n  children,\n  className,\n  transition = \"page\",\n  duration = 120,\n  webkit = \"skip\",\n}: {\n  children: ReactNode;\n  /** On the wrapper element the pair is made of; carry the body's layout here. */\n  className?: string;\n  /** The view-transition class a navigation gets, for CSS of your own on top. */\n  transition?: string;\n  /** How long the fade runs, in milliseconds. The group and root pairs match it. */\n  duration?: number;\n  /**\n   * What WebKit gets. `skip` for an app with long pages - the default,\n   * since a landing page usually is one; `run` for an app whose pages are\n   * a screen tall, where the snapshot is small and the fade is fine.\n   */\n  webkit?: \"skip\" | \"run\";\n}) {\n  const [skip, setSkip] = useState(false);\n\n  useEffect(() => {\n    if ((webkit === \"skip\" && snapshotsWholePage()) || prefersReducedMotion()) setSkip(true);\n  }, [webkit]);\n\n  return (\n    <ViewTransition default={{ \"rsc-navigation\": skip ? \"none\" : transition, default: \"none\" }}>\n      <div className={className}>\n        <style href={`rsc-kit-page-transition-${transition}`} precedence=\"rsc-kit\">\n          {pageTransitionCss(transition, duration)}\n        </style>\n        {children}\n      </div>\n    </ViewTransition>\n  );\n}\n"]}

package/dist/js/SegmentBoundary.js

@@ -44,6 +44,7 @@ const addTransitionType = React.addTransitionType ??
     React
         .unstable_addTransitionType;
 import { RedirectBoundary } from "./RedirectBoundary";
+import { navigationCommitted } from "./perf";
 import { getSegmentState, navigatedOnce, seedSegment, subscribeToSegment, } from "./segmentStore";
 export function SegmentBoundary({ depth, pageKey, children, }) {
     // The store still addresses the boundary; the render reads React state, so
@@ -60,6 +61,13 @@ export function SegmentBoundary({ depth, pageKey, children, }) {
             setState(getSegmentState(depth));
         });
     }), [depth]);
+    // The commit that put a navigated segment on screen: the end of the
+    // navigation's measure, see perf.ts. Not on the first render, which is the
+    // seed.
+    useEffect(() => {
+        if (state !== null)
+            navigationCommitted();
+    }, [state]);
     // Record the page we arrived on, so a later navigation away and back can
     // return to it. Without this the first page is the one page you cannot keep.
     useEffect(() => {

package/dist/js/SegmentBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentBoundary.js","sourceRoot":"","sources":["../../src/js/SegmentBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAE3D,4EAA4E;AAC5E,yEAAyE;AACzE,uDAAuD;AACvD,MAAM,iBAAiB,GACpB,KAAwD,CAAC,iBAAiB;IAC1E,KAAiE;SAC/D,0BAA0B,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,EACP,QAAQ,GAMT;IACC,2EAA2E;IAC3E,2EAA2E;IAC3E,+DAA+D;IAC/D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqC,GAAG,EAAE,CAC1E,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAC9D,CAAC;IAEF,SAAS,CACP,GAAG,EAAE,CACH,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE;QAC7B,eAAe,CAAC,GAAG,EAAE;YACnB,+DAA+D;YAC/D,gEAAgE;YAChE,sBAAsB;YACtB,IAAI,aAAa,EAAE;gBAAE,iBAAiB,EAAE,CAAC,0BAA0B,CAAC,CAAC;YAErE,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,EACJ,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,yEAAyE;IACzE,6EAA6E;IAC7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO;YAAE,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,0EAA0E;IAC1E,QAAQ;IACR,wEAAwE;IACxE,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,qEAAqE;IACrE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,OAAO,CAAC,CAAC,CAAC,CACf,KAAC,QAAQ,IAAe,IAAI,EAAC,SAAS,YACpC,KAAC,gBAAgB,cAAE,QAAQ,GAAoB,IADlC,OAAO,CAEX,CACZ,CAAC,CAAC,CAAC,CACF,KAAC,gBAAgB,cAAE,QAAQ,GAAoB,CAChD,CAAC;IACJ,CAAC;IAED,OAAO,CACL,4BACG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5B,KAAC,QAAQ,IAEP,IAAI,EAAE,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,YAE1D,KAAC,gBAAgB,IAAC,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,YACpD,KAAK,CAAC,IAAiB,GACP,IALd,KAAK,CAAC,GAAG,CAML,CACZ,CAAC,GACD,CACJ,CAAC;AACJ,CAAC","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 {\n  getSegmentState,\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  // 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  useEffect(() => {\n    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  if (!state) {\n    return pageKey ? (\n      <Activity key={pageKey} mode=\"visible\">\n        <RedirectBoundary>{children}</RedirectBoundary>\n      </Activity>\n    ) : (\n      <RedirectBoundary>{children}</RedirectBoundary>\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 { navigationCommitted } from \"./perf\";\nimport {\n  getSegmentState,\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  useEffect(() => {\n    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  if (!state) {\n    return pageKey ? (\n      <Activity key={pageKey} mode=\"visible\">\n        <RedirectBoundary>{children}</RedirectBoundary>\n      </Activity>\n    ) : (\n      <RedirectBoundary>{children}</RedirectBoundary>\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"]}

package/dist/js/navigate.d.ts

@@ -107,7 +107,20 @@ export declare function applyRevalidated(target: string, tree: ReactNode): void;
  * count living in a layout will not move until you ask for 'all'.
  */
 export declare function refresh(target?: string): Promise<void>;
-export declare function prefetch(url: string, cacheForMs?: number): void;
+/**
+ * Fetch a page's payload ahead of the navigation that may ask for it.
+ *
+ * `intent` is the difference between a link that came into view and one the
+ * visitor is about to follow: a hover that settled, a touch. Only then is the
+ * payload decoded on arrival - decoding is what loads the client chunks the
+ * page names, and a viewport prefetch that decoded put the sign-in page's
+ * thirty chunks onto a landing page for every phone visitor. A touch leads
+ * its click by 100-300 ms, about a round trip, and a tap that found the
+ * bytes here but not the chunks spent that round trip after the click
+ * instead of before it: the tap-to-paint that was "not zero" beside Next,
+ * whose prefetch decodes as it lands.
+ */
+export declare function prefetch(url: string, cacheForMs?: number, intent?: boolean): void;
 /**
  * Drop a prefetch that is still in flight — the pointer left the link.
  *

package/dist/js/navigate.js

@@ -7,6 +7,7 @@
  */
 import { isStaleAssetError, loadDocumentOnce } from "./staleAssets";
 import { isUpdated, markStale } from "./updateStore";
+import { navigationAbandoned, navigationCommitted, navigationReached, navigationStarted } from "./perf";
 import { isSafeRedirect } from "../safeUrl.js";
 import { reportReachable } from "./onlineStore";
 import { clearSlots, setSlot } from "./slotStore";
@@ -61,6 +62,16 @@ let interceptedAtDepth = null;
  */
 let interceptedOver = null;
 const DEFAULT_PREFETCH_TTL = 30_000;
+/**
+ * How long a payload the host marked `public` is kept.
+ *
+ * The same build-time bytes for everyone, so the only way it changes is a
+ * deploy, and the version handshake catches that on the tap. Thirty seconds
+ * was Next's figure for a dynamic page; its static pages are held five
+ * minutes, and a landing page read for a minute before the tap on Sign in
+ * was, at thirty, an expired entry and a round trip on a phone.
+ */
+const STATIC_PREFETCH_TTL = 300_000;
 /**
  * How many prefetched payloads are kept. Entries carry a TTL but were only
  * dropped when read again, so a long session hovering its way through a big
@@ -504,6 +515,7 @@ export async function navigate(url, opts) {
     }
     // Abort any in-flight navigation
     activeController?.abort();
+    navigationStarted(url);
     // Not window.stop(). It used to be called here while the document was
     // still loading, to free a single-threaded server for the new request -
     // and it cancels every load the page has in flight: the client chunks a
@@ -546,6 +558,7 @@ export async function navigate(url, opts) {
             history.pushState({ rscUrl: url }, "", url);
         }
         window.dispatchEvent(new CustomEvent("rsc-navigate", { detail: url }));
+        navigationCommitted();
         return;
     }
     // Not when the target is the page already showing: asking for this page
@@ -580,6 +593,7 @@ export async function navigate(url, opts) {
             history.pushState({ rscUrl: url }, "", url);
         }
         window.dispatchEvent(new CustomEvent("rsc-navigate", { detail: url }));
+        navigationCommitted();
         return;
     }
     // A prefetched payload was rendered against the chain held at prefetch time.
@@ -673,6 +687,7 @@ export async function navigate(url, opts) {
         let tree;
         try {
             tree = await treePromise;
+            navigationReached("decoded");
         }
         catch (error) {
             // A navigation another one overtook: its request was aborted, and
@@ -729,6 +744,7 @@ export async function navigate(url, opts) {
         clearSlots();
         interceptedOver = null;
         interceptedAtDepth = interceptSlot ? segmentDepth : null;
+        navigationReached("applied");
         onNavigate?.(tree, activityKey, segmentDepth);
         if (!opts?.preserveScroll && !interceptSlot) {
             // Wait for React to commit the DOM update before scrolling.
@@ -740,6 +756,7 @@ export async function navigate(url, opts) {
         window.dispatchEvent(new CustomEvent("rsc-navigate", { detail: url }));
     }
     catch (err) {
+        navigationAbandoned();
         if (err instanceof DOMException && err.name === "AbortError")
             return;
         // A chunk the deploy no longer serves: the browser would have loaded the
@@ -903,7 +920,20 @@ function restoreScroll(positions) {
     };
     apply(1);
 }
-export function prefetch(url, cacheForMs) {
+/**
+ * Fetch a page's payload ahead of the navigation that may ask for it.
+ *
+ * `intent` is the difference between a link that came into view and one the
+ * visitor is about to follow: a hover that settled, a touch. Only then is the
+ * payload decoded on arrival - decoding is what loads the client chunks the
+ * page names, and a viewport prefetch that decoded put the sign-in page's
+ * thirty chunks onto a landing page for every phone visitor. A touch leads
+ * its click by 100-300 ms, about a round trip, and a tap that found the
+ * bytes here but not the chunks spent that round trip after the click
+ * instead of before it: the tap-to-paint that was "not zero" beside Next,
+ * whose prefetch decodes as it lands.
+ */
+export function prefetch(url, cacheForMs, intent = false) {
     // Never a route.ts: fetching one runs it, and a hover is not a click.
     if (isApiRoute(url))
         return;
@@ -920,20 +950,31 @@ export function prefetch(url, cacheForMs) {
         return;
     const ttl = cacheForMs ?? DEFAULT_PREFETCH_TTL;
     const interceptSlot = matchIntercept(url);
+    const held = { intent, explicitTtl: cacheForMs !== undefined };
     if (interceptSlot) {
         // Intercepted route — only prefetch the intercepted variant
         const currentUrl = window.location.pathname + window.location.search;
         const cacheKey = retentionKeyFor(url, interceptSlot);
-        prefetchUrl(cacheKey, url, ttl, interceptSlot, currentUrl);
+        prefetchUrl(cacheKey, url, ttl, interceptSlot, currentUrl, held);
     }
     else {
-        prefetchUrl(url, url, ttl);
+        prefetchUrl(url, url, ttl, undefined, undefined, held);
     }
 }
-function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl) {
+/** Decode a held payload now, so the chunks it names are loading before the tap. */
+function warm(entry) {
+    // 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(() => { });
+}
+function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl, held = { intent: false, explicitTtl: false }) {
     const chain = claimedChain(interceptSlot ?? null);
     const existing = cache.get(cacheKey);
     if (existing && existing.expiresAt > Date.now()) {
+        // Fetched as it came into view, undecoded; the touch says decode it.
+        if (held.intent)
+            warm(existing);
         return;
     }
     // A navigation is already fetching it; the answer is on its way.
@@ -994,7 +1035,15 @@ function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl) {
         else if (local) {
             entry.layouts = local.chain;
         }
-        // The bytes, not the page: decoding is the navigation's, see CacheEntry.
+        // Marked public: the build's bytes, the same for everyone, and held
+        // for as long as Next holds a static page - unless the link said how
+        // long. A deploy is caught by the version handshake, not by the clock.
+        if (!held.explicitTtl &&
+            /\bpublic\b/.test(response.headers.get("Cache-Control") ?? "")) {
+            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();
     })
         .catch(() => {
@@ -1010,6 +1059,8 @@ function prefetchUrl(cacheKey, url, ttl, interceptSlot, refererUrl) {
         }
     });
     cache.set(cacheKey, entry);
+    if (held.intent)
+        warm(entry);
 }
 /**
  * Drop a prefetch that is still in flight — the pointer left the link.