@funstack/router 0.0.1-alpha.2 → 0.0.1

package/dist/index.d.mts

@@ -2,6 +2,16 @@ import { ComponentType, ReactNode } from "react";
 
 //#region src/route.d.ts
 declare const routeDefinitionSymbol: unique symbol;
+/**
+ * Extracts parameter names from a path pattern.
+ * E.g., "/users/:id/posts/:postId" -> "id" | "postId"
+ */
+type ExtractParams<T extends string> = T extends `${string}:${infer Param}/${infer Rest}` ? Param | ExtractParams<`/${Rest}`> : T extends `${string}:${infer Param}` ? Param : never;
+/**
+ * Creates a params object type from a path pattern.
+ * E.g., "/users/:id" -> { id: string }
+ */
+type PathParams<T extends string> = [ExtractParams<T>] extends [never] ? Record<string, never> : { [K in ExtractParams<T>]: string };
 /**
  * Arguments passed to loader functions.
  */
@@ -31,28 +41,34 @@ type RouteDefinition = OpaqueRouteDefinition | {
 };
 /**
  * Route definition with loader - infers TData from loader return type.
+ * TPath is used to infer params type from the path pattern.
  */
-type RouteWithLoader<TData> = {
-  path: string;
+type RouteWithLoader<TPath extends string, TData> = {
+  path: TPath;
   loader: (args: LoaderArgs) => TData;
   component: ComponentType<{
     data: TData;
+    params: PathParams<TPath>;
   }>;
   children?: RouteDefinition[];
 };
 /**
  * Route definition without loader.
+ * TPath is used to infer params type from the path pattern.
  */
-type RouteWithoutLoader = {
-  path: string;
-  component?: ComponentType;
+type RouteWithoutLoader<TPath extends string> = {
+  path: TPath;
+  component?: ComponentType<{
+    params: PathParams<TPath>;
+  }>;
   children?: RouteDefinition[];
 };
 /**
  * Helper function for creating type-safe route definitions.
  *
  * When a loader is provided, TypeScript infers the return type and ensures
- * the component accepts a `data` prop of that type.
+ * the component accepts a `data` prop of that type. Components always receive
+ * a `params` prop with types inferred from the path pattern.
  *
  * @example
  * ```typescript
@@ -63,33 +79,18 @@ type RouteWithoutLoader = {
  *     const res = await fetch(`/api/users/${params.userId}`, { signal });
  *     return res.json() as Promise<User>;
  *   },
- *   component: UserDetail, // Must accept { data: Promise<User> }
+ *   component: UserDetail, // Must accept { data: Promise<User>, params: { userId: string } }
  * });
  *
  * // Route without loader
  * route({
  *   path: "about",
- *   component: AboutPage, // No data prop required
+ *   component: AboutPage, // Must accept { params: {} }
  * });
  * ```
  */
-declare function route<TData>(definition: RouteWithLoader<TData>): OpaqueRouteDefinition;
-declare function route(definition: RouteWithoutLoader): OpaqueRouteDefinition;
-//#endregion
-//#region src/Router.d.ts
-type RouterProps = {
-  routes: RouteDefinition[];
-};
-declare function Router({
-  routes: inputRoutes
-}: RouterProps): ReactNode;
-//#endregion
-//#region src/Outlet.d.ts
-/**
- * Renders the matched child route.
- * Used in layout components to specify where child routes should render.
- */
-declare function Outlet(): ReactNode;
+declare function route<TPath extends string, TData>(definition: RouteWithLoader<TPath, TData>): OpaqueRouteDefinition;
+declare function route<TPath extends string>(definition: RouteWithoutLoader<TPath>): OpaqueRouteDefinition;
 //#endregion
 //#region src/types.d.ts
 declare const InternalRouteDefinitionSymbol: unique symbol;
@@ -108,6 +109,7 @@ type InternalRouteDefinition = {
   /** Component to render when this route matches */
   component?: ComponentType<{
     data?: unknown;
+    params?: Record<string, string>;
   }>;
 };
 /**
@@ -145,6 +147,53 @@ type Location = {
   search: string;
   hash: string;
 };
+/**
+ * Callback invoked before navigation is intercepted.
+ * Call `event.preventDefault()` to prevent the router from handling this navigation.
+ *
+ * @param event - The NavigateEvent from the Navigation API
+ * @param matched - Array of matched routes, or null if no routes matched
+ */
+type OnNavigateCallback = (event: NavigateEvent, matched: readonly MatchedRoute[] | null) => void;
+/**
+ * Fallback mode when Navigation API is unavailable.
+ *
+ * - `"none"` (default): Render nothing when Navigation API is unavailable
+ * - `"static"`: Render matched routes without navigation capabilities (MPA behavior)
+ */
+type FallbackMode = "none" | "static";
+//#endregion
+//#region src/Router.d.ts
+type RouterProps = {
+  routes: RouteDefinition[];
+  /**
+   * Callback invoked before navigation is intercepted.
+   * Call `event.preventDefault()` to prevent the router from handling this navigation.
+   *
+   * @param event - The NavigateEvent from the Navigation API
+   * @param matched - Array of matched routes, or null if no routes matched
+   */
+  onNavigate?: OnNavigateCallback;
+  /**
+   * Fallback mode when Navigation API is unavailable.
+   *
+   * - `"none"` (default): Render nothing when Navigation API is unavailable
+   * - `"static"`: Render matched routes without navigation capabilities (MPA behavior)
+   */
+  fallback?: FallbackMode;
+};
+declare function Router({
+  routes: inputRoutes,
+  onNavigate,
+  fallback
+}: RouterProps): ReactNode;
+//#endregion
+//#region src/Outlet.d.ts
+/**
+ * Renders the matched child route.
+ * Used in layout components to specify where child routes should render.
+ */
+declare function Outlet(): ReactNode;
 //#endregion
 //#region src/hooks/useNavigate.d.ts
 /**
@@ -171,5 +220,19 @@ type SetSearchParams = (params: URLSearchParams | Record<string, string> | ((pre
  */
 declare function useSearchParams(): [URLSearchParams, SetSearchParams];
 //#endregion
-export { type LoaderArgs, type Location, type MatchedRoute, type MatchedRouteWithData, type NavigateOptions, Outlet, type RouteDefinition, Router, type RouterProps, route, useLocation, useNavigate, useParams, useSearchParams };
+//#region src/core/RouterAdapter.d.ts
+/**
+ * Represents the current location state.
+ * Abstracts NavigationHistoryEntry for static mode compatibility.
+ */
+type LocationEntry = {
+  /** The current URL */
+  url: URL;
+  /** Unique key for this entry (used for loader caching) */
+  key: string;
+  /** State associated with this entry */
+  state: unknown;
+};
+//#endregion
+export { type FallbackMode, type LoaderArgs, type Location, type LocationEntry, type MatchedRoute, type MatchedRouteWithData, type NavigateOptions, type OnNavigateCallback, Outlet, type PathParams, type RouteDefinition, Router, type RouterProps, route, useLocation, useNavigate, useParams, useSearchParams };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/route.ts","../src/Router.tsx","../src/Outlet.tsx","../src/types.ts","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts"],"sourcesContent":[],"mappings":";;;cAEM;;AAFqC;AAO3C;AAEU,KAFE,UAAA,GAEF;EAEC;EAED,MAAA,EAJA,MAIA,CAAA,MAAA,EAAA,MAAA,CAAA;EAAW;EAMJ,OAAA,EARN,OAQM;EASL;EACR,MAAA,EAhBM,WAgBN;CAGc;;;AAEZ;AAOW,UAtBA,qBAAA,CAsBA;EAAe,CArB7B,qBAAA,CAqB6B,EAAA,KAAA;EACG,IAAA,EAAA,MAAA;EAAtB,QAAA,CAAA,EApBA,eAoBA,EAAA;;;AAEe;AAsC5B;AAC8B,KAvDlB,eAAA,GACR,qBAsD0B,GAAA;EAAhB,IAAA,EAAA,MAAA;EACX,SAAA,CAAA,EApDe,aAoDf,CAAA,CAAA,CAAA,CAAA;EAAqB,QAAA,CAAA,EAnDP,eAmDO,EAAA;AACxB,CAAA;;;;AC3DA,KDaK,eCbkB,CAAA,KAAA,CAAA,GACb;EAGM,IAAA,EAAA,MAAM;EAAW,MAAA,EAAA,CAAA,IAAA,EDWhB,UCXgB,EAAA,GDWD,KCXC;EAAe,SAAA,EDYnC,aCZmC,CAAA;IAAc,IAAA,EDY3B,KCZ2B;EAAS,CAAA,CAAA;aDc1D;;;AErCb;;KF2CK,kBAAA;;EG/CC,SAAA,CAAA,EHiDQ,aGjDR;EAMM,QAAA,CAAA,EH6CC,eG7CsB,EAAA;CAChC;;;;;AA+BH;AAYA;AAQA;AAUA;;;;AChEA;;;;ACAA;;;;ACDA;;;;;;iBN4EgB,yBACF,gBAAgB,SAC3B;iBACa,KAAA,aAAkB,qBAAqB;;;KC3D3C,WAAA;EDxBN,MAAA,ECyBI,eDzBJ,EAAgC;AAKtC,CAAA;AAEU,iBCqBM,MAAA,CDrBN;EAAA,MAAA,ECqBuB;ADrBvB,CAAA,ECqBsC,WDrBtC,CAAA,ECqBoD,SDrBpD;;;;;AATiC;AAO3C;AAEU,iBEFM,MAAA,CAAA,CFEN,EEFgB,SFEhB;;;cGNJ;AHHqC;AAO3C;;;AAMU,KGJE,uBAAA,GHIF;EAAW,CGHlB,6BAAA,CHGkB,EAAA,KAAA;EAMJ;EASL,IAAA,EAAA,MAAA;EACR;EAGc,QAAA,CAAA,EGlBL,uBHkBK,EAAA;EACD;EAAe,MAAA,CAAA,EAAA,CAAA,IAAA,EGbd,UHac,EAAA,GAAA,OAAA;EAM3B;EAEY,SAAA,CAAA,EGnBH,aHmBG,CAAA;IAAe,IAAA,CAAA,EAAA,OAAA;EACG,CAAA,CAAA;CAAtB;AA2Cb;;;KG5CY,YAAA;EFfA;EAII,KAAA,EEaP,uBFba;EAAW;EAAe,MAAA,EEetC,MFfsC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAc;EAAS,QAAA,EAAA,MAAA;;;;ACvBvE;KC8CY,oBAAA,GAAuB;;;AApD2B,CAAA;AAQ9D;;;AAWkB,KAyCN,eAAA,GAzCM;EAEJ;EAAa,OAAA,CAAA,EAAA,OAAA;EAmBf;EAYA,KAAA,CAAA,EAAA,OAAA;AAQZ,CAAA;AAUA;;;KAAY,QAAA;EChEI,QAAA,EAAA,MAAW;;;;;;;;AJPgB;AAO/B,iBIAI,WAAA,CAAA,CJAM,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EIAgC,eJAhC,EAAA,GAAA,IAAA;;;;;AAPqB;AAO/B,iBKAI,WAAA,CAAA,CLAM,EKAS,QLAT;;;;;;AALhB,iBMIU,SNJsB,CAAA,UMK1B,MNL0B,CAAA,MAAA,EAAA,MAAA,CAAA,GMKD,MNLC,CAAA,MAAA,EAAA,MAAA,CAAA,CAAA,CAAA,CAAA,EMMjC,CNNiC;;;KOCjC,eAAA,YAEC,kBACA,iCACQ,oBAAoB,kBAAkB;;;APPT;AAO/B,iBOMI,eAAA,CAAA,CPNM,EAAA,COMc,ePNd,EOM+B,ePN/B,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/route.ts","../src/types.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts","../src/core/RouterAdapter.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -139,7 +139,7 @@ function executeLoaders(matchedRoutes, entryId, request, signal) {
 }
 
 //#endregion
-//#region src/core/navigation.ts
+//#region src/core/NavigationAPIAdapter.ts
 /**
 * Fallback AbortController for data loading initialized outside of a navigation event.
 * Aborted when the next navigation occurs.
@@ -148,104 +148,183 @@ function executeLoaders(matchedRoutes, entryId, request, signal) {
 */
 let idleController = null;
 /**
-* Get the current abort signal for loader cancellation.
+* Adapter that uses the Navigation API for full SPA functionality.
 */
-function getIdleAbortSignal() {
-	idleController ??= new AbortController();
-	return idleController.signal;
-}
-/**
-* Check if Navigation API is available.
-*/
-function hasNavigation() {
-	return typeof navigation !== "undefined";
-}
-/**
-* Subscribe to Navigation API's currententrychange event.
-* Returns a cleanup function.
-*/
-function subscribeToNavigation(callback) {
-	if (!hasNavigation()) return () => {};
-	navigation.addEventListener("currententrychange", callback);
-	return () => {
-		if (hasNavigation()) navigation.removeEventListener("currententrychange", callback);
-	};
-}
+var NavigationAPIAdapter = class {
+	cachedSnapshot = null;
+	cachedEntryId = null;
+	getSnapshot() {
+		const entry = navigation.currentEntry;
+		if (!entry?.url) return null;
+		if (this.cachedEntryId === entry.id && this.cachedSnapshot) return this.cachedSnapshot;
+		this.cachedEntryId = entry.id;
+		this.cachedSnapshot = {
+			url: new URL(entry.url),
+			key: entry.id,
+			state: entry.getState()
+		};
+		return this.cachedSnapshot;
+	}
+	getServerSnapshot() {
+		return null;
+	}
+	subscribe(callback) {
+		const controller = new AbortController();
+		navigation.addEventListener("currententrychange", callback, { signal: controller.signal });
+		return () => {
+			controller.abort();
+		};
+	}
+	navigate(to, options) {
+		navigation.navigate(to, {
+			history: options?.replace ? "replace" : "push",
+			state: options?.state
+		});
+	}
+	setupInterception(routes, onNavigate) {
+		const handleNavigate = (event) => {
+			if (!event.canIntercept || event.hashChange) return;
+			const url = new URL(event.destination.url);
+			const matched = matchRoutes(routes, url.pathname);
+			if (onNavigate) {
+				onNavigate(event, matched);
+				if (event.defaultPrevented) return;
+			}
+			if (matched) {
+				if (idleController) {
+					idleController.abort();
+					idleController = null;
+				}
+				event.intercept({ handler: async () => {
+					const request = createLoaderRequest(url);
+					const currentEntry = navigation.currentEntry;
+					if (!currentEntry) throw new Error("Navigation currentEntry is null during navigation interception");
+					const results = executeLoaders(matched, currentEntry.id, request, event.signal);
+					await Promise.all(results.map((r) => r.data));
+				} });
+			}
+		};
+		const controller = new AbortController();
+		navigation.addEventListener("navigate", handleNavigate, { signal: controller.signal });
+		return () => {
+			controller.abort();
+		};
+	}
+	getIdleAbortSignal() {
+		idleController ??= new AbortController();
+		return idleController.signal;
+	}
+};
+
+//#endregion
+//#region src/core/StaticAdapter.ts
 /**
-* Get current navigation entry snapshot.
+* Static adapter for fallback mode when Navigation API is unavailable.
+* Provides read-only location access with no SPA navigation capabilities.
+* Links will cause full page loads (MPA behavior).
 */
-function getNavigationSnapshot() {
-	if (!hasNavigation()) return null;
-	return navigation.currentEntry;
-}
+var StaticAdapter = class {
+	cachedSnapshot = null;
+	idleController = null;
+	getSnapshot() {
+		if (typeof window === "undefined") return null;
+		if (!this.cachedSnapshot) this.cachedSnapshot = {
+			url: new URL(window.location.href),
+			key: "__static__",
+			state: void 0
+		};
+		return this.cachedSnapshot;
+	}
+	getServerSnapshot() {
+		return null;
+	}
+	subscribe(_callback) {
+		return () => {};
+	}
+	navigate(to, _options) {
+		console.warn("FUNSTACK Router: navigate() called in static fallback mode. Navigation API is not available in this browser. Links will cause full page loads.");
+	}
+	setupInterception(_routes, _onNavigate) {}
+	getIdleAbortSignal() {
+		this.idleController ??= new AbortController();
+		return this.idleController.signal;
+	}
+};
+
+//#endregion
+//#region src/core/NullAdapter.ts
 /**
-* Server snapshot - Navigation API not available on server.
+* Null adapter for when Navigation API is unavailable and no fallback is configured.
+* All methods are no-ops that return safe default values.
 */
-function getServerSnapshot() {
-	return null;
-}
+var NullAdapter = class {
+	idleController = null;
+	getSnapshot() {
+		return null;
+	}
+	getServerSnapshot() {
+		return null;
+	}
+	subscribe(_callback) {
+		return () => {};
+	}
+	navigate(_to, _options) {
+		console.warn("FUNSTACK Router: navigate() called but no adapter is available. Navigation API is not available in this browser and no fallback mode is configured.");
+	}
+	setupInterception(_routes, _onNavigate) {}
+	getIdleAbortSignal() {
+		this.idleController ??= new AbortController();
+		return this.idleController.signal;
+	}
+};
+
+//#endregion
+//#region src/core/createAdapter.ts
 /**
-* Set up navigation interception for client-side routing.
-* Returns a cleanup function.
+* Check if Navigation API is available.
 */
-function setupNavigationInterception(routes) {
-	if (!hasNavigation()) return () => {};
-	const handleNavigate = (event) => {
-		if (!event.canIntercept || event.hashChange) return;
-		const url = new URL(event.destination.url);
-		const matched = matchRoutes(routes, url.pathname);
-		if (matched) {
-			if (idleController) {
-				idleController.abort();
-				idleController = null;
-			}
-			event.intercept({ handler: async () => {
-				const request = createLoaderRequest(url);
-				const currentEntry = navigation.currentEntry;
-				if (!currentEntry) throw new Error("Navigation currentEntry is null during navigation interception");
-				const results = executeLoaders(matched, currentEntry.id, request, event.signal);
-				await Promise.all(results.map((r) => r.data));
-			} });
-		}
-	};
-	navigation.addEventListener("navigate", handleNavigate);
-	return () => {
-		if (hasNavigation()) navigation.removeEventListener("navigate", handleNavigate);
-	};
+function hasNavigation() {
+	return typeof window !== "undefined" && "navigation" in window;
 }
 /**
-* Navigate to a new URL programmatically.
+* Create the appropriate router adapter based on browser capabilities
+* and the specified fallback mode.
+*
+* @param fallback - The fallback mode to use when Navigation API is unavailable
+* @returns A RouterAdapter instance
 */
-function performNavigation(to, options) {
-	if (!hasNavigation()) return;
-	navigation.navigate(to, {
-		history: options?.replace ? "replace" : "push",
-		state: options?.state
-	});
+function createAdapter(fallback) {
+	if (hasNavigation()) return new NavigationAPIAdapter();
+	if (fallback === "static") return new StaticAdapter();
+	return new NullAdapter();
 }
 
 //#endregion
 //#region src/Router.tsx
-function Router({ routes: inputRoutes }) {
+function Router({ routes: inputRoutes, onNavigate, fallback = "none" }) {
 	const routes = internalRoutes(inputRoutes);
-	const currentEntry = useSyncExternalStore(subscribeToNavigation, getNavigationSnapshot, getServerSnapshot);
+	const adapter = useMemo(() => createAdapter(fallback), [fallback]);
+	const locationEntry = useSyncExternalStore(useCallback((callback) => adapter.subscribe(callback), [adapter]), () => adapter.getSnapshot(), () => adapter.getServerSnapshot());
 	useEffect(() => {
-		return setupNavigationInterception(routes);
-	}, [routes]);
-	const navigate = useCallback((to, options) => performNavigation(to, options), []);
+		return adapter.setupInterception(routes, onNavigate);
+	}, [
+		adapter,
+		routes,
+		onNavigate
+	]);
+	const navigate = useCallback((to, options) => {
+		adapter.navigate(to, options);
+	}, [adapter]);
 	return useMemo(() => {
-		if (currentEntry === null) return null;
-		const currentUrl = currentEntry.url;
-		if (currentUrl === null) return null;
-		const url = new URL(currentUrl);
-		const currentEntryId = currentEntry.id;
+		if (locationEntry === null) return null;
+		const { url, key } = locationEntry;
 		const matchedRoutesWithData = (() => {
 			const matched = matchRoutes(routes, url.pathname);
 			if (!matched) return null;
-			return executeLoaders(matched, currentEntryId, createLoaderRequest(url), getIdleAbortSignal());
+			return executeLoaders(matched, key, createLoaderRequest(url), adapter.getIdleAbortSignal());
 		})();
 		const routerContextValue = {
-			currentEntry,
+			locationEntry,
 			url,
 			navigate
 		};
@@ -258,8 +337,9 @@ function Router({ routes: inputRoutes }) {
 		});
 	}, [
 		navigate,
-		currentEntry,
-		routes
+		locationEntry,
+		routes,
+		adapter
 	]);
 }
 /**
@@ -285,8 +365,11 @@ function RouteRenderer({ matchedRoutes, index }) {
 	]);
 	const renderComponent = () => {
 		if (!Component) return outlet;
-		if (route$1.loader) return /* @__PURE__ */ jsx(Component, { data });
-		return /* @__PURE__ */ jsx(Component, {});
+		if (route$1.loader) return /* @__PURE__ */ jsx(Component, {
+			data,
+			params
+		});
+		return /* @__PURE__ */ jsx(Component, { params });
 	};
 	return /* @__PURE__ */ jsx(RouteContext.Provider, {
 		value: routeContextValue,

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","route","newParams: URLSearchParams"],"sources":["../src/context/RouterContext.ts","../src/context/RouteContext.ts","../src/types.ts","../src/core/matchRoutes.ts","../src/core/loaderCache.ts","../src/core/navigation.ts","../src/Router.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts","../src/route.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { NavigateOptions } from \"../types.js\";\n\nexport type RouterContextValue = {\n  /** Current navigation entry */\n  currentEntry: NavigationHistoryEntry;\n  /** Current URL */\n  url: URL;\n  /** Navigate to a new URL */\n  navigate: (to: string, options?: NavigateOptions) => 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 type { ComponentType } from \"react\";\nimport type { LoaderArgs, RouteDefinition } from \"./route.js\";\n\nconst InternalRouteDefinitionSymbol = Symbol();\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<{ data?: unknown }>;\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};\n\n/**\n * Location object representing current URL state.\n */\nexport type Location = {\n  pathname: string;\n  search: string;\n  hash: string;\n};\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}:${routePath}`\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  route: InternalRouteDefinition,\n  args: LoaderArgs,\n): unknown | undefined {\n  if (!route.loader) {\n    return undefined;\n  }\n\n  const cacheKey = `${entryId}:${route.path}`;\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) => {\n    const { route, params } = match;\n    const args: LoaderArgs = { params, request, signal };\n    const data = getOrCreateLoaderResult(entryId, 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","import type { InternalRouteDefinition, NavigateOptions } from \"../types.js\";\nimport { matchRoutes } from \"./matchRoutes.js\";\nimport { executeLoaders, createLoaderRequest } 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 * Get the current abort signal for loader cancellation.\n */\nexport function getIdleAbortSignal(): AbortSignal {\n  idleController ??= new AbortController();\n  return idleController.signal;\n}\n\n/**\n * Reset navigation state. Used for testing.\n */\nexport function resetNavigationState(): void {\n  idleController?.abort();\n  idleController = null;\n}\n\n/**\n * Check if Navigation API is available.\n */\nexport function hasNavigation(): boolean {\n  return typeof navigation !== \"undefined\";\n}\n\n/**\n * Subscribe to Navigation API's currententrychange event.\n * Returns a cleanup function.\n */\nexport function subscribeToNavigation(callback: () => void): () => void {\n  if (!hasNavigation()) {\n    return () => {};\n  }\n  navigation.addEventListener(\"currententrychange\", callback);\n  return () => {\n    if (hasNavigation()) {\n      navigation.removeEventListener(\"currententrychange\", callback);\n    }\n  };\n}\n\n/**\n * Get current navigation entry snapshot.\n */\nexport function getNavigationSnapshot(): NavigationHistoryEntry | null {\n  if (!hasNavigation()) {\n    return null;\n  }\n  return navigation.currentEntry;\n}\n\n/**\n * Server snapshot - Navigation API not available on server.\n */\nexport function getServerSnapshot(): null {\n  return null;\n}\n\n/**\n * Set up navigation interception for client-side routing.\n * Returns a cleanup function.\n */\nexport function setupNavigationInterception(\n  routes: InternalRouteDefinition[],\n): () => void {\n  if (!hasNavigation()) {\n    return () => {};\n  }\n\n  const handleNavigate = (event: NavigateEvent) => {\n    // Only intercept same-origin navigations\n    if (!event.canIntercept || event.hashChange) {\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    if (matched) {\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\n  navigation.addEventListener(\"navigate\", handleNavigate);\n  return () => {\n    if (hasNavigation()) {\n      navigation.removeEventListener(\"navigate\", handleNavigate);\n    }\n  };\n}\n\n/**\n * Navigate to a new URL programmatically.\n */\nexport function performNavigation(to: string, options?: NavigateOptions): void {\n  if (!hasNavigation()) {\n    return;\n  }\n  navigation.navigate(to, {\n    history: options?.replace ? \"replace\" : \"push\",\n    state: options?.state,\n  });\n}\n","import {\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n} from \"react\";\nimport { RouterContext } from \"./context/RouterContext.js\";\nimport { RouteContext } from \"./context/RouteContext.js\";\nimport {\n  type NavigateOptions,\n  type MatchedRouteWithData,\n  internalRoutes,\n} from \"./types.js\";\nimport { matchRoutes } from \"./core/matchRoutes.js\";\nimport {\n  subscribeToNavigation,\n  getNavigationSnapshot,\n  getServerSnapshot,\n  setupNavigationInterception,\n  performNavigation,\n  getIdleAbortSignal,\n} from \"./core/navigation.js\";\nimport { executeLoaders, createLoaderRequest } from \"./core/loaderCache.js\";\nimport type { RouteDefinition } from \"./route.js\";\n\nexport type RouterProps = {\n  routes: RouteDefinition[];\n};\n\nexport function Router({ routes: inputRoutes }: RouterProps): ReactNode {\n  const routes = internalRoutes(inputRoutes);\n\n  const currentEntry = useSyncExternalStore(\n    subscribeToNavigation,\n    getNavigationSnapshot,\n    getServerSnapshot,\n  );\n\n  // Set up navigation interception\n  useEffect(() => {\n    return setupNavigationInterception(routes);\n  }, [routes]);\n\n  // Navigate function for programmatic navigation\n  const navigate = useCallback(\n    (to: string, options?: NavigateOptions) => performNavigation(to, options),\n    [],\n  );\n\n  return useMemo(() => {\n    if (currentEntry === null) {\n      // This happens either when Navigation API is unavailable,\n      // or the current document is not fully active.\n      return null;\n    }\n    const currentUrl = currentEntry.url;\n    if (currentUrl === null) {\n      // This means currentEntry is not in this document, which is impossible\n      return null;\n    }\n\n    const url = new URL(currentUrl);\n    const currentEntryId = currentEntry.id;\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 navigation entry id)\n      const request = createLoaderRequest(url);\n      const signal = getIdleAbortSignal();\n      return executeLoaders(matched, currentEntryId, request, signal);\n    })();\n\n    const routerContextValue = { currentEntry, url, navigate };\n\n    return (\n      <RouterContext.Provider value={routerContextValue}>\n        {matchedRoutesWithData ? (\n          <RouteRenderer matchedRoutes={matchedRoutesWithData} index={0} />\n        ) : null}\n      </RouterContext.Provider>\n    );\n  }, [navigate, currentEntry, routes]);\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  // 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  const renderComponent = () => {\n    if (!Component) return outlet;\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      }>;\n      return <ComponentWithData data={data} />;\n    }\n    const ComponentWithoutData = Component as React.ComponentType;\n    return <ComponentWithoutData />;\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 { useContext } from \"react\";\nimport { RouteContext } from \"../context/RouteContext.js\";\n\n/**\n * Returns route parameters from the matched path.\n */\nexport function useParams<\n  T extends Record<string, string> = Record<string, string>,\n>(): T {\n  const context = useContext(RouteContext);\n\n  if (!context) {\n    throw new Error(\"useParams must be used within a Router\");\n  }\n\n  return context.params as T;\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 type { ComponentType } from \"react\";\n\nconst routeDefinitionSymbol = Symbol();\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 * 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<{}>;\n      children?: RouteDefinition[];\n    };\n\n/**\n * Route definition with loader - infers TData from loader return type.\n */\ntype RouteWithLoader<TData> = {\n  path: string;\n  loader: (args: LoaderArgs) => TData;\n  component: ComponentType<{ data: TData }>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children?: RouteDefinition[];\n};\n\n/**\n * Route definition without loader.\n */\ntype RouteWithoutLoader = {\n  path: string;\n  component?: ComponentType;\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.\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> }\n * });\n *\n * // Route without loader\n * route({\n *   path: \"about\",\n *   component: AboutPage, // No data prop required\n * });\n * ```\n */\nexport function route<TData>(\n  definition: RouteWithLoader<TData>,\n): OpaqueRouteDefinition;\nexport function route(definition: RouteWithoutLoader): OpaqueRouteDefinition;\nexport function route<TData>(\n  definition: RouteWithLoader<TData> | RouteWithoutLoader,\n): OpaqueRouteDefinition {\n  return definition as OpaqueRouteDefinition;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["route","result: MatchedRoute","urlPatternPath: string","params: Record<string, string>","consumedPathname: string","route","idleController: AbortController | null","route","newParams: URLSearchParams"],"sources":["../src/context/RouterContext.ts","../src/context/RouteContext.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/useParams.ts","../src/hooks/useSearchParams.ts","../src/route.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};\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 type { ComponentType } from \"react\";\nimport type { LoaderArgs, RouteDefinition } from \"./route.js\";\n\nconst InternalRouteDefinitionSymbol = Symbol();\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  }>;\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};\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}:${routePath}`\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  route: InternalRouteDefinition,\n  args: LoaderArgs,\n): unknown | undefined {\n  if (!route.loader) {\n    return undefined;\n  }\n\n  const cacheKey = `${entryId}:${route.path}`;\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) => {\n    const { route, params } = match;\n    const args: LoaderArgs = { params, request, signal };\n    const data = getOrCreateLoaderResult(entryId, 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","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 { executeLoaders, createLoaderRequest } 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  private cachedSnapshot: LocationEntry | null = null;\n  private cachedEntryId: string | null = null;\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    };\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    return () => {\n      controller.abort();\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    });\n  }\n\n  setupInterception(\n    routes: InternalRouteDefinition[],\n    onNavigate?: OnNavigateCallback,\n  ): (() => void) | undefined {\n    const handleNavigate = (event: NavigateEvent) => {\n      // Only intercept same-origin navigations\n      if (!event.canIntercept || event.hashChange) {\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      if (matched) {\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\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","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  private cachedSnapshot: LocationEntry | null = null;\n  private 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      };\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  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\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","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  private 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  setupInterception(\n    _routes: InternalRouteDefinition[],\n    _onNavigate?: OnNavigateCallback,\n  ): (() => void) | undefined {\n    return undefined;\n  }\n\n  getIdleAbortSignal(): AbortSignal {\n    this.idleController ??= new AbortController();\n    return this.idleController.signal;\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  useEffect,\n  useMemo,\n  useSyncExternalStore,\n} from \"react\";\nimport { RouterContext } from \"./context/RouterContext.js\";\nimport { RouteContext } from \"./context/RouteContext.js\";\nimport {\n  type NavigateOptions,\n  type MatchedRouteWithData,\n  type OnNavigateCallback,\n  type FallbackMode,\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  // 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(routes, onNavigate);\n  }, [adapter, routes, onNavigate]);\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  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 = { locationEntry, url, navigate };\n\n    return (\n      <RouterContext.Provider value={routerContextValue}>\n        {matchedRoutesWithData ? (\n          <RouteRenderer matchedRoutes={matchedRoutesWithData} index={0} />\n        ) : null}\n      </RouterContext.Provider>\n    );\n  }, [navigate, locationEntry, routes, adapter]);\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  // 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 prop to components\n  const renderComponent = () => {\n    if (!Component) return outlet;\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      }>;\n      return <ComponentWithData data={data} params={params} />;\n    }\n    const ComponentWithoutData = Component as React.ComponentType<{\n      params: Record<string, string>;\n    }>;\n    return <ComponentWithoutData params={params} />;\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 { useContext } from \"react\";\nimport { RouteContext } from \"../context/RouteContext.js\";\n\n/**\n * Returns route parameters from the matched path.\n */\nexport function useParams<\n  T extends Record<string, string> = Record<string, string>,\n>(): T {\n  const context = useContext(RouteContext);\n\n  if (!context) {\n    throw new Error(\"useParams must be used within a Router\");\n  }\n\n  return context.params as T;\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 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 * 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<{}>;\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 */\ntype RouteWithLoader<TPath extends string, TData> = {\n  path: TPath;\n  loader: (args: LoaderArgs) => TData;\n  component: ComponentType<{ data: TData; params: PathParams<TPath> }>;\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 */\ntype RouteWithoutLoader<TPath extends string> = {\n  path: TPath;\n  component?: ComponentType<{ params: PathParams<TPath> }>;\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 * @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 } }\n * });\n *\n * // Route without loader\n * route({\n *   path: \"about\",\n *   component: AboutPage, // Must accept { params: {} }\n * });\n * ```\n */\nexport function route<TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData>,\n): OpaqueRouteDefinition;\nexport function route<TPath extends string>(\n  definition: RouteWithoutLoader<TPath>,\n): OpaqueRouteDefinition;\nexport function route<TPath extends string, TData>(\n  definition: RouteWithLoader<TPath, TData> | RouteWithoutLoader<TPath>,\n): OpaqueRouteDefinition {\n  return definition as unknown as OpaqueRouteDefinition;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funstack/router",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1",
   "description": "A modern React router based on the Navigation API",
   "repository": {
     "type": "git",
@@ -29,11 +29,11 @@
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.0",
+    "@testing-library/react": "^16.3.1",
     "@types/react": "^19.0.0",
     "jsdom": "^27.3.0",
     "react": "^19.0.0",
-    "tsdown": "^0.17.2",
+    "tsdown": "^0.18.0",
     "typescript": "^5.7.0",
     "urlpattern-polyfill": "^10.1.0",
     "vitest": "^4.0.15"