@rangojs/router 0.24.4 → 0.25.0

package/dist/types/vite/discovery/state.d.ts

@@ -52,7 +52,26 @@ export interface PluginOptions {
      * budget into its capture/render handlers.
      */
     progressiveChunkSize?: number;
+    /**
+     * The index rango()'s clientUrls() revalidate() hoist plugin shares, so
+     * discovery's temp server records keys into it and assigns the files the
+     * dev server's or build's group modules import.
+     */
+    clientUrlRevalidate?: ClientUrlRevalidateIndex;
+}
+/**
+ * What the clientUrls() revalidate() hoist
+ * (plugins/client-urls-revalidate-hoist.ts) shares with discovery across the
+ * plugin instances of one rango(), the dev server or build and discovery's
+ * temp server: the file of every key the hoist transform saw, in any
+ * environment, and each group's files, which discovery assigns from the
+ * group's projection and the group's `?rango-revalidate` module imports.
+ */
+export interface ClientUrlRevalidateIndex {
+    readonly fileByKey: Map<string, string>;
+    readonly filesByGroup: Map<string, readonly string[]>;
 }
+export declare function createClientUrlRevalidateIndex(): ClientUrlRevalidateIndex;
 export interface PrecomputedEntry {
     staticPrefix: string;
     routes: Record<string, string>;
@@ -122,6 +141,7 @@ export interface DiscoveryState {
     perRouterManifestDataMap: Map<string, Record<string, string>>;
     clientUrlSourceByReferenceId?: Map<string, string>;
     clientUrlProjectionMap?: Map<string, ClientUrlProjection>;
+    clientUrlRevalidate: ClientUrlRevalidateIndex;
     prerenderManifestEntries: Record<string, string> | null;
     staticManifestEntries: Record<string, string> | null;
     /**

package/dist/types/vite/plugins/client-urls-revalidate-hoist.d.ts

@@ -1,5 +1,6 @@
 import type { Plugin } from "vite";
 import MagicString from "magic-string";
+import type { ClientUrlRevalidateIndex } from "../discovery/state.js";
 /**
  * The key of the predicate `source` declared in `relativeFile` (relative to
  * the project root): a hash of the file and the predicate's syntax, so the
@@ -26,29 +27,40 @@ interface HoistClientUrlsRevalidateResult {
     readonly keys: readonly string[];
 }
 /**
- * Hoist every clientUrls() `revalidate()` predicate of a "use client"
- * module. Returns null when there is none. Throws, naming file:line, for a
- * predicate that is not pure.
+ * Hoist every clientUrls() `revalidate()` predicate of a module. Returns null
+ * when there is none (boolean literals stay in place). Throws, naming
+ * file:line, for a predicate that is not pure.
  */
 export declare function hoistClientUrlsRevalidates(code: string, id: string, deps: HoistClientUrlsRevalidateDeps): Promise<HoistClientUrlsRevalidateResult | null>;
 /** The file a `?rango-revalidate` id names, or null. */
 export declare function parseHoistedRevalidateId(id: string): string | null;
 /**
  * The plugins: a pre transform that hoists in every environment (markers in
- * the client and SSR copies, the server module recorded from the RSC
- * transform) and serves `?rango-revalidate`, and a post transform that
- * appends its import to the RSC client-reference proxy.
+ * the client and SSR copies, each key's file in `index`, the server module
+ * recorded from the RSC transform, the groups noted) and serves
+ * `?rango-revalidate`, a post transform that appends its import to the RSC
+ * client-reference proxy of each group, and in dev the client's `.use`
+ * update propagation. Pass one `index` to every instance of one rango():
+ * discovery's temp server records keys the dev server or build reads.
  *
- * `load` serves the module the RSC transform emitted, which hoisted the
- * pipeline code; the disk source is re-hoisted only when the transform has
- * not seen the current file (loadEmittedOrDisk). A file whose edit removed
- * every predicate serves an empty module to a proxy that still imports it.
+ * `load` serves the registrations the RSC transform emitted, which hoisted
+ * the pipeline code; the disk source is re-hoisted when the transform has not
+ * seen the current file (loadEmittedOrDisk), which is always the case for a
+ * component module: the RSC environment never transforms a module only a
+ * group imports. A group's module also imports the registrations of the
+ * files discovery assigned it. A file with neither serves an empty module.
  *
- * The transform's code filter skips a module that never mentions clientUrls,
- * so a file that stops doing so would keep its `emitted` entry: watchChange
- * drops it, together with the cached "use client" answer for an edited
- * dependency (isClientModule memoizes per resolved file; buildStart resets
- * it).
+ * A component module that exports only components is a Fast Refresh
+ * boundary, so a `.use` edit would leave the browser's group records stale
+ * (the group never re-evaluates). In dev, an update that changes a module's
+ * componentUseSignature also updates its importers, as a group edit does;
+ * any other edit keeps Fast Refresh.
+ *
+ * The transform's code filter skips a module that names neither clientUrls
+ * nor revalidate, so a file that stops doing so would keep its `emitted`
+ * entry: watchChange drops it, its group mark, and the cached "use client"
+ * answer for an edited dependency (isClientModule memoizes per resolved
+ * file; buildStart resets it).
  */
-export declare function clientUrlsRevalidateHoistPlugin(): Plugin[];
+export declare function clientUrlsRevalidateHoistPlugin(index: ClientUrlRevalidateIndex): Plugin[];
 export {};

package/dist/types/vite/plugins/hoist/source.d.ts

@@ -31,11 +31,12 @@ export interface EmittedEntry<T> {
 }
 export declare function recordEmitted<T>(emitted: Map<string, EmittedEntry<T>>, file: string, value: T): Promise<void>;
 /**
- * What a `?rango-*` load serves for `hoistedFile`: the transform's emission
- * when it saw the current disk source (or the file is gone), else
- * `rehoist(disk)`. The transform hoists the pipeline code, which an earlier
- * plugin may have changed, so re-hoisting the disk source is the fallback only
- * for an environment loading before the RSC transform ran or for an edit the
- * RSC environment has not re-transformed yet. Undefined when neither exists.
+ * What a `?rango-*` load serves for `hoistedFile`, whose source on disk is
+ * `disk` (readSource): the transform's emission when it saw that source (or
+ * the file is gone), else `rehoist(disk)`. The transform hoists the pipeline
+ * code, which an earlier plugin may have changed, so re-hoisting the disk
+ * source is the fallback only for an environment loading before the RSC
+ * transform ran or for an edit the RSC environment has not re-transformed
+ * yet. Undefined when neither exists.
  */
-export declare function loadEmittedOrDisk<T>(emitted: ReadonlyMap<string, EmittedEntry<T>>, hoistedFile: string, rehoist: (disk: string) => Promise<T | undefined>): Promise<T | undefined>;
+export declare function loadEmittedOrDisk<T>(emitted: ReadonlyMap<string, EmittedEntry<T>>, hoistedFile: string, disk: string | null, rehoist: (disk: string) => Promise<T | undefined>): Promise<T | undefined>;

package/dist/types/vite/plugins/virtual-entries.d.ts

@@ -36,6 +36,12 @@ export declare const VIRTUAL_IDS: {
     readonly rsc: "virtual:rsc-router/entry.rsc.js";
     readonly version: "@rangojs/router:version";
 };
+/**
+ * Non-RSC environments (client, ssr) get only PACKAGE_VERSION: the build
+ * module's ROUTER_VERSIONS token is replaced in server chunks only, so a
+ * client import of the full module would throw a ReferenceError.
+ */
+export declare function getVirtualPackageVersionContent(): string;
 /** Dev: one stamp for both versions of every router, bumped on RSC edits. */
 export declare function getVirtualVersionContent(version: string): string;
 /**

package/dist/types/vite/utils/prerender-utils.d.ts

@@ -1,4 +1,11 @@
 export declare function encodePathParam(value: unknown): string;
+/**
+ * `ctx.reverse` of a build-time `getParams()`. Substitutes like the dev-mode
+ * one (`createReverseFunction`, router/prerender-match.ts): a missing required
+ * param throws `Missing param`, with or without a params object, instead of
+ * leaving a literal `:param` in the URL.
+ */
+export declare function createGetParamsReverse(routes: Record<string, string>): (name: string, params?: Record<string, string>) => string;
 export declare function substituteRouteParams(pattern: string, params: Record<string, string>, encode?: (value: string) => string): string;
 export declare function runWithConcurrency<T>(items: T[], concurrency: number, fn: (item: T) => Promise<void>): Promise<void>;
 export declare function groupByConcurrency<T extends {