@rangojs/router 0.0.0-experimental.0b82333f

package/dist/prerender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,OAAO;IACnC,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAEhB,wEAAwE;IACxE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAEjD,mEAAmE;IACnE,GAAG,EAAE,GAAG,CAAC;IAET,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACnF,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;IACjD,0BAA0B;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAKD,wBAAgB,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EAChE,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EACzE,OAAO,CAAC,EAAE,gBAAgB,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAGvC,wBAAgB,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,EAC/C,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EACzE,OAAO,CAAC,EAAE,gBAAgB,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,0BAA0B,CAAC,OAAO,CAAC,CAAC;AA2DvC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAOrC"}

package/dist/prerender.js

@@ -0,0 +1,57 @@
+// -- Implementation ---------------------------------------------------------
+export function Prerender(handlerOrGetParams, handlerOrOptions, optionsOrId, maybeId) {
+    // Resolve overloads:
+    // 1 fn arg:  Prerender(handler, options?, __injectedId?)
+    // 2 fn args: Prerender(getParams, handler, options?, __injectedId?)
+    let handler;
+    let getParams;
+    let options;
+    let id;
+    if (typeof handlerOrOptions === "function") {
+        // Two function args: getParams + handler
+        getParams = handlerOrGetParams;
+        handler = handlerOrOptions;
+        if (typeof optionsOrId === "string") {
+            id = optionsOrId;
+        }
+        else {
+            options = optionsOrId;
+            id = maybeId ?? "";
+        }
+    }
+    else {
+        // Single function arg: handler only
+        handler = handlerOrGetParams;
+        if (typeof handlerOrOptions === "object" && handlerOrOptions !== null) {
+            options = handlerOrOptions;
+        }
+        if (typeof optionsOrId === "string") {
+            id = optionsOrId;
+        }
+        else {
+            id = maybeId ?? "";
+        }
+    }
+    if (!id) {
+        throw new Error("[rsc-router] Prerender: missing $$id. " +
+            "Ensure the exposeInternalIds Vite plugin is configured.");
+    }
+    return {
+        __brand: "prerenderHandler",
+        $$id: id,
+        handler,
+        ...(getParams ? { getParams } : {}),
+        ...(options ? { options } : {}),
+    };
+}
+// -- Type guard -------------------------------------------------------------
+/**
+ * Type guard to check if a value is a PrerenderHandlerDefinition.
+ */
+export function isPrerenderHandler(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "__brand" in value &&
+        value.__brand === "prerenderHandler");
+}
+//# sourceMappingURL=prerender.js.map

package/dist/prerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"AAsFA,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CACvB,kBAA4B,EAC5B,gBAA8C,EAC9C,WAAuC,EACvC,OAAgB;IAEhB,qBAAqB;IACrB,yDAAyD;IACzD,oEAAoE;IACpE,IAAI,OAAyB,CAAC;IAC9B,IAAI,SAA6D,CAAC;IAClE,IAAI,OAAqC,CAAC;IAC1C,IAAI,EAAU,CAAC;IAEf,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;QAC3C,yCAAyC;QACzC,SAAS,GAAG,kBAA0D,CAAC;QACvE,OAAO,GAAG,gBAAoC,CAAC;QAC/C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,EAAE,GAAG,WAAW,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,WAA2C,CAAC;YACtD,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,oCAAoC;QACpC,OAAO,GAAG,kBAAsC,CAAC;QACjD,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACtE,OAAO,GAAG,gBAAoC,CAAC;QACjD,CAAC;QACD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,EAAE,GAAG,WAAW,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,wCAAwC;YACxC,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,kBAA2B;QACpC,IAAI,EAAE,EAAE;QACR,OAAO;QACP,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,kBAAkB,CAC/D,CAAC;AACJ,CAAC"}

package/dist/reverse.d.ts

@@ -0,0 +1,196 @@
+import type { ExtractParams } from "./types.js";
+import type { SearchSchema, ResolveSearchSchema } from "./search-params.js";
+/**
+ * Sanitize prefix string by removing leading slash
+ * "/shop" -> "shop", "blog" -> "blog", "" -> ""
+ */
+export type SanitizePrefix<T extends string> = T extends `/${infer P}` ? P : T;
+/**
+ * Helper type to merge multiple route definitions into a single accumulated type.
+ * Note: When using createRouter, types accumulate automatically through the
+ * builder chain, so this type is typically not needed.
+ *
+ * @example
+ * ```typescript
+ * // Manual type merging (rarely needed):
+ * type AppRoutes = MergeRoutes<[
+ *   typeof homeRoutes,
+ *   PrefixRoutePatterns<typeof blogRoutes, "/blog">,
+ * ]>;
+ *
+ * // Preferred: Let router accumulate types automatically
+ * const router = createRouter<AppEnv>()
+ *   .routes(homeRoutes).map(...)
+ *   .routes("/blog", blogRoutes).map(...);
+ * type AppRoutes = typeof router.routeMap;
+ * ```
+ */
+export type MergeRoutes<T extends unknown[]> = T extends [
+    infer First,
+    ...infer Rest
+] ? First & MergeRoutes<Rest> : {};
+/**
+ * Add key prefix to all entries in a route map
+ * { "cart": "/cart" } with prefix "shop" -> { "shop.cart": "/shop/cart" }
+ */
+export type PrefixRouteKeys<T, Prefix extends string> = Prefix extends "" ? T : {
+    [K in keyof T as `${Prefix}.${K & string}`]: T[K];
+};
+/**
+ * Add path prefix to all patterns in a route map
+ * { "cart": "/cart" } with prefix "/shop" -> { "cart": "/shop/cart" }
+ */
+export type PrefixRoutePatterns<T, PathPrefix extends string> = {
+    [K in keyof T]: PathPrefix extends "" | "/" ? T[K] : T[K] extends "/" ? PathPrefix : T[K] extends string ? `${PathPrefix}${T[K]}` : T[K];
+};
+/**
+ * Combined: prefix both keys and patterns
+ * Used for module augmentation registration
+ *
+ * @example
+ * ```typescript
+ * // Given shopRoutes = { "index": "/", "cart": "/cart", "products.detail": "/product/:slug" }
+ * // PrefixedRoutes<typeof shopRoutes, "shop"> produces:
+ * // { "shop.index": "/shop", "shop.cart": "/shop/cart", "shop.products.detail": "/shop/product/:slug" }
+ * ```
+ */
+export type PrefixedRoutes<T, KeyPrefix extends string, PathPrefix extends string = KeyPrefix extends "" ? "" : `/${KeyPrefix}`> = PrefixRouteKeys<PrefixRoutePatterns<T, PathPrefix>, KeyPrefix>;
+/**
+ * Helper to safely extract route patterns from a routes object
+ * Handles string values, { path, response } objects, and interface types (like RegisteredRoutes)
+ */
+type RoutePatternFor<TRoutes, TName extends keyof TRoutes> = TRoutes[TName] extends string ? TRoutes[TName] : TRoutes[TName] extends {
+    readonly path: infer P extends string;
+} ? P : string;
+/**
+ * Extract params type for a route
+ */
+export type ParamsFor<TRoutes, TName extends keyof TRoutes> = ExtractParams<RoutePatternFor<TRoutes, TName>>;
+/**
+ * Check if an object type has any keys
+ */
+type IsEmptyObject<T> = keyof T extends never ? true : false;
+/**
+ * Extract search schema from a route entry.
+ * Returns {} if no search schema is defined.
+ */
+type ExtractSearchSchema<TRoutes, TName extends keyof TRoutes> = TRoutes[TName] extends {
+    readonly search: infer S extends SearchSchema;
+} ? S : {};
+/**
+ * Type-safe reverse function signature (Django-style URL reversal)
+ *
+ * Validates route names and params at compile time.
+ * Use route names instead of raw paths for full type safety.
+ *
+ * @example
+ * ```typescript
+ * reverse("cart")                           // ✓ Validates route exists
+ * reverse("product.detail", { id: "123" })  // ✓ Validates route + params
+ * ```
+ */
+export type ReverseFunction<TRoutes> = {
+    /**
+     * Route without params - validates route name exists
+     */
+    <TName extends keyof TRoutes & string>(name: IsEmptyObject<ExtractParams<RoutePatternFor<TRoutes, TName>>> extends true ? TName : never): string;
+    /**
+     * Route with params - validates both route name and params
+     */
+    <TName extends keyof TRoutes & string>(name: TName, params: ExtractParams<RoutePatternFor<TRoutes, TName>>): string;
+    /**
+     * Route with params and search - validates route name, params, and search
+     */
+    <TName extends keyof TRoutes & string>(name: TName, params: ExtractParams<RoutePatternFor<TRoutes, TName>>, search: ResolveSearchSchema<ExtractSearchSchema<TRoutes, TName>>): string;
+};
+/**
+ * Type-safe scoped reverse function that validates all route names and params.
+ *
+ * When used via HandlerContext or scopedReverse(), local routes are merged with
+ * global RegisteredRoutes so all names are fully type-checked.
+ *
+ * @example
+ * ```typescript
+ * reverse("cart")                           // ✓ Validates local route
+ * reverse("blog.post", { slug: "hello" })   // ✓ Validates global route + params
+ * reverse("typo")                           // ✗ Compile error
+ * ```
+ */
+export type ScopedReverseFunction<TLocalRoutes> = {
+    /**
+     * Route without params - validates route name exists
+     * @recommended Use this for type-safe URL generation
+     */
+    <TName extends keyof TLocalRoutes & string>(name: IsEmptyObject<ExtractParams<RoutePatternFor<TLocalRoutes, TName>>> extends true ? TName : never): string;
+    /**
+     * Route with params - validates both route name and params
+     * @recommended Use this for type-safe URL generation with parameters
+     */
+    <TName extends keyof TLocalRoutes & string>(name: TName, params: ExtractParams<RoutePatternFor<TLocalRoutes, TName>>): string;
+    /**
+     * Route with params and search - validates route name, params, and search
+     */
+    <TName extends keyof TLocalRoutes & string>(name: TName, params: ExtractParams<RoutePatternFor<TLocalRoutes, TName>>, search: ResolveSearchSchema<ExtractSearchSchema<TLocalRoutes, TName>>): string;
+};
+/**
+ * Extract local routes type from UrlPatterns
+ * Used with scopedReverse() to get the routes type from patterns
+ */
+export type ExtractLocalRoutes<TPatterns> = TPatterns extends {
+    readonly _routes?: infer TRoutes;
+} ? TRoutes : TPatterns extends Record<string, string> ? TPatterns : Record<string, string>;
+/**
+ * Extract the response data type for a named route from a UrlPatterns instance.
+ * Re-exported from urls.ts for consumer convenience.
+ */
+export type { RouteResponse } from "./urls.js";
+/**
+ * Get a locally-typed reverse function from ctx.reverse for composable modules.
+ *
+ * This is a type-only cast - ctx.reverse already resolves local names at runtime
+ * based on the current route prefix. This helper just provides type safety
+ * for local route names within a url module.
+ *
+ * @param reverse - The ctx.reverse function from HandlerContext
+ * @returns The same reverse function, but typed for local routes
+ *
+ * @example
+ * ```typescript
+ * // urls/blog.tsx
+ * export const blogPatterns = urls(({ path }) => [
+ *   path("/", (ctx) => {
+ *     // Get locally-typed reverse for this module's routes
+ *     const reverse = scopedReverse<typeof blogPatterns>(ctx.reverse);
+ *
+ *     reverse("index");              // ✓ Type-safe local route
+ *     reverse("post", { slug: "x" }); // ✓ Type-safe with params
+ *     reverse("shop.cart");          // ✓ Type-safe global route
+ *
+ *     return <BlogIndex />;
+ *   }, { name: "index" }),
+ *
+ *   path("/:slug", BlogPost, { name: "post" }),
+ * ]);
+ * ```
+ */
+export declare function scopedReverse<TPatterns>(reverse: ((...args: any[]) => string)): ScopedReverseFunction<ExtractLocalRoutes<TPatterns>>;
+/**
+ * Create a type-safe reverse function for URL generation
+ *
+ * @param routeMap - Flattened route map with all registered routes
+ * @returns Type-safe reverse function
+ *
+ * @example
+ * ```typescript
+ * // Given routes: { cart: "/shop/cart", detail: "/shop/product/:slug" }
+ * const reverse = createReverse(routeMap);
+ * reverse("cart"); // "/shop/cart"
+ * reverse("detail", { slug: "my-product" }); // "/shop/product/my-product"
+ * ```
+ */
+type RouteMapEntry = string | {
+    path: string;
+    search?: Record<string, string>;
+};
+export declare function createReverse<TRoutes extends Record<string, string>>(routeMap: TRoutes, getFallbackMap?: () => Record<string, RouteMapEntry> | undefined): ReverseFunction<TRoutes & Record<string, string>>;
+//# sourceMappingURL=reverse.d.ts.map

package/dist/reverse.d.ts.map

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

package/dist/reverse.js

@@ -0,0 +1,78 @@
+import { serializeSearchParams } from "./search-params.js";
+/**
+ * Get a locally-typed reverse function from ctx.reverse for composable modules.
+ *
+ * This is a type-only cast - ctx.reverse already resolves local names at runtime
+ * based on the current route prefix. This helper just provides type safety
+ * for local route names within a url module.
+ *
+ * @param reverse - The ctx.reverse function from HandlerContext
+ * @returns The same reverse function, but typed for local routes
+ *
+ * @example
+ * ```typescript
+ * // urls/blog.tsx
+ * export const blogPatterns = urls(({ path }) => [
+ *   path("/", (ctx) => {
+ *     // Get locally-typed reverse for this module's routes
+ *     const reverse = scopedReverse<typeof blogPatterns>(ctx.reverse);
+ *
+ *     reverse("index");              // ✓ Type-safe local route
+ *     reverse("post", { slug: "x" }); // ✓ Type-safe with params
+ *     reverse("shop.cart");          // ✓ Type-safe global route
+ *
+ *     return <BlogIndex />;
+ *   }, { name: "index" }),
+ *
+ *   path("/:slug", BlogPost, { name: "post" }),
+ * ]);
+ * ```
+ */
+export function scopedReverse(reverse) {
+    return reverse;
+}
+function resolveRoutePattern(entry) {
+    if (!entry)
+        return undefined;
+    return typeof entry === "string" ? entry : entry.path;
+}
+export function createReverse(routeMap, getFallbackMap) {
+    return ((name, params, search) => {
+        let pattern = resolveRoutePattern(routeMap[name]);
+        if (!pattern) {
+            // Try the static route names from the generated file (O(1) fallback)
+            const fallback = getFallbackMap?.();
+            if (fallback) {
+                pattern = resolveRoutePattern(fallback[name]);
+            }
+        }
+        if (!pattern) {
+            // During build-time discovery, lazy includes haven't resolved yet.
+            // Return a placeholder instead of crashing the build.
+            if (globalThis.__rscRouterDiscoveryActive) {
+                return `/__unresolved_reverse/${name}`;
+            }
+            throw new Error(`Unknown route: ${name}`);
+        }
+        let result = pattern;
+        if (params) {
+            // Replace :param placeholders with actual values
+            result = result.replace(/:([^/]+)/g, (_, key) => {
+                const value = params[key];
+                if (value === undefined) {
+                    throw new Error(`Missing param "${key}" for route "${name}"`);
+                }
+                return encodeURIComponent(value);
+            });
+        }
+        // Append search params as query string
+        if (search) {
+            const qs = serializeSearchParams(search);
+            if (qs) {
+                result += `?${qs}`;
+            }
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=reverse.js.map

package/dist/reverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse.js","sourceRoot":"","sources":["../src/reverse.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA+M3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAqC;IAErC,OAAO,OAA+D,CAAC;AACzE,CAAC;AAkBD,SAAS,mBAAmB,CAAC,KAAgC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAiB,EACjB,cAAgE;IAEhE,OAAO,CAAC,CAAC,IAAY,EAAE,MAA+B,EAAE,MAAgC,EAAE,EAAE;QAC1F,IAAI,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAA6B,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,qEAAqE;YACrE,MAAM,QAAQ,GAAG,cAAc,EAAE,EAAE,CAAC;YACpC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,mEAAmE;YACnE,sDAAsD;YACtD,IAAK,UAAkB,CAAC,0BAA0B,EAAE,CAAC;gBACnD,OAAO,yBAAyB,IAAI,EAAE,CAAC;YACzC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,MAAM,GAAG,OAAO,CAAC;QACrB,IAAI,MAAM,EAAE,CAAC;YACX,iDAAiD;YACjD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAS,EAAE,GAAW,EAAE,EAAE;gBAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,gBAAgB,IAAI,GAAG,CAAC,CAAC;gBAChE,CAAC;gBACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,uCAAuC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAA6B,CAAC;AACjC,CAAC"}

package/dist/root-error-boundary.d.ts

@@ -0,0 +1,33 @@
+import { Component, type ReactNode } from "react";
+interface RootErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Root error boundary component
+ *
+ * Wraps the entire segment tree to catch any unhandled errors that bubble up.
+ * This prevents the entire app from crashing with a white screen.
+ *
+ * This is a client component with an inline fallback to avoid the
+ * "Functions cannot be passed to Client Components" RSC error.
+ */
+export declare class RootErrorBoundary extends Component<{
+    children: ReactNode;
+}, RootErrorBoundaryState> {
+    constructor(props: {
+        children: ReactNode;
+    });
+    static getDerivedStateFromError(error: Error): RootErrorBoundaryState;
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    componentDidUpdate(prevProps: {
+        children: ReactNode;
+    }): void;
+    handlePopState: () => void;
+    reset: () => void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=root-error-boundary.d.ts.map

package/dist/root-error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-error-boundary.d.ts","sourceRoot":"","sources":["../src/root-error-boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAkM5D,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,SAAS,CAC9C;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,EACvB,sBAAsB,CACvB;gBACa,KAAK,EAAE;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE;IAK1C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,sBAAsB;IAIrE,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAI5B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAIjE,kBAAkB,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAQ5D,cAAc,QAAO,IAAI,CAKvB;IAEF,KAAK,QAAO,IAAI,CAEd;IAEF,MAAM,IAAI,SAAS;CAqBpB"}

package/dist/root-error-boundary.js

@@ -0,0 +1,165 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component, useState } from "react";
+/**
+ * Check if an error is a network-related error
+ */
+function isNetworkError(error) {
+    return error.name === "NetworkError";
+}
+/**
+ * Network error fallback UI with retry functionality
+ * Shows a connection-specific message and allows retrying via page refresh
+ */
+function NetworkErrorFallback({ error, reset, }) {
+    const [isRetrying, setIsRetrying] = useState(false);
+    const handleRetry = () => {
+        setIsRetrying(true);
+        // Refresh the page to retry the request
+        window.location.reload();
+    };
+    return (_jsxs("div", { style: {
+            fontFamily: "system-ui, -apple-system, sans-serif",
+            padding: "2rem",
+            maxWidth: "600px",
+            margin: "2rem auto",
+            textAlign: "center",
+        }, children: [_jsx("div", { style: {
+                    fontSize: "3rem",
+                    marginBottom: "1rem",
+                }, children: _jsx("span", { style: { color: "#9ca3af" }, children: "\u2601" }) }), _jsx("h1", { style: {
+                    color: "#374151",
+                    fontSize: "1.5rem",
+                    marginBottom: "0.5rem",
+                }, children: "Connection Error" }), _jsx("p", { style: {
+                    color: "#6b7280",
+                    marginBottom: "1.5rem",
+                }, children: error.message || "Unable to connect to the server. Please check your internet connection." }), _jsxs("div", { style: { display: "flex", gap: "1rem", justifyContent: "center" }, children: [_jsx("button", { type: "button", onClick: handleRetry, disabled: isRetrying, style: {
+                            padding: "0.75rem 1.5rem",
+                            backgroundColor: isRetrying ? "#9ca3af" : "#2563eb",
+                            color: "white",
+                            border: "none",
+                            borderRadius: "0.375rem",
+                            cursor: isRetrying ? "not-allowed" : "pointer",
+                            fontSize: "1rem",
+                            fontWeight: 500,
+                        }, children: isRetrying ? "Retrying..." : "Retry" }), _jsx("button", { type: "button", onClick: () => window.history.back(), style: {
+                            padding: "0.75rem 1.5rem",
+                            backgroundColor: "transparent",
+                            color: "#6b7280",
+                            border: "1px solid #d1d5db",
+                            borderRadius: "0.375rem",
+                            cursor: "pointer",
+                            fontSize: "1rem",
+                        }, children: "Go Back" })] })] }));
+}
+/**
+ * Default fallback UI for root error boundary
+ * This is shown when an unhandled error bubbles up to the root
+ */
+function RootErrorFallback({ error, reset }) {
+    return (_jsxs("div", { style: {
+            fontFamily: "system-ui, -apple-system, sans-serif",
+            padding: "2rem",
+            maxWidth: "600px",
+            margin: "2rem auto",
+        }, children: [_jsx("h1", { style: {
+                    color: "#dc2626",
+                    fontSize: "1.5rem",
+                    marginBottom: "1rem",
+                }, children: "Internal Server Error" }), _jsx("p", { style: {
+                    color: "#374151",
+                    marginBottom: "1rem",
+                }, children: "An unexpected error occurred while processing your request." }), _jsxs("div", { style: {
+                    background: "#fef2f2",
+                    border: "1px solid #fecaca",
+                    borderRadius: "0.5rem",
+                    padding: "1rem",
+                    marginBottom: "1rem",
+                }, children: [_jsxs("p", { style: {
+                            fontWeight: 600,
+                            color: "#991b1b",
+                            marginBottom: "0.5rem",
+                        }, children: [error.name, ": ", error.message] }), error.stack && (_jsx("pre", { style: {
+                            fontSize: "0.75rem",
+                            color: "#6b7280",
+                            overflow: "auto",
+                            whiteSpace: "pre-wrap",
+                            wordBreak: "break-word",
+                        }, children: error.stack }))] }), _jsxs("div", { style: { display: "flex", gap: "1rem" }, children: [_jsx("button", { type: "button", onClick: reset, style: {
+                            padding: "0.5rem 1rem",
+                            backgroundColor: "#2563eb",
+                            color: "white",
+                            border: "none",
+                            borderRadius: "0.25rem",
+                            cursor: "pointer",
+                        }, children: "Try Again" }), _jsx("a", { href: "/", style: {
+                            display: "inline-block",
+                            padding: "0.5rem 1rem",
+                            color: "#2563eb",
+                            textDecoration: "underline",
+                        }, children: "Go to homepage" })] })] }));
+}
+/**
+ * Root error boundary component
+ *
+ * Wraps the entire segment tree to catch any unhandled errors that bubble up.
+ * This prevents the entire app from crashing with a white screen.
+ *
+ * This is a client component with an inline fallback to avoid the
+ * "Functions cannot be passed to Client Components" RSC error.
+ */
+export class RootErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.handlePopState = () => {
+            // Reset error state on back/forward navigation
+            if (this.state.hasError) {
+                this.setState({ hasError: false, error: null });
+            }
+        };
+        this.reset = () => {
+            this.setState({ hasError: false, error: null });
+        };
+        this.state = { hasError: false, error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidMount() {
+        // Listen for popstate (back/forward navigation) to reset error state
+        window.addEventListener("popstate", this.handlePopState);
+    }
+    componentWillUnmount() {
+        window.removeEventListener("popstate", this.handlePopState);
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error("[RootErrorBoundary] Unhandled error caught:", error, errorInfo);
+    }
+    componentDidUpdate(prevProps) {
+        // Reset error state when children change (e.g., navigation)
+        // This allows the app to recover after navigation away from an errored route
+        if (this.state.hasError && prevProps.children !== this.props.children) {
+            this.setState({ hasError: false, error: null });
+        }
+    }
+    render() {
+        if (this.state.hasError && this.state.error) {
+            const errorInfo = {
+                message: this.state.error.message,
+                name: this.state.error.name,
+                stack: this.state.error.stack,
+                cause: this.state.error.cause,
+                segmentId: "root",
+                segmentType: "route",
+            };
+            // Use specialized fallback for network errors
+            if (isNetworkError(this.state.error)) {
+                return _jsx(NetworkErrorFallback, { error: errorInfo, reset: this.reset });
+            }
+            return _jsx(RootErrorFallback, { error: errorInfo, reset: this.reset });
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=root-error-boundary.js.map

package/dist/root-error-boundary.js.map

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

package/dist/route-content-wrapper.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from "react";
+import type { ResolvedSegment } from "./types.js";
+/**
+ * Stable async wrapper component for route content
+ * Using a module-level component ensures React sees the same component reference
+ * across renders, preventing unnecessary remounts during actions.
+ *
+ * When content is a pending promise, React suspends and shows the nearest
+ * Suspense fallback. When content is already resolved, it renders immediately
+ * without suspension.
+ *
+ * @param segmentId - Stable ID from segment, used for consistent keys across renders
+ */
+export declare function RouteContentWrapper({ content, fallback, segmentId, }: {
+    content: Promise<ReactNode>;
+    fallback?: ReactNode;
+    segmentId?: string;
+}): ReactNode;
+export declare function RouteContentWrapperCallback<T>({ resolve, fallback, children, }: {
+    resolve: Promise<T> | T;
+    fallback?: ReactNode;
+    children: (data: T) => ReactNode;
+}): ReactNode;
+/**
+ * LoaderBoundary - Client component that resolves loader promises and renders OutletProvider
+ *
+ * This component enables streaming with loaders by:
+ * 1. Receiving loader promises (serializable across RSC boundary)
+ * 2. Using React's use() to resolve them (triggers Suspense)
+ * 3. Rendering OutletProvider with resolved data
+ *
+ * The callback logic lives inside this client component, avoiding the
+ * "Functions are not valid as a child of Client Components" error.
+ */
+export interface LoaderBoundaryProps {
+    loaderDataPromise: Promise<any[]> | any[];
+    loaderIds: string[];
+    fallback?: ReactNode;
+    outletKey: string;
+    outletContent: ReactNode;
+    segment: ResolvedSegment;
+    parallel?: ResolvedSegment[];
+    children: ReactNode;
+}
+export declare function LoaderBoundary({ loaderDataPromise, loaderIds, fallback, outletKey, outletContent, segment, parallel, children, }: LoaderBoundaryProps): ReactNode;
+//# sourceMappingURL=route-content-wrapper.d.ts.map

package/dist/route-content-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-content-wrapper.d.ts","sourceRoot":"","sources":["../src/route-content-wrapper.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE;IACD,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,SAAS,CAUZ;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,EAC7C,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;CAClC,GAAG,SAAS,CAqBZ;AAwBD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,SAAS,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,EAC7B,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE,mBAAmB,GAAG,SAAS,CAejC"}