@rangojs/router 0.0.0-experimental.0b82333f

package/dist/router/revalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidation.d.ts","sourceRoot":"","sources":["../../src/router/revalidation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;GAEG;AACH,UAAU,2BAA2B,CAAC,IAAI;IACxC,kCAAkC;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sDAAsD;IACtD,cAAc,EAAE,CAAC,MAAM,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IACpE,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,OAAO,EAAE,GAAG,CAAC;IACb,eAAe;IACf,OAAO,EAAE,GAAG,CAAC;IACb,oCAAoC;IACpC,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAChD,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAC7C,OAAO,EAAE,2BAA2B,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,CAyJlB"}

package/dist/router/revalidation.js

@@ -0,0 +1,147 @@
+/**
+ * Router Revalidation Logic
+ *
+ * Evaluates whether segments should revalidate based on params, actions, and custom functions.
+ */
+import { debugLog } from "./logging.js";
+/**
+ * Evaluate if a segment should revalidate using soft/hard decision pattern
+ * Optimized to use prevParams directly and avoid building previous segments
+ */
+export async function evaluateRevalidation(options) {
+    const { segment, prevParams, getPrevSegment, request, prevUrl, nextUrl, revalidations, routeKey, context, actionContext, stale, } = options;
+    const nextParams = segment.params || {};
+    const paramsChanged = Object.keys(nextParams).length !== Object.keys(prevParams).length ||
+        Object.keys(nextParams).some((key) => nextParams[key] !== prevParams[key]);
+    // Calculate default revalidation based on segment type and request method
+    let defaultShouldRevalidate;
+    if (request.method === "POST") {
+        // Actions: revalidate segments that belong to the route, skip parent chain
+        if (segment.type === "route") {
+            // Route segment always revalidates on actions
+            defaultShouldRevalidate = true;
+        }
+        else if (segment.type === "loader") {
+            // Loaders always revalidate on actions - they often contain action-sensitive data
+            // (e.g., cart count after add-to-cart action)
+            defaultShouldRevalidate = true;
+        }
+        else if (segment.belongsToRoute) {
+            // Segment belongs to route (orphan layouts/parallels) - revalidate
+            defaultShouldRevalidate = true;
+        }
+        else {
+            // Parent chain segment (shared layouts/parallels) - don't revalidate
+            defaultShouldRevalidate = false;
+        }
+    }
+    else {
+        // Navigation (GET): Conservative defaults to minimize unnecessary revalidations
+        // Only the route segment revalidates by default - all others require explicit opt-in
+        if (segment.type === "route") {
+            // Route segments revalidate when params change
+            // Routes are the primary param-dependent content and always need updates
+            defaultShouldRevalidate = paramsChanged;
+            if (paramsChanged) {
+                debugLog("revalidation", "route params changed, revalidating", {
+                    segmentId: segment.id,
+                });
+            }
+        }
+        else {
+            // Layouts and parallels default to no revalidation
+            // Cannot assume these segments depend on params without explicit declaration
+            // Use custom revalidation functions to opt-in when needed
+            defaultShouldRevalidate = false;
+            debugLog("revalidation", "non-route segment skipped by default", {
+                segmentId: segment.id,
+                segmentType: segment.type,
+            });
+        }
+    }
+    // No custom revalidations defined - return default behavior without prev segment
+    if (revalidations.length === 0) {
+        if (defaultShouldRevalidate) {
+            debugLog("revalidation", "default revalidate=true", {
+                segmentId: segment.id,
+                prevParams,
+                nextParams,
+            });
+        }
+        else {
+            debugLog("revalidation", "default revalidate=false", {
+                segmentId: segment.id,
+            });
+        }
+        return defaultShouldRevalidate;
+    }
+    // Custom revalidations exist - may need full prev segment
+    // Lazy load prev segment only if getPrevSegment provided
+    const prevSegment = getPrevSegment ? await getPrevSegment() : null;
+    // Execute revalidation functions with soft/hard decision pattern
+    let currentSuggestion = defaultShouldRevalidate;
+    for (const { name, fn } of revalidations) {
+        const result = fn({
+            currentParams: prevSegment?.params || prevParams, // Use segment params if available, else route params
+            currentUrl: prevUrl,
+            nextParams,
+            nextUrl,
+            defaultShouldRevalidate: currentSuggestion,
+            context,
+            // Segment metadata (which segment is being evaluated)
+            segmentType: segment.type,
+            layoutName: segment.layoutName,
+            slotName: segment.slot,
+            // Action context (only populated when triggered by server action)
+            actionId: actionContext?.actionId,
+            actionUrl: actionContext?.actionUrl,
+            actionResult: actionContext?.actionResult,
+            formData: actionContext?.formData,
+            method: request.method, // GET for navigation, POST for actions
+            routeName: routeKey, // User-friendly route name (e.g., "products.detail")
+            // Stale cache context (only true for background revalidation after stale cache render)
+            stale,
+        });
+        // Check return type:
+        // - boolean: hard decision, short-circuit immediately
+        // - { defaultShouldRevalidate: boolean }: soft decision, update suggestion and continue
+        // - null/undefined: use default behavior (equivalent to returning { defaultShouldRevalidate })
+        if (typeof result === "boolean") {
+            // Hard decision - short-circuit
+            debugLog("revalidation", "hard decision", {
+                segmentId: segment.id,
+                revalidator: name,
+                revalidate: result,
+            });
+            return result;
+        }
+        else if (result &&
+            typeof result === "object" &&
+            "defaultShouldRevalidate" in result) {
+            // Soft decision - update suggestion and continue
+            currentSuggestion = result.defaultShouldRevalidate;
+            debugLog("revalidation", "soft decision", {
+                segmentId: segment.id,
+                revalidator: name,
+                revalidate: currentSuggestion,
+            });
+        }
+        else if (result === null || result === undefined) {
+            // Defer to default - equivalent to { defaultShouldRevalidate: currentSuggestion }
+            // This means "I don't care, use whatever the default is"
+            debugLog("revalidation", "deferred to current default", {
+                segmentId: segment.id,
+                revalidator: name,
+                revalidate: currentSuggestion,
+            });
+            // currentSuggestion stays the same, continue to next function
+        }
+    }
+    // All revalidators completed - use final suggestion
+    debugLog("revalidation", "final decision", {
+        segmentId: segment.id,
+        revalidate: currentSuggestion,
+    });
+    return currentSuggestion;
+}
+//# sourceMappingURL=revalidation.js.map

package/dist/router/revalidation.js.map

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

package/dist/router/router-context.d.ts

@@ -0,0 +1,135 @@
+import type { CacheScope } from "../cache/cache-scope.js";
+import type { EntryData, InterceptEntry, InterceptSelectorContext, MetricsStore } from "../server/context.js";
+import type { HandlerContext, ResolvedSegment, ShouldRevalidateFn } from "../types.js";
+import type { RouteMatchResult } from "./pattern-matching.js";
+/**
+ * Revalidation context passed to segment resolution
+ */
+export interface 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;
+}
+/**
+ * Result from intercept lookup
+ */
+export interface InterceptResult {
+    intercept: InterceptEntry;
+    entry: EntryData;
+}
+/**
+ * Router context available via AsyncLocalStorage
+ *
+ * Contains closure functions from createRouter() that middleware needs access to.
+ * Instead of passing 20+ parameters, middleware calls getRouterContext() to access them.
+ */
+export interface RouterContext<TEnv = any> {
+    findMatch: (pathname: string) => RouteMatchResult | null;
+    loadManifest: (entry: any, routeKey: string, pathname: string, metricsStore?: MetricsStore, isSSR?: boolean) => Promise<EntryData>;
+    traverseBack: (entry: EntryData) => Generator<EntryData>;
+    createHandlerContext: (params: Record<string, string>, request: Request, searchParams: URLSearchParams, pathname: string, url: URL, bindings?: any, routeMap?: Record<string, string>, routeName?: string) => HandlerContext<any, TEnv>;
+    setupLoaderAccess: (ctx: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>) => void;
+    setupLoaderAccessSilent: (ctx: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>) => void;
+    getContext: () => {
+        getOrCreateStore: (key: string) => any;
+        runWithStore: <T>(store: any, namespace: string, parent: any, fn: () => T) => T;
+    };
+    getMetricsStore: () => MetricsStore | undefined;
+    createCacheScope: (cacheConfig: any, parent: CacheScope | null) => CacheScope | null;
+    findInterceptForRoute: (routeKey: string, parentEntry: EntryData | null, selectorContext: InterceptSelectorContext, isAction: boolean) => InterceptResult | null;
+    resolveAllSegmentsWithRevalidation: (entries: EntryData[], routeKey: string, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, clientSegmentSet: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, loaderPromises: Map<string, Promise<any>>, actionContext: any | undefined, interceptResult: InterceptResult | null, localRouteName: string, pathname: string) => Promise<{
+        segments: ResolvedSegment[];
+        matchedIds: string[];
+    }>;
+    resolveAllSegmentsWithRevalidationGenerator?: (entries: EntryData[], routeKey: string, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, clientSegmentSet: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, loaderPromises: Map<string, Promise<any>>, actionContext?: any) => AsyncGenerator<ResolvedSegment | {
+        __type: "id";
+        id: string;
+    }>;
+    resolveInterceptEntry: (intercept: InterceptEntry, entry: EntryData, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, belongsToRoute: boolean, revalidationContext?: RevalidationContext) => Promise<ResolvedSegment[]>;
+    collectWithMarkers?: <T>(gen: AsyncGenerator<T | {
+        __type: "id";
+        id: string;
+    }>) => Promise<{
+        items: T[];
+        matchedIds: string[];
+    }>;
+    evaluateRevalidation: (params: {
+        segment: ResolvedSegment;
+        prevParams: Record<string, string>;
+        getPrevSegment: (() => Promise<ResolvedSegment | undefined>) | null;
+        request: Request;
+        prevUrl: URL;
+        nextUrl: URL;
+        revalidations: Array<{
+            name: string;
+            fn: any;
+        }>;
+        routeKey: string;
+        context: HandlerContext<any, TEnv>;
+        actionContext?: any;
+        stale?: boolean;
+    }) => Promise<boolean>;
+    getRequestContext: () => {
+        waitUntil: (fn: () => Promise<void>) => void;
+        _handleStore?: any;
+    } | undefined;
+    resolveAllSegments: (entries: EntryData[], routeKey: string, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>) => Promise<ResolvedSegment[]>;
+    resolveAllSegmentsGenerator?: (entries: EntryData[], routeKey: string, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>) => AsyncGenerator<ResolvedSegment | {
+        __type: "id";
+        id: string;
+    }>;
+    collectSegmentsFromGenerator?: <T>(gen: AsyncGenerator<T | {
+        __type: "id";
+        id: string;
+    }>) => Promise<T[]>;
+    createHandleStore: () => any;
+    resolveLoadersOnly?: (entries: EntryData[], handlerContext: HandlerContext<any, TEnv>) => Promise<ResolvedSegment[]>;
+    resolveLoadersOnlyWithRevalidation?: (entries: EntryData[], handlerContext: HandlerContext<any, TEnv>, clientSegmentSet: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, actionContext?: any) => Promise<{
+        segments: ResolvedSegment[];
+        matchedIds: string[];
+    }>;
+    buildEntryRevalidateMap?: (entries: EntryData[]) => Map<string, {
+        revalidate: ShouldRevalidateFn[];
+    }>;
+    resolveInterceptLoadersOnly?: (intercept: InterceptEntry, entry: EntryData, params: Record<string, string>, handlerContext: HandlerContext<any, TEnv>, belongsToRoute: boolean, revalidationContext: {
+        clientSegmentIds: Set<string>;
+        prevParams: Record<string, string>;
+        request: Request;
+        prevUrl: URL;
+        nextUrl: URL;
+        routeKey: string;
+        actionContext?: any;
+        stale?: boolean;
+    }) => Promise<{
+        loaderDataPromise: Promise<any[]> | any[];
+        loaderIds: string[];
+    } | null>;
+}
+/**
+ * Get router dependencies from AsyncLocalStorage context
+ *
+ * @throws Error if called outside of router context (runWithRouterContext)
+ */
+export declare function getRouterContext<TEnv = any>(): RouterContext<TEnv>;
+/**
+ * Run a function with router dependencies available via getRouterContext()
+ *
+ * All async code within fn() can call getRouterContext() to access router closures.
+ * This works across async boundaries thanks to AsyncLocalStorage.
+ *
+ * @param deps Router dependencies to make available
+ * @param fn Function to run with dependencies available
+ * @returns Result of fn()
+ */
+export declare function runWithRouterContext<T, TEnv = any>(deps: RouterContext<TEnv>, fn: () => T): T;
+//# sourceMappingURL=router-context.d.ts.map

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

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

package/dist/router/router-context.js

@@ -0,0 +1,36 @@
+/**
+ * Router Context using AsyncLocalStorage
+ *
+ * Provides clean dependency injection for router middleware without parameter drilling.
+ * All closure functions from createRouter() are made available via getRouterContext().
+ */
+import { AsyncLocalStorage } from "async_hooks";
+// AsyncLocalStorage instance for router context
+const routerContext = new AsyncLocalStorage();
+/**
+ * Get router dependencies from AsyncLocalStorage context
+ *
+ * @throws Error if called outside of router context (runWithRouterContext)
+ */
+export function getRouterContext() {
+    const deps = routerContext.getStore();
+    if (!deps) {
+        throw new Error("getRouterContext() called outside of router context. " +
+            "Ensure code is running inside runWithRouterContext().");
+    }
+    return deps;
+}
+/**
+ * Run a function with router dependencies available via getRouterContext()
+ *
+ * All async code within fn() can call getRouterContext() to access router closures.
+ * This works across async boundaries thanks to AsyncLocalStorage.
+ *
+ * @param deps Router dependencies to make available
+ * @param fn Function to run with dependencies available
+ * @returns Result of fn()
+ */
+export function runWithRouterContext(deps, fn) {
+    return routerContext.run(deps, fn);
+}
+//# sourceMappingURL=router-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router-context.js","sourceRoot":"","sources":["../../src/router/router-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAmQhD,gDAAgD;AAChD,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAsB,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,uDAAuD,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,IAA2B,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAyB,EACzB,EAAW;IAEX,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,127 @@
+/**
+ * Segment Resolution
+ *
+ * Extracted from createRouter closure. Contains all segment resolution functions
+ * for both fresh (full match) and revalidation (partial match) paths.
+ *
+ * Functions receive a `deps` parameter for closure-bound helpers from createRouter.
+ */
+import type { ReactNode } from "react";
+import type { EntryData } from "../server/context";
+import type { HandlerContext, ResolvedSegment, ShouldRevalidateFn } from "../types";
+import type { SegmentResolutionDeps, SegmentRevalidationResult, ActionContext } from "./types.js";
+/**
+ * Handle Response returns from handlers.
+ * When a handler returns a Response (e.g., redirect), throw it to trigger
+ * the short-circuit mechanism. Otherwise return the ReactNode.
+ */
+export declare function handleHandlerResult(result: ReactNode | Response | Promise<ReactNode> | Promise<Response>): ReactNode;
+/**
+ * Resolve loaders for an entry and emit segments.
+ * Loaders are run lazily via ctx.use() and memoized for parallel execution.
+ */
+export declare function resolveLoaders<TEnv>(entry: EntryData, ctx: HandlerContext<any, TEnv>, belongsToRoute: boolean, deps: SegmentResolutionDeps<TEnv>, shortCodeOverride?: string): Promise<ResolvedSegment[]>;
+/**
+ * Options for segment resolution.
+ */
+export interface ResolveSegmentOptions {
+    /** When true, skip resolveLoaders() calls (used for pre-rendering) */
+    skipLoaders?: boolean;
+}
+/**
+ * Resolve segments from EntryData.
+ * Executes middlewares, loaders, parallels, and handlers in correct order.
+ * Returns array: [main segment, ...orphan layout segments]
+ */
+export declare function resolveSegment<TEnv>(entry: EntryData, routeKey: string, params: Record<string, string>, context: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>, deps: SegmentResolutionDeps<TEnv>, isRouteEntry?: boolean, options?: ResolveSegmentOptions): Promise<ResolvedSegment[]>;
+/**
+ * Resolve orphan layout with its middlewares, loaders, and parallels.
+ */
+export declare function resolveOrphanLayout<TEnv>(orphan: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>, belongsToRoute: boolean, deps: SegmentResolutionDeps<TEnv>): Promise<ResolvedSegment[]>;
+/**
+ * Resolve parallel EntryData with its loaders and slot handlers.
+ */
+export declare function resolveParallelEntry<TEnv>(parallelEntry: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, belongsToRoute: boolean, parentShortCode: string, deps: SegmentResolutionDeps<TEnv>): Promise<ResolvedSegment[]>;
+/**
+ * Wrapper that adds error boundary handling to segment resolution.
+ */
+export declare function resolveWithErrorHandling<TEnv>(entry: EntryData, routeKey: string, params: Record<string, string>, context: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>, resolveFn: () => Promise<ResolvedSegment[]>, deps: SegmentResolutionDeps<TEnv>, errorContext?: {
+    env?: TEnv;
+    isPartial?: boolean;
+    requestStartTime?: number;
+}): Promise<ResolvedSegment[]>;
+/**
+ * Resolve all segments for a route (used for single-cache-per-request pattern).
+ */
+export declare function resolveAllSegments<TEnv>(entries: EntryData[], routeKey: string, params: Record<string, string>, context: HandlerContext<any, TEnv>, loaderPromises: Map<string, Promise<any>>, deps: SegmentResolutionDeps<TEnv>, options?: ResolveSegmentOptions): Promise<ResolvedSegment[]>;
+/**
+ * Resolve only loader segments for all entries (used when serving cached non-loader segments).
+ */
+export declare function resolveLoadersOnly<TEnv>(entries: EntryData[], context: HandlerContext<any, TEnv>, deps: SegmentResolutionDeps<TEnv>): Promise<ResolvedSegment[]>;
+/**
+ * Resolve loaders with revalidation awareness (for partial rendering).
+ * Returns both segments to render AND all matched segment IDs.
+ */
+export declare function resolveLoadersWithRevalidation<TEnv>(entry: EntryData, ctx: HandlerContext<any, TEnv>, belongsToRoute: boolean, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext, shortCodeOverride?: string, stale?: boolean): Promise<{
+    segments: ResolvedSegment[];
+    matchedIds: string[];
+}>;
+/**
+ * Resolve only loader segments for all entries with revalidation logic.
+ */
+export declare function resolveLoadersOnlyWithRevalidation<TEnv>(entries: EntryData[], context: HandlerContext<any, TEnv>, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext): Promise<{
+    segments: ResolvedSegment[];
+    matchedIds: string[];
+}>;
+/**
+ * Build a map of segment shortCode -> entry with revalidate functions.
+ */
+export declare function buildEntryRevalidateMap(entries: EntryData[]): Map<string, {
+    entry: EntryData;
+    revalidate: ShouldRevalidateFn<any, any>[];
+}>;
+/**
+ * Resolve parallel segments with revalidation.
+ */
+export declare function resolveParallelSegmentsWithRevalidation<TEnv>(entry: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, belongsToRoute: boolean, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext, stale?: boolean): Promise<SegmentRevalidationResult>;
+/**
+ * Resolve entry handler (layout, cache, or route) with revalidation.
+ */
+export declare function resolveEntryHandlerWithRevalidation<TEnv>(entry: Exclude<EntryData, {
+    type: "parallel";
+}>, params: Record<string, string>, context: HandlerContext<any, TEnv>, belongsToRoute: boolean, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext, stale?: boolean): Promise<{
+    segment: ResolvedSegment;
+    matchedId: string;
+}>;
+/**
+ * Resolve segments with revalidation awareness (for partial rendering).
+ */
+export declare function resolveSegmentWithRevalidation<TEnv>(entry: Exclude<EntryData, {
+    type: "parallel";
+}>, routeKey: string, params: Record<string, string>, context: HandlerContext<any, TEnv>, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, loaderPromises: Map<string, Promise<any>>, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext, stale?: boolean): Promise<SegmentRevalidationResult>;
+/**
+ * Resolve orphan layout with revalidation.
+ */
+export declare function resolveOrphanLayoutWithRevalidation<TEnv>(orphan: EntryData, params: Record<string, string>, context: HandlerContext<any, TEnv>, clientSegmentIds: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, routeKey: string, loaderPromises: Map<string, Promise<any>>, belongsToRoute: boolean, deps: SegmentResolutionDeps<TEnv>, actionContext?: ActionContext, stale?: boolean): Promise<SegmentRevalidationResult>;
+/**
+ * Wrapper for segment resolution with revalidation that adds error boundary handling.
+ */
+export declare function resolveWithRevalidationErrorHandling<TEnv>(entry: EntryData, params: Record<string, string>, resolveFn: () => Promise<SegmentRevalidationResult>, deps: SegmentResolutionDeps<TEnv>, pathname?: string, errorContext?: {
+    request: Request;
+    url: URL;
+    routeKey?: string;
+    env?: TEnv;
+    isPartial?: boolean;
+    requestStartTime?: number;
+}): Promise<SegmentRevalidationResult>;
+/**
+ * Resolve all segments for a route with revalidation logic (for matchPartial).
+ */
+export declare function resolveAllSegmentsWithRevalidation<TEnv>(entries: EntryData[], routeKey: string, params: Record<string, string>, context: HandlerContext<any, TEnv>, clientSegmentSet: Set<string>, prevParams: Record<string, string>, request: Request, prevUrl: URL, nextUrl: URL, loaderPromises: Map<string, Promise<any>>, actionContext: ActionContext | undefined, interceptResult: {
+    intercept: any;
+    entry: EntryData;
+} | null, localRouteName: string, pathname: string, deps: SegmentResolutionDeps<TEnv>): Promise<{
+    segments: ResolvedSegment[];
+    matchedIds: string[];
+}>;
+//# sourceMappingURL=segment-resolution.d.ts.map

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

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