@pracht/core 0.2.6 → 0.2.7

package/README.md

@@ -37,7 +37,7 @@ metadata for the failure phase and matched framework files when available.
 - `startApp()` — client-side hydration and runtime
 - `useLocation()` — access the current pathname and search string separately
 - `useRouteData()` — access loader data inside a route component
-- `useRevalidateRoute()` — trigger a revalidation of the current route's data
+- `useRevalidate()` — trigger a revalidation of the current route's data
 - `<Form>` — progressive enhancement form component
 
 ### Types

package/dist/index.d.mts

@@ -35,7 +35,9 @@ interface TimeRevalidatePolicy {
 }
 type RouteRevalidate = TimeRevalidatePolicy;
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
-type ApiRouteArgs<TContext = RegisteredContext> = BaseRouteArgs<TContext>;
+type ApiRouteArgs<TContext = RegisteredContext> = Omit<BaseRouteArgs<TContext>, "route"> & {
+  route: ResolvedApiRoute;
+};
 type ApiRouteHandler<TContext = RegisteredContext> = (args: ApiRouteArgs<TContext>) => MaybePromise<Response>;
 interface ApiRouteModule<TContext = any> {
   default?: ApiRouteHandler<TContext>;
@@ -286,10 +288,8 @@ interface HandlePrachtRequestOptions<TContext = unknown> {
   /** Expose raw server error details in rendered HTML and route-state JSON. */
   debugErrors?: boolean;
   clientEntryUrl?: string;
-  /** Per-source-file CSS map produced by the vite plugin (preferred over cssUrls). */
+  /** Per-source-file CSS map produced by the vite plugin. */
   cssManifest?: Record<string, string[]>;
-  /** @deprecated Pass cssManifest instead for per-page CSS resolution. */
-  cssUrls?: string[];
   /** Per-source-file JS chunk map produced by the vite plugin for modulepreload hints. */
   jsManifest?: Record<string, string[]>;
   apiRoutes?: ResolvedApiRoute[];
@@ -318,12 +318,14 @@ declare function PrachtRuntimeProvider<TData>({
   data,
   params,
   routeId,
+  stateVersion,
   url
 }: {
   children: ComponentChildren;
   data: TData;
   params?: RouteParams;
   routeId: string;
+  stateVersion?: number;
   url: string;
 }): _$preact.VNode<_$preact.Attributes & {
   value: PrachtRuntimeValue | undefined;
@@ -339,8 +341,6 @@ interface Location {
 declare function useLocation(): Location;
 declare function useParams(): RouteParams;
 declare function useRevalidate(): () => Promise<unknown>;
-/** @deprecated Use useRevalidate instead. */
-declare const useRevalidateRoute: typeof useRevalidate;
 declare function Form(props: FormProps): _$preact.VNode<_$preact.ClassAttributes<HTMLFormElement> & h.JSX.HTMLAttributes<HTMLFormElement>>;
 type RouteStateResult = {
   type: "data";
@@ -370,12 +370,10 @@ interface PrerenderAppOptions {
   app: PrachtApp;
   registry?: ModuleRegistry;
   clientEntryUrl?: string;
-  /** Per-source-file CSS map produced by the vite plugin (preferred over cssUrls). */
+  /** Per-source-file CSS map produced by the vite plugin. */
   cssManifest?: Record<string, string[]>;
   /** Per-source-file JS map produced by the vite plugin for modulepreload hints. */
   jsManifest?: Record<string, string[]>;
-  /** @deprecated Pass cssManifest instead for per-page CSS resolution. */
-  cssUrls?: string[];
 }
 declare function prerenderApp(options: PrerenderAppOptions): Promise<PrerenderResult[]>;
 declare function prerenderApp(options: PrerenderAppOptions & {
@@ -389,7 +387,7 @@ declare global {
     __PRACHT_ROUTER_READY__?: boolean;
   }
 }
-type ModuleMap = Record<string, () => Promise<any>>;
+type ModuleMap = Record<string, () => Promise<unknown>>;
 type NavigateFn = (to: string, options?: {
   replace?: boolean;
 }) => Promise<void>;
@@ -404,4 +402,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 HeadMetadata, 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, useRevalidateRoute, useRouteData };
+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 HeadMetadata, 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 };

package/dist/index.mjs

@@ -1,7 +1,241 @@
-import { a as matchApiRoute, c as resolveApp, i as group, l as route, n as buildPathFromSegments, o as matchAppRoute, r as defineApp, s as resolveApiRoutes, u as timeRevalidate } from "./app-CUL3q2ZA.mjs";
 import { createContext, h, hydrate, options, render } from "preact";
 import { useContext, useEffect, useMemo, useState } from "preact/hooks";
 import { Suspense, lazy } from "preact-suspense";
+//#region src/app.ts
+function timeRevalidate(seconds) {
+	if (!Number.isInteger(seconds) || seconds <= 0) throw new Error("timeRevalidate expects a positive integer number of seconds.");
+	return {
+		kind: "time",
+		seconds
+	};
+}
+function route(path, fileOrConfig, meta = {}) {
+	if (typeof fileOrConfig === "string" || typeof fileOrConfig === "function") return {
+		kind: "route",
+		path: normalizeRoutePath(path),
+		file: resolveModuleRef(fileOrConfig),
+		...meta
+	};
+	const { component, loader, ...routeMeta } = fileOrConfig;
+	return {
+		kind: "route",
+		path: normalizeRoutePath(path),
+		file: resolveModuleRef(component),
+		loaderFile: resolveModuleRef(loader),
+		...routeMeta
+	};
+}
+function resolveModuleRef(ref) {
+	if (ref === void 0) return void 0;
+	if (typeof ref === "string") return ref;
+	return "";
+}
+function group(meta, routes) {
+	return {
+		kind: "group",
+		meta,
+		routes
+	};
+}
+function defineApp(config) {
+	return {
+		shells: resolveModuleRefRecord(config.shells ?? {}),
+		middleware: resolveModuleRefRecord(config.middleware ?? {}),
+		api: config.api ?? {},
+		routes: config.routes
+	};
+}
+function resolveModuleRefRecord(record) {
+	const result = {};
+	for (const [key, value] of Object.entries(record)) result[key] = resolveModuleRef(value);
+	return result;
+}
+function resolveApp(app) {
+	const routes = [];
+	const inherited = {
+		pathPrefix: "/",
+		middleware: []
+	};
+	for (const node of app.routes) flattenRouteNode(app, node, inherited, routes);
+	return {
+		shells: app.shells,
+		middleware: app.middleware,
+		api: app.api,
+		routes,
+		apiRoutes: []
+	};
+}
+function matchAppRoute(app, pathname) {
+	const resolved = isResolvedApp(app) ? app : resolveApp(app);
+	const normalizedPathname = normalizeRoutePath(pathname);
+	const targetSegments = splitPathSegments(normalizedPathname);
+	for (const currentRoute of resolved.routes) {
+		const params = matchRouteSegments(currentRoute.segments, targetSegments);
+		if (params) return {
+			route: currentRoute,
+			params,
+			pathname: normalizedPathname
+		};
+	}
+}
+function flattenRouteNode(app, node, inherited, routes) {
+	if (node.kind === "group") {
+		const nextInherited = {
+			pathPrefix: mergeRoutePaths(inherited.pathPrefix, node.meta.pathPrefix),
+			shell: node.meta.shell ?? inherited.shell,
+			render: node.meta.render ?? inherited.render,
+			middleware: [...inherited.middleware, ...node.meta.middleware ?? []]
+		};
+		for (const child of node.routes) flattenRouteNode(app, child, nextInherited, routes);
+		return;
+	}
+	const fullPath = mergeRoutePaths(inherited.pathPrefix, node.path);
+	const shell = node.shell ?? inherited.shell;
+	const middleware = [...inherited.middleware, ...node.middleware ?? []];
+	routes.push({
+		id: node.id ?? createRouteId(fullPath),
+		path: fullPath,
+		file: node.file,
+		loaderFile: node.loaderFile,
+		shell,
+		shellFile: shell ? app.shells[shell] : void 0,
+		render: node.render ?? inherited.render,
+		middleware,
+		middlewareFiles: middleware.flatMap((name) => {
+			const middlewareFile = app.middleware[name];
+			return middlewareFile ? [middlewareFile] : [];
+		}),
+		revalidate: node.revalidate,
+		segments: parseRouteSegments(fullPath)
+	});
+}
+function isResolvedApp(app) {
+	return app.routes.length === 0 || "segments" in app.routes[0];
+}
+function matchRouteSegments(routeSegments, targetSegments) {
+	const params = {};
+	let routeIndex = 0;
+	let targetIndex = 0;
+	while (routeIndex < routeSegments.length) {
+		const currentSegment = routeSegments[routeIndex];
+		if (currentSegment.type === "catchall") {
+			params[currentSegment.name] = targetSegments.slice(targetIndex).join("/");
+			return params;
+		}
+		const targetSegment = targetSegments[targetIndex];
+		if (typeof targetSegment === "undefined") return null;
+		if (currentSegment.type === "static") {
+			if (currentSegment.value !== targetSegment) return null;
+		} else try {
+			params[currentSegment.name] = decodeURIComponent(targetSegment);
+		} catch {
+			return null;
+		}
+		routeIndex += 1;
+		targetIndex += 1;
+	}
+	return targetIndex === targetSegments.length ? params : null;
+}
+function parseRouteSegments(path) {
+	return splitPathSegments(path).map((segment) => {
+		if (segment === "*") return {
+			type: "catchall",
+			name: "*"
+		};
+		if (segment.startsWith(":")) return {
+			type: "param",
+			name: segment.slice(1)
+		};
+		return {
+			type: "static",
+			value: segment
+		};
+	});
+}
+function splitPathSegments(path) {
+	return normalizeRoutePath(path).split("/").filter(Boolean);
+}
+function mergeRoutePaths(prefix, path) {
+	if (!path) return normalizeRoutePath(prefix);
+	const normalizedPrefix = normalizeRoutePath(prefix);
+	const normalizedPath = normalizeRoutePath(path);
+	if (normalizedPrefix === "/") return normalizedPath;
+	if (normalizedPath === "/") return normalizedPrefix;
+	return normalizeRoutePath(`${normalizedPrefix}/${normalizedPath.slice(1)}`);
+}
+function normalizeRoutePath(path) {
+	if (!path || path === "/") return "/";
+	const collapsed = (path.startsWith("/") ? path : `/${path}`).replace(/\/{2,}/g, "/");
+	return collapsed.length > 1 && collapsed.endsWith("/") ? collapsed.slice(0, -1) : collapsed;
+}
+function buildPathFromSegments(segments, params) {
+	return normalizeRoutePath("/" + segments.map((segment) => {
+		if (segment.type === "static") return segment.value;
+		if (segment.type === "param") return encodeURIComponent(params[segment.name] ?? "");
+		return params["*"] ?? "";
+	}).join("/"));
+}
+/**
+* Convert a list of file paths from `import.meta.glob` into resolved API routes.
+*
+* Example: `"/src/api/health.ts"` → path `/api/health`
+*          `"/src/api/users/[id].ts"` → path `/api/users/:id`
+*          `"/src/api/index.ts"` → path `/api`
+*/
+function resolveApiRoutes(files, apiDir = "/src/api") {
+	const normalizedDir = apiDir.replace(/\/$/, "");
+	return files.map((file) => {
+		let relative = file;
+		if (relative.startsWith(normalizedDir)) relative = relative.slice(normalizedDir.length);
+		relative = relative.replace(/\.(ts|tsx|js|jsx)$/, "");
+		if (relative.endsWith("/index")) relative = relative.slice(0, -6) || "/";
+		relative = relative.replace(/\[([^\]]+)\]/g, ":$1");
+		const path = normalizeRoutePath(`/api${relative}`);
+		return {
+			path,
+			file,
+			segments: parseRouteSegments(path)
+		};
+	}).sort(compareResolvedApiRoutes);
+}
+function matchApiRoute(apiRoutes, pathname) {
+	const normalizedPathname = normalizeRoutePath(pathname);
+	const targetSegments = splitPathSegments(normalizedPathname);
+	for (const route of apiRoutes) {
+		const params = matchRouteSegments(route.segments, targetSegments);
+		if (params) return {
+			route,
+			params,
+			pathname: normalizedPathname
+		};
+	}
+}
+function createRouteId(path) {
+	if (path === "/") return "index";
+	return path.slice(1).split("/").map((segment) => {
+		if (segment === "*") return "splat";
+		return segment.startsWith(":") ? segment.slice(1) : segment;
+	}).join("-").replace(/[^a-zA-Z0-9-]/g, "-");
+}
+function compareResolvedApiRoutes(left, right) {
+	const length = Math.max(left.segments.length, right.segments.length);
+	for (let index = 0; index < length; index += 1) {
+		const leftSegment = left.segments[index];
+		const rightSegment = right.segments[index];
+		if (!leftSegment) return 1;
+		if (!rightSegment) return -1;
+		const leftScore = getRouteSegmentSpecificity(leftSegment);
+		const rightScore = getRouteSegmentSpecificity(rightSegment);
+		if (leftScore !== rightScore) return rightScore - leftScore;
+	}
+	return left.path.localeCompare(right.path);
+}
+function getRouteSegmentSpecificity(segment) {
+	if (segment.type === "static") return 3;
+	if (segment.type === "param") return 2;
+	return 1;
+}
+//#endregion
 //#region src/forwardRef.ts
 let oldDiffHook = options.__b;
 options.__b = (vnode) => {
@@ -80,6 +314,7 @@ const SAFE_METHODS = new Set(["GET", "HEAD"]);
 const HYDRATION_STATE_ELEMENT_ID = "pracht-state";
 const ROUTE_STATE_REQUEST_HEADER = "x-pracht-route-state-request";
 const ROUTE_STATE_CACHE_CONTROL = "no-store";
+const EMPTY_ROUTE_PARAMS = {};
 let _renderToStringAsync;
 async function getRenderToStringAsync() {
 	if (_renderToStringAsync) return _renderToStringAsync;
@@ -87,25 +322,37 @@ async function getRenderToStringAsync() {
 	return _renderToStringAsync;
 }
 const RouteDataContext = createContext(void 0);
-function PrachtRuntimeProvider({ children, data, params = {}, routeId, url }) {
-	const [routeData, setRouteData] = useState(data);
+function PrachtRuntimeProvider({ children, data, params = EMPTY_ROUTE_PARAMS, routeId, stateVersion = 0, url }) {
+	const [routeDataState, setRouteDataState] = useState({
+		data,
+		stateVersion
+	});
+	const routeData = routeDataState.stateVersion === stateVersion ? routeDataState.data : data;
 	useEffect(() => {
-		setRouteData(data);
+		setRouteDataState({
+			data,
+			stateVersion
+		});
 	}, [
 		data,
 		routeId,
+		stateVersion,
 		url
 	]);
 	const context = useMemo(() => ({
 		data: routeData,
 		params,
 		routeId,
-		setData: setRouteData,
+		setData: (nextData) => setRouteDataState({
+			data: nextData,
+			stateVersion
+		}),
 		url
 	}), [
 		routeData,
 		params,
 		routeId,
+		stateVersion,
 		url
 	]);
 	return h(RouteDataContext.Provider, {
@@ -125,13 +372,9 @@ function readHydrationState() {
 	if (!(element instanceof HTMLScriptElement)) return;
 	const raw = element.textContent;
 	if (!raw) return;
-	try {
-		const state = JSON.parse(raw);
-		window.__PRACHT_STATE__ = state;
-		return state;
-	} catch {
-		return;
-	}
+	const state = JSON.parse(raw);
+	window.__PRACHT_STATE__ = state;
+	return state;
 }
 function useRouteData() {
 	return useContext(RouteDataContext)?.data;
@@ -151,13 +394,11 @@ function useRevalidate() {
 			await navigateToClientLocation(result.location);
 			return;
 		}
-		if (result.type === "error") throw deserializeRouteError$1(result.error);
+		if (result.type === "error") throw deserializeRouteError(result.error);
 		runtime?.setData(result.data);
 		return result.data;
 	};
 }
-/** @deprecated Use useRevalidate instead. */
-const useRevalidateRoute = useRevalidate;
 function Form(props) {
 	const { onSubmit, method, ...rest } = props;
 	return h("form", {
@@ -187,9 +428,10 @@ function Form(props) {
 		}
 	});
 }
-async function fetchPrachtRouteState(url) {
-	const response = await fetch(url, {
-		headers: {
+async function fetchPrachtRouteState(url, options) {
+	const fetchUrl = options?.useDataParam ? buildRouteStateUrl(url) : url;
+	const response = await fetch(fetchUrl, {
+		headers: options?.useDataParam ? {} : {
 			[ROUTE_STATE_REQUEST_HEADER]: "1",
 			"Cache-Control": "no-cache"
 		},
@@ -216,11 +458,16 @@ async function fetchPrachtRouteState(url) {
 		type: "data"
 	};
 }
+function buildRouteStateUrl(url) {
+	return `${url}${url.includes("?") ? "&" : "?"}_data=1`;
+}
 async function handlePrachtRequest(options) {
 	const url = new URL(options.request.url);
+	const hasDataParam = url.searchParams.get("_data") === "1";
+	if (hasDataParam) url.searchParams.delete("_data");
 	const requestPath = getRequestPath(url);
 	const registry = options.registry ?? {};
-	const isRouteStateRequest = options.request.headers.get(ROUTE_STATE_REQUEST_HEADER) === "1";
+	const isRouteStateRequest = options.request.headers.get(ROUTE_STATE_REQUEST_HEADER) === "1" || hasDataParam;
 	const exposeDiagnostics = shouldExposeServerErrors(options);
 	if (options.apiRoutes?.length) {
 		const apiMatch = matchApiRoute(options.apiRoutes, url.pathname);
@@ -311,7 +558,7 @@ async function handlePrachtRequest(options) {
 	let loaderFile;
 	let currentPhase = "middleware";
 	try {
-		const middlewareResult = await runMiddlewareChain({
+		const middlewarePromise = runMiddlewareChain({
 			context: routeArgs.context,
 			middlewareFiles: match.route.middlewareFiles,
 			params: match.params,
@@ -320,25 +567,31 @@ async function handlePrachtRequest(options) {
 			route: match.route,
 			url
 		});
+		const routeModulePromise = resolveRegistryModule(registry.routeModules, match.route.file);
+		const shellModulePromise = match.route.shellFile ? resolveRegistryModule(registry.shellModules, match.route.shellFile) : Promise.resolve(void 0);
+		const dataFunctionsPromise = routeModulePromise.then((mod) => resolveDataFunctions(match.route, mod, registry));
+		routeModulePromise.catch(() => {});
+		shellModulePromise.catch(() => {});
+		dataFunctionsPromise.catch(() => {});
+		const middlewareResult = await middlewarePromise;
 		if (middlewareResult.response) return normalizePageResponse(middlewareResult.response, { isRouteStateRequest });
 		routeArgs = {
 			...routeArgs,
 			context: middlewareResult.context
 		};
 		currentPhase = "render";
-		routeModule = await resolveRegistryModule(registry.routeModules, match.route.file);
+		routeModule = await routeModulePromise;
 		if (!routeModule) throw new Error("Route module not found");
 		currentPhase = "loader";
-		const { loader, loaderFile: resolvedLoaderFile } = await resolveDataFunctions(match.route, routeModule, registry);
+		const { loader, loaderFile: resolvedLoaderFile } = await dataFunctionsPromise;
 		loaderFile = resolvedLoaderFile;
 		const loaderResult = loader ? await loader(routeArgs) : void 0;
 		if (loaderResult instanceof Response) return normalizePageResponse(loaderResult, { isRouteStateRequest });
 		const data = loaderResult;
 		if (isRouteStateRequest) return withRouteResponseHeaders(Response.json({ data }), { isRouteStateRequest: true });
 		currentPhase = "render";
-		shellModule = match.route.shellFile ? await resolveRegistryModule(registry.shellModules, match.route.shellFile) : void 0;
-		const head = await mergeHeadMetadata(shellModule, routeModule, routeArgs, data);
-		const documentHeaders = await mergeDocumentHeaders(shellModule, routeModule, routeArgs, data);
+		shellModule = await shellModulePromise;
+		const [head, documentHeaders] = await Promise.all([mergeHeadMetadata(shellModule, routeModule, routeArgs, data), mergeDocumentHeaders(shellModule, routeModule, routeArgs, data)]);
 		const cssUrls = resolvePageCssUrls(options, match.route.shellFile, match.route.file);
 		const modulePreloadUrls = resolvePageJsUrls(options, match.route.shellFile, match.route.file);
 		if (match.route.render === "spa") {
@@ -361,18 +614,20 @@ async function handlePrachtRequest(options) {
 				},
 				clientEntryUrl: options.clientEntryUrl,
 				cssUrls,
-				modulePreloadUrls
+				modulePreloadUrls,
+				routeStatePreloadUrl: loader ? buildRouteStateUrl(requestPath) : void 0
 			}), 200, documentHeaders);
 		}
 		const DefaultComponent = typeof routeModule.default === "function" ? routeModule.default : void 0;
 		const Component = routeModule.Component ?? DefaultComponent;
 		if (!Component) throw new Error("Route has no Component or default export");
 		const Shell = shellModule?.Shell;
+		const Comp = Component;
 		const componentProps = {
 			data,
 			params: match.params
 		};
-		const componentTree = Shell ? h(Shell, null, h(Component, componentProps)) : h(Component, componentProps);
+		const componentTree = Shell ? h(Shell, null, h(Comp, componentProps)) : h(Comp, componentProps);
 		const tree = h(PrachtRuntimeProvider, {
 			data,
 			params: match.params,
@@ -409,18 +664,11 @@ async function handlePrachtRequest(options) {
 	}
 }
 function parseLocation(value) {
-	try {
-		const url = new URL(value, "http://pracht.local");
-		return {
-			pathname: url.pathname,
-			search: url.search
-		};
-	} catch {
-		return {
-			pathname: value || "/",
-			search: ""
-		};
-	}
+	const url = new URL(value, "http://pracht.local");
+	return {
+		pathname: url.pathname,
+		search: url.search
+	};
 }
 function getRequestPath(url) {
 	return `${url.pathname}${url.search}`;
@@ -455,27 +703,23 @@ function resolveManifestEntries(manifest, file) {
 	const resolved = getSuffixIndex(manifest).get(normalizeModulePath(file));
 	if (resolved) return manifest[resolved];
 }
+function resolvePageUrlsFromManifest(manifest, shellFile, routeFile) {
+	const urls = /* @__PURE__ */ new Set();
+	const add = (file) => {
+		const entries = resolveManifestEntries(manifest, file);
+		if (entries) for (const url of entries) urls.add(url);
+	};
+	if (shellFile) add(shellFile);
+	add(routeFile);
+	return [...urls];
+}
 function resolvePageCssUrls(options, shellFile, routeFile) {
-	if (!options.cssManifest) return options.cssUrls ?? [];
-	const css = /* @__PURE__ */ new Set();
-	function addFromManifest(file) {
-		const entries = resolveManifestEntries(options.cssManifest, file);
-		if (entries) for (const c of entries) css.add(c);
-	}
-	if (shellFile) addFromManifest(shellFile);
-	addFromManifest(routeFile);
-	return [...css];
+	if (!options.cssManifest) return [];
+	return resolvePageUrlsFromManifest(options.cssManifest, shellFile, routeFile);
 }
 function resolvePageJsUrls(options, shellFile, routeFile) {
 	if (!options.jsManifest) return [];
-	const js = /* @__PURE__ */ new Set();
-	function addFromManifest(file) {
-		const entries = resolveManifestEntries(options.jsManifest, file);
-		if (entries) for (const j of entries) js.add(j);
-	}
-	if (shellFile) addFromManifest(shellFile);
-	addFromManifest(routeFile);
-	return [...js];
+	return resolvePageUrlsFromManifest(options.jsManifest, shellFile, routeFile);
 }
 async function navigateToClientLocation(location, options) {
 	if (typeof window === "undefined") return;
@@ -561,7 +805,7 @@ function normalizeRouteError(error, options) {
 		status: 500
 	};
 }
-function deserializeRouteError$1(error) {
+function deserializeRouteError(error) {
 	const result = new Error(error.message);
 	result.name = error.name;
 	result.status = error.status;
@@ -643,7 +887,7 @@ async function renderRouteErrorResponse(options) {
 	const renderToString = await getRenderToStringAsync();
 	const ErrorBoundary = options.routeModule.ErrorBoundary;
 	const Shell = shellModule?.Shell;
-	const errorValue = deserializeRouteError$1(routeErrorWithDiagnostics);
+	const errorValue = deserializeRouteError(routeErrorWithDiagnostics);
 	const componentTree = Shell ? h(Shell, null, h(ErrorBoundary, { error: errorValue })) : h(ErrorBoundary, { error: errorValue });
 	return htmlResponse(buildHtmlDocument({
 		head,
@@ -665,8 +909,10 @@ async function renderRouteErrorResponse(options) {
 }
 async function runMiddlewareChain(options) {
 	let context = options.context;
-	for (const mwFile of options.middlewareFiles) {
-		const mwModule = await resolveRegistryModule(options.registry.middlewareModules, mwFile);
+	const modulePromises = options.middlewareFiles.map((mwFile) => resolveRegistryModule(options.registry.middlewareModules, mwFile));
+	for (const p of modulePromises) p.catch(() => {});
+	for (const modulePromise of modulePromises) {
+		const mwModule = await modulePromise;
 		if (!mwModule?.middleware) continue;
 		const result = await mwModule.middleware({
 			request: options.request,
@@ -711,11 +957,10 @@ async function resolveRegistryModule(modules, file) {
 	if (resolved) return modules[resolved]();
 }
 async function mergeHeadMetadata(shellModule, routeModule, routeArgs, data) {
-	const shellHead = shellModule?.head ? await shellModule.head(routeArgs) : {};
-	const routeHead = routeModule?.head ? await routeModule.head({
+	const [shellHead, routeHead] = await Promise.all([shellModule?.head ? shellModule.head(routeArgs) : Promise.resolve({}), routeModule?.head ? routeModule.head({
 		...routeArgs,
 		data
-	}) : {};
+	}) : Promise.resolve({})]);
 	return {
 		title: routeHead.title ?? shellHead.title,
 		lang: routeHead.lang ?? shellHead.lang,
@@ -725,12 +970,11 @@ async function mergeHeadMetadata(shellModule, routeModule, routeArgs, data) {
 }
 async function mergeDocumentHeaders(shellModule, routeModule, routeArgs, data) {
 	const headers = new Headers();
-	const shellHeaders = shellModule?.headers ? await shellModule.headers(routeArgs) : void 0;
-	if (shellHeaders) applyHeaders(headers, shellHeaders);
-	const routeHeaders = routeModule?.headers ? await routeModule.headers({
+	const [shellHeaders, routeHeaders] = await Promise.all([shellModule?.headers ? shellModule.headers(routeArgs) : Promise.resolve(void 0), routeModule?.headers ? routeModule.headers({
 		...routeArgs,
 		data
-	}) : void 0;
+	}) : Promise.resolve(void 0)]);
+	if (shellHeaders) applyHeaders(headers, shellHeaders);
 	if (routeHeaders) applyHeaders(headers, routeHeaders);
 	return headers;
 }
@@ -740,12 +984,13 @@ function applyHeaders(headers, init) {
 	});
 }
 function buildHtmlDocument(options) {
-	const { head, body, hydrationState, clientEntryUrl, cssUrls = [], modulePreloadUrls = [] } = options;
+	const { head, body, hydrationState, clientEntryUrl, cssUrls = [], modulePreloadUrls = [], routeStatePreloadUrl } = options;
 	const titleTag = head.title ? `<title>${escapeHtml(head.title)}</title>` : "";
 	const metaTags = (head.meta ?? []).map((m) => `<meta ${Object.entries(m).map(([k, v]) => `${k}="${escapeHtml(v)}"`).join(" ")}>`).join("\n    ");
 	const linkTags = (head.link ?? []).map((l) => `<link ${Object.entries(l).map(([k, v]) => `${k}="${escapeHtml(v)}"`).join(" ")}>`).join("\n    ");
 	const cssTags = cssUrls.map((url) => `<link rel="stylesheet" href="${escapeHtml(url)}">`).join("\n    ");
 	const modulePreloadTags = modulePreloadUrls.map((url) => `<link rel="modulepreload" href="${escapeHtml(url)}">`).join("\n    ");
+	const routeStatePreloadTag = routeStatePreloadUrl ? `<link rel="preload" as="fetch" href="${escapeHtml(routeStatePreloadUrl)}" crossorigin="anonymous">` : "";
 	const stateScript = `<script id="${HYDRATION_STATE_ELEMENT_ID}" type="application/json">${serializeJsonForHtml(hydrationState)}<\/script>`;
 	const entryScript = clientEntryUrl ? `<script type="module" src="${escapeHtml(clientEntryUrl)}"><\/script>` : "";
 	return `<!DOCTYPE html>
@@ -757,6 +1002,7 @@ function buildHtmlDocument(options) {
     ${linkTags}
     ${cssTags}
     ${modulePreloadTags}
+    ${routeStatePreloadTag}
   </head>
   <body>
     <div id="pracht-root">${body}</div>
@@ -824,7 +1070,6 @@ function serializeJsonForHtml(value) {
 	return JSON.stringify(value).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
 async function prerenderApp(options) {
-	const { resolveApp } = await import("./app-CUL3q2ZA.mjs").then((n) => n.t);
 	const resolved = resolveApp(options.app);
 	const results = [];
 	const isgManifest = {};
@@ -886,7 +1131,6 @@ async function collectSSGPaths(route, registry) {
 		console.warn(`  Warning: SSG route "${route.path}" has dynamic segments but no getStaticPaths() export, skipping.`);
 		return [];
 	}
-	const { buildPathFromSegments } = await import("./app-CUL3q2ZA.mjs").then((n) => n.t);
 	return (await routeModule.getStaticPaths()).map((params) => buildPathFromSegments(route.segments, params));
 }
 //#endregion
@@ -939,7 +1183,6 @@ function setupPrefetching(app, warmModules) {
 		const match = matchAppRoute(app, routePathname);
 		if (!match) return "none";
 		if (match.route.prefetch) return match.route.prefetch;
-		if (match.route.render === "spa") return "none";
 		return "intent";
 	}
 	document.addEventListener("mouseenter", (e) => {
@@ -1041,7 +1284,30 @@ async function initClientRouter(options) {
 		if (!shellKey) return null;
 		return loadModule(shellModules, shellKey);
 	}
-	async function buildRouteTree(match, state, currentUrl, routeModPromise, shellModPromise) {
+	let updateRouteState = null;
+	let routeStateVersion = 0;
+	function RouterRoot({ initialState }) {
+		const [routeState, setRouteState] = useState(initialState);
+		updateRouteState = setRouteState;
+		const navigateValue = useMemo(() => navigate, []);
+		const { Shell, Component, componentProps, data, params, routeId, url, version } = routeState;
+		const componentTree = Shell ? h(Shell, null, h(Component, componentProps)) : h(Component, componentProps);
+		return h(NavigateContext.Provider, { value: navigateValue }, h(PrachtRuntimeProvider, {
+			data,
+			params,
+			routeId,
+			stateVersion: version,
+			url
+		}, componentTree));
+	}
+	function applyRouteState(routeState) {
+		if (updateRouteState) {
+			updateRouteState(routeState);
+			return;
+		}
+		render(h(RouterRoot, { initialState: routeState }), root);
+	}
+	async function resolveRouteState(match, state, currentUrl, routeModPromise, shellModPromise) {
 		const routeMod = await (routeModPromise ?? startRouteImport(match));
 		if (!routeMod) return null;
 		let Shell = null;
@@ -1050,31 +1316,37 @@ async function initClientRouter(options) {
 		const DefaultComponent = typeof routeMod.default === "function" ? routeMod.default : void 0;
 		const Component = state.error ? routeMod.ErrorBoundary : routeMod.Component ?? DefaultComponent;
 		if (!Component) return null;
-		const props = state.error ? { error: deserializeRouteError(state.error) } : {
+		const componentProps = state.error ? { error: deserializeRouteError(state.error) } : {
 			data: state.data,
 			params: match.params
 		};
-		const componentTree = Shell ? h(Shell, null, h(Component, props)) : h(Component, props);
-		return h(NavigateContext.Provider, { value: navigate }, h(PrachtRuntimeProvider, {
+		return {
+			Shell,
+			Component,
+			componentProps,
 			data: state.data,
 			params: match.params,
 			routeId: match.route.id ?? "",
-			url: currentUrl
-		}, componentTree));
+			url: currentUrl,
+			version: ++routeStateVersion
+		};
 	}
-	async function buildSpaPendingTree(match, currentUrl, shellModPromise) {
+	async function resolveSpaPendingState(match, currentUrl, shellModPromise) {
 		const resolvedShell = await (shellModPromise ?? startShellImport(match));
 		if (!resolvedShell) return null;
-		const Shell = resolvedShell.Shell;
+		const Shell = resolvedShell.Shell ?? null;
 		const Loading = resolvedShell.Loading;
-		const componentTree = Shell != null ? h(Shell, null, Loading ? h(Loading, null) : null) : Loading ? h(Loading, null) : null;
-		if (!componentTree) return null;
-		return h(NavigateContext.Provider, { value: navigate }, h(PrachtRuntimeProvider, {
+		if (!Shell && !Loading) return null;
+		return {
+			Shell,
+			Component: Loading ?? (() => null),
+			componentProps: {},
 			data: void 0,
 			params: match.params,
 			routeId: match.route.id ?? "",
-			url: currentUrl
-		}, componentTree));
+			url: currentUrl,
+			version: ++routeStateVersion
+		};
 	}
 	function resolveRedirectTarget(location) {
 		const targetUrl = new URL(location, window.location.href);
@@ -1151,21 +1423,12 @@ async function initClientRouter(options) {
 		}
 		if (!opts?._popstate) if (opts?.replace) history.replaceState(null, "", target.browserUrl);
 		else history.pushState(null, "", target.browserUrl);
-		const tree = await buildRouteTree(match, state, target.requestUrl, routeModPromise, shellModPromise);
-		if (tree) {
-			render(tree, root);
+		const routeState = await resolveRouteState(match, state, target.requestUrl, routeModPromise, shellModPromise);
+		if (routeState) {
+			applyRouteState(routeState);
 			window.scrollTo(0, 0);
 		} else window.location.href = target.browserUrl;
 	}
-	if (import.meta.env?.DEV) {
-		const prev = options.__m;
-		options.__m = (vnode, s) => {
-			const message = `Hydration mismatch in <${(typeof vnode.type === "function" ? vnode.type.displayName || vnode.type.name : vnode.type) || "Unknown"}>: ${s}`;
-			console.warn(`[pracht] ${message}`);
-			appendHydrationWarning(message);
-			if (prev) prev(vnode, s);
-		};
-	}
 	const initialTarget = resolveBrowserRouteTarget(options.initialState.url);
 	const initialRequestUrl = initialTarget?.requestUrl ?? options.initialState.url;
 	const initialBrowserUrl = initialTarget?.browserUrl ?? options.initialState.url;
@@ -1177,9 +1440,9 @@ async function initClientRouter(options) {
 			error: options.initialState.error ?? null
 		};
 		if (initialMatch.route.render === "spa" && options.initialState.pending) {
-			const dataPromise = fetchPrachtRouteState(initialRequestUrl);
-			const pendingTree = await buildSpaPendingTree(initialMatch, initialRequestUrl, initialShellPromise);
-			if (pendingTree) hydrate(pendingTree, root);
+			const dataPromise = fetchPrachtRouteState(initialRequestUrl, { useDataParam: true });
+			const pendingState = await resolveSpaPendingState(initialMatch, initialRequestUrl, initialShellPromise);
+			if (pendingState) hydrate(h(RouterRoot, { initialState: pendingState }), root);
 			try {
 				const result = await dataPromise;
 				if (result.type === "redirect") {
@@ -1198,12 +1461,15 @@ async function initClientRouter(options) {
 				window.location.href = initialBrowserUrl;
 				return;
 			}
-		}
-		const tree = await buildRouteTree(initialMatch, state, initialRequestUrl, void 0, initialShellPromise);
-		if (tree) if (initialMatch.route.render === "spa") render(tree, root);
-		else {
-			markHydrating();
-			hydrate(tree, root);
+			const resolvedState = await resolveRouteState(initialMatch, state, initialRequestUrl, void 0, initialShellPromise);
+			if (resolvedState) applyRouteState(resolvedState);
+		} else {
+			const initialRouteState = await resolveRouteState(initialMatch, state, initialRequestUrl, void 0, initialShellPromise);
+			if (initialRouteState) if (initialMatch.route.render === "spa") render(h(RouterRoot, { initialState: initialRouteState }), root);
+			else {
+				markHydrating();
+				hydrate(h(RouterRoot, { initialState: initialRouteState }), root);
+			}
 		}
 	}
 	document.addEventListener("click", (e) => {
@@ -1238,61 +1504,6 @@ async function initClientRouter(options) {
 	};
 	setupPrefetching(app, warmModules);
 }
-const HYDRATION_BANNER_ID = "__pracht_hydration_warnings__";
-function appendHydrationWarning(message) {
-	let container = document.getElementById(HYDRATION_BANNER_ID);
-	if (!container) {
-		container = document.createElement("div");
-		container.id = HYDRATION_BANNER_ID;
-		Object.assign(container.style, {
-			position: "fixed",
-			bottom: "0",
-			left: "0",
-			right: "0",
-			maxHeight: "30vh",
-			overflow: "auto",
-			background: "#2d1b00",
-			borderTop: "2px solid #f0ad4e",
-			color: "#ffc107",
-			fontFamily: "ui-monospace, Consolas, monospace",
-			fontSize: "13px",
-			padding: "12px 16px",
-			zIndex: "2147483647"
-		});
-		const header = document.createElement("div");
-		Object.assign(header.style, {
-			display: "flex",
-			justifyContent: "space-between",
-			alignItems: "center",
-			marginBottom: "8px"
-		});
-		header.innerHTML = "<strong style=\"color:#f0ad4e\">⚠ Hydration Mismatches</strong>";
-		const close = document.createElement("button");
-		close.textContent = "×";
-		Object.assign(close.style, {
-			background: "none",
-			border: "none",
-			color: "#f0ad4e",
-			fontSize: "18px",
-			cursor: "pointer"
-		});
-		close.onclick = () => container.remove();
-		header.appendChild(close);
-		container.appendChild(header);
-		document.body.appendChild(container);
-	}
-	const entry = document.createElement("div");
-	entry.textContent = message;
-	Object.assign(entry.style, { padding: "2px 0" });
-	container.appendChild(entry);
-}
-function deserializeRouteError(error) {
-	const result = new Error(error.message);
-	result.name = error.name;
-	result.status = error.status;
-	result.diagnostics = error.diagnostics;
-	return result;
-}
 function resolveBrowserRouteTarget(to) {
 	if (typeof window === "undefined") return null;
 	try {
@@ -1318,4 +1529,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, useRevalidateRoute, useRouteData };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pracht/core",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "license": "MIT",
   "homepage": "https://github.com/JoviDeCroock/pracht/tree/main/packages/framework",
   "bugs": {

package/dist/app-CUL3q2ZA.mjs

@@ -1,259 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-//#region src/app.ts
-var app_exports = /* @__PURE__ */ __exportAll({
-	buildPathFromSegments: () => buildPathFromSegments,
-	defineApp: () => defineApp,
-	group: () => group,
-	matchApiRoute: () => matchApiRoute,
-	matchAppRoute: () => matchAppRoute,
-	resolveApiRoutes: () => resolveApiRoutes,
-	resolveApp: () => resolveApp,
-	route: () => route,
-	timeRevalidate: () => timeRevalidate
-});
-function timeRevalidate(seconds) {
-	if (!Number.isInteger(seconds) || seconds <= 0) throw new Error("timeRevalidate expects a positive integer number of seconds.");
-	return {
-		kind: "time",
-		seconds
-	};
-}
-function route(path, fileOrConfig, meta = {}) {
-	if (typeof fileOrConfig === "string" || typeof fileOrConfig === "function") return {
-		kind: "route",
-		path: normalizeRoutePath(path),
-		file: resolveModuleRef(fileOrConfig),
-		...meta
-	};
-	const { component, loader, ...routeMeta } = fileOrConfig;
-	return {
-		kind: "route",
-		path: normalizeRoutePath(path),
-		file: resolveModuleRef(component),
-		loaderFile: resolveModuleRef(loader),
-		...routeMeta
-	};
-}
-function resolveModuleRef(ref) {
-	if (ref === void 0) return void 0;
-	if (typeof ref === "string") return ref;
-	return "";
-}
-function group(meta, routes) {
-	return {
-		kind: "group",
-		meta,
-		routes
-	};
-}
-function defineApp(config) {
-	return {
-		shells: resolveModuleRefRecord(config.shells ?? {}),
-		middleware: resolveModuleRefRecord(config.middleware ?? {}),
-		api: config.api ?? {},
-		routes: config.routes
-	};
-}
-function resolveModuleRefRecord(record) {
-	const result = {};
-	for (const [key, value] of Object.entries(record)) result[key] = resolveModuleRef(value);
-	return result;
-}
-function resolveApp(app) {
-	const routes = [];
-	const inherited = {
-		pathPrefix: "/",
-		middleware: []
-	};
-	for (const node of app.routes) flattenRouteNode(app, node, inherited, routes);
-	return {
-		shells: app.shells,
-		middleware: app.middleware,
-		api: app.api,
-		routes,
-		apiRoutes: []
-	};
-}
-function matchAppRoute(app, pathname) {
-	const resolved = isResolvedApp(app) ? app : resolveApp(app);
-	const normalizedPathname = normalizeRoutePath(pathname);
-	const targetSegments = splitPathSegments(normalizedPathname);
-	for (const currentRoute of resolved.routes) {
-		const params = matchRouteSegments(currentRoute.segments, targetSegments);
-		if (params) return {
-			route: currentRoute,
-			params,
-			pathname: normalizedPathname
-		};
-	}
-}
-function flattenRouteNode(app, node, inherited, routes) {
-	if (node.kind === "group") {
-		const nextInherited = {
-			pathPrefix: mergeRoutePaths(inherited.pathPrefix, node.meta.pathPrefix),
-			shell: node.meta.shell ?? inherited.shell,
-			render: node.meta.render ?? inherited.render,
-			middleware: [...inherited.middleware, ...node.meta.middleware ?? []]
-		};
-		for (const child of node.routes) flattenRouteNode(app, child, nextInherited, routes);
-		return;
-	}
-	const fullPath = mergeRoutePaths(inherited.pathPrefix, node.path);
-	const shell = node.shell ?? inherited.shell;
-	const middleware = [...inherited.middleware, ...node.middleware ?? []];
-	routes.push({
-		id: node.id ?? createRouteId(fullPath),
-		path: fullPath,
-		file: node.file,
-		loaderFile: node.loaderFile,
-		shell,
-		shellFile: shell ? app.shells[shell] : void 0,
-		render: node.render ?? inherited.render,
-		middleware,
-		middlewareFiles: middleware.flatMap((name) => {
-			const middlewareFile = app.middleware[name];
-			return middlewareFile ? [middlewareFile] : [];
-		}),
-		revalidate: node.revalidate,
-		segments: parseRouteSegments(fullPath)
-	});
-}
-function isResolvedApp(app) {
-	return app.routes.length === 0 || "segments" in app.routes[0];
-}
-function matchRouteSegments(routeSegments, targetSegments) {
-	const params = {};
-	let routeIndex = 0;
-	let targetIndex = 0;
-	while (routeIndex < routeSegments.length) {
-		const currentSegment = routeSegments[routeIndex];
-		if (currentSegment.type === "catchall") {
-			params[currentSegment.name] = targetSegments.slice(targetIndex).join("/");
-			return params;
-		}
-		const targetSegment = targetSegments[targetIndex];
-		if (typeof targetSegment === "undefined") return null;
-		if (currentSegment.type === "static") {
-			if (currentSegment.value !== targetSegment) return null;
-		} else try {
-			params[currentSegment.name] = decodeURIComponent(targetSegment);
-		} catch {
-			return null;
-		}
-		routeIndex += 1;
-		targetIndex += 1;
-	}
-	return targetIndex === targetSegments.length ? params : null;
-}
-function parseRouteSegments(path) {
-	return splitPathSegments(path).map((segment) => {
-		if (segment === "*") return {
-			type: "catchall",
-			name: "*"
-		};
-		if (segment.startsWith(":")) return {
-			type: "param",
-			name: segment.slice(1)
-		};
-		return {
-			type: "static",
-			value: segment
-		};
-	});
-}
-function splitPathSegments(path) {
-	return normalizeRoutePath(path).split("/").filter(Boolean);
-}
-function mergeRoutePaths(prefix, path) {
-	if (!path) return normalizeRoutePath(prefix);
-	const normalizedPrefix = normalizeRoutePath(prefix);
-	const normalizedPath = normalizeRoutePath(path);
-	if (normalizedPrefix === "/") return normalizedPath;
-	if (normalizedPath === "/") return normalizedPrefix;
-	return normalizeRoutePath(`${normalizedPrefix}/${normalizedPath.slice(1)}`);
-}
-function normalizeRoutePath(path) {
-	if (!path || path === "/") return "/";
-	const collapsed = (path.startsWith("/") ? path : `/${path}`).replace(/\/{2,}/g, "/");
-	return collapsed.length > 1 && collapsed.endsWith("/") ? collapsed.slice(0, -1) : collapsed;
-}
-function buildPathFromSegments(segments, params) {
-	return normalizeRoutePath("/" + segments.map((segment) => {
-		if (segment.type === "static") return segment.value;
-		if (segment.type === "param") return encodeURIComponent(params[segment.name] ?? "");
-		return params["*"] ?? "";
-	}).join("/"));
-}
-/**
-* Convert a list of file paths from `import.meta.glob` into resolved API routes.
-*
-* Example: `"/src/api/health.ts"` → path `/api/health`
-*          `"/src/api/users/[id].ts"` → path `/api/users/:id`
-*          `"/src/api/index.ts"` → path `/api`
-*/
-function resolveApiRoutes(files, apiDir = "/src/api") {
-	const normalizedDir = apiDir.replace(/\/$/, "");
-	return files.map((file) => {
-		let relative = file;
-		if (relative.startsWith(normalizedDir)) relative = relative.slice(normalizedDir.length);
-		relative = relative.replace(/\.(ts|tsx|js|jsx)$/, "");
-		if (relative.endsWith("/index")) relative = relative.slice(0, -6) || "/";
-		relative = relative.replace(/\[([^\]]+)\]/g, ":$1");
-		const path = normalizeRoutePath(`/api${relative}`);
-		return {
-			path,
-			file,
-			segments: parseRouteSegments(path)
-		};
-	}).sort(compareResolvedApiRoutes);
-}
-function matchApiRoute(apiRoutes, pathname) {
-	const normalizedPathname = normalizeRoutePath(pathname);
-	const targetSegments = splitPathSegments(normalizedPathname);
-	for (const route of apiRoutes) {
-		const params = matchRouteSegments(route.segments, targetSegments);
-		if (params) return {
-			route,
-			params,
-			pathname: normalizedPathname
-		};
-	}
-}
-function createRouteId(path) {
-	if (path === "/") return "index";
-	return path.slice(1).split("/").map((segment) => {
-		if (segment === "*") return "splat";
-		return segment.startsWith(":") ? segment.slice(1) : segment;
-	}).join("-").replace(/[^a-zA-Z0-9-]/g, "-");
-}
-function compareResolvedApiRoutes(left, right) {
-	const length = Math.max(left.segments.length, right.segments.length);
-	for (let index = 0; index < length; index += 1) {
-		const leftSegment = left.segments[index];
-		const rightSegment = right.segments[index];
-		if (!leftSegment) return 1;
-		if (!rightSegment) return -1;
-		const leftScore = getRouteSegmentSpecificity(leftSegment);
-		const rightScore = getRouteSegmentSpecificity(rightSegment);
-		if (leftScore !== rightScore) return rightScore - leftScore;
-	}
-	return left.path.localeCompare(right.path);
-}
-function getRouteSegmentSpecificity(segment) {
-	if (segment.type === "static") return 3;
-	if (segment.type === "param") return 2;
-	return 1;
-}
-//#endregion
-export { matchApiRoute as a, resolveApp as c, group as i, route as l, buildPathFromSegments as n, matchAppRoute as o, defineApp as r, resolveApiRoutes as s, app_exports as t, timeRevalidate as u };