@funstack/router 0.0.3-alpha.0 → 0.0.3-alpha.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as RouteDefinition, i as RouteComponentPropsWithData, n as PathParams, o as route, r as RouteComponentProps, s as routeState, t as LoaderArgs } from "./route-BifTpiQO.mjs";
+import { a as RouteDefinition, i as RouteComponentPropsWithData, n as PathParams, o as route, r as RouteComponentProps, s as routeState, t as LoaderArgs } from "./route-BXVQqSlR.mjs";
 import { ComponentType, ReactNode } from "react";
 
 //#region src/types.d.ts
@@ -29,7 +29,7 @@ type InternalRouteDefinition = {
     setStateSync?: (state: unknown | ((prev: unknown) => unknown)) => void;
     resetState?: () => void;
     info?: unknown;
-  }>;
+  }> | ReactNode;
 };
 /**
  * A matched route with its parameters.

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useSearchParams.ts","../src/hooks/useBlocker.ts","../src/core/RouterAdapter.ts"],"sourcesContent":[],"mappings":";;;;cAGM;;AAFwD;AAgB9D;;;;;;AAwCA;AAYY,KApDA,uBAAA,GAoDoB;EAQpB,CA3DT,6BAAA,CA2DwB,EAAA,KAAA;EAYf;EAaA,IAAA,EAAA,MAAA;EAWA;aA3FC;;kBAMK;ECAN;EACF,SAAA,CAAA,EDCI,aCDJ,CAAA;IAQK,IAAA,CAAA,EAAA,OAAA;IAOF,MAAA,CAAA,EDZA,MCYA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAY,KAAA,CAAA,EAAA,OAAA;IAGT,QAAM,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,GAAA,CAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,EAAA,GDb4C,OCa5C,CAAA,IAAA,CAAA;IACZ,YAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,GAAA,CAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,EAAA,GAAA,IAAA;IACR,UAAA,CAAA,EAAA,GAAA,GAAA,IAAA;IACA,IAAA,CAAA,EAAA,OAAA;EACC,CAAA,CAAA;CAAc;AE5CjB;;;KHkDY,YAAA;EIlDI;SJoDP;;UAEC;EK1DL;EAEC,QAAA,EAAA,MAAA;CACA;;;;AACoD,KL8D9C,oBAAA,GAAuB,YK9DuB,GAAA;EAM1C;;;;ACVhB;AAmCA;KNuCY,eAAA;;;EOnEA;;;;;;;;KP+EA,QAAA;;;;;;;;;;;;KAaA,kBAAA,WACH,iCACW;;;;;;;KASR,YAAA;;;KCrFA,WAAA;EDzBN,MAAA,EC0BI,eD1BJ,EAAA;EAcM;;;;;;;EAae,UAAA,CAAA,ECOZ,kBDPY;EA2Bf;AAYZ;AAQA;AAYA;AAaA;AAWA;aCrEa;;iBAGG,MAAA;UACN;;;GAGP,cAAc;;;;;;ADlD6C;AAgBlD,iBEVI,MAAA,CAAA,CFUmB,EEVT,SFUS;;;;;;AAd7B,iBGIU,WAAA,CAAA,CHJ8B,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EGIQ,eHJR,EAAA,GAAA,IAAA;;;;;;AAAxC,iBIIU,WAAA,CAAA,CJJ8B,EIIf,QJJe;;;KKAzC,eAAA,YAEC,kBACA,iCACQ,oBAAoB,kBAAkB;;;;ALJ9C,iBKUU,eAAA,CAAA,CLV8B,EAAA,CKUV,eLVU,EKUO,eLVP,CAAA;;;KMAlC,iBAAA;;;;ANFkD;EAgBlD,WAAA,EAAA,GAAA,GAAA,OAAuB;CAChC;;;;;;;AAuCH;AAYA;AAQA;AAYA;AAaA;AAWA;;;;ACrFA;;;;;AAmBA;;;;;;;iBKTgB,UAAA,UAAoB;;;;;;ANrC0B;AAgBlD,KOPA,aAAA,GPOA;EACT;EAIU,GAAA,EOVN,GPUM;EAMK;EAIL,GAAA,EAAA,MAAA;EAEqD;EAJpD,KAAA,EAAA,OAAA;EAAa;EA2Bf,IAAA,EAAA,OAAA;AAYZ,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useSearchParams.ts","../src/hooks/useBlocker.ts","../src/core/RouterAdapter.ts"],"sourcesContent":[],"mappings":";;;;cAGM;;AAFwD;AAgB9D;;;;;;;AA4CY,KA5CA,uBAAA,GA8CH;EAUG,CAvDT,6BAAA,CAuD6B,EAAA,KAAG;EAQvB;EAYA,IAAA,EAAA,MAAQ;EAaR;EAWA,QAAA,CAAA,EA/FC,uBA+FW,EAAA;;kBAzFN;;ECAN,SAAA,CAAA,EDGN,aCHiB,CAAA;IACb,IAAA,CAAA,EAAA,OAAA;IAQK,MAAA,CAAA,EDJE,MCIF,CAAA,MAAA,EAAA,MAAA,CAAA;IAOF,KAAA,CAAA,EAAA,OAAA;IAAY,QAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,GAAA,CAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,EAAA,GDPZ,OCOY,CAAA,IAAA,CAAA;IAGT,YAAM,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,GAAA,CAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,EAAA,GAAA,IAAA;IACZ,UAAA,CAAA,EAAA,GAAA,GAAA,IAAA;IACR,IAAA,CAAA,EAAA,OAAA;EACA,CAAA,CAAA,GDRI,SCQJ;CACC;;AE5CH;;KHsDY,YAAA;;EItDI,KAAA,EJwDP,uBIxDsB;;UJ0DrB;;EK9DL,QAAA,EAAA,MAAA;CAEC;;;;AAE8C,KLkExC,oBAAA,GAAuB,YKlEiB,GAAA;EAAM;EAM1C,IAAA,EAAA,OAAA,GAAA,SAAe;;;;ACV/B;AAmCgB,KN2CJ,eAAA,GM3CwB;;;;EC5BxB,KAAA,CAAA,EAAA,OAAA;;;;;;;KPmFA,QAAA;;;;;;;;;;;;KAaA,kBAAA,WACH,iCACW;;;;;;;KASR,YAAA;;;KCzFA,WAAA;EDzBN,MAAA,EC0BI,eD1BJ,EAAA;EAcM;;;;;;;EAyBN,UAAA,CAAA,ECLS,kBDKT;EAAS;AAmBf;AAYA;AAQA;AAYA;AAaA;EAWY,QAAA,CAAA,ECzEC,YDyEW;;iBCtER,MAAA;UACN;;;GAGP,cAAc;;;;;;ADlD6C;AAgBlD,iBEVI,MAAA,CAAA,CFUmB,EEVT,SFUS;;;;;;AAd7B,iBGIU,WAAA,CAAA,CHJ8B,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EGIQ,eHJR,EAAA,GAAA,IAAA;;;;;;AAAxC,iBIIU,WAAA,CAAA,CJJ8B,EIIf,QJJe;;;KKAzC,eAAA,YAEC,kBACA,iCACQ,oBAAoB,kBAAkB;;;;ALJ9C,iBKUU,eAAA,CAAA,CLV8B,EAAA,CKUV,eLVU,EKUO,eLVP,CAAA;;;KMAlC,iBAAA;;;;ANFkD;EAgBlD,WAAA,EAAA,GAAA,GAAA,OAAuB;CAChC;;;;;;;;AA2CH;AAYA;AAQA;AAYA;AAaA;AAWA;;;;ACzFA;;;;;AAmBA;;;;;;AAI0B,iBKbV,UAAA,CLaU,OAAA,EKbU,iBLaV,CAAA,EAAA,IAAA;;;;;;ADlDoC;AAgBlD,KOPA,aAAA,GPOA;EACT;EAIU,GAAA,EOVN,GPUM;EAMK;EAKD,GAAA,EAAA,MAAA;EAIJ;EANP,KAAA,EAAA,OAAA;EAWA;EAAS,IAAA,EAAA,OAAA;AAmBf,CAAA"}

package/dist/index.mjs

@@ -453,7 +453,6 @@ function RouteRenderer({ matchedRoutes, index }) {
 	const match = matchedRoutes[index];
 	if (!match) return null;
 	const { route: route$1, params, pathname, data } = match;
-	const Component = route$1.component;
 	const routerContext = useContext(RouterContext);
 	if (!routerContext) throw new Error("RouteRenderer must be used within RouterContext");
 	const { locationEntry, url, navigateAsync, updateCurrentEntryState } = routerContext;
@@ -509,7 +508,10 @@ function RouteRenderer({ matchedRoutes, index }) {
 		outlet
 	]);
 	const renderComponent = () => {
-		if (!Component) return outlet;
+		const componentOrElement = route$1.component;
+		if (componentOrElement == null) return outlet;
+		if (typeof componentOrElement !== "function") return componentOrElement;
+		const Component = componentOrElement;
 		const stateProps = {
 			state: routeState$1,
 			setState,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["route","result: MatchedRoute","urlPatternPath: string","params: Record<string, string>","consumedPathname: string","route","idleController: AbortController | null","#cachedEntryId","#cachedSnapshot","#currentNavigationInfo","#subscribeToDisposeEvents","#subscribedEntryIds","#cachedSnapshot","#idleController","#idleController","route","routeState","newParams: URLSearchParams"],"sources":["../src/context/RouterContext.ts","../src/context/RouteContext.ts","../src/context/BlockerContext.ts","../src/types.ts","../src/core/matchRoutes.ts","../src/core/loaderCache.ts","../src/core/NavigationAPIAdapter.ts","../src/core/StaticAdapter.ts","../src/core/NullAdapter.ts","../src/core/createAdapter.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useSearchParams.ts","../src/hooks/useBlocker.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { NavigateOptions } from \"../types.js\";\nimport type { LocationEntry } from \"../core/RouterAdapter.js\";\n\nexport type RouterContextValue = {\n  /** Current location entry */\n  locationEntry: LocationEntry;\n  /** Current URL */\n  url: URL;\n  /** Navigate to a new URL */\n  navigate: (to: string, options?: NavigateOptions) => void;\n  /** Navigate to a new URL and wait for completion */\n  navigateAsync: (to: string, options?: NavigateOptions) => Promise<void>;\n  /** Update current entry's state without navigation */\n  updateCurrentEntryState: (state: unknown) => void;\n};\n\nexport const RouterContext = createContext<RouterContextValue | null>(null);\n","import { createContext, type ReactNode } from \"react\";\n\nexport type RouteContextValue = {\n  /** Matched route parameters */\n  params: Record<string, string>;\n  /** The matched path pattern */\n  matchedPath: string;\n  /** Child route element to render via Outlet */\n  outlet: ReactNode;\n};\n\nexport const RouteContext = createContext<RouteContextValue | null>(null);\n","import { createContext } from \"react\";\n\nexport type BlockerId = string;\n\nexport type BlockerRegistry = {\n  /** Register a blocker, returns unregister function */\n  register: (id: BlockerId, shouldBlock: () => boolean) => () => void;\n  /** Check all blockers - returns true if any blocks */\n  checkAll: () => boolean;\n};\n\nexport type BlockerContextValue = {\n  registry: BlockerRegistry;\n};\n\n/**\n * Create a new blocker registry.\n * The registry manages registered blockers and provides a way to check if any blocker is active.\n */\nexport function createBlockerRegistry(): BlockerRegistry {\n  const blockers = new Map<BlockerId, () => boolean>();\n\n  return {\n    register(id: BlockerId, shouldBlock: () => boolean): () => void {\n      blockers.set(id, shouldBlock);\n      return () => {\n        blockers.delete(id);\n      };\n    },\n\n    checkAll(): boolean {\n      for (const shouldBlock of blockers.values()) {\n        if (shouldBlock()) {\n          return true;\n        }\n      }\n      return false;\n    },\n  };\n}\n\nexport const BlockerContext = createContext<BlockerContextValue | null>(null);\n","import type { ComponentType } from \"react\";\nimport type { LoaderArgs, RouteDefinition } from \"./route.js\";\n\nconst InternalRouteDefinitionSymbol = Symbol();\n\n/**\n * Internal structure for storing per-route state in NavigationHistoryEntry.\n * Each route in the matched stack gets its own state slot indexed by match position.\n */\nexport type InternalRouteState = {\n  __routeStates: (unknown | undefined)[];\n};\n\n/**\n * Route definition for the router.\n * When a loader is defined, the component receives the loader result as a `data` prop.\n */\nexport type InternalRouteDefinition = {\n  [InternalRouteDefinitionSymbol]: never;\n  /** Path pattern to match (e.g., \"users/:id\") */\n  path: string;\n  /** Child routes for nested routing */\n  children?: InternalRouteDefinition[];\n\n  // Note: `loader` and `component` may both exist or both not exist.\n  // Also, `unknown`s may actually be more specific types. They are guaranteed\n  // to be the same type by the `route` helper function.\n  /** Data loader function for this route */\n  loader?: (args: LoaderArgs) => unknown;\n  /** Component to render when this route matches */\n  component?: ComponentType<{\n    data?: unknown;\n    params?: Record<string, string>;\n    state?: unknown;\n    setState?: (state: unknown | ((prev: unknown) => unknown)) => Promise<void>;\n    setStateSync?: (state: unknown | ((prev: unknown) => unknown)) => void;\n    resetState?: () => void;\n    info?: unknown;\n  }>;\n};\n\n/**\n * Converts user-defined routes to internal route definitions.\n * This function is used internally by the Router.\n *\n * Actually, this function just performs a type assertion since\n * both RouteDefinition and InternalRouteDefinition have the same runtime shape.\n */\nexport function internalRoutes(\n  routes: RouteDefinition[],\n): InternalRouteDefinition[] {\n  return routes as InternalRouteDefinition[];\n}\n\n/**\n * A matched route with its parameters.\n */\nexport type MatchedRoute = {\n  /** The original route definition */\n  route: InternalRouteDefinition;\n  /** Extracted path parameters */\n  params: Record<string, string>;\n  /** The matched pathname segment */\n  pathname: string;\n};\n\n/**\n * A matched route with loader data.\n */\nexport type MatchedRouteWithData = MatchedRoute & {\n  /** Data returned from the loader (undefined if no loader) */\n  data: unknown | undefined;\n};\n\n/**\n * Options for navigation.\n */\nexport type NavigateOptions = {\n  /** Replace current history entry instead of pushing */\n  replace?: boolean;\n  /** State to associate with the navigation */\n  state?: unknown;\n  /** Ephemeral info for this navigation only (not persisted in history) */\n  info?: unknown;\n};\n\n/**\n * Location object representing current URL state.\n */\nexport type Location = {\n  pathname: string;\n  search: string;\n  hash: string;\n};\n\n/**\n * Callback invoked before navigation is intercepted.\n * Call `event.preventDefault()` to prevent the router from handling this navigation.\n *\n * @param event - The NavigateEvent from the Navigation API\n * @param matched - Array of matched routes, or null if no routes matched\n */\nexport type OnNavigateCallback = (\n  event: NavigateEvent,\n  matched: readonly MatchedRoute[] | null,\n) => void;\n\n/**\n * Fallback mode when Navigation API is unavailable.\n *\n * - `\"none\"` (default): Render nothing when Navigation API is unavailable\n * - `\"static\"`: Render matched routes without navigation capabilities (MPA behavior)\n */\nexport type FallbackMode =\n  | \"none\" // Default: render nothing when Navigation API unavailable\n  | \"static\"; // Render matched routes without navigation capabilities\n","import type { InternalRouteDefinition, MatchedRoute } from \"../types.js\";\n\n/**\n * Match a pathname against a route tree, returning the matched route stack.\n * Returns null if no match is found.\n */\nexport function matchRoutes(\n  routes: InternalRouteDefinition[],\n  pathname: string,\n): MatchedRoute[] | null {\n  for (const route of routes) {\n    const matched = matchRoute(route, pathname);\n    if (matched) {\n      return matched;\n    }\n  }\n  return null;\n}\n\n/**\n * Match a single route and its children recursively.\n */\nfunction matchRoute(\n  route: InternalRouteDefinition,\n  pathname: string,\n): MatchedRoute[] | null {\n  const hasChildren = Boolean(route.children?.length);\n\n  // For parent routes (with children), we need to match as a prefix\n  // For leaf routes (no children), we need an exact match\n  const { matched, params, consumedPathname } = matchPath(\n    route.path,\n    pathname,\n    !hasChildren,\n  );\n\n  if (!matched) {\n    return null;\n  }\n\n  const result: MatchedRoute = {\n    route,\n    params,\n    pathname: consumedPathname,\n  };\n\n  // If this route has children, try to match them\n  if (hasChildren) {\n    // Calculate remaining pathname, ensuring it starts with /\n    let remainingPathname = pathname.slice(consumedPathname.length);\n    if (!remainingPathname.startsWith(\"/\")) {\n      remainingPathname = \"/\" + remainingPathname;\n    }\n    if (remainingPathname === \"\") {\n      remainingPathname = \"/\";\n    }\n\n    for (const child of route.children!) {\n      const childMatch = matchRoute(child, remainingPathname);\n      if (childMatch) {\n        // Merge params from parent into children\n        return [\n          result,\n          ...childMatch.map((m) => ({\n            ...m,\n            params: { ...params, ...m.params },\n          })),\n        ];\n      }\n    }\n\n    // If no children matched but this route has a component, it's still a valid match\n    if (route.component) {\n      return [result];\n    }\n\n    return null;\n  }\n\n  return [result];\n}\n\n/**\n * Match a path pattern against a pathname.\n */\nfunction matchPath(\n  pattern: string,\n  pathname: string,\n  exact: boolean,\n): {\n  matched: boolean;\n  params: Record<string, string>;\n  consumedPathname: string;\n} {\n  // Normalize pattern\n  const normalizedPattern = pattern.startsWith(\"/\") ? pattern : `/${pattern}`;\n\n  // Build URLPattern\n  let urlPatternPath: string;\n  if (exact) {\n    urlPatternPath = normalizedPattern;\n  } else if (normalizedPattern === \"/\") {\n    // Special case: root path as prefix matches anything\n    urlPatternPath = \"/*\";\n  } else {\n    // For other prefix matches, add optional wildcard suffix\n    urlPatternPath = `${normalizedPattern}{/*}?`;\n  }\n\n  const urlPattern = new URLPattern({ pathname: urlPatternPath });\n\n  const match = urlPattern.exec({ pathname });\n  if (!match) {\n    return { matched: false, params: {}, consumedPathname: \"\" };\n  }\n\n  // Extract params (excluding the wildcard group \"0\")\n  const params: Record<string, string> = {};\n  for (const [key, value] of Object.entries(match.pathname.groups)) {\n    if (value !== undefined && key !== \"0\") {\n      params[key] = value;\n    }\n  }\n\n  // Calculate consumed pathname\n  let consumedPathname: string;\n  if (exact) {\n    consumedPathname = pathname;\n  } else if (normalizedPattern === \"/\") {\n    // Root pattern consumes just \"/\"\n    consumedPathname = \"/\";\n  } else {\n    // For prefix matches, calculate based on pattern segments\n    const patternSegments = normalizedPattern.split(\"/\").filter(Boolean);\n    const pathnameSegments = pathname.split(\"/\").filter(Boolean);\n    consumedPathname =\n      \"/\" + pathnameSegments.slice(0, patternSegments.length).join(\"/\");\n  }\n\n  return { matched: true, params, consumedPathname };\n}\n","import type { LoaderArgs } from \"../route.js\";\nimport type {\n  MatchedRoute,\n  MatchedRouteWithData,\n  InternalRouteDefinition,\n} from \"../types.js\";\n\n/**\n * Cache for loader results.\n * Key format: `${entryId}:${matchIndex}`\n */\nconst loaderCache = new Map<string, unknown>();\n\n/**\n * Get or create a loader result from cache.\n * If the result is not cached, executes the loader and caches the result.\n */\nfunction getOrCreateLoaderResult(\n  entryId: string,\n  matchIndex: number,\n  route: InternalRouteDefinition,\n  args: LoaderArgs,\n): unknown | undefined {\n  if (!route.loader) {\n    return undefined;\n  }\n\n  const cacheKey = `${entryId}:${matchIndex}`;\n\n  if (!loaderCache.has(cacheKey)) {\n    loaderCache.set(cacheKey, route.loader(args));\n  }\n\n  return loaderCache.get(cacheKey);\n}\n\n/**\n * Create a Request object for loader args.\n */\nexport function createLoaderRequest(url: URL): Request {\n  return new Request(url.href, {\n    method: \"GET\",\n  });\n}\n\n/**\n * Execute loaders for matched routes and return routes with data.\n * Results are cached by navigation entry id to prevent duplicate execution.\n */\nexport function executeLoaders(\n  matchedRoutes: MatchedRoute[],\n  entryId: string,\n  request: Request,\n  signal: AbortSignal,\n): MatchedRouteWithData[] {\n  return matchedRoutes.map((match, index) => {\n    const { route, params } = match;\n    const args: LoaderArgs = { params, request, signal };\n    const data = getOrCreateLoaderResult(entryId, index, route, args);\n\n    return { ...match, data };\n  });\n}\n\n/**\n * Clear the loader cache.\n * Mainly used for testing.\n */\nexport function clearLoaderCache(): void {\n  loaderCache.clear();\n}\n\n/**\n * Clear loader cache entries for a specific navigation entry.\n * Called when a NavigationHistoryEntry is disposed (removed from history stack).\n */\nexport function clearLoaderCacheForEntry(entryId: string): void {\n  const prefix = `${entryId}:`;\n  for (const key of loaderCache.keys()) {\n    if (key.startsWith(prefix)) {\n      loaderCache.delete(key);\n    }\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\nimport { matchRoutes } from \"./matchRoutes.js\";\nimport {\n  executeLoaders,\n  createLoaderRequest,\n  clearLoaderCacheForEntry,\n} from \"./loaderCache.js\";\n\n/**\n * Fallback AbortController for data loading initialized outside of a navigation event.\n * Aborted when the next navigation occurs.\n *\n * To save resources, this controller is created only when needed.\n */\nlet idleController: AbortController | null = null;\n\n/**\n * Reset navigation state. Used for testing.\n */\nexport function resetNavigationState(): void {\n  idleController?.abort();\n  idleController = null;\n}\n\n/**\n * Adapter that uses the Navigation API for full SPA functionality.\n */\nexport class NavigationAPIAdapter implements RouterAdapter {\n  // Cache the snapshot to ensure referential stability for useSyncExternalStore\n  #cachedSnapshot: LocationEntry | null = null;\n  #cachedEntryId: string | null = null;\n  // Ephemeral info from the current navigation event (not persisted in history)\n  #currentNavigationInfo: unknown = undefined;\n\n  getSnapshot(): LocationEntry | null {\n    const entry = navigation.currentEntry;\n    if (!entry?.url) {\n      return null;\n    }\n\n    // Return cached snapshot if entry hasn't changed\n    if (this.#cachedEntryId === entry.id && this.#cachedSnapshot) {\n      return this.#cachedSnapshot;\n    }\n\n    // Create new snapshot and cache it\n    this.#cachedEntryId = entry.id;\n    this.#cachedSnapshot = {\n      url: new URL(entry.url),\n      key: entry.id,\n      state: entry.getState(),\n      info: this.#currentNavigationInfo,\n    };\n    return this.#cachedSnapshot;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(callback: () => void): () => void {\n    const controller = new AbortController();\n    navigation.addEventListener(\"currententrychange\", callback, {\n      signal: controller.signal,\n    });\n\n    // Subscribe to dispose events on all existing entries\n    this.#subscribeToDisposeEvents(controller.signal);\n\n    // When current entry changes, subscribe to any new entries' dispose events\n    navigation.addEventListener(\n      \"currententrychange\",\n      () => this.#subscribeToDisposeEvents(controller.signal),\n      { signal: controller.signal },\n    );\n\n    return () => {\n      controller.abort();\n    };\n  }\n\n  /**\n   * Track which entries we've subscribed to dispose events for.\n   */\n  #subscribedEntryIds = new Set<string>();\n\n  /**\n   * Subscribe to dispose events on all navigation entries.\n   * When an entry is disposed, its cached loader results are cleared.\n   */\n  #subscribeToDisposeEvents(signal: AbortSignal): void {\n    for (const entry of navigation.entries()) {\n      if (this.#subscribedEntryIds.has(entry.id)) {\n        continue;\n      }\n      this.#subscribedEntryIds.add(entry.id);\n\n      const entryId = entry.id;\n      entry.addEventListener(\n        \"dispose\",\n        () => {\n          clearLoaderCacheForEntry(entryId);\n          this.#subscribedEntryIds.delete(entryId);\n        },\n        { signal },\n      );\n    }\n  }\n\n  navigate(to: string, options?: NavigateOptions): void {\n    navigation.navigate(to, {\n      history: options?.replace ? \"replace\" : \"push\",\n      state: options?.state,\n      info: options?.info,\n    });\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    const result = navigation.navigate(to, {\n      history: options?.replace ? \"replace\" : \"push\",\n      state: options?.state,\n      info: options?.info,\n    });\n    await result.finished;\n  }\n\n  setupInterception(\n    routes: InternalRouteDefinition[],\n    onNavigate?: OnNavigateCallback,\n    checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    const handleNavigate = (event: NavigateEvent) => {\n      // Capture ephemeral info from the navigate event\n      // This info is only available during this navigation and resets on the next one\n      this.#currentNavigationInfo = event.info;\n      // Invalidate cached snapshot to pick up new info\n      this.#cachedSnapshot = null;\n\n      // Check blockers first - if any blocker returns true, prevent navigation\n      if (checkBlockers?.()) {\n        event.preventDefault();\n        return;\n      }\n\n      // Only intercept same-origin navigations\n      if (!event.canIntercept) {\n        onNavigate?.(event, []);\n        return;\n      }\n\n      // Check if the URL matches any of our routes\n      const url = new URL(event.destination.url);\n      const matched = matchRoutes(routes, url.pathname);\n\n      // Call onNavigate callback if provided (regardless of route match)\n      if (onNavigate) {\n        onNavigate(event, matched);\n        if (event.defaultPrevented) {\n          return; // Do not intercept, allow browser default\n        }\n      }\n\n      // hash change navigations are not intercepted.\n      // Also do not intercept if it is a download request.\n      if (event.hashChange || event.downloadRequest !== null) {\n        return;\n      }\n\n      if (!matched) {\n        return;\n      }\n\n      // Route match, so intercept\n\n      // Abort initial load's loaders if this is the first navigation\n      if (idleController) {\n        idleController.abort();\n        idleController = null;\n      }\n\n      event.intercept({\n        handler: async () => {\n          const request = createLoaderRequest(url);\n\n          // Note: in response to `currententrychange` event, <Router> should already\n          // have dispatched data loaders and the results should be cached.\n          // Here we run executeLoader to retrieve cached results.\n          const currentEntry = navigation.currentEntry;\n          if (!currentEntry) {\n            throw new Error(\n              \"Navigation currentEntry is null during navigation interception\",\n            );\n          }\n\n          const results = executeLoaders(\n            matched,\n            currentEntry.id,\n            request,\n            event.signal,\n          );\n\n          // Delay navigation until async loaders complete\n          await Promise.all(results.map((r) => r.data));\n        },\n      });\n    };\n\n    const controller = new AbortController();\n    navigation.addEventListener(\"navigate\", handleNavigate, {\n      signal: controller.signal,\n    });\n    return () => {\n      controller.abort();\n    };\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    idleController ??= new AbortController();\n    return idleController.signal;\n  }\n\n  updateCurrentEntryState(state: unknown): void {\n    // Invalidate cached snapshot BEFORE updating, so the subscriber gets fresh state\n    this.#cachedSnapshot = null;\n    navigation.updateCurrentEntry({ state });\n    // Note: updateCurrentEntry fires currententrychange, so subscribers are notified automatically\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\n\n/**\n * Static adapter for fallback mode when Navigation API is unavailable.\n * Provides read-only location access with no SPA navigation capabilities.\n * Links will cause full page loads (MPA behavior).\n */\nexport class StaticAdapter implements RouterAdapter {\n  #cachedSnapshot: LocationEntry | null = null;\n  #idleController: AbortController | null = null;\n\n  getSnapshot(): LocationEntry | null {\n    if (typeof window === \"undefined\") {\n      return null;\n    }\n\n    // Cache the snapshot - it never changes in static mode\n    if (!this.#cachedSnapshot) {\n      this.#cachedSnapshot = {\n        url: new URL(window.location.href),\n        key: \"__static__\",\n        state: undefined,\n        info: undefined,\n      };\n    }\n    return this.#cachedSnapshot;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(_callback: () => void): () => void {\n    // Static mode never fires location change events\n    return () => {};\n  }\n\n  navigate(to: string, _options?: NavigateOptions): void {\n    console.warn(\n      \"FUNSTACK Router: navigate() called in static fallback mode. \" +\n        \"Navigation API is not available in this browser. \" +\n        \"Links will cause full page loads.\",\n    );\n    // Note: We intentionally do NOT do window.location.href = to\n    // as that would mask bugs where developers expect SPA behavior.\n    // If needed in the future, we could add a \"static-reload\" mode.\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    this.navigate(to, options);\n  }\n\n  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\n    _checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    // No interception in static mode - links cause full page loads\n    return undefined;\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    this.#idleController ??= new AbortController();\n    return this.#idleController.signal;\n  }\n\n  updateCurrentEntryState(_state: unknown): void {\n    // No-op in static mode - state updates require Navigation API\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\n\n/**\n * Null adapter for when Navigation API is unavailable and no fallback is configured.\n * All methods are no-ops that return safe default values.\n */\nexport class NullAdapter implements RouterAdapter {\n  #idleController: AbortController | null = null;\n\n  getSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(_callback: () => void): () => void {\n    return () => {};\n  }\n\n  navigate(_to: string, _options?: NavigateOptions): void {\n    console.warn(\n      \"FUNSTACK Router: navigate() called but no adapter is available. \" +\n        \"Navigation API is not available in this browser and no fallback mode is configured.\",\n    );\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    this.navigate(to, options);\n  }\n\n  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\n    _checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    return undefined;\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    this.#idleController ??= new AbortController();\n    return this.#idleController.signal;\n  }\n\n  updateCurrentEntryState(_state: unknown): void {\n    // No-op: NullAdapter doesn't support state updates\n  }\n}\n","import type { RouterAdapter } from \"./RouterAdapter.js\";\nimport { NavigationAPIAdapter } from \"./NavigationAPIAdapter.js\";\nimport { StaticAdapter } from \"./StaticAdapter.js\";\nimport { NullAdapter } from \"./NullAdapter.js\";\nimport type { FallbackMode } from \"../types.js\";\n\n/**\n * Check if Navigation API is available.\n */\nfunction hasNavigation(): boolean {\n  return typeof window !== \"undefined\" && \"navigation\" in window;\n}\n\n/**\n * Create the appropriate router adapter based on browser capabilities\n * and the specified fallback mode.\n *\n * @param fallback - The fallback mode to use when Navigation API is unavailable\n * @returns A RouterAdapter instance\n */\nexport function createAdapter(fallback: FallbackMode): RouterAdapter {\n  // Try Navigation API first\n  if (hasNavigation()) {\n    return new NavigationAPIAdapter();\n  }\n\n  // Fall back to static mode if enabled\n  if (fallback === \"static\") {\n    return new StaticAdapter();\n  }\n\n  // No adapter available (fallback=\"none\" or default)\n  return new NullAdapter();\n}\n","import {\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport { RouterContext } from \"./context/RouterContext.js\";\nimport { RouteContext } from \"./context/RouteContext.js\";\nimport {\n  BlockerContext,\n  createBlockerRegistry,\n} from \"./context/BlockerContext.js\";\nimport {\n  type NavigateOptions,\n  type MatchedRouteWithData,\n  type OnNavigateCallback,\n  type FallbackMode,\n  type InternalRouteState,\n  internalRoutes,\n} from \"./types.js\";\nimport { matchRoutes } from \"./core/matchRoutes.js\";\nimport { createAdapter } from \"./core/createAdapter.js\";\nimport { executeLoaders, createLoaderRequest } from \"./core/loaderCache.js\";\nimport type { RouteDefinition } from \"./route.js\";\n\nexport type RouterProps = {\n  routes: RouteDefinition[];\n  /**\n   * Callback invoked before navigation is intercepted.\n   * Call `event.preventDefault()` to prevent the router from handling this navigation.\n   *\n   * @param event - The NavigateEvent from the Navigation API\n   * @param matched - Array of matched routes, or null if no routes matched\n   */\n  onNavigate?: OnNavigateCallback;\n  /**\n   * Fallback mode when Navigation API is unavailable.\n   *\n   * - `\"none\"` (default): Render nothing when Navigation API is unavailable\n   * - `\"static\"`: Render matched routes without navigation capabilities (MPA behavior)\n   */\n  fallback?: FallbackMode;\n};\n\nexport function Router({\n  routes: inputRoutes,\n  onNavigate,\n  fallback = \"none\",\n}: RouterProps): ReactNode {\n  const routes = internalRoutes(inputRoutes);\n\n  // Create adapter once based on browser capabilities and fallback setting\n  const adapter = useMemo(() => createAdapter(fallback), [fallback]);\n\n  // Create blocker registry once\n  const [blockerRegistry] = useState(() => createBlockerRegistry());\n\n  // Subscribe to location changes via adapter\n  const locationEntry = useSyncExternalStore(\n    useCallback((callback) => adapter.subscribe(callback), [adapter]),\n    () => adapter.getSnapshot(),\n    () => adapter.getServerSnapshot(),\n  );\n\n  // Set up navigation interception via adapter\n  useEffect(() => {\n    return adapter.setupInterception(\n      routes,\n      onNavigate,\n      blockerRegistry.checkAll,\n    );\n  }, [adapter, routes, onNavigate, blockerRegistry]);\n\n  // Navigate function from adapter\n  const navigate = useCallback(\n    (to: string, options?: NavigateOptions) => {\n      adapter.navigate(to, options);\n    },\n    [adapter],\n  );\n\n  // Navigate function that returns a Promise\n  const navigateAsync = useCallback(\n    (to: string, options?: NavigateOptions) => {\n      return adapter.navigateAsync(to, options);\n    },\n    [adapter],\n  );\n\n  // Update current entry's state without navigation\n  const updateCurrentEntryState = useCallback(\n    (state: unknown) => {\n      adapter.updateCurrentEntryState(state);\n    },\n    [adapter],\n  );\n\n  return useMemo(() => {\n    if (locationEntry === null) {\n      // This happens either when Navigation API is unavailable (and no fallback),\n      // or the current document is not fully active.\n      return null;\n    }\n\n    const { url, key } = locationEntry;\n\n    // Match current URL against routes and execute loaders\n    const matchedRoutesWithData = (() => {\n      const matched = matchRoutes(routes, url.pathname);\n      if (!matched) return null;\n\n      // Execute loaders (results are cached by location entry key)\n      const request = createLoaderRequest(url);\n      const signal = adapter.getIdleAbortSignal();\n      return executeLoaders(matched, key, request, signal);\n    })();\n\n    const routerContextValue = {\n      locationEntry,\n      url,\n      navigate,\n      navigateAsync,\n      updateCurrentEntryState,\n    };\n\n    const blockerContextValue = { registry: blockerRegistry };\n\n    return (\n      <BlockerContext.Provider value={blockerContextValue}>\n        <RouterContext.Provider value={routerContextValue}>\n          {matchedRoutesWithData ? (\n            <RouteRenderer matchedRoutes={matchedRoutesWithData} index={0} />\n          ) : null}\n        </RouterContext.Provider>\n      </BlockerContext.Provider>\n    );\n  }, [\n    navigate,\n    navigateAsync,\n    updateCurrentEntryState,\n    locationEntry,\n    routes,\n    adapter,\n    blockerRegistry,\n  ]);\n}\n\ntype RouteRendererProps = {\n  matchedRoutes: MatchedRouteWithData[];\n  index: number;\n};\n\n/**\n * Recursively render matched routes with proper context.\n */\nfunction RouteRenderer({\n  matchedRoutes,\n  index,\n}: RouteRendererProps): ReactNode {\n  const match = matchedRoutes[index];\n  if (!match) return null;\n\n  const { route, params, pathname, data } = match;\n  const Component = route.component;\n\n  const routerContext = useContext(RouterContext);\n  if (!routerContext) {\n    throw new Error(\"RouteRenderer must be used within RouterContext\");\n  }\n  const { locationEntry, url, navigateAsync, updateCurrentEntryState } =\n    routerContext;\n\n  // Extract this route's state from internal structure\n  const internalState = locationEntry.state as InternalRouteState | undefined;\n  const routeState = internalState?.__routeStates?.[index];\n\n  // Create stable setStateSync callback for this route's slice (synchronous via updateCurrentEntry)\n  const setStateSync = useCallback(\n    (stateOrUpdater: unknown | ((prev: unknown) => unknown)) => {\n      const currentStates =\n        (locationEntry.state as InternalRouteState | undefined)\n          ?.__routeStates ?? [];\n      const currentRouteState = currentStates[index];\n\n      const newState =\n        typeof stateOrUpdater === \"function\"\n          ? (stateOrUpdater as (prev: unknown) => unknown)(currentRouteState)\n          : stateOrUpdater;\n\n      const newStates = [...currentStates];\n      newStates[index] = newState;\n      updateCurrentEntryState({ __routeStates: newStates });\n    },\n    [locationEntry.state, index, updateCurrentEntryState],\n  );\n\n  // Create stable setState callback for this route's slice (async via replace navigation)\n  const setState = useCallback(\n    async (\n      stateOrUpdater: unknown | ((prev: unknown) => unknown),\n    ): Promise<void> => {\n      const currentStates =\n        (locationEntry.state as InternalRouteState | undefined)\n          ?.__routeStates ?? [];\n      const currentRouteState = currentStates[index];\n\n      const newState =\n        typeof stateOrUpdater === \"function\"\n          ? (stateOrUpdater as (prev: unknown) => unknown)(currentRouteState)\n          : stateOrUpdater;\n\n      const newStates = [...currentStates];\n      newStates[index] = newState;\n\n      await navigateAsync(url.href, {\n        replace: true,\n        state: { __routeStates: newStates },\n      });\n    },\n    [locationEntry.state, index, url, navigateAsync],\n  );\n\n  // Create stable resetState callback\n  const resetState = useCallback(() => {\n    const currentStates =\n      (locationEntry.state as InternalRouteState | undefined)?.__routeStates ??\n      [];\n    const newStates = [...currentStates];\n    newStates[index] = undefined;\n    updateCurrentEntryState({ __routeStates: newStates });\n  }, [locationEntry.state, index, updateCurrentEntryState]);\n\n  // Create outlet for child routes\n  const outlet =\n    index < matchedRoutes.length - 1 ? (\n      <RouteRenderer matchedRoutes={matchedRoutes} index={index + 1} />\n    ) : null;\n\n  const routeContextValue = useMemo(\n    () => ({ params, matchedPath: pathname, outlet }),\n    [params, pathname, outlet],\n  );\n\n  // Render component with or without data prop based on loader presence\n  // Always pass params, state, setState, resetState, and info props to components\n  const renderComponent = () => {\n    if (!Component) return outlet;\n\n    const stateProps = {\n      state: routeState,\n      setState,\n      setStateSync,\n      resetState,\n    };\n\n    // Ephemeral info from the current navigation\n    const { info } = locationEntry;\n\n    // When loader exists, data is defined and component expects data prop\n    // When loader doesn't exist, data is undefined and component doesn't expect data prop\n    // TypeScript can't narrow this union, so we use runtime check with type assertion\n    if (route.loader) {\n      const ComponentWithData = Component as React.ComponentType<{\n        data: unknown;\n        params: Record<string, string>;\n        state: unknown;\n        setState: (s: unknown | ((prev: unknown) => unknown)) => Promise<void>;\n        setStateSync: (s: unknown | ((prev: unknown) => unknown)) => void;\n        resetState: () => void;\n        info: unknown;\n      }>;\n      return (\n        <ComponentWithData\n          data={data}\n          params={params}\n          {...stateProps}\n          info={info}\n        />\n      );\n    }\n    const ComponentWithoutData = Component as React.ComponentType<{\n      params: Record<string, string>;\n      state: unknown;\n      setState: (s: unknown | ((prev: unknown) => unknown)) => Promise<void>;\n      setStateSync: (s: unknown | ((prev: unknown) => unknown)) => void;\n      resetState: () => void;\n      info: unknown;\n    }>;\n    return <ComponentWithoutData params={params} {...stateProps} info={info} />;\n  };\n\n  return (\n    <RouteContext.Provider value={routeContextValue}>\n      {renderComponent()}\n    </RouteContext.Provider>\n  );\n}\n","import { type ReactNode, useContext } from \"react\";\nimport { RouteContext } from \"./context/RouteContext.js\";\n\n/**\n * Renders the matched child route.\n * Used in layout components to specify where child routes should render.\n */\nexport function Outlet(): ReactNode {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    return null;\n  }\n\n  return routeContext.outlet;\n}\n","import { useContext } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\nimport type { NavigateOptions } from \"../types.js\";\n\n/**\n * Returns a function for programmatic navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useNavigate must be used within a Router\");\n  }\n\n  return context.navigate;\n}\n","import { useContext, useMemo } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\nimport type { Location } from \"../types.js\";\n\n/**\n * Returns the current location object.\n */\nexport function useLocation(): Location {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useLocation must be used within a Router\");\n  }\n\n  const { url } = context;\n\n  return useMemo(() => {\n    return {\n      pathname: url.pathname,\n      search: url.search,\n      hash: url.hash,\n    };\n  }, [url]);\n}\n","import { useCallback, useContext, useMemo } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\n\ntype SetSearchParams = (\n  params:\n    | URLSearchParams\n    | Record<string, string>\n    | ((prev: URLSearchParams) => URLSearchParams | Record<string, string>),\n) => void;\n\n/**\n * Returns and allows manipulation of URL search parameters.\n */\nexport function useSearchParams(): [URLSearchParams, SetSearchParams] {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useSearchParams must be used within a Router\");\n  }\n\n  const searchParams = context.url.searchParams;\n\n  const setSearchParams = useCallback<SetSearchParams>(\n    (params) => {\n      const url = new URL(context.url);\n\n      let newParams: URLSearchParams;\n      if (typeof params === \"function\") {\n        const result = params(new URLSearchParams(url.search));\n        newParams =\n          result instanceof URLSearchParams\n            ? result\n            : new URLSearchParams(result);\n      } else if (params instanceof URLSearchParams) {\n        newParams = params;\n      } else {\n        newParams = new URLSearchParams(params);\n      }\n\n      url.search = newParams.toString();\n      context.navigate(url.pathname + url.search + url.hash, { replace: true });\n    },\n    [context],\n  );\n\n  return [searchParams, setSearchParams];\n}\n","import { useContext, useEffect, useId } from \"react\";\nimport { BlockerContext } from \"../context/BlockerContext.js\";\n\nexport type UseBlockerOptions = {\n  /**\n   * Function that returns true if navigation should be blocked.\n   * Can call `confirm()` inside to show a confirmation dialog.\n   */\n  shouldBlock: () => boolean;\n};\n\n/**\n * Hook to block navigation away from the current route.\n *\n * This is useful for scenarios like unsaved form data, ongoing file uploads,\n * or any state that would be lost on navigation.\n *\n * @example\n * ```tsx\n * function EditForm() {\n *   const [isDirty, setIsDirty] = useState(false);\n *\n *   useBlocker({\n *     shouldBlock: () => {\n *       if (isDirty) {\n *         return !confirm(\"You have unsaved changes. Leave anyway?\");\n *       }\n *       return false;\n *     },\n *   });\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * Note: This hook only handles SPA navigations (links, programmatic navigation).\n * For hard navigations (tab close, refresh), handle `beforeunload` separately.\n */\nexport function useBlocker(options: UseBlockerOptions): void {\n  const context = useContext(BlockerContext);\n\n  if (!context) {\n    throw new Error(\"useBlocker must be used within a Router\");\n  }\n\n  const { shouldBlock } = options;\n  const blockerId = useId();\n  const { registry } = context;\n\n  // Register blocker on mount, unregister on unmount\n  // Re-registers when shouldBlock function changes\n  useEffect(() => {\n    return registry.register(blockerId, shouldBlock);\n  }, [blockerId, shouldBlock, registry]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["route","route","#cachedEntryId","#cachedSnapshot","#currentNavigationInfo","#subscribeToDisposeEvents","#subscribedEntryIds","#cachedSnapshot","#idleController","#idleController","routeState","route"],"sources":["../src/context/RouterContext.ts","../src/context/RouteContext.ts","../src/context/BlockerContext.ts","../src/types.ts","../src/core/matchRoutes.ts","../src/core/loaderCache.ts","../src/core/NavigationAPIAdapter.ts","../src/core/StaticAdapter.ts","../src/core/NullAdapter.ts","../src/core/createAdapter.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useSearchParams.ts","../src/hooks/useBlocker.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { NavigateOptions } from \"../types.js\";\nimport type { LocationEntry } from \"../core/RouterAdapter.js\";\n\nexport type RouterContextValue = {\n  /** Current location entry */\n  locationEntry: LocationEntry;\n  /** Current URL */\n  url: URL;\n  /** Navigate to a new URL */\n  navigate: (to: string, options?: NavigateOptions) => void;\n  /** Navigate to a new URL and wait for completion */\n  navigateAsync: (to: string, options?: NavigateOptions) => Promise<void>;\n  /** Update current entry's state without navigation */\n  updateCurrentEntryState: (state: unknown) => void;\n};\n\nexport const RouterContext = createContext<RouterContextValue | null>(null);\n","import { createContext, type ReactNode } from \"react\";\n\nexport type RouteContextValue = {\n  /** Matched route parameters */\n  params: Record<string, string>;\n  /** The matched path pattern */\n  matchedPath: string;\n  /** Child route element to render via Outlet */\n  outlet: ReactNode;\n};\n\nexport const RouteContext = createContext<RouteContextValue | null>(null);\n","import { createContext } from \"react\";\n\nexport type BlockerId = string;\n\nexport type BlockerRegistry = {\n  /** Register a blocker, returns unregister function */\n  register: (id: BlockerId, shouldBlock: () => boolean) => () => void;\n  /** Check all blockers - returns true if any blocks */\n  checkAll: () => boolean;\n};\n\nexport type BlockerContextValue = {\n  registry: BlockerRegistry;\n};\n\n/**\n * Create a new blocker registry.\n * The registry manages registered blockers and provides a way to check if any blocker is active.\n */\nexport function createBlockerRegistry(): BlockerRegistry {\n  const blockers = new Map<BlockerId, () => boolean>();\n\n  return {\n    register(id: BlockerId, shouldBlock: () => boolean): () => void {\n      blockers.set(id, shouldBlock);\n      return () => {\n        blockers.delete(id);\n      };\n    },\n\n    checkAll(): boolean {\n      for (const shouldBlock of blockers.values()) {\n        if (shouldBlock()) {\n          return true;\n        }\n      }\n      return false;\n    },\n  };\n}\n\nexport const BlockerContext = createContext<BlockerContextValue | null>(null);\n","import type { ComponentType, ReactNode } from \"react\";\nimport type { LoaderArgs, RouteDefinition } from \"./route.js\";\n\nconst InternalRouteDefinitionSymbol = Symbol();\n\n/**\n * Internal structure for storing per-route state in NavigationHistoryEntry.\n * Each route in the matched stack gets its own state slot indexed by match position.\n */\nexport type InternalRouteState = {\n  __routeStates: (unknown | undefined)[];\n};\n\n/**\n * Route definition for the router.\n * When a loader is defined, the component receives the loader result as a `data` prop.\n */\nexport type InternalRouteDefinition = {\n  [InternalRouteDefinitionSymbol]: never;\n  /** Path pattern to match (e.g., \"users/:id\") */\n  path: string;\n  /** Child routes for nested routing */\n  children?: InternalRouteDefinition[];\n\n  // Note: `loader` and `component` may both exist or both not exist.\n  // Also, `unknown`s may actually be more specific types. They are guaranteed\n  // to be the same type by the `route` helper function.\n  /** Data loader function for this route */\n  loader?: (args: LoaderArgs) => unknown;\n  /** Component to render when this route matches */\n  component?:\n    | ComponentType<{\n        data?: unknown;\n        params?: Record<string, string>;\n        state?: unknown;\n        setState?: (\n          state: unknown | ((prev: unknown) => unknown),\n        ) => Promise<void>;\n        setStateSync?: (state: unknown | ((prev: unknown) => unknown)) => void;\n        resetState?: () => void;\n        info?: unknown;\n      }>\n    | ReactNode;\n};\n\n/**\n * Converts user-defined routes to internal route definitions.\n * This function is used internally by the Router.\n *\n * Actually, this function just performs a type assertion since\n * both RouteDefinition and InternalRouteDefinition have the same runtime shape.\n */\nexport function internalRoutes(\n  routes: RouteDefinition[],\n): InternalRouteDefinition[] {\n  return routes as InternalRouteDefinition[];\n}\n\n/**\n * A matched route with its parameters.\n */\nexport type MatchedRoute = {\n  /** The original route definition */\n  route: InternalRouteDefinition;\n  /** Extracted path parameters */\n  params: Record<string, string>;\n  /** The matched pathname segment */\n  pathname: string;\n};\n\n/**\n * A matched route with loader data.\n */\nexport type MatchedRouteWithData = MatchedRoute & {\n  /** Data returned from the loader (undefined if no loader) */\n  data: unknown | undefined;\n};\n\n/**\n * Options for navigation.\n */\nexport type NavigateOptions = {\n  /** Replace current history entry instead of pushing */\n  replace?: boolean;\n  /** State to associate with the navigation */\n  state?: unknown;\n  /** Ephemeral info for this navigation only (not persisted in history) */\n  info?: unknown;\n};\n\n/**\n * Location object representing current URL state.\n */\nexport type Location = {\n  pathname: string;\n  search: string;\n  hash: string;\n};\n\n/**\n * Callback invoked before navigation is intercepted.\n * Call `event.preventDefault()` to prevent the router from handling this navigation.\n *\n * @param event - The NavigateEvent from the Navigation API\n * @param matched - Array of matched routes, or null if no routes matched\n */\nexport type OnNavigateCallback = (\n  event: NavigateEvent,\n  matched: readonly MatchedRoute[] | null,\n) => void;\n\n/**\n * Fallback mode when Navigation API is unavailable.\n *\n * - `\"none\"` (default): Render nothing when Navigation API is unavailable\n * - `\"static\"`: Render matched routes without navigation capabilities (MPA behavior)\n */\nexport type FallbackMode =\n  | \"none\" // Default: render nothing when Navigation API unavailable\n  | \"static\"; // Render matched routes without navigation capabilities\n","import type { InternalRouteDefinition, MatchedRoute } from \"../types.js\";\n\n/**\n * Match a pathname against a route tree, returning the matched route stack.\n * Returns null if no match is found.\n */\nexport function matchRoutes(\n  routes: InternalRouteDefinition[],\n  pathname: string,\n): MatchedRoute[] | null {\n  for (const route of routes) {\n    const matched = matchRoute(route, pathname);\n    if (matched) {\n      return matched;\n    }\n  }\n  return null;\n}\n\n/**\n * Match a single route and its children recursively.\n */\nfunction matchRoute(\n  route: InternalRouteDefinition,\n  pathname: string,\n): MatchedRoute[] | null {\n  const hasChildren = Boolean(route.children?.length);\n\n  // For parent routes (with children), we need to match as a prefix\n  // For leaf routes (no children), we need an exact match\n  const { matched, params, consumedPathname } = matchPath(\n    route.path,\n    pathname,\n    !hasChildren,\n  );\n\n  if (!matched) {\n    return null;\n  }\n\n  const result: MatchedRoute = {\n    route,\n    params,\n    pathname: consumedPathname,\n  };\n\n  // If this route has children, try to match them\n  if (hasChildren) {\n    // Calculate remaining pathname, ensuring it starts with /\n    let remainingPathname = pathname.slice(consumedPathname.length);\n    if (!remainingPathname.startsWith(\"/\")) {\n      remainingPathname = \"/\" + remainingPathname;\n    }\n    if (remainingPathname === \"\") {\n      remainingPathname = \"/\";\n    }\n\n    for (const child of route.children!) {\n      const childMatch = matchRoute(child, remainingPathname);\n      if (childMatch) {\n        // Merge params from parent into children\n        return [\n          result,\n          ...childMatch.map((m) => ({\n            ...m,\n            params: { ...params, ...m.params },\n          })),\n        ];\n      }\n    }\n\n    // If no children matched but this route has a component, it's still a valid match\n    if (route.component) {\n      return [result];\n    }\n\n    return null;\n  }\n\n  return [result];\n}\n\n/**\n * Match a path pattern against a pathname.\n */\nfunction matchPath(\n  pattern: string,\n  pathname: string,\n  exact: boolean,\n): {\n  matched: boolean;\n  params: Record<string, string>;\n  consumedPathname: string;\n} {\n  // Normalize pattern\n  const normalizedPattern = pattern.startsWith(\"/\") ? pattern : `/${pattern}`;\n\n  // Build URLPattern\n  let urlPatternPath: string;\n  if (exact) {\n    urlPatternPath = normalizedPattern;\n  } else if (normalizedPattern === \"/\") {\n    // Special case: root path as prefix matches anything\n    urlPatternPath = \"/*\";\n  } else {\n    // For other prefix matches, add optional wildcard suffix\n    urlPatternPath = `${normalizedPattern}{/*}?`;\n  }\n\n  const urlPattern = new URLPattern({ pathname: urlPatternPath });\n\n  const match = urlPattern.exec({ pathname });\n  if (!match) {\n    return { matched: false, params: {}, consumedPathname: \"\" };\n  }\n\n  // Extract params (excluding the wildcard group \"0\")\n  const params: Record<string, string> = {};\n  for (const [key, value] of Object.entries(match.pathname.groups)) {\n    if (value !== undefined && key !== \"0\") {\n      params[key] = value;\n    }\n  }\n\n  // Calculate consumed pathname\n  let consumedPathname: string;\n  if (exact) {\n    consumedPathname = pathname;\n  } else if (normalizedPattern === \"/\") {\n    // Root pattern consumes just \"/\"\n    consumedPathname = \"/\";\n  } else {\n    // For prefix matches, calculate based on pattern segments\n    const patternSegments = normalizedPattern.split(\"/\").filter(Boolean);\n    const pathnameSegments = pathname.split(\"/\").filter(Boolean);\n    consumedPathname =\n      \"/\" + pathnameSegments.slice(0, patternSegments.length).join(\"/\");\n  }\n\n  return { matched: true, params, consumedPathname };\n}\n","import type { LoaderArgs } from \"../route.js\";\nimport type {\n  MatchedRoute,\n  MatchedRouteWithData,\n  InternalRouteDefinition,\n} from \"../types.js\";\n\n/**\n * Cache for loader results.\n * Key format: `${entryId}:${matchIndex}`\n */\nconst loaderCache = new Map<string, unknown>();\n\n/**\n * Get or create a loader result from cache.\n * If the result is not cached, executes the loader and caches the result.\n */\nfunction getOrCreateLoaderResult(\n  entryId: string,\n  matchIndex: number,\n  route: InternalRouteDefinition,\n  args: LoaderArgs,\n): unknown | undefined {\n  if (!route.loader) {\n    return undefined;\n  }\n\n  const cacheKey = `${entryId}:${matchIndex}`;\n\n  if (!loaderCache.has(cacheKey)) {\n    loaderCache.set(cacheKey, route.loader(args));\n  }\n\n  return loaderCache.get(cacheKey);\n}\n\n/**\n * Create a Request object for loader args.\n */\nexport function createLoaderRequest(url: URL): Request {\n  return new Request(url.href, {\n    method: \"GET\",\n  });\n}\n\n/**\n * Execute loaders for matched routes and return routes with data.\n * Results are cached by navigation entry id to prevent duplicate execution.\n */\nexport function executeLoaders(\n  matchedRoutes: MatchedRoute[],\n  entryId: string,\n  request: Request,\n  signal: AbortSignal,\n): MatchedRouteWithData[] {\n  return matchedRoutes.map((match, index) => {\n    const { route, params } = match;\n    const args: LoaderArgs = { params, request, signal };\n    const data = getOrCreateLoaderResult(entryId, index, route, args);\n\n    return { ...match, data };\n  });\n}\n\n/**\n * Clear the loader cache.\n * Mainly used for testing.\n */\nexport function clearLoaderCache(): void {\n  loaderCache.clear();\n}\n\n/**\n * Clear loader cache entries for a specific navigation entry.\n * Called when a NavigationHistoryEntry is disposed (removed from history stack).\n */\nexport function clearLoaderCacheForEntry(entryId: string): void {\n  const prefix = `${entryId}:`;\n  for (const key of loaderCache.keys()) {\n    if (key.startsWith(prefix)) {\n      loaderCache.delete(key);\n    }\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\nimport { matchRoutes } from \"./matchRoutes.js\";\nimport {\n  executeLoaders,\n  createLoaderRequest,\n  clearLoaderCacheForEntry,\n} from \"./loaderCache.js\";\n\n/**\n * Fallback AbortController for data loading initialized outside of a navigation event.\n * Aborted when the next navigation occurs.\n *\n * To save resources, this controller is created only when needed.\n */\nlet idleController: AbortController | null = null;\n\n/**\n * Reset navigation state. Used for testing.\n */\nexport function resetNavigationState(): void {\n  idleController?.abort();\n  idleController = null;\n}\n\n/**\n * Adapter that uses the Navigation API for full SPA functionality.\n */\nexport class NavigationAPIAdapter implements RouterAdapter {\n  // Cache the snapshot to ensure referential stability for useSyncExternalStore\n  #cachedSnapshot: LocationEntry | null = null;\n  #cachedEntryId: string | null = null;\n  // Ephemeral info from the current navigation event (not persisted in history)\n  #currentNavigationInfo: unknown = undefined;\n\n  getSnapshot(): LocationEntry | null {\n    const entry = navigation.currentEntry;\n    if (!entry?.url) {\n      return null;\n    }\n\n    // Return cached snapshot if entry hasn't changed\n    if (this.#cachedEntryId === entry.id && this.#cachedSnapshot) {\n      return this.#cachedSnapshot;\n    }\n\n    // Create new snapshot and cache it\n    this.#cachedEntryId = entry.id;\n    this.#cachedSnapshot = {\n      url: new URL(entry.url),\n      key: entry.id,\n      state: entry.getState(),\n      info: this.#currentNavigationInfo,\n    };\n    return this.#cachedSnapshot;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(callback: () => void): () => void {\n    const controller = new AbortController();\n    navigation.addEventListener(\"currententrychange\", callback, {\n      signal: controller.signal,\n    });\n\n    // Subscribe to dispose events on all existing entries\n    this.#subscribeToDisposeEvents(controller.signal);\n\n    // When current entry changes, subscribe to any new entries' dispose events\n    navigation.addEventListener(\n      \"currententrychange\",\n      () => this.#subscribeToDisposeEvents(controller.signal),\n      { signal: controller.signal },\n    );\n\n    return () => {\n      controller.abort();\n    };\n  }\n\n  /**\n   * Track which entries we've subscribed to dispose events for.\n   */\n  #subscribedEntryIds = new Set<string>();\n\n  /**\n   * Subscribe to dispose events on all navigation entries.\n   * When an entry is disposed, its cached loader results are cleared.\n   */\n  #subscribeToDisposeEvents(signal: AbortSignal): void {\n    for (const entry of navigation.entries()) {\n      if (this.#subscribedEntryIds.has(entry.id)) {\n        continue;\n      }\n      this.#subscribedEntryIds.add(entry.id);\n\n      const entryId = entry.id;\n      entry.addEventListener(\n        \"dispose\",\n        () => {\n          clearLoaderCacheForEntry(entryId);\n          this.#subscribedEntryIds.delete(entryId);\n        },\n        { signal },\n      );\n    }\n  }\n\n  navigate(to: string, options?: NavigateOptions): void {\n    navigation.navigate(to, {\n      history: options?.replace ? \"replace\" : \"push\",\n      state: options?.state,\n      info: options?.info,\n    });\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    const result = navigation.navigate(to, {\n      history: options?.replace ? \"replace\" : \"push\",\n      state: options?.state,\n      info: options?.info,\n    });\n    await result.finished;\n  }\n\n  setupInterception(\n    routes: InternalRouteDefinition[],\n    onNavigate?: OnNavigateCallback,\n    checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    const handleNavigate = (event: NavigateEvent) => {\n      // Capture ephemeral info from the navigate event\n      // This info is only available during this navigation and resets on the next one\n      this.#currentNavigationInfo = event.info;\n      // Invalidate cached snapshot to pick up new info\n      this.#cachedSnapshot = null;\n\n      // Check blockers first - if any blocker returns true, prevent navigation\n      if (checkBlockers?.()) {\n        event.preventDefault();\n        return;\n      }\n\n      // Only intercept same-origin navigations\n      if (!event.canIntercept) {\n        onNavigate?.(event, []);\n        return;\n      }\n\n      // Check if the URL matches any of our routes\n      const url = new URL(event.destination.url);\n      const matched = matchRoutes(routes, url.pathname);\n\n      // Call onNavigate callback if provided (regardless of route match)\n      if (onNavigate) {\n        onNavigate(event, matched);\n        if (event.defaultPrevented) {\n          return; // Do not intercept, allow browser default\n        }\n      }\n\n      // hash change navigations are not intercepted.\n      // Also do not intercept if it is a download request.\n      if (event.hashChange || event.downloadRequest !== null) {\n        return;\n      }\n\n      if (!matched) {\n        return;\n      }\n\n      // Route match, so intercept\n\n      // Abort initial load's loaders if this is the first navigation\n      if (idleController) {\n        idleController.abort();\n        idleController = null;\n      }\n\n      event.intercept({\n        handler: async () => {\n          const request = createLoaderRequest(url);\n\n          // Note: in response to `currententrychange` event, <Router> should already\n          // have dispatched data loaders and the results should be cached.\n          // Here we run executeLoader to retrieve cached results.\n          const currentEntry = navigation.currentEntry;\n          if (!currentEntry) {\n            throw new Error(\n              \"Navigation currentEntry is null during navigation interception\",\n            );\n          }\n\n          const results = executeLoaders(\n            matched,\n            currentEntry.id,\n            request,\n            event.signal,\n          );\n\n          // Delay navigation until async loaders complete\n          await Promise.all(results.map((r) => r.data));\n        },\n      });\n    };\n\n    const controller = new AbortController();\n    navigation.addEventListener(\"navigate\", handleNavigate, {\n      signal: controller.signal,\n    });\n    return () => {\n      controller.abort();\n    };\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    idleController ??= new AbortController();\n    return idleController.signal;\n  }\n\n  updateCurrentEntryState(state: unknown): void {\n    // Invalidate cached snapshot BEFORE updating, so the subscriber gets fresh state\n    this.#cachedSnapshot = null;\n    navigation.updateCurrentEntry({ state });\n    // Note: updateCurrentEntry fires currententrychange, so subscribers are notified automatically\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\n\n/**\n * Static adapter for fallback mode when Navigation API is unavailable.\n * Provides read-only location access with no SPA navigation capabilities.\n * Links will cause full page loads (MPA behavior).\n */\nexport class StaticAdapter implements RouterAdapter {\n  #cachedSnapshot: LocationEntry | null = null;\n  #idleController: AbortController | null = null;\n\n  getSnapshot(): LocationEntry | null {\n    if (typeof window === \"undefined\") {\n      return null;\n    }\n\n    // Cache the snapshot - it never changes in static mode\n    if (!this.#cachedSnapshot) {\n      this.#cachedSnapshot = {\n        url: new URL(window.location.href),\n        key: \"__static__\",\n        state: undefined,\n        info: undefined,\n      };\n    }\n    return this.#cachedSnapshot;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(_callback: () => void): () => void {\n    // Static mode never fires location change events\n    return () => {};\n  }\n\n  navigate(to: string, _options?: NavigateOptions): void {\n    console.warn(\n      \"FUNSTACK Router: navigate() called in static fallback mode. \" +\n        \"Navigation API is not available in this browser. \" +\n        \"Links will cause full page loads.\",\n    );\n    // Note: We intentionally do NOT do window.location.href = to\n    // as that would mask bugs where developers expect SPA behavior.\n    // If needed in the future, we could add a \"static-reload\" mode.\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    this.navigate(to, options);\n  }\n\n  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\n    _checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    // No interception in static mode - links cause full page loads\n    return undefined;\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    this.#idleController ??= new AbortController();\n    return this.#idleController.signal;\n  }\n\n  updateCurrentEntryState(_state: unknown): void {\n    // No-op in static mode - state updates require Navigation API\n  }\n}\n","import type { RouterAdapter, LocationEntry } from \"./RouterAdapter.js\";\nimport type {\n  InternalRouteDefinition,\n  NavigateOptions,\n  OnNavigateCallback,\n} from \"../types.js\";\n\n/**\n * Null adapter for when Navigation API is unavailable and no fallback is configured.\n * All methods are no-ops that return safe default values.\n */\nexport class NullAdapter implements RouterAdapter {\n  #idleController: AbortController | null = null;\n\n  getSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  getServerSnapshot(): LocationEntry | null {\n    return null;\n  }\n\n  subscribe(_callback: () => void): () => void {\n    return () => {};\n  }\n\n  navigate(_to: string, _options?: NavigateOptions): void {\n    console.warn(\n      \"FUNSTACK Router: navigate() called but no adapter is available. \" +\n        \"Navigation API is not available in this browser and no fallback mode is configured.\",\n    );\n  }\n\n  async navigateAsync(to: string, options?: NavigateOptions): Promise<void> {\n    this.navigate(to, options);\n  }\n\n  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\n    _checkBlockers?: () => boolean,\n  ): (() => void) | undefined {\n    return undefined;\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    this.#idleController ??= new AbortController();\n    return this.#idleController.signal;\n  }\n\n  updateCurrentEntryState(_state: unknown): void {\n    // No-op: NullAdapter doesn't support state updates\n  }\n}\n","import type { RouterAdapter } from \"./RouterAdapter.js\";\nimport { NavigationAPIAdapter } from \"./NavigationAPIAdapter.js\";\nimport { StaticAdapter } from \"./StaticAdapter.js\";\nimport { NullAdapter } from \"./NullAdapter.js\";\nimport type { FallbackMode } from \"../types.js\";\n\n/**\n * Check if Navigation API is available.\n */\nfunction hasNavigation(): boolean {\n  return typeof window !== \"undefined\" && \"navigation\" in window;\n}\n\n/**\n * Create the appropriate router adapter based on browser capabilities\n * and the specified fallback mode.\n *\n * @param fallback - The fallback mode to use when Navigation API is unavailable\n * @returns A RouterAdapter instance\n */\nexport function createAdapter(fallback: FallbackMode): RouterAdapter {\n  // Try Navigation API first\n  if (hasNavigation()) {\n    return new NavigationAPIAdapter();\n  }\n\n  // Fall back to static mode if enabled\n  if (fallback === \"static\") {\n    return new StaticAdapter();\n  }\n\n  // No adapter available (fallback=\"none\" or default)\n  return new NullAdapter();\n}\n","import {\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport { RouterContext } from \"./context/RouterContext.js\";\nimport { RouteContext } from \"./context/RouteContext.js\";\nimport {\n  BlockerContext,\n  createBlockerRegistry,\n} from \"./context/BlockerContext.js\";\nimport {\n  type NavigateOptions,\n  type MatchedRouteWithData,\n  type OnNavigateCallback,\n  type FallbackMode,\n  type InternalRouteState,\n  internalRoutes,\n} from \"./types.js\";\nimport { matchRoutes } from \"./core/matchRoutes.js\";\nimport { createAdapter } from \"./core/createAdapter.js\";\nimport { executeLoaders, createLoaderRequest } from \"./core/loaderCache.js\";\nimport type { RouteDefinition } from \"./route.js\";\n\nexport type RouterProps = {\n  routes: RouteDefinition[];\n  /**\n   * Callback invoked before navigation is intercepted.\n   * Call `event.preventDefault()` to prevent the router from handling this navigation.\n   *\n   * @param event - The NavigateEvent from the Navigation API\n   * @param matched - Array of matched routes, or null if no routes matched\n   */\n  onNavigate?: OnNavigateCallback;\n  /**\n   * Fallback mode when Navigation API is unavailable.\n   *\n   * - `\"none\"` (default): Render nothing when Navigation API is unavailable\n   * - `\"static\"`: Render matched routes without navigation capabilities (MPA behavior)\n   */\n  fallback?: FallbackMode;\n};\n\nexport function Router({\n  routes: inputRoutes,\n  onNavigate,\n  fallback = \"none\",\n}: RouterProps): ReactNode {\n  const routes = internalRoutes(inputRoutes);\n\n  // Create adapter once based on browser capabilities and fallback setting\n  const adapter = useMemo(() => createAdapter(fallback), [fallback]);\n\n  // Create blocker registry once\n  const [blockerRegistry] = useState(() => createBlockerRegistry());\n\n  // Subscribe to location changes via adapter\n  const locationEntry = useSyncExternalStore(\n    useCallback((callback) => adapter.subscribe(callback), [adapter]),\n    () => adapter.getSnapshot(),\n    () => adapter.getServerSnapshot(),\n  );\n\n  // Set up navigation interception via adapter\n  useEffect(() => {\n    return adapter.setupInterception(\n      routes,\n      onNavigate,\n      blockerRegistry.checkAll,\n    );\n  }, [adapter, routes, onNavigate, blockerRegistry]);\n\n  // Navigate function from adapter\n  const navigate = useCallback(\n    (to: string, options?: NavigateOptions) => {\n      adapter.navigate(to, options);\n    },\n    [adapter],\n  );\n\n  // Navigate function that returns a Promise\n  const navigateAsync = useCallback(\n    (to: string, options?: NavigateOptions) => {\n      return adapter.navigateAsync(to, options);\n    },\n    [adapter],\n  );\n\n  // Update current entry's state without navigation\n  const updateCurrentEntryState = useCallback(\n    (state: unknown) => {\n      adapter.updateCurrentEntryState(state);\n    },\n    [adapter],\n  );\n\n  return useMemo(() => {\n    if (locationEntry === null) {\n      // This happens either when Navigation API is unavailable (and no fallback),\n      // or the current document is not fully active.\n      return null;\n    }\n\n    const { url, key } = locationEntry;\n\n    // Match current URL against routes and execute loaders\n    const matchedRoutesWithData = (() => {\n      const matched = matchRoutes(routes, url.pathname);\n      if (!matched) return null;\n\n      // Execute loaders (results are cached by location entry key)\n      const request = createLoaderRequest(url);\n      const signal = adapter.getIdleAbortSignal();\n      return executeLoaders(matched, key, request, signal);\n    })();\n\n    const routerContextValue = {\n      locationEntry,\n      url,\n      navigate,\n      navigateAsync,\n      updateCurrentEntryState,\n    };\n\n    const blockerContextValue = { registry: blockerRegistry };\n\n    return (\n      <BlockerContext.Provider value={blockerContextValue}>\n        <RouterContext.Provider value={routerContextValue}>\n          {matchedRoutesWithData ? (\n            <RouteRenderer matchedRoutes={matchedRoutesWithData} index={0} />\n          ) : null}\n        </RouterContext.Provider>\n      </BlockerContext.Provider>\n    );\n  }, [\n    navigate,\n    navigateAsync,\n    updateCurrentEntryState,\n    locationEntry,\n    routes,\n    adapter,\n    blockerRegistry,\n  ]);\n}\n\ntype RouteRendererProps = {\n  matchedRoutes: MatchedRouteWithData[];\n  index: number;\n};\n\n/**\n * Recursively render matched routes with proper context.\n */\nfunction RouteRenderer({\n  matchedRoutes,\n  index,\n}: RouteRendererProps): ReactNode {\n  const match = matchedRoutes[index];\n  if (!match) return null;\n\n  const { route, params, pathname, data } = match;\n\n  const routerContext = useContext(RouterContext);\n  if (!routerContext) {\n    throw new Error(\"RouteRenderer must be used within RouterContext\");\n  }\n  const { locationEntry, url, navigateAsync, updateCurrentEntryState } =\n    routerContext;\n\n  // Extract this route's state from internal structure\n  const internalState = locationEntry.state as InternalRouteState | undefined;\n  const routeState = internalState?.__routeStates?.[index];\n\n  // Create stable setStateSync callback for this route's slice (synchronous via updateCurrentEntry)\n  const setStateSync = useCallback(\n    (stateOrUpdater: unknown | ((prev: unknown) => unknown)) => {\n      const currentStates =\n        (locationEntry.state as InternalRouteState | undefined)\n          ?.__routeStates ?? [];\n      const currentRouteState = currentStates[index];\n\n      const newState =\n        typeof stateOrUpdater === \"function\"\n          ? (stateOrUpdater as (prev: unknown) => unknown)(currentRouteState)\n          : stateOrUpdater;\n\n      const newStates = [...currentStates];\n      newStates[index] = newState;\n      updateCurrentEntryState({ __routeStates: newStates });\n    },\n    [locationEntry.state, index, updateCurrentEntryState],\n  );\n\n  // Create stable setState callback for this route's slice (async via replace navigation)\n  const setState = useCallback(\n    async (\n      stateOrUpdater: unknown | ((prev: unknown) => unknown),\n    ): Promise<void> => {\n      const currentStates =\n        (locationEntry.state as InternalRouteState | undefined)\n          ?.__routeStates ?? [];\n      const currentRouteState = currentStates[index];\n\n      const newState =\n        typeof stateOrUpdater === \"function\"\n          ? (stateOrUpdater as (prev: unknown) => unknown)(currentRouteState)\n          : stateOrUpdater;\n\n      const newStates = [...currentStates];\n      newStates[index] = newState;\n\n      await navigateAsync(url.href, {\n        replace: true,\n        state: { __routeStates: newStates },\n      });\n    },\n    [locationEntry.state, index, url, navigateAsync],\n  );\n\n  // Create stable resetState callback\n  const resetState = useCallback(() => {\n    const currentStates =\n      (locationEntry.state as InternalRouteState | undefined)?.__routeStates ??\n      [];\n    const newStates = [...currentStates];\n    newStates[index] = undefined;\n    updateCurrentEntryState({ __routeStates: newStates });\n  }, [locationEntry.state, index, updateCurrentEntryState]);\n\n  // Create outlet for child routes\n  const outlet =\n    index < matchedRoutes.length - 1 ? (\n      <RouteRenderer matchedRoutes={matchedRoutes} index={index + 1} />\n    ) : null;\n\n  const routeContextValue = useMemo(\n    () => ({ params, matchedPath: pathname, outlet }),\n    [params, pathname, outlet],\n  );\n\n  // Render component with or without data prop based on loader presence\n  // Always pass params, state, setState, resetState, and info props to components\n  const renderComponent = () => {\n    const componentOrElement = route.component;\n\n    if (componentOrElement == null) return outlet;\n\n    // Check if it's a component reference (function) or a ReactNode (JSX element)\n    if (typeof componentOrElement !== \"function\") {\n      // ReactNode (JSX element, string, number, etc.): render as-is without router props\n      return componentOrElement;\n    }\n\n    // Component reference: inject router props (existing behavior)\n    const Component = componentOrElement;\n\n    const stateProps = {\n      state: routeState,\n      setState,\n      setStateSync,\n      resetState,\n    };\n\n    // Ephemeral info from the current navigation\n    const { info } = locationEntry;\n\n    // When loader exists, data is defined and component expects data prop\n    // When loader doesn't exist, data is undefined and component doesn't expect data prop\n    // TypeScript can't narrow this union, so we use runtime check with type assertion\n    if (route.loader) {\n      const ComponentWithData = Component as React.ComponentType<{\n        data: unknown;\n        params: Record<string, string>;\n        state: unknown;\n        setState: (s: unknown | ((prev: unknown) => unknown)) => Promise<void>;\n        setStateSync: (s: unknown | ((prev: unknown) => unknown)) => void;\n        resetState: () => void;\n        info: unknown;\n      }>;\n      return (\n        <ComponentWithData\n          data={data}\n          params={params}\n          {...stateProps}\n          info={info}\n        />\n      );\n    }\n    const ComponentWithoutData = Component as React.ComponentType<{\n      params: Record<string, string>;\n      state: unknown;\n      setState: (s: unknown | ((prev: unknown) => unknown)) => Promise<void>;\n      setStateSync: (s: unknown | ((prev: unknown) => unknown)) => void;\n      resetState: () => void;\n      info: unknown;\n    }>;\n    return <ComponentWithoutData params={params} {...stateProps} info={info} />;\n  };\n\n  return (\n    <RouteContext.Provider value={routeContextValue}>\n      {renderComponent()}\n    </RouteContext.Provider>\n  );\n}\n","import { type ReactNode, useContext } from \"react\";\nimport { RouteContext } from \"./context/RouteContext.js\";\n\n/**\n * Renders the matched child route.\n * Used in layout components to specify where child routes should render.\n */\nexport function Outlet(): ReactNode {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    return null;\n  }\n\n  return routeContext.outlet;\n}\n","import { useContext } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\nimport type { NavigateOptions } from \"../types.js\";\n\n/**\n * Returns a function for programmatic navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useNavigate must be used within a Router\");\n  }\n\n  return context.navigate;\n}\n","import { useContext, useMemo } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\nimport type { Location } from \"../types.js\";\n\n/**\n * Returns the current location object.\n */\nexport function useLocation(): Location {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useLocation must be used within a Router\");\n  }\n\n  const { url } = context;\n\n  return useMemo(() => {\n    return {\n      pathname: url.pathname,\n      search: url.search,\n      hash: url.hash,\n    };\n  }, [url]);\n}\n","import { useCallback, useContext, useMemo } from \"react\";\nimport { RouterContext } from \"../context/RouterContext.js\";\n\ntype SetSearchParams = (\n  params:\n    | URLSearchParams\n    | Record<string, string>\n    | ((prev: URLSearchParams) => URLSearchParams | Record<string, string>),\n) => void;\n\n/**\n * Returns and allows manipulation of URL search parameters.\n */\nexport function useSearchParams(): [URLSearchParams, SetSearchParams] {\n  const context = useContext(RouterContext);\n\n  if (!context) {\n    throw new Error(\"useSearchParams must be used within a Router\");\n  }\n\n  const searchParams = context.url.searchParams;\n\n  const setSearchParams = useCallback<SetSearchParams>(\n    (params) => {\n      const url = new URL(context.url);\n\n      let newParams: URLSearchParams;\n      if (typeof params === \"function\") {\n        const result = params(new URLSearchParams(url.search));\n        newParams =\n          result instanceof URLSearchParams\n            ? result\n            : new URLSearchParams(result);\n      } else if (params instanceof URLSearchParams) {\n        newParams = params;\n      } else {\n        newParams = new URLSearchParams(params);\n      }\n\n      url.search = newParams.toString();\n      context.navigate(url.pathname + url.search + url.hash, { replace: true });\n    },\n    [context],\n  );\n\n  return [searchParams, setSearchParams];\n}\n","import { useContext, useEffect, useId } from \"react\";\nimport { BlockerContext } from \"../context/BlockerContext.js\";\n\nexport type UseBlockerOptions = {\n  /**\n   * Function that returns true if navigation should be blocked.\n   * Can call `confirm()` inside to show a confirmation dialog.\n   */\n  shouldBlock: () => boolean;\n};\n\n/**\n * Hook to block navigation away from the current route.\n *\n * This is useful for scenarios like unsaved form data, ongoing file uploads,\n * or any state that would be lost on navigation.\n *\n * @example\n * ```tsx\n * function EditForm() {\n *   const [isDirty, setIsDirty] = useState(false);\n *\n *   useBlocker({\n *     shouldBlock: () => {\n *       if (isDirty) {\n *         return !confirm(\"You have unsaved changes. Leave anyway?\");\n *       }\n *       return false;\n *     },\n *   });\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * Note: This hook only handles SPA navigations (links, programmatic navigation).\n * For hard navigations (tab close, refresh), handle `beforeunload` separately.\n */\nexport function useBlocker(options: UseBlockerOptions): void {\n  const context = useContext(BlockerContext);\n\n  if (!context) {\n    throw new Error(\"useBlocker must be used within a Router\");\n  }\n\n  const { shouldBlock } = options;\n  const blockerId = useId();\n  const { registry } = context;\n\n  // Register blocker on mount, unregister on unmount\n  // Re-registers when shouldBlock function changes\n  useEffect(() => {\n    return registry.register(blockerId, shouldBlock);\n  }, [blockerId, shouldBlock, registry]);\n}\n"],"mappings":"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"}

package/dist/{route-BifTpiQO.d.mts → route-BXVQqSlR.d.mts}

@@ -1,4 +1,4 @@
-import { ComponentType } from "react";
+import { ComponentType, ReactNode } from "react";
 
 //#region src/route.d.ts
 declare const routeDefinitionSymbol: unique symbol;
@@ -62,7 +62,7 @@ interface OpaqueRouteDefinition {
  */
 type RouteDefinition = OpaqueRouteDefinition | {
   path: string;
-  component?: ComponentType<object>;
+  component?: ComponentType<object> | ReactNode;
   children?: RouteDefinition[];
 };
 /**
@@ -73,7 +73,7 @@ type RouteDefinition = OpaqueRouteDefinition | {
 type RouteWithLoader<TPath extends string, TData, TState> = {
   path: TPath;
   loader: (args: LoaderArgs) => TData;
-  component: ComponentType<RouteComponentPropsWithData<PathParams<TPath>, TData, TState>>;
+  component: ComponentType<RouteComponentPropsWithData<PathParams<TPath>, TData, TState>> | ReactNode;
   children?: RouteDefinition[];
 };
 /**
@@ -83,7 +83,7 @@ type RouteWithLoader<TPath extends string, TData, TState> = {
  */
 type RouteWithoutLoader<TPath extends string, TState> = {
   path: TPath;
-  component?: ComponentType<RouteComponentProps<PathParams<TPath>, TState>>;
+  component?: ComponentType<RouteComponentProps<PathParams<TPath>, TState>> | ReactNode;
   children?: RouteDefinition[];
 };
 /**
@@ -146,4 +146,4 @@ declare function routeState<TState>(): {
 };
 //#endregion
 export { RouteDefinition as a, RouteComponentPropsWithData as i, PathParams as n, route as o, RouteComponentProps as r, routeState as s, LoaderArgs as t };
-//# sourceMappingURL=route-BifTpiQO.d.mts.map
+//# sourceMappingURL=route-BXVQqSlR.d.mts.map

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

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

package/dist/route-DiO6FM2A.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"route-DiO6FM2A.mjs","names":[],"sources":["../src/route.ts"],"sourcesContent":["import type { ComponentType } 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 = {\n  /** Extracted path parameters */\n  params: Record<string, string>;\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 type 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};\n\n/**\n * Props for route components with loader.\n * Includes data from loader and navigation state management props.\n */\nexport type RouteComponentPropsWithData<\n  TParams extends Record<string, string>,\n  TData,\n  TState = undefined,\n> = 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]: never;\n  path: string;\n  children?: RouteDefinition[];\n}\n\n/**\n * Any route definition defined by user.\n */\nexport type RouteDefinition =\n  | OpaqueRouteDefinition\n  | {\n      path: string;\n      component?: ComponentType<object>;\n      children?: RouteDefinition[];\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 */\ntype RouteWithLoader<TPath extends string, TData, TState> = {\n  path: TPath;\n  loader: (args: LoaderArgs) => TData;\n  component: ComponentType<\n    RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n  >;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children?: RouteDefinition[];\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 */\ntype RouteWithoutLoader<TPath extends string, TState> = {\n  path: TPath;\n  component?: ComponentType<RouteComponentProps<PathParams<TPath>, TState>>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children?: RouteDefinition[];\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 loader\nexport function route<TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload without loader\nexport function route<TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Implementation\nexport function route<TPath extends string, TData>(\n  definition:\n    | RouteWithLoader<TPath, TData, undefined>\n    | RouteWithoutLoader<TPath, undefined>,\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  <TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState>,\n  ): OpaqueRouteDefinition;\n  <TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition;\n} {\n  return function <TPath extends string, TData>(\n    definition:\n      | RouteWithLoader<TPath, TData, TState>\n      | RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition {\n    return definition as unknown as OpaqueRouteDefinition;\n  };\n}\n"],"mappings":";AA8JA,SAAgB,MACd,YAGuB;AACvB,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aAOd;AACA,QAAO,SACL,YAGuB;AACvB,SAAO"}
+{"version":3,"file":"route-DiO6FM2A.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 = {\n  /** Extracted path parameters */\n  params: Record<string, string>;\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 type 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};\n\n/**\n * Props for route components with loader.\n * Includes data from loader and navigation state management props.\n */\nexport type RouteComponentPropsWithData<\n  TParams extends Record<string, string>,\n  TData,\n  TState = undefined,\n> = 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]: never;\n  path: string;\n  children?: RouteDefinition[];\n}\n\n/**\n * Any route definition defined by user.\n */\nexport type RouteDefinition =\n  | OpaqueRouteDefinition\n  | {\n      path: string;\n      component?: ComponentType<object> | ReactNode;\n      children?: RouteDefinition[];\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 */\ntype RouteWithLoader<TPath extends string, TData, TState> = {\n  path: TPath;\n  loader: (args: LoaderArgs) => TData;\n  component:\n    | ComponentType<\n        RouteComponentPropsWithData<PathParams<TPath>, TData, TState>\n      >\n    | ReactNode;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children?: RouteDefinition[];\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 */\ntype RouteWithoutLoader<TPath extends string, TState> = {\n  path: TPath;\n  component?:\n    | ComponentType<RouteComponentProps<PathParams<TPath>, TState>>\n    | ReactNode;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children?: RouteDefinition[];\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 loader\nexport function route<TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData, undefined>,\n): OpaqueRouteDefinition;\n// Overload without loader\nexport function route<TPath extends string>(\n  definition: RouteWithoutLoader<TPath, undefined>,\n): OpaqueRouteDefinition;\n// Implementation\nexport function route<TPath extends string, TData>(\n  definition:\n    | RouteWithLoader<TPath, TData, undefined>\n    | RouteWithoutLoader<TPath, undefined>,\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  <TPath extends string, TData>(\n    definition: RouteWithLoader<TPath, TData, TState>,\n  ): OpaqueRouteDefinition;\n  <TPath extends string>(\n    definition: RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition;\n} {\n  return function <TPath extends string, TData>(\n    definition:\n      | RouteWithLoader<TPath, TData, TState>\n      | RouteWithoutLoader<TPath, TState>,\n  ): OpaqueRouteDefinition {\n    return definition as unknown as OpaqueRouteDefinition;\n  };\n}\n"],"mappings":";AAkKA,SAAgB,MACd,YAGuB;AACvB,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BT,SAAgB,aAOd;AACA,QAAO,SACL,YAGuB;AACvB,SAAO"}

package/dist/server.d.mts

@@ -1,2 +1,2 @@
-import { a as RouteDefinition, i as RouteComponentPropsWithData, n as PathParams, o as route, r as RouteComponentProps, s as routeState, t as LoaderArgs } from "./route-BifTpiQO.mjs";
+import { a as RouteDefinition, i as RouteComponentPropsWithData, n as PathParams, o as route, r as RouteComponentProps, s as routeState, t as LoaderArgs } from "./route-BXVQqSlR.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.3-alpha.0",
+  "version": "0.0.3-alpha.1",
   "description": "A modern React router based on the Navigation API",
   "repository": {
     "type": "git",
@@ -37,7 +37,7 @@
     "@types/react": "^19.0.0",
     "jsdom": "^27.4.0",
     "react": "^19.0.0",
-    "tsdown": "^0.18.2",
+    "tsdown": "^0.19.0",
     "typescript": "^5.7.0",
     "urlpattern-polyfill": "^10.1.0",
     "vitest": "^4.0.16"

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

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