@rangojs/router 0.4.0 → 0.4.2

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

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

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

@@ -0,0 +1,99 @@
+/**
+ * Segment Resolution Middleware
+ *
+ * Resolves route segments when cache misses. Skips if cache hit.
+ *
+ * FLOW DIAGRAM
+ * ============
+ *
+ *   source (from cache-lookup)
+ *         |
+ *         v
+ *   +---------------------------+
+ *   | Iterate source first!    |  <-- CRITICAL: Must drain source
+ *   | yield* source            |      to let cache-lookup run
+ *   +---------------------------+
+ *         |
+ *         v
+ *   +---------------------+
+ *   | state.cacheHit?     |──yes──> return (cache already yielded)
+ *   +---------------------+
+ *         | no
+ *         v
+ *   +---------------------+
+ *   | isFullMatch?        |
+ *   +---------------------+
+ *         |
+ *   +-----+-----+
+ *   |           |
+ *  yes          no
+ *   |           |
+ *   v           v
+ * resolveAll  resolveAllWithRevalidation
+ * Segments    Segments
+ *   |           |
+ *   |           | (compares with prev state)
+ *   |           | (handles null components)
+ *   |           |
+ *   +-----------+
+ *         |
+ *         v
+ *   +---------------------------+
+ *   | Update state:             |
+ *   |  - state.segments         |
+ *   |  - state.matchedIds       |
+ *   +---------------------------+
+ *         |
+ *         v
+ *   yield all resolved segments
+ *         |
+ *         v
+ *      next middleware
+ *
+ *
+ * RESOLUTION MODES
+ * ================
+ *
+ * Full Match (document request):
+ *   - Uses resolveAllSegments()
+ *   - No revalidation logic (nothing to compare against)
+ *   - Simple resolution of all route entries
+ *
+ * Partial Match (navigation):
+ *   - Uses resolveAllSegmentsWithRevalidation()
+ *   - Compares current vs previous params/URL
+ *   - Sets component = null for segments client already has
+ *   - Respects custom revalidation rules
+ *
+ *
+ * CRITICAL: SOURCE ITERATION
+ * ==========================
+ *
+ * The middleware MUST iterate the source generator before checking cacheHit:
+ *
+ *   for await (const segment of source) { yield segment; }
+ *
+ * This is because:
+ *   1. Generator middleware are lazy (don't execute until iterated)
+ *   2. cache-lookup sets state.cacheHit during iteration
+ *   3. Without draining source first, cache-lookup never runs
+ *
+ * Incorrect pattern:
+ *   if (!state.cacheHit) { ... }  // cacheHit still false!
+ *   yield* source;                // Too late, already resolved
+ *
+ * Correct pattern:
+ *   yield* source;                // Let cache-lookup set cacheHit
+ *   if (state.cacheHit) return;   // Now we can check
+ */
+import type { ResolvedSegment } from "../../types.js";
+import type { MatchContext, MatchPipelineState } from "../match-context.js";
+import type { GeneratorMiddleware } from "./cache-lookup.js";
+/**
+ * Creates segment resolution middleware
+ *
+ * Only runs on cache miss (state.cacheHit === false).
+ * Uses resolveAllSegmentsWithRevalidation from RouterContext to resolve segments.
+ */
+export declare function withSegmentResolution<TEnv>(ctx: MatchContext<TEnv>, state: MatchPipelineState): GeneratorMiddleware<ResolvedSegment>;
+//# sourceMappingURL=segment-resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"segment-resolution.d.ts","sourceRoot":"","sources":["../../../src/router/match-middleware/segment-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EACxC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,kBAAkB,GACxB,mBAAmB,CAAC,eAAe,CAAC,CAiFtC"}

package/dist/router/match-middleware/segment-resolution.js

@@ -0,0 +1,53 @@
+import { getRouterContext } from "../router-context.js";
+/**
+ * Creates segment resolution middleware
+ *
+ * Only runs on cache miss (state.cacheHit === false).
+ * Uses resolveAllSegmentsWithRevalidation from RouterContext to resolve segments.
+ */
+export function withSegmentResolution(ctx, state) {
+    return async function* (source) {
+        const pipelineStart = performance.now();
+        const ms = ctx.metricsStore;
+        // IMPORTANT: Always iterate source first to give cache-lookup a chance
+        // to run and set state.cacheHit. Without this, cache-lookup never executes!
+        for await (const segment of source) {
+            yield segment;
+        }
+        // If cache hit, segments were already yielded by cache lookup
+        if (state.cacheHit) {
+            if (ms) {
+                ms.metrics.push({ label: "pipeline:segment-resolve", duration: performance.now() - pipelineStart, startTime: pipelineStart - ms.requestStart });
+            }
+            return;
+        }
+        const { resolveAllSegmentsWithRevalidation, resolveAllSegments } = getRouterContext();
+        const Store = ctx.Store;
+        if (ctx.isFullMatch) {
+            // Full match (document request) - simple resolution without revalidation
+            const segments = await Store.run(() => resolveAllSegments(ctx.entries, ctx.routeKey, ctx.matched.params, ctx.handlerContext, ctx.loaderPromises));
+            // Update state with resolved segments
+            state.segments = segments;
+            state.matchedIds = segments.map((s) => s.id);
+            // Yield all resolved segments
+            for (const segment of segments) {
+                yield segment;
+            }
+        }
+        else {
+            // Partial match (navigation) - resolution with revalidation logic
+            const result = await Store.run(() => resolveAllSegmentsWithRevalidation(ctx.entries, ctx.routeKey, ctx.matched.params, ctx.handlerContext, ctx.clientSegmentSet, ctx.prevParams, ctx.request, ctx.prevUrl, ctx.url, ctx.loaderPromises, ctx.actionContext, ctx.interceptResult, ctx.localRouteName, ctx.pathname));
+            // Update state with resolved segments
+            state.segments = result.segments;
+            state.matchedIds = result.matchedIds;
+            // Yield all resolved segments
+            for (const segment of result.segments) {
+                yield segment;
+            }
+        }
+        if (ms) {
+            ms.metrics.push({ label: "pipeline:segment-resolve", duration: performance.now() - pipelineStart, startTime: pipelineStart - ms.requestStart });
+        }
+    };
+}
+//# sourceMappingURL=segment-resolution.js.map

package/dist/router/match-middleware/segment-resolution.js.map

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

package/dist/router/match-pipelines.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Match Pipelines
+ *
+ * Composes async generator middleware into pipelines for route matching.
+ * The pipeline transforms navigation requests into resolved UI segments.
+ *
+ * PIPELINE ARCHITECTURE OVERVIEW
+ * ==============================
+ *
+ * The router uses a pipeline of async generator middleware to process requests.
+ * Each middleware can:
+ *   1. Produce segments (yield)
+ *   2. Transform segments from upstream
+ *   3. Observe segments without modifying them
+ *   4. Trigger side effects (caching, background revalidation)
+ *
+ * REQUEST FLOW DIAGRAM
+ * ====================
+ *
+ *   Navigation Request
+ *         |
+ *         v
+ *   +------------------+
+ *   | Create Context   |  MatchContext: routes, params, client state
+ *   +------------------+
+ *         |
+ *         v
+ *   +------------------+
+ *   | Select Pipeline  |  Full (document) vs Partial (navigation)
+ *   +------------------+
+ *         |
+ *         v
+ *   ==================== PIPELINE EXECUTION ====================
+ *   |                                                          |
+ *   |  empty() ─────> [1] ─────> [2] ─────> [3] ─────> [4] ───>|───> segments
+ *   |    |            |          |          |          |       |
+ *   |    |    cache   |  segment |intercept | cache   | bg     |
+ *   |    |   lookup   | resolve  | resolve  | store   | reval  |
+ *   |                                                          |
+ *   ============================================================
+ *         |
+ *         v
+ *   +------------------+
+ *   | Collect Result   |  Filter segments, build MatchResult
+ *   +------------------+
+ *         |
+ *         v
+ *   RSC Stream Response
+ *
+ *
+ * MIDDLEWARE EXECUTION ORDER
+ * ==========================
+ *
+ * Middleware compose in reverse order (rightmost = innermost, runs first):
+ *
+ *   compose(A, B, C)(source)  =>  source -> C -> B -> A -> output
+ *
+ * For the partial match pipeline:
+ *
+ *   compose(
+ *     withBackgroundRevalidation,  // [5] Outermost - triggers SWR
+ *     withCacheStore,              // [4] Stores segments in cache
+ *     withInterceptResolution,     // [3] Resolves intercept segments
+ *     withSegmentResolution,       // [2] Resolves on cache miss
+ *     withCacheLookup              // [1] Innermost - checks cache first
+ *   )
+ *
+ * Execution flow for cache MISS:
+ *
+ *   empty() yields nothing
+ *     -> [1] cache-lookup: no cache, passes through
+ *     -> [2] segment-resolution: resolves segments, yields them
+ *     -> [3] intercept-resolution: resolves intercepts, yields them
+ *     -> [4] cache-store: observes all, stores in cache
+ *     -> [5] bg-revalidation: no-op (wasn't stale)
+ *     -> output: all segments
+ *
+ * Execution flow for cache HIT (stale):
+ *
+ *   empty() yields nothing
+ *     -> [1] cache-lookup: HIT! yields cached segments + fresh loaders
+ *     -> [2] segment-resolution: sees cacheHit=true, skips
+ *     -> [3] intercept-resolution: extracts intercepts from cache
+ *     -> [4] cache-store: sees cacheHit=true, skips
+ *     -> [5] bg-revalidation: triggers waitUntil() to revalidate
+ *     -> output: cached segments + fresh loader data
+ *
+ *
+ * TWO PIPELINE VARIANTS
+ * =====================
+ *
+ * 1. createMatchPipeline (Full Match)
+ *    - Used for document requests (initial page load)
+ *    - No revalidation logic (no previous state to compare)
+ *    - Simpler segment resolution
+ *
+ * 2. createMatchPartialPipeline (Partial Match)
+ *    - Used for client-side navigation
+ *    - Includes revalidation for SWR
+ *    - Compares with previous params/URL
+ *    - Supports intercepts (soft navigation modals)
+ */
+import type { ResolvedSegment } from "../types.js";
+import type { MatchContext, MatchPipelineState } from "./match-context.js";
+import type { GeneratorMiddleware } from "./match-middleware/index.js";
+/**
+ * Compose multiple async generator middleware into a single middleware
+ *
+ * Middleware are applied in reverse order (rightmost runs first, innermost).
+ * For the pipeline:
+ *   compose(A, B, C)(source)
+ *
+ * The flow is: source -> C -> B -> A -> output
+ * Where C is the innermost (runs first on input) and A is outermost (runs last).
+ */
+export declare function compose<T>(...middleware: GeneratorMiddleware<T>[]): GeneratorMiddleware<T>;
+/**
+ * Create an empty async generator (source for pipeline)
+ */
+export declare function empty<T>(): AsyncGenerator<T>;
+/**
+ * Create the match partial pipeline
+ *
+ * Pipeline order (innermost to outermost):
+ * 1. cache-lookup    - Check cache first, yield cached segments if hit
+ * 2. segment-resolution - Resolve segments if cache miss
+ * 3. intercept-resolution - Resolve intercept segments
+ * 4. cache-store     - Store segments in cache
+ * 5. background-revalidation - Trigger SWR if cache was stale
+ *
+ * Data flow:
+ * - empty() produces no segments
+ * - cache-lookup either yields cached segments OR passes through to segment-resolution
+ * - segment-resolution resolves fresh segments on cache miss
+ * - intercept-resolution adds intercept segments
+ * - cache-store observes and caches segments
+ * - background-revalidation triggers SWR revalidation if needed
+ */
+export declare function createMatchPartialPipeline<TEnv>(ctx: MatchContext<TEnv>, state: MatchPipelineState): AsyncGenerator<ResolvedSegment>;
+/**
+ * Create the full match pipeline (simpler, no revalidation)
+ *
+ * Used for document requests (initial page load) where we don't need
+ * revalidation logic since there's no previous state to compare against.
+ */
+export declare function createMatchPipeline<TEnv>(ctx: MatchContext<TEnv>, state: MatchPipelineState): AsyncGenerator<ResolvedSegment>;
+//# sourceMappingURL=match-pipelines.d.ts.map

package/dist/router/match-pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-pipelines.d.ts","sourceRoot":"","sources":["../../src/router/match-pipelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AASvE;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,GAAG,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,GACtC,mBAAmB,CAAC,CAAC,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAuB,KAAK,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAEnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAC7C,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC,eAAe,CAAC,CAiBjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EACtC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC,eAAe,CAAC,CAmBjC"}

package/dist/router/match-pipelines.js

@@ -0,0 +1,82 @@
+import { withBackgroundRevalidation, withCacheLookup, withCacheStore, withInterceptResolution, withSegmentResolution, } from "./match-middleware/index.js";
+/**
+ * Compose multiple async generator middleware into a single middleware
+ *
+ * Middleware are applied in reverse order (rightmost runs first, innermost).
+ * For the pipeline:
+ *   compose(A, B, C)(source)
+ *
+ * The flow is: source -> C -> B -> A -> output
+ * Where C is the innermost (runs first on input) and A is outermost (runs last).
+ */
+export function compose(...middleware) {
+    if (middleware.length === 0) {
+        return (source) => source;
+    }
+    if (middleware.length === 1) {
+        return middleware[0];
+    }
+    return (source) => {
+        // Apply middleware in reverse order (rightmost first)
+        return middleware.reduceRight((prev, fn) => fn(prev), source);
+    };
+}
+/**
+ * Create an empty async generator (source for pipeline)
+ */
+export async function* empty() {
+    // Yields nothing - used as the initial source for the pipeline
+}
+/**
+ * Create the match partial pipeline
+ *
+ * Pipeline order (innermost to outermost):
+ * 1. cache-lookup    - Check cache first, yield cached segments if hit
+ * 2. segment-resolution - Resolve segments if cache miss
+ * 3. intercept-resolution - Resolve intercept segments
+ * 4. cache-store     - Store segments in cache
+ * 5. background-revalidation - Trigger SWR if cache was stale
+ *
+ * Data flow:
+ * - empty() produces no segments
+ * - cache-lookup either yields cached segments OR passes through to segment-resolution
+ * - segment-resolution resolves fresh segments on cache miss
+ * - intercept-resolution adds intercept segments
+ * - cache-store observes and caches segments
+ * - background-revalidation triggers SWR revalidation if needed
+ */
+export function createMatchPartialPipeline(ctx, state) {
+    // Build the middleware chain
+    const pipeline = compose(
+    // Outermost - observes segments and triggers background revalidation
+    withBackgroundRevalidation(ctx, state), 
+    // Observes and stores segments in cache
+    withCacheStore(ctx, state), 
+    // Adds intercept segments after main segments
+    withInterceptResolution(ctx, state), 
+    // Resolves segments on cache miss
+    withSegmentResolution(ctx, state), 
+    // Innermost - checks cache first
+    withCacheLookup(ctx, state));
+    // Start with empty source - cache lookup or segment resolution will produce segments
+    return pipeline(empty());
+}
+/**
+ * Create the full match pipeline (simpler, no revalidation)
+ *
+ * Used for document requests (initial page load) where we don't need
+ * revalidation logic since there's no previous state to compare against.
+ */
+export function createMatchPipeline(ctx, state) {
+    // For full match, we only need:
+    // 1. Cache lookup
+    // 2. Segment resolution (without revalidation)
+    // 3. Intercept resolution
+    // 4. Cache store
+    // Note: Full match uses different resolution logic (resolveAllSegments instead of
+    // resolveAllSegmentsWithRevalidation). This will be handled by the segment resolution
+    // middleware checking ctx.isFullMatch or similar flag.
+    const pipeline = compose(withCacheStore(ctx, state), withInterceptResolution(ctx, state), withSegmentResolution(ctx, state), withCacheLookup(ctx, state));
+    return pipeline(empty());
+}
+//# sourceMappingURL=match-pipelines.js.map

package/dist/router/match-pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-pipelines.js","sourceRoot":"","sources":["../../src/router/match-pipelines.ts"],"names":[],"mappings":"AAyGA,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CACrB,GAAG,UAAoC;IAEvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;IAC5B,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,sDAAsD;QACtD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,KAAK;IAC1B,+DAA+D;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAuB,EACvB,KAAyB;IAEzB,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,OAAO;IACtB,qEAAqE;IACrE,0BAA0B,CAAC,GAAG,EAAE,KAAK,CAAC;IACtC,wCAAwC;IACxC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC;IAC1B,8CAA8C;IAC9C,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC;IACnC,kCAAkC;IAClC,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC;IACjC,iCAAiC;IACjC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAC5B,CAAC;IAEF,qFAAqF;IACrF,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAuB,EACvB,KAAyB;IAEzB,gCAAgC;IAChC,kBAAkB;IAClB,+CAA+C;IAC/C,0BAA0B;IAC1B,iBAAiB;IAEjB,kFAAkF;IAClF,sFAAsF;IACtF,uDAAuD;IAEvD,MAAM,QAAQ,GAAG,OAAO,CACtB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,EAC1B,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC,EACnC,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,EACjC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAC5B,CAAC;IAEF,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/router/match-result.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Match Result Collection
+ *
+ * Collects segments from the pipeline and builds the final MatchResult.
+ * This is the final stage of the match pipeline.
+ *
+ * COLLECTION FLOW
+ * ===============
+ *
+ *   Pipeline Generator
+ *         |
+ *         v
+ *   +---------------------------+
+ *   | collectSegments()        |  Drain async generator
+ *   | for await...push         |
+ *   +---------------------------+
+ *         |
+ *         v
+ *   +---------------------------+
+ *   | buildMatchResult()       |  Transform to MatchResult
+ *   +---------------------------+
+ *         |
+ *         |
+ *   +-----+-----+
+ *   |           |
+ * Full       Partial
+ * Match      Match
+ *   |           |
+ *   v           v
+ * All segs   Filter:
+ * rendered   - null components out
+ *            - keep loaders
+ *            - handle intercepts
+ *   |           |
+ *   +-----------+
+ *         |
+ *         v
+ *   MatchResult {
+ *     segments,    // Segments to render
+ *     matched,     // All segment IDs
+ *     diff,        // Changed segment IDs
+ *     params,      // Route params
+ *     slots,       // Intercept slot data
+ *     serverTiming // Performance metrics
+ *   }
+ *
+ *
+ * FULL VS PARTIAL MATCH
+ * =====================
+ *
+ * Full Match (document request):
+ *   - All segments are rendered
+ *   - allIds = all segment IDs
+ *   - No filtering needed
+ *
+ * Partial Match (navigation):
+ *   - Filter out null components (client already has them)
+ *   - BUT keep loader segments (they carry data)
+ *   - Handle intercepts specially (preserve client page + add modal)
+ *
+ *
+ * SEGMENT FILTERING RULES
+ * =======================
+ *
+ * For partial match, segments are filtered:
+ *
+ *   Keep if:
+ *     - component !== null (needs rendering)
+ *     - type === "loader" (carries data even with null component)
+ *
+ *   Skip if:
+ *     - component === null AND type !== "loader"
+ *     - (Client already has this segment's UI)
+ *
+ *
+ * INTERCEPT HANDLING
+ * ==================
+ *
+ * When intercepting (modal over current page):
+ *
+ *   allIds = client segments + intercept segments
+ *
+ * This tells the client:
+ *   1. Keep your current segments
+ *   2. Add these intercept segments to the modal slot
+ *
+ * The page stays visible, modal renders on top.
+ *
+ *
+ * MATCHRESULT STRUCTURE
+ * =====================
+ *
+ * {
+ *   segments: ResolvedSegment[]  // Segments to serialize and render
+ *   matched: string[]            // All segment IDs for this route
+ *   diff: string[]               // Which segments changed (for client diffing)
+ *   params: Record<string,string> // Route parameters
+ *   slots?: Record<string, {...}> // Named slot data for intercepts
+ *   serverTiming?: string         // Server-Timing header value
+ *   routeMiddleware?: [...]       // Route middleware results
+ * }
+ *
+ * The client uses this to:
+ *   1. Render segments[] to the UI tree
+ *   2. Update internal state with matched[]
+ *   3. Diff against previous state with diff[]
+ *   4. Render slot content if slots present
+ */
+import type { MatchResult, ResolvedSegment } from "../types.js";
+import type { MatchContext, MatchPipelineState } from "./match-context.js";
+/**
+ * Collect all segments from an async generator
+ */
+export declare function collectSegments(generator: AsyncGenerator<ResolvedSegment>): Promise<ResolvedSegment[]>;
+/**
+ * Build the final MatchResult from collected segments and context
+ */
+export declare function buildMatchResult<TEnv>(allSegments: ResolvedSegment[], ctx: MatchContext<TEnv>, state: MatchPipelineState): MatchResult;
+/**
+ * Collect segments from pipeline and build MatchResult
+ *
+ * This is the main entry point for building the final result after
+ * the pipeline has processed all segments.
+ */
+export declare function collectMatchResult<TEnv>(pipeline: AsyncGenerator<ResolvedSegment>, ctx: MatchContext<TEnv>, state: MatchPipelineState): Promise<MatchResult>;
+//# sourceMappingURL=match-result.d.ts.map

package/dist/router/match-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-result.d.ts","sourceRoot":"","sources":["../../src/router/match-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2GG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI3E;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,cAAc,CAAC,eAAe,CAAC,GACzC,OAAO,CAAC,eAAe,EAAE,CAAC,CAM5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EACnC,WAAW,EAAE,eAAe,EAAE,EAC9B,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,kBAAkB,GACxB,WAAW,CAuEb;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAC3C,QAAQ,EAAE,cAAc,CAAC,eAAe,CAAC,EACzC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,WAAW,CAAC,CAStB"}

package/dist/router/match-result.js

@@ -0,0 +1,93 @@
+import { generateServerTiming, logMetrics } from "./metrics.js";
+import { debugLog } from "./logging.js";
+/**
+ * Collect all segments from an async generator
+ */
+export async function collectSegments(generator) {
+    const segments = [];
+    for await (const segment of generator) {
+        segments.push(segment);
+    }
+    return segments;
+}
+/**
+ * Build the final MatchResult from collected segments and context
+ */
+export function buildMatchResult(allSegments, ctx, state) {
+    const logPrefix = ctx.isFullMatch ? "[Router.match]" : "[Router.matchPartial]";
+    let allIds;
+    let segmentsToRender;
+    if (ctx.isFullMatch) {
+        // Full match (document request) - all segments are rendered
+        // Deduplicate by segment ID (defense-in-depth). The primary dedup is in
+        // resolveAllSegments, but this guards against any path that bypasses it.
+        // include() scopes can produce entries that resolve the same shared layout,
+        // and duplicate IDs change the client's React tree depth causing remounts.
+        const seen = new Set();
+        segmentsToRender = [];
+        for (const s of allSegments) {
+            if (!seen.has(s.id)) {
+                seen.add(s.id);
+                segmentsToRender.push(s);
+            }
+        }
+        allIds = segmentsToRender.map((s) => s.id);
+    }
+    else {
+        // Partial match (navigation) - filter and handle intercepts
+        // When intercepting, tell browser to keep its current segments + add modal
+        // This prevents the browser from discarding the current page content
+        // If client sent empty segments (HMR recovery), use segment IDs from allSegments
+        allIds = ctx.interceptResult
+            ? ctx.clientSegmentIds.length > 0
+                ? [...ctx.clientSegmentIds, ...state.interceptSegments.map((s) => s.id)]
+                : allSegments.map((s) => s.id) // Use actual segments, not matchedIds
+            : [...state.matchedIds, ...state.interceptSegments.map((s) => s.id)];
+        // Deduplicate allIds (defense-in-depth for partial match path)
+        allIds = [...new Set(allIds)];
+        // Filter out segments with null components (client already has them)
+        // BUT always include loader segments - they carry data even with null component
+        segmentsToRender = allSegments.filter((s) => s.component !== null || s.type === "loader");
+    }
+    debugLog(logPrefix, "all segments", {
+        segments: allSegments.map((s) => ({
+            id: s.id,
+            type: s.type,
+            hasComponent: s.component !== null,
+        })),
+    });
+    debugLog(logPrefix, "segments to render", {
+        segmentIds: segmentsToRender.map((s) => s.id),
+    });
+    // Output metrics if enabled
+    let serverTiming;
+    if (ctx.metricsStore) {
+        logMetrics(ctx.request.method, ctx.pathname, ctx.metricsStore);
+        serverTiming = generateServerTiming(ctx.metricsStore);
+    }
+    return {
+        segments: segmentsToRender,
+        matched: allIds,
+        diff: segmentsToRender.map((s) => s.id),
+        params: ctx.matched.params,
+        routeName: ctx.routeKey,
+        serverTiming,
+        slots: Object.keys(state.slots).length > 0 ? state.slots : undefined,
+        routeMiddleware: ctx.routeMiddleware.length > 0 ? ctx.routeMiddleware : undefined,
+    };
+}
+/**
+ * Collect segments from pipeline and build MatchResult
+ *
+ * This is the main entry point for building the final result after
+ * the pipeline has processed all segments.
+ */
+export async function collectMatchResult(pipeline, ctx, state) {
+    const allSegments = await collectSegments(pipeline);
+    // Update state with collected segments if not already set
+    if (state.segments.length === 0) {
+        state.segments = allSegments;
+    }
+    return buildMatchResult(allSegments, ctx, state);
+}
+//# sourceMappingURL=match-result.js.map

package/dist/router/match-result.js.map

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

package/dist/router/metrics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Router Metrics Utilities
+ *
+ * Performance metrics collection and reporting for RSC Router.
+ */
+import type { MetricsStore } from "../server/context";
+/**
+ * Create a metrics store for the request if debugPerformance is enabled
+ */
+export declare function createMetricsStore(debugPerformance: boolean): MetricsStore | undefined;
+/**
+ * Log metrics to console in a formatted way
+ */
+export declare function logMetrics(method: string, pathname: string, metricsStore: MetricsStore): void;
+/**
+ * Generate Server-Timing header value from metrics
+ * Format: metric-name;dur=X.XX
+ */
+export declare function generateServerTiming(metricsStore: MetricsStore): string;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/router/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,OAAO,GACxB,YAAY,GAAG,SAAS,CAO1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,YAAY,GACzB,IAAI,CAeN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAWvE"}