@rangojs/router 0.0.0-experimental.0b82333f

package/dist/host/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/host/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/host/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Host Router Utilities
+ *
+ * Helper functions for type-safe pattern definitions.
+ */
+/**
+ * Define hosts with type safety
+ *
+ * @example
+ * ```ts
+ * const hosts = defineHosts({
+ *   admin: 'admin.*',
+ *   api: 'api.*',
+ *   app: ['*', 'www.*']
+ * });
+ *
+ * router.host(hosts.admin).map(...); // Type-safe!
+ * ```
+ */
+export declare function defineHosts<T extends Record<string, string | string[]>>(hosts: T): Readonly<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/host/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/host/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EACrE,KAAK,EAAE,CAAC,GACP,QAAQ,CAAC,CAAC,CAAC,CAEb"}

package/dist/host/utils.js

@@ -0,0 +1,23 @@
+/**
+ * Host Router Utilities
+ *
+ * Helper functions for type-safe pattern definitions.
+ */
+/**
+ * Define hosts with type safety
+ *
+ * @example
+ * ```ts
+ * const hosts = defineHosts({
+ *   admin: 'admin.*',
+ *   api: 'api.*',
+ *   app: ['*', 'www.*']
+ * });
+ *
+ * router.host(hosts.admin).map(...); // Type-safe!
+ * ```
+ */
+export function defineHosts(hosts) {
+    return Object.freeze(hosts);
+}
+//# sourceMappingURL=utils.js.map

package/dist/host/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/host/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,KAAQ;IAER,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/href-client.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Client-safe type-safe href function
+ *
+ * This is a compile-time only href that validates paths against registered routes.
+ * No runtime route map lookup - just an identity function with TypeScript validation.
+ *
+ * @example
+ * ```typescript
+ * import { href } from "rsc-router/client";
+ *
+ * href("/blog/my-post");           // ✓ matches /blog/:slug
+ * href("/shop/product/widget");    // ✓ matches /shop/product/:slug
+ * href("/invalid");                // ✗ TypeScript error
+ * ```
+ */
+import type { GetRegisteredRoutes } from "./types.js";
+import type { ResponseEnvelope } from "./urls.js";
+/**
+ * Parse constraint values into a union type for paths
+ * "a|b|c" → "a" | "b" | "c"
+ */
+type ParseConstraintPath<T extends string> = T extends `${infer First}|${infer Rest}` ? First | ParseConstraintPath<Rest> : T;
+/**
+ * Convert a route pattern to a template literal type
+ *
+ * Supports:
+ * - Static: /about → "/about"
+ * - Dynamic: /blog/:slug → `/blog/${string}`
+ * - Optional: /:locale?/blog → "/blog" | `/${string}/blog`
+ * - Constrained: /:locale(en|gb)/blog → "/en/blog" | "/gb/blog"
+ * - Optional + Constrained: /:locale(en|gb)?/blog → "/blog" | "/en/blog" | "/gb/blog"
+ *
+ * @example
+ * PatternToPath<"/blog/:slug"> = `/blog/${string}`
+ * PatternToPath<"/:locale?/blog"> = "/blog" | `/${string}/blog`
+ * PatternToPath<"/:locale(en|gb)/blog"> = "/en/blog" | "/gb/blog"
+ * PatternToPath<"/:locale(en|gb)?/blog"> = "/blog" | "/en/blog" | "/gb/blog"
+ */
+export type PatternToPath<T extends string> = T extends `${infer Before}:${infer _Name}(${infer Constraint})?/${infer After}` ? PatternToPath<`${Before}${After}`> | `${Before}${ParseConstraintPath<Constraint>}/${PatternToPath<After>}` : T extends `${infer Before}:${infer _Name}(${infer Constraint})?` ? Before | `${Before}${ParseConstraintPath<Constraint>}` : T extends `${infer Before}:${infer _Name}(${infer Constraint})/${infer After}` ? `${Before}${ParseConstraintPath<Constraint>}/${PatternToPath<After>}` : T extends `${infer Before}:${infer _Name}(${infer Constraint})` ? `${Before}${ParseConstraintPath<Constraint>}` : T extends `${infer Before}:${infer _Param}?/${infer After}` ? PatternToPath<`${Before}${After}`> | `${Before}${string}/${PatternToPath<After>}` : T extends `${infer Before}:${infer _Param}?` ? Before | `${Before}${string}` : T extends `${infer Before}:${infer _Param}/${infer After}` ? `${Before}${string}/${PatternToPath<After>}` : T extends `${infer Before}:${infer _Param}` ? `${Before}${string}` : T;
+/**
+ * Allow optional query string (?...) and/or hash fragment (#...) suffix
+ *
+ * @example
+ * WithSuffix<"/about"> = "/about" | "/about?..." | "/about#..." | "/about?...#..."
+ */
+type WithSuffix<T extends string> = T | `${T}?${string}` | `${T}#${string}` | `${T}?${string}#${string}`;
+/**
+ * Helper type to get pattern from routes, handling string values and { path, response } objects
+ */
+type RoutePattern<TRoutes, K extends keyof TRoutes> = TRoutes[K] extends string ? TRoutes[K] : TRoutes[K] extends {
+    readonly path: infer P extends string;
+} ? P : string;
+/**
+ * Look up the response data type for a route pattern from RegisteredRoutes.
+ *
+ * Works by reverse-looking up the route name for the given pattern,
+ * then extracting the response type from the route entry.
+ *
+ * For static routes (no params), pattern === path:
+ *   PathResponse<"/api/health"> → { status: string; timestamp: number }
+ *
+ * For dynamic routes, use the pattern:
+ *   PathResponse<"/api/products/:id"> → Product
+ */
+export type PathResponse<TPattern extends string, TRoutes = GetRegisteredRoutes> = ResponseEnvelope<{
+    [K in keyof TRoutes]: RoutePattern<TRoutes, K> extends TPattern ? TRoutes[K] extends {
+        readonly response: infer R;
+    } ? Exclude<R, Response> : never : never;
+}[keyof TRoutes]>;
+/**
+ * Strip trailing slash from a path (e.g., "/blog/" -> "/blog" | "/blog/")
+ * Allows navigation to include() prefixes without requiring trailing slash
+ */
+type OptionalTrailingSlash<T extends string> = T extends `${infer Base}/` ? (Base extends "" ? T : Base | T) : T;
+/**
+ * Union of all valid paths from registered routes
+ *
+ * Generated from RSCRouter.RegisteredRoutes via module augmentation.
+ * Allows optional query strings and hash fragments.
+ */
+export type ValidPaths<TRoutes = GetRegisteredRoutes> = keyof TRoutes extends never ? `/${string}` : WithSuffix<{
+    [K in keyof TRoutes]: OptionalTrailingSlash<PatternToPath<RoutePattern<TRoutes, K>>>;
+}[keyof TRoutes]>;
+/**
+ * Type-safe href function for client-side use
+ *
+ * Without mount: identity function, validates absolute paths at compile time.
+ * With mount: prepends mount path, for use with useMount() inside include() scopes.
+ *
+ * @param path - A valid path matching one of the registered route patterns
+ * @param mount - Optional mount prefix from useMount() for include-scoped paths
+ * @returns The resolved path
+ *
+ * @example
+ * ```typescript
+ * // Absolute paths (type-safe)
+ * href("/blog/hello");           // "/blog/hello"
+ * href("/shop/product/widget");  // "/shop/product/widget"
+ *
+ * // With mount (inside an include)
+ * const mount = useMount();      // "/articles"
+ * href("/", mount);              // "/articles/"
+ * href("/my-post", mount);       // "/articles/my-post"
+ *
+ * // Query strings and hashes pass through
+ * href("/blog/hello?page=1");
+ * href("/about#contact");
+ * ```
+ */
+export declare function href<T extends ValidPaths>(path: T, mount?: string): string;
+/**
+ * Props shape returned by href.json() etc. for spreading on <Link>.
+ * Sets data-external to trigger hard navigation (skips RSC fetch).
+ */
+export interface ResponseHrefProps {
+    to: string;
+    "data-external": "";
+}
+type ResponseHrefFn = <T extends ValidPaths>(path: T, mount?: string) => ResponseHrefProps;
+export declare namespace href {
+    const json: ResponseHrefFn;
+    const text: ResponseHrefFn;
+    const html: ResponseHrefFn;
+    const xml: ResponseHrefFn;
+    const md: ResponseHrefFn;
+    const image: ResponseHrefFn;
+    const stream: ResponseHrefFn;
+    const any: ResponseHrefFn;
+}
+export {};
+//# sourceMappingURL=href-client.d.ts.map

package/dist/href-client.d.ts.map

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

package/dist/href-client.js

@@ -0,0 +1,64 @@
+/**
+ * Client-safe type-safe href function
+ *
+ * This is a compile-time only href that validates paths against registered routes.
+ * No runtime route map lookup - just an identity function with TypeScript validation.
+ *
+ * @example
+ * ```typescript
+ * import { href } from "rsc-router/client";
+ *
+ * href("/blog/my-post");           // ✓ matches /blog/:slug
+ * href("/shop/product/widget");    // ✓ matches /shop/product/:slug
+ * href("/invalid");                // ✗ TypeScript error
+ * ```
+ */
+/**
+ * Type-safe href function for client-side use
+ *
+ * Without mount: identity function, validates absolute paths at compile time.
+ * With mount: prepends mount path, for use with useMount() inside include() scopes.
+ *
+ * @param path - A valid path matching one of the registered route patterns
+ * @param mount - Optional mount prefix from useMount() for include-scoped paths
+ * @returns The resolved path
+ *
+ * @example
+ * ```typescript
+ * // Absolute paths (type-safe)
+ * href("/blog/hello");           // "/blog/hello"
+ * href("/shop/product/widget");  // "/shop/product/widget"
+ *
+ * // With mount (inside an include)
+ * const mount = useMount();      // "/articles"
+ * href("/", mount);              // "/articles/"
+ * href("/my-post", mount);       // "/articles/my-post"
+ *
+ * // Query strings and hashes pass through
+ * href("/blog/hello?page=1");
+ * href("/about#contact");
+ * ```
+ */
+export function href(path, mount) {
+    if (mount && mount !== "/") {
+        return mount + path;
+    }
+    return path;
+}
+function createResponseHrefTag() {
+    return (path, mount) => ({
+        to: href(path, mount),
+        "data-external": "",
+    });
+}
+(function (href) {
+    href.json = createResponseHrefTag();
+    href.text = createResponseHrefTag();
+    href.html = createResponseHrefTag();
+    href.xml = createResponseHrefTag();
+    href.md = createResponseHrefTag();
+    href.image = createResponseHrefTag();
+    href.stream = createResponseHrefTag();
+    href.any = createResponseHrefTag();
+})(href || (href = {}));
+//# sourceMappingURL=href-client.js.map

package/dist/href-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"href-client.js","sourceRoot":"","sources":["../src/href-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+HH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,IAAI,CAAuB,IAAO,EAAE,KAAc;IAChE,IAAI,KAAK,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAC3B,OAAO,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD,SAAS,qBAAqB;IAC5B,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACvB,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QACrB,eAAe,EAAE,EAAW;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,WAAiB,IAAI;IACN,SAAI,GAAmB,qBAAqB,EAAE,CAAC;IAC/C,SAAI,GAAmB,qBAAqB,EAAE,CAAC;IAC/C,SAAI,GAAmB,qBAAqB,EAAE,CAAC;IAC/C,QAAG,GAAmB,qBAAqB,EAAE,CAAC;IAC9C,OAAE,GAAmB,qBAAqB,EAAE,CAAC;IAC7C,UAAK,GAAmB,qBAAqB,EAAE,CAAC;IAChD,WAAM,GAAmB,qBAAqB,EAAE,CAAC;IACjD,QAAG,GAAmB,qBAAqB,EAAE,CAAC;AAC7D,CAAC,EATgB,IAAI,KAAJ,IAAI,QASpB"}

package/dist/href-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Href Context for route name resolution
+ *
+ * This module is marked "use client" so it can be imported by both:
+ * - Server (segment-system): Gets a client reference for createElement
+ * - Client (useHref): Uses the actual context for useContext
+ *
+ * The context stores:
+ * - routeMap: Map of route names to URL patterns
+ * - routeName: Current matched route name (for local name resolution)
+ */
+import { type Context } from "react";
+/**
+ * Context value for href resolution
+ */
+export interface HrefContextValue {
+    /** Route map: route name -> URL pattern */
+    routeMap: Record<string, string>;
+    /** Current matched route name (includes name prefix from include()) */
+    routeName?: string;
+}
+/**
+ * Context for href resolution (route map and current route name)
+ *
+ * On the server: Populated by renderSegments() via HrefContext.Provider
+ * On the client: Populated by NavigationProvider from RSC metadata
+ */
+export declare const HrefContext: Context<HrefContextValue | null>;
+//# sourceMappingURL=href-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"href-context.d.ts","sourceRoot":"","sources":["../src/href-context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CACX,CAAC"}

package/dist/href-context.js

@@ -0,0 +1,21 @@
+"use client";
+/**
+ * Href Context for route name resolution
+ *
+ * This module is marked "use client" so it can be imported by both:
+ * - Server (segment-system): Gets a client reference for createElement
+ * - Client (useHref): Uses the actual context for useContext
+ *
+ * The context stores:
+ * - routeMap: Map of route names to URL patterns
+ * - routeName: Current matched route name (for local name resolution)
+ */
+import { createContext } from "react";
+/**
+ * Context for href resolution (route map and current route name)
+ *
+ * On the server: Populated by renderSegments() via HrefContext.Provider
+ * On the client: Populated by NavigationProvider from RSC metadata
+ */
+export const HrefContext = createContext(null);
+//# sourceMappingURL=href-context.js.map

package/dist/href-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"href-context.js","sourceRoot":"","sources":["../src/href-context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAgB,MAAM,OAAO,CAAC;AAYpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB,aAAa,CAA0B,IAAI,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @rangojs/router
+ *
+ * Single user-facing entrypoint for all router APIs.
+ *
+ * The "react-server" export condition selects index.rsc.ts (real implementations)
+ * vs this file (client stubs for server-only functions).
+ *
+ * For client-only exports (Outlet, useOutlet, hooks, components):
+ *   import from "@rangojs/router/client"
+ */
+export { renderSegments } from "./segment-system.js";
+export { RouteNotFoundError, DataNotFoundError, notFound, MiddlewareError, HandlerError, BuildError, InvalidHandlerError, NetworkError, isNetworkError, sanitizeError, RouterError, } from "./errors.js";
+export type { DocumentProps, RouterEnv, DefaultEnv, RouteDefinition, RouteConfig, RouteDefinitionOptions, TrailingSlashMode, Handler, // Supports params object, path pattern, or route name
+ScopedRouteMap, // Scoped view of GeneratedRouteMap for Handler<"localName", ScopedRouteMap<"prefix">>
+HandlerContext, ExtractParams, GenericParams, Middleware, RevalidateParams, Revalidate, RouteKeys, LoaderDefinition, LoaderFn, LoaderContext, FetchableLoaderOptions, LoadOptions, LoaderActionContext, LoaderAction, LoaderMiddlewareFn, ErrorInfo, ErrorBoundaryFallbackProps, ErrorBoundaryHandler, ClientErrorBoundaryFallbackProps, NotFoundInfo, NotFoundBoundaryFallbackProps, NotFoundBoundaryHandler, ErrorPhase, OnErrorContext, OnErrorCallback, } from "./types.js";
+export type { SearchSchema, SearchSchemaValue, ResolveSearchSchema, RouteSearchParams, RouteParams } from "./search-params.js";
+export { createLoader } from "./loader.js";
+export type { RouteHelpers, RouteHandlers } from "./route-definition.js";
+export type { ResponseHandler, ResponseHandlerContext, JsonResponseHandler, TextResponseHandler, JsonValue, ResponsePathFn, JsonResponsePathFn, TextResponsePathFn, RouteResponse, ResponseError, ResponseEnvelope, } from "./urls.js";
+export type { MiddlewareContext, CookieOptions, } from "./router/middleware.js";
+/**
+ * Error-throwing stub for server-only `urls` function.
+ */
+export declare function urls(): never;
+/**
+ * Error-throwing stub for server-only `createRouter` function.
+ */
+export declare function createRouter(): never;
+/**
+ * Error-throwing stub for server-only `redirect` function.
+ */
+export declare function redirect(): never;
+export { createHandle, isHandle, type Handle } from "./handle.js";
+/**
+ * Error-throwing stub for server-only `Prerender` function.
+ */
+export declare function Prerender(): never;
+/**
+ * Error-throwing stub for server-only `Static` function.
+ */
+export declare function Static(): never;
+/**
+ * Error-throwing stub for server-only `getRequestContext` function.
+ */
+export declare function getRequestContext(): never;
+/**
+ * Error-throwing stub for server-only `requireRequestContext` function.
+ */
+export declare function requireRequestContext(): never;
+/**
+ * Error-throwing stub for server-only `createReverse` function.
+ */
+export declare function createReverse(): never;
+/**
+ * Error-throwing stub for server-only `enableMatchDebug` function.
+ */
+export declare function enableMatchDebug(): never;
+/**
+ * Error-throwing stub for server-only `getMatchDebugStats` function.
+ */
+export declare function getMatchDebugStats(): never;
+/**
+ * Error-throwing stub for server-only `track` function.
+ */
+export declare function track(): never;
+export type { RequestContext } from "./server/request-context.js";
+export type { MetaDescriptor, MetaDescriptorBase } from "./router/types.js";
+export type { ScopedReverseFunction, ReverseFunction, ExtractLocalRoutes, PrefixedRoutes, PrefixRoutePatterns, ParamsFor, SanitizePrefix, MergeRoutes } from "./reverse.js";
+export { scopedReverse } from "./reverse.js";
+export { createLocationState, type LocationStateDefinition, type LocationStateEntry, } from "./browser/react/location-state-shared.js";
+export type { PathResponse } from "./href-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,YAAY,EAEV,aAAa,EACb,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EAEjB,OAAO,EAAa,sDAAsD;AAC1E,cAAc,EAAM,sFAAsF;AAC1G,cAAc,EACd,aAAa,EACb,aAAa,EAEb,UAAU,EAEV,gBAAgB,EAChB,UAAU,EACV,SAAS,EAET,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAElB,SAAS,EACT,0BAA0B,EAC1B,oBAAoB,EACpB,gCAAgC,EAEhC,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EAEvB,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAI/H,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGzE,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAgB,IAAI,IAAI,KAAK,CAI5B;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAIpC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAIhC;AAGD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAElE;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,CAIjC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,KAAK,CAI9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAIzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAI7C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAIrC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAIxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAI1C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,KAAK,CAI7B;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5K,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EACL,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,0CAA0C,CAAC;AAGlD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,91 @@
+/**
+ * @rangojs/router
+ *
+ * Single user-facing entrypoint for all router APIs.
+ *
+ * The "react-server" export condition selects index.rsc.ts (real implementations)
+ * vs this file (client stubs for server-only functions).
+ *
+ * For client-only exports (Outlet, useOutlet, hooks, components):
+ *   import from "@rangojs/router/client"
+ */
+// Universal rendering utilities (work on both server and client)
+export { renderSegments } from "./segment-system.js";
+// Error classes (can be used on both server and client)
+export { RouteNotFoundError, DataNotFoundError, notFound, MiddlewareError, HandlerError, BuildError, InvalidHandlerError, NetworkError, isNetworkError, sanitizeError, RouterError, } from "./errors.js";
+// Client-safe createLoader - only stores the $$id, function is not included
+// Use this when defining loaders that will be imported by client components
+export { createLoader } from "./loader.js";
+/**
+ * Error-throwing stub for server-only `urls` function.
+ */
+export function urls() {
+    throw new Error('urls() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `createRouter` function.
+ */
+export function createRouter() {
+    throw new Error('createRouter() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `redirect` function.
+ */
+export function redirect() {
+    throw new Error('redirect() is server-only and requires RSC context.');
+}
+// Handle API (universal - works on both server and client)
+export { createHandle, isHandle } from "./handle.js";
+/**
+ * Error-throwing stub for server-only `Prerender` function.
+ */
+export function Prerender() {
+    throw new Error('Prerender() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `Static` function.
+ */
+export function Static() {
+    throw new Error('Static() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `getRequestContext` function.
+ */
+export function getRequestContext() {
+    throw new Error('getRequestContext() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `requireRequestContext` function.
+ */
+export function requireRequestContext() {
+    throw new Error('requireRequestContext() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `createReverse` function.
+ */
+export function createReverse() {
+    throw new Error('createReverse() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `enableMatchDebug` function.
+ */
+export function enableMatchDebug() {
+    throw new Error('enableMatchDebug() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `getMatchDebugStats` function.
+ */
+export function getMatchDebugStats() {
+    throw new Error('getMatchDebugStats() is server-only and requires RSC context.');
+}
+/**
+ * Error-throwing stub for server-only `track` function.
+ */
+export function track() {
+    throw new Error('track() is server-only and requires RSC context.');
+}
+// scopedReverse() helper for handlers to get locally-typed reverse
+export { scopedReverse } from "./reverse.js";
+// Location state (universal - works on both server and client)
+export { createLocationState, } from "./browser/react/location-state-shared.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,wDAAwD;AACxD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAmDrB,4EAA4E;AAC5E,4EAA4E;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA0B3C;;GAEG;AACH,MAAM,UAAU,IAAI;IAClB,MAAM,IAAI,KAAK,CACb,iDAAiD,CAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,IAAI,KAAK,CACb,qDAAqD,CACtD,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,IAAI,KAAK,CACb,sDAAsD,CACvD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,IAAI,KAAK,CACb,mDAAmD,CACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK;IACnB,MAAM,IAAI,KAAK,CACb,kDAAkD,CACnD,CAAC;AACJ,CAAC;AAUD,mEAAmE;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,+DAA+D;AAC/D,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC"}

package/dist/index.rsc.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @rangojs/router (react-server environment)
+ *
+ * This file is used when importing "@rangojs/router" from RSC (server components).
+ * It re-exports everything from the universal index.ts plus adds server-side
+ * implementations that replace the client-side error stubs.
+ *
+ * The bundler uses the "react-server" export condition to select this file
+ * in RSC context, while the regular index.ts is used in client components.
+ */
+export { renderSegments, RouteNotFoundError, DataNotFoundError, notFound, MiddlewareError, HandlerError, BuildError, InvalidHandlerError, NetworkError, isNetworkError, sanitizeError, RouterError, } from "./index.js";
+export type { DocumentProps, RouterEnv, DefaultEnv, RouteDefinition, RouteConfig, RouteDefinitionOptions, TrailingSlashMode, Handler, ScopedRouteMap, HandlerContext, ExtractParams, GenericParams, Middleware, RevalidateParams, Revalidate, RouteKeys, LoaderDefinition, LoaderFn, LoaderContext, FetchableLoaderOptions, LoadOptions, LoaderActionContext, LoaderAction, LoaderMiddlewareFn, ErrorInfo, ErrorBoundaryFallbackProps, ErrorBoundaryHandler, ClientErrorBoundaryFallbackProps, NotFoundInfo, NotFoundBoundaryFallbackProps, NotFoundBoundaryHandler, ErrorPhase, OnErrorContext, OnErrorCallback, } from "./types.js";
+export type { RSCRouterOptions } from "./router.js";
+export { createLoader, redirect, type RouteHelpers, type RouteHandlers, } from "./route-definition.js";
+export { createHandle, isHandle, type Handle } from "./handle.js";
+export { Prerender, isPrerenderHandler, type PrerenderHandlerDefinition, type PrerenderOptions, type BuildContext, } from "./prerender.js";
+export { Static, isStaticHandler, type StaticHandlerDefinition, } from "./static-handler.js";
+export { urls, RESPONSE_TYPE, type PathHelpers, type PathOptions, type UrlPatterns, type IncludeOptions, type IncludeItem, type RouteResponse, type ResponseError, type ResponseEnvelope, type ResponseHandler, type ResponseHandlerContext, type JsonResponseHandler, type TextResponseHandler, type JsonValue, type ResponsePathFn, type JsonResponsePathFn, type TextResponsePathFn, } from "./urls.js";
+export { createRouter, type RSCRouter, type RootLayoutProps, } from "./router.js";
+export type { HandlerCacheConfig } from "./rsc/types.js";
+export { Meta } from "./handles/meta.js";
+export { getRequestContext, requireRequestContext, type RequestContext, } from "./server/request-context.js";
+export type { MetaDescriptor, MetaDescriptorBase } from "./router/types.js";
+export type { MiddlewareContext, CookieOptions, } from "./router/middleware.js";
+export type { ScopedReverseFunction, ReverseFunction, ExtractLocalRoutes, PrefixedRoutes, PrefixRoutePatterns, ParamsFor, SanitizePrefix, MergeRoutes } from "./reverse.js";
+export { scopedReverse, createReverse } from "./reverse.js";
+export type { SearchSchema, SearchSchemaValue, ResolveSearchSchema, RouteSearchParams, RouteParams } from "./search-params.js";
+export { track } from "./server/context.js";
+export { enableMatchDebug, getMatchDebugStats, } from "./router/pattern-matching.js";
+export { createLocationState, type LocationStateDefinition, type LocationStateEntry, } from "./browser/react/location-state-shared.js";
+export type { PathResponse } from "./href-client.js";
+//# sourceMappingURL=index.rsc.d.ts.map

package/dist/index.rsc.d.ts.map

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

package/dist/index.rsc.js

@@ -0,0 +1,40 @@
+/**
+ * @rangojs/router (react-server environment)
+ *
+ * This file is used when importing "@rangojs/router" from RSC (server components).
+ * It re-exports everything from the universal index.ts plus adds server-side
+ * implementations that replace the client-side error stubs.
+ *
+ * The bundler uses the "react-server" export condition to select this file
+ * in RSC context, while the regular index.ts is used in client components.
+ */
+// Re-export all universal exports from index.ts
+export { 
+// Universal rendering utilities
+renderSegments, 
+// Error classes
+RouteNotFoundError, DataNotFoundError, notFound, MiddlewareError, HandlerError, BuildError, InvalidHandlerError, NetworkError, isNetworkError, sanitizeError, RouterError, } from "./index.js";
+// Server-side createLoader and redirect
+export { createLoader, redirect, } from "./route-definition.js";
+// Handle API
+export { createHandle, isHandle } from "./handle.js";
+// Pre-render handler API
+export { Prerender, isPrerenderHandler, } from "./prerender.js";
+// Static handler API
+export { Static, isStaticHandler, } from "./static-handler.js";
+// Django-style URL patterns (RSC/server context)
+export { urls, RESPONSE_TYPE, } from "./urls.js";
+// Core router (server-side)
+export { createRouter, } from "./router.js";
+// Built-in handles (server-side)
+export { Meta } from "./handles/meta.js";
+// Request context (for accessing request data in server actions/components)
+export { getRequestContext, requireRequestContext, } from "./server/request-context.js";
+export { scopedReverse, createReverse } from "./reverse.js";
+// Performance tracking (server-only)
+export { track } from "./server/context.js";
+// Debug utilities for route matching (development only)
+export { enableMatchDebug, getMatchDebugStats, } from "./router/pattern-matching.js";
+// Location state (universal)
+export { createLocationState, } from "./browser/react/location-state-shared.js";
+//# sourceMappingURL=index.rsc.js.map

package/dist/index.rsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.rsc.js","sourceRoot":"","sources":["../src/index.rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,OAAO;AACL,gCAAgC;AAChC,cAAc;AACd,gBAAgB;AAChB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAmDpB,wCAAwC;AACxC,OAAO,EACL,YAAY,EACZ,QAAQ,GAGT,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AAElE,yBAAyB;AACzB,OAAO,EACL,SAAS,EACT,kBAAkB,GAInB,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EACL,MAAM,EACN,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAE7B,iDAAiD;AACjD,OAAO,EACL,IAAI,EACJ,aAAa,GAiBd,MAAM,WAAW,CAAC;AAEnB,4BAA4B;AAC5B,OAAO,EACL,YAAY,GAGb,MAAM,aAAa,CAAC;AAKrB,iCAAiC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,4EAA4E;AAC5E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAarC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAK5D,qCAAqC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,6BAA6B;AAC7B,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC"}

package/dist/internal-debug.d.ts

@@ -0,0 +1,2 @@
+export declare const INTERNAL_RANGO_DEBUG: boolean;
+//# sourceMappingURL=internal-debug.d.ts.map

package/dist/internal-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-debug.d.ts","sourceRoot":"","sources":["../src/internal-debug.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,EAAE,OAEkB,CAAC"}

package/dist/internal-debug.js

@@ -0,0 +1,5 @@
+// Internal debug gate. Enable with INTERNAL_RANGO_DEBUG=1 in the environment.
+// Only checked on the server (Node.js / Bun); on workers process is undefined.
+export const INTERNAL_RANGO_DEBUG = typeof process !== "undefined" &&
+    Boolean(process.env?.INTERNAL_RANGO_DEBUG);
+//# sourceMappingURL=internal-debug.js.map

package/dist/internal-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-debug.js","sourceRoot":"","sources":["../src/internal-debug.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAE,OAAe,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * rsc-router/loader (client version)
+ *
+ * Client-only stub for createLoader. Returns a minimal loader definition
+ * that can be passed to hooks like useLoader. The actual loader function
+ * is not included - it only exists on the server.
+ *
+ * The $$id is injected by the Vite exposeInternalIds plugin.
+ */
+import type { FetchableLoaderOptions, LoaderDefinition, LoaderFn } from "./types.js";
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>, fetchable: true): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+export declare function createLoader<T>(fn: LoaderFn<T, Record<string, string | undefined>, any>, options: FetchableLoaderOptions): LoaderDefinition<Awaited<T>, Record<string, string | undefined>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,GACvD,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAGpE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,EACxD,SAAS,EAAE,IAAI,GACd,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAGpE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,EACxD,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC"}