@pracht/core 0.8.0 → 0.8.1

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

@@ -26,7 +26,7 @@ function route(path, fileOrConfig, meta = {}) {
 function resolveModuleRef(ref) {
 	if (ref === void 0) return void 0;
 	if (typeof ref === "string") return ref;
-	return "";
+	throw new Error("Invalid ModuleRef: expected a string path, but received a function at runtime. Use a plain string path (e.g. \"./routes/home.tsx\"), or ensure the Vite plugin rewrites inline `() => import(\"./file\")` refs in the app manifest.");
 }
 function group(meta, routes) {
 	return {

package/dist/browser.mjs

@@ -1,7 +1,7 @@
-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-BvC1uQG5.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-idmK5omD.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-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-B7J4YYwg.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 { Suspense, lazy } from "preact-suspense";

package/dist/client.mjs

@@ -1,4 +1,4 @@
-import { c as resolveApp } from "./app-BvC1uQG5.mjs";
-import { t as initClientRouter } from "./router-B7J4YYwg.mjs";
+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";
 export { initClientRouter, readHydrationState, resolveApp };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-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, t as buildHref, u as timeRevalidate } from "./app-BvC1uQG5.mjs";
-import { S as createHref, _ as applyDefaultSecurityHeaders, 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-idmK5omD.mjs";
+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, t as buildHref, u as timeRevalidate } from "./app-w-P1wf5T.mjs";
+import { S as createHref, _ as applyDefaultSecurityHeaders, 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-B7J4YYwg.mjs";
+import { n as useNavigate, r as useIsHydrated, t as initClientRouter } from "./router-BkkyNjqB.mjs";
 import { i as startApp, r as readHydrationState, t as PrachtRuntimeProvider } from "./runtime-context-B5pREhcM.mjs";
-import { n as handlePrachtRequest, t as prerenderApp } from "./prerender-D3E2H96p.mjs";
+import { n as handlePrachtRequest, t as prerenderApp } from "./prerender-CoMyuJKm.mjs";
 import { Suspense, lazy } from "preact-suspense";
 export { Form, Link, PrachtHttpError, PrachtRuntimeProvider, Suspense, applyDefaultSecurityHeaders, buildHref, buildPathFromSegments, createHref, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, redirect, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };

package/dist/manifest.mjs

@@ -1,2 +1,2 @@
-import { i as group, l as route, r as defineApp, u as timeRevalidate } from "./app-BvC1uQG5.mjs";
+import { i as group, l as route, r as defineApp, u as timeRevalidate } from "./app-w-P1wf5T.mjs";
 export { defineApp, group, route, timeRevalidate };

package/dist/{prefetch-B50kX9RL.mjs → prefetch-D9amIQtw.mjs}

@@ -1,4 +1,4 @@
-import { o as matchAppRoute } from "./app-BvC1uQG5.mjs";
+import { o as matchAppRoute } from "./app-w-P1wf5T.mjs";
 import { a as trimMapToSize, i as getCachedRouteState, n as cacheRouteState, s as fetchPrachtRouteState, t as EMPTY_ROUTE_STATE_PROMISE, u as routeNeedsServerFetch } from "./prefetch-cache-DzP2Bj9H.mjs";
 //#region src/prefetch.ts
 const MAX_MATCH_CACHE_ENTRIES = 250;

package/dist/{prerender-D3E2H96p.mjs → prerender-CoMyuJKm.mjs}

@@ -1,5 +1,5 @@
-import { a as matchApiRoute, c as resolveApp, n as buildPathFromSegments, o as matchAppRoute } from "./app-BvC1uQG5.mjs";
-import { _ as applyDefaultSecurityHeaders, b as withDefaultSecurityHeaders, c as mergeDocumentHeaders, d as runMiddlewareChain, f as resolveDataFunctions, g as appendVaryHeader, h as resolveRegistryModule, l as mergeHeadMetadata, m as resolvePageJsUrls, p as resolvePageCssUrls, v as applyHeaders, x as withRouteResponseHeaders, y as applySecurityAndRouteHeaders } from "./types-idmK5omD.mjs";
+import { a as matchApiRoute, c as resolveApp, n as buildPathFromSegments, o as matchAppRoute } from "./app-w-P1wf5T.mjs";
+import { _ as applyDefaultSecurityHeaders, b as withDefaultSecurityHeaders, c as mergeDocumentHeaders, d as runMiddlewareChain, f as resolveDataFunctions, g as appendVaryHeader, h as resolveRegistryModule, l as mergeHeadMetadata, m as resolvePageJsUrls, p as resolvePageCssUrls, v as applyHeaders, x as withRouteResponseHeaders, y as applySecurityAndRouteHeaders } from "./types-DQv2poC5.mjs";
 import { f as HYDRATION_STATE_ELEMENT_ID, h as SAFE_METHODS, m as ROUTE_STATE_REQUEST_HEADER, o as buildRouteStateUrl } from "./prefetch-cache-DzP2Bj9H.mjs";
 import { a as buildRuntimeDiagnostics, c as normalizeRouteError, l as shouldExposeServerErrors, o as createSerializedRouteError, s as deserializeRouteError, t as PrachtRuntimeProvider } from "./runtime-context-B5pREhcM.mjs";
 import { h } from "preact";
@@ -249,11 +249,9 @@ function prefersMarkdown(accept) {
 	if (!html) return true;
 	return md.quality >= html.quality;
 }
-function markdownResponse(source) {
-	const headers = new Headers({
-		"content-type": "text/markdown; charset=utf-8",
-		"cache-control": "public, max-age=0, must-revalidate"
-	});
+function markdownResponse(source, initHeaders) {
+	const headers = new Headers(initHeaders);
+	headers.set("content-type", "text/markdown; charset=utf-8");
 	appendVaryHeader(headers, "Accept");
 	applyDefaultSecurityHeaders(headers);
 	return new Response(source, {
@@ -444,7 +442,6 @@ async function handlePrachtRequest(options) {
 			currentPhase = "render";
 			routeModule = await routeModulePromise;
 			if (!routeModule) throw new Error("Route module not found");
-			if (!isRouteStateRequest && typeof routeModule.markdown === "string" && prefersMarkdown(options.request.headers.get("accept"))) return markdownResponse(routeModule.markdown);
 			currentPhase = "loader";
 			const { loader, loaderFile: resolvedLoaderFile } = await dataFunctionsPromise;
 			loaderFile = resolvedLoaderFile;
@@ -455,6 +452,7 @@ async function handlePrachtRequest(options) {
 			currentPhase = "render";
 			shellModule = await shellModulePromise;
 			const [head, documentHeaders] = await Promise.all([mergeHeadMetadata(shellModule, routeModule, routeArgs, data), mergeDocumentHeaders(shellModule, routeModule, routeArgs, data)]);
+			if (!isRouteStateRequest && typeof routeModule.markdown === "string" && prefersMarkdown(options.request.headers.get("accept"))) return markdownResponse(routeModule.markdown, documentHeaders);
 			const cssUrls = resolvePageCssUrls(options.cssManifest, match.route.shellFile, match.route.file);
 			const modulePreloadUrls = resolvePageJsUrls(options.jsManifest, match.route.shellFile, match.route.file);
 			if (match.route.render === "spa") {

package/dist/{router-B7J4YYwg.mjs → router-BkkyNjqB.mjs}

@@ -1,11 +1,11 @@
-import { o as matchAppRoute, t as buildHref } from "./app-BvC1uQG5.mjs";
+import { o as matchAppRoute, t as buildHref } from "./app-w-P1wf5T.mjs";
 import { i as getCachedRouteState, l as parseSafeNavigationUrl, s as fetchPrachtRouteState, u as routeNeedsServerFetch } from "./prefetch-cache-DzP2Bj9H.mjs";
 import { s as deserializeRouteError, t as PrachtRuntimeProvider } from "./runtime-context-B5pREhcM.mjs";
 import { createContext, h, hydrate, options, render } from "preact";
 import { useContext, useEffect, useMemo, useState } from "preact/hooks";
 import { Suspense } from "preact-suspense";
 //#region src/hydration.ts
-const MODE_HYDRATE = 32;
+const MODE_HYDRATE$1 = 32;
 let _hydrating = false;
 let _suspensionCount = 0;
 let _hydrated = false;
@@ -13,7 +13,7 @@ new Suspense({});
 const oldCatchError = options.__e;
 options.__e = (err, newVNode, oldVNode, errorInfo) => {
 	if (_hydrating && !_hydrated && err && err.then) {
-		if (!!(newVNode && newVNode.__u && newVNode.__u & MODE_HYDRATE) || !!(newVNode && newVNode.__h)) {
+		if (!!(newVNode && newVNode.__u && newVNode.__u & MODE_HYDRATE$1) || !!(newVNode && newVNode.__h)) {
 			_suspensionCount++;
 			let settled = false;
 			const onSettled = () => {
@@ -55,21 +55,102 @@ function useIsHydrated() {
 //#endregion
 //#region src/hydration-mismatch.ts
 const HYDRATION_BANNER_ID = "__pracht_hydration_mismatch__";
+const MODE_HYDRATE = 32;
 let installed = false;
+let prevMismatch;
+let prevCatchError;
+let prevCommit;
+const pendingSuspenseChecks = /* @__PURE__ */ new Set();
+let flushScheduled = false;
 function installHydrationMismatchWarning() {
 	if (installed) return;
 	installed = true;
-	const prev = options.__m;
-	options.__m = function(vnode) {
+	const opts = options;
+	prevMismatch = opts.__m;
+	prevCatchError = opts.__e;
+	prevCommit = opts.__c;
+	opts.__m = function(vnode) {
 		appendHydrationWarning(vnode);
-		if (prev) prev(vnode);
+		if (prevMismatch) prevMismatch(vnode);
+	};
+	opts.__e = function(err, newVNode, oldVNode, errorInfo) {
+		trackSuspendingVNode(err, newVNode);
+		if (prevCatchError) prevCatchError(err, newVNode, oldVNode, errorInfo);
+	};
+	opts.__c = function(vnode, commitQueue) {
+		if (prevCommit) prevCommit(vnode, commitQueue);
+		scheduleSuspenseCheckFlush();
+	};
+}
+function trackSuspendingVNode(err, vnode) {
+	if (!vnode) return;
+	if (!err || typeof err.then !== "function") return;
+	if (!!!(vnode.__u && vnode.__u & MODE_HYDRATE || vnode.__h)) return;
+	const promise = err;
+	const onSettle = () => {
+		pendingSuspenseChecks.add(vnode);
 	};
+	promise.then(onSettle, onSettle);
+}
+function scheduleSuspenseCheckFlush() {
+	if (flushScheduled) return;
+	if (pendingSuspenseChecks.size === 0) return;
+	flushScheduled = true;
+	queueMicrotask(flushSuspenseChecks);
+}
+function flushSuspenseChecks() {
+	flushScheduled = false;
+	if (pendingSuspenseChecks.size === 0) return;
+	const checks = Array.from(pendingSuspenseChecks);
+	pendingSuspenseChecks.clear();
+	for (const vnode of checks) {
+		const rendered = currentVNode(vnode);
+		const count = countTopLevelDomNodes(rendered);
+		if (count !== 1) appendSuspenseOffsetWarning(pickReportableVNode(rendered), count);
+	}
+}
+function currentVNode(vnode) {
+	return vnode.__c?.__v ?? vnode;
+}
+function pickReportableVNode(vnode) {
+	let current = vnode;
+	for (let depth = 0; depth < 4; depth++) {
+		if (!isLazyWrapperVNode(current)) break;
+		const children = current.__k;
+		if (!Array.isArray(children) || children.length !== 1) break;
+		const child = children[0];
+		if (!child || typeof child.type !== "function") break;
+		current = currentVNode(child);
+	}
+	return current;
+}
+function isLazyWrapperVNode(vnode) {
+	const type = vnode.type;
+	if (typeof type !== "function") return false;
+	const fn = type;
+	return fn.displayName === "Lazy" || fn.name === "Lazy";
+}
+function countTopLevelDomNodes(vnode) {
+	if (!vnode || typeof vnode !== "object") return 0;
+	const type = vnode.type;
+	if (type === null) return 1;
+	if (typeof type === "string") return 1;
+	const children = vnode.__k;
+	if (!Array.isArray(children)) return 0;
+	let total = 0;
+	for (const child of children) total += countTopLevelDomNodes(child);
+	return total;
+}
+function appendSuspenseOffsetWarning(vnode, count) {
+	if (typeof document === "undefined") return;
+	appendBannerMessage(`Suspense boundary resolved during hydration: <${getVNodeName(vnode)}> ${count === 0 ? "rendered 0 DOM nodes" : `rendered ${count} DOM nodes`}. Components that unsuspend during hydration must render exactly one DOM node — otherwise sibling offsets can drift and later updates may bind to the wrong nodes.`);
 }
 function appendHydrationWarning(vnode) {
+	appendBannerMessage(`Hydration mismatch detected on <${getVNodeName(vnode)}>. The server-rendered HTML did not match the client.`);
+}
+function appendBannerMessage(message) {
 	if (typeof document === "undefined") return;
-	const componentName = getVNodeName(vnode);
 	let banner = document.getElementById(HYDRATION_BANNER_ID);
-	const message = `Hydration mismatch detected on <${componentName}>. The server-rendered HTML did not match the client.`;
 	if (banner) {
 		const list = banner.querySelector(`[data-pracht-mismatch-list]`);
 		if (list) {
@@ -246,7 +327,9 @@ async function initClientRouter(options) {
 		const navigationTarget = typeof to === "string" ? to : buildHref(app.routes, to.route, to);
 		const target = resolveBrowserRouteTarget(navigationTarget);
 		if (!target) {
-			window.location.href = navigationTarget;
+			const safeUrl = parseSafeNavigationUrl(navigationTarget, window.location.href);
+			if (safeUrl) window.location.href = safeUrl.toString();
+			else if (navigationTarget) console.error(`[pracht] refused to navigate to unsafe URL: ${navigationTarget}`);
 			return;
 		}
 		const match = matchAppRoute(app, target.pathname);
@@ -396,7 +479,7 @@ async function initClientRouter(options) {
 		startRouteImport(match);
 		startShellImport(match);
 	};
-	import("./prefetch-B50kX9RL.mjs").then(({ setupPrefetching }) => {
+	import("./prefetch-D9amIQtw.mjs").then(({ setupPrefetching }) => {
 		setupPrefetching(app, warmModules);
 	});
 }

package/dist/server.mjs

@@ -1,5 +1,5 @@
-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, t as buildHref, u as timeRevalidate } from "./app-BvC1uQG5.mjs";
-import { S as createHref, _ as applyDefaultSecurityHeaders, t as PrachtHttpError, u as redirect } from "./types-idmK5omD.mjs";
+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, t as buildHref, u as timeRevalidate } from "./app-w-P1wf5T.mjs";
+import { S as createHref, _ as applyDefaultSecurityHeaders, t as PrachtHttpError, u as redirect } from "./types-DQv2poC5.mjs";
 import { t as PrachtRuntimeProvider } from "./runtime-context-B5pREhcM.mjs";
-import { n as handlePrachtRequest, t as prerenderApp } from "./prerender-D3E2H96p.mjs";
+import { n as handlePrachtRequest, t as prerenderApp } from "./prerender-CoMyuJKm.mjs";
 export { PrachtHttpError, PrachtRuntimeProvider, applyDefaultSecurityHeaders, buildHref, buildPathFromSegments, createHref, defineApp, group, handlePrachtRequest, matchApiRoute, matchAppRoute, prerenderApp, redirect, resolveApiRoutes, resolveApp, route, timeRevalidate };

package/dist/{types-idmK5omD.mjs → types-DQv2poC5.mjs}

@@ -1,4 +1,4 @@
-import { t as buildHref } from "./app-BvC1uQG5.mjs";
+import { t as buildHref } from "./app-w-P1wf5T.mjs";
 import { c as navigateToClientLocation, h as SAFE_METHODS, l as parseSafeNavigationUrl, m as ROUTE_STATE_REQUEST_HEADER, p as ROUTE_STATE_CACHE_CONTROL, r as clearPrefetchCache, s as fetchPrachtRouteState } from "./prefetch-cache-DzP2Bj9H.mjs";
 import { n as RouteDataContext, s as deserializeRouteError } from "./runtime-context-B5pREhcM.mjs";
 import { h } from "preact";
@@ -323,14 +323,7 @@ function Form(props) {
 				body: new FormData(form),
 				redirect: "manual"
 			});
-			if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) {
-				const location = response.headers.get("location");
-				if (location) {
-					await navigateToClientLocation(location);
-					return;
-				}
-				window.location.href = props.action ?? form.action;
-			}
+			if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) await navigateToClientLocation(response.headers.get("location") ?? props.action ?? form.action);
 		}
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pracht/core",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Core runtime for Pracht, a full-stack Preact framework with per-route SSR, SSG, ISG, SPA, loaders, and API routes.",
   "keywords": [
     "pracht",