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

package/dist/router/handler-context.js

@@ -0,0 +1,198 @@
+/**
+ * Router Handler Context
+ *
+ * Creates the handler context object passed to route handlers, middleware, and loaders.
+ */
+import { getRequestContext } from "../server/request-context.js";
+import { getSearchSchema } from "../route-map-builder.js";
+import { parseSearchParams, serializeSearchParams } from "../search-params.js";
+/**
+ * Resolve route name with namespace prefix support.
+ * Supports local names, absolute names (dot notation), and path-based URLs.
+ */
+function resolveRouteName(name, routeMap, currentRoutePrefix) {
+    // 1. Path-based - starts with /
+    if (name.startsWith("/")) {
+        return name;
+    }
+    // 2. Absolute name - already has a dot (e.g., "shop.cart")
+    if (name.includes(".")) {
+        return routeMap[name];
+    }
+    // 3. Local name - try with current prefix first, then fall back to direct lookup
+    if (currentRoutePrefix) {
+        // Extract the prefix from current route name
+        // e.g., "blog.posts.detail" → prefix is "blog.posts"
+        const lastDot = currentRoutePrefix.lastIndexOf(".");
+        const prefix = lastDot > 0 ? currentRoutePrefix.substring(0, lastDot) : currentRoutePrefix;
+        // Try prefixed name
+        const prefixedName = `${prefix}.${name}`;
+        if (routeMap[prefixedName] !== undefined) {
+            return routeMap[prefixedName];
+        }
+        // If current route is a nested include, try parent prefixes
+        // e.g., for "blog.posts.detail", try "blog.posts.index", then "blog.index"
+        let currentPrefix = prefix;
+        while (currentPrefix.includes(".")) {
+            const parentDot = currentPrefix.lastIndexOf(".");
+            currentPrefix = currentPrefix.substring(0, parentDot);
+            const parentPrefixedName = `${currentPrefix}.${name}`;
+            if (routeMap[parentPrefixedName] !== undefined) {
+                return routeMap[parentPrefixedName];
+            }
+        }
+    }
+    // Fall back to direct lookup (route without prefix)
+    return routeMap[name];
+}
+/**
+ * Create HandlerContext with typed env/var/get/set
+ */
+export function createHandlerContext(params, request, searchParams, pathname, url, bindings = {}, routeMap = {}, routeName) {
+    // Get variables from request context - this is the unified context
+    // shared between middleware and route handlers
+    const requestContext = getRequestContext();
+    const variables = requestContext?.var ?? {};
+    // Filter system parameters (starting with _rsc) from searchParams
+    // This ensures handlers only see user-facing query params
+    const cleanSearchParams = new URLSearchParams();
+    searchParams.forEach((value, key) => {
+        if (!key.startsWith("_rsc")) {
+            cleanSearchParams.append(key, value);
+        }
+    });
+    // Create clean URL without system params
+    const cleanUrl = new URL(url);
+    cleanUrl.search = cleanSearchParams.toString();
+    // If route has a search schema, parse URLSearchParams into typed object
+    const searchSchema = routeName ? getSearchSchema(routeName) : undefined;
+    const resolvedSearchParams = searchSchema
+        ? parseSearchParams(cleanSearchParams, searchSchema)
+        : cleanSearchParams;
+    // Get stub response from request context for setting headers
+    const stubResponse = requestContext?.res ?? new Response(null, { status: 200 });
+    return {
+        params,
+        request,
+        searchParams: resolvedSearchParams, // Filtered params (typed object or URLSearchParams)
+        pathname,
+        url: cleanUrl, // Clean URL
+        env: bindings,
+        var: variables,
+        get: ((key) => variables[key]),
+        set: ((key, value) => {
+            variables[key] = value;
+        }),
+        _originalRequest: request, // Raw request for advanced use
+        res: stubResponse, // Stub response for setting headers
+        headers: stubResponse.headers, // Shorthand for res.headers
+        // Placeholder use() - will be replaced with actual implementation during request
+        use: () => {
+            throw new Error("ctx.use() called before loaders were initialized");
+        },
+        // Theme support (when enabled via router config)
+        theme: requestContext?.theme,
+        setTheme: requestContext?.setTheme,
+        // Scoped reverse for URL generation
+        reverse: (name, hrefParams, search) => {
+            // Path-based - return directly (optionally with param substitution)
+            if (name.startsWith("/")) {
+                let result = name;
+                if (hrefParams) {
+                    result = result.replace(/:([^/]+)/g, (_, key) => {
+                        const value = hrefParams[key];
+                        if (value === undefined) {
+                            throw new Error(`Missing param "${key}" for path "${name}"`);
+                        }
+                        return encodeURIComponent(value);
+                    });
+                }
+                if (search) {
+                    const qs = serializeSearchParams(search);
+                    if (qs)
+                        result += `?${qs}`;
+                }
+                return result;
+            }
+            // Resolve route name with namespace support
+            const pattern = resolveRouteName(name, routeMap, routeName);
+            if (pattern === undefined) {
+                throw new Error(`Unknown route: "${name}"${routeName ? ` (current route: ${routeName})` : ""}`);
+            }
+            let result = pattern;
+            // Substitute params
+            if (hrefParams) {
+                result = result.replace(/:([^/]+)/g, (_, key) => {
+                    const value = hrefParams[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;
+        },
+    };
+}
+/**
+ * Create a BuildContext for pre-rendering.
+ *
+ * Returns a HandlerContext-compatible object where params, pathname, url,
+ * and use(handle) work, but request/env/headers/cookies/var/searchParams
+ * throw with a clear error. Loaders are not available during pre-rendering.
+ */
+export function createBuildContext(params, pathname, handleStore) {
+    const syntheticUrl = new URL(`http://prerender${pathname}`);
+    function throwUnavailable(prop) {
+        throw new Error(`Property "${prop}" is not available during pre-rendering. ` +
+            `Fetch data directly in the handler or use a passthrough prerender handler.`);
+    }
+    return {
+        params,
+        get request() {
+            return throwUnavailable("request");
+        },
+        get searchParams() {
+            return throwUnavailable("searchParams");
+        },
+        pathname,
+        url: syntheticUrl,
+        get env() {
+            return throwUnavailable("env");
+        },
+        get var() {
+            return throwUnavailable("var");
+        },
+        get: (() => {
+            throwUnavailable("get");
+        }),
+        set: (() => {
+            throwUnavailable("set");
+        }),
+        get _originalRequest() {
+            return throwUnavailable("request");
+        },
+        get res() {
+            return throwUnavailable("res");
+        },
+        get headers() {
+            return throwUnavailable("headers");
+        },
+        // Placeholder use() - replaced by setupBuildUse
+        use: () => {
+            throw new Error("ctx.use() called before build context was initialized");
+        },
+        theme: undefined,
+        setTheme: undefined,
+        reverse: () => {
+            throwUnavailable("reverse");
+        },
+    };
+}
+//# sourceMappingURL=handler-context.js.map

package/dist/router/handler-context.js.map

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

package/dist/router/intercept-resolution.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Intercept Resolution
+ *
+ * Extracted from createRouter closure. Contains intercept detection and resolution
+ * functions for soft navigation (modals).
+ */
+import type { EntryData, InterceptEntry, InterceptSelectorContext } from "../server/context";
+import type { HandlerContext, ResolvedSegment } from "../types";
+import type { SegmentResolutionDeps } from "./types.js";
+/**
+ * Check if an intercept's when conditions are satisfied.
+ * All when() functions must return true for the intercept to activate.
+ * If no when() conditions are defined, the intercept always activates.
+ *
+ * During action revalidation, when() is NOT evaluated.
+ */
+export declare function evaluateInterceptWhen(intercept: InterceptEntry, selectorContext: InterceptSelectorContext | null, isAction: boolean): boolean;
+/**
+ * Find an intercept for the target route by walking up the entry chain.
+ * Returns the first (innermost) matching intercept along with the entry that defines it.
+ */
+export declare function findInterceptForRoute(targetRouteKey: string, fromEntry: EntryData | null, selectorContext?: InterceptSelectorContext | null, isAction?: boolean): {
+    intercept: InterceptEntry;
+    entry: EntryData;
+} | null;
+/**
+ * Resolve an intercept entry and emit segment with the slot name.
+ */
+export declare function resolveInterceptEntry<TEnv>(interceptEntry: InterceptEntry, parentEntry: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, belongsToRoute: boolean, deps: SegmentResolutionDeps<TEnv>, revalidationContext?: {
+    clientSegmentIds: Set<string>;
+    prevParams: Record<string, string>;
+    request: Request;
+    prevUrl: URL;
+    nextUrl: URL;
+    routeKey: string;
+    actionContext?: {
+        actionId?: string;
+        actionUrl?: URL;
+        actionResult?: any;
+        formData?: FormData;
+    };
+    stale?: boolean;
+}): Promise<ResolvedSegment[]>;
+/**
+ * Resolve only the loaders for a cached intercept segment.
+ * Used on intercept cache hit to get fresh loader data while keeping cached component/layout.
+ */
+export declare function resolveInterceptLoadersOnly<TEnv>(interceptEntry: InterceptEntry, parentEntry: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, belongsToRoute: boolean, deps: SegmentResolutionDeps<TEnv>, revalidationContext: {
+    clientSegmentIds: Set<string>;
+    prevParams: Record<string, string>;
+    request: Request;
+    prevUrl: URL;
+    nextUrl: URL;
+    routeKey: string;
+    actionContext?: {
+        actionId?: string;
+        actionUrl?: URL;
+        actionResult?: any;
+        formData?: FormData;
+    };
+    stale?: boolean;
+}): Promise<{
+    loaderDataPromise: Promise<any[]> | any[];
+    loaderIds: string[];
+} | null>;
+//# sourceMappingURL=intercept-resolution.d.ts.map

package/dist/router/intercept-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercept-resolution.d.ts","sourceRoot":"","sources":["../../src/router/intercept-resolution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,eAAe,EAAE,wBAAwB,GAAG,IAAI,EAChD,QAAQ,EAAE,OAAO,GAChB,OAAO,CAcT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,eAAe,GAAE,wBAAwB,GAAG,IAAW,EACvD,QAAQ,GAAE,OAAe,GACxB;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAkCxD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAC9C,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAClC,cAAc,EAAE,OAAO,EACvB,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,EACjC,mBAAmB,CAAC,EAAE;IACpB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CAyJ5B;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EACpD,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAClC,cAAc,EAAE,OAAO,EACvB,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,EACjC,mBAAmB,EAAE;IACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC;IACT,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,IAAI,CAAC,CAuFR"}

package/dist/router/intercept-resolution.js

@@ -0,0 +1,246 @@
+/**
+ * Intercept Resolution
+ *
+ * Extracted from createRouter closure. Contains intercept detection and resolution
+ * functions for soft navigation (modals).
+ */
+import { evaluateRevalidation } from "./revalidation.js";
+import { getRequestContext } from "../server/request-context.js";
+import { executeInterceptMiddleware } from "./middleware.js";
+import { handleHandlerResult } from "./segment-resolution.js";
+import { debugLog } from "./logging.js";
+/**
+ * Check if an intercept's when conditions are satisfied.
+ * All when() functions must return true for the intercept to activate.
+ * If no when() conditions are defined, the intercept always activates.
+ *
+ * During action revalidation, when() is NOT evaluated.
+ */
+export function evaluateInterceptWhen(intercept, selectorContext, isAction) {
+    if (isAction) {
+        return true;
+    }
+    if (!intercept.when || intercept.when.length === 0) {
+        return true;
+    }
+    if (!selectorContext) {
+        return false;
+    }
+    return intercept.when.every((fn) => fn(selectorContext));
+}
+/**
+ * Find an intercept for the target route by walking up the entry chain.
+ * Returns the first (innermost) matching intercept along with the entry that defines it.
+ */
+export function findInterceptForRoute(targetRouteKey, fromEntry, selectorContext = null, isAction = false) {
+    let current = fromEntry;
+    while (current) {
+        if (current.intercept && current.intercept.length > 0) {
+            for (const intercept of current.intercept) {
+                if (intercept.routeName === targetRouteKey &&
+                    evaluateInterceptWhen(intercept, selectorContext, isAction)) {
+                    return { intercept, entry: current };
+                }
+            }
+        }
+        if (current.layout && current.layout.length > 0) {
+            for (const siblingLayout of current.layout) {
+                if (siblingLayout.intercept && siblingLayout.intercept.length > 0) {
+                    for (const intercept of siblingLayout.intercept) {
+                        if (intercept.routeName === targetRouteKey &&
+                            evaluateInterceptWhen(intercept, selectorContext, isAction)) {
+                            return { intercept, entry: siblingLayout };
+                        }
+                    }
+                }
+            }
+        }
+        current = current.parent;
+    }
+    return null;
+}
+/**
+ * Resolve an intercept entry and emit segment with the slot name.
+ */
+export async function resolveInterceptEntry(interceptEntry, parentEntry, params, context, belongsToRoute, deps, revalidationContext) {
+    const segments = [];
+    if (interceptEntry.middleware.length > 0) {
+        const requestCtx = getRequestContext();
+        if (!requestCtx?.res) {
+            throw new Error("Request context with stubResponse is required for intercept middleware");
+        }
+        const middlewareResponse = await executeInterceptMiddleware(interceptEntry.middleware, context.request, context.env, params, context.var, requestCtx.res);
+        if (middlewareResponse)
+            throw middlewareResponse;
+    }
+    const loaderPromises = [];
+    const loaderIds = [];
+    for (let i = 0; i < interceptEntry.loader.length; i++) {
+        const { loader, revalidate: loaderRevalidateFns } = interceptEntry.loader[i];
+        const segmentId = `${parentEntry.shortCode}.${interceptEntry.slotName}D${i}.${loader.$$id}`;
+        if (revalidationContext) {
+            const { clientSegmentIds, prevParams, request, prevUrl, nextUrl, routeKey, actionContext, stale, } = revalidationContext;
+            const interceptSegmentId = `${parentEntry.shortCode}.${interceptEntry.slotName}`;
+            if (clientSegmentIds.has(interceptSegmentId)) {
+                const dummySegment = {
+                    id: segmentId,
+                    namespace: `intercept:${interceptEntry.routeName}`,
+                    type: "loader",
+                    index: i,
+                    component: null,
+                    params,
+                    loaderId: loader.$$id,
+                    belongsToRoute,
+                };
+                const shouldRevalidate = await evaluateRevalidation({
+                    segment: dummySegment,
+                    prevParams,
+                    getPrevSegment: null,
+                    request,
+                    prevUrl,
+                    nextUrl,
+                    revalidations: loaderRevalidateFns.map((fn, j) => ({
+                        name: `intercept-loader-revalidate${j}`,
+                        fn,
+                    })),
+                    routeKey,
+                    context,
+                    actionContext,
+                    stale,
+                });
+                if (!shouldRevalidate) {
+                    debugLog("intercept.loader", "skipped revalidation", {
+                        loaderId: loader.$$id,
+                    });
+                    continue;
+                }
+                debugLog("intercept.loader", "revalidating", {
+                    loaderId: loader.$$id,
+                    stale,
+                });
+            }
+        }
+        loaderIds.push(loader.$$id);
+        loaderPromises.push(deps.wrapLoaderPromise(context.use(loader), parentEntry, segmentId, context.pathname));
+    }
+    const handlerResult = typeof interceptEntry.handler === "function"
+        ? handleHandlerResult(interceptEntry.handler(context))
+        : interceptEntry.handler;
+    let layoutElement;
+    if (interceptEntry.layout) {
+        if (typeof interceptEntry.layout === "function") {
+            const layoutResult = await interceptEntry.layout(context);
+            if (layoutResult instanceof Response) {
+                throw layoutResult;
+            }
+            layoutElement = layoutResult;
+        }
+        else {
+            layoutElement = interceptEntry.layout;
+        }
+    }
+    let component;
+    let loaderDataPromise;
+    if (interceptEntry.loading && loaderPromises.length > 0) {
+        component =
+            handlerResult instanceof Promise
+                ? handlerResult
+                : Promise.resolve(handlerResult);
+        loaderDataPromise = Promise.all(loaderPromises);
+    }
+    else if (loaderPromises.length > 0) {
+        loaderDataPromise = await Promise.all(loaderPromises);
+        component =
+            handlerResult instanceof Promise ? await handlerResult : handlerResult;
+    }
+    else {
+        component =
+            interceptEntry.loading && handlerResult instanceof Promise
+                ? handlerResult
+                : handlerResult instanceof Promise
+                    ? await handlerResult
+                    : handlerResult;
+    }
+    const interceptSegment = {
+        id: `${parentEntry.shortCode}.${interceptEntry.slotName}`,
+        namespace: `intercept:${interceptEntry.routeName}`,
+        type: "parallel",
+        index: 0,
+        component,
+        loading: interceptEntry.loading === false ? null : interceptEntry.loading,
+        layout: layoutElement,
+        params,
+        slot: interceptEntry.slotName,
+        belongsToRoute,
+        parallelName: `intercept:${interceptEntry.routeName}.${interceptEntry.slotName}`,
+        loaderDataPromise,
+        loaderIds: loaderIds.length > 0 ? loaderIds : undefined,
+    };
+    segments.push(interceptSegment);
+    return segments;
+}
+/**
+ * Resolve only the loaders for a cached intercept segment.
+ * Used on intercept cache hit to get fresh loader data while keeping cached component/layout.
+ */
+export async function resolveInterceptLoadersOnly(interceptEntry, parentEntry, params, context, belongsToRoute, deps, revalidationContext) {
+    if (interceptEntry.loader.length === 0) {
+        return null;
+    }
+    const loaderPromises = [];
+    const loaderIds = [];
+    const { clientSegmentIds, prevParams, request, prevUrl, nextUrl, routeKey, actionContext, stale, } = revalidationContext;
+    for (let i = 0; i < interceptEntry.loader.length; i++) {
+        const { loader, revalidate: loaderRevalidateFns } = interceptEntry.loader[i];
+        const segmentId = `${parentEntry.shortCode}.${interceptEntry.slotName}D${i}.${loader.$$id}`;
+        const interceptSegmentId = `${parentEntry.shortCode}.${interceptEntry.slotName}`;
+        if (clientSegmentIds.has(interceptSegmentId)) {
+            const dummySegment = {
+                id: segmentId,
+                namespace: `intercept:${interceptEntry.routeName}`,
+                type: "loader",
+                index: i,
+                component: null,
+                params,
+                loaderId: loader.$$id,
+                belongsToRoute,
+            };
+            const shouldRevalidate = await evaluateRevalidation({
+                segment: dummySegment,
+                prevParams,
+                getPrevSegment: null,
+                request,
+                prevUrl,
+                nextUrl,
+                revalidations: loaderRevalidateFns.map((fn, j) => ({
+                    name: `intercept-loader-revalidate${j}`,
+                    fn,
+                })),
+                routeKey,
+                context,
+                actionContext,
+                stale,
+            });
+            if (!shouldRevalidate) {
+                debugLog("intercept.loader", "skipped on cache hit", {
+                    loaderId: loader.$$id,
+                });
+                continue;
+            }
+            debugLog("intercept.loader", "revalidating on cache hit", {
+                loaderId: loader.$$id,
+                stale,
+            });
+        }
+        loaderIds.push(loader.$$id);
+        loaderPromises.push(deps.wrapLoaderPromise(context.use(loader), parentEntry, segmentId, context.pathname));
+    }
+    if (loaderPromises.length === 0) {
+        return null;
+    }
+    const loaderDataPromise = interceptEntry.loading !== undefined
+        ? Promise.all(loaderPromises)
+        : await Promise.all(loaderPromises);
+    return { loaderDataPromise, loaderIds };
+}
+//# sourceMappingURL=intercept-resolution.js.map

package/dist/router/intercept-resolution.js.map

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

package/dist/router/loader-resolution.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Router Loader Resolution
+ *
+ * Loader execution, memoization, and error handling utilities.
+ */
+import type { ReactNode } from "react";
+import type { EntryData } from "../server/context";
+import type { HandlerContext, LoaderDataResult, ErrorBoundaryHandler, ErrorInfo } from "../types";
+/**
+ * Internal callback signature for loader error notifications.
+ * This is a simplified callback for internal use in wrapLoaderWithErrorHandling.
+ * The caller (wrapLoaderPromise in router.ts) bridges this to the full OnErrorCallback.
+ */
+export type LoaderErrorCallback = (error: unknown, context: {
+    segmentId: string;
+    loaderName: string;
+    handledByBoundary: boolean;
+}) => void;
+/**
+ * Wrap a loader promise with error handling for deferred client-side resolution.
+ * Catches errors and converts them to LoaderDataResult objects that include
+ * error info and pre-rendered fallback UI when an error boundary is available.
+ *
+ * @param onError - Optional callback invoked when loader errors occur.
+ *   This has a simplified signature for internal use - the caller (typically
+ *   wrapLoaderPromise in router.ts) is responsible for bridging to the full
+ *   OnErrorCallback with complete request context (request, url, env, etc.).
+ */
+export declare function wrapLoaderWithErrorHandling<T>(promise: Promise<T>, entry: EntryData, segmentId: string, pathname: string, findNearestErrorBoundary: (entry: EntryData | null) => ReactNode | ErrorBoundaryHandler | null, createErrorInfo: (error: unknown, segmentId: string, segmentType: ErrorInfo["segmentType"]) => ErrorInfo, onError?: LoaderErrorCallback): Promise<LoaderDataResult<T>>;
+/**
+ * Set up the use() method on handler context to access loaders and handles.
+ *
+ * For loaders: Lazily runs loaders, memoizes results per request.
+ * For handles: Returns a push function bound to the current segment.
+ *
+ * Includes cycle detection: tracks dependency edges between loaders and
+ * throws on circular dependencies to prevent deadlocks.
+ */
+export declare function setupLoaderAccess<TEnv>(ctx: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>): void;
+/**
+ * Set up ctx.use() for pre-rendering (build-time).
+ * Handles push to HandleStore; loaders throw with a clear error.
+ */
+export declare function setupBuildUse<TEnv>(ctx: HandlerContext<any, TEnv>): void;
+/**
+ * Set up ctx.use() for proactive caching (silent mode).
+ * Handles are silently ignored (no push to HandleStore).
+ * Loaders work normally but with fresh memoization and cycle detection.
+ *
+ * This prevents duplicate handle data (breadcrumbs, meta) from being
+ * pushed to the response stream during background proactive caching.
+ */
+export declare function setupLoaderAccessSilent<TEnv>(ctx: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>): void;
+/**
+ * Conditional execution based on revalidation
+ * Evaluates revalidation logic lazily, then executes appropriate callback
+ *
+ * @param shouldRevalidate - Async function that determines if revalidation is needed
+ * @param onRevalidate - Callback executed if revalidation returns true
+ * @param onSkip - Callback executed if revalidation returns false
+ * @returns Result from either onRevalidate or onSkip
+ */
+export declare function revalidate<T>(shouldRevalidate: () => Promise<boolean>, onRevalidate: () => Promise<T>, onSkip: () => T): Promise<T>;
+//# sourceMappingURL=loader-resolution.d.ts.map

package/dist/router/loader-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-resolution.d.ts","sourceRoot":"","sources":["../../src/router/loader-resolution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAEV,cAAc,EAId,gBAAgB,EAChB,oBAAoB,EAEpB,SAAS,EACV,MAAM,UAAU,CAAC;AAQlB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,KACE,IAAI,CAAC;AAEV;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,wBAAwB,EAAE,CACxB,KAAK,EAAE,SAAS,GAAG,IAAI,KACpB,SAAS,GAAG,oBAAoB,GAAG,IAAI,EAC5C,eAAe,EAAE,CACf,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,KAClC,SAAS,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA6D9B;AAgJD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EACpC,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GACxC,IAAI,CAiCN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAChC,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,GAC7B,IAAI,CAsCN;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAC1C,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GACxC,IAAI,CAWN;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,gBAAgB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACxC,YAAY,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,GACd,OAAO,CAAC,CAAC,CAAC,CAGZ"}