@rangojs/router 0.0.0-experimental.0b82333f

package/dist/__tests__/helpers/route-tree.d.ts

@@ -0,0 +1,118 @@
+import type { urls } from "../../urls.js";
+import { type EntryData, type InterceptEntry, type LoaderEntry } from "../../server/context.js";
+import { type RouteMatchResult } from "../../router/pattern-matching.js";
+import type { RouteEntry } from "../../types.js";
+export type { EntryData, InterceptEntry, LoaderEntry };
+export interface SegmentInfo {
+    id: string;
+    type: EntryData["type"];
+    pattern?: string;
+}
+export interface InterceptInfo {
+    slotName: string;
+    routeName: string;
+    hasWhen: boolean;
+    whenCount: number;
+    hasLoader: boolean;
+    hasMiddleware: boolean;
+}
+/**
+ * Build a route tree from url patterns for inspection.
+ *
+ * Executes the urls() handler inside RSCRouterContext and extracts
+ * the manifest, patterns, and route entries. Lazy includes are
+ * eagerly evaluated so the full tree is available.
+ *
+ * @example
+ * ```ts
+ * const tree = buildRouteTree(
+ *   urls(({ path, layout }) => [
+ *     layout(RootLayout, () => [
+ *       path("/", HomePage, { name: "home" }),
+ *       path("/about", AboutPage, { name: "about" }),
+ *     ]),
+ *   ])
+ * );
+ *
+ * // Inspect patterns
+ * expect(tree.routes()).toEqual({ home: "/", about: "/about" });
+ *
+ * // Inspect segment IDs
+ * expect(tree.segmentId("home")).toBe("M0L0L0R0");
+ *
+ * // Match a URL
+ * const match = tree.match("/about");
+ * expect(match?.routeKey).toBe("about");
+ * ```
+ */
+export declare function buildRouteTree(urlPatterns: ReturnType<typeof urls>, options?: {
+    mountIndex?: number;
+}): RouteTree;
+/**
+ * Wrapper around the raw manifest/patterns/entries providing
+ * convenient inspection methods for route tree, segment IDs,
+ * middleware, intercepts, loaders, and parallel slots.
+ */
+export declare class RouteTree {
+    readonly manifest: Map<string, EntryData>;
+    readonly patterns: Map<string, string>;
+    readonly routeEntries: RouteEntry[];
+    constructor(manifest: Map<string, EntryData>, patterns: Map<string, string>, routeEntries: RouteEntry[]);
+    /** Route name -> URL pattern map as a plain object */
+    routes(): Record<string, string>;
+    /** Get all route names */
+    routeNames(): string[];
+    /** Get the segment ID (shortCode) for a named route */
+    segmentId(name: string): string | undefined;
+    /** Get segment IDs for all named routes */
+    segmentIds(): Record<string, string>;
+    /**
+     * Get the full segment path from root to a named route.
+     * Returns an array of { id, type, pattern? } entries.
+     */
+    segmentPath(name: string): SegmentInfo[];
+    /** Get the EntryData for a named route */
+    entry(name: string): EntryData | undefined;
+    /** Get the EntryData for a route matching a URL pattern string */
+    entryByPattern(pattern: string): EntryData | undefined;
+    /** Match a pathname and return the match result (routeKey, params) */
+    match(pathname: string): RouteMatchResult | null;
+    /** Get middleware functions attached to a named route/layout */
+    middleware(name: string): Array<Function>;
+    /** Check if a named route/layout has middleware */
+    hasMiddleware(name: string): boolean;
+    /**
+     * Collect all middleware in the chain from root to a named route.
+     * Returns them in execution order (root first).
+     */
+    middlewareChain(name: string): Array<{
+        segmentId: string;
+        count: number;
+    }>;
+    /** Get intercept entries for a named route/layout */
+    intercepts(name: string): InterceptInfo[];
+    /** Get raw InterceptEntry objects for a named route/layout */
+    interceptEntries(name: string): InterceptEntry[];
+    /** Get loader entries for a named route/layout */
+    loaders(name: string): LoaderEntry[];
+    /** Check if a named route/layout has loaders */
+    hasLoaders(name: string): boolean;
+    /** Get parallel slot entries (child EntryData with type="parallel") */
+    parallelSlots(name: string): EntryData[];
+    /** Get parallel slot names for a named route/layout */
+    parallelSlotNames(name: string): string[];
+    /** Check if a named route/layout has an error boundary */
+    hasErrorBoundary(name: string): boolean;
+    /** Check if a named route/layout has a not-found boundary */
+    hasNotFoundBoundary(name: string): boolean;
+    /** Check if a named route/layout has cache config */
+    hasCache(name: string): boolean;
+    /** Check if a named route/layout has a loading component */
+    hasLoading(name: string): boolean;
+    /**
+     * Debug print the route tree.
+     * Useful for exploring the structure in tests.
+     */
+    debug(): string;
+}
+//# sourceMappingURL=route-tree.d.ts.map

package/dist/__tests__/helpers/route-tree.d.ts.map

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

package/dist/__tests__/helpers/route-tree.js

@@ -0,0 +1,374 @@
+/**
+ * Route Tree Test Utilities
+ *
+ * Builds a route tree from urls() patterns and exposes the manifest,
+ * patterns map, and route entries for inspection. Replicates the
+ * pattern extraction logic from createRouter.routes() (router.ts)
+ * without importing the full router (which depends on virtual modules).
+ *
+ * Not shipped with the npm package (lives in __tests__/).
+ */
+import React from "react";
+import { RSCRouterContext, runWithPrefixes, } from "../../server/context.js";
+import { findMatch, isLazyEvaluationNeeded, } from "../../router/pattern-matching.js";
+// ============================================================================
+// buildRouteTree
+// ============================================================================
+/**
+ * Build a route tree from url patterns for inspection.
+ *
+ * Executes the urls() handler inside RSCRouterContext and extracts
+ * the manifest, patterns, and route entries. Lazy includes are
+ * eagerly evaluated so the full tree is available.
+ *
+ * @example
+ * ```ts
+ * const tree = buildRouteTree(
+ *   urls(({ path, layout }) => [
+ *     layout(RootLayout, () => [
+ *       path("/", HomePage, { name: "home" }),
+ *       path("/about", AboutPage, { name: "about" }),
+ *     ]),
+ *   ])
+ * );
+ *
+ * // Inspect patterns
+ * expect(tree.routes()).toEqual({ home: "/", about: "/about" });
+ *
+ * // Inspect segment IDs
+ * expect(tree.segmentId("home")).toBe("M0L0L0R0");
+ *
+ * // Match a URL
+ * const match = tree.match("/about");
+ * expect(match?.routeKey).toBe("about");
+ * ```
+ */
+export function buildRouteTree(urlPatterns, options) {
+    const manifest = new Map();
+    const patterns = new Map();
+    const patternsByPrefix = new Map();
+    const trailingSlashMap = new Map();
+    const mountIndex = options?.mountIndex ?? 0;
+    // Synthetic root layout to match createRouter behavior
+    const syntheticMapRoot = {
+        type: "layout",
+        id: `#synthetic-maproot-M${mountIndex}`,
+        shortCode: `M${mountIndex}L0`,
+        parent: null,
+        handler: React.createElement(React.Fragment),
+        middleware: [],
+        revalidate: [],
+        errorBoundary: [],
+        notFoundBoundary: [],
+        layout: [],
+        parallel: [],
+        intercept: [],
+        loader: [],
+    };
+    let handlerResult = [];
+    RSCRouterContext.run({
+        manifest,
+        patterns,
+        patternsByPrefix,
+        trailingSlash: trailingSlashMap,
+        namespace: "root",
+        parent: syntheticMapRoot,
+        counters: {},
+        mountIndex,
+    }, () => {
+        handlerResult = urlPatterns.handler();
+    });
+    // Eagerly evaluate lazy includes
+    const lazyIncludes = findLazyIncludes(handlerResult);
+    for (const lazy of lazyIncludes) {
+        const lazyManifest = new Map();
+        const lazyPatterns = new Map();
+        const lazyCounters = {};
+        if (lazy.context.counters) {
+            for (const [key, value] of Object.entries(lazy.context.counters)) {
+                lazyCounters[key] = value;
+            }
+        }
+        RSCRouterContext.run({
+            manifest: lazyManifest,
+            patterns: lazyPatterns,
+            patternsByPrefix: new Map(),
+            trailingSlash: trailingSlashMap,
+            namespace: "lazy",
+            parent: lazy.context.parent ?? null,
+            counters: lazyCounters,
+            mountIndex,
+        }, () => {
+            const fullPrefix = (lazy.context.urlPrefix || "") + lazy.prefix;
+            if (fullPrefix || lazy.context.namePrefix) {
+                runWithPrefixes(fullPrefix, lazy.context.namePrefix, () => {
+                    lazy.patterns.handler();
+                });
+            }
+            else {
+                lazy.patterns.handler();
+            }
+        });
+        for (const [k, v] of lazyManifest)
+            manifest.set(k, v);
+        for (const [k, v] of lazyPatterns)
+            patterns.set(k, v);
+    }
+    // Build route entries for findMatch
+    const routesObject = {};
+    for (const [name, pattern] of patterns.entries()) {
+        routesObject[name] = pattern;
+    }
+    const routeEntries = [
+        {
+            prefix: "",
+            staticPrefix: "",
+            routes: routesObject,
+            handler: urlPatterns.handler,
+            mountIndex,
+        },
+    ];
+    return new RouteTree(manifest, patterns, routeEntries);
+}
+// ============================================================================
+// RouteTree
+// ============================================================================
+/**
+ * Wrapper around the raw manifest/patterns/entries providing
+ * convenient inspection methods for route tree, segment IDs,
+ * middleware, intercepts, loaders, and parallel slots.
+ */
+export class RouteTree {
+    constructor(manifest, patterns, routeEntries) {
+        this.manifest = manifest;
+        this.patterns = patterns;
+        this.routeEntries = routeEntries;
+    }
+    // --- Route patterns ---
+    /** Route name -> URL pattern map as a plain object */
+    routes() {
+        return Object.fromEntries(this.patterns);
+    }
+    /** Get all route names */
+    routeNames() {
+        return [...this.patterns.keys()];
+    }
+    // --- Segment IDs ---
+    /** Get the segment ID (shortCode) for a named route */
+    segmentId(name) {
+        return this.entry(name)?.shortCode;
+    }
+    /** Get segment IDs for all named routes */
+    segmentIds() {
+        const result = {};
+        for (const name of this.patterns.keys()) {
+            const id = this.segmentId(name);
+            if (id)
+                result[name] = id;
+        }
+        return result;
+    }
+    /**
+     * Get the full segment path from root to a named route.
+     * Returns an array of { id, type, pattern? } entries.
+     */
+    segmentPath(name) {
+        const entry = this.entry(name);
+        if (!entry)
+            return [];
+        const path = [];
+        let current = entry;
+        while (current) {
+            path.unshift({
+                id: current.shortCode,
+                type: current.type,
+                pattern: current.type === "route" ? current.pattern : undefined,
+            });
+            current = current.parent;
+        }
+        return path;
+    }
+    // --- Entry access ---
+    /** Get the EntryData for a named route */
+    entry(name) {
+        const direct = this.manifest.get(name);
+        if (direct)
+            return direct;
+        for (const [key, entry] of this.manifest) {
+            if (key.endsWith(`.${name}`))
+                return entry;
+        }
+        return undefined;
+    }
+    /** Get the EntryData for a route matching a URL pattern string */
+    entryByPattern(pattern) {
+        for (const entry of this.manifest.values()) {
+            if (entry.type === "route" && entry.pattern === pattern) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    // --- URL matching ---
+    /** Match a pathname and return the match result (routeKey, params) */
+    match(pathname) {
+        const result = findMatch(pathname, this.routeEntries);
+        if (!result || isLazyEvaluationNeeded(result))
+            return null;
+        return result;
+    }
+    // --- Middleware ---
+    /** Get middleware functions attached to a named route/layout */
+    middleware(name) {
+        const entry = this.entry(name);
+        return entry?.middleware ?? [];
+    }
+    /** Check if a named route/layout has middleware */
+    hasMiddleware(name) {
+        return this.middleware(name).length > 0;
+    }
+    /**
+     * Collect all middleware in the chain from root to a named route.
+     * Returns them in execution order (root first).
+     */
+    middlewareChain(name) {
+        const entry = this.entry(name);
+        if (!entry)
+            return [];
+        const chain = [];
+        let current = entry;
+        const stack = [];
+        while (current) {
+            stack.unshift(current);
+            current = current.parent;
+        }
+        for (const e of stack) {
+            if (e.middleware.length > 0) {
+                chain.push({ segmentId: e.shortCode, count: e.middleware.length });
+            }
+        }
+        return chain;
+    }
+    // --- Intercepts ---
+    /** Get intercept entries for a named route/layout */
+    intercepts(name) {
+        const entry = this.entry(name);
+        if (!entry)
+            return [];
+        return entry.intercept.map((i) => ({
+            slotName: i.slotName,
+            routeName: i.routeName,
+            hasWhen: i.when.length > 0,
+            whenCount: i.when.length,
+            hasLoader: i.loader.length > 0,
+            hasMiddleware: i.middleware.length > 0,
+        }));
+    }
+    /** Get raw InterceptEntry objects for a named route/layout */
+    interceptEntries(name) {
+        return this.entry(name)?.intercept ?? [];
+    }
+    // --- Loaders ---
+    /** Get loader entries for a named route/layout */
+    loaders(name) {
+        return this.entry(name)?.loader ?? [];
+    }
+    /** Check if a named route/layout has loaders */
+    hasLoaders(name) {
+        return this.loaders(name).length > 0;
+    }
+    // --- Parallel slots ---
+    /** Get parallel slot entries (child EntryData with type="parallel") */
+    parallelSlots(name) {
+        return this.entry(name)?.parallel ?? [];
+    }
+    /** Get parallel slot names for a named route/layout */
+    parallelSlotNames(name) {
+        const entry = this.entry(name);
+        if (!entry)
+            return [];
+        // Parallel entry handler is Record<`@${string}`, Handler>
+        return entry.parallel.map((p) => {
+            if (p.type === "parallel" && typeof p.handler === "object" && p.handler !== null) {
+                return Object.keys(p.handler);
+            }
+            return [];
+        }).flat();
+    }
+    // --- Error/NotFound boundaries ---
+    /** Check if a named route/layout has an error boundary */
+    hasErrorBoundary(name) {
+        return (this.entry(name)?.errorBoundary?.length ?? 0) > 0;
+    }
+    /** Check if a named route/layout has a not-found boundary */
+    hasNotFoundBoundary(name) {
+        return (this.entry(name)?.notFoundBoundary?.length ?? 0) > 0;
+    }
+    // --- Cache ---
+    /** Check if a named route/layout has cache config */
+    hasCache(name) {
+        return this.entry(name)?.cache !== undefined;
+    }
+    // --- Loading ---
+    /** Check if a named route/layout has a loading component */
+    hasLoading(name) {
+        const entry = this.entry(name);
+        if (!entry)
+            return false;
+        return "loading" in entry && entry.loading !== undefined;
+    }
+    // --- Debug ---
+    /**
+     * Debug print the route tree.
+     * Useful for exploring the structure in tests.
+     */
+    debug() {
+        const lines = ["Route Tree:"];
+        for (const [name, pattern] of this.patterns) {
+            const entry = this.entry(name);
+            const segPath = this.segmentPath(name);
+            const ids = segPath.map((s) => s.id).join(" > ");
+            const extras = [];
+            if (entry && entry.middleware.length > 0)
+                extras.push(`mw:${entry.middleware.length}`);
+            if (entry && entry.loader.length > 0)
+                extras.push(`ld:${entry.loader.length}`);
+            if (entry && entry.intercept.length > 0)
+                extras.push(`int:${entry.intercept.length}`);
+            if (entry && entry.parallel.length > 0)
+                extras.push(`par:${entry.parallel.length}`);
+            if (entry?.errorBoundary?.length)
+                extras.push("err");
+            if (entry?.cache)
+                extras.push("cache");
+            const suffix = extras.length > 0 ? ` {${extras.join(", ")}}` : "";
+            lines.push(`  ${name}: ${pattern} [${entry?.shortCode}] (${ids})${suffix}`);
+        }
+        return lines.join("\n");
+    }
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+function findLazyIncludes(items) {
+    const result = [];
+    for (const item of items) {
+        if (!item)
+            continue;
+        if (item.type === "include") {
+            const includeItem = item;
+            if (includeItem.lazy === true && includeItem._lazyContext) {
+                result.push({
+                    prefix: includeItem.prefix,
+                    patterns: includeItem.patterns,
+                    context: includeItem._lazyContext,
+                });
+            }
+        }
+        if (item.uses && Array.isArray(item.uses)) {
+            result.push(...findLazyIncludes(item.uses));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=route-tree.js.map

package/dist/__tests__/helpers/route-tree.js.map

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

package/dist/__tests__/match-result.test.d.ts

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

package/dist/__tests__/match-result.test.d.ts.map

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

package/dist/__tests__/match-result.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect, vi } from "vitest";
+import { buildMatchResult } from "../router/match-result.js";
+// Mock metrics and logging (not relevant to these tests)
+vi.mock("../router/metrics.js", () => ({
+    generateServerTiming: vi.fn(),
+    logMetrics: vi.fn(),
+}));
+vi.mock("../router/logging.js", () => ({
+    debugLog: vi.fn(),
+}));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function seg(id, overrides) {
+    return {
+        id,
+        namespace: "",
+        index: 0,
+        type: "layout",
+        component: `component-${id}`,
+        ...overrides,
+    };
+}
+function makeCtx(overrides) {
+    return {
+        isFullMatch: true,
+        matched: { params: {} },
+        routeKey: "test",
+        request: { method: "GET" },
+        pathname: "/test",
+        clientSegmentIds: [],
+        interceptResult: null,
+        routeMiddleware: [],
+        ...overrides,
+    };
+}
+function makeState(overrides) {
+    return {
+        cacheHit: false,
+        segments: [],
+        matchedIds: [],
+        interceptSegments: [],
+        slots: {},
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("buildMatchResult", () => {
+    describe("unique segment ID invariant", () => {
+        it("produces unique matched IDs for full match with unique segments", () => {
+            const segments = [
+                seg("M0L0"),
+                seg("M0L0C0"),
+                seg("M0L0C0L0"),
+                seg("M0L0C0L0R0", { type: "route" }),
+            ];
+            const result = buildMatchResult(segments, makeCtx(), makeState());
+            expect(result.matched).toEqual([
+                "M0L0", "M0L0C0", "M0L0C0L0", "M0L0C0L0R0",
+            ]);
+            expect(new Set(result.matched).size).toBe(result.matched.length);
+        });
+        it("deduplicates segment IDs when allSegments contains duplicates from include() scopes", () => {
+            // Simulates the bug: include() scopes produce entries that resolve the
+            // same shared layout segment. Without dedup, the client receives duplicate
+            // IDs in matched[], changing the React tree depth and causing remounts.
+            const segments = [
+                seg("M0L0"),
+                seg("M0L0C0"), // shared layout (first occurrence)
+                seg("M0L0C0L0"),
+                seg("M0L0C0"), // shared layout (DUPLICATE from second include scope)
+                seg("M0L0C0L0R0", { type: "route" }),
+            ];
+            const result = buildMatchResult(segments, makeCtx(), makeState());
+            // matched must have unique IDs - no duplicates
+            expect(new Set(result.matched).size).toBe(result.matched.length);
+            expect(result.matched).toEqual([
+                "M0L0", "M0L0C0", "M0L0C0L0", "M0L0C0L0R0",
+            ]);
+        });
+        it("deduplicates segments array (not just IDs) for full match", () => {
+            const segments = [
+                seg("M0L0"),
+                seg("M0L0C0"),
+                seg("M0L0"), // duplicate
+                seg("M0L0C0L0R0", { type: "route" }),
+            ];
+            const result = buildMatchResult(segments, makeCtx(), makeState());
+            // segments should also be deduped (keeping first occurrence)
+            expect(result.segments.length).toBe(3);
+            expect(result.segments.map((s) => s.id)).toEqual([
+                "M0L0", "M0L0C0", "M0L0C0L0R0",
+            ]);
+        });
+        it("deduplicates matched IDs for partial match", () => {
+            const segments = [
+                seg("M0L0"),
+                seg("M0L0C0", { component: null }), // null = client already has it
+                seg("M0L0C0L0", { component: null }), // null = client already has it
+                seg("M0L0C0L0R0", { type: "route" }), // has component
+            ];
+            const state = makeState({
+                // matchedIds with duplicates (simulating unfixed resolveAllSegmentsWithRevalidation)
+                matchedIds: ["M0L0", "M0L0C0", "M0L0C0L0", "M0L0", "M0L0C0L0R0"],
+            });
+            const result = buildMatchResult(segments, makeCtx({ isFullMatch: false }), state);
+            // matched must have unique IDs
+            expect(new Set(result.matched).size).toBe(result.matched.length);
+            expect(result.matched).toEqual([
+                "M0L0", "M0L0C0", "M0L0C0L0", "M0L0C0L0R0",
+            ]);
+        });
+        it("preserves order while deduplicating (first occurrence wins)", () => {
+            const segments = [
+                seg("A"),
+                seg("B"),
+                seg("C"),
+                seg("A"), // duplicate of first
+                seg("B"), // duplicate of second
+                seg("D", { type: "route" }),
+            ];
+            const result = buildMatchResult(segments, makeCtx(), makeState());
+            expect(result.matched).toEqual(["A", "B", "C", "D"]);
+        });
+    });
+    describe("diff array", () => {
+        it("diff matches segments for full match (unique)", () => {
+            const segments = [
+                seg("L0"),
+                seg("L0R0", { type: "route" }),
+            ];
+            const result = buildMatchResult(segments, makeCtx(), makeState());
+            expect(result.diff).toEqual(["L0", "L0R0"]);
+            expect(new Set(result.diff).size).toBe(result.diff.length);
+        });
+        it("diff only includes segments with component for partial match", () => {
+            const segments = [
+                seg("L0"), // has component
+                seg("L0C0", { component: null }), // null = skip
+                seg("L0C0R0", { type: "route" }), // has component
+                seg("L0D0", { type: "loader", component: null }), // loader = keep even if null
+            ];
+            const state = makeState({
+                matchedIds: ["L0", "L0C0", "L0C0R0", "L0D0"],
+            });
+            const result = buildMatchResult(segments, makeCtx({ isFullMatch: false }), state);
+            // diff = filtered segments (component !== null OR type === "loader")
+            expect(result.diff).toEqual(["L0", "L0C0R0", "L0D0"]);
+        });
+    });
+});
+//# sourceMappingURL=match-result.test.js.map