@rangojs/router 0.26.6 → 0.28.0

package/dist/types/vite/router-discovery.d.ts

@@ -2,55 +2,16 @@
  * Router Discovery Plugin
  *
  * Vite plugin that discovers router instances at dev/build time via the RSC
- * environment. Delegates to extracted modules for discovery, route types
- * generation, virtual module codegen, and bundle post-processing.
+ * environment. Its hooks call the phase modules over one DiscoveryState:
+ * discovery/dev-server-phase.ts (configureServer),
+ * discovery/build-discovery-phase.ts (buildStart, buildApp post, buildEnd) and
+ * discovery/bundle-scan-phase.ts (generateBundle). Route types generation,
+ * virtual module codegen and bundle post-processing live in their own
+ * discovery/ modules.
  */
-import type { Plugin, ViteDevServer } from "vite";
-import { VIRTUAL_ROUTES_MANIFEST_ID, type DiscoveryState, type PluginOptions } from "./discovery/state.js";
+import type { Plugin } from "vite";
+import { VIRTUAL_ROUTES_MANIFEST_ID, type PluginOptions } from "./discovery/state.js";
 export { VIRTUAL_ROUTES_MANIFEST_ID };
-/** The slice of a Vite environment module graph the route-file watcher reads. */
-interface ModulesByFileGraph {
-    getModulesByFile(file: string): ReadonlySet<unknown> | undefined;
-}
-/**
- * Whether the dev route-file watcher ignores `file`: it sits in a directory
- * every discovery scan skips (isInSkippedScanDir) and the RSC graph has not
- * loaded it. See docs/manifests.md, "A reload no file of the app asked for".
- */
-export declare function isFileOutsideApp(root: string, file: string, rscGraph: ModulesByFileGraph | undefined): boolean;
-/**
- * Create a minimal Vite server for router discovery.
- *
- * Both dev-mode prerender and build-mode discovery need a temp RSC server
- * to import user router files via module runner. This factory centralizes
- * the shared config and the mode-specific differences:
- * - Dev: path-based IDs (no forceBuild), separate cacheDir
- * - Build: hashed IDs (forceBuild), hashClientRefs for production bundles
- *
- * Returns the ViteDevServer instance. Callers access .environments.rsc as needed.
- * @internal Exported for tests.
- */
-export declare function createTempRscServer(state: DiscoveryState, options?: {
-    forceBuild?: boolean;
-    cacheDir?: string;
-    /**
-     * Serve the REAL rango SSR entry (getVirtualEntrySSR) for
-     * "virtual:entry-ssr" instead of the discovery stub, so the dev
-     * /__rsc_shell endpoint can drive captureShellHTML in this server's SSR
-     * realm. Dev-correct by construction: the entry's bootstrap resolves to
-     * plugin-rsc's stable virtual browser-entry URL, which the MAIN dev
-     * server serves to the browser. Loaded lazily — discovery never imports
-     * the SSR entry, so the temp server stays as light as before until a
-     * shell capture actually runs.
-     */
-    realSsrEntry?: boolean;
-}): Promise<ViteDevServer>;
-import type { BuildEnvOption, BuildEnvFactoryContext, BuildEnvResult } from "./plugin-types.js";
-/**
- * Resolve the buildEnv option into a concrete { env, dispose? } result.
- * Handles all four input shapes: false, "auto", factory, plain object.
- */
-export declare function resolveBuildEnv(option: BuildEnvOption | undefined, factoryCtx: BuildEnvFactoryContext): Promise<BuildEnvResult | null>;
 /**
  * Plugin that discovers router instances at dev/build time via the RSC environment.
  *

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

@@ -0,0 +1,39 @@
+/**
+ * The discovery temp RSC server: a minimal Vite server whose module runner
+ * imports the user's router files. Shared by dev discovery
+ * (discovery/dev-server-phase.ts) and build discovery
+ * (discovery/build-discovery-phase.ts).
+ *
+ * Sits in src/vite/, not src/vite/discovery/: the loader hook URL below
+ * resolves against this module's import.meta.url, and the published bundle
+ * (dist/vite/index.js) ships the hook at the same relative path.
+ */
+import type { ViteDevServer } from "vite";
+import type { DiscoveryState } from "./discovery/state.js";
+/**
+ * Create a minimal Vite server for router discovery.
+ *
+ * Both dev-mode prerender and build-mode discovery need a temp RSC server
+ * to import user router files via module runner. This factory centralizes
+ * the shared config and the mode-specific differences:
+ * - Dev: path-based IDs (no forceBuild), separate cacheDir
+ * - Build: hashed IDs (forceBuild), hashClientRefs for production bundles
+ *
+ * Returns the ViteDevServer instance. Callers access .environments.rsc as needed.
+ * @internal Exported for tests.
+ */
+export declare function createTempRscServer(state: DiscoveryState, options?: {
+    forceBuild?: boolean;
+    cacheDir?: string;
+    /**
+     * Serve the REAL rango SSR entry (getVirtualEntrySSR) for
+     * "virtual:entry-ssr" instead of the discovery stub, so the dev
+     * /__rsc_shell endpoint can drive captureShellHTML in this server's SSR
+     * realm. Dev-correct by construction: the entry's bootstrap resolves to
+     * plugin-rsc's stable virtual browser-entry URL, which the MAIN dev
+     * server serves to the browser. Loaded lazily — discovery never imports
+     * the SSR entry, so the temp server stays as light as before until a
+     * shell capture actually runs.
+     */
+    realSsrEntry?: boolean;
+}): Promise<ViteDevServer>;

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

@@ -1,3 +1,4 @@
+import type { LiveIntercept } from "../../router/prerender-match.js";
 export declare function encodePathParam(value: unknown): string;
 /**
  * `ctx.reverse` of a build-time `getParams()`. Substitutes like the dev-mode
@@ -25,6 +26,14 @@ export declare function notifyOnError(registry: Map<string, any>, error: unknown
  * URL / handler name for the log line; `elapsed` is the per-entry duration string.
  */
 export declare function resolvePrerenderError(registry: Map<string, any>, error: any, onError: "fail" | "warn", label: string, elapsed: string, phase: "prerender" | "static", routeKey?: string, pathname?: string): void;
+/**
+ * Warn once per router, route and slot (`warned` holds the keys already
+ * warned) that an intercept over a Prerender() route renders live: the build
+ * did not bake it (matchForPrerender `liveIntercepts`), so its handler runs
+ * per request and one that needs BuildContext fails there. A route in an
+ * unnamed include() has an internal key; the warning names its URL instead.
+ */
+export declare function warnLiveIntercepts(warned: Set<string>, routerId: string, routeName: string, urlPath: string, liveIntercepts: readonly LiveIntercept[] | undefined): void;
 /** Build scratch space, relative to the project root. Never shipped. */
 export declare const RANGO_BUILD_DIR = "node_modules/.rangojs-router-build";
 export declare function resetStagedBuildAssets(projectRoot: string): void;

package/dist/types/wire-params.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The router's `_rsc_*` query parameter names, shared by the browser and the
+ * server graph (dependency free): the one module that spells them
+ * (tools/check-internals.mjs rule rsc-param-literal). The browser writes the
+ * partial-request set through browser/wire-protocol.ts writePartialParams.
+ */
+export declare const WIRE: {
+    /** A navigation or prefetch: `true`. */
+    readonly partial: "_rsc_partial";
+    /** The mounted segment ids, comma-joined. */
+    readonly segments: "_rsc_segments";
+    /** A JS server action's id, in place of `partial`. */
+    readonly action: "_rsc_action";
+    /** The client's build version (version-mismatch reload). */
+    readonly version: "_rsc_v";
+    /** The client's router id (app-switch reload). */
+    readonly routerId: "_rsc_rid";
+    /** The rewrite target of the page on screen (#1144). */
+    readonly rewriteTarget: "_rsc_rt";
+    /** A stale request: `true` (router/navigation-snapshot.ts). */
+    readonly stale: "_rsc_stale";
+    /** A fill request (docs/design/prefetch-false.md): `1`. */
+    readonly fill: "_rsc_fill";
+    /** A loader fetch's loader id (rsc/loader-fetch.ts). */
+    readonly loader: "_rsc_loader";
+    /** A loader fetch's params, JSON: a query param, or a form field on a POST. */
+    readonly loaderParams: "_rsc_loader_params";
+    /** The forced-MISS marker of a degraded PPR shell reload (rsc/shell-serve.ts). */
+    readonly shellMiss: "_rsc_shell";
+    /** A connection warmup HEAD request (browser/connection-warmup.ts). */
+    readonly warmup: "_rsc_warmup";
+};
+/** The prefix every name in WIRE starts with. */
+export declare const WIRE_PREFIX = "_rsc_";