@funstack/router 0.0.7 → 0.0.9

package/dist/{route-ClVnhrQD.d.mts → route-DRcgs0Pt.d.mts}

@@ -12,13 +12,23 @@ type ExtractParams<T extends string> = T extends `${string}:${infer Param}/${inf
  * E.g., "/users/:id" -> { id: string }
  */
 type PathParams<T extends string> = [ExtractParams<T>] extends [never] ? Record<string, never> : { [K in ExtractParams<T>]: string };
+/**
+ * Arguments passed to action functions.
+ * The request carries the POST method and FormData body.
+ */
+type ActionArgs<Params extends Record<string, string>> = {
+  /** Extracted path parameters */params: Params; /** Request object with method POST and FormData body */
+  request: Request; /** AbortSignal for cancellation */
+  signal: AbortSignal;
+};
 /**
  * Arguments passed to loader functions.
  */
-type LoaderArgs<Params extends Record<string, string>> = {
+type LoaderArgs<Params extends Record<string, string>, ActionResult = undefined> = {
   /** Extracted path parameters */params: Params; /** Request object with URL and headers */
   request: Request; /** AbortSignal for cancellation on navigation */
-  signal: AbortSignal;
+  signal: AbortSignal; /** Result from the action, if this load was triggered by a form submission */
+  actionResult: ActionResult | undefined;
 };
 /**
  * Props for route components without loader.
@@ -33,8 +43,10 @@ interface RouteComponentProps<TParams extends Record<string, string>, TState = u
   setState: (state: TState | ((prev: TState | undefined) => TState)) => Promise<void>;
   /** Update navigation state for this route synchronously via updateCurrentEntry */
   setStateSync: (state: TState | ((prev: TState | undefined) => TState)) => void;
-  /** Reset navigation state to undefined */
-  resetState: () => void;
+  /** Reset navigation state to undefined asynchronously via replace navigation */
+  resetState: () => Promise<void>;
+  /** Reset navigation state to undefined synchronously via updateCurrentEntry */
+  resetStateSync: () => void;
   /** Ephemeral navigation info (only available during navigation, not persisted) */
   info: unknown;
   /** Whether a navigation transition is pending */
@@ -94,6 +106,33 @@ type RouteDefinition = OpaqueRouteDefinition | TypefulOpaqueRouteDefinition<stri
   exact?: boolean;
   requireChildren?: boolean;
 };
+/**
+ * Route definition with action and loader.
+ * Action result flows to loader via actionResult parameter.
+ */
+type RouteWithActionAndLoader<TPath extends string, TActionResult, TData, TState, TId extends string | undefined = undefined> = {
+  id?: TId;
+  path: TPath;
+  action: (args: ActionArgs<PathParams<TPath>>) => TActionResult;
+  loader: (args: LoaderArgs<PathParams<TPath>, Awaited<TActionResult>>) => TData;
+  component: ComponentType<RouteComponentPropsWithData<PathParams<TPath>, TData, TState>> | ReactNode;
+  children?: RouteDefinition[];
+  exact?: boolean;
+  requireChildren?: boolean;
+};
+/**
+ * Route definition with action only (no loader).
+ * Action executes as a pure side effect.
+ */
+type RouteWithActionOnly<TPath extends string, TState, TId extends string | undefined = undefined> = {
+  id?: TId;
+  path: TPath;
+  action: (args: ActionArgs<PathParams<TPath>>) => unknown;
+  component?: ComponentType<RouteComponentProps<PathParams<TPath>, TState>> | ReactNode;
+  children?: RouteDefinition[];
+  exact?: boolean;
+  requireChildren?: boolean;
+};
 /**
  * Route definition with loader - infers TData from loader return type.
  * TPath is used to infer params type from the path pattern.
@@ -174,6 +213,14 @@ type PathlessRouteWithoutLoader<TState, TId extends string | undefined = undefin
  * });
  * ```
  */
+declare function route<TId extends string, const TPath extends string, TActionResult, TData>(definition: RouteWithActionAndLoader<TPath, TActionResult, TData, undefined, TId> & {
+  id: TId;
+}): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>;
+declare function route<TId extends string, const TPath extends string>(definition: RouteWithActionOnly<TPath, undefined, TId> & {
+  id: TId;
+}): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, undefined>;
+declare function route<const TPath extends string, TActionResult, TData>(definition: RouteWithActionAndLoader<TPath, TActionResult, TData, undefined>): OpaqueRouteDefinition;
+declare function route<const TPath extends string>(definition: RouteWithActionOnly<TPath, undefined>): OpaqueRouteDefinition;
 declare function route<TId extends string, TData>(definition: PathlessRouteWithLoader<TData, undefined, TId> & {
   id: TId;
 }): TypefulOpaqueRouteDefinition<TId, Record<string, never>, undefined, TData>;
@@ -215,6 +262,14 @@ declare function route<const TPath extends string>(definition: RouteWithoutLoade
  * ```
  */
 declare function routeState<TState>(): {
+  <TId extends string, TPath extends string, TActionResult, TData>(definition: RouteWithActionAndLoader<TPath, TActionResult, TData, TState, TId> & {
+    id: TId;
+  }): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, TData>;
+  <TId extends string, TPath extends string>(definition: RouteWithActionOnly<TPath, TState, TId> & {
+    id: TId;
+  }): TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, TState, undefined>;
+  <TPath extends string, TActionResult, TData>(definition: RouteWithActionAndLoader<TPath, TActionResult, TData, TState>): OpaqueRouteDefinition;
+  <TPath extends string>(definition: RouteWithActionOnly<TPath, TState>): OpaqueRouteDefinition;
   <TId extends string, TData>(definition: PathlessRouteWithLoader<TData, TState, TId> & {
     id: TId;
   }): TypefulOpaqueRouteDefinition<TId, Record<string, never>, TState, TData>;
@@ -233,5 +288,5 @@ declare function routeState<TState>(): {
   <TPath extends string>(definition: RouteWithoutLoader<TPath, TState>): OpaqueRouteDefinition;
 };
 //#endregion
-export { LoaderArgs as a, RouteComponentProps as c, RouteDefinition as d, TypefulOpaqueRouteDefinition as f, ExtractRouteState as i, RouteComponentPropsOf as l, routeState as m, ExtractRouteId as n, OpaqueRouteDefinition as o, route as p, ExtractRouteParams as r, PathParams as s, ExtractRouteData as t, RouteComponentPropsWithData as u };
-//# sourceMappingURL=route-ClVnhrQD.d.mts.map
+export { ExtractRouteState as a, PathParams as c, RouteComponentPropsWithData as d, RouteDefinition as f, routeState as h, ExtractRouteParams as i, RouteComponentProps as l, route as m, ExtractRouteData as n, LoaderArgs as o, TypefulOpaqueRouteDefinition as p, ExtractRouteId as r, OpaqueRouteDefinition as s, ActionArgs as t, RouteComponentPropsOf as u };
+//# sourceMappingURL=route-DRcgs0Pt.d.mts.map

package/dist/route-DRcgs0Pt.d.mts.map

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

package/dist/route-p_gr5yPI.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"route-p_gr5yPI.mjs","names":[],"sources":["../src/route.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nconst routeDefinitionSymbol = 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 loader functions.\n */\nexport type LoaderArgs<Params extends Record<string, string>> = {\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};\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 */\n  resetState: () => 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/** Extract the Id type from a TypefulOpaqueRouteDefinition */\nexport type ExtractRouteId<T> =\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 */\nexport type ExtractRouteParams<T> =\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 */\nexport type ExtractRouteState<T> =\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 */\nexport type ExtractRouteData<T> =\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 */\nexport type RouteComponentPropsOf<\n  T extends TypefulOpaqueRouteDefinition<\n    string,\n    Record<string, string>,\n    unknown,\n    unknown\n  >,\n> =\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 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 * 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// 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<TId extends string, const TPath extends string, TData>(\n  definition:\n    | (PathlessRouteWithLoader<TData, undefined, TId> & { id: TId })\n    | (PathlessRouteWithoutLoader<undefined, TId> & { id: TId })\n    | PathlessRouteWithLoader<TData, undefined>\n    | PathlessRouteWithoutLoader<undefined>\n    | (RouteWithLoader<TPath, TData, undefined, TId> & { id: TId })\n    | (RouteWithoutLoader<TPath, undefined, TId> & { id: TId })\n    | RouteWithLoader<TPath, TData, undefined>\n    | RouteWithoutLoader<TPath, undefined>,\n):\n  | TypefulOpaqueRouteDefinition<TId, PathParams<TPath>, undefined, TData>\n  | TypefulOpaqueRouteDefinition<TId, Record<string, never>, undefined, TData>\n  | OpaqueRouteDefinition {\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  // 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"],"mappings":";AAsVA,SAAgB,MACd,YAYwB;AACxB,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aAoCd;AACA,UAAS,eAAuB;AAC9B,SAAO"}
+{"version":3,"file":"route-p_gr5yPI.mjs","names":[],"sources":["../src/route.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\nconst routeDefinitionSymbol = 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/** Extract the Id type from a TypefulOpaqueRouteDefinition */\nexport type ExtractRouteId<T> =\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 */\nexport type ExtractRouteParams<T> =\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 */\nexport type ExtractRouteState<T> =\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 */\nexport type ExtractRouteData<T> =\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 */\nexport type RouteComponentPropsOf<\n  T extends TypefulOpaqueRouteDefinition<\n    string,\n    Record<string, string>,\n    unknown,\n    unknown\n  >,\n> =\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 * 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// 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(definition: object): OpaqueRouteDefinition {\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  // 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"],"mappings":";AAobA,SAAgB,MAAM,YAA2C;AAC/D,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aA0Dd;AACA,UAAS,eAAuB;AAC9B,SAAO"}

package/dist/server.d.mts

@@ -1,2 +1,2 @@
-import { a as LoaderArgs, c as RouteComponentProps, d as RouteDefinition, m as routeState, p as route, s as PathParams, u as RouteComponentPropsWithData } from "./route-ClVnhrQD.mjs";
+import { c as PathParams, d as RouteComponentPropsWithData, f as RouteDefinition, h as routeState, l as RouteComponentProps, m as route, o as LoaderArgs } from "./route-DRcgs0Pt.mjs";
 export { type LoaderArgs, type PathParams, type RouteComponentProps, type RouteComponentPropsWithData, type RouteDefinition, route, routeState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funstack/router",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "A modern React router based on the Navigation API",
   "repository": {
     "type": "git",

package/dist/route-ClVnhrQD.d.mts.map

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