@funstack/router 1.0.0 → 1.1.0

package/dist/bin/skill-installer.mjs

@@ -2,12 +2,11 @@
 import { install } from "@funstack/skill-installer";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
-
 //#region src/bin/skill-installer.ts
 const skillDir = resolve(dirname(fileURLToPath(import.meta.url)), "../../skills/funstack-router-knowledge");
 console.log("Installing skill from:", skillDir);
 await install(skillDir);
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=skill-installer.mjs.map

package/dist/bin/skill-installer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skill-installer.mjs","names":[],"sources":["../../src/bin/skill-installer.ts"],"sourcesContent":["#! /usr/bin/env node\n\nimport { install } from \"@funstack/skill-installer\";\nimport { fileURLToPath } from \"node:url\";\nimport { resolve, dirname } from \"node:path\";\n\n// Resolve the skill directory relative to this script's location.\n// This script is at dist/bin/skill-installer.mjs, so go up two levels\n// to reach the package root, then into skills/.\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst skillDir = resolve(__dirname, \"../../skills/funstack-router-knowledge\");\n\nconsole.log(\"Installing skill from:\", skillDir);\n\nawait install(skillDir);\n"],"mappings":";;;;;;AAUA,MAAM,WAAW,QADC,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACrB,yCAAyC;AAE7E,QAAQ,IAAI,0BAA0B,SAAS;AAE/C,MAAM,QAAQ,SAAS"}
+{"version":3,"file":"skill-installer.mjs","names":[],"sources":["../../src/bin/skill-installer.ts"],"sourcesContent":["#! /usr/bin/env node\n\nimport { install } from \"@funstack/skill-installer\";\nimport { fileURLToPath } from \"node:url\";\nimport { resolve, dirname } from \"node:path\";\n\n// Resolve the skill directory relative to this script's location.\n// This script is at dist/bin/skill-installer.mjs, so go up two levels\n// to reach the package root, then into skills/.\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst skillDir = resolve(__dirname, \"../../skills/funstack-router-knowledge\");\n\nconsole.log(\"Installing skill from:\", skillDir);\n\nawait install(skillDir);\n"],"mappings":";;;;;AAUA,MAAM,WAAW,QADC,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACrB,yCAAyC;AAE7E,QAAQ,IAAI,0BAA0B,SAAS;AAE/C,MAAM,QAAQ,SAAS"}

package/dist/{bindRoute-C7JBYje-.mjs → bindRoute-CQ2-ruTp.mjs}

@@ -31,7 +31,6 @@ function routeState() {
 		return definition;
 	});
 }
-
 //#endregion
 //#region src/bindRoute.ts
 function bindRoute(partialRoute, binding) {
@@ -40,7 +39,7 @@ function bindRoute(partialRoute, binding) {
 		...binding
 	};
 }
-
 //#endregion
 export { route as n, routeState as r, bindRoute as t };
-//# sourceMappingURL=bindRoute-C7JBYje-.mjs.map
+
+//# sourceMappingURL=bindRoute-CQ2-ruTp.mjs.map

package/dist/{bindRoute-C7JBYje-.mjs.map → bindRoute-CQ2-ruTp.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"bindRoute-C7JBYje-.mjs","names":[],"sources":["../src/route.ts","../src/bindRoute.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nconst routeDefinitionSymbol = Symbol();\nconst partialRouteDefinitionSymbol = Symbol();\n\n/**\n * Extracts parameter names from a path pattern.\n * E.g., \"/users/:id/posts/:postId\" -> \"id\" | \"postId\"\n */\ntype ExtractParams<T extends string> =\n  T extends `${string}:${infer Param}/${infer Rest}`\n    ? Param | ExtractParams<`/${Rest}`>\n    : T extends `${string}:${infer Param}`\n      ? Param\n      : never;\n\n/**\n * Creates a params object type from a path pattern.\n * E.g., \"/users/:id\" -> { id: string }\n */\nexport type PathParams<T extends string> = [ExtractParams<T>] extends [never]\n  ? Record<string, never>\n  : { [K in ExtractParams<T>]: string };\n\n/**\n * Arguments passed to action functions.\n * The request carries the POST method and FormData body.\n */\nexport type ActionArgs<Params extends Record<string, string>> = {\n  /** Extracted path parameters */\n  params: Params;\n  /** Request object with method POST and FormData body */\n  request: Request;\n  /** AbortSignal for cancellation */\n  signal: AbortSignal;\n};\n\n/**\n * Arguments passed to loader functions.\n */\nexport type LoaderArgs<\n  Params extends Record<string, string>,\n  ActionResult = undefined,\n> = {\n  /** Extracted path parameters */\n  params: Params;\n  /** Request object with URL and headers */\n  request: Request;\n  /** AbortSignal for cancellation on navigation */\n  signal: AbortSignal;\n  /** Result from the action, if this load was triggered by a form submission */\n  actionResult: ActionResult | undefined;\n};\n\n/**\n * Props for route components without loader.\n * Includes navigation state management props.\n */\nexport interface RouteComponentProps<\n  TParams extends Record<string, string>,\n  TState = undefined,\n> {\n  /** Extracted path parameters */\n  params: TParams;\n  /** Current navigation state for this route (undefined on first visit) */\n  state: TState | undefined;\n  /** Update navigation state for this route asynchronously via replace navigation */\n  setState: (\n    state: TState | ((prev: TState | undefined) => TState),\n  ) => Promise<void>;\n  /** Update navigation state for this route synchronously via updateCurrentEntry */\n  setStateSync: (\n    state: TState | ((prev: TState | undefined) => TState),\n  ) => void;\n  /** Reset navigation state to undefined asynchronously via replace navigation */\n  resetState: () => Promise<void>;\n  /** Reset navigation state to undefined synchronously via updateCurrentEntry */\n  resetStateSync: () => void;\n  /** Ephemeral navigation info (only available during navigation, not persisted) */\n  info: unknown;\n  /** Whether a navigation transition is pending */\n  isPending: boolean;\n}\n\n/**\n * Props for route components with loader.\n * Includes data from loader and navigation state management props.\n */\nexport interface RouteComponentPropsWithData<\n  TParams extends Record<string, string>,\n  TData,\n  TState = undefined,\n> extends RouteComponentProps<TParams, TState> {\n  /** Data returned from the loader */\n  data: TData;\n}\n\n/**\n * Route definition created by the `route` helper function.\n */\nexport interface OpaqueRouteDefinition {\n  [routeDefinitionSymbol]: unknown;\n  path?: string;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n}\n\n/**\n * Type-carrying route definition created by the `route` helper function when an `id` is provided.\n * This type carries type information for params, state, and data, enabling type-safe hooks in the future.\n */\nexport interface TypefulOpaqueRouteDefinition<\n  Id extends string,\n  Params extends Record<string, string>,\n  State,\n  Data,\n> {\n  [routeDefinitionSymbol]: {\n    id: Id;\n    params: Params;\n    state: State;\n    data: Data;\n  };\n  path?: string;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n}\n\n/**\n * Partial route definition created by the `route` helper function when `id` is provided but `component` is not.\n * Used for two-phase route definition in RSC: Phase 1 defines id, path, loader, action;\n * Phase 2 uses `bindRoute()` to attach the component.\n * This type carries type information for params, state, and data, enabling type-safe hooks.\n */\nexport interface PartialRouteDefinition<\n  Id extends string,\n  Params extends Record<string, string>,\n  State,\n  Data,\n> {\n  [partialRouteDefinitionSymbol]: {\n    id: Id;\n    params: Params;\n    state: State;\n    data: Data;\n  };\n  path?: string;\n}\n\n/** Extract the Id type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteId<T> =\n  T extends PartialRouteDefinition<\n    infer Id,\n    infer _Params,\n    infer _State,\n    infer _Data\n  >\n    ? Id\n    : T extends TypefulOpaqueRouteDefinition<\n          infer Id,\n          infer _Params,\n          infer _State,\n          infer _Data\n        >\n      ? Id\n      : never;\n\n/** Extract the Params type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteParams<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer Params,\n    infer _State,\n    infer _Data\n  >\n    ? Params\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer Params,\n          infer _State,\n          infer _Data\n        >\n      ? Params\n      : never;\n\n/** Extract the State type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteState<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer _Params,\n    infer State,\n    infer _Data\n  >\n    ? State\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer _Params,\n          infer State,\n          infer _Data\n        >\n      ? State\n      : never;\n\n/** Extract the Data type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteData<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer _Params,\n    infer _State,\n    infer Data\n  >\n    ? Data\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer _Params,\n          infer _State,\n          infer Data\n        >\n      ? Data\n      : never;\n\n/** Extract the component props type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type RouteComponentPropsOf<\n  T extends\n    | TypefulOpaqueRouteDefinition<\n        string,\n        Record<string, string>,\n        unknown,\n        unknown\n      >\n    | PartialRouteDefinition<string, Record<string, string>, unknown, unknown>,\n> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer Params,\n    infer State,\n    infer Data\n  >\n    ? Data extends undefined\n      ? RouteComponentProps<Params, State>\n      : RouteComponentPropsWithData<Params, Data, State>\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer Params,\n          infer State,\n          infer Data\n        >\n      ? Data extends undefined\n        ? RouteComponentProps<Params, State>\n        : RouteComponentPropsWithData<Params, Data, State>\n      : never;\n\n/**\n * Any route definition defined by user.\n */\nexport type RouteDefinition =\n  | OpaqueRouteDefinition\n  | TypefulOpaqueRouteDefinition<\n      string,\n      Record<string, string>,\n      unknown,\n      unknown\n    >\n  | {\n      path?: string;\n      component?: ComponentType<object> | ReactNode;\n      children?: RouteDefinition[];\n      exact?: boolean;\n      requireChildren?: boolean;\n    };\n\n/**\n * Route definition with action and loader.\n * Action result flows to loader via actionResult parameter.\n */\ntype RouteWithActionAndLoader<\n  TPath extends string,\n  TActionResult,\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => TActionResult;\n  loader: (\n    args: LoaderArgs<PathParams<TPath>, Awaited<TActionResult>>,\n  ) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition with action only (no loader).\n * Action executes as a pure side effect.\n */\ntype RouteWithActionOnly<\n  TPath extends string,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => unknown;\n  component?:\n    | ComponentType<RouteComponentProps<PathParams<TPath>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition with loader - infers TData from loader return type.\n * TPath is used to infer params type from the path pattern.\n * TState is the type of navigation state for this route.\n * TId is the optional route identifier for type-safe route references.\n */\ntype RouteWithLoader<\n  TPath extends string,\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  loader: (args: LoaderArgs<PathParams<TPath>>) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition without loader.\n * TPath is used to infer params type from the path pattern.\n * TState is the type of navigation state for this route.\n * TId is the optional route identifier for type-safe route references.\n */\ntype RouteWithoutLoader<\n  TPath extends string,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  component?:\n    | ComponentType<RouteComponentProps<PathParams<TPath>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Pathless route definition with loader.\n * Pathless routes always match and don't consume any pathname.\n */\ntype PathlessRouteWithLoader<\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  loader: (args: LoaderArgs<Record<string, never>>) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<Record<string, never>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  requireChildren?: boolean;\n};\n\n/**\n * Pathless route definition without loader.\n * Pathless routes always match and don't consume any pathname.\n */\ntype PathlessRouteWithoutLoader<\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  component?:\n    | ComponentType<RouteComponentProps<Record<string, never>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  requireChildren?: boolean;\n};\n\n/**\n * Partial route definition with action and loader (no component).\n * Used for two-phase route definition.\n */\ntype PartialRouteWithActionAndLoader<\n  TPath extends string,\n  TActionResult,\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => TActionResult;\n  loader: (\n    args: LoaderArgs<PathParams<TPath>, Awaited<TActionResult>>,\n  ) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition with action only (no component, no loader).\n */\ntype PartialRouteWithActionOnly<\n  TPath extends string,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => unknown;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition with loader (no component).\n */\ntype PartialRouteWithLoader<\n  TPath extends string,\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  loader: (args: LoaderArgs<PathParams<TPath>>) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition without loader or component.\n */\ntype PartialRouteWithoutLoader<\n  TPath extends string,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial pathless route definition with loader (no component).\n */\ntype PartialPathlessRouteWithLoader<\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  loader: (args: LoaderArgs<Record<string, never>>) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial pathless route definition without loader or component.\n */\ntype PartialPathlessRouteWithoutLoader<\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Helper function for creating type-safe route definitions.\n *\n * When a loader is provided, TypeScript infers the return type and ensures\n * the component accepts a `data` prop of that type. Components always receive\n * a `params` prop with types inferred from the path pattern.\n *\n * For routes with navigation state, use `routeState<TState>()({ ... })` instead.\n *\n * @example\n * ```typescript\n * // Route with async loader\n * route({\n *   path: \"users/:userId\",\n *   loader: async ({ params, signal }) => {\n *     const res = await fetch(`/api/users/${params.userId}`, { signal });\n *     return res.json() as Promise<User>;\n *   },\n *   component: UserDetail, // Must accept { data: Promise<User>, params: { userId: string }, state, setState, resetState }\n * });\n *\n * // Route without loader\n * route({\n *   path: \"about\",\n *   component: AboutPage, // Must accept { params: {}, state, setState, resetState }\n * });\n * ```\n */\n// Partial overload: id + action + loader (no component) → PartialRouteDefinition\nexport function route<\n  TId extends string,\n  const TPath extends string,\n  TActionResult,\n  TData,\n>(\n  definition: PartialRouteWithActionAndLoader<\n    TPath,\n    TActionResult,\n    TData,\n    TId\n  > & {\n    id: TId;\n  },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Partial overload: id + action only (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: PartialRouteWithActionOnly<TPath, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Partial overload: id + pathless + loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, TData>(\n  definition: PartialPathlessRouteWithLoader<TData, TId> & { id: TId },\n): PartialRouteDefinition<TId, Record<string, never>, undefined, TData>;\n// Partial overload: id + pathless + no loader (no component) → PartialRouteDefinition\nexport function route<TId extends string>(\n  definition: PartialPathlessRouteWithoutLoader<TId> & { id: TId },\n): PartialRouteDefinition<TId, Record<string, never>, undefined, undefined>;\n// Partial overload: id + loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string, TData>(\n  definition: PartialRouteWithLoader<TPath, TData, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Partial overload: id + no loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: PartialRouteWithoutLoader<TPath, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with id + action + loader → TypefulOpaqueRouteDefinition\nexport function route<\n  TId extends string,\n  const TPath extends string,\n  TActionResult,\n  TData,\n>(\n  definition: RouteWithActionAndLoader<\n    TPath,\n    TActionResult,\n    TData,\n    undefined,\n    TId\n  > & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Overload with id + action only → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: RouteWithActionOnly<TPath, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with action + loader (no id)\nexport function route<const TPath extends string, TActionResult, TData>(\n  definition: RouteWithActionAndLoader<TPath, TActionResult, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload with action only (no id)\nexport function route<const TPath extends string>(\n  definition: RouteWithActionOnly<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Pathless overload with id + loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, TData>(\n  definition: PathlessRouteWithLoader<TData, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, Record<string, never>, undefined, TData>;\n// Pathless overload with id + no loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string>(\n  definition: PathlessRouteWithoutLoader<undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<\n  TId,\n  Record<string, never>,\n  undefined,\n  undefined\n>;\n// Pathless overload with loader (no id)\nexport function route<TData>(\n  definition: PathlessRouteWithLoader<TData, undefined>,\n): OpaqueRouteDefinition;\n// Pathless overload without loader (no id)\nexport function route(\n  definition: PathlessRouteWithoutLoader<undefined>,\n): OpaqueRouteDefinition;\n// Overload with id + loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Overload with id + no loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with loader (no id)\nexport function route<const TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload without loader (no id)\nexport function route<const TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Implementation\nexport function route(\n  definition: object,\n):\n  | OpaqueRouteDefinition\n  | PartialRouteDefinition<string, Record<string, string>, unknown, unknown> {\n  return definition as unknown as OpaqueRouteDefinition;\n}\n\n/**\n * Helper function for creating type-safe route definitions with navigation state.\n *\n * Use this curried function when your route component needs to manage navigation state.\n * The state is tied to the navigation history entry and persists across back/forward navigation.\n *\n * @example\n * ```typescript\n * // Route with navigation state\n * type MyState = { scrollPosition: number };\n * routeState<MyState>()({\n *   path: \"users/:userId\",\n *   component: UserPage, // Receives { params, state, setState, resetState }\n * });\n *\n * // Route with both loader and navigation state\n * type FilterState = { filter: string };\n * routeState<FilterState>()({\n *   path: \"products\",\n *   loader: async () => fetchProducts(),\n *   component: ProductList, // Receives { data, params, state, setState, resetState }\n * });\n * ```\n */\nexport function routeState<TState>(): {\n  // Partial overload: id + action + loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string, TActionResult, TData>(\n    definition: PartialRouteWithActionAndLoader<\n      TPath,\n      TActionResult,\n      TData,\n      TId\n    > & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Partial overload: id + action only (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: PartialRouteWithActionOnly<TPath, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Partial overload: id + pathless + loader (no component) → PartialRouteDefinition\n  <TId extends string, TData>(\n    definition: PartialPathlessRouteWithLoader<TData, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, Record<string, never>, TState, TData>;\n  // Partial overload: id + pathless + no loader (no component) → PartialRouteDefinition\n  <TId extends string>(\n    definition: PartialPathlessRouteWithoutLoader<TId> & { id: TId },\n  ): PartialRouteDefinition<TId, Record<string, never>, TState, undefined>;\n  // Partial overload: id + loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string, TData>(\n    definition: PartialRouteWithLoader<TPath, TData, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Partial overload: id + no loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: PartialRouteWithoutLoader<TPath, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with id + action + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string, TActionResult, TData>(\n    definition: RouteWithActionAndLoader<\n      TPath,\n      TActionResult,\n      TData,\n      TState,\n      TId\n    > & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Overload with id + action only → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: RouteWithActionOnly<TPath, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with action + loader (no id)\n  <TPath extends string, TActionResult, TData>(\n    definition: RouteWithActionAndLoader<TPath, TActionResult, TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Overload with action only (no id)\n  <TPath extends string>(\n    definition: RouteWithActionOnly<TPath, TState>,\n  ): OpaqueRouteDefinition;\n  // Pathless overload with id + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TData>(\n    definition: PathlessRouteWithLoader<TData, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, Record<string, never>, TState, TData>;\n  // Pathless overload with id + no loader → TypefulOpaqueRouteDefinition\n  <TId extends string>(\n    definition: PathlessRouteWithoutLoader<TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<\n    TId,\n    Record<string, never>,\n    TState,\n    undefined\n  >;\n  // Pathless overload with loader (no id)\n  <TData>(\n    definition: PathlessRouteWithLoader<TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Pathless overload without loader (no id)\n  (definition: PathlessRouteWithoutLoader<TState>): OpaqueRouteDefinition;\n  // Overload with id + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Overload with id + no loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with loader (no id)\n  <TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Overload without loader (no id)\n  <TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition;\n} {\n  return ((definition: object) => {\n    return definition as unknown as OpaqueRouteDefinition;\n  }) as never;\n}\n","import type { ComponentType, ReactNode } from \"react\";\nimport type {\n  OpaqueRouteDefinition,\n  PartialRouteDefinition,\n  RouteDefinition,\n  TypefulOpaqueRouteDefinition,\n} from \"./route.js\";\n\ntype BindRouteOptions = {\n  component: ComponentType<any> | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Binds a component (and optionally children) to a partial route definition,\n * producing a full route definition for use with `<Router />`.\n *\n * This is the Phase 2 of two-phase route definition for RSC:\n * - Phase 1: `route()` without component → `PartialRouteDefinition` (shared module)\n * - Phase 2: `bindRoute()` with component → full route definition (server module)\n *\n * @example\n * ```tsx\n * // Phase 1 (shared module)\n * export const userRoute = route({\n *   id: \"user\",\n *   path: \"/:userId\",\n *   loader: fetchUser,\n * });\n *\n * // Phase 2 (server module)\n * const routes = [\n *   bindRoute(userRoute, { component: <UserProfile /> }),\n * ];\n * ```\n */\nexport function bindRoute<\n  TId extends string,\n  TParams extends Record<string, string>,\n  TState,\n  TData,\n>(\n  partialRoute: PartialRouteDefinition<TId, TParams, TState, TData>,\n  binding: BindRouteOptions,\n): TypefulOpaqueRouteDefinition<TId, TParams, TState, TData>;\nexport function bindRoute(\n  partialRoute: OpaqueRouteDefinition,\n  binding: BindRouteOptions,\n): OpaqueRouteDefinition;\nexport function bindRoute(\n  partialRoute: object,\n  binding: BindRouteOptions,\n): object {\n  return { ...partialRoute, ...binding };\n}\n"],"mappings":";AAynBA,SAAgB,MACd,YAG2E;AAC3E,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aAuFd;AACA,UAAS,eAAuB;AAC9B,SAAO;;;;;;AC/rBX,SAAgB,UACd,cACA,SACQ;AACR,QAAO;EAAE,GAAG;EAAc,GAAG;EAAS"}
+{"version":3,"file":"bindRoute-CQ2-ruTp.mjs","names":[],"sources":["../src/route.ts","../src/bindRoute.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nconst routeDefinitionSymbol = Symbol();\nconst partialRouteDefinitionSymbol = Symbol();\n\n/**\n * Extracts parameter names from a path pattern.\n * E.g., \"/users/:id/posts/:postId\" -> \"id\" | \"postId\"\n */\ntype ExtractParams<T extends string> =\n  T extends `${string}:${infer Param}/${infer Rest}`\n    ? Param | ExtractParams<`/${Rest}`>\n    : T extends `${string}:${infer Param}`\n      ? Param\n      : never;\n\n/**\n * Creates a params object type from a path pattern.\n * E.g., \"/users/:id\" -> { id: string }\n */\nexport type PathParams<T extends string> = [ExtractParams<T>] extends [never]\n  ? Record<string, never>\n  : { [K in ExtractParams<T>]: string };\n\n/**\n * Arguments passed to action functions.\n * The request carries the POST method and FormData body.\n */\nexport type ActionArgs<Params extends Record<string, string>> = {\n  /** Extracted path parameters */\n  params: Params;\n  /** Request object with method POST and FormData body */\n  request: Request;\n  /** AbortSignal for cancellation */\n  signal: AbortSignal;\n};\n\n/**\n * Arguments passed to loader functions.\n */\nexport type LoaderArgs<\n  Params extends Record<string, string>,\n  ActionResult = undefined,\n> = {\n  /** Extracted path parameters */\n  params: Params;\n  /** Request object with URL and headers */\n  request: Request;\n  /** AbortSignal for cancellation on navigation */\n  signal: AbortSignal;\n  /** Result from the action, if this load was triggered by a form submission */\n  actionResult: ActionResult | undefined;\n};\n\n/**\n * Props for route components without loader.\n * Includes navigation state management props.\n */\nexport interface RouteComponentProps<\n  TParams extends Record<string, string>,\n  TState = undefined,\n> {\n  /** Extracted path parameters */\n  params: TParams;\n  /** Current navigation state for this route (undefined on first visit) */\n  state: TState | undefined;\n  /** Update navigation state for this route asynchronously via replace navigation */\n  setState: (\n    state: TState | ((prev: TState | undefined) => TState),\n  ) => Promise<void>;\n  /** Update navigation state for this route synchronously via updateCurrentEntry */\n  setStateSync: (\n    state: TState | ((prev: TState | undefined) => TState),\n  ) => void;\n  /** Reset navigation state to undefined asynchronously via replace navigation */\n  resetState: () => Promise<void>;\n  /** Reset navigation state to undefined synchronously via updateCurrentEntry */\n  resetStateSync: () => void;\n  /** Ephemeral navigation info (only available during navigation, not persisted) */\n  info: unknown;\n  /** Whether a navigation transition is pending */\n  isPending: boolean;\n}\n\n/**\n * Props for route components with loader.\n * Includes data from loader and navigation state management props.\n */\nexport interface RouteComponentPropsWithData<\n  TParams extends Record<string, string>,\n  TData,\n  TState = undefined,\n> extends RouteComponentProps<TParams, TState> {\n  /** Data returned from the loader */\n  data: TData;\n}\n\n/**\n * Route definition created by the `route` helper function.\n */\nexport interface OpaqueRouteDefinition {\n  [routeDefinitionSymbol]: unknown;\n  path?: string;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n}\n\n/**\n * Type-carrying route definition created by the `route` helper function when an `id` is provided.\n * This type carries type information for params, state, and data, enabling type-safe hooks in the future.\n */\nexport interface TypefulOpaqueRouteDefinition<\n  Id extends string,\n  Params extends Record<string, string>,\n  State,\n  Data,\n> {\n  [routeDefinitionSymbol]: {\n    id: Id;\n    params: Params;\n    state: State;\n    data: Data;\n  };\n  path?: string;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n}\n\n/**\n * Partial route definition created by the `route` helper function when `id` is provided but `component` is not.\n * Used for two-phase route definition in RSC: Phase 1 defines id, path, loader, action;\n * Phase 2 uses `bindRoute()` to attach the component.\n * This type carries type information for params, state, and data, enabling type-safe hooks.\n */\nexport interface PartialRouteDefinition<\n  Id extends string,\n  Params extends Record<string, string>,\n  State,\n  Data,\n> {\n  [partialRouteDefinitionSymbol]: {\n    id: Id;\n    params: Params;\n    state: State;\n    data: Data;\n  };\n  path?: string;\n}\n\n/** Extract the Id type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteId<T> =\n  T extends PartialRouteDefinition<\n    infer Id,\n    infer _Params,\n    infer _State,\n    infer _Data\n  >\n    ? Id\n    : T extends TypefulOpaqueRouteDefinition<\n          infer Id,\n          infer _Params,\n          infer _State,\n          infer _Data\n        >\n      ? Id\n      : never;\n\n/** Extract the Params type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteParams<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer Params,\n    infer _State,\n    infer _Data\n  >\n    ? Params\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer Params,\n          infer _State,\n          infer _Data\n        >\n      ? Params\n      : never;\n\n/** Extract the State type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteState<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer _Params,\n    infer State,\n    infer _Data\n  >\n    ? State\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer _Params,\n          infer State,\n          infer _Data\n        >\n      ? State\n      : never;\n\n/** Extract the Data type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type ExtractRouteData<T> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer _Params,\n    infer _State,\n    infer Data\n  >\n    ? Data\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer _Params,\n          infer _State,\n          infer Data\n        >\n      ? Data\n      : never;\n\n/** Extract the component props type from a TypefulOpaqueRouteDefinition or PartialRouteDefinition */\nexport type RouteComponentPropsOf<\n  T extends\n    | TypefulOpaqueRouteDefinition<\n        string,\n        Record<string, string>,\n        unknown,\n        unknown\n      >\n    | PartialRouteDefinition<string, Record<string, string>, unknown, unknown>,\n> =\n  T extends PartialRouteDefinition<\n    infer _Id,\n    infer Params,\n    infer State,\n    infer Data\n  >\n    ? Data extends undefined\n      ? RouteComponentProps<Params, State>\n      : RouteComponentPropsWithData<Params, Data, State>\n    : T extends TypefulOpaqueRouteDefinition<\n          infer _Id,\n          infer Params,\n          infer State,\n          infer Data\n        >\n      ? Data extends undefined\n        ? RouteComponentProps<Params, State>\n        : RouteComponentPropsWithData<Params, Data, State>\n      : never;\n\n/**\n * Any route definition defined by user.\n */\nexport type RouteDefinition =\n  | OpaqueRouteDefinition\n  | TypefulOpaqueRouteDefinition<\n      string,\n      Record<string, string>,\n      unknown,\n      unknown\n    >\n  | {\n      path?: string;\n      component?: ComponentType<object> | ReactNode;\n      children?: RouteDefinition[];\n      exact?: boolean;\n      requireChildren?: boolean;\n    };\n\n/**\n * Route definition with action and loader.\n * Action result flows to loader via actionResult parameter.\n */\ntype RouteWithActionAndLoader<\n  TPath extends string,\n  TActionResult,\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => TActionResult;\n  loader: (\n    args: LoaderArgs<PathParams<TPath>, Awaited<TActionResult>>,\n  ) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition with action only (no loader).\n * Action executes as a pure side effect.\n */\ntype RouteWithActionOnly<\n  TPath extends string,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => unknown;\n  component?:\n    | ComponentType<RouteComponentProps<PathParams<TPath>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition with loader - infers TData from loader return type.\n * TPath is used to infer params type from the path pattern.\n * TState is the type of navigation state for this route.\n * TId is the optional route identifier for type-safe route references.\n */\ntype RouteWithLoader<\n  TPath extends string,\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  loader: (args: LoaderArgs<PathParams<TPath>>) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Route definition without loader.\n * TPath is used to infer params type from the path pattern.\n * TState is the type of navigation state for this route.\n * TId is the optional route identifier for type-safe route references.\n */\ntype RouteWithoutLoader<\n  TPath extends string,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  component?:\n    | ComponentType<RouteComponentProps<PathParams<TPath>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Pathless route definition with loader.\n * Pathless routes always match and don't consume any pathname.\n */\ntype PathlessRouteWithLoader<\n  TData,\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  loader: (args: LoaderArgs<Record<string, never>>) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<Record<string, never>, TData, TState>\n      >\n    | ReactNode;\n  children?: RouteDefinition[];\n  requireChildren?: boolean;\n};\n\n/**\n * Pathless route definition without loader.\n * Pathless routes always match and don't consume any pathname.\n */\ntype PathlessRouteWithoutLoader<\n  TState,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  component?:\n    | ComponentType<RouteComponentProps<Record<string, never>, TState>>\n    | ReactNode;\n  children?: RouteDefinition[];\n  requireChildren?: boolean;\n};\n\n/**\n * Partial route definition with action and loader (no component).\n * Used for two-phase route definition.\n */\ntype PartialRouteWithActionAndLoader<\n  TPath extends string,\n  TActionResult,\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => TActionResult;\n  loader: (\n    args: LoaderArgs<PathParams<TPath>, Awaited<TActionResult>>,\n  ) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition with action only (no component, no loader).\n */\ntype PartialRouteWithActionOnly<\n  TPath extends string,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  action: (args: ActionArgs<PathParams<TPath>>) => unknown;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition with loader (no component).\n */\ntype PartialRouteWithLoader<\n  TPath extends string,\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  loader: (args: LoaderArgs<PathParams<TPath>>) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial route definition without loader or component.\n */\ntype PartialRouteWithoutLoader<\n  TPath extends string,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path: TPath;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial pathless route definition with loader (no component).\n */\ntype PartialPathlessRouteWithLoader<\n  TData,\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  loader: (args: LoaderArgs<Record<string, never>>) => TData;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Partial pathless route definition without loader or component.\n */\ntype PartialPathlessRouteWithoutLoader<\n  TId extends string | undefined = undefined,\n> = {\n  id?: TId;\n  path?: undefined;\n  component?: never;\n  children?: never;\n  exact?: never;\n  requireChildren?: never;\n};\n\n/**\n * Helper function for creating type-safe route definitions.\n *\n * When a loader is provided, TypeScript infers the return type and ensures\n * the component accepts a `data` prop of that type. Components always receive\n * a `params` prop with types inferred from the path pattern.\n *\n * For routes with navigation state, use `routeState<TState>()({ ... })` instead.\n *\n * @example\n * ```typescript\n * // Route with async loader\n * route({\n *   path: \"users/:userId\",\n *   loader: async ({ params, signal }) => {\n *     const res = await fetch(`/api/users/${params.userId}`, { signal });\n *     return res.json() as Promise<User>;\n *   },\n *   component: UserDetail, // Must accept { data: Promise<User>, params: { userId: string }, state, setState, resetState }\n * });\n *\n * // Route without loader\n * route({\n *   path: \"about\",\n *   component: AboutPage, // Must accept { params: {}, state, setState, resetState }\n * });\n * ```\n */\n// Partial overload: id + action + loader (no component) → PartialRouteDefinition\nexport function route<\n  TId extends string,\n  const TPath extends string,\n  TActionResult,\n  TData,\n>(\n  definition: PartialRouteWithActionAndLoader<\n    TPath,\n    TActionResult,\n    TData,\n    TId\n  > & {\n    id: TId;\n  },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Partial overload: id + action only (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: PartialRouteWithActionOnly<TPath, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Partial overload: id + pathless + loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, TData>(\n  definition: PartialPathlessRouteWithLoader<TData, TId> & { id: TId },\n): PartialRouteDefinition<TId, Record<string, never>, undefined, TData>;\n// Partial overload: id + pathless + no loader (no component) → PartialRouteDefinition\nexport function route<TId extends string>(\n  definition: PartialPathlessRouteWithoutLoader<TId> & { id: TId },\n): PartialRouteDefinition<TId, Record<string, never>, undefined, undefined>;\n// Partial overload: id + loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string, TData>(\n  definition: PartialRouteWithLoader<TPath, TData, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Partial overload: id + no loader (no component) → PartialRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: PartialRouteWithoutLoader<TPath, TId> & { id: TId },\n): PartialRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with id + action + loader → TypefulOpaqueRouteDefinition\nexport function route<\n  TId extends string,\n  const TPath extends string,\n  TActionResult,\n  TData,\n>(\n  definition: RouteWithActionAndLoader<\n    TPath,\n    TActionResult,\n    TData,\n    undefined,\n    TId\n  > & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Overload with id + action only → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: RouteWithActionOnly<TPath, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with action + loader (no id)\nexport function route<const TPath extends string, TActionResult, TData>(\n  definition: RouteWithActionAndLoader<TPath, TActionResult, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload with action only (no id)\nexport function route<const TPath extends string>(\n  definition: RouteWithActionOnly<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Pathless overload with id + loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, TData>(\n  definition: PathlessRouteWithLoader<TData, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, Record<string, never>, undefined, TData>;\n// Pathless overload with id + no loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string>(\n  definition: PathlessRouteWithoutLoader<undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<\n  TId,\n  Record<string, never>,\n  undefined,\n  undefined\n>;\n// Pathless overload with loader (no id)\nexport function route<TData>(\n  definition: PathlessRouteWithLoader<TData, undefined>,\n): OpaqueRouteDefinition;\n// Pathless overload without loader (no id)\nexport function route(\n  definition: PathlessRouteWithoutLoader<undefined>,\n): OpaqueRouteDefinition;\n// Overload with id + loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>;\n// Overload with id + no loader → TypefulOpaqueRouteDefinition\nexport function route<TId extends string, const TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined, TId> & { id: TId },\n): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;\n// Overload with loader (no id)\nexport function route<const TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload without loader (no id)\nexport function route<const TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Implementation\nexport function route(\n  definition: object,\n):\n  | OpaqueRouteDefinition\n  | PartialRouteDefinition<string, Record<string, string>, unknown, unknown> {\n  return definition as unknown as OpaqueRouteDefinition;\n}\n\n/**\n * Helper function for creating type-safe route definitions with navigation state.\n *\n * Use this curried function when your route component needs to manage navigation state.\n * The state is tied to the navigation history entry and persists across back/forward navigation.\n *\n * @example\n * ```typescript\n * // Route with navigation state\n * type MyState = { scrollPosition: number };\n * routeState<MyState>()({\n *   path: \"users/:userId\",\n *   component: UserPage, // Receives { params, state, setState, resetState }\n * });\n *\n * // Route with both loader and navigation state\n * type FilterState = { filter: string };\n * routeState<FilterState>()({\n *   path: \"products\",\n *   loader: async () => fetchProducts(),\n *   component: ProductList, // Receives { data, params, state, setState, resetState }\n * });\n * ```\n */\nexport function routeState<TState>(): {\n  // Partial overload: id + action + loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string, TActionResult, TData>(\n    definition: PartialRouteWithActionAndLoader<\n      TPath,\n      TActionResult,\n      TData,\n      TId\n    > & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Partial overload: id + action only (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: PartialRouteWithActionOnly<TPath, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Partial overload: id + pathless + loader (no component) → PartialRouteDefinition\n  <TId extends string, TData>(\n    definition: PartialPathlessRouteWithLoader<TData, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, Record<string, never>, TState, TData>;\n  // Partial overload: id + pathless + no loader (no component) → PartialRouteDefinition\n  <TId extends string>(\n    definition: PartialPathlessRouteWithoutLoader<TId> & { id: TId },\n  ): PartialRouteDefinition<TId, Record<string, never>, TState, undefined>;\n  // Partial overload: id + loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string, TData>(\n    definition: PartialRouteWithLoader<TPath, TData, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Partial overload: id + no loader (no component) → PartialRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: PartialRouteWithoutLoader<TPath, TId> & { id: TId },\n  ): PartialRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with id + action + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string, TActionResult, TData>(\n    definition: RouteWithActionAndLoader<\n      TPath,\n      TActionResult,\n      TData,\n      TState,\n      TId\n    > & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Overload with id + action only → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: RouteWithActionOnly<TPath, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with action + loader (no id)\n  <TPath extends string, TActionResult, TData>(\n    definition: RouteWithActionAndLoader<TPath, TActionResult, TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Overload with action only (no id)\n  <TPath extends string>(\n    definition: RouteWithActionOnly<TPath, TState>,\n  ): OpaqueRouteDefinition;\n  // Pathless overload with id + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TData>(\n    definition: PathlessRouteWithLoader<TData, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, Record<string, never>, TState, TData>;\n  // Pathless overload with id + no loader → TypefulOpaqueRouteDefinition\n  <TId extends string>(\n    definition: PathlessRouteWithoutLoader<TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<\n    TId,\n    Record<string, never>,\n    TState,\n    undefined\n  >;\n  // Pathless overload with loader (no id)\n  <TData>(\n    definition: PathlessRouteWithLoader<TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Pathless overload without loader (no id)\n  (definition: PathlessRouteWithoutLoader<TState>): OpaqueRouteDefinition;\n  // Overload with id + loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, TData>;\n  // Overload with id + no loader → TypefulOpaqueRouteDefinition\n  <TId extends string, TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState, TId> & { id: TId },\n  ): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, undefined>;\n  // Overload with loader (no id)\n  <TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState>,\n  ): OpaqueRouteDefinition;\n  // Overload without loader (no id)\n  <TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition;\n} {\n  return ((definition: object) => {\n    return definition as unknown as OpaqueRouteDefinition;\n  }) as never;\n}\n","import type { ComponentType, ReactNode } from \"react\";\nimport type {\n  OpaqueRouteDefinition,\n  PartialRouteDefinition,\n  RouteDefinition,\n  TypefulOpaqueRouteDefinition,\n} from \"./route.js\";\n\ntype BindRouteOptions = {\n  component: ComponentType<any> | ReactNode;\n  children?: RouteDefinition[];\n  exact?: boolean;\n  requireChildren?: boolean;\n};\n\n/**\n * Binds a component (and optionally children) to a partial route definition,\n * producing a full route definition for use with `<Router />`.\n *\n * This is the Phase 2 of two-phase route definition for RSC:\n * - Phase 1: `route()` without component → `PartialRouteDefinition` (shared module)\n * - Phase 2: `bindRoute()` with component → full route definition (server module)\n *\n * @example\n * ```tsx\n * // Phase 1 (shared module)\n * export const userRoute = route({\n *   id: \"user\",\n *   path: \"/:userId\",\n *   loader: fetchUser,\n * });\n *\n * // Phase 2 (server module)\n * const routes = [\n *   bindRoute(userRoute, { component: <UserProfile /> }),\n * ];\n * ```\n */\nexport function bindRoute<\n  TId extends string,\n  TParams extends Record<string, string>,\n  TState,\n  TData,\n>(\n  partialRoute: PartialRouteDefinition<TId, TParams, TState, TData>,\n  binding: BindRouteOptions,\n): TypefulOpaqueRouteDefinition<TId, TParams, TState, TData>;\nexport function bindRoute(\n  partialRoute: OpaqueRouteDefinition,\n  binding: BindRouteOptions,\n): OpaqueRouteDefinition;\nexport function bindRoute(\n  partialRoute: object,\n  binding: BindRouteOptions,\n): object {\n  return { ...partialRoute, ...binding };\n}\n"],"mappings":";AAynBA,SAAgB,MACd,YAG2E;AAC3E,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aAuFd;AACA,UAAS,eAAuB;AAC9B,SAAO;;;;;AC/rBX,SAAgB,UACd,cACA,SACQ;AACR,QAAO;EAAE,GAAG;EAAc,GAAG;EAAS"}

package/dist/{bindRoute-BtT4qPKI.d.mts → bindRoute-DulMzi5X.d.mts}

@@ -446,4 +446,4 @@ declare function bindRoute<TId extends string, TParams extends Record<string, st
 declare function bindRoute(partialRoute: OpaqueRouteDefinition, binding: BindRouteOptions): OpaqueRouteDefinition;
 //#endregion
 export { routeState as _, ExtractRouteParams as a, OpaqueRouteDefinition as c, RouteComponentProps as d, RouteComponentPropsOf as f, route as g, TypefulOpaqueRouteDefinition as h, ExtractRouteId as i, PartialRouteDefinition as l, RouteDefinition as m, ActionArgs as n, ExtractRouteState as o, RouteComponentPropsWithData as p, ExtractRouteData as r, LoaderArgs as s, bindRoute as t, PathParams as u };
-//# sourceMappingURL=bindRoute-BtT4qPKI.d.mts.map
+//# sourceMappingURL=bindRoute-DulMzi5X.d.mts.map

package/dist/{bindRoute-BtT4qPKI.d.mts.map → bindRoute-DulMzi5X.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"bindRoute-BtT4qPKI.d.mts","names":[],"sources":["../src/route.ts","../src/bindRoute.ts"],"mappings":"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"}
+{"version":3,"file":"bindRoute-DulMzi5X.d.mts","names":[],"sources":["../src/route.ts","../src/bindRoute.ts"],"mappings":"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"}

package/dist/docs/ApiHooksPage.tsx

@@ -21,7 +21,16 @@ function MyComponent() {
   console.log(location.pathname);  // "/users/123"
   console.log(location.search);    // "?tab=profile"
   console.log(location.hash);      // "#section"
+  console.log(location.entryId);   // NavigationHistoryEntry.id or null
+  console.log(location.entryKey);  // NavigationHistoryEntry.key or null
 }`}</CodeBlock>
+        <p>
+          <code>entryId</code> and <code>entryKey</code> are <code>null</code>{" "}
+          when the Navigation API is unavailable. Do not render them directly in
+          DOM — they are not available during SSR and will cause a hydration
+          mismatch. Use them as a React <code>key</code> or in effects/callbacks
+          instead.
+        </p>
       </article>
 
       <article className="api-item">

package/dist/docs/ApiTypesPage.tsx

@@ -335,7 +335,24 @@ routeState<{ tab: string }>()({
   pathname: string;
   search: string;
   hash: string;
+  entryId: string | null;   // NavigationHistoryEntry.id
+  entryKey: string | null;  // NavigationHistoryEntry.key
 }`}</CodeBlock>
+        <p>
+          <code>entryId</code> and <code>entryKey</code> expose the
+          corresponding properties from the Navigation API's{" "}
+          <code>NavigationHistoryEntry</code>. <code>entryId</code> is a unique
+          identifier for the entry — a new id is assigned when the entry is
+          replaced. <code>entryKey</code> represents the slot in the entry list
+          and is stable across replacements. Both are <code>null</code> when the
+          Navigation API is unavailable (e.g., in static fallback mode).
+        </p>
+        <p>
+          <strong>Warning:</strong> Do not render these values directly in DOM,
+          as they are not available during SSR and will cause a hydration
+          mismatch. They are best suited for use as a React <code>key</code> or
+          in effects/callbacks.
+        </p>
       </article>
 
       <article className="api-item">

package/dist/docs/LearnLoadersPage.tsx

@@ -0,0 +1,320 @@
+import { CodeBlock } from "../components/CodeBlock.js";
+
+export function LearnLoadersPage() {
+  return (
+    <div className="learn-content">
+      <h2>How Loaders Run</h2>
+
+      <p className="page-intro">
+        Loaders fetch data for a route before the UI renders. This page explains
+        when loaders execute, how results are cached, and how different types of
+        navigation affect loader behavior.
+      </p>
+
+      <section>
+        <h3>Defining a Loader</h3>
+        <p>
+          A loader is a function on a route definition that receives the route
+          params, a <code>Request</code>, and an <code>AbortSignal</code>. It
+          can return any value &mdash; typically a Promise from a fetch call:
+        </p>
+        <CodeBlock language="tsx">{`import { route } from "@funstack/router";
+
+const userRoute = route({
+  path: "/users/:id",
+  loader: async ({ params, request, signal }) => {
+    const res = await fetch(\`/api/users/\${params.id}\`, { signal });
+    return res.json();
+  },
+  component: UserPage,
+});`}</CodeBlock>
+        <p>
+          The component receives the loader&rsquo;s return value as the{" "}
+          <code>data</code> prop. For async loaders this is a{" "}
+          <code>Promise</code>, which you unwrap with React&rsquo;s{" "}
+          <code>use()</code> hook inside a <code>Suspense</code> boundary:
+        </p>
+        <CodeBlock language="tsx">{`import { use, Suspense } from "react";
+
+function UserPage({ data }: { data: Promise<User> }) {
+  return (
+    <Suspense fallback={<p>Loading...</p>}>
+      <UserDetail data={data} />
+    </Suspense>
+  );
+}
+
+function UserDetail({ data }: { data: Promise<User> }) {
+  const user = use(data);
+  return <h1>{user.name}</h1>;
+}`}</CodeBlock>
+      </section>
+
+      <section>
+        <h3>When Loaders Execute</h3>
+        <p>Loaders run at two points in the lifecycle:</p>
+        <ol>
+          <li>
+            <strong>Initial page load</strong> &mdash; When the Router first
+            renders, it matches the current URL against the route definitions
+            and executes all matching loaders immediately.
+          </li>
+          <li>
+            <strong>Navigation events</strong> &mdash; When the user navigates
+            (by clicking a link, submitting a form, or calling{" "}
+            <code>navigate()</code>), the Router matches the destination URL and
+            executes loaders for the matched routes.
+          </li>
+        </ol>
+        <p>
+          In both cases, all loaders in the matched route stack (parent and
+          child) run <strong>in parallel</strong>. The navigation completes once
+          every loader&rsquo;s Promise has resolved.
+        </p>
+      </section>
+
+      <section>
+        <h3>Caching by Navigation Entry</h3>
+        <p>
+          Loader results are cached using the{" "}
+          <strong>navigation entry ID</strong> from the Navigation API. Each
+          time you navigate to a new URL, the browser creates a new navigation
+          entry with a unique ID. The Router uses this ID as the cache key, so:
+        </p>
+        <ul>
+          <li>
+            Re-renders of the same page <strong>do not</strong> re-execute
+            loaders &mdash; the cached result is returned.
+          </li>
+          <li>
+            Navigating to a new URL always creates a new entry and{" "}
+            <strong>always</strong> executes loaders, even if the URL is the
+            same as a previous navigation.
+          </li>
+        </ul>
+        <p>
+          This design ensures that loaders run exactly once per navigation while
+          preventing unnecessary re-fetches during React re-renders.
+        </p>
+      </section>
+
+      <section>
+        <h3>Navigation Types and Loader Behavior</h3>
+        <p>
+          Different types of navigation have different effects on whether
+          loaders run:
+        </p>
+
+        <h4>Push and Replace</h4>
+        <p>
+          A <strong>push</strong> navigation (the default when clicking a link
+          or calling <code>navigate()</code>) creates a new navigation entry.
+          Since the entry is new, loaders always execute. A{" "}
+          <strong>replace</strong> navigation behaves the same way &mdash; it
+          creates a new entry that replaces the current one, so loaders execute
+          fresh.
+        </p>
+
+        <h4>Traverse (Back / Forward)</h4>
+        <p>
+          When the user goes back or forward in history, the browser revisits an{" "}
+          <strong>existing</strong> navigation entry. Because the entry ID is
+          the same as when the page was originally visited, the cached loader
+          results are returned <strong>without re-executing</strong> the
+          loaders. This makes back/forward navigation instant.
+        </p>
+
+        <h4>Reload</h4>
+        <p>
+          A reload navigation stays on the same navigation entry, but the Router
+          generates a <strong>fresh cache key</strong> so that all loaders{" "}
+          <strong>re-execute</strong>. This is useful when you want to refresh
+          data without navigating away from the current page.
+        </p>
+        <p>
+          You can trigger a reload programmatically using the Navigation
+          API&rsquo;s <code>navigation.reload()</code> method:
+        </p>
+        <CodeBlock language="tsx">{`function RefreshButton() {
+  return (
+    <button onClick={() => navigation.reload()}>
+      Refresh Data
+    </button>
+  );
+}`}</CodeBlock>
+        <p>
+          During a reload, the old cached data remains available for the{" "}
+          <strong>pending UI</strong>. Because the Router wraps navigations in a
+          React transition, the previous UI stays on screen while the new data
+          loads. Once the new loaders resolve, the UI updates. This means users
+          see the existing content while the refresh is in progress, rather than
+          a blank screen or loading spinner.
+        </p>
+        <p>
+          Consecutive reloads work correctly &mdash; each reload increments an
+          internal counter to produce a unique cache key, and stale caches are
+          pruned automatically.
+        </p>
+
+        <h4>Form Submissions</h4>
+        <p>
+          When a <code>{'<form method="post">'}</code> is submitted, the Router
+          runs the matched route&rsquo;s <code>action</code> first, then clears
+          the loader cache for the current entry and re-executes all loaders.
+          The action&rsquo;s return value is passed to each loader as{" "}
+          <code>actionResult</code>. See the{" "}
+          <a href="/learn/actions">Form Actions</a> page for details.
+        </p>
+      </section>
+
+      <section>
+        <h3>Nested Route Loaders</h3>
+        <p>
+          When routes are nested, each route in the matched stack can define its
+          own loader. All loaders in the stack execute in parallel, and each
+          component receives its own loader&rsquo;s result:
+        </p>
+        <CodeBlock language="tsx">{`const routes = [
+  route({
+    path: "/dashboard",
+    loader: () => fetchDashboardLayout(),
+    component: DashboardLayout,
+    children: [
+      route({
+        path: "/stats",
+        loader: () => fetchStats(),
+        component: StatsPage,
+      }),
+    ],
+  }),
+];
+
+// When navigating to /dashboard/stats:
+// → fetchDashboardLayout() and fetchStats() run in parallel
+// → DashboardLayout receives the layout data
+// → StatsPage receives the stats data`}</CodeBlock>
+        <p>
+          On reload, <strong>all</strong> loaders in the matched stack
+          re-execute, not just the deepest one.
+        </p>
+      </section>
+
+      <section>
+        <h3>Cache Cleanup</h3>
+        <p>
+          Cached loader results are automatically cleaned up when a navigation
+          entry is <strong>disposed</strong>. The browser disposes entries when
+          they are removed from the history stack (for example, when the user
+          navigates forward from a point in the middle of the history stack, the
+          entries ahead are discarded). The Router listens for these dispose
+          events and removes the corresponding cached data.
+        </p>
+      </section>
+
+      <section>
+        <h3>Error Handling</h3>
+        <p>
+          When a loader throws an error, the router catches it and re-throws it
+          during rendering of that route&rsquo;s component. This means the error
+          can be caught by a React{" "}
+          <a href="https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary">
+            Error Boundary
+          </a>{" "}
+          placed above the route in the component tree. For async loaders that
+          return a rejected promise, the error is surfaced when{" "}
+          <code>use(data)</code> is called, which is also caught by Error
+          Boundaries.
+        </p>
+        <p>
+          The recommended pattern is to place an error boundary in your{" "}
+          <strong>root layout route</strong>, wrapping the{" "}
+          <code>{"<Outlet />"}</code>. This catches errors from any loader in
+          the route tree while keeping the root layout (header, navigation,
+          etc.) intact:
+        </p>
+        <CodeBlock language="tsx">{`import { Router, route, Outlet } from "@funstack/router";
+import { ErrorBoundary } from "./ErrorBoundary";
+
+function RootLayout() {
+  return (
+    <div>
+      <header>My App</header>
+      <ErrorBoundary fallback={<div>Something went wrong.</div>}>
+        <Outlet />
+      </ErrorBoundary>
+    </div>
+  );
+}
+
+const routes = [
+  route({
+    path: "/",
+    component: RootLayout,
+    children: [
+      route({
+        path: "/",
+        component: HomePage,
+      }),
+      route({
+        path: "/users/:id",
+        component: UserPage,
+        loader: async ({ params }) => {
+          const res = await fetch(\`/api/users/\${params.id}\`);
+          if (!res.ok) throw new Error("Failed to load user");
+          return res.json();
+        },
+      }),
+    ],
+  }),
+];`}</CodeBlock>
+        <p>
+          This works for both synchronous and asynchronous loaders. For sync
+          loaders, the router catches the error and re-throws it during route
+          rendering. For async loaders, the rejected promise naturally surfaces
+          through <code>use()</code>. Either way, Error Boundaries catch the
+          error.
+        </p>
+        <p>
+          You can also place error boundaries at more granular levels (e.g.,
+          wrapping a specific route&rsquo;s <code>{"<Outlet />"}</code> or{" "}
+          <code>{"<Suspense>"}</code> boundary) for fine-grained error handling.
+        </p>
+      </section>
+
+      <section>
+        <h3>Summary</h3>
+        <table className="summary-table">
+          <thead>
+            <tr>
+              <th>Navigation type</th>
+              <th>Loaders run?</th>
+              <th>Why</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>Push / Replace</td>
+              <td>Yes</td>
+              <td>New navigation entry, no cache</td>
+            </tr>
+            <tr>
+              <td>Traverse (Back / Forward)</td>
+              <td>No</td>
+              <td>Existing entry, cached results returned</td>
+            </tr>
+            <tr>
+              <td>Reload</td>
+              <td>Yes</td>
+              <td>Fresh cache key generated</td>
+            </tr>
+            <tr>
+              <td>Form submission (POST)</td>
+              <td>Yes</td>
+              <td>Cache cleared after action runs</td>
+            </tr>
+          </tbody>
+        </table>
+      </section>
+    </div>
+  );
+}

package/dist/docs/index.md

@@ -16,6 +16,7 @@
 ### Learn
 
 - [Form Actions](./LearnActionsPage.tsx) - FUNSTACK Router can intercept submissions and run an action function on the client before navigation occurs. This guide explains how actions work, when to use them, and important considerations for progressive enhancement.
+- [How Loaders Run](./LearnLoadersPage.tsx) - Loaders fetch data for a route before the UI renders. This page explains when loaders execute, how results are cached, and how different types of navigation affect loader behavior.
 - [Navigation API](./LearnNavigationApiPage.tsx) - FUNSTACK Router is built on the Navigation API , a modern browser API that provides a unified way to handle navigation. This guide explains the key differences from the older History API and the benefits this brings to your application.
 - [Nested Routes](./LearnNestedRoutesPage.tsx) - Nested routes let you build complex page layouts where parts of the UI persist across navigation while other parts change. Think of a dashboard with a sidebar that stays in place while the main content area updates—that's nested routing in action.
 - [RSC with Route Features](./LearnRouteDefinitionsPage.tsx) - When using React Server Components as route components, you may also want route features like loaders, typed hooks ( useRouteParams, useRouteData), and navigation state. The challenge is that route definitions referencing server components cannot be imported from client modules. This guide shows how to split a route definition into a shared part (importable by client components for type safety) and a server part (where the component is attached), enabling full route features alongside RSC.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as routeState, a as ExtractRouteParams, c as OpaqueRouteDefinition, d as RouteComponentProps, f as RouteComponentPropsOf, g as route, h as TypefulOpaqueRouteDefinition, i as ExtractRouteId, l as PartialRouteDefinition, m as RouteDefinition, n as ActionArgs, o as ExtractRouteState, p as RouteComponentPropsWithData, r as ExtractRouteData, s as LoaderArgs, t as bindRoute, u as PathParams } from "./bindRoute-BtT4qPKI.mjs";
+import { _ as routeState, a as ExtractRouteParams, c as OpaqueRouteDefinition, d as RouteComponentProps, f as RouteComponentPropsOf, g as route, h as TypefulOpaqueRouteDefinition, i as ExtractRouteId, l as PartialRouteDefinition, m as RouteDefinition, n as ActionArgs, o as ExtractRouteState, p as RouteComponentPropsWithData, r as ExtractRouteData, s as LoaderArgs, t as bindRoute, u as PathParams } from "./bindRoute-DulMzi5X.mjs";
 import { ComponentType, ReactNode } from "react";
 
 //#region src/types.d.ts
@@ -72,6 +72,26 @@ type Location = {
   pathname: string;
   search: string;
   hash: string;
+  /**
+   * NavigationHistoryEntry.id — unique identifier for this entry.
+   * A new id is assigned when the entry is replaced.
+   * Null when Navigation API is unavailable.
+   *
+   * **Warning:** Do not render this value directly in DOM, as it is not
+   * available during SSR and will cause a hydration mismatch. Use it as a
+   * React `key` or in effects/callbacks instead.
+   */
+  entryId: string | null;
+  /**
+   * NavigationHistoryEntry.key — represents the slot in the entry list.
+   * Stable across replacements.
+   * Null when Navigation API is unavailable.
+   *
+   * **Warning:** Do not render this value directly in DOM, as it is not
+   * available during SSR and will cause a hydration mismatch. Use it as a
+   * React `key` or in effects/callbacks instead.
+   */
+  entryKey: string | null;
 };
 /**
  * Callback invoked before navigation is intercepted.