@funstack/router 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/index.d.mts

@@ -1,29 +1,133 @@
-import * as react0 from "react";
-import { AnchorHTMLAttributes, ComponentType, ReactNode } from "react";
+import { ComponentType, ReactNode } from "react";
 
+//#region src/route.d.ts
+declare const routeDefinitionSymbol: unique symbol;
+/**
+ * Arguments passed to loader functions.
+ */
+type LoaderArgs = {
+  /** Extracted path parameters */
+  params: Record<string, string>;
+  /** Request object with URL and headers */
+  request: Request;
+  /** AbortSignal for cancellation on navigation */
+  signal: AbortSignal;
+};
+/**
+ * Route definition created by the `route` helper function.
+ */
+interface OpaqueRouteDefinition {
+  [routeDefinitionSymbol]: never;
+  path: string;
+  children?: RouteDefinition[];
+}
+/**
+ * Any route definition defined by user.
+ */
+type RouteDefinition = OpaqueRouteDefinition | {
+  path: string;
+  component?: ComponentType<{}>;
+  children?: RouteDefinition[];
+};
+/**
+ * Route definition with loader - infers TData from loader return type.
+ */
+type RouteWithLoader<TData> = {
+  path: string;
+  loader: (args: LoaderArgs) => TData;
+  component: ComponentType<{
+    data: TData;
+  }>;
+  children?: RouteDefinition[];
+};
+/**
+ * Route definition without loader.
+ */
+type RouteWithoutLoader = {
+  path: string;
+  component?: ComponentType;
+  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.
+ *
+ * @example
+ * ```typescript
+ * // Route with async loader
+ * route({
+ *   path: "users/:userId",
+ *   loader: async ({ params, signal }) => {
+ *     const res = await fetch(`/api/users/${params.userId}`, { signal });
+ *     return res.json() as Promise<User>;
+ *   },
+ *   component: UserDetail, // Must accept { data: Promise<User> }
+ * });
+ *
+ * // Route without loader
+ * route({
+ *   path: "about",
+ *   component: AboutPage, // No data prop required
+ * });
+ * ```
+ */
+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;
+//#endregion
 //#region src/types.d.ts
+declare const InternalRouteDefinitionSymbol: unique symbol;
 /**
  * Route definition for the router.
+ * When a loader is defined, the component receives the loader result as a `data` prop.
  */
-type RouteDefinition = {
+type InternalRouteDefinition = {
+  [InternalRouteDefinitionSymbol]: never;
   /** Path pattern to match (e.g., "users/:id") */
   path: string;
-  /** Component to render when this route matches */
-  component?: ComponentType;
   /** Child routes for nested routing */
-  children?: RouteDefinition[];
+  children?: InternalRouteDefinition[];
+  /** Data loader function for this route */
+  loader?: (args: LoaderArgs) => unknown;
+  /** Component to render when this route matches */
+  component?: ComponentType<{
+    data?: unknown;
+  }>;
 };
 /**
  * A matched route with its parameters.
  */
 type MatchedRoute = {
   /** The original route definition */
-  route: RouteDefinition;
+  route: InternalRouteDefinition;
   /** Extracted path parameters */
   params: Record<string, string>;
   /** The matched pathname segment */
   pathname: string;
 };
+/**
+ * A matched route with loader data.
+ */
+type MatchedRouteWithData = MatchedRoute & {
+  /** Data returned from the loader (undefined if no loader) */
+  data: unknown | undefined;
+};
 /**
  * Options for navigation.
  */
@@ -42,43 +146,6 @@ type Location = {
   hash: string;
 };
 //#endregion
-//#region src/Router.d.ts
-type RouterProps = {
-  routes: RouteDefinition[];
-  children?: ReactNode;
-};
-declare function Router({
-  routes,
-  children
-}: RouterProps): ReactNode;
-//#endregion
-//#region src/Link.d.ts
-type LinkProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & {
-  /** The destination URL */
-  to: string;
-  /** Replace current history entry instead of pushing */
-  replace?: boolean;
-  /** State to associate with the navigation */
-  state?: unknown;
-  children?: ReactNode;
-};
-declare const Link: react0.ForwardRefExoticComponent<Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & {
-  /** The destination URL */
-  to: string;
-  /** Replace current history entry instead of pushing */
-  replace?: boolean;
-  /** State to associate with the navigation */
-  state?: unknown;
-  children?: ReactNode;
-} & react0.RefAttributes<HTMLAnchorElement>>;
-//#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
 /**
  * Returns a function for programmatic navigation.
@@ -104,5 +171,5 @@ type SetSearchParams = (params: URLSearchParams | Record<string, string> | ((pre
  */
 declare function useSearchParams(): [URLSearchParams, SetSearchParams];
 //#endregion
-export { Link, type LinkProps, type Location, type MatchedRoute, type NavigateOptions, Outlet, type RouteDefinition, Router, type RouterProps, useLocation, useNavigate, useParams, useSearchParams };
+export { type LoaderArgs, type Location, type MatchedRoute, type MatchedRouteWithData, type NavigateOptions, Outlet, 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/types.ts","../src/Router.tsx","../src/Link.tsx","../src/Outlet.tsx","../src/hooks/useNavigate.ts","../src/hooks/useLocation.ts","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts"],"sourcesContent":[],"mappings":";;;;;;;AAKY,KAAA,eAAA,GAAe;EAYf;EAYA,IAAA,EAAA,MAAA;EAUA;cA9BE;;aAED;ACKb,CAAA;AA4CA;;;AAA6C,KD3CjC,YAAA,GC2CiC;EAAc;EAAS,KAAA,EDzC3D,eCyC2D;;UDvC1D;;EEZE,QAAA,EAAA,MAAS;CACE;;;;AASD,KFUV,eAAA,GEVU;EAGT;EAAI,OAAA,CAAA,EAAA,OAAA;EAAA;EAAA,KAAA,CAAA,EAAA,OAAA;CAHJ;;;;AAGI,KFiBL,QAAA,GEjBK;;;;ACfjB,CAAA;;;KFSY,WAAA;UACF;EDZE,QAAA,CAAA,ECaC,SDbc;AAY3B,CAAA;AAYY,iBC+BI,MAAA,CD/BW;EAAA,MAAA;EAAA;AAAA,CAAA,EC+BkB,WD/BlB,CAAA,EC+BgC,SD/BhC;;;KEpBf,SAAA,GAAY,KACtB,qBAAqB;;;EFLX;EAYA,OAAA,CAAA,EAAA,OAAY;EAYZ;EAUA,KAAA,CAAA,EAAA,OAAQ;aEpBP;;cAGA,aAAI,0BAAA,KAAA,qBAAA;EDNL;EA4CI,EAAA,EAAA,MAAM;EAAG;EAAQ,OAAA,CAAA,EAAA,OAAA;EAAY;EAAc,KAAA,CAAA,EAAA,OAAA;EAAS,QAAA,CAAA,ECzCvD,SDyCuD;;;;;;;ADvDpE;AAYY,iBGVI,MAAA,CAAA,CHYP,EGZiB,SHYjB;;;;;;AAdG,iBIEI,WAAA,CAAA,CJEF,EAAA,CAAA,EAAA,EAAA,MAED,EAAA,OAAe,CAAf,EIJyC,eJI1B,EAAA,GAAA,IAAA;;;;;;AANhB,iBKEI,WAAA,CAAA,CLEF,EKFiB,QLEjB;;;;;;iBMHE,oBACJ,yBAAyB,2BAChC;;;KCLA,eAAA,YAEC,kBACA,iCACQ,oBAAoB,kBAAkB;;;;APFxC,iBOQI,eAAA,CAAA,CPJF,EAAA,COIsB,ePFvB,EOEwC,ePFzB,CAAA"}
+{"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { createContext, forwardRef, useCallback, useContext, useEffect, useMemo, useSyncExternalStore } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
 
 //#region src/context/RouterContext.ts
 const RouterContext = createContext(null);
@@ -8,6 +8,19 @@ const RouterContext = createContext(null);
 //#region src/context/RouteContext.ts
 const RouteContext = createContext(null);
 
+//#endregion
+//#region src/types.ts
+/**
+* Converts user-defined routes to internal route definitions.
+* This function is used internally by the Router.
+*
+* Actually, this function just performs a type assertion since
+* both RouteDefinition and InternalRouteDefinition have the same runtime shape.
+*/
+function internalRoutes(routes) {
+	return routes;
+}
+
 //#endregion
 //#region src/core/matchRoutes.ts
 /**
@@ -15,8 +28,8 @@ const RouteContext = createContext(null);
 * Returns null if no match is found.
 */
 function matchRoutes(routes, pathname) {
-	for (const route of routes) {
-		const matched = matchRoute(route, pathname);
+	for (const route$1 of routes) {
+		const matched = matchRoute(route$1, pathname);
 		if (matched) return matched;
 	}
 	return null;
@@ -24,12 +37,12 @@ function matchRoutes(routes, pathname) {
 /**
 * Match a single route and its children recursively.
 */
-function matchRoute(route, pathname) {
-	const hasChildren = Boolean(route.children?.length);
-	const { matched, params, consumedPathname } = matchPath(route.path, pathname, !hasChildren);
+function matchRoute(route$1, pathname) {
+	const hasChildren = Boolean(route$1.children?.length);
+	const { matched, params, consumedPathname } = matchPath(route$1.path, pathname, !hasChildren);
 	if (!matched) return null;
 	const result = {
-		route,
+		route: route$1,
 		params,
 		pathname: consumedPathname
 	};
@@ -37,7 +50,7 @@ function matchRoute(route, pathname) {
 		let remainingPathname = pathname.slice(consumedPathname.length);
 		if (!remainingPathname.startsWith("/")) remainingPathname = "/" + remainingPathname;
 		if (remainingPathname === "") remainingPathname = "/";
-		for (const child of route.children) {
+		for (const child of route$1.children) {
 			const childMatch = matchRoute(child, remainingPathname);
 			if (childMatch) return [result, ...childMatch.map((m) => ({
 				...m,
@@ -47,7 +60,7 @@ function matchRoute(route, pathname) {
 				}
 			}))];
 		}
-		if (route.component) return [result];
+		if (route$1.component) return [result];
 		return null;
 	}
 	return [result];
@@ -84,7 +97,63 @@ function matchPath(pattern, pathname, exact) {
 }
 
 //#endregion
-//#region src/Router.tsx
+//#region src/core/loaderCache.ts
+/**
+* Cache for loader results.
+* Key format: `${entryId}:${routePath}`
+*/
+const loaderCache = /* @__PURE__ */ new Map();
+/**
+* Get or create a loader result from cache.
+* If the result is not cached, executes the loader and caches the result.
+*/
+function getOrCreateLoaderResult(entryId, route$1, args) {
+	if (!route$1.loader) return;
+	const cacheKey = `${entryId}:${route$1.path}`;
+	if (!loaderCache.has(cacheKey)) loaderCache.set(cacheKey, route$1.loader(args));
+	return loaderCache.get(cacheKey);
+}
+/**
+* Create a Request object for loader args.
+*/
+function createLoaderRequest(url) {
+	return new Request(url.href, { method: "GET" });
+}
+/**
+* Execute loaders for matched routes and return routes with data.
+* Results are cached by navigation entry id to prevent duplicate execution.
+*/
+function executeLoaders(matchedRoutes, entryId, request, signal) {
+	return matchedRoutes.map((match) => {
+		const { route: route$1, params } = match;
+		const data = getOrCreateLoaderResult(entryId, route$1, {
+			params,
+			request,
+			signal
+		});
+		return {
+			...match,
+			data
+		};
+	});
+}
+
+//#endregion
+//#region src/core/navigation.ts
+/**
+* Fallback AbortController for data loading initialized outside of a navigation event.
+* Aborted when the next navigation occurs.
+*
+* To save resources, this controller is created only when needed.
+*/
+let idleController = null;
+/**
+* Get the current abort signal for loader cancellation.
+*/
+function getIdleAbortSignal() {
+	idleController ??= new AbortController();
+	return idleController.signal;
+}
 /**
 * Check if Navigation API is available.
 */
@@ -93,6 +162,7 @@ function hasNavigation() {
 }
 /**
 * Subscribe to Navigation API's currententrychange event.
+* Returns a cleanup function.
 */
 function subscribeToNavigation(callback) {
 	if (!hasNavigation()) return () => {};
@@ -114,42 +184,83 @@ function getNavigationSnapshot() {
 function getServerSnapshot() {
 	return null;
 }
-function Router({ routes, children }) {
+/**
+* Set up navigation interception for client-side routing.
+* Returns a cleanup function.
+*/
+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);
+	};
+}
+/**
+* Navigate to a new URL programmatically.
+*/
+function performNavigation(to, options) {
+	if (!hasNavigation()) return;
+	navigation.navigate(to, {
+		history: options?.replace ? "replace" : "push",
+		state: options?.state
+	});
+}
+
+//#endregion
+//#region src/Router.tsx
+function Router({ routes: inputRoutes }) {
+	const routes = internalRoutes(inputRoutes);
 	const currentEntry = useSyncExternalStore(subscribeToNavigation, getNavigationSnapshot, getServerSnapshot);
 	useEffect(() => {
-		if (!hasNavigation()) return;
-		const handleNavigate = (event) => {
-			if (!event.canIntercept || event.hashChange) return;
-			if (matchRoutes(routes, new URL(event.destination.url).pathname)) event.intercept({ handler: async () => {} });
-		};
-		navigation.addEventListener("navigate", handleNavigate);
-		return () => {
-			if (hasNavigation()) navigation.removeEventListener("navigate", handleNavigate);
-		};
+		return setupNavigationInterception(routes);
 	}, [routes]);
-	const navigate = useCallback((to, options) => {
-		if (!hasNavigation()) return;
-		navigation.navigate(to, {
-			history: options?.replace ? "replace" : "push",
-			state: options?.state
+	const navigate = useCallback((to, options) => performNavigation(to, options), []);
+	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;
+		const matchedRoutesWithData = (() => {
+			const matched = matchRoutes(routes, url.pathname);
+			if (!matched) return null;
+			return executeLoaders(matched, currentEntryId, createLoaderRequest(url), getIdleAbortSignal());
+		})();
+		const routerContextValue = {
+			currentEntry,
+			url,
+			navigate
+		};
+		return /* @__PURE__ */ jsx(RouterContext.Provider, {
+			value: routerContextValue,
+			children: matchedRoutesWithData ? /* @__PURE__ */ jsx(RouteRenderer, {
+				matchedRoutes: matchedRoutesWithData,
+				index: 0
+			}) : null
 		});
-	}, []);
-	const currentUrl = currentEntry?.url;
-	const matchedRoutes = useMemo(() => {
-		if (!currentUrl) return null;
-		return matchRoutes(routes, new URL(currentUrl).pathname);
-	}, [currentUrl, routes]);
-	const routerContextValue = useMemo(() => ({
+	}, [
+		navigate,
 		currentEntry,
-		navigate
-	}), [currentEntry, navigate]);
-	return /* @__PURE__ */ jsxs(RouterContext.Provider, {
-		value: routerContextValue,
-		children: [matchedRoutes ? /* @__PURE__ */ jsx(RouteRenderer, {
-			matchedRoutes,
-			index: 0
-		}) : null, children]
-	});
+		routes
+	]);
 }
 /**
 * Recursively render matched routes with proper context.
@@ -157,8 +268,8 @@ function Router({ routes, children }) {
 function RouteRenderer({ matchedRoutes, index }) {
 	const match = matchedRoutes[index];
 	if (!match) return null;
-	const { route, params, pathname } = match;
-	const Component = route.component;
+	const { route: route$1, params, pathname, data } = match;
+	const Component = route$1.component;
 	const outlet = index < matchedRoutes.length - 1 ? /* @__PURE__ */ jsx(RouteRenderer, {
 		matchedRoutes,
 		index: index + 1
@@ -172,52 +283,17 @@ function RouteRenderer({ matchedRoutes, index }) {
 		pathname,
 		outlet
 	]);
+	const renderComponent = () => {
+		if (!Component) return outlet;
+		if (route$1.loader) return /* @__PURE__ */ jsx(Component, { data });
+		return /* @__PURE__ */ jsx(Component, {});
+	};
 	return /* @__PURE__ */ jsx(RouteContext.Provider, {
 		value: routeContextValue,
-		children: Component ? /* @__PURE__ */ jsx(Component, {}) : outlet
+		children: renderComponent()
 	});
 }
 
-//#endregion
-//#region src/hooks/useNavigate.ts
-/**
-* Returns a function for programmatic navigation.
-*/
-function useNavigate() {
-	const context = useContext(RouterContext);
-	if (!context) throw new Error("useNavigate must be used within a Router");
-	return context.navigate;
-}
-
-//#endregion
-//#region src/Link.tsx
-const Link = forwardRef(function Link$1({ to, replace, state, onClick, children, ...rest }, ref) {
-	const navigate = useNavigate();
-	return /* @__PURE__ */ jsx("a", {
-		ref,
-		href: to,
-		onClick: useCallback((event) => {
-			onClick?.(event);
-			if (event.defaultPrevented) return;
-			if (event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) return;
-			if (event.button !== 0) return;
-			event.preventDefault();
-			navigate(to, {
-				replace,
-				state
-			});
-		}, [
-			navigate,
-			to,
-			replace,
-			state,
-			onClick
-		]),
-		...rest,
-		children
-	});
-});
-
 //#endregion
 //#region src/Outlet.tsx
 /**
@@ -230,6 +306,17 @@ function Outlet() {
 	return routeContext.outlet;
 }
 
+//#endregion
+//#region src/hooks/useNavigate.ts
+/**
+* Returns a function for programmatic navigation.
+*/
+function useNavigate() {
+	const context = useContext(RouterContext);
+	if (!context) throw new Error("useNavigate must be used within a Router");
+	return context.navigate;
+}
+
 //#endregion
 //#region src/hooks/useLocation.ts
 /**
@@ -238,19 +325,14 @@ function Outlet() {
 function useLocation() {
 	const context = useContext(RouterContext);
 	if (!context) throw new Error("useLocation must be used within a Router");
+	const { url } = context;
 	return useMemo(() => {
-		if (!context.currentEntry?.url) return {
-			pathname: "/",
-			search: "",
-			hash: ""
-		};
-		const url = new URL(context.currentEntry.url);
 		return {
 			pathname: url.pathname,
 			search: url.search,
 			hash: url.hash
 		};
-	}, [context.currentEntry?.url]);
+	}, [url]);
 }
 
 //#endregion
@@ -272,13 +354,8 @@ function useParams() {
 function useSearchParams() {
 	const context = useContext(RouterContext);
 	if (!context) throw new Error("useSearchParams must be used within a Router");
-	return [useMemo(() => {
-		if (!context.currentEntry?.url) return new URLSearchParams();
-		return new URL(context.currentEntry.url).searchParams;
-	}, [context.currentEntry?.url]), useCallback((params) => {
-		const currentUrl = context.currentEntry?.url;
-		if (!currentUrl) return;
-		const url = new URL(currentUrl);
+	return [context.url.searchParams, useCallback((params) => {
+		const url = new URL(context.url);
 		let newParams;
 		if (typeof params === "function") {
 			const result = params(new URLSearchParams(url.search));
@@ -291,5 +368,11 @@ function useSearchParams() {
 }
 
 //#endregion
-export { Link, Outlet, Router, useLocation, useNavigate, useParams, useSearchParams };
+//#region src/route.ts
+function route(definition) {
+	return definition;
+}
+
+//#endregion
+export { Outlet, Router, route, useLocation, useNavigate, useParams, useSearchParams };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["result: MatchedRoute","urlPatternPath: string","params: Record<string, string>","consumedPathname: string","Link","newParams: URLSearchParams"],"sources":["../src/context/RouterContext.ts","../src/context/RouteContext.ts","../src/core/matchRoutes.ts","../src/Router.tsx","../src/hooks/useNavigate.ts","../src/Link.tsx","../src/Outlet.tsx","../src/hooks/useLocation.ts","../src/hooks/useParams.ts","../src/hooks/useSearchParams.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { NavigateOptions } from \"../types.js\";\n\nexport type RouterContextValue = {\n  /** Current navigation entry */\n  currentEntry: NavigationHistoryEntry | null;\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 { RouteDefinition, 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: RouteDefinition[],\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: RouteDefinition,\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 {\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 type {\n  RouteDefinition,\n  NavigateOptions,\n  MatchedRoute,\n} from \"./types.js\";\nimport { matchRoutes } from \"./core/matchRoutes.js\";\n\nexport type RouterProps = {\n  routes: RouteDefinition[];\n  children?: ReactNode;\n};\n\n/**\n * Check if Navigation API is available.\n */\nfunction hasNavigation(): boolean {\n  return typeof navigation !== \"undefined\";\n}\n\n/**\n * Subscribe to Navigation API's currententrychange event.\n */\nfunction 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 */\nfunction 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 */\nfunction getServerSnapshot(): null {\n  return null;\n}\n\nexport function Router({ routes, children }: RouterProps): ReactNode {\n  const currentEntry = useSyncExternalStore(\n    subscribeToNavigation,\n    getNavigationSnapshot,\n    getServerSnapshot,\n  );\n\n  // Set up navigation interception\n  useEffect(() => {\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        event.intercept({\n          handler: async () => {\n            // Navigation will complete and currententrychange will fire\n          },\n        });\n      }\n    };\n\n    navigation.addEventListener(\"navigate\", handleNavigate);\n    return () => {\n      if (hasNavigation()) {\n        navigation.removeEventListener(\"navigate\", handleNavigate);\n      }\n    };\n  }, [routes]);\n\n  // Navigate function for programmatic navigation\n  const navigate = useCallback((to: string, options?: NavigateOptions) => {\n    if (!hasNavigation()) {\n      return;\n    }\n    navigation.navigate(to, {\n      history: options?.replace ? \"replace\" : \"push\",\n      state: options?.state,\n    });\n  }, []);\n\n  // Match current URL against routes\n  const currentUrl = currentEntry?.url;\n  const matchedRoutes = useMemo(() => {\n    if (!currentUrl) return null;\n    const url = new URL(currentUrl);\n    return matchRoutes(routes, url.pathname);\n  }, [currentUrl, routes]);\n\n  const routerContextValue = useMemo(\n    () => ({ currentEntry, navigate }),\n    [currentEntry, navigate],\n  );\n\n  return (\n    <RouterContext.Provider value={routerContextValue}>\n      {matchedRoutes ? (\n        <RouteRenderer matchedRoutes={matchedRoutes} index={0} />\n      ) : null}\n      {children}\n    </RouterContext.Provider>\n  );\n}\n\ntype RouteRendererProps = {\n  matchedRoutes: MatchedRoute[];\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 } = 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  return (\n    <RouteContext.Provider value={routeContextValue}>\n      {Component ? <Component /> : outlet}\n    </RouteContext.Provider>\n  );\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 {\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n  type ReactNode,\n  forwardRef,\n  useCallback,\n} from \"react\";\nimport { useNavigate } from \"./hooks/useNavigate.js\";\n\nexport type LinkProps = Omit<\n  AnchorHTMLAttributes<HTMLAnchorElement>,\n  \"href\"\n> & {\n  /** The destination URL */\n  to: string;\n  /** Replace current history entry instead of pushing */\n  replace?: boolean;\n  /** State to associate with the navigation */\n  state?: unknown;\n  children?: ReactNode;\n};\n\nexport const Link = forwardRef<HTMLAnchorElement, LinkProps>(function Link(\n  { to, replace, state, onClick, children, ...rest },\n  ref,\n) {\n  const navigate = useNavigate();\n\n  const handleClick = useCallback(\n    (event: MouseEvent<HTMLAnchorElement>) => {\n      // Call user's onClick handler if provided\n      onClick?.(event);\n\n      // Don't handle if default was prevented\n      if (event.defaultPrevented) return;\n\n      // Don't handle modified clicks (new tab, etc.)\n      if (event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) {\n        return;\n      }\n\n      // Don't handle right clicks\n      if (event.button !== 0) return;\n\n      // Prevent default and navigate via Navigation API\n      event.preventDefault();\n      navigate(to, { replace, state });\n    },\n    [navigate, to, replace, state, onClick],\n  );\n\n  return (\n    <a ref={ref} href={to} onClick={handleClick} {...rest}>\n      {children}\n    </a>\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, 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  return useMemo(() => {\n    if (!context.currentEntry?.url) {\n      return { pathname: \"/\", search: \"\", hash: \"\" };\n    }\n\n    const url = new URL(context.currentEntry.url);\n    return {\n      pathname: url.pathname,\n      search: url.search,\n      hash: url.hash,\n    };\n  }, [context.currentEntry?.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 = useMemo(() => {\n    if (!context.currentEntry?.url) {\n      return new URLSearchParams();\n    }\n    const url = new URL(context.currentEntry.url);\n    return url.searchParams;\n  }, [context.currentEntry?.url]);\n\n  const setSearchParams = useCallback<SetSearchParams>(\n    (params) => {\n      const currentUrl = context.currentEntry?.url;\n      if (!currentUrl) return;\n\n      const url = new URL(currentUrl);\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"],"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/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":";;;;AAYA,MAAa,gBAAgB,cAAyC,KAAK;;;;ACD3E,MAAa,eAAe,cAAwC,KAAK;;;;;;;;;;;ACqBzE,SAAgB,eACd,QAC2B;AAC3B,QAAO;;;;;;;;;AC7BT,SAAgB,YACd,QACA,UACuB;AACvB,MAAK,MAAMA,WAAS,QAAQ;EAC1B,MAAM,UAAU,WAAWA,SAAO,SAAS;AAC3C,MAAI,QACF,QAAO;;AAGX,QAAO;;;;;AAMT,SAAS,WACP,SACA,UACuB;CACvB,MAAM,cAAc,QAAQA,QAAM,UAAU,OAAO;CAInD,MAAM,EAAE,SAAS,QAAQ,qBAAqB,UAC5CA,QAAM,MACN,UACA,CAAC,YACF;AAED,KAAI,CAAC,QACH,QAAO;CAGT,MAAMC,SAAuB;EAC3B;EACA;EACA,UAAU;EACX;AAGD,KAAI,aAAa;EAEf,IAAI,oBAAoB,SAAS,MAAM,iBAAiB,OAAO;AAC/D,MAAI,CAAC,kBAAkB,WAAW,IAAI,CACpC,qBAAoB,MAAM;AAE5B,MAAI,sBAAsB,GACxB,qBAAoB;AAGtB,OAAK,MAAM,SAASD,QAAM,UAAW;GACnC,MAAM,aAAa,WAAW,OAAO,kBAAkB;AACvD,OAAI,WAEF,QAAO,CACL,QACA,GAAG,WAAW,KAAK,OAAO;IACxB,GAAG;IACH,QAAQ;KAAE,GAAG;KAAQ,GAAG,EAAE;KAAQ;IACnC,EAAE,CACJ;;AAKL,MAAIA,QAAM,UACR,QAAO,CAAC,OAAO;AAGjB,SAAO;;AAGT,QAAO,CAAC,OAAO;;;;;AAMjB,SAAS,UACP,SACA,UACA,OAKA;CAEA,MAAM,oBAAoB,QAAQ,WAAW,IAAI,GAAG,UAAU,IAAI;CAGlE,IAAIE;AACJ,KAAI,MACF,kBAAiB;UACR,sBAAsB,IAE/B,kBAAiB;KAGjB,kBAAiB,GAAG,kBAAkB;CAKxC,MAAM,QAFa,IAAI,WAAW,EAAE,UAAU,gBAAgB,CAAC,CAEtC,KAAK,EAAE,UAAU,CAAC;AAC3C,KAAI,CAAC,MACH,QAAO;EAAE,SAAS;EAAO,QAAQ,EAAE;EAAE,kBAAkB;EAAI;CAI7D,MAAMC,SAAiC,EAAE;AACzC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,SAAS,OAAO,CAC9D,KAAI,UAAU,UAAa,QAAQ,IACjC,QAAO,OAAO;CAKlB,IAAIC;AACJ,KAAI,MACF,oBAAmB;UACV,sBAAsB,IAE/B,oBAAmB;MACd;EAEL,MAAM,kBAAkB,kBAAkB,MAAM,IAAI,CAAC,OAAO,QAAQ;AAEpE,qBACE,MAFuB,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ,CAEnC,MAAM,GAAG,gBAAgB,OAAO,CAAC,KAAK,IAAI;;AAGrE,QAAO;EAAE,SAAS;EAAM;EAAQ;EAAkB;;;;;;;;;AChIpD,MAAM,8BAAc,IAAI,KAAsB;;;;;AAM9C,SAAS,wBACP,SACA,SACA,MACqB;AACrB,KAAI,CAACC,QAAM,OACT;CAGF,MAAM,WAAW,GAAG,QAAQ,GAAGA,QAAM;AAErC,KAAI,CAAC,YAAY,IAAI,SAAS,CAC5B,aAAY,IAAI,UAAUA,QAAM,OAAO,KAAK,CAAC;AAG/C,QAAO,YAAY,IAAI,SAAS;;;;;AAMlC,SAAgB,oBAAoB,KAAmB;AACrD,QAAO,IAAI,QAAQ,IAAI,MAAM,EAC3B,QAAQ,OACT,CAAC;;;;;;AAOJ,SAAgB,eACd,eACA,SACA,SACA,QACwB;AACxB,QAAO,cAAc,KAAK,UAAU;EAClC,MAAM,EAAE,gBAAO,WAAW;EAE1B,MAAM,OAAO,wBAAwB,SAASA,SADrB;GAAE;GAAQ;GAAS;GAAQ,CACM;AAE1D,SAAO;GAAE,GAAG;GAAO;GAAM;GACzB;;;;;;;;;;;AClDJ,IAAIC,iBAAyC;;;;AAK7C,SAAgB,qBAAkC;AAChD,oBAAmB,IAAI,iBAAiB;AACxC,QAAO,eAAe;;;;;AAcxB,SAAgB,gBAAyB;AACvC,QAAO,OAAO,eAAe;;;;;;AAO/B,SAAgB,sBAAsB,UAAkC;AACtE,KAAI,CAAC,eAAe,CAClB,cAAa;AAEf,YAAW,iBAAiB,sBAAsB,SAAS;AAC3D,cAAa;AACX,MAAI,eAAe,CACjB,YAAW,oBAAoB,sBAAsB,SAAS;;;;;;AAQpE,SAAgB,wBAAuD;AACrE,KAAI,CAAC,eAAe,CAClB,QAAO;AAET,QAAO,WAAW;;;;;AAMpB,SAAgB,oBAA0B;AACxC,QAAO;;;;;;AAOT,SAAgB,4BACd,QACY;AACZ,KAAI,CAAC,eAAe,CAClB,cAAa;CAGf,MAAM,kBAAkB,UAAyB;AAE/C,MAAI,CAAC,MAAM,gBAAgB,MAAM,WAC/B;EAIF,MAAM,MAAM,IAAI,IAAI,MAAM,YAAY,IAAI;EAC1C,MAAM,UAAU,YAAY,QAAQ,IAAI,SAAS;AAEjD,MAAI,SAAS;AAEX,OAAI,gBAAgB;AAClB,mBAAe,OAAO;AACtB,qBAAiB;;AAGnB,SAAM,UAAU,EACd,SAAS,YAAY;IACnB,MAAM,UAAU,oBAAoB,IAAI;IAKxC,MAAM,eAAe,WAAW;AAChC,QAAI,CAAC,aACH,OAAM,IAAI,MACR,iEACD;IAGH,MAAM,UAAU,eACd,SACA,aAAa,IACb,SACA,MAAM,OACP;AAGD,UAAM,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,KAAK,CAAC;MAEhD,CAAC;;;AAIN,YAAW,iBAAiB,YAAY,eAAe;AACvD,cAAa;AACX,MAAI,eAAe,CACjB,YAAW,oBAAoB,YAAY,eAAe;;;;;;AAQhE,SAAgB,kBAAkB,IAAY,SAAiC;AAC7E,KAAI,CAAC,eAAe,CAClB;AAEF,YAAW,SAAS,IAAI;EACtB,SAAS,SAAS,UAAU,YAAY;EACxC,OAAO,SAAS;EACjB,CAAC;;;;;AChHJ,SAAgB,OAAO,EAAE,QAAQ,eAAuC;CACtE,MAAM,SAAS,eAAe,YAAY;CAE1C,MAAM,eAAe,qBACnB,uBACA,uBACA,kBACD;AAGD,iBAAgB;AACd,SAAO,4BAA4B,OAAO;IACzC,CAAC,OAAO,CAAC;CAGZ,MAAM,WAAW,aACd,IAAY,YAA8B,kBAAkB,IAAI,QAAQ,EACzE,EAAE,CACH;AAED,QAAO,cAAc;AACnB,MAAI,iBAAiB,KAGnB,QAAO;EAET,MAAM,aAAa,aAAa;AAChC,MAAI,eAAe,KAEjB,QAAO;EAGT,MAAM,MAAM,IAAI,IAAI,WAAW;EAC/B,MAAM,iBAAiB,aAAa;EAEpC,MAAM,+BAA+B;GACnC,MAAM,UAAU,YAAY,QAAQ,IAAI,SAAS;AACjD,OAAI,CAAC,QAAS,QAAO;AAKrB,UAAO,eAAe,SAAS,gBAFf,oBAAoB,IAAI,EACzB,oBAAoB,CAC4B;MAC7D;EAEJ,MAAM,qBAAqB;GAAE;GAAc;GAAK;GAAU;AAE1D,SACE,oBAAC,cAAc;GAAS,OAAO;aAC5B,wBACC,oBAAC;IAAc,eAAe;IAAuB,OAAO;KAAK,GAC/D;IACmB;IAE1B;EAAC;EAAU;EAAc;EAAO,CAAC;;;;;AAWtC,SAAS,cAAc,EACrB,eACA,SACgC;CAChC,MAAM,QAAQ,cAAc;AAC5B,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,EAAE,gBAAO,QAAQ,UAAU,SAAS;CAC1C,MAAM,YAAYC,QAAM;CAGxB,MAAM,SACJ,QAAQ,cAAc,SAAS,IAC7B,oBAAC;EAA6B;EAAe,OAAO,QAAQ;GAAK,GAC/D;CAEN,MAAM,oBAAoB,eACjB;EAAE;EAAQ,aAAa;EAAU;EAAQ,GAChD;EAAC;EAAQ;EAAU;EAAO,CAC3B;CAGD,MAAM,wBAAwB;AAC5B,MAAI,CAAC,UAAW,QAAO;AAKvB,MAAIA,QAAM,OAIR,QAAO,oBAHmB,aAGM,OAAQ;AAG1C,SAAO,oBADsB,cACE;;AAGjC,QACE,oBAAC,aAAa;EAAS,OAAO;YAC3B,iBAAiB;GACI;;;;;;;;;ACjI5B,SAAgB,SAAoB;CAClC,MAAM,eAAe,WAAW,aAAa;AAE7C,KAAI,CAAC,aACH,QAAO;AAGT,QAAO,aAAa;;;;;;;;ACPtB,SAAgB,cAA+D;CAC7E,MAAM,UAAU,WAAW,cAAc;AAEzC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,2CAA2C;AAG7D,QAAO,QAAQ;;;;;;;;ACPjB,SAAgB,cAAwB;CACtC,MAAM,UAAU,WAAW,cAAc;AAEzC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,2CAA2C;CAG7D,MAAM,EAAE,QAAQ;AAEhB,QAAO,cAAc;AACnB,SAAO;GACL,UAAU,IAAI;GACd,QAAQ,IAAI;GACZ,MAAM,IAAI;GACX;IACA,CAAC,IAAI,CAAC;;;;;;;;AChBX,SAAgB,YAET;CACL,MAAM,UAAU,WAAW,aAAa;AAExC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,yCAAyC;AAG3D,QAAO,QAAQ;;;;;;;;ACFjB,SAAgB,kBAAsD;CACpE,MAAM,UAAU,WAAW,cAAc;AAEzC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,+CAA+C;AA4BjE,QAAO,CAzBc,QAAQ,IAAI,cAET,aACrB,WAAW;EACV,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;EAEhC,IAAIC;AACJ,MAAI,OAAO,WAAW,YAAY;GAChC,MAAM,SAAS,OAAO,IAAI,gBAAgB,IAAI,OAAO,CAAC;AACtD,eACE,kBAAkB,kBACd,SACA,IAAI,gBAAgB,OAAO;aACxB,kBAAkB,gBAC3B,aAAY;MAEZ,aAAY,IAAI,gBAAgB,OAAO;AAGzC,MAAI,SAAS,UAAU,UAAU;AACjC,UAAQ,SAAS,IAAI,WAAW,IAAI,SAAS,IAAI,MAAM,EAAE,SAAS,MAAM,CAAC;IAE3E,CAAC,QAAQ,CACV,CAEqC;;;;;ACyCxC,SAAgB,MACd,YACuB;AACvB,QAAO"}

package/package.json

@@ -1,30 +1,22 @@
 {
   "name": "@funstack/router",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.2",
   "description": "A modern React router based on the Navigation API",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/uhyo/funstack-router.git"
+    "url": "git+https://github.com/uhyo/funstack-router.git",
+    "directory": "packages/router"
   },
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     }
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
-  },
   "keywords": [
     "react",
     "router",
@@ -40,11 +32,17 @@
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.0.0",
     "jsdom": "^27.3.0",
-    "prettier": "^3.7.4",
     "react": "^19.0.0",
     "tsdown": "^0.17.2",
     "typescript": "^5.7.0",
     "urlpattern-polyfill": "^10.1.0",
     "vitest": "^4.0.15"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/README.md

@@ -1,225 +0,0 @@
-# FUNSTACK Router
-
-A modern React router built on the [Navigation API](https://developer.mozilla.org/en-US/docs/Web/API/Navigation_API).
-
-> **Warning**
-> This project is in early development and is not ready for production use. APIs may change without notice.
-
-## Features
-
-- **Navigation API based** - Uses the modern Navigation API instead of the History API
-- **Object-based routes** - Define routes as plain JavaScript objects
-- **Nested routing** - Support for layouts and nested routes with `<Outlet>`
-- **Type-safe** - Full TypeScript support
-- **Lightweight** - ~2.5 kB gzipped
-
-## Installation
-
-```bash
-npm install @funstack/router
-```
-
-## Quick Start
-
-```tsx
-import { Router, Link, Outlet, useParams } from "@funstack/router";
-import type { RouteDefinition } from "@funstack/router";
-
-function Layout() {
-  return (
-    <div>
-      <nav>
-        <Link to="/">Home</Link>
-        <Link to="/users">Users</Link>
-      </nav>
-      <Outlet />
-    </div>
-  );
-}
-
-function Home() {
-  return <h1>Home</h1>;
-}
-
-function Users() {
-  return <h1>Users</h1>;
-}
-
-function UserDetail() {
-  const { id } = useParams<{ id: string }>();
-  return <h1>User {id}</h1>;
-}
-
-const routes: RouteDefinition[] = [
-  {
-    path: "/",
-    component: Layout,
-    children: [
-      { path: "", component: Home },
-      { path: "users", component: Users },
-      { path: "users/:id", component: UserDetail },
-    ],
-  },
-];
-
-function App() {
-  return <Router routes={routes} />;
-}
-```
-
-## API Reference
-
-### Components
-
-#### `<Router>`
-
-The root component that provides routing context.
-
-```tsx
-<Router routes={routes} />
-```
-
-| Prop       | Type                | Description                                 |
-| ---------- | ------------------- | ------------------------------------------- |
-| `routes`   | `RouteDefinition[]` | Array of route definitions                  |
-| `children` | `ReactNode`         | Optional children rendered alongside routes |
-
-#### `<Link>`
-
-Navigation link component.
-
-```tsx
-<Link to="/users" replace state={{ from: "home" }}>
-  Users
-</Link>
-```
-
-| Prop      | Type      | Description                           |
-| --------- | --------- | ------------------------------------- |
-| `to`      | `string`  | Destination URL                       |
-| `replace` | `boolean` | Replace history entry instead of push |
-| `state`   | `unknown` | State to pass to the destination      |
-
-#### `<Outlet>`
-
-Renders the matched child route. Used in layout components.
-
-```tsx
-function Layout() {
-  return (
-    <div>
-      <nav>...</nav>
-      <Outlet />
-    </div>
-  );
-}
-```
-
-### Hooks
-
-#### `useNavigate()`
-
-Returns a function for programmatic navigation.
-
-```tsx
-const navigate = useNavigate();
-
-// Basic navigation
-navigate("/users");
-
-// With options
-navigate("/users", { replace: true, state: { from: "home" } });
-```
-
-#### `useLocation()`
-
-Returns the current location.
-
-```tsx
-const location = useLocation();
-// { pathname: "/users", search: "?page=1", hash: "#section" }
-```
-
-#### `useParams()`
-
-Returns the current route's path parameters.
-
-```tsx
-// Route: /users/:id
-const { id } = useParams<{ id: string }>();
-```
-
-#### `useSearchParams()`
-
-Returns and allows updating URL search parameters.
-
-```tsx
-const [searchParams, setSearchParams] = useSearchParams();
-
-// Read
-const page = searchParams.get("page");
-
-// Update
-setSearchParams({ page: "2" });
-
-// Update with function
-setSearchParams((prev) => {
-  prev.set("page", "2");
-  return prev;
-});
-```
-
-### Types
-
-#### `RouteDefinition`
-
-```typescript
-type RouteDefinition = {
-  path: string;
-  component?: React.ComponentType;
-  children?: RouteDefinition[];
-};
-```
-
-#### `Location`
-
-```typescript
-type Location = {
-  pathname: string;
-  search: string;
-  hash: string;
-};
-```
-
-#### `NavigateOptions`
-
-```typescript
-type NavigateOptions = {
-  replace?: boolean;
-  state?: unknown;
-};
-```
-
-## Path Patterns
-
-FUNSTACK Router uses the [URLPattern API](https://developer.mozilla.org/en-US/docs/Web/API/URLPattern) for path matching.
-
-| Pattern      | Example        | Matches         |
-| ------------ | -------------- | --------------- |
-| `/users`     | `/users`       | Exact match     |
-| `/users/:id` | `/users/123`   | Named parameter |
-| `/files/*`   | `/files/a/b/c` | Wildcard        |
-
-## Browser Support
-
-The Navigation API is supported in:
-
-- Chrome 102+
-- Edge 102+
-- Opera 88+
-
-Firefox and Safari do not yet support the Navigation API. For these browsers, consider using a polyfill.
-
-## License
-
-MIT