@kasperrt/smolter 0.4.3 → 0.4.4

package/dist/react/document.js

@@ -0,0 +1,169 @@
+import { serializeData } from "../core/serialize.js";
+import { useSnapshot } from "./context.js";
+import { applicationEnvironment } from "../core/environment.js";
+import { scrollPositions } from "../core/navigation.js";
+import { useNavigationSnapshot } from "./navigation-state.js";
+import { useApplication } from "./root-context.js";
+import { Fragment, createElement, useEffect, useLayoutEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region .generated/react/document.tsx
+/**
+* React document metadata, resource links and hydration scripts.
+*
+* @module
+*/
+/** @jsxImportSource react */
+function renderMeta(item, index) {
+	if (typeof item.title === "string") return /* @__PURE__ */ jsx("title", { children: item.title }, index);
+	if ("script:ld+json" in item) return /* @__PURE__ */ jsx("script", {
+		type: "application/ld+json",
+		dangerouslySetInnerHTML: { __html: serializeData(item["script:ld+json"]) }
+	}, index);
+	const { tagName, ...props } = item;
+	return createElement(tagName === "link" ? "link" : "meta", {
+		...props,
+		key: index
+	});
+}
+/** Render root or active-route metadata in the document head. */
+function Meta() {
+	const { routes, rootModule } = useApplication();
+	const snapshot = useSnapshot();
+	const route = routes.find((item) => item.path === snapshot.path);
+	const args = {
+		loaderData: snapshot.data,
+		data: snapshot.data,
+		params: snapshot.params,
+		error: snapshot.error,
+		location: new URL(snapshot.url)
+	};
+	const values = route?.meta?.(args) ?? rootModule?.meta?.(args) ?? [];
+	useEffect(() => {
+		const title = values.find((item) => typeof item.title === "string")?.title;
+		if (typeof title === "string") document.title = title;
+	}, [values]);
+	return /* @__PURE__ */ jsx(Fragment, { children: values.map(renderMeta) });
+}
+/** Render stylesheet and other link descriptors from the application root. */
+function Links() {
+	const { rootModule } = useApplication();
+	return /* @__PURE__ */ jsx(Fragment, { children: rootModule?.links?.().map((props, index) => /* @__PURE__ */ jsx("link", { ...props }, index)) });
+}
+/** Render the hydration snapshot and browser entry script with an optional CSP nonce. */
+function Scripts({ nonce }) {
+	const { root, rootError, router, entry, streaming, initialData } = useApplication();
+	const [json] = useState(() => {
+		if (initialData !== void 0) return initialData;
+		if (streaming) return "";
+		const current = router.getSnapshot();
+		const snapshot = {
+			...current,
+			error: current.error && {
+				...current.error,
+				name: current.error.name,
+				message: current.error.message
+			}
+		};
+		return serializeData({
+			root,
+			snapshot,
+			...rootError && { rootError }
+		});
+	});
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx("script", {
+			...nonce && { nonce },
+			dangerouslySetInnerHTML: { __html: applicationEnvironment?.entryScript ?? "" }
+		}),
+		/* @__PURE__ */ jsx("script", {
+			id: "smolter-data",
+			type: "application/json",
+			...nonce && { nonce },
+			dangerouslySetInnerHTML: { __html: json }
+		}),
+		entry && /* @__PURE__ */ jsx("script", {
+			type: "module",
+			async: initialData !== void 0,
+			src: entry,
+			...nonce && { nonce }
+		})
+	] });
+}
+/** Reset scroll after navigation unless the navigation requests preservation. */
+function ScrollRestoration(_props) {
+	const { router } = useApplication();
+	const { url, state } = useSnapshot();
+	const navigation = useNavigationSnapshot(router);
+	const positions = scrollPositions(router);
+	const restoredLocation = useRef("");
+	useEffect(() => {
+		const previous = history.scrollRestoration;
+		history.scrollRestoration = "manual";
+		return () => {
+			history.scrollRestoration = previous;
+		};
+	}, []);
+	useLayoutEffect(() => {
+		if (state !== "idle") return;
+		if ((history.state?.key ?? "initial") !== navigation.key) return;
+		const locationKey = `${navigation.key}:${url}`;
+		if (restoredLocation.current === locationKey) return;
+		const frame = requestAnimationFrame(() => {
+			restoredLocation.current = locationKey;
+			const target = new URL(location.href);
+			const saved = navigation.type === "POP" && positions.get(navigation.key);
+			if (!saved && target.hash) {
+				document.getElementById(target.hash.slice(1))?.scrollIntoView();
+				return;
+			}
+			if (!saved && navigation.preventScrollReset) return;
+			const [left, top] = saved || [0, 0];
+			window.scrollTo({
+				left,
+				top,
+				behavior: "instant"
+			});
+		});
+		return () => cancelAnimationFrame(frame);
+	}, [
+		url,
+		state,
+		positions,
+		navigation.key,
+		navigation.type,
+		navigation.preventScrollReset
+	]);
+	return null;
+}
+/** Render the server document and preserve client-managed theme classes on hydration. */
+function Document(props) {
+	const { children, ...attributes } = props;
+	const className = String(props.className ?? "");
+	const previousClassName = useRef(className);
+	const lang = String(props.lang ?? "en");
+	const debug = String(props["data-debug"] ?? false);
+	useEffect(() => {
+		if (previousClassName.current !== className) {
+			const previous = previousClassName.current.split(/\s+/).filter(Boolean);
+			const next = className.split(/\s+/).filter(Boolean);
+			document.documentElement.classList.remove(...previous);
+			document.documentElement.classList.add(...next);
+			previousClassName.current = className;
+		}
+		document.documentElement.lang = lang;
+		document.documentElement.dataset.debug = debug;
+	}, [
+		className,
+		lang,
+		debug
+	]);
+	const classes = typeof document !== "undefined" && previousClassName.current !== className ? [...document.documentElement.classList].filter((value) => !previousClassName.current.split(/\s+/).includes(value)).concat(className.split(/\s+/).filter(Boolean)).join(" ") : props.className;
+	return /* @__PURE__ */ jsx("html", {
+		...attributes,
+		className: classes,
+		suppressHydrationWarning: true,
+		children
+	});
+}
+//#endregion
+export { Document, Links, Meta, Scripts, ScrollRestoration };

package/dist/react/fetcher.d.ts

@@ -2,11 +2,13 @@
  * React components and typed data hooks. Import from @kasperrt/smolter/react.
  * @module
  */
-import { type AnyDataFunction, type DataFunction, type DataOf, type FetcherSnapshot, type Result, type Route as RouteDefinition, type RouteModule, type SubmitOptions } from "../core/index.ts";
+import { type AnyDataFunction, type DataFunction, type DataOf, type FetcherSnapshot, type Result, type Route as RouteDefinition, type RouteModule } from "../core/index.ts";
+import { type Submission, type SubmissionOptions } from "../core/submission.ts";
 import { type FormProps } from "./form.ts";
+import type { RouteData } from "./route-types.ts";
 import { type ComponentType } from "./runtime.ts";
 /** Action method and optional explicit route URL for a fetcher submission. */
-export interface FetcherSubmitOptions extends SubmitOptions {
+export interface FetcherSubmitOptions extends SubmissionOptions {
     action?: string;
 }
 /** Typed independent request state, methods, and a bound Form component. */
@@ -14,9 +16,11 @@ export interface TypedFetcher<T> extends Omit<FetcherSnapshot, "data"> {
     data?: T;
     Form: ComponentType<FormProps>;
     load: (url?: string) => Promise<Result>;
-    submit: (body: FormData, options?: FetcherSubmitOptions) => Promise<Result>;
+    submit: (body: Submission, options?: FetcherSubmitOptions) => Promise<Result>;
 }
 /** Create a fetcher for independent route reads and mutations; its data stays local. */
 export declare function useFetcher<T extends RouteModule>(route: RouteDefinition<T>): TypedFetcher<DataOf<Extract<T["action"] | T["clientAction"], AnyDataFunction>> | DataOf<Extract<T["loader"] | T["clientLoader"], AnyDataFunction>>>;
 /** Create a fetcher for independent route reads and mutations; its data stays local. */
-export declare function useFetcher<T extends AnyDataFunction = DataFunction>(): TypedFetcher<DataOf<T>>;
+export declare function useFetcher<T = DataFunction>(): TypedFetcher<RouteData<T>>;
+/** A fetcher with a bound form and inferred result data. */
+export type FetcherWithComponents<T> = TypedFetcher<RouteData<T>>;

package/dist/react/fetcher.js

@@ -1,3 +1,4 @@
+import { submissionBody, submissionSearch } from "../core/submission.js";
 import { createElement, useEffect, useMemo, useSyncExternalStore } from "./runtime.js";
 import { useRouter } from "./context.js";
 import { Form } from "./form.js";
@@ -20,7 +21,17 @@ function useFetcher(route) {
 				fetcher: store
 			}),
 			load: (url) => store.load(url ?? target()),
-			submit: (body, options) => store.submit(options?.action ?? target(), body, options)
+			submit: (body, options = {}) => {
+				const action = options.action ?? target();
+				const data = submissionBody(body, options.encType);
+				const method = options.method?.toUpperCase();
+				if (method === "GET") {
+					const url = new URL(action, router.getSnapshot().url);
+					url.search = submissionSearch(data);
+					return store.load(url.href);
+				}
+				return store.submit(action, data, { method });
+			}
 		};
 	}, [router, path]);
 	useEffect(() => fetcher.dispose, [fetcher]);

package/dist/react/form.js

@@ -1,6 +1,6 @@
+import { submitForm } from "../core/submission.js";
 import { createElement } from "./runtime.js";
 import { useRouter } from "./context.js";
-import { submitForm } from "../core/submission.js";
 //#region .generated/react/form.ts
 /** Submit form data to a registered route without a document reload. */
 function Form(options) {

package/dist/react/hooks.d.ts

@@ -2,19 +2,20 @@
  * React components and typed data hooks. Import from @kasperrt/smolter/react.
  * @module
  */
-import type { AnyDataFunction, DataOf, RouteModule, Router, Snapshot } from "../core/index.ts";
+import type { AnyDataFunction, RouteModule, Router, Snapshot } from "../core/index.ts";
+import type { RouteData } from "./route-types.ts";
 /** A route module or loader function used for data inference. */
 export type LoaderSource = RouteModule | AnyDataFunction;
 /** Infer server and client loader data from a route module or function. */
-export type LoaderData<T> = T extends AnyDataFunction ? DataOf<T> : T extends RouteModule ? DataOf<Extract<T["loader"] | T["clientLoader"], AnyDataFunction>> : unknown;
+export type LoaderData<T> = T extends AnyDataFunction ? RouteData<T> : T extends RouteModule ? RouteData<Extract<T["loader"] | T["clientLoader"], AnyDataFunction>> : RouteData<T>;
 /** Infer server and client action data from a route module or function. */
-export type ActionData<T> = T extends AnyDataFunction ? DataOf<T> : T extends RouteModule ? DataOf<Extract<T["action"] | T["clientAction"], AnyDataFunction>> : unknown;
+export type ActionData<T> = T extends AnyDataFunction ? RouteData<T> : T extends RouteModule ? RouteData<Extract<T["action"] | T["clientAction"], AnyDataFunction>> : RouteData<T>;
 /** Pass a route for inference, or use useLoaderData<typeof loader>() in its module. */
-export declare function useLoaderData<T extends LoaderSource = RouteModule>(route?: T): LoaderData<T> | undefined;
+export declare function useLoaderData<T = RouteModule>(route?: T & LoaderSource): LoaderData<T>;
 /** Read the last page action result, optionally inferring its type from a route. */
-export declare function useActionData<T extends LoaderSource = RouteModule>(route?: T): ActionData<T> | undefined;
+export declare function useActionData<T = RouteModule>(route?: T & LoaderSource): ActionData<T> | undefined;
 /** Read path parameters for the active route. */
-export declare function useParams(): Snapshot["params"];
+export declare function useParams<T extends Snapshot["params"] = Snapshot["params"]>(): T;
 /** Read the current path, search, and hash together with the navigate function. */
 export declare function useLocation(): readonly [string, Router["navigate"]];
 /** Get the function that revalidates the current loader subject to shouldRevalidate. */

package/dist/react/index.d.ts

@@ -5,10 +5,16 @@
  */
 export type * from "../core/index.ts";
 export { createDataRouter, createRouter, defineRoute, } from "../core/index.ts";
+export type { ApplicationEnvironment } from "../core/environment.ts";
+export * from "../core/responses.ts";
+export { readSubmission, type Submission, type SubmissionOptions, } from "../core/submission.ts";
 export { RouterProvider, type RouterProviderProps, useRouter, } from "./context.ts";
 export * from "./fetcher.ts";
 export * from "./form.ts";
 export * from "./hooks.ts";
-export * from "./link.ts";
+export * from "./navigation.ts";
 export { Outlet, type OutletProps, useMatches, useOutletContext, } from "./outlet.ts";
+export { useNavigation, useRootData, useRouteError, useRouteLoaderData, useSubmit, } from "./route-hooks.ts";
+export * from "./route-types.ts";
+export { type ApplicationProps, RouterApplication } from "./router.ts";
 export * from "./routes.ts";

package/dist/react/index.js

@@ -1,11 +1,15 @@
 import { defineRoute } from "../core/match.js";
 import { createRouter } from "../core/navigation-router.js";
 import { createDataRouter } from "../core/router.js";
+import { data, isRouteErrorResponse, normalizeResult, redirect, resolveData } from "../core/responses.js";
+import { readSubmission } from "../core/submission.js";
 import { RouterProvider, useRouter } from "./context.js";
 import { Form } from "./form.js";
 import { useFetcher } from "./fetcher.js";
 import { useActionData, useLoaderData, useLocation, useParams, useRevalidator } from "./hooks.js";
-import { Link } from "./link.js";
+import { useNavigate, useNavigation, useNavigationType, useRootData, useRouteError, useRouteLoaderData, useSearchParams, useSubmit, useURLLocation } from "./route-hooks.js";
+import { Link, NavLink } from "./navigation.js";
 import { Routes } from "./routes.js";
 import { Outlet, useMatches, useOutletContext } from "./outlet.js";
-export { Form, Link, Outlet, RouterProvider, Routes, createDataRouter, createRouter, defineRoute, useActionData, useFetcher, useLoaderData, useLocation, useMatches, useOutletContext, useParams, useRevalidator, useRouter };
+import { RouterApplication } from "./router.js";
+export { Form, Link, NavLink, Outlet, RouterApplication, RouterProvider, Routes, createDataRouter, createRouter, data, defineRoute, isRouteErrorResponse, normalizeResult, readSubmission, redirect, resolveData, useActionData, useFetcher, useLoaderData, useLocation, useMatches, useNavigate, useNavigation, useNavigationType, useOutletContext, useParams, useRevalidator, useRootData, useRouteError, useRouteLoaderData, useRouter, useSearchParams, useSubmit, useURLLocation };

package/dist/react/lazy-route.d.ts

@@ -0,0 +1,22 @@
+import type { RouteModule } from "../core/index.ts";
+import type { AppRoute } from "./route-types.ts";
+import { type ComponentType } from "./runtime.ts";
+/** Lazy route path, server transport endpoint and available handler capabilities. */
+export interface LazyRouteOptions {
+    path: string;
+    dataEndpoint?: string;
+    id?: string;
+    loader?: boolean;
+    action?: boolean;
+    clientAction?: boolean;
+    meta?: boolean;
+    shouldRevalidate?: boolean;
+    ErrorBoundary?: boolean;
+}
+type LoadedRoute = RouteModule & Pick<AppRoute, "meta">;
+interface LazyAppRoute extends AppRoute {
+    resolveComponent: () => ComponentType | undefined;
+}
+/** Create a route that imports its module on demand and shares the import with intent prefetching. */
+export declare function lazyRoute(options: LazyRouteOptions, importer: () => Promise<LoadedRoute>): LazyAppRoute;
+export {};

package/dist/react/lazy-route.js

@@ -0,0 +1,57 @@
+import { createElement, useSyncExternalStore } from "./runtime.js";
+import { useRouter } from "./context.js";
+import { serverRoute } from "../client/index.js";
+//#region .generated/react/lazy-route.ts
+/**
+* On-demand React route modules with shared intent prefetching.
+*
+* @module
+*/
+function LazyView() {
+	const router = useRouter();
+	const { path } = useSyncExternalStore(router.subscribe, router.getSnapshot, router.getSnapshot);
+	const Component = router.routes.find((item) => item.path === path)?.resolveComponent();
+	return Component && createElement(Component, {});
+}
+/** Create a route that imports its module on demand and shares the import with intent prefetching. */
+function lazyRoute(options, importer) {
+	let module;
+	let pending;
+	function preload() {
+		pending ??= importer().then((loaded) => {
+			module = serverRoute(options.path, loaded, {
+				loader: options.loader,
+				action: options.action,
+				dataEndpoint: options.dataEndpoint
+			});
+		}).catch((error) => {
+			pending = void 0;
+			throw error;
+		});
+		return pending;
+	}
+	async function run(args, action = false) {
+		await preload();
+		if (args.signal.aborted) return /* @__PURE__ */ new Error("Navigation cancelled");
+		return (action ? module.clientAction ?? module.action : module.clientLoader ?? module.loader)?.(args);
+	}
+	function ErrorBoundary(props) {
+		const Component = module?.ErrorBoundary;
+		if (!Component) return props.error.message;
+		return createElement(Component, props);
+	}
+	return {
+		path: options.path,
+		id: options.id,
+		preload,
+		default: LazyView,
+		resolveComponent: () => module?.default,
+		clientLoader: (args) => run(args),
+		...(options.action || options.clientAction) && { clientAction: (args) => run(args, true) },
+		...options.meta && { meta: (args) => module?.meta?.(args) ?? [] },
+		...options.shouldRevalidate && { shouldRevalidate: (args) => module?.shouldRevalidate?.(args) ?? true },
+		...options.ErrorBoundary && { ErrorBoundary }
+	};
+}
+//#endregion
+export { lazyRoute };

package/dist/react/link.d.ts

@@ -1,12 +1 @@
-/**
- * React components and typed data hooks. Import from @kasperrt/smolter/react.
- * @module
- */
-import { type AnchorHTMLAttributes, type ReactNode } from "./runtime.ts";
-/** Anchor attributes with internal navigation and optional history replacement. */
-export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
-    href: string;
-    replace?: boolean;
-}
-/** Render an anchor that handles internal navigation and preserves native modified clicks. */
-export declare function Link(options: LinkProps): ReactNode;
+export { Link, type LinkProps } from "./navigation.ts";

package/dist/react/navigation-state.d.ts

@@ -0,0 +1,2 @@
+import type { Router } from "../core/index.ts";
+export declare function useNavigationSnapshot(router: Router): import("../core/navigation.ts").NavigationSnapshot;

package/dist/react/navigation-state.js

@@ -0,0 +1,9 @@
+import { useSyncExternalStore } from "./runtime.js";
+import { navigationStore } from "../core/navigation.js";
+//#region .generated/react/navigation-state.ts
+function useNavigationSnapshot(router) {
+	const store = navigationStore(router);
+	return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
+//#endregion
+export { useNavigationSnapshot };

package/dist/react/navigation.d.ts

@@ -0,0 +1,33 @@
+import { type NavigateOptions } from "../core/index.ts";
+import type { AnchorHTMLAttributes, ReactNode } from "./runtime.ts";
+export type { NavigateOptions } from "../core/index.ts";
+export type { NavigationType } from "../core/navigation.ts";
+/** Navigate to a URL or move through browser history using a numeric offset. */
+export type NavigateFunction = (to: string | number | Partial<Pick<URL, "pathname" | "search" | "hash">>, options?: NavigateOptions) => void;
+/** Anchor properties and router navigation options, including document reload and prefetch controls. */
+export interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    to?: string;
+    href?: string;
+    replace?: boolean;
+    prefetch?: string;
+    state?: unknown;
+    preventScrollReset?: boolean;
+    viewTransition?: boolean;
+    reloadDocument?: boolean;
+}
+/** Active and pending flags supplied to NavLink render callbacks. */
+export interface NavLinkRenderProps {
+    isActive: boolean;
+    isPending: boolean;
+}
+/** Link options with matching rules and state-aware class or children callbacks. */
+export interface NavLinkProps extends Omit<LinkProps, "className" | "children"> {
+    end?: boolean;
+    className?: string | ((state: NavLinkRenderProps) => string);
+    children?: ReactNode | ((state: NavLinkRenderProps) => ReactNode);
+}
+/** Render an anchor with same-origin router navigation and optional intent prefetching. */
+export declare function Link(options: LinkProps): ReactNode;
+/** Render a Link with active-route state and aria-current for the matching destination. */
+export declare function NavLink({ href, to, end, className, children, ...props }: NavLinkProps): ReactNode;
+export { useNavigate, useNavigationType, useSearchParams, useURLLocation, } from "./route-hooks.ts";

package/dist/react/navigation.js

@@ -0,0 +1,64 @@
+import { matchRoutes } from "../core/match.js";
+import { navigationClick } from "../core/url.js";
+import { createElement } from "./runtime.js";
+import { useRouter, useSnapshot } from "./context.js";
+import { handoffDocument, resolveApplicationURL } from "../core/environment.js";
+import { useNavigate, useNavigation, useNavigationType, useSearchParams, useURLLocation } from "./route-hooks.js";
+//#region .generated/react/navigation.ts
+/** Render an anchor with same-origin router navigation and optional intent prefetching. */
+function Link(options) {
+	const { href: hrefProp, to = hrefProp ?? "/", replace, preventScrollReset, viewTransition, prefetch, state, reloadDocument, ...props } = options;
+	const router = useRouter();
+	const current = new URL(useSnapshot("url"));
+	const destination = resolveApplicationURL(new URL(to, current));
+	const internal = destination.origin === current.origin;
+	const preload = () => {
+		(matchRoutes(router.routes, destination.pathname)?.route)?.preload?.().catch(() => {});
+	};
+	if (!reloadDocument && prefetch !== "none" && internal) for (const name of [
+		"onPointerEnter",
+		"onFocus",
+		"onTouchStart"
+	]) {
+		const handler = props[name];
+		props[name] = (event) => {
+			handler?.(event);
+			preload();
+		};
+	}
+	return createElement("a", {
+		...props,
+		href: destination.href,
+		onClick(event) {
+			props.onClick?.(event);
+			if (reloadDocument || !navigationClick(event, event.currentTarget)) return;
+			if (!internal) {
+				handoffDocument(event.nativeEvent, destination);
+				return;
+			}
+			event.preventDefault();
+			router.navigate(destination.href, options);
+		}
+	});
+}
+/** Render a Link with active-route state and aria-current for the matching destination. */
+function NavLink({ href, to = href ?? "/", end, className, children, ...props }) {
+	const location = useURLLocation();
+	const destination = resolveApplicationURL(new URL(to, location.href));
+	const target = destination.pathname;
+	const isActive = destination.origin === location.origin && (location.pathname === target || !end && target !== "/" && location.pathname.startsWith(`${target}/`));
+	const pending = useNavigation().location;
+	const state = {
+		isActive,
+		isPending: !!pending && pending.origin === destination.origin && (pending.pathname === target || !end && target !== "/" && pending.pathname.startsWith(`${target}/`))
+	};
+	return createElement(Link, {
+		...props,
+		to,
+		className: typeof className === "function" ? className(state) : className,
+		...isActive && { "aria-current": "page" },
+		children: typeof children === "function" ? children(state) : children
+	});
+}
+//#endregion
+export { Link, NavLink, useNavigate, useNavigationType, useSearchParams, useURLLocation };

package/dist/react/root-context.d.ts

@@ -0,0 +1,14 @@
+import type { Router } from "../core/index.ts";
+import type { AppRoute, RootModule } from "./route-types.ts";
+export interface ApplicationContext {
+    router: Router;
+    routes: AppRoute[];
+    root: unknown;
+    rootError?: boolean;
+    entry?: string;
+    streaming?: boolean;
+    initialData?: string;
+    rootModule?: RootModule;
+}
+export declare const Application: import("react").Context<ApplicationContext | null>;
+export declare function useApplication(): ApplicationContext;

package/dist/react/root-context.js

@@ -0,0 +1,10 @@
+import { createContext, useContext } from "./runtime.js";
+//#region .generated/react/root-context.ts
+var Application = createContext(null);
+function useApplication() {
+	const app = useContext(Application);
+	if (!app) throw new Error("Root data requires RouterApplication.");
+	return app;
+}
+//#endregion
+export { Application, useApplication };

package/dist/react/route-hooks.d.ts

@@ -0,0 +1,34 @@
+import type { NavigateOptions } from "../core/index.ts";
+import type { NavigationType } from "../core/navigation.ts";
+import { type Submission, type SubmissionOptions } from "../core/submission.ts";
+import { useSnapshot } from "./context.ts";
+import type { NavigateFunction } from "./navigation.ts";
+import type { RouteData } from "./route-types.ts";
+/** Read root loader data from the application context. */
+export declare function useRootData<T = unknown>(): RouteData<T>;
+/** Read root data or the active route's data by its manifest identifier. */
+export declare function useRouteLoaderData<T = unknown>(id: string): RouteData<T> | undefined;
+export { useSnapshot };
+/** Read the current route error for an error boundary. */
+export declare function useRouteError(): Error | undefined;
+/** Read the current page navigation or submission state. */
+export declare function useNavigation(): {
+    state: "idle" | "loading" | "submitting";
+    location: URL | undefined;
+};
+/** Return a function that submits form data through the current router. */
+export declare function useSubmit(): (value: Submission, options?: SubmissionOptions) => Promise<void> | Promise<import("../core/index.ts").Result<unknown>>;
+/** Read the current router location as a URL. */
+export declare function useURLLocation(): URL & {
+    state: unknown;
+    key: string;
+};
+/** Return the application navigation function, including history offsets and relative destinations. */
+export declare function useNavigate(): NavigateFunction;
+/** Read URL search parameters and update them through router navigation. */
+export declare function useSearchParams(): [
+    URLSearchParams,
+    (value: URLSearchParams | Record<string, string>, options?: NavigateOptions) => void
+];
+/** Read the last browser history operation. */
+export declare function useNavigationType(): NavigationType;

package/dist/react/route-hooks.js

@@ -0,0 +1,89 @@
+import { submissionBody, submissionSearch } from "../core/submission.js";
+import { useCallback, useMemo } from "./runtime.js";
+import { useRouter, useSnapshot } from "./context.js";
+import { pendingLocation } from "../core/presentation.js";
+import { useNavigationSnapshot } from "./navigation-state.js";
+import { useApplication } from "./root-context.js";
+//#region .generated/react/route-hooks.ts
+/** Read root loader data from the application context. */
+function useRootData() {
+	return useApplication().root;
+}
+/** Read root data or the active route's data by its manifest identifier. */
+function useRouteLoaderData(id) {
+	const app = useApplication();
+	const snapshot = useSnapshot();
+	if (id === "root") return app.root;
+	const route = app.routes.find((item) => item.id === id);
+	if (!route || route.path !== snapshot.path) return void 0;
+	return snapshot.data;
+}
+/** Read the current route error for an error boundary. */
+function useRouteError() {
+	return useSnapshot("error");
+}
+/** Read the current page navigation or submission state. */
+function useNavigation() {
+	const router = useRouter();
+	const snapshot = useSnapshot();
+	const location = pendingLocation(router);
+	return useMemo(() => ({
+		state: snapshot.state,
+		location
+	}), [snapshot.state, location?.href]);
+}
+/** Return a function that submits form data through the current router. */
+function useSubmit() {
+	const router = useRouter();
+	return useCallback((value, options = {}) => {
+		const body = submissionBody(value, options.encType);
+		const method = options.method?.toUpperCase();
+		const target = options.action ?? router.getSnapshot().url;
+		if (method === "GET") {
+			const url = new URL(target, router.getSnapshot().url);
+			url.search = submissionSearch(body);
+			return router.navigate(url.href, options);
+		}
+		return router.submit(target, body, { method });
+	}, [router]);
+}
+/** Read the current router location as a URL. */
+function useURLLocation() {
+	const href = useSnapshot("url");
+	const snapshot = useNavigationSnapshot(useRouter());
+	return useMemo(() => Object.assign(new URL(href), {
+		state: snapshot.state,
+		key: snapshot.key
+	}), [
+		href,
+		snapshot.state,
+		snapshot.key
+	]);
+}
+/** Return the application navigation function, including history offsets and relative destinations. */
+function useNavigate() {
+	const router = useRouter();
+	return useCallback((to, options) => {
+		if (typeof to === "number") {
+			window.history.go(to);
+			return;
+		}
+		const current = new URL(router.getSnapshot().url);
+		const target = typeof to === "string" ? to : `${to.pathname ?? current.pathname}${to.search ?? current.search}${to.hash ?? current.hash}`;
+		router.navigate(target, options);
+	}, [router]);
+}
+/** Read URL search parameters and update them through router navigation. */
+function useSearchParams() {
+	const location = useURLLocation();
+	const navigate = useNavigate();
+	return [useMemo(() => new URLSearchParams(location.search), [location.search]), useCallback((value, options) => {
+		navigate(`${location.pathname}?${new URLSearchParams(value)}`, options);
+	}, [location.pathname, navigate])];
+}
+/** Read the last browser history operation. */
+function useNavigationType() {
+	return useNavigationSnapshot(useRouter()).type;
+}
+//#endregion
+export { useNavigate, useNavigation, useNavigationType, useRootData, useRouteError, useRouteLoaderData, useSearchParams, useSnapshot, useSubmit, useURLLocation };