@rangojs/router 0.32.0 → 0.33.0

package/dist/types/types/loader-types.d.ts

@@ -182,10 +182,13 @@ export type LoaderFn<T, TParams = Record<string, string | undefined>, TEnv = Def
 export type LoaderOptions = {
     ssr?: boolean;
     /**
-     * `prefetch: false` keeps this loader out of prefetches. A `<Link>`
-     * prefetch (a partial request with `X-Rango-Prefetch`) does not execute it;
-     * the payload marks it deferred. A document request and a navigation with
-     * no prefetch to adopt run it as usual.
+     * `prefetch: false` keeps this loader out of speculative prefetches. A
+     * viewport or render `<Link>` prefetch (a partial request with
+     * `X-Rango-Prefetch: 1`) does not execute it; the payload marks it
+     * deferred. A hover prefetch and `useRouter().prefetch()`
+     * (`X-Rango-Prefetch: intent`) count as intent to click and run it, so a
+     * click after a hover needs no follow-up request. A document request and a
+     * navigation with no prefetch to adopt run it as usual.
      *
      * A deferred loader never blocks the navigation that adopts the prefetch:
      * it behaves like a loader that is still streaming. Its own `<Suspense>`

package/dist/types/types/segments.d.ts

@@ -147,7 +147,6 @@ export interface ResolvedSegment {
     layoutName?: string;
     parallelName?: string;
     loaderId?: string;
-    _inherited?: boolean;
     loaderData?: any;
     /**
      * True when this loader was awaited before first flush
@@ -276,10 +275,22 @@ export interface MatchResult {
     interceptTargeted?: true;
     /**
      * Set on a partial match when a revalidate() predicate read the source page
-     * and kept a held segment: the diff is that source's. The RSC handler
-     * scopes its prefetch entry to it, like `interceptTargeted` (#1331).
+     * and kept a held segment: the diff is right for the pages with equal values
+     * of what it read. The RSC handler scopes its prefetch entry to that group,
+     * or to the source page when the predicate read `currentUrl` (#1331).
      */
-    sourceHeld?: true;
+    sourceHeld?: import("../router/source-reads.js").SourceHeld;
+    /**
+     * Set on a partial match whose answer has nothing live in it: the cache
+     * lookup served it (a cache() record, a Prerender entry, a shell replay's
+     * record, not a stale cache() record or stale overlay entry), it sends a
+     * segment, every segment it
+     * sends is one that lookup decoded, and no loader ran. A stored segment
+     * cannot fail after the headers left, since every writer refuses a failed
+     * render; a live segment or a loader can. The RSC handler marks the request
+     * `_servedFromStorage` from it.
+     */
+    fromStorage?: true;
     /**
      * Redirect URL for trailing slash normalization.
      * When set, the RSC handler should return a 308 redirect to this URL

package/dist/types/urls/path-helper-types.d.ts

@@ -161,9 +161,10 @@ export type PathHelpers<TEnv> = {
      * freezes into the shell (nested promises stay live holes) — the pre-flush
      * promise applied to the prelude.
      *
-     * Pass `{ prefetch: false }` to keep the loader out of prefetches: a
-     * prefetch skips it and the click that adopts the prefetch fetches it in
-     * one follow-up request (see {@link LoaderOptions}). Only on a segment the
+     * Pass `{ prefetch: false }` to keep the loader out of speculative
+     * prefetches (viewport, render): such a prefetch skips it and the click
+     * that adopts it fetches it in one follow-up request; a hover prefetch runs
+     * it (see {@link LoaderOptions}). Only on a segment the
      * client does not have yet: a loader the client already holds runs in the
      * prefetch when it revalidates.
      */
@@ -172,8 +173,9 @@ export type PathHelpers<TEnv> = {
      * Attach a loading component to the current route/layout.
      *
      * `{ ssr: false }` skips the fallback on document requests. `{ prefetch:
-     * false }` keeps what the fallback covers out of prefetches, when this
-     * entry's segment is new to the client: the entry's handler, its loaders,
+     * false }` keeps what the fallback covers out of viewport and render
+     * prefetches (a hover prefetch runs it), when this entry's segment is new
+     * to the client: the entry's handler, its loaders,
      * its orphan layouts and parallel slots and, for a layout, every deeper
      * entry. The click that adopts the prefetch shows the fallback and fetches
      * them in one follow-up request, which reads cache() and "use cache" as

package/dist/types/vite/temp-rsc-server.d.ts

@@ -7,8 +7,8 @@
  *
  * Sits in src/vite/, not src/vite/discovery/: the loader hook URL below
  * resolves against this module's import.meta.url, and the published bundles
- * (dist/vite/index.js, dist/bin/rango.js) ship the hook at the same relative
- * path.
+ * (dist/vite/index.js, and the CLI's code-split chunks in dist/bin/) ship the
+ * hook at the same relative path.
  */
 import type { ViteDevServer } from "vite";
 import type { DiscoveryState } from "./discovery/state.js";