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

package/dist/urls.js

@@ -0,0 +1,443 @@
+import { getContext, runWithPrefixes, getUrlPrefix, getNamePrefix, } from "./server/context";
+import { invariant } from "./errors";
+import { isPrerenderHandler, } from "./prerender.js";
+import { isStaticHandler, } from "./static-handler.js";
+import { registerSearchSchema } from "./route-map-builder.js";
+// ============================================================================
+// Response Route Symbol and Types
+// ============================================================================
+/**
+ * Symbol marking a route as a response route (non-RSC).
+ * Stored on PathOptions and UrlPatterns to signal the trie to short-circuit.
+ */
+export const RESPONSE_TYPE = Symbol.for("rangojs.responseType");
+// ============================================================================
+// Helper Implementations
+// ============================================================================
+/**
+ * Check if a value is a valid use item
+ */
+const isValidUseItem = (item) => {
+    return (typeof item === "undefined" ||
+        item === null ||
+        (item &&
+            typeof item === "object" &&
+            "type" in item &&
+            [
+                "layout",
+                "route",
+                "middleware",
+                "revalidate",
+                "parallel",
+                "intercept",
+                "loader",
+                "loading",
+                "errorBoundary",
+                "notFoundBoundary",
+                "when",
+                "cache",
+                "include",
+            ].includes(item.type)));
+};
+/**
+ * Apply URL prefix to a pattern
+ * Handles edge cases like "/" patterns and double slashes
+ */
+function applyUrlPrefix(prefix, pattern) {
+    if (!prefix)
+        return pattern;
+    if (pattern === "/")
+        return prefix;
+    if (prefix.endsWith("/") && pattern.startsWith("/")) {
+        return prefix + pattern.slice(1);
+    }
+    return prefix + pattern;
+}
+/**
+ * Apply name prefix to a route name
+ */
+function applyNamePrefix(prefix, name) {
+    if (!prefix)
+        return name;
+    return `${prefix}.${name}`;
+}
+/**
+ * Create path() helper
+ *
+ * The path() function is the key new feature - it combines URL pattern
+ * with handler at the definition site.
+ */
+/**
+ * Resolve response type from path options (set by path.json(), path.text(), etc.)
+ */
+function resolveResponseType(options) {
+    return options?.[RESPONSE_TYPE];
+}
+function createPathHelper() {
+    return ((pattern, handler, optionsOrUse, maybeUse) => {
+        const store = getContext();
+        const ctx = store.getStore();
+        if (!ctx)
+            throw new Error("path() must be called inside urls()");
+        invariant(!ctx.parent || ctx.parent.type !== "parallel", "path() cannot be used inside parallel()");
+        // Walk the parent chain to prevent path() nested under another path(),
+        // even when separated by intermediate layouts (e.g. path(layout(path())))
+        {
+            let ancestor = ctx.parent;
+            while (ancestor) {
+                invariant(ancestor.type !== "route", "path() cannot be nested inside another path()");
+                ancestor = ancestor.parent;
+            }
+        }
+        // Determine options and use based on argument types
+        let options;
+        let use;
+        if (typeof optionsOrUse === "function") {
+            // path(pattern, handler, use)
+            use = optionsOrUse;
+        }
+        else if (typeof optionsOrUse === "object") {
+            // path(pattern, handler, options) or path(pattern, handler, options, use)
+            options = optionsOrUse;
+            use = maybeUse;
+        }
+        // Get prefixes from context (set by include())
+        const urlPrefix = getUrlPrefix();
+        const namePrefix = getNamePrefix();
+        // Apply URL prefix to pattern
+        const prefixedPattern = applyUrlPrefix(urlPrefix, pattern);
+        // Generate route name - use provided name or generate from pattern
+        const localName = options?.name || `$path_${pattern.replace(/[/:*?]/g, "_")}`;
+        // Apply name prefix if set (from include())
+        const routeName = applyNamePrefix(namePrefix, localName);
+        const namespace = `${ctx.namespace}.${store.getNextIndex("route")}.${routeName}`;
+        // Per-request pruning: skip registration for routes that won't be rendered.
+        // forRoute is set by loadManifest() to the matched route name. During
+        // evaluateLazyEntry() (route matching), forRoute is unset so all routes
+        // register normally. We still increment counters to keep shortCodes stable
+        // across different routes (needed for segment reconciliation on navigation).
+        //
+        // include() does not need its own forRoute pruning. include() creates lazy
+        // entries that defer handler execution until route matching. When the lazy
+        // handler eventually runs inside loadManifest(), this path() check already
+        // covers all routes defined inside the include.
+        if (ctx.forRoute && routeName !== ctx.forRoute) {
+            store.getShortCode("route");
+            return { type: "route" };
+        }
+        // Ensure handler is always a function (wrap ReactNode or extract from prerender/static def)
+        const wrappedHandler = typeof handler === "function"
+            ? handler
+            : isPrerenderHandler(handler)
+                ? handler.handler
+                : isStaticHandler(handler)
+                    ? handler.handler
+                    : () => handler;
+        const entry = {
+            id: namespace,
+            shortCode: store.getShortCode("route"),
+            type: "route",
+            parent: ctx.parent,
+            handler: wrappedHandler,
+            // Store the PREFIXED pattern for route matching
+            pattern: prefixedPattern,
+            loading: undefined,
+            middleware: [],
+            revalidate: [],
+            errorBoundary: [],
+            notFoundBoundary: [],
+            layout: [],
+            parallel: [],
+            intercept: [],
+            loader: [],
+            ...(urlPrefix ? { mountPath: urlPrefix } : {}),
+            ...(isPrerenderHandler(handler)
+                ? {
+                    isPrerender: true,
+                    prerenderDef: handler,
+                }
+                : {}),
+            ...(isStaticHandler(handler)
+                ? { isStaticPrerender: true }
+                : {}),
+            ...(resolveResponseType(options)
+                ? { responseType: resolveResponseType(options) }
+                : {}),
+        };
+        // Check for duplicate route names (TypeScript should catch this, but runtime check too)
+        invariant(ctx.manifest.get(routeName) === undefined, `Duplicate route name: ${routeName} at ${namespace}`);
+        // Register route entry with prefixed name
+        ctx.manifest.set(routeName, entry);
+        // Also store pattern in a separate map for URL generation
+        if (ctx.patterns) {
+            ctx.patterns.set(routeName, prefixedPattern);
+        }
+        // Store pattern grouped by URL prefix for separate entry creation
+        if (ctx.patternsByPrefix) {
+            const urlPrefix = getUrlPrefix() || "";
+            if (!ctx.patternsByPrefix.has(urlPrefix)) {
+                ctx.patternsByPrefix.set(urlPrefix, new Map());
+            }
+            ctx.patternsByPrefix.get(urlPrefix).set(routeName, prefixedPattern);
+        }
+        // Store trailing slash config if specified
+        if (options?.trailingSlash && ctx.trailingSlash) {
+            ctx.trailingSlash.set(routeName, options.trailingSlash);
+        }
+        // Store search schema if specified
+        if (options?.search) {
+            if (ctx.searchSchemas) {
+                ctx.searchSchemas.set(routeName, options.search);
+            }
+            registerSearchSchema(routeName, options.search);
+        }
+        // Run use callback if provided
+        if (use && typeof use === "function") {
+            const result = store.run(namespace, entry, use);
+            invariant(Array.isArray(result) && result.every((item) => isValidUseItem(item)), `path() use() callback must return an array of use items [${namespace}]`);
+            return { name: namespace, type: "route", uses: result };
+        }
+        return { name: namespace, type: "route" };
+    });
+}
+/**
+ * Attach response type tag methods (.json, .text, .html, .xml, .md, .image, .stream, .any) to a path helper.
+ * Each tag wraps the original path() call with the RESPONSE_TYPE option set.
+ */
+function attachPathResponseTags(pathFn) {
+    function createTagged(responseType) {
+        return ((pattern, handler, optionsOrUse, maybeUse) => {
+            let options;
+            let use;
+            if (typeof optionsOrUse === "function") {
+                options = { [RESPONSE_TYPE]: responseType };
+                use = optionsOrUse;
+            }
+            else {
+                options = { ...optionsOrUse, [RESPONSE_TYPE]: responseType };
+                use = maybeUse;
+            }
+            return pathFn(pattern, handler, options, use);
+        });
+    }
+    const extended = pathFn;
+    extended.json = createTagged("json");
+    extended.text = createTagged("text");
+    extended.html = createTagged("html");
+    extended.xml = createTagged("xml");
+    extended.md = createTagged("md");
+    extended.image = createTagged("image");
+    extended.stream = createTagged("stream");
+    extended.any = createTagged("any");
+    return extended;
+}
+/**
+ * Process an IncludeItem by executing its nested patterns with prefixes
+ * This expands the include into actual route registrations
+ */
+function processIncludeItem(item) {
+    const { prefix, patterns, options } = item;
+    const namePrefix = options?.name;
+    // Execute the nested patterns' handler with URL and name prefixes
+    // The urlPrefix being set tells nested urls() to skip RootLayout wrapping
+    return runWithPrefixes(prefix, namePrefix, () => {
+        // Call the nested patterns' handler - this registers routes with prefixed patterns/names
+        return patterns.handler();
+    });
+}
+/**
+ * Recursively process items, expanding any IncludeItems
+ * Returns items with IncludeItems expanded into actual route items
+ *
+ * Lazy includes are kept as-is (not expanded) for the router to handle later.
+ */
+function processItems(items) {
+    const result = [];
+    for (const item of items) {
+        if (!item)
+            continue;
+        if (item.type === "include") {
+            const includeItem = item;
+            // Lazy includes are NOT expanded here - kept for router to handle
+            if (includeItem.lazy) {
+                result.push(item);
+                continue;
+            }
+            // Eager includes are already expanded during include() call
+            if (includeItem._expanded) {
+                // Items were expanded immediately - just process them recursively
+                result.push(...processItems(includeItem._expanded));
+            }
+            else {
+                // Fallback for legacy include items without _expanded
+                const expanded = processIncludeItem(item);
+                result.push(...processItems(expanded));
+            }
+        }
+        else if (item.type === "layout" && item.uses) {
+            // Process nested items in layout
+            const layoutItem = item;
+            layoutItem.uses = processItems(layoutItem.uses);
+            result.push(layoutItem);
+        }
+        else {
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * Create include() helper for composing URL patterns
+ *
+ * By default, include() IMMEDIATELY expands the nested patterns. This ensures
+ * that routes from included patterns inherit the correct parent context
+ * (the layout they're included in).
+ *
+ * With `lazy: true`, patterns are NOT expanded at definition time. Instead,
+ * they're evaluated on first request that matches the prefix. This improves
+ * cold start time for apps with many routes.
+ */
+function createIncludeHelper() {
+    return (prefix, patterns, options) => {
+        var _a;
+        const store = getContext();
+        const ctx = store.getStore();
+        if (!ctx)
+            throw new Error("include() must be called inside urls()");
+        const namePrefix = options?.name;
+        const name = `$include_${prefix.replace(/[/:*?]/g, "_")}`;
+        // Capture context for deferred evaluation
+        const capturedUrlPrefix = getUrlPrefix();
+        const capturedNamePrefix = getNamePrefix();
+        const capturedParent = ctx.parent;
+        const fullPrefix = capturedUrlPrefix
+            ? (capturedUrlPrefix.endsWith("/") && prefix.startsWith("/")
+                ? capturedUrlPrefix + prefix.slice(1)
+                : capturedUrlPrefix + prefix)
+            : prefix;
+        const fullNamePrefix = namePrefix
+            ? capturedNamePrefix
+                ? `${capturedNamePrefix}.${namePrefix}`
+                : namePrefix
+            : capturedNamePrefix;
+        // Track this include for build-time manifest generation
+        if (ctx.trackedIncludes) {
+            ctx.trackedIncludes.push({
+                prefix,
+                fullPrefix,
+                namePrefix: fullNamePrefix,
+                patterns,
+                lazy: true,
+            });
+        }
+        // Snapshot parent's counters so lazy manifest generation starts
+        // at the correct index, preventing shortCode collisions with
+        // sibling entries (e.g., BlogLayout and ArticlesLayout under NavLayout).
+        const capturedCounters = { ...ctx.counters };
+        // Reserve a layout slot in the parent's counter so sibling lazy includes
+        // produce different shortCode indices for their root layout.
+        // Without this, consecutive include() calls capture identical counters
+        // and their first child layouts get the same shortCode (e.g., both M0L0L0),
+        // causing the client partial-update diff to see no changes on navigation.
+        if (capturedParent?.shortCode) {
+            const layoutCounterKey = `${capturedParent.shortCode}_layout`;
+            (_a = ctx.counters)[layoutCounterKey] ?? (_a[layoutCounterKey] = 0);
+            ctx.counters[layoutCounterKey]++;
+        }
+        // All includes are lazy - patterns are evaluated on first matching request
+        // This improves cold start time significantly for large route sets
+        return {
+            type: "include",
+            name,
+            prefix,
+            patterns,
+            options,
+            lazy: true,
+            _lazyContext: {
+                urlPrefix: capturedUrlPrefix,
+                namePrefix: fullNamePrefix,
+                parent: capturedParent,
+                counters: capturedCounters,
+            },
+        };
+    };
+}
+// ============================================================================
+// Re-use existing helpers from route-definition.ts
+// ============================================================================
+// Import the helper creation functions from route-definition
+import { createRouteHelpers } from "./route-definition.js";
+// ============================================================================
+// urls() Main Entry Point
+// ============================================================================
+/**
+ * Define URL patterns with Django-inspired syntax
+ *
+ * Replaces map() as the entry point for route definitions.
+ * URL patterns are now visible at the definition site via path().
+ *
+ * @example
+ * ```typescript
+ * export const blogPatterns = urls(({ path, layout, loader }) => [
+ *   layout(BlogLayout, () => [
+ *     path("/", BlogIndex, { name: "index" }),
+ *     path("/:slug", BlogPost, { name: "post" }, () => [
+ *       loader(PostLoader),
+ *     ]),
+ *   ]),
+ * ]);
+ * ```
+ */
+export function urls(builder) {
+    // Collect path definitions during build
+    const definitions = [];
+    // Create the handler function that will be called by the router
+    const handler = () => {
+        invariant(typeof builder === "function", "urls() expects a builder function as its argument");
+        // Get base helpers from the existing route-definition module
+        const baseHelpers = createRouteHelpers();
+        // Create the path helper (with .json, .text, .html, .xml, .image, .stream, .any tags)
+        const pathHelper = attachPathResponseTags(createPathHelper());
+        // Create the include helper
+        const includeHelper = createIncludeHelper();
+        // Combine all helpers
+        // Note: layout and cache are cast to their typed versions - phantom types don't affect runtime
+        const helpers = {
+            path: pathHelper,
+            include: includeHelper,
+            layout: baseHelpers.layout,
+            parallel: baseHelpers.parallel,
+            intercept: baseHelpers.intercept,
+            middleware: baseHelpers.middleware,
+            revalidate: baseHelpers.revalidate,
+            loader: baseHelpers.loader,
+            loading: baseHelpers.loading,
+            errorBoundary: baseHelpers.errorBoundary,
+            notFoundBoundary: baseHelpers.notFoundBoundary,
+            when: baseHelpers.when,
+            cache: baseHelpers.cache,
+        };
+        // Execute builder directly - manifest.ts handles RootLayout wrapping
+        // for inline handlers (non-Promise results).
+        // For nested include() calls, routes inherit the outer RootLayout.
+        const builderResult = builder(helpers);
+        return processItems(builderResult);
+    };
+    // trailingSlash config is populated when handler() runs
+    // We expose it via a getter that reads from the context after handler execution
+    return {
+        definitions,
+        handler,
+        get trailingSlash() {
+            // Get the trailingSlash map from the current context
+            // This will be populated after handler() is called
+            const store = getContext();
+            const ctx = store.context.getStore();
+            if (!ctx?.trailingSlash) {
+                return {};
+            }
+            return Object.fromEntries(ctx.trailingSlash);
+        },
+    };
+}
+//# sourceMappingURL=urls.js.map

package/dist/urls.js.map

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

package/dist/use-loader.d.ts

@@ -0,0 +1,127 @@
+import type { LoaderDefinition, LoadOptions } from "./types.js";
+/**
+ * Load function type with form action support
+ */
+export type LoadFunction<T> = ((options?: LoadOptions) => Promise<T>) & {
+    /** Form action for progressive enhancement - can be passed to form action prop */
+    action: (formData: FormData) => Promise<void>;
+};
+/**
+ * Result type for useLoader hook (strict - data is required)
+ */
+export interface UseLoaderResult<T> {
+    /** The loaded data - guaranteed to exist when loader is registered on route */
+    data: T;
+    /** True while a load() is in progress */
+    isLoading: boolean;
+    /** Error from the most recent load attempt, null if successful */
+    error: Error | null;
+    /** Function to trigger a fetch (only works if loader is fetchable) */
+    load: LoadFunction<T>;
+    /** Alias for load */
+    refetch: LoadFunction<T>;
+}
+/**
+ * Result type for useFetchLoader hook (flexible - data is optional)
+ */
+export interface UseFetchLoaderResult<T> {
+    /** The loaded data - may be undefined if not yet fetched or not in context */
+    data: T | undefined;
+    /** True while a load() is in progress */
+    isLoading: boolean;
+    /** Error from the most recent load attempt, null if successful */
+    error: Error | null;
+    /** Function to trigger a fetch (only works if loader is fetchable) */
+    load: LoadFunction<T>;
+    /** Alias for load */
+    refetch: LoadFunction<T>;
+}
+/**
+ * Options for useLoader hook
+ */
+export interface UseLoaderOptions {
+    /**
+     * If true (default), errors from load() will be thrown to the nearest error boundary.
+     * If false, errors are only captured in the `error` state.
+     * @default true
+     */
+    throwOnError?: boolean;
+}
+/**
+ * Hook to access loader data from route context (strict version)
+ *
+ * Use this when the loader is registered on the route via `loader()`.
+ * The data is guaranteed to exist - throws an error if not found.
+ *
+ * For on-demand fetching or when loader might not be in context,
+ * use `useFetchLoader` instead.
+ *
+ * @param loader - The loader definition (must be registered on route)
+ * @param options - Optional configuration
+ * @returns Object with data (guaranteed), isLoading, error, load, and refetch
+ * @throws Error if loader data is not found in context
+ *
+ * @example Basic usage - accessing route loader data
+ * ```tsx
+ * "use client";
+ * import { useLoader } from "rsc-router/client";
+ * import { CartLoader } from "../loaders/cart";
+ *
+ * // In route definition: loader(CartLoader)
+ *
+ * export function CartIcon() {
+ *   const { data } = useLoader(CartLoader);
+ *   // data is guaranteed to be CartData, not CartData | undefined
+ *   return <span>Cart ({data.items.length})</span>;
+ * }
+ * ```
+ */
+export declare function useLoader<T>(loader: LoaderDefinition<T>, options?: UseLoaderOptions): UseLoaderResult<T>;
+/**
+ * Hook to access loader data with optional fetching (flexible version)
+ *
+ * Use this when:
+ * - The loader might not be registered on the route
+ * - You want to fetch data on-demand from the client
+ * - You're building a reusable component that doesn't assume route context
+ *
+ * If the loader IS registered on the route, it will still get the initial
+ * data from context - you just have to handle the `undefined` case in types.
+ *
+ * @param loader - The loader definition
+ * @param options - Optional configuration
+ * @returns Object with data (may be undefined), isLoading, error, load, and refetch
+ *
+ * @example On-demand fetching
+ * ```tsx
+ * "use client";
+ * import { useFetchLoader } from "rsc-router/client";
+ * import { SearchLoader } from "../loaders/search";
+ *
+ * export function SearchResults() {
+ *   const { data, load, isLoading } = useFetchLoader(SearchLoader);
+ *
+ *   const handleSearch = async (query: string) => {
+ *     await load({ params: { query } });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => handleSearch("test")}>Search</button>
+ *       {isLoading && <span>Loading...</span>}
+ *       {data?.results.map(r => <div key={r.id}>{r.name}</div>)}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example With route context (hybrid usage)
+ * ```tsx
+ * // Loader registered on route: loader(UserLoader)
+ * // useFetchLoader still works - gets initial data from context
+ * const { data, load } = useFetchLoader(UserLoader);
+ * // data is UserData | undefined (even though it will have initial value)
+ * ```
+ */
+export declare function useFetchLoader<T>(loader: LoaderDefinition<T>, options?: UseLoaderOptions): UseFetchLoaderResult<T>;
+//# sourceMappingURL=use-loader.d.ts.map

package/dist/use-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-loader.d.ts","sourceRoot":"","sources":["../src/use-loader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUhE;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;IACtE,kFAAkF;IAClF,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,+EAA+E;IAC/E,IAAI,EAAE,CAAC,CAAC;IACR,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sEAAsE;IACtE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtB,qBAAqB;IACrB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,8EAA8E;IAC9E,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sEAAsE;IACtE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtB,qBAAqB;IACrB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAuLD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAAC,CAAC,CAAC,CAapB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,oBAAoB,CAAC,CAAC,CAAC,CAEzB"}