@pracht/core 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -23,6 +23,53 @@ type RegisteredContext = Register extends {
 } ? T : unknown;
 type RenderMode = "spa" | "ssr" | "ssg" | "isg";
 type RouteParams = Record<string, string>;
+type RouteParamInput = string | number | boolean;
+type SearchParamPrimitive = string | number | boolean;
+type SearchParamValue = SearchParamPrimitive | null | undefined | readonly (SearchParamPrimitive | null | undefined)[];
+type SearchParamsInput = string | URLSearchParams | Record<string, SearchParamValue>;
+interface BuildHrefOptions {
+  params?: Record<string, RouteParamInput>;
+  search?: SearchParamsInput;
+  hash?: string;
+}
+interface NavigateOptions {
+  replace?: boolean;
+}
+interface HrefRouteDefinition {
+  id?: string;
+  path: string;
+  segments?: readonly RouteSegment[];
+}
+type RegisteredRouteMap = Register extends {
+  routes: infer TRoutes;
+} ? TRoutes extends Record<string, unknown> ? TRoutes : {} : {};
+type HasRegisteredRoutes = keyof RegisteredRouteMap extends never ? false : true;
+type EmptyRouteParams = Record<never, never>;
+type IsEmptyRouteParams<TParams> = keyof TParams extends never ? true : false;
+type RouteId = HasRegisteredRoutes extends true ? Extract<keyof RegisteredRouteMap, string> : string;
+type RouteParamsFor<TRoute extends RouteId> = HasRegisteredRoutes extends true ? TRoute extends keyof RegisteredRouteMap ? RegisteredRouteMap[TRoute] extends {
+  params: infer TParams;
+} ? TParams extends Record<string, unknown> ? TParams : EmptyRouteParams : EmptyRouteParams : never : Record<string, RouteParamInput>;
+type RouteSearchFor<TRoute extends RouteId> = HasRegisteredRoutes extends true ? TRoute extends keyof RegisteredRouteMap ? RegisteredRouteMap[TRoute] extends {
+  search: infer TSearch;
+} ? TSearch : SearchParamsInput : never : SearchParamsInput;
+type TypedHrefOptions<TRoute extends RouteId> = IsEmptyRouteParams<RouteParamsFor<TRoute>> extends true ? {
+  params?: never;
+  search?: RouteSearchFor<TRoute>;
+  hash?: string;
+} : {
+  params: RouteParamsFor<TRoute>;
+  search?: RouteSearchFor<TRoute>;
+  hash?: string;
+};
+type HrefOptions<TRoute extends RouteId = RouteId> = HasRegisteredRoutes extends true ? TRoute extends RouteId ? TypedHrefOptions<TRoute> : never : BuildHrefOptions;
+type HrefArgs<TRoute extends RouteId = RouteId> = HasRegisteredRoutes extends true ? TRoute extends RouteId ? IsEmptyRouteParams<RouteParamsFor<TRoute>> extends true ? [options?: TypedHrefOptions<TRoute>] : [options: TypedHrefOptions<TRoute>] : never : [options?: BuildHrefOptions];
+type RouteTarget<TRoute extends RouteId = RouteId> = HasRegisteredRoutes extends true ? TRoute extends RouteId ? {
+  route: TRoute;
+} & TypedHrefOptions<TRoute> : never : {
+  route: string;
+} & BuildHrefOptions;
+type HrefFn = <TRoute extends RouteId>(route: TRoute, ...args: HrefArgs<TRoute>) => string;
 /**
  * A reference to a module file — either a plain string path or a lazy import
  * function. Using `() => import("./path")` enables IDE click-to-navigate.
@@ -67,6 +114,7 @@ interface RouteMeta {
   middleware?: string[];
   revalidate?: RouteRevalidate;
   prefetch?: PrefetchStrategy;
+  hasLoader?: boolean;
 }
 interface GroupMeta {
   shell?: string;
@@ -241,7 +289,9 @@ declare function group(meta: GroupMeta, routes: RouteTreeNode[]): GroupDefinitio
 declare function defineApp(config: PrachtAppConfig): PrachtApp;
 declare function resolveApp(app: PrachtApp): ResolvedPrachtApp;
 declare function matchAppRoute(app: PrachtApp | ResolvedPrachtApp, pathname: string): RouteMatch | undefined;
-declare function buildPathFromSegments(segments: RouteSegment[], params: RouteParams): string;
+declare function buildPathFromSegments(segments: readonly RouteSegment[], params: RouteParams): string;
+declare function buildHref<TRoute extends RouteId>(routes: readonly HrefRouteDefinition[], routeId: TRoute, ...args: HrefArgs<TRoute>): string;
+declare function createHref(routes: readonly HrefRouteDefinition[]): HrefFn;
 /**
  * Convert a list of file paths from `import.meta.glob` into resolved API routes.
  *
@@ -310,22 +360,22 @@ interface FormProps extends Omit<JSX.HTMLAttributes<HTMLFormElement>, "action" |
   action?: string;
   method?: string;
 }
+type LinkProps<TRoute extends RouteId = RouteId> = Omit<JSX.HTMLAttributes<HTMLAnchorElement>, "href"> & RouteTarget<TRoute>;
 interface Location {
   pathname: string;
   search: string;
 }
 declare global {
+  var __PRACHT_ROUTE_DEFINITIONS__: readonly HrefRouteDefinition[] | undefined;
   interface Window {
     __PRACHT_STATE__?: PrachtHydrationState;
-    __PRACHT_NAVIGATE__?: (to: string, options?: {
-      replace?: boolean;
-    }) => Promise<void>;
   }
 }
 interface PrachtRuntimeValue {
   data: unknown;
   params: RouteParams;
   routeId: string;
+  routes?: readonly HrefRouteDefinition[];
   url: string;
   setData: (data: unknown) => void;
 }
@@ -334,6 +384,7 @@ declare function PrachtRuntimeProvider<TData>({
   data,
   params,
   routeId,
+  routes,
   stateVersion,
   url
 }: {
@@ -341,6 +392,7 @@ declare function PrachtRuntimeProvider<TData>({
   data: TData;
   params?: RouteParams;
   routeId: string;
+  routes?: readonly HrefRouteDefinition[];
   stateVersion?: number;
   url: string;
 }): _$preact.VNode<_$preact.Attributes & {
@@ -354,6 +406,7 @@ declare function useRouteData<TData = unknown>(): TData;
 declare function useLocation(): Location;
 declare function useParams(): RouteParams;
 declare function useRevalidate(): () => Promise<unknown>;
+declare function Link<TRoute extends RouteId>(props: LinkProps<TRoute>): _$preact.VNode<_$preact.ClassAttributes<HTMLAnchorElement> & h.JSX.HTMLAttributes<HTMLAnchorElement>>;
 declare function Form(props: FormProps): _$preact.VNode<_$preact.ClassAttributes<HTMLFormElement> & h.JSX.HTMLAttributes<HTMLFormElement>>;
 //#endregion
 //#region src/runtime-client-fetch.d.ts
@@ -422,9 +475,10 @@ declare global {
   }
 }
 type ModuleMap = Record<string, () => Promise<unknown>>;
-type NavigateFn = (to: string, options?: {
-  replace?: boolean;
-}) => Promise<void>;
+interface NavigateFn {
+  (to: string, options?: NavigateOptions): Promise<void>;
+  <TRoute extends RouteId>(to: RouteTarget<TRoute>, options?: NavigateOptions): Promise<void>;
+}
 declare function useNavigate(): NavigateFn;
 interface InitClientRouterOptions {
   app: ResolvedPrachtApp;
@@ -436,4 +490,4 @@ interface InitClientRouterOptions {
 }
 declare function initClientRouter(options: InitClientRouterOptions): Promise<void>;
 //#endregion
-export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadAttributes, type HeadMetadata, type HeadScriptDescriptor, type HeadersArgs, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteMatch, type RouteMeta, type RouteModule, type RouteParams, type RouteRevalidate, type RouteStateResult, type RouteTreeNode, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };
+export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type BuildHrefOptions, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadAttributes, type HeadMetadata, type HeadScriptDescriptor, type HeadersArgs, type HrefArgs, type HrefFn, type HrefOptions, type HrefRouteDefinition, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, Link, type LinkProps, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type NavigateOptions, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteId, type RouteMatch, type RouteMeta, type RouteModule, type RouteParamInput, type RouteParams, type RouteParamsFor, type RouteRevalidate, type RouteSearchFor, type RouteStateResult, type RouteTarget, type RouteTreeNode, type SearchParamPrimitive, type SearchParamValue, type SearchParamsInput, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildHref, buildPathFromSegments, createHref, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };

package/dist/index.mjs

@@ -22,6 +22,7 @@ function route(path, fileOrConfig, meta = {}) {
 		path: normalizeRoutePath(path),
 		file: resolveModuleRef(component),
 		loaderFile: resolveModuleRef(loader),
+		hasLoader: !!loader,
 		...routeMeta
 	};
 }
@@ -97,6 +98,7 @@ function flattenRouteNode(app, node, inherited, routes) {
 		path: fullPath,
 		file: node.file,
 		loaderFile: node.loaderFile,
+		hasLoader: node.loaderFile ? true : node.hasLoader,
 		shell,
 		shellFile: shell ? app.shells[shell] : void 0,
 		render: node.render ?? inherited.render,
@@ -188,6 +190,54 @@ function buildPathFromSegments(segments, params) {
 		return (params[segment.name] ?? params["*"] ?? "").split("/").map((part) => encodeDynamicPathSegment(part)).join("/");
 	}).join("/"));
 }
+function buildHref(routes, routeId, ...args) {
+	return buildHrefUntyped(routes, String(routeId), args[0]);
+}
+function createHref(routes) {
+	return ((routeId, options) => buildHrefUntyped(routes, routeId, options));
+}
+function buildHrefUntyped(routes, routeId, options = {}) {
+	const route = routes.find((candidate) => candidate.id === routeId);
+	if (!route) throw new Error(`Unknown pracht route id: ${routeId}.`);
+	const segments = route.segments ?? parseRouteSegments(route.path);
+	return `${buildPathFromSegments(segments, normalizeHrefParams(segments, options.params ?? {}))}${serializeSearch(options.search)}${serializeHash(options.hash)}`;
+}
+function normalizeHrefParams(segments, params) {
+	const expected = new Set(segments.filter((segment) => segment.type === "param" || segment.type === "catchall").map((segment) => segment.name));
+	for (const name of expected) if (params[name] == null) throw new Error(`Missing route param: ${name}.`);
+	for (const name of Object.keys(params)) if (!expected.has(name)) throw new Error(`Unexpected route param: ${name}.`);
+	const normalized = {};
+	for (const name of expected) normalized[name] = String(params[name]);
+	return normalized;
+}
+function serializeSearch(search) {
+	if (search == null) return "";
+	if (typeof search === "string") {
+		if (!search) return "";
+		return search.startsWith("?") ? search : `?${search}`;
+	}
+	const serialized = (search instanceof URLSearchParams ? search : objectToSearchParams(search)).toString();
+	return serialized ? `?${serialized}` : "";
+}
+function objectToSearchParams(search) {
+	const params = new URLSearchParams();
+	for (const [key, value] of Object.entries(search)) {
+		if (Array.isArray(value)) {
+			for (const item of value) appendSearchValue(params, key, item);
+			continue;
+		}
+		appendSearchValue(params, key, value);
+	}
+	return params;
+}
+function appendSearchValue(params, key, value) {
+	if (value == null) return;
+	params.append(key, String(value));
+}
+function serializeHash(hash) {
+	if (!hash) return "";
+	return hash.startsWith("#") ? hash : `#${hash}`;
+}
 /**
 * Encode one dynamic URL path segment for SSG/ISG output. `encodeURIComponent`
 * leaves unreserved characters (including `.`) intact, and even percent-encoded
@@ -532,6 +582,10 @@ function parseSafeNavigationUrl(location, base) {
 	if (!SAFE_NAVIGATION_PROTOCOLS.has(targetUrl.protocol)) return null;
 	return targetUrl;
 }
+function routeNeedsServerFetch(route) {
+	if (route.hasLoader === false && route.middlewareFiles.length === 0) return false;
+	return true;
+}
 function buildRouteStateUrl(url) {
 	return `${url}${url.includes("?") ? "&" : "?"}_data=1`;
 }
@@ -589,6 +643,10 @@ async function navigateToClientLocation(location, options) {
 const CACHE_TTL_MS = 3e4;
 const MAX_PREFETCH_CACHE_ENTRIES = 100;
 const MAX_MATCH_CACHE_ENTRIES = 250;
+const EMPTY_ROUTE_STATE_PROMISE = Promise.resolve({
+	type: "data",
+	data: void 0
+});
 const prefetchCache = /* @__PURE__ */ new Map();
 function clearPrefetchCache() {
 	prefetchCache.clear();
@@ -604,7 +662,8 @@ function getCachedRouteState(url) {
 	prefetchCache.set(url, entry);
 	return entry.promise;
 }
-function prefetchRouteState(url) {
+function prefetchRouteState(url, route) {
+	if (route && !routeNeedsServerFetch(route)) return EMPTY_ROUTE_STATE_PROMISE;
 	const cached = getCachedRouteState(url);
 	if (cached) return cached;
 	sweepPrefetchCache();
@@ -657,10 +716,9 @@ function setupPrefetching(app, warmModules) {
 		return entry;
 	}
 	function prefetchHref(href) {
-		prefetchRouteState(href);
-		if (!warmModules) return;
 		const match = getMatchEntry(href).match;
-		if (match) warmModules(match);
+		prefetchRouteState(href, match?.route);
+		if (warmModules && match) warmModules(match);
 	}
 	document.addEventListener("mouseenter", (e) => {
 		const anchor = e.target.closest?.("a");
@@ -734,7 +792,8 @@ function trimMapToSize(map, maxEntries) {
 //#endregion
 //#region src/runtime-hooks.ts
 const RouteDataContext = createContext(void 0);
-function PrachtRuntimeProvider({ children, data, params = EMPTY_ROUTE_PARAMS, routeId, stateVersion = 0, url }) {
+function PrachtRuntimeProvider({ children, data, params = EMPTY_ROUTE_PARAMS, routeId, routes, stateVersion = 0, url }) {
+	registerRuntimeRoutes(routes);
 	const [routeDataState, setRouteDataState] = useState({
 		data,
 		stateVersion
@@ -755,6 +814,7 @@ function PrachtRuntimeProvider({ children, data, params = EMPTY_ROUTE_PARAMS, ro
 		data: routeData,
 		params,
 		routeId,
+		routes,
 		setData: (nextData) => setRouteDataState({
 			data: nextData,
 			stateVersion
@@ -764,6 +824,7 @@ function PrachtRuntimeProvider({ children, data, params = EMPTY_ROUTE_PARAMS, ro
 		routeData,
 		params,
 		routeId,
+		routes,
 		stateVersion,
 		url
 	]);
@@ -811,6 +872,23 @@ function useRevalidate() {
 		return result.data;
 	};
 }
+function Link(props) {
+	const routes = useContext(RouteDataContext)?.routes ?? globalThis.__PRACHT_ROUTE_DEFINITIONS__;
+	if (!routes) throw new Error("<Link route=...> must render inside a pracht route tree.");
+	const { route, params, search, hash, ...anchorProps } = props;
+	return h("a", {
+		...anchorProps,
+		href: buildHref(routes, route, {
+			params,
+			search,
+			hash
+		})
+	});
+}
+function registerRuntimeRoutes(routes) {
+	if (!routes) return;
+	globalThis.__PRACHT_ROUTE_DEFINITIONS__ = routes;
+}
 function Form(props) {
 	const { onSubmit, method, ...rest } = props;
 	return h("form", {
@@ -1199,6 +1277,7 @@ async function renderRouteErrorResponse(options) {
 		body: await renderToString(h(PrachtRuntimeProvider, {
 			data: null,
 			routeId: options.routeId,
+			routes: options.routes,
 			url: options.requestPath
 		}, componentTree)),
 		hydrationState: {
@@ -1326,6 +1405,7 @@ async function handlePrachtRequest(options) {
 	if (hasDataParam) url.searchParams.delete("_data");
 	const requestPath = getRequestPath(url);
 	const registry = options.registry ?? {};
+	const resolvedApp = getResolvedApp(options.app);
 	const headerSignalsRouteState = options.request.headers.get(ROUTE_STATE_REQUEST_HEADER) === "1";
 	const dataParamIsFirstParty = hasDataParam && isFirstPartyFetch(options.request);
 	const isRouteStateRequest = headerSignalsRouteState || dataParamIsFirstParty;
@@ -1380,7 +1460,7 @@ async function handlePrachtRequest(options) {
 			}
 		}
 	}
-	const match = matchAppRoute(options.app, url.pathname);
+	const match = matchAppRoute(resolvedApp, url.pathname);
 	if (!match) {
 		if (isRouteStateRequest) return jsonErrorResponse(createSerializedRouteError("Not found", 404, {
 			diagnostics: exposeDiagnostics ? buildRuntimeDiagnostics({
@@ -1462,11 +1542,18 @@ async function handlePrachtRequest(options) {
 		const modulePreloadUrls = resolvePageJsUrls(options.jsManifest, match.route.shellFile, match.route.file);
 		if (match.route.render === "spa") {
 			let body = "";
-			if (shellModule?.Shell || shellModule?.Loading) {
-				const Shell = shellModule?.Shell;
-				const Loading = shellModule?.Loading;
-				const loadingTree = Shell != null ? h(Shell, null, Loading ? h(Loading, null) : null) : Loading ? h(Loading, null) : null;
-				if (loadingTree) body = await (await getRenderToStringAsync())(loadingTree);
+			const Shell = shellModule?.Shell;
+			const Loading = shellModule?.Loading;
+			const loadingTree = Shell != null ? h(Shell, null, Loading ? h(Loading, null) : null) : Loading ? h(Loading, null) : null;
+			if (loadingTree) {
+				const tree = h(PrachtRuntimeProvider, {
+					data: null,
+					params: match.params,
+					routeId: match.route.id ?? "",
+					routes: resolvedApp.routes,
+					url: requestPath
+				}, loadingTree);
+				body = await (await getRenderToStringAsync())(tree);
 			}
 			return htmlResponse(buildHtmlDocument({
 				head,
@@ -1498,6 +1585,7 @@ async function handlePrachtRequest(options) {
 			data,
 			params: match.params,
 			routeId: match.route.id ?? "",
+			routes: resolvedApp.routes,
 			url: requestPath
 		}, componentTree);
 		return htmlResponse(buildHtmlDocument({
@@ -1523,6 +1611,7 @@ async function handlePrachtRequest(options) {
 			routeArgs,
 			routeId: match.route.id ?? "",
 			routeModule,
+			routes: resolvedApp.routes,
 			shellFile: match.route.shellFile,
 			shellModule,
 			requestPath
@@ -1532,8 +1621,24 @@ async function handlePrachtRequest(options) {
 function getRequestPath(url) {
 	return `${url.pathname}${url.search}`;
 }
+function getResolvedApp(app) {
+	const routes = app.routes;
+	if (routes.length === 0 || isHrefRouteDefinition(routes[0])) return app;
+	return resolveApp(app);
+}
+function isHrefRouteDefinition(value) {
+	return Boolean(value && typeof value === "object" && "path" in value && "segments" in value && Array.isArray(value.segments));
+}
 //#endregion
 //#region src/prerender.ts
+const DANGEROUS_PRERENDER_HEADER_NAMES = new Set([
+	"authorization",
+	"proxy-authenticate",
+	"proxy-authorization",
+	"set-cookie",
+	"www-authenticate"
+]);
+const SECRET_SHAPED_PRERENDER_HEADER_RE = /^x-.*(?:api[-_]?key|client[-_]?secret|credential|jwt[-_]?secret|password|private[-_]?key|refresh[-_]?token|secret|session[-_]?secret|token|webhook[-_]?secret)(?:$|[-_])/i;
 async function prerenderApp(options) {
 	const resolved = resolveApp(options.app);
 	const results = [];
@@ -1567,6 +1672,7 @@ async function prerenderApp(options) {
 				console.warn(`  Warning: ${item.render.toUpperCase()} route "${item.pathname}" returned status ${response.status}, skipping.`);
 				return null;
 			}
+			assertSafePrerenderHeaders(response.headers, item);
 			const html = await response.text();
 			return {
 				headers: Object.fromEntries(response.headers),
@@ -1590,6 +1696,16 @@ async function prerenderApp(options) {
 	};
 	return results;
 }
+function assertSafePrerenderHeaders(headers, item) {
+	const dangerous = [...headers.keys()].filter(isDangerousPrerenderHeader);
+	if (dangerous.length === 0) return;
+	const names = dangerous.map((name) => `"${name}"`).join(", ");
+	throw new Error(`Refusing to prerender ${item.render.toUpperCase()} route "${item.pathname}" because its document headers include ${names}. SSG/ISG document headers are serialized into public static output and replayed for every visitor. Move cookies/authentication headers to API routes, loaders, middleware responses, or SSR-only routes.`);
+}
+function isDangerousPrerenderHeader(name) {
+	const normalized = name.toLowerCase();
+	return DANGEROUS_PRERENDER_HEADER_NAMES.has(normalized) || SECRET_SHAPED_PRERENDER_HEADER_RE.test(normalized);
+}
 async function collectSSGPaths(route, registry) {
 	if (!route.segments.some((s) => s.type === "param" || s.type === "catchall")) return [route.path];
 	const routeModule = await resolveRegistryModule(registry?.routeModules, route.file);
@@ -1708,6 +1824,7 @@ async function initClientRouter(options) {
 			data,
 			params,
 			routeId,
+			routes: app.routes,
 			stateVersion: version,
 			url
 		}, componentTree));
@@ -1789,9 +1906,10 @@ async function initClientRouter(options) {
 		activeNavigationAbort?.abort();
 		const abortController = new AbortController();
 		activeNavigationAbort = abortController;
-		const target = resolveBrowserRouteTarget(to);
+		const navigationTarget = typeof to === "string" ? to : buildHref(app.routes, to.route, to);
+		const target = resolveBrowserRouteTarget(navigationTarget);
 		if (!target) {
-			window.location.href = to;
+			window.location.href = navigationTarget;
 			return;
 		}
 		const match = matchAppRoute(app, target.pathname);
@@ -1799,7 +1917,12 @@ async function initClientRouter(options) {
 			window.location.href = target.browserUrl;
 			return;
 		}
-		const statePromise = getCachedRouteState(target.requestUrl) ?? fetchPrachtRouteState(target.requestUrl, { signal: abortController.signal });
+		let statePromise;
+		if (routeNeedsServerFetch(match.route)) statePromise = getCachedRouteState(target.requestUrl) ?? fetchPrachtRouteState(target.requestUrl, { signal: abortController.signal });
+		else statePromise = Promise.resolve({
+			type: "data",
+			data: void 0
+		});
 		const routeModPromise = startRouteImport(match);
 		const shellModPromise = startShellImport(match);
 		let state = {
@@ -1963,4 +2086,4 @@ var PrachtHttpError = class extends Error {
 	}
 };
 //#endregion
-export { Form, PrachtHttpError, PrachtRuntimeProvider, Suspense, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };
+export { Form, Link, PrachtHttpError, PrachtRuntimeProvider, Suspense, applyDefaultSecurityHeaders, buildHref, buildPathFromSegments, createHref, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "@pracht/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
+  "description": "Core runtime for Pracht, a full-stack Preact framework with per-route SSR, SSG, ISG, SPA, loaders, and API routes.",
+  "keywords": [
+    "pracht",
+    "preact",
+    "framework",
+    "full-stack",
+    "ssr",
+    "ssg",
+    "isg",
+    "routing",
+    "loaders",
+    "api-routes"
+  ],
   "license": "MIT",
   "homepage": "https://github.com/JoviDeCroock/pracht/tree/main/packages/framework",
   "bugs": {