@pracht/core 0.8.1 → 0.9.0

package/README.md

@@ -36,13 +36,17 @@ 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
+- `useRouteData()` — access loader data inside a route component; pass a route
+  id for fully typed data after `pracht typegen`, or a `typeof loader` generic
+  otherwise
 - `useRevalidate()` — trigger a revalidation of the current route's data
 - `<Form>` — progressive enhancement form component
 
 ### Types
 
 - `LoaderData<T>` — infer the return type of a loader
+- `RouteLoaderData<TModule, TFallbackModule?>` — infer loader data from a route
+  module type; used by `pracht typegen` to key loader data by route id
 - `RouteComponentProps<T>` — props type for route components
 - `LoaderArgs` — argument type passed to loaders
 

package/dist/app-BN3pjxtw.d.mts

@@ -0,0 +1,24 @@
+import { F as PrachtApp, G as RouteConfig, H as ResolvedPrachtApp, I as PrachtAppConfig, J as RouteId, M as ModuleRef, V as ResolvedApiRoute, X as RouteMatch, Z as RouteMeta, _ as HrefArgs, b as HrefRouteDefinition, d as GroupMeta, et as RouteParams, ft as TimeRevalidatePolicy, i as ApiRouteMatch, it as RouteSegment, ot as RouteTreeNode, q as RouteDefinition, u as GroupDefinition } from "./types-B-sfVjaH.mjs";
+
+//#region src/app.d.ts
+declare function timeRevalidate(seconds: number): TimeRevalidatePolicy;
+declare function route(path: string, file: ModuleRef, meta?: RouteMeta): RouteDefinition;
+declare function route(path: string, config: RouteConfig): RouteDefinition;
+declare function group(meta: GroupMeta, routes: RouteTreeNode[]): GroupDefinition;
+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: readonly RouteSegment[], params: RouteParams): string;
+declare function buildHref<TRoute extends RouteId>(routes: readonly HrefRouteDefinition[], routeId: TRoute, ...args: HrefArgs<TRoute>): string;
+/**
+ * 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/files/[...path].ts"` → path `/api/files/*`
+ *          `"/src/api/index.ts"` → path `/api`
+ */
+declare function resolveApiRoutes(files: string[], apiDir?: string): ResolvedApiRoute[];
+declare function matchApiRoute(apiRoutes: ResolvedApiRoute[], pathname: string): ApiRouteMatch | undefined;
+//#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, buildHref as t, timeRevalidate as u };

package/dist/{app-w-P1wf5T.mjs → app-CGRKjZ6Z.mjs}

@@ -1,3 +1,61 @@
+//#region src/name-suggestions.ts
+/**
+* "Did you mean" helpers for manifest wiring errors.
+*
+* When a route references an unknown shell, middleware, or route id, the
+* error message includes the closest registered name plus the full list of
+* registered names. A tiny internal edit-distance implementation keeps this
+* dependency-free.
+*/
+/** Classic Levenshtein edit distance using two rolling rows. */
+function levenshteinDistance(a, b) {
+	if (a === b) return 0;
+	if (a.length === 0) return b.length;
+	if (b.length === 0) return a.length;
+	let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+	let current = Array.from({ length: b.length + 1 });
+	for (let i = 1; i <= a.length; i += 1) {
+		current[0] = i;
+		for (let j = 1; j <= b.length; j += 1) {
+			const substitution = previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1);
+			current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, substitution);
+		}
+		[previous, current] = [current, previous];
+	}
+	return previous[b.length];
+}
+/**
+* Return the candidate closest to `input`, or `undefined` when nothing is
+* close enough to be a plausible typo. The threshold scales with the input
+* length (roughly a third of it, minimum 2 edits).
+*/
+function closestName(input, candidates) {
+	let best;
+	let bestDistance = Infinity;
+	for (const candidate of candidates) {
+		const distance = levenshteinDistance(input.toLowerCase(), candidate.toLowerCase());
+		if (distance < bestDistance) {
+			bestDistance = distance;
+			best = candidate;
+		}
+	}
+	const threshold = Math.max(2, Math.floor(input.length / 3));
+	return bestDistance <= threshold ? best : void 0;
+}
+/**
+* Format an enriched wiring error, e.g.
+* `Unknown shell "pubic" for route "/". Did you mean "public"? Registered shells: public, app.`
+*/
+function formatUnknownNameError(options) {
+	const { kind, name, registered, context } = options;
+	const kindPlural = options.kindPlural ?? `${kind}s`;
+	let message = `Unknown ${kind} "${name}"${context ? ` for ${context}` : ""}.`;
+	const suggestion = closestName(name, registered);
+	if (suggestion) message += ` Did you mean "${suggestion}"?`;
+	message += registered.length > 0 ? ` Registered ${kindPlural}: ${registered.join(", ")}.` : ` No ${kindPlural} are registered in defineApp().`;
+	return message;
+}
+//#endregion
 //#region src/app.ts
 function timeRevalidate(seconds) {
 	if (!Number.isInteger(seconds) || seconds <= 0) throw new Error("timeRevalidate expects a positive integer number of seconds.");
@@ -40,7 +98,8 @@ function defineApp(config) {
 		shells: resolveModuleRefRecord(config.shells ?? {}),
 		middleware: resolveModuleRefRecord(config.middleware ?? {}),
 		api: config.api ?? {},
-		routes: config.routes
+		routes: config.routes,
+		viewTransitions: config.viewTransitions
 	};
 }
 function resolveModuleRefRecord(record) {
@@ -54,13 +113,21 @@ function resolveApp(app) {
 		pathPrefix: "/",
 		middleware: []
 	};
+	for (const name of app.api?.middleware ?? []) if (!hasOwnEntry(app.middleware, name)) throw new Error(formatUnknownNameError({
+		kind: "middleware",
+		kindPlural: "middleware",
+		name,
+		registered: Object.keys(app.middleware),
+		context: "api routes"
+	}));
 	for (const node of app.routes) flattenRouteNode(app, node, inherited, routes);
 	return {
 		shells: app.shells,
 		middleware: app.middleware,
 		api: app.api,
 		routes,
-		apiRoutes: []
+		apiRoutes: [],
+		viewTransitions: app.viewTransitions
 	};
 }
 function matchAppRoute(app, pathname) {
@@ -90,6 +157,12 @@ function flattenRouteNode(app, node, inherited, routes) {
 	const fullPath = mergeRoutePaths(inherited.pathPrefix, node.path);
 	const shell = node.shell ?? inherited.shell;
 	const middleware = [...inherited.middleware, ...node.middleware ?? []];
+	if (shell !== void 0 && !hasOwnEntry(app.shells, shell)) throw new Error(formatUnknownNameError({
+		kind: "shell",
+		name: shell,
+		registered: Object.keys(app.shells),
+		context: `route "${fullPath}"`
+	}));
 	routes.push({
 		id: node.id ?? createRouteId(fullPath),
 		path: fullPath,
@@ -97,17 +170,28 @@ function flattenRouteNode(app, node, inherited, routes) {
 		loaderFile: node.loaderFile,
 		hasLoader: node.loaderFile ? true : node.hasLoader,
 		shell,
-		shellFile: shell ? app.shells[shell] : void 0,
+		shellFile: shell !== void 0 ? app.shells[shell] : void 0,
 		render: node.render ?? inherited.render,
 		middleware,
-		middlewareFiles: middleware.flatMap((name) => {
-			const middlewareFile = app.middleware[name];
-			return middlewareFile ? [middlewareFile] : [];
+		middlewareFiles: middleware.map((name) => {
+			if (!hasOwnEntry(app.middleware, name)) throw new Error(formatUnknownNameError({
+				kind: "middleware",
+				kindPlural: "middleware",
+				name,
+				registered: Object.keys(app.middleware),
+				context: `route "${fullPath}"`
+			}));
+			return app.middleware[name];
 		}),
+		prefetch: node.prefetch,
 		revalidate: node.revalidate,
 		segments: parseRouteSegments(fullPath)
 	});
 }
+/** `in` would also match `Object.prototype` keys such as `constructor`. */
+function hasOwnEntry(record, name) {
+	return Object.prototype.hasOwnProperty.call(record, name);
+}
 function isResolvedApp(app) {
 	return app.routes.length === 0 || "segments" in app.routes[0];
 }
@@ -192,7 +276,12 @@ function buildHref(routes, routeId, ...args) {
 }
 function buildHrefUntyped(routes, routeId, options = {}) {
 	const route = routes.find((candidate) => candidate.id === routeId);
-	if (!route) throw new Error(`Unknown pracht route id: ${routeId}.`);
+	if (!route) throw new Error(formatUnknownNameError({
+		kind: "pracht route id",
+		kindPlural: "route ids",
+		name: routeId,
+		registered: routes.flatMap((candidate) => candidate.id ? [candidate.id] : [])
+	}));
 	const segments = route.segments ?? parseRouteSegments(route.path);
 	return `${buildPathFromSegments(segments, normalizeHrefParams(segments, options.params ?? {}))}${serializeSearch(options.search)}${serializeHash(options.hash)}`;
 }

package/dist/app-graph-BlaCcGUZ.mjs

@@ -0,0 +1,52 @@
+//#region src/app-graph.ts
+const API_METHOD_ORDER = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"HEAD",
+	"OPTIONS"
+];
+function serializeAppRoutes(routes) {
+	return routes.map((route) => ({
+		file: route.file,
+		id: route.id ?? "",
+		loaderFile: route.loaderFile ?? null,
+		middleware: route.middleware,
+		path: route.path,
+		render: route.render ?? null,
+		revalidate: route.revalidate ?? null,
+		shell: route.shell ?? null,
+		shellFile: route.shellFile ?? null
+	}));
+}
+function serializeApiRoutes(apiRoutes, access) {
+	return Promise.all(apiRoutes.map(async (route) => ({
+		file: route.file,
+		methods: await detectApiMethods(route.file, access),
+		path: route.path
+	})));
+}
+async function buildAppGraph(options) {
+	return {
+		api: await serializeApiRoutes(options.apiRoutes ?? [], options),
+		routes: serializeAppRoutes(options.app.routes)
+	};
+}
+async function detectApiMethods(file, access) {
+	try {
+		const module = await access.loadModule(file);
+		return API_METHOD_ORDER.filter((method) => typeof module[method] === "function");
+	} catch {
+		let source;
+		try {
+			source = access.readSource(file);
+		} catch {
+			return [];
+		}
+		return API_METHOD_ORDER.filter((method) => new RegExp(`export\\s+(?:async\\s+)?(?:function|const|let|var)\\s+${method}\\b`).test(source));
+	}
+}
+//#endregion
+export { serializeAppRoutes as i, detectApiMethods as n, serializeApiRoutes as r, buildAppGraph as t };

package/dist/app-graph-DBoDsHJ5.d.mts

@@ -0,0 +1,38 @@
+import { H as ResolvedPrachtApp, U as ResolvedRoute, V as ResolvedApiRoute, x as HttpMethod } from "./types-B-sfVjaH.mjs";
+
+//#region src/app-graph.d.ts
+interface AppGraphRoute {
+  file: string;
+  id: string;
+  loaderFile: string | null;
+  middleware: string[];
+  path: string;
+  render: string | null;
+  revalidate: unknown;
+  shell: string | null;
+  shellFile: string | null;
+}
+interface AppGraphApiRoute {
+  file: string;
+  methods: string[];
+  path: string;
+}
+interface AppGraph {
+  api: AppGraphApiRoute[];
+  routes: AppGraphRoute[];
+}
+interface AppGraphModuleAccess {
+  /** Import an app module by its app-relative file path (e.g. Vite's `ssrLoadModule`). */
+  loadModule: (file: string) => Promise<Record<string, unknown>>;
+  /** Read an app module's source text — fallback method detection when importing fails. */
+  readSource: (file: string) => string;
+}
+declare function serializeAppRoutes(routes: readonly ResolvedRoute[]): AppGraphRoute[];
+declare function serializeApiRoutes(apiRoutes: readonly ResolvedApiRoute[], access: AppGraphModuleAccess): Promise<AppGraphApiRoute[]>;
+declare function buildAppGraph(options: {
+  apiRoutes?: readonly ResolvedApiRoute[];
+  app: ResolvedPrachtApp;
+} & AppGraphModuleAccess): Promise<AppGraph>;
+declare function detectApiMethods(file: string, access: AppGraphModuleAccess): Promise<HttpMethod[]>;
+//#endregion
+export { buildAppGraph as a, serializeAppRoutes as c, AppGraphRoute as i, AppGraphApiRoute as n, detectApiMethods as o, AppGraphModuleAccess as r, serializeApiRoutes as s, AppGraph as t };

package/dist/browser.d.mts

@@ -1,7 +1,8 @@
-import { $ as RouteComponentProps, A as HrefRouteDefinition, B as ModuleImporter, C as HeadAttributes, D as HrefArgs, E as HeadersArgs, G as PrachtAppConfig, H as ModuleRegistry, I as MiddlewareArgs, J as Register, K as PrachtHttpError, L as MiddlewareFn, M as LoaderArgs, N as LoaderData, O as HrefFn, P as LoaderFn, Q as ResolvedRoute, R as MiddlewareModule, S as HeadArgs, T as HeadScriptDescriptor, U as NavigateOptions, V as ModuleRef, W as PrachtApp, X as ResolvedApiRoute, Y as RenderMode, Z as ResolvedPrachtApp, _ as BuildHrefOptions, _t as ShellProps, at as RouteModule, b as GroupDefinition, c as resolveApp, ct as RouteParamsFor, d as ApiConfig, dt as RouteTarget, et as RouteConfig, f as ApiRouteArgs, ft as RouteTreeNode, g as BaseRouteArgs, gt as ShellModule, h as ApiRouteModule, ht as SearchParamsInput, i as group, it as RouteMeta, j as HttpMethod, k as HrefOptions, l as route, lt as RouteRevalidate, m as ApiRouteMatch, mt as SearchParamValue, n as buildPathFromSegments, nt as RouteId, o as matchAppRoute, ot as RouteParamInput, p as ApiRouteHandler, pt as SearchParamPrimitive, q as PrefetchStrategy, r as defineApp, rt as RouteMatch, st as RouteParams, t as buildHref, tt as RouteDefinition, u as timeRevalidate, ut as RouteSearchFor, v as DataModule, vt as TimeRevalidatePolicy, w as HeadMetadata, x as GroupMeta, y as ErrorBoundaryProps, z as MiddlewareNext } from "./app-BWriseLj.mjs";
-import { a as parseSafeNavigationUrl, c as Link, d as useLocation, f as useParams, h as createHref, i as fetchPrachtRouteState, l as LinkProps, m as useRouteData, n as redirect, o as Form, p as useRevalidate, r as RouteStateResult, s as FormProps, t as RedirectOptions, u as Location } from "./runtime-middleware-aeBdgjYr.mjs";
-import { n as forwardRef, t as useIsHydrated } from "./hydration-M1QzbQ1O.mjs";
-import { a as startApp, c as SerializedRouteError, i as readHydrationState, n as PrachtRuntimeProvider, r as StartAppOptions, t as PrachtHydrationState } from "./runtime-context-ytVd7GmZ.mjs";
-import { i as useNavigate, n as NavigateFn, r as initClientRouter, t as InitClientRouterOptions } from "./router-BcUmg1kB.mjs";
+import { $ as RouteParamInput, A as MiddlewareNext, B as RenderMode, C as LoaderArgs, D as MiddlewareArgs, F as PrachtApp, G as RouteConfig, H as ResolvedPrachtApp, I as PrachtAppConfig, J as RouteId, K as RouteDataFor, L as PrachtHttpError, M as ModuleRef, N as ModuleRegistry, O as MiddlewareFn, P as NavigateOptions, Q as RouteModule, R as PrefetchStrategy, S as LinkPrefetchStrategy, T as LoaderFn, U as ResolvedRoute, V as ResolvedApiRoute, W as RouteComponentProps, X as RouteMatch, Y as RouteLoaderData, Z as RouteMeta, _ as HrefArgs, a as ApiRouteModule, at as RouteTarget, b as HrefRouteDefinition, c as DataModule, ct as SearchParamValue, d as GroupMeta, dt as ShellProps, et as RouteParams, f as HeadArgs, ft as TimeRevalidatePolicy, g as HeadersArgs, h as HeadScriptDescriptor, i as ApiRouteMatch, j as ModuleImporter, k as MiddlewareModule, l as ErrorBoundaryProps, lt as SearchParamsInput, m as HeadMetadata, n as ApiRouteArgs, nt as RouteRevalidate, o as BaseRouteArgs, ot as RouteTreeNode, p as HeadAttributes, q as RouteDefinition, r as ApiRouteHandler, rt as RouteSearchFor, s as BuildHrefOptions, st as SearchParamPrimitive, t as ApiConfig, tt as RouteParamsFor, u as GroupDefinition, ut as ShellModule, v as HrefFn, w as LoaderData, x as HttpMethod, y as HrefOptions, z as Register } from "./types-B-sfVjaH.mjs";
+import { c as resolveApp, i as group, l as route, n as buildPathFromSegments, o as matchAppRoute, r as defineApp, t as buildHref, u as timeRevalidate } from "./app-BN3pjxtw.mjs";
+import { _ as NavigationLocation, a as parseSafeNavigationUrl, c as Link, d as useLocation, f as useNavigation, g as Navigation, h as useRouteData, i as fetchPrachtRouteState, l as LinkProps, m as useRevalidate, n as redirect, o as Form, p as useParams, r as RouteStateResult, s as FormProps, t as RedirectOptions, u as Location, v as createHref } from "./runtime-middleware-pYubngnL.mjs";
+import { i as forwardRef, n as prefetch, r as useIsHydrated, t as PrefetchFn } from "./prefetch-api-Bf-P7XFo.mjs";
+import { a as startApp, c as SerializedRouteError, i as readHydrationState, n as PrachtRuntimeProvider, r as StartAppOptions, t as PrachtHydrationState } from "./runtime-context-BYBwVA0M.mjs";
+import { i as useNavigate, n as NavigateFn, r as initClientRouter, t as InitClientRouterOptions } from "./router-B_Aj5TtY.mjs";
 import { Suspense, lazy } from "preact-suspense";
-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 HeadArgs, type HeadAttributes, type HeadMetadata, type HeadScriptDescriptor, type HeadersArgs, type HrefArgs, type HrefFn, type HrefOptions, type HrefRouteDefinition, type HttpMethod, type InitClientRouterOptions, Link, type LinkProps, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareNext, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type NavigateOptions, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, PrachtRuntimeProvider, type PrefetchStrategy, type RedirectOptions, 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, buildHref, buildPathFromSegments, createHref, defineApp, fetchPrachtRouteState, forwardRef, group, initClientRouter, lazy, matchAppRoute, parseSafeNavigationUrl, readHydrationState, redirect, 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 HeadArgs, type HeadAttributes, type HeadMetadata, type HeadScriptDescriptor, type HeadersArgs, type HrefArgs, type HrefFn, type HrefOptions, type HrefRouteDefinition, type HttpMethod, type InitClientRouterOptions, Link, type LinkPrefetchStrategy, type LinkProps, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareNext, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type NavigateOptions, type Navigation, type NavigationLocation, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, PrachtRuntimeProvider, type PrefetchFn, type PrefetchStrategy, type RedirectOptions, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDataFor, type RouteDefinition, type RouteId, type RouteLoaderData, 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, buildHref, buildPathFromSegments, createHref, defineApp, fetchPrachtRouteState, forwardRef, group, initClientRouter, lazy, matchAppRoute, parseSafeNavigationUrl, prefetch, readHydrationState, redirect, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useNavigation, useParams, useRevalidate, useRouteData };

package/dist/browser.mjs

@@ -1,8 +1,9 @@
-import { c as resolveApp, i as group, l as route, n as buildPathFromSegments, o as matchAppRoute, r as defineApp, t as buildHref, u as timeRevalidate } from "./app-w-P1wf5T.mjs";
-import { S as createHref, a as useParams, i as useLocation, n as Form, o as useRevalidate, r as Link, s as useRouteData, t as PrachtHttpError, u as redirect } from "./types-DQv2poC5.mjs";
-import { t as forwardRef } from "./forwardRef-grZ6t4GS.mjs";
-import { n as useNavigate, r as useIsHydrated, t as initClientRouter } from "./router-BkkyNjqB.mjs";
-import { l as parseSafeNavigationUrl, s as fetchPrachtRouteState } from "./prefetch-cache-DzP2Bj9H.mjs";
-import { i as startApp, r as readHydrationState, t as PrachtRuntimeProvider } from "./runtime-context-B5pREhcM.mjs";
+import { c as resolveApp, i as group, l as route, n as buildPathFromSegments, o as matchAppRoute, r as defineApp, t as buildHref, u as timeRevalidate } from "./app-CGRKjZ6Z.mjs";
+import { C as createHref, a as useNavigation, c as useRouteData, d as redirect, i as useLocation, n as Form, o as useParams, r as Link, s as useRevalidate, t as PrachtHttpError } from "./types-DEPXdbyp.mjs";
+import { t as forwardRef } from "./forwardRef-B0cSkHwH.mjs";
+import { n as useNavigate, r as useIsHydrated, t as initClientRouter } from "./router-E5Wh-dOR.mjs";
+import { c as fetchPrachtRouteState, u as parseSafeNavigationUrl } from "./prefetch-cache-BNLEp9H5.mjs";
+import { l as readHydrationState, s as PrachtRuntimeProvider, u as startApp } from "./navigation-state-BjwXTeVz.mjs";
+import { t as prefetch } from "./prefetch-api-ChSCTbEB.mjs";
 import { Suspense, lazy } from "preact-suspense";
-export { Form, Link, PrachtHttpError, PrachtRuntimeProvider, Suspense, buildHref, buildPathFromSegments, createHref, defineApp, fetchPrachtRouteState, forwardRef, group, initClientRouter, lazy, matchAppRoute, parseSafeNavigationUrl, readHydrationState, redirect, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };
+export { Form, Link, PrachtHttpError, PrachtRuntimeProvider, Suspense, buildHref, buildPathFromSegments, createHref, defineApp, fetchPrachtRouteState, forwardRef, group, initClientRouter, lazy, matchAppRoute, parseSafeNavigationUrl, prefetch, readHydrationState, redirect, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useNavigation, useParams, useRevalidate, useRouteData };

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { c as resolveApp } from "./app-BWriseLj.mjs";
-import { i as readHydrationState, t as PrachtHydrationState } from "./runtime-context-ytVd7GmZ.mjs";
-import { n as NavigateFn, r as initClientRouter, t as InitClientRouterOptions } from "./router-BcUmg1kB.mjs";
+import { c as resolveApp } from "./app-BN3pjxtw.mjs";
+import { i as readHydrationState, t as PrachtHydrationState } from "./runtime-context-BYBwVA0M.mjs";
+import { n as NavigateFn, r as initClientRouter, t as InitClientRouterOptions } from "./router-B_Aj5TtY.mjs";
 export { type InitClientRouterOptions, type NavigateFn, type PrachtHydrationState, initClientRouter, readHydrationState, resolveApp };

package/dist/client.mjs

@@ -1,4 +1,4 @@
-import { c as resolveApp } from "./app-w-P1wf5T.mjs";
-import { t as initClientRouter } from "./router-BkkyNjqB.mjs";
-import { r as readHydrationState } from "./runtime-context-B5pREhcM.mjs";
+import { c as resolveApp } from "./app-CGRKjZ6Z.mjs";
+import { t as initClientRouter } from "./router-E5Wh-dOR.mjs";
+import { l as readHydrationState } from "./navigation-state-BjwXTeVz.mjs";
 export { initClientRouter, readHydrationState, resolveApp };

package/dist/dev-404.d.mts

@@ -0,0 +1,26 @@
+//#region src/dev-404.d.ts
+/**
+ * Self-contained 404 page for pracht dev mode.
+ *
+ * Returns a standalone HTML document with inline styles and scripts.
+ * Not a Preact component — rendered by the dev middleware when a request
+ * matches no page route and no API route. Loaded exclusively through the
+ * dev server (`@pracht/core/dev-404`) and never reachable from production
+ * code paths.
+ */
+interface DevNotFoundRoute {
+  path: string;
+  render?: string | null;
+}
+interface DevNotFoundApiRoute {
+  path: string;
+  methods?: string[];
+}
+interface DevNotFoundOptions {
+  requestedPath: string;
+  routes: DevNotFoundRoute[];
+  apiRoutes?: DevNotFoundApiRoute[];
+}
+declare function buildDevNotFoundHtml(options: DevNotFoundOptions): string;
+//#endregion
+export { DevNotFoundApiRoute, DevNotFoundOptions, DevNotFoundRoute, buildDevNotFoundHtml };

package/dist/dev-404.mjs

@@ -0,0 +1,166 @@
+//#region src/dev-404.ts
+const DYNAMIC_SEGMENT = /[:*]/;
+function buildDevNotFoundHtml(options) {
+	const { requestedPath, routes, apiRoutes = [] } = options;
+	const routeRows = routes.map((route) => {
+		const mode = route.render ?? "ssr";
+		return `<tr><td>${!DYNAMIC_SEGMENT.test(route.path) ? `<a class="path" href="${escapeHtml(route.path)}">${escapeHtml(route.path)}</a>` : `<span class="path dynamic">${escapeHtml(route.path)}</span>`}</td><td><span class="mode mode-${escapeHtml(mode)}">${escapeHtml(mode)}</span></td></tr>`;
+	}).join("\n      ");
+	const routesHtml = routes.length > 0 ? `<table class="routes">\n      ${routeRows}\n    </table>` : `<p class="empty">No page routes are registered.</p>`;
+	const apiRows = apiRoutes.map((route) => {
+		const methods = route.methods?.length ? route.methods.join(", ") : "";
+		return `<tr><td><span class="path">${escapeHtml(route.path)}</span></td><td><span class="methods">${escapeHtml(methods)}</span></td></tr>`;
+	}).join("\n      ");
+	const apiHtml = apiRoutes.length > 0 ? `<h2>API routes</h2>\n    <table class="routes">\n      ${apiRows}\n    </table>` : "";
+	return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>404 — pracht dev</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: ui-monospace, "Cascadia Code", "Source Code Pro", Menlo, Consolas, monospace;
+      background: #1a1a2e;
+      color: #e0e0e0;
+      padding: 32px;
+      line-height: 1.5;
+    }
+    .overlay {
+      max-width: 900px;
+      margin: 0 auto;
+    }
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      margin-bottom: 24px;
+      padding-bottom: 16px;
+      border-bottom: 1px solid #333;
+    }
+    .badge {
+      background: #f39c12;
+      color: #1a1a2e;
+      font-size: 11px;
+      font-weight: 700;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+      padding: 4px 10px;
+      border-radius: 4px;
+    }
+    .title {
+      font-size: 14px;
+      color: #888;
+    }
+    .message {
+      font-size: 18px;
+      font-weight: 600;
+      color: #ffd166;
+      margin-bottom: 8px;
+      word-break: break-word;
+    }
+    .requested {
+      color: #a0c4ff;
+    }
+    .sub {
+      font-size: 13px;
+      color: #888;
+      margin-bottom: 28px;
+    }
+    h2 {
+      font-size: 13px;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.08em;
+      color: #888;
+      margin: 28px 0 10px;
+    }
+    .routes {
+      width: 100%;
+      border-collapse: collapse;
+      background: #16162a;
+      border: 1px solid #333;
+      border-radius: 8px;
+      overflow: hidden;
+      font-size: 13px;
+    }
+    .routes td {
+      padding: 8px 16px;
+      border-bottom: 1px solid #262640;
+    }
+    .routes tr:last-child td {
+      border-bottom: none;
+    }
+    .routes td:last-child {
+      text-align: right;
+      width: 1%;
+      white-space: nowrap;
+    }
+    a.path {
+      color: #a0c4ff;
+      text-decoration: none;
+    }
+    a.path:hover {
+      text-decoration: underline;
+    }
+    .path.dynamic {
+      color: #ccc;
+    }
+    .mode {
+      font-size: 11px;
+      font-weight: 700;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+      padding: 2px 8px;
+      border-radius: 4px;
+      background: #262640;
+      color: #a0c4ff;
+    }
+    .mode-ssg { color: #7bd88f; }
+    .mode-isg { color: #5fd7d7; }
+    .mode-ssr { color: #ffd166; }
+    .mode-spa { color: #d7a0ff; }
+    .methods {
+      font-size: 12px;
+      color: #7bd88f;
+    }
+    .empty {
+      font-size: 13px;
+      color: #888;
+    }
+    .hint {
+      margin-top: 24px;
+      font-size: 12px;
+      color: #666;
+    }
+  </style>
+</head>
+<body>
+  <div class="overlay">
+    <div class="header">
+      <span class="badge">404</span>
+      <span class="title">pracht dev</span>
+    </div>
+    <div class="message">No route matches <span class="requested">${escapeHtml(requestedPath)}</span></div>
+    <div class="sub">This page is only shown in development — production serves your app's own 404 response.</div>
+    <h2>Page routes</h2>
+    ${routesHtml}
+    ${apiHtml}
+    <div class="hint">Add the route to your app manifest and save — the page will reload automatically.</div>
+  </div>
+  <script>
+    // Auto-reload when Vite triggers a full reload (e.g. a route was added)
+    if (import.meta.hot) {
+      import.meta.hot.on("vite:beforeFullReload", function () {
+        window.location.reload();
+      });
+    }
+  <\/script>
+</body>
+</html>`;
+}
+function escapeHtml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+//#endregion
+export { buildDevNotFoundHtml };

package/dist/devtools.d.mts

@@ -0,0 +1,8 @@
+import { a as buildAppGraph, c as serializeAppRoutes, i as AppGraphRoute, n as AppGraphApiRoute, o as detectApiMethods, r as AppGraphModuleAccess, s as serializeApiRoutes, t as AppGraph } from "./app-graph-DBoDsHJ5.mjs";
+
+//#region src/devtools.d.ts
+declare const DEVTOOLS_PATH = "/_pracht";
+declare const DEVTOOLS_JSON_PATH = "/_pracht.json";
+declare function buildDevtoolsHtml(graph: AppGraph): string;
+//#endregion
+export { type AppGraph, type AppGraphApiRoute, type AppGraphModuleAccess, type AppGraphRoute, DEVTOOLS_JSON_PATH, DEVTOOLS_PATH, buildAppGraph, buildDevtoolsHtml, detectApiMethods, serializeApiRoutes, serializeAppRoutes };