@rangojs/router 0.0.0-experimental.2 → 0.0.0-experimental.21

package/dist/loader.js

@@ -0,0 +1,20 @@
+/**
+ * rsc-router/loader (client version)
+ *
+ * Client-only stub for createLoader. Returns a minimal loader definition
+ * that can be passed to hooks like useLoader. The actual loader function
+ * is not included - it only exists on the server.
+ *
+ * The $$id is injected by the Vite exposeInternalIds plugin.
+ */
+// Implementation - client stub that just returns the loader definition
+// The $$id parameter is injected by Vite plugin, not user-provided
+export function createLoader(_fn, _fetchable, __injectedId) {
+    // Client only needs the $$id for identification
+    // The actual loader function is only used on the server
+    return {
+        __brand: "loader",
+        $$id: __injectedId || "",
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,uEAAuE;AACvE,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAC1B,GAAyD,EACzD,UAA0C,EAC1C,YAAqB;IAErB,gDAAgD;IAChD,wDAAwD;IACxD,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,YAAY,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/loader.rsc.d.ts

@@ -0,0 +1,19 @@
+/**
+ * rsc-router/loader (RSC/server version)
+ *
+ * Server-side createLoader implementation with full loader functionality.
+ * Only used in react-server context via export conditions.
+ *
+ * For non-fetchable loaders: returns a loader definition with fn included
+ * For fetchable loaders: stores fn in registry and returns a serializable loader with action
+ *
+ * The $$id is injected by the Vite exposeInternalIds plugin as a hidden parameter.
+ * Users don't need to pass any name - IDs are auto-generated from file path.
+ */
+import type { FetchableLoaderOptions, LoaderDefinition, LoaderFn } from "./types.js";
+import { getFetchableLoader } from "./server/fetchable-loader-store.js";
+export { getFetchableLoader };
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>, fetchable: true): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>, options: FetchableLoaderOptions): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+//# sourceMappingURL=loader.rsc.d.ts.map

package/dist/loader.rsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.rsc.d.ts","sourceRoot":"","sources":["../src/loader.rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,GACvD,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAGpE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,EACxD,SAAS,EAAE,IAAI,GACd,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAGpE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,EACxD,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC"}

package/dist/loader.rsc.js

@@ -0,0 +1,99 @@
+/**
+ * rsc-router/loader (RSC/server version)
+ *
+ * Server-side createLoader implementation with full loader functionality.
+ * Only used in react-server context via export conditions.
+ *
+ * For non-fetchable loaders: returns a loader definition with fn included
+ * For fetchable loaders: stores fn in registry and returns a serializable loader with action
+ *
+ * The $$id is injected by the Vite exposeInternalIds plugin as a hidden parameter.
+ * Users don't need to pass any name - IDs are auto-generated from file path.
+ */
+import { getRequestContext } from "./server/request-context.js";
+import { registerFetchableLoader, getFetchableLoader, } from "./server/fetchable-loader-store.js";
+export { getFetchableLoader };
+// Implementation - the $$id parameter is injected by Vite plugin, not user-provided
+export function createLoader(fn, fetchable, 
+// Hidden parameter injected by Vite exposeInternalIds plugin
+__injectedId) {
+    // The $$id will be set on the returned object by Vite plugin
+    // For fetchable loaders, __injectedId is also passed as a parameter
+    const loaderId = __injectedId || "";
+    // If not fetchable, store fn in registry and return a plain object.
+    // Server-side code looks up fn via getFetchableLoader($$id).
+    if (fetchable === undefined) {
+        if (fn && loaderId) {
+            registerFetchableLoader(loaderId, fn, []);
+        }
+        return {
+            __brand: "loader",
+            $$id: loaderId,
+        };
+    }
+    // Fetchable loader - store fn in registry and return a serializable object
+    const middleware = fetchable === true ? [] : fetchable?.middleware || [];
+    // Register the function in the internal registry by $$id (server-side only)
+    // The server action will look it up by $$id when executed
+    if (fn && loaderId) {
+        registerFetchableLoader(loaderId, fn, middleware);
+    }
+    // Create server action for form-based fetching
+    // This action is serializable and can be passed to client components
+    // The loaderId is captured in closure (it's a primitive string)
+    //
+    // IMPORTANT: The signature must be (prevState, formData) for useActionState compatibility.
+    // When used with useActionState, React passes the previous state as the first argument.
+    // The prevState is ignored here since loaders are stateless data fetchers.
+    async function loaderAction(_prevState, formData) {
+        "use server";
+        // Look up the loader from registry by $$id
+        const registered = getFetchableLoader(loaderId);
+        if (!registered) {
+            throw new Error(`Loader "${loaderId}" not found in registry`);
+        }
+        // Get request context (env, request, url, variables) from the RSC handler
+        // This is set by runWithRequestContext in rsc/index.ts when executing actions
+        const requestCtx = getRequestContext();
+        // Convert FormData to params object
+        const params = {};
+        formData.forEach((value, key) => {
+            if (typeof value === "string") {
+                params[key] = value;
+            }
+        });
+        // Use real request/url from context, or fall back to synthetic for edge cases
+        const actionUrl = requestCtx?.url ?? new URL("http://localhost/");
+        const actionRequest = requestCtx?.request ?? new Request(actionUrl, { method: "POST" });
+        const env = requestCtx?.env ?? {};
+        // Merge variables from request context (app-level middleware) with loader-specific variables
+        // requestCtx.var is the shared variables object from the handler
+        const variables = { ...requestCtx?.var };
+        // Execute middleware for auth checks, headers, cookies
+        // Headers/cookies set on ctx.res will be merged into the final response
+        if (registered.middleware.length > 0 && requestCtx?.res) {
+            const { executeServerActionMiddleware } = await import("./router/middleware.js");
+            await executeServerActionMiddleware(registered.middleware, actionRequest, env, params, variables, requestCtx.res);
+        }
+        // Build context using createHandlerContext for consistency with route handlers
+        // Variables are now accessed from request context via getRequestContext()
+        const { createHandlerContext } = await import("./router/handler-context.js");
+        const baseCtx = createHandlerContext(params, actionRequest, actionUrl.searchParams, actionUrl.pathname, actionUrl, env);
+        // Extend with server action specific properties
+        const ctx = {
+            ...baseCtx,
+            method: "POST",
+            formData,
+        };
+        // Execute and return result
+        return registered.fn(ctx);
+    }
+    // Return a plain object with action for form-based fetching.
+    // loaderAction has "use server" so RSC Flight serializes it natively as a server action reference.
+    return {
+        __brand: "loader",
+        $$id: loaderId,
+        action: loaderAction,
+    };
+}
+//# sourceMappingURL=loader.rsc.js.map

package/dist/loader.rsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.rsc.js","sourceRoot":"","sources":["../src/loader.rsc.ts"],"names":[],"mappings":"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"}

package/dist/network-error-thrower.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { NetworkError } from "./errors.js";
+interface NetworkErrorThrowerProps {
+    error: NetworkError;
+}
+/**
+ * Client component that throws a NetworkError during render.
+ * Used to trigger the root error boundary when a network error occurs
+ * during navigation or server actions.
+ *
+ * This must be a separate component because:
+ * 1. Errors must be thrown during React's render phase to be caught by error boundaries
+ * 2. The error occurs in async code (fetch), so we need to propagate it to React's render
+ */
+export declare function NetworkErrorThrower({ error }: NetworkErrorThrowerProps): ReactNode;
+export {};
+//# sourceMappingURL=network-error-thrower.d.ts.map

package/dist/network-error-thrower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-error-thrower.d.ts","sourceRoot":"","sources":["../src/network-error-thrower.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,wBAAwB;IAChC,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE,wBAAwB,GAAG,SAAS,CAElF"}

package/dist/network-error-thrower.js

@@ -0,0 +1,14 @@
+"use client";
+/**
+ * Client component that throws a NetworkError during render.
+ * Used to trigger the root error boundary when a network error occurs
+ * during navigation or server actions.
+ *
+ * This must be a separate component because:
+ * 1. Errors must be thrown during React's render phase to be caught by error boundaries
+ * 2. The error occurs in async code (fetch), so we need to propagate it to React's render
+ */
+export function NetworkErrorThrower({ error }) {
+    throw error;
+}
+//# sourceMappingURL=network-error-thrower.js.map

package/dist/network-error-thrower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-error-thrower.js","sourceRoot":"","sources":["../src/network-error-thrower.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AASb;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,KAAK,EAA4B;IACrE,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/outlet-context.d.ts

@@ -0,0 +1,13 @@
+import { Context, type ReactNode } from "react";
+import type { ResolvedSegment } from "./types";
+export interface OutletContextValue {
+    content: ReactNode;
+    parallel?: ResolvedSegment[];
+    segment?: ResolvedSegment;
+    loaderData?: Record<string, any>;
+    parent?: OutletContextValue | null;
+    /** Loading component for Suspense fallback (from segment's loading() definition) */
+    loading?: ReactNode;
+}
+export declare const OutletContext: Context<OutletContextValue | null>;
+//# sourceMappingURL=outlet-context.d.ts.map

package/dist/outlet-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet-context.d.ts","sourceRoot":"","sources":["../src/outlet-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,oFAAoF;IACpF,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CACb,CAAC"}

package/dist/outlet-context.js

@@ -0,0 +1,3 @@
+import { createContext } from "react";
+export const OutletContext = createContext(null);
+//# sourceMappingURL=outlet-context.js.map

package/dist/outlet-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet-context.js","sourceRoot":"","sources":["../src/outlet-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,aAAa,EAAkB,MAAM,OAAO,CAAC;AAa/D,MAAM,CAAC,MAAM,aAAa,GACxB,aAAa,CAA4B,IAAI,CAAC,CAAC"}

package/dist/prerender/__tests__/param-hash.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=param-hash.test.d.ts.map

package/dist/prerender/__tests__/param-hash.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-hash.test.d.ts","sourceRoot":"","sources":["../../../src/prerender/__tests__/param-hash.test.ts"],"names":[],"mappings":""}

package/dist/prerender/__tests__/param-hash.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect } from "vitest";
+import { hashParams } from "../param-hash.js";
+describe("hashParams", () => {
+    describe("basic functionality", () => {
+        it("should return '_' for empty params", () => {
+            expect(hashParams({})).toBe("_");
+        });
+        it("should return a hash for a single param", () => {
+            const result = hashParams({ id: "42" });
+            expect(result).not.toBe("_");
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+        });
+        it("should return a hash for multiple params", () => {
+            const result = hashParams({ slug: "hello", locale: "en" });
+            expect(result).not.toBe("_");
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+        });
+    });
+    describe("hash format", () => {
+        it("should produce an 8-character lowercase hex string", () => {
+            const result = hashParams({ key: "value" });
+            expect(result).toHaveLength(8);
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+        });
+        it("should produce an 8-char hex string even for short input", () => {
+            const result = hashParams({ a: "b" });
+            expect(result).toHaveLength(8);
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+        });
+    });
+    describe("deterministic ordering", () => {
+        it("should produce the same hash regardless of insertion order", () => {
+            const hash1 = hashParams({ a: "1", b: "2", c: "3" });
+            const hash2 = hashParams({ c: "3", a: "1", b: "2" });
+            const hash3 = hashParams({ b: "2", c: "3", a: "1" });
+            expect(hash1).toBe(hash2);
+            expect(hash2).toBe(hash3);
+        });
+        it("should produce the same hash for two-param objects in any order", () => {
+            const hash1 = hashParams({ slug: "post", lang: "en" });
+            const hash2 = hashParams({ lang: "en", slug: "post" });
+            expect(hash1).toBe(hash2);
+        });
+    });
+    describe("distinct inputs produce different hashes", () => {
+        it("should produce different hashes for different values", () => {
+            const hash1 = hashParams({ id: "1" });
+            const hash2 = hashParams({ id: "2" });
+            expect(hash1).not.toBe(hash2);
+        });
+        it("should produce different hashes for different keys", () => {
+            const hash1 = hashParams({ a: "x" });
+            const hash2 = hashParams({ b: "x" });
+            expect(hash1).not.toBe(hash2);
+        });
+        it("should produce different hashes for different param counts", () => {
+            const hash1 = hashParams({ a: "1" });
+            const hash2 = hashParams({ a: "1", b: "2" });
+            expect(hash1).not.toBe(hash2);
+        });
+    });
+    describe("delimiter encoding prevents collisions", () => {
+        // Fixed P0-3: keys and values are now URL-encoded before joining,
+        // so structurally different params produce different hash inputs.
+        it("should produce different hashes for value containing & vs separate params", () => {
+            const singleParam = hashParams({ a: "1&b=2" });
+            const twoParams = hashParams({ a: "1", b: "2" });
+            expect(singleParam).not.toBe(twoParams);
+        });
+        it("should produce different hashes when key contains '='", () => {
+            const equalsInKey = hashParams({ "a=1": "x" });
+            const equalsInValue = hashParams({ a: "1=x" });
+            expect(equalsInKey).not.toBe(equalsInValue);
+        });
+        it("should produce different hashes when value contains '&'", () => {
+            const ampInValue = hashParams({ a: "x&b=y" });
+            const separateParams = hashParams({ a: "x", b: "y" });
+            expect(ampInValue).not.toBe(separateParams);
+        });
+    });
+    describe("localeCompare non-determinism", () => {
+        // BUG P1-10: localeCompare varies across runtimes and locales.
+        // Byte-order (< operator) comparison should be used instead to
+        // guarantee identical sort order in Node.js, Workers, and browsers.
+        it("should sort by byte order, not locale-dependent order", () => {
+            // In many locales, localeCompare treats uppercase and lowercase
+            // as equivalent or sorts them differently than codepoint order.
+            // Codepoint order: 'A' (65) < 'Z' (90) < 'a' (97) < 'z' (122)
+            // Some locales: 'a' < 'A' < 'b' < 'B' (case-interleaved)
+            const hash1 = hashParams({ Z: "1", a: "2" });
+            const hash2 = hashParams({ a: "2", Z: "1" });
+            // Both should produce the same hash regardless of insertion order.
+            // This passes because localeCompare at least agrees on basic ASCII
+            // letter ordering within a single runtime.
+            expect(hash1).toBe(hash2);
+        });
+        it("should produce consistent sort order for non-ASCII keys", () => {
+            // localeCompare may sort accented characters differently depending
+            // on the runtime locale. Byte-order comparison would use codepoint
+            // values and be deterministic across all environments.
+            // e.g., in Swedish locale, a-ring sorts after z, but in German it
+            // may sort differently.
+            const params = { "\u00E4": "ae", "\u00F6": "oe", "a": "plain" };
+            const hash1 = hashParams(params);
+            // Re-hash to verify at least within the same runtime it is stable.
+            const hash2 = hashParams({ a: "plain", "\u00F6": "oe", "\u00E4": "ae" });
+            expect(hash1).toBe(hash2);
+        });
+        it("should treat codepoint order as canonical for ASCII keys", () => {
+            // Byte/codepoint order: "_" (95) < "a" (97)
+            // Some localeCompare implementations treat "_" as a punctuation
+            // character and sort it after letters.
+            const hash1 = hashParams({ _meta: "1", alpha: "2" });
+            const hash2 = hashParams({ alpha: "2", _meta: "1" });
+            // Within a single runtime these should match, but across runtimes
+            // the sort order may differ if localeCompare is used.
+            expect(hash1).toBe(hash2);
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle params with empty string values", () => {
+            const result = hashParams({ key: "" });
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+            expect(result).not.toBe("_");
+        });
+        it("should handle params with empty string keys", () => {
+            const result = hashParams({ "": "value" });
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+            expect(result).not.toBe("_");
+        });
+        it("should produce different hashes for different unicode values", () => {
+            const hash1 = hashParams({ name: "\u00FC" }); // u-umlaut
+            const hash2 = hashParams({ name: "\u0075\u0308" }); // u + combining diaeresis
+            // These are visually the same character but different codepoints,
+            // so they should produce different hashes (no normalization).
+            expect(hash1).not.toBe(hash2);
+        });
+        it("should handle a large number of params", () => {
+            const params = {};
+            for (let i = 0; i < 100; i++) {
+                params[`key${i}`] = `value${i}`;
+            }
+            const result = hashParams(params);
+            expect(result).toMatch(/^[0-9a-f]{8}$/);
+        });
+    });
+});
+//# sourceMappingURL=param-hash.test.js.map

package/dist/prerender/__tests__/param-hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-hash.test.js","sourceRoot":"","sources":["../../../src/prerender/__tests__/param-hash.test.ts"],"names":[],"mappings":"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"}

package/dist/prerender/param-hash.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deterministic param hashing for prerender storage keys.
+ *
+ * Used at build time (child process) to generate filenames and at
+ * runtime (worker) to look up pre-rendered data. Both environments
+ * must produce identical hashes for the same params.
+ *
+ * Uses a simple DJB2-based hash that works in all JS environments
+ * (Node.js, Cloudflare Workers, browsers) without crypto imports.
+ */
+/**
+ * Compute a deterministic hash string from route params.
+ * For static routes (no params), returns "_".
+ */
+export declare function hashParams(params: Record<string, string>): string;
+//# sourceMappingURL=param-hash.d.ts.map

package/dist/prerender/param-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-hash.d.ts","sourceRoot":"","sources":["../../src/prerender/param-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CASjE"}

package/dist/prerender/param-hash.js

@@ -0,0 +1,36 @@
+/**
+ * Deterministic param hashing for prerender storage keys.
+ *
+ * Used at build time (child process) to generate filenames and at
+ * runtime (worker) to look up pre-rendered data. Both environments
+ * must produce identical hashes for the same params.
+ *
+ * Uses a simple DJB2-based hash that works in all JS environments
+ * (Node.js, Cloudflare Workers, browsers) without crypto imports.
+ */
+/**
+ * Compute a deterministic hash string from route params.
+ * For static routes (no params), returns "_".
+ */
+export function hashParams(params) {
+    const entries = Object.entries(params);
+    if (entries.length === 0)
+        return "_";
+    const sorted = entries.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    const str = sorted
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+        .join("&");
+    return djb2Hex(str);
+}
+/**
+ * DJB2 hash returning an 8-char hex string.
+ * Deterministic across all JS runtimes.
+ */
+function djb2Hex(str) {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) + hash + str.charCodeAt(i)) >>> 0;
+    }
+    return hash.toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=param-hash.js.map

package/dist/prerender/param-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-hash.js","sourceRoot":"","sources":["../../src/prerender/param-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAA8B;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAErC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,MAAM;SACf,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/prerender/store.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Prerender Store
+ *
+ * Reads pre-rendered segment data from the worker bundle at build time.
+ * The data is stored as globalThis.__PRERENDER_MANIFEST, a map of
+ * "<routeName>/<paramHash>" to dynamic import functions that resolve
+ * individual prerender entry modules.
+ */
+import type { SerializedSegmentData, SegmentHandleData } from "../cache/types.js";
+export interface PrerenderEntry {
+    segments: SerializedSegmentData[];
+    handles: Record<string, SegmentHandleData>;
+}
+export interface PrerenderStore {
+    get(routeName: string, paramHash: string, meta?: {
+        pathname: string;
+    }): PrerenderEntry | null | Promise<PrerenderEntry | null>;
+}
+declare global {
+    var __PRERENDER_MANIFEST: Record<string, () => Promise<{
+        default: PrerenderEntry;
+    }>> | undefined;
+    var __PRERENDER_DEV_URL: string | undefined;
+}
+/**
+ * Create a dev-mode prerender store that fetches on-demand from the
+ * Vite dev server's /__rsc_prerender endpoint (runs in Node.js where
+ * node:fs works, unlike workerd).
+ */
+export declare function createDevPrerenderStore(devUrl: string): PrerenderStore;
+/**
+ * Create a prerender store.
+ * Dev mode: on-demand fetch from Vite dev server (node:fs works there).
+ * Production: backed by globalThis.__PRERENDER_MANIFEST injected at build time.
+ * Returns null if no prerender data is available.
+ */
+export declare function createPrerenderStore(): PrerenderStore | null;
+//# sourceMappingURL=store.d.ts.map

package/dist/prerender/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/prerender/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GACnE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,OAAO,CAAC,MAAM,CAAC;IAGb,IAAI,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAGjG,IAAI,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CActE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,IAAI,CAuB5D"}

package/dist/prerender/store.js

@@ -0,0 +1,61 @@
+/**
+ * Prerender Store
+ *
+ * Reads pre-rendered segment data from the worker bundle at build time.
+ * The data is stored as globalThis.__PRERENDER_MANIFEST, a map of
+ * "<routeName>/<paramHash>" to dynamic import functions that resolve
+ * individual prerender entry modules.
+ */
+/**
+ * Create a dev-mode prerender store that fetches on-demand from the
+ * Vite dev server's /__rsc_prerender endpoint (runs in Node.js where
+ * node:fs works, unlike workerd).
+ */
+export function createDevPrerenderStore(devUrl) {
+    return {
+        async get(_routeName, _paramHash, meta) {
+            if (!meta?.pathname)
+                return null;
+            const url = `${devUrl}/__rsc_prerender?pathname=${encodeURIComponent(meta.pathname)}`;
+            try {
+                const res = await fetch(url);
+                if (!res.ok)
+                    return null;
+                return res.json();
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+/**
+ * Create a prerender store.
+ * Dev mode: on-demand fetch from Vite dev server (node:fs works there).
+ * Production: backed by globalThis.__PRERENDER_MANIFEST injected at build time.
+ * Returns null if no prerender data is available.
+ */
+export function createPrerenderStore() {
+    if (globalThis.__PRERENDER_DEV_URL) {
+        return createDevPrerenderStore(globalThis.__PRERENDER_DEV_URL);
+    }
+    const manifest = globalThis.__PRERENDER_MANIFEST;
+    if (!manifest || Object.keys(manifest).length === 0)
+        return null;
+    const cache = new Map();
+    return {
+        get(routeName, paramHash) {
+            const key = `${routeName}/${paramHash}`;
+            const cached = cache.get(key);
+            if (cached)
+                return cached;
+            const loader = manifest[key];
+            if (!loader)
+                return Promise.resolve(null);
+            const promise = loader().then((mod) => mod.default).catch(() => null);
+            cache.set(key, promise);
+            return promise;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/prerender/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/prerender/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI;YACpC,IAAI,CAAC,IAAI,EAAE,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACjC,MAAM,GAAG,GAAG,GAAG,MAAM,6BAA6B,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtF,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,OAAO,IAAI,CAAC;gBACzB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACnC,OAAO,uBAAuB,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,oBAAoB,CAAC;IACjD,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0C,CAAC;IAEhE,OAAO;QACL,GAAG,CAAC,SAAiB,EAAE,SAAiB;YACtC,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAE1B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE1C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACtE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/prerender.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pre-render handler definition for build-time rendering of route segments.
+ *
+ * Prerender wraps a handler so that in production (phase 2)
+ * it can be pre-rendered at build time and served as a static Flight payload.
+ * In dev mode (phase 1), it behaves as a normal handler — the handler runs
+ * on every request just like a regular path() handler.
+ *
+ * The $$id is auto-generated by the Vite exposeInternalIds plugin
+ * based on file path and export name. No manual naming required.
+ *
+ * @example
+ * ```ts
+ * // Static page — no params
+ * export const DocsPage = Prerender(async (ctx) => {
+ *   return <div>Documentation</div>;
+ * });
+ *
+ * // Dynamic page — params first, handler second
+ * export const DocsArticle = Prerender(
+ *   async () => [{ slug: "getting-started" }, { slug: "api-reference" }],
+ *   async (ctx) => {
+ *     return <div>{ctx.params.slug}</div>;
+ *   }
+ * );
+ * ```
+ */
+import type { ReactNode } from "react";
+import type { Handler, HandlerContext } from "./types.js";
+import type { Handle } from "./handle.js";
+export interface PrerenderOptions {
+    /**
+     * Keep handler in server bundle for live fallback (default: false).
+     * false: handler replaced with stub, source-only APIs excluded from bundle.
+     * true: handler stays in bundle, unknown params render live at request time.
+     */
+    passthrough?: boolean;
+}
+export interface BuildContext<TParams> {
+    /** Params extracted from the route pattern (populated from getParams). */
+    params: TParams;
+    /** Push handle data (frozen into pre-rendered output at build time). */
+    use: <T>(handle: Handle<T>) => (data: T) => void;
+    /** Synthetic URL built from pattern + params (no real request). */
+    url: URL;
+    /** Pathname portion of the synthetic URL. */
+    pathname: string;
+}
+export interface PrerenderHandlerDefinition<TParams extends Record<string, any> = any> {
+    readonly __brand: "prerenderHandler";
+    /** Auto-generated unique ID (injected by Vite plugin). */
+    $$id: string;
+    /** In dev mode, the actual handler function that path() can call. */
+    handler: Handler<TParams>;
+    /** Returns the list of param objects to pre-render (dynamic routes). */
+    getParams?: () => Promise<TParams[]> | TParams[];
+    /** Pre-render options. */
+    options?: PrerenderOptions;
+}
+export declare function Prerender<TParams extends Record<string, any> = {}>(handler: (ctx: HandlerContext<TParams>) => ReactNode | Promise<ReactNode>, options?: PrerenderOptions, __injectedId?: string): PrerenderHandlerDefinition<TParams>;
+export declare function Prerender<TParams extends Record<string, any>>(getParams: () => Promise<TParams[]> | TParams[], handler: (ctx: HandlerContext<TParams>) => ReactNode | Promise<ReactNode>, options?: PrerenderOptions, __injectedId?: string): PrerenderHandlerDefinition<TParams>;
+/**
+ * Type guard to check if a value is a PrerenderHandlerDefinition.
+ */
+export declare function isPrerenderHandler(value: unknown): value is PrerenderHandlerDefinition;
+//# sourceMappingURL=prerender.d.ts.map