void 1.4.0 → 1.6.0

package/dist/pages/client.mjs

@@ -1,18 +1,18 @@
-import { i as searchWithoutActionKey } from "../action-key-XZ9HkWAO.mjs";
-import { t as ISLAND_FRONTMATTER_ID } from "../serialize-YHvlcG3Q.mjs";
-import { t as interpolateRouteParams } from "../route-url-BjGv_KKY.mjs";
-import { n as parseCacheFor, t as PrefetchCache } from "../prefetch-Bsc_Pb6c.mjs";
+import { i as searchWithoutActionKey } from "../action-key-XtKKbbsi.mjs";
+import { t as ISLAND_FRONTMATTER_ID } from "../serialize-DUuYuaY3.mjs";
+import { r as toUrlString, t as interpolateRouteParams } from "../route-url-CRDF-I0I.mjs";
+import { r as parseCacheFor, t as PrefetchCache } from "../prefetch-Dx2jIbtg.mjs";
 import { readUsageLimit } from "@void/edge";
-//#region src/pages/action-result.ts
+// src/pages/action-result.ts
 var VoidActionError = class extends Error {
 	body;
 	limit;
 	status;
 	statusText;
 	url;
-	constructor({ body, status, statusText, url }) {
+	constructor({ body, message, status, statusText, url }) {
 		const limit = status === 429 ? readUsageLimit(body) : null;
-		super(limit?.message ?? (statusText ? `Action failed with ${status} ${statusText}` : `Action failed with ${status}`));
+		super(message ?? limit?.message ?? (statusText ? `Action failed with ${status} ${statusText}` : `Action failed with ${status}`));
 		this.name = "VoidActionError";
 		this.body = body;
 		this.limit = limit;
@@ -52,16 +52,22 @@ async function readActionErrorBody(response) {
 		return null;
 	}
 }
+function readActionErrorMessage(response, body) {
+	if (response.status < 400 || response.status >= 500) return;
+	if (!response.headers.get("content-type")?.includes("text/plain")) return;
+	return typeof body === "string" && body.trim() ? body : void 0;
+}
 async function createActionErrorFromResponse(response, url) {
+	const body = await readActionErrorBody(response);
 	return new VoidActionError({
-		body: await readActionErrorBody(response),
+		body,
+		message: readActionErrorMessage(response, body),
 		status: response.status,
 		statusText: response.statusText,
 		url
 	});
 }
-//#endregion
-//#region src/pages/head-client.ts
+// src/pages/head-client.ts
 const ATTR = "data-void-head";
 function elementDescriptorSignature(descriptor) {
 	const attrs = Object.entries(descriptor.attrs).sort(([a], [b]) => a.localeCompare(b));
@@ -149,8 +155,7 @@ function applyClientHead(head) {
 	}
 	if (head?.title !== void 0) document.title = head.title;
 }
-//#endregion
-//#region src/pages/scroll-restoration.ts
+// src/pages/scroll-restoration.ts
 const STORAGE_PREFIX = "void:scroll:";
 function readKey(state) {
 	return typeof state?.__voidScrollKey === "string" ? state.__voidScrollKey : null;
@@ -247,8 +252,7 @@ function createScrollRestoration() {
 		}
 	};
 }
-//#endregion
-//#region src/pages/url.ts
+// src/pages/url.ts
 function isSameOrigin(url, origin) {
 	if (url.protocol === "capacitor:") {
 		const current = new URL(origin);
@@ -290,8 +294,7 @@ function decodePagePath(path) {
 	}
 	return decoded;
 }
-//#endregion
-//#region src/pages/navigation-engine.ts
+// src/pages/navigation-engine.ts
 /**
 * The server leaves a named action's key out of the page URL. When the page URL
 * shows that, drop the key from the URL written to history as well.
@@ -366,7 +369,7 @@ async function fetchPageResponse(fetchUrl, init) {
 	}
 }
 async function createPageNavigationEngine(config) {
-	const { adapter, components, layoutTree, routeMeta, staticPageData: STATIC_PAGE_DATA_ENABLED = false, staticPageDataFastPath: STATIC_PAGE_DATA_FAST_PATH = STATIC_PAGE_DATA_ENABLED, prefetchHoverDelay: PREFETCH_HOVER_DELAY, prefetchDefaultCacheFor: PREFETCH_DEFAULT_CACHE_FOR, cacheVisitedPageData: CACHE_VISITED_PAGE_DATA = false } = config;
+	const { adapter, components, layoutTree, routeMeta, staticPageData: STATIC_PAGE_DATA_ENABLED = false, staticPageDataFastPath: STATIC_PAGE_DATA_FAST_PATH = STATIC_PAGE_DATA_ENABLED, prefetchHoverDelay: PREFETCH_HOVER_DELAY, prefetchDefaultCacheFor: PREFETCH_DEFAULT_CACHE_FOR, prefetchDefaultStrategy: PREFETCH_DEFAULT_STRATEGY = false, cacheVisitedPageData: CACHE_VISITED_PAGE_DATA = false } = config;
 	const matchRoute = (url) => config.matchRoute(decodePagePath(new URL(url, "http://x").pathname));
 	const _prefetchCache = new PrefetchCache();
 	let _nextNavigationId = 0;
@@ -603,6 +606,9 @@ async function createPageNavigationEngine(config) {
 			return;
 		}
 		if (method !== "GET") _prefetchCache.flushAll();
+		const matchedComponentId = method === "GET" ? matchRoute(fetchUrl) : null;
+		const preloadComponentPromise = matchedComponentId && !routeMeta[matchedComponentId]?.island && components[matchedComponentId] ? Promise.all([resolveComponent(matchedComponentId), resolveLayouts(matchedComponentId)]) : null;
+		preloadComponentPromise?.catch(() => {});
 		const headers = {
 			"X-VoidPages": "true",
 			Accept: "application/json"
@@ -660,6 +666,7 @@ async function createPageNavigationEngine(config) {
 				url = fetchUrl + redirectUrl.hash;
 				commitTarget.fetchUrl = fetchUrl;
 				commitTarget.hash = redirectUrl.hash;
+				commitTarget.method = method;
 			}
 			if (response && method !== "GET" && !response.ok) throw await createActionErrorFromResponse(response, fetchUrl);
 			if (response && !response.headers.get("X-VoidPages")) {
@@ -728,7 +735,7 @@ async function createPageNavigationEngine(config) {
 			deferredRegistry.preserveValuesFrom(_committedDeferredRegistry, pageData);
 			commitTarget.fetchUrl = withoutActionKey(fetchUrl, pageData.url);
 		}
-		const [component, layouts] = await Promise.race([Promise.all([resolveComponent(pageData.component), resolveLayouts(pageData.component)]), abortSignalPromise(signal)]);
+		const [component, layouts] = await Promise.race([matchedComponentId === pageData.component && preloadComponentPromise ? preloadComponentPromise : Promise.all([resolveComponent(pageData.component), resolveLayouts(pageData.component)]), abortSignalPromise(signal)]);
 		if (id !== _nextNavigationId && signal.aborted) throw abortError();
 		return {
 			pageData,
@@ -744,6 +751,7 @@ async function createPageNavigationEngine(config) {
 			const result = await shell;
 			if (!result) return false;
 			if (resourceId < _urlNavigationId) return false;
+			const preserveScroll = options.preserveScroll ?? (commitTarget.method !== "GET" && commitTarget.fetchUrl === window.location.pathname + window.location.search);
 			if (!options._popstate) {
 				const historyUrl = commitTarget.fetchUrl + commitTarget.hash;
 				const resource = getResource();
@@ -778,7 +786,7 @@ async function createPageNavigationEngine(config) {
 			_currentFetchUrl = commitTarget.fetchUrl;
 			scrollRestoration.commit();
 			requestAnimationFrame(() => {
-				if (!options.preserveScroll) restoreScroll(options._scrollPosition, commitTarget.hash);
+				if (!preserveScroll) restoreScroll(options._scrollPosition, commitTarget.hash);
 			});
 			return true;
 		};
@@ -792,6 +800,7 @@ async function createPageNavigationEngine(config) {
 	_htmlDeferredRegistry = initialDeferredRegistry;
 	return {
 		_hoverDelay: PREFETCH_HOVER_DELAY,
+		_prefetchDefaultStrategy: PREFETCH_DEFAULT_STRATEGY,
 		initialPageData,
 		initialComponent,
 		initialLayouts,
@@ -835,7 +844,8 @@ async function createPageNavigationEngine(config) {
 			const deferredRegistry = new DeferredRegistry();
 			const commitTarget = {
 				fetchUrl: effectiveFetchUrl,
-				hash
+				hash,
+				method
 			};
 			const shell = loadNavigationShell(id, url, effectiveFetchUrl, method, options, controller.signal, commitTarget, deferredRegistry);
 			let commitResource = async () => false;
@@ -891,7 +901,8 @@ async function createPageNavigationEngine(config) {
 			return fetchPromise;
 		},
 		flush(url, method = "GET") {
-			_prefetchCache.flush(url, method);
+			const hashIdx = url.indexOf("#");
+			_prefetchCache.flush(hashIdx !== -1 ? url.slice(0, hashIdx) : url, method);
 		},
 		flushAll() {
 			_prefetchCache.flushAll();
@@ -930,8 +941,7 @@ async function createPageNavigationEngine(config) {
 		}
 	};
 }
-//#endregion
-//#region src/pages/adapter-helpers.ts
+// src/pages/adapter-helpers.ts
 function getValidationErrors(body) {
 	if (body && typeof body === "object" && "errors" in body && body.errors && typeof body.errors === "object" && !Array.isArray(body.errors)) return body.errors;
 	return null;
@@ -972,8 +982,148 @@ function isModifiedEvent(e) {
 	const target = e.currentTarget.getAttribute("target");
 	return target !== null && target !== "_self" || e.ctrlKey || e.metaKey || e.shiftKey || e.altKey || e.button !== 0;
 }
-//#endregion
-//#region src/pages/island-action.ts
+// src/pages/link.ts
+/** Normalizes the method and destination, rejecting options that only GET links support. */
+function resolveLink(props) {
+	const method = (props.method ?? "GET").toUpperCase();
+	const isGet = method === "GET";
+	if (props.prefetch !== void 0 && props.prefetch !== false && !isGet) throw new Error("Link: prefetch only supports GET links. Remove `prefetch` or use method=\"GET\".");
+	if (props.reloadDocument && !isGet) throw new Error("Link: reloadDocument only supports GET links.");
+	return {
+		method,
+		isGet,
+		href: isGet ? mergeDataIntoHref(props.href, props.data) : props.href
+	};
+}
+/**
+* The events that prefetch a Link. A Link without a `prefetch` prop uses the app's
+* `defaultStrategy`, but only when it is a GET link, the only kind that can prefetch.
+*/
+function linkPrefetchStrategies(props, link, defaultStrategy = false) {
+	if (props.reloadDocument) return [];
+	const prefetch = props.prefetch ?? (link.isGet ? defaultStrategy : false);
+	if (prefetch === false) return [];
+	if (prefetch === true) return ["hover"];
+	if (typeof prefetch === "string") return [prefetch];
+	return prefetch;
+}
+/**
+* Marks a GET link to the current page. Pathnames compare the way the server
+* matches pages: case-sensitive, trailing slash significant, decoded like Hono's
+* getPath. The query and hash are ignored. `prefix` also matches nested pages by
+* whole segment, except for `/`, but only an exact match is `aria-current`.
+* Spread the result before the user's attributes so theirs win.
+*/
+function linkActiveAttributes(router, link, match = "exact") {
+	if (!router || !link.isGet) return {};
+	const current = router.url;
+	const target = resolveSameOrigin(link.href, current);
+	if (!target) return {};
+	const currentPath = decodePagePath(current.pathname);
+	const linkPath = decodePagePath(target.pathname);
+	if (linkPath === currentPath) return {
+		"aria-current": "page",
+		"data-void-active": ""
+	};
+	if (match === "prefix" && linkPath !== "/") {
+		const parent = linkPath.endsWith("/") ? linkPath : `${linkPath}/`;
+		if (currentPath.startsWith(parent)) return { "data-void-active": "" };
+	}
+	return {};
+}
+/**
+* Marks a link while a visit to its destination is loading: the visit uses the link's
+* method and goes to its path, query and hash. Unlike active links, the query counts,
+* so `?page=2` isn't pending during a visit to `?page=3`. Every link to the destination
+* is marked, not only the one that was clicked.
+* Spread the result before the user's attributes so theirs win.
+*/
+function linkPendingAttributes(router, navigation, link) {
+	if (!router || !navigation?.location || navigation.state === "idle" || navigation.method !== link.method) return {};
+	const destination = navigation.location;
+	const target = resolveSameOrigin(link.href, router.url);
+	if (target && target.host === destination.host && target.protocol === destination.protocol && decodePagePath(target.pathname) === decodePagePath(destination.pathname) && target.search === destination.search && target.hash === destination.hash) return { "data-void-pending": "" };
+	return {};
+}
+/** Resolves `href` against `base`, or returns `null` for a malformed or other-origin href. */
+function resolveSameOrigin(href, base) {
+	let target;
+	try {
+		target = new URL(href, base);
+	} catch {
+		return null;
+	}
+	if (target.protocol !== base.protocol || target.host !== base.host) return null;
+	return target;
+}
+/** Data saver is on, or the connection is 2G-class. Read per call: both change while the page is open. */
+function isConstrainedConnection() {
+	const connection = navigator.connection;
+	return connection?.saveData === true || connection?.effectiveType === "2g" || connection?.effectiveType === "slow-2g";
+}
+/** Link's automatic prefetch. `router.prefetch()` called directly is not limited by the connection. */
+function prefetchLink(router, href, cacheFor) {
+	if (!router?.prefetch || isConstrainedConnection()) return;
+	if (new URL(href, window.location.href).origin !== window.location.origin) return;
+	if (href === window.location.pathname + window.location.search) return;
+	const options = {};
+	if (cacheFor !== void 0) options.cacheFor = cacheFor;
+	router.prefetch(href, options);
+}
+/**
+* Runs a client-side visit for a plain same-origin click. Modified clicks, downloads,
+* cross-origin destinations and `reloadDocument` links are left to the browser.
+* Call it after the user's own click handler so its `preventDefault()` is respected.
+*/
+function handleLinkClick(event, router, link, props) {
+	if (props.reloadDocument || !router || event.defaultPrevented || isModifiedEvent(event)) return;
+	if (event.currentTarget.hasAttribute("download")) return;
+	if (new URL(link.href, window.location.href).origin !== window.location.origin) return;
+	let navigatePrevented = false;
+	props.onNavigate?.({ preventDefault() {
+		navigatePrevented = true;
+	} });
+	event.preventDefault();
+	if (navigatePrevented) return;
+	router.visit(link.href, {
+		method: link.method,
+		data: link.isGet ? void 0 : props.data,
+		preserveScroll: props.preserveScroll,
+		preserveState: props.preserveState,
+		replace: props.replace,
+		viewTransition: props.viewTransition
+	});
+}
+/**
+* Calls `onVisible` once, after `element` has stayed in the viewport for
+* `LINK_VISIBLE_PREFETCH_DELAY` ms. Leaving the viewport cancels the wait and entering
+* again restarts it. Returns a cleanup that also cancels a pending wait.
+*/
+function observeLinkVisible(element, onVisible) {
+	let timer;
+	let done = false;
+	const stop = () => {
+		done = true;
+		clearTimeout(timer);
+		timer = void 0;
+		observer.disconnect();
+	};
+	const observer = new IntersectionObserver((entries) => {
+		if (done) return;
+		if (entries.some((entry) => !entry.isIntersecting)) {
+			clearTimeout(timer);
+			timer = void 0;
+		}
+		if (!entries.at(-1)?.isIntersecting) return;
+		timer ??= setTimeout(() => {
+			stop();
+			onVisible();
+		}, 300);
+	}, { rootMargin: "0px" });
+	observer.observe(element);
+	return stop;
+}
+// src/pages/island-action.ts
 async function submitIslandAction(url, method, data) {
 	const response = await fetch(url, {
 		method,
@@ -997,8 +1147,7 @@ async function submitIslandAction(url, method, data) {
 		error
 	};
 }
-//#endregion
-//#region src/pages/form-value-equality.ts
+// src/pages/form-value-equality.ts
 function isPlainObject(value) {
 	if (value === null || typeof value !== "object") return false;
 	const prototype = Object.getPrototypeOf(value);
@@ -1019,8 +1168,7 @@ function isEqualFormValue(a, b) {
 	}
 	return false;
 }
-//#endregion
-//#region src/pages/form-reset.ts
+// src/pages/form-reset.ts
 function isFormResetOptions(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1052,8 +1200,7 @@ function parseFormResetArgs(args) {
 		fields: args
 	};
 }
-//#endregion
-//#region src/pages/form-presentation.ts
+// src/pages/form-presentation.ts
 function formErrorMessage(form) {
 	return form.error?.message ?? (Object.values(form.errors).filter(Boolean).join(". ") || null);
 }
@@ -1079,20 +1226,24 @@ function scheduleFormRetry(error, ready) {
 	schedule();
 	return () => clearTimeout(timer);
 }
-//#endregion
-//#region src/pages/client.ts
+// src/pages/client.ts
 function currentUrl() {
 	return window.location.pathname + window.location.search + window.location.hash;
 }
 function getUrlOrigin() {
 	return typeof window === "undefined" ? "http://localhost" : window.location.origin;
 }
+/** Relative URLs such as `?page=2` resolve against the current page, as in an anchor. */
+function getUrlBase() {
+	return typeof window === "undefined" ? "http://localhost/" : getUrlOrigin() + currentUrl();
+}
 function toUrl(value) {
-	return value instanceof URL ? new URL(value.href) : new URL(value || "/", getUrlOrigin());
+	return value instanceof URL ? new URL(value.href) : new URL(value || "/", getUrlBase());
 }
 function normalizeUrl(value) {
-	if (typeof value === "string" && value.startsWith("#")) return value;
-	const url = toUrl(value);
+	const urlString = toUrlString(value);
+	if (urlString.startsWith("#")) return urlString;
+	const url = toUrl(urlString);
 	return isSameOrigin(url, getUrlOrigin()) ? url.pathname + url.search + url.hash : url.href;
 }
 function navigationMethod(method) {
@@ -1120,8 +1271,11 @@ function createRouterFacade(router, getCurrentUrl, getCurrentParams = () => rout
 		get _hoverDelay() {
 			return router._hoverDelay;
 		},
+		get _prefetchDefaultStrategy() {
+			return router._prefetchDefaultStrategy;
+		},
 		get url() {
-			return toUrl(getCurrentUrl());
+			return new URL(getCurrentUrl() || "/", router.url);
 		},
 		get path() {
 			return this.url.pathname;
@@ -1149,11 +1303,11 @@ function createRouterFacade(router, getCurrentUrl, getCurrentParams = () => rout
 		}
 	};
 }
-function createSsrRouter(url = "/", params = {}) {
+function createSsrRouter(url = "/", params = {}, requestUrl) {
 	return {
 		_hoverDelay: 75,
 		get url() {
-			return toUrl(url);
+			return new URL(url || "/", requestUrl ?? getUrlBase());
 		},
 		get path() {
 			return this.url.pathname;
@@ -1218,7 +1372,7 @@ async function submitAction(router, url, options) {
 	}
 }
 /** Creates an action client with its own router for each framework adapter. */
-function createActionClient() {
+function createActionClient(defaults = {}) {
 	let _router = null;
 	/** Called during app initialization to store the router instance */
 	function setActionRouter(router) {
@@ -1233,7 +1387,9 @@ function createActionClient() {
 		const resolvedUrl = interpolateRouteParams(url, options?.params);
 		return submitAction(_router, resolvedUrl, {
 			method,
-			data
+			data,
+			preserveScroll: options?.preserveScroll,
+			...defaults
 		});
 	}
 	return {
@@ -1324,6 +1480,7 @@ async function createVoidRouter(config) {
 	}
 	const router = {
 		_hoverDelay: engine._hoverDelay,
+		_prefetchDefaultStrategy: engine._prefetchDefaultStrategy,
 		get url() {
 			return toUrl(routeUrl);
 		},
@@ -1401,5 +1558,4 @@ function initIslands(islands, hydrateFn) {
 		if (loader) scheduleHydration(el, loader, props, strategy, hydrate);
 	});
 }
-//#endregion
-export { VoidActionError, categorizeActionError, cloneFormValue, createActionClient, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, formErrorMessage, formRetryMessage, formSubmissionBlocked, getValidationErrors, hasFiles, idleNavigationState, initIslands, interpolateRouteParams, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, isFormResetOptions, isModifiedEvent, mergeDataIntoHref, objectToFormData, parseFormResetArgs, refreshPage, scheduleFormRetry, scheduleHydration, ssrProxy, submitAction, submitIslandAction };
+export { VoidActionError, categorizeActionError, cloneFormValue, createActionClient, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, formErrorMessage, formRetryMessage, formSubmissionBlocked, getValidationErrors, handleLinkClick, hasFiles, idleNavigationState, initIslands, interpolateRouteParams, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, isFormResetOptions, isModifiedEvent, linkActiveAttributes, linkPendingAttributes, linkPrefetchStrategies, mergeDataIntoHref, objectToFormData, observeLinkVisible, parseFormResetArgs, prefetchLink, refreshPage, resolveLink, scheduleFormRetry, scheduleHydration, ssrProxy, submitAction, submitIslandAction, toUrlString };

package/dist/pages/head.d.mts

@@ -1,2 +1,2 @@
-import { a as renderHtmlAttrs, i as renderHeadToString, n as HeadDescriptor, o as resolveHead, r as renderBodyAttrs, t as HeadConfig } from "../head-C8K_iGe6.mjs";
+import { a as renderHtmlAttrs, i as renderHeadToString, n as HeadDescriptor, o as resolveHead, r as renderBodyAttrs, t as HeadConfig } from "../head-MeF_5M_3.mjs";
 export { HeadConfig, HeadDescriptor, renderBodyAttrs, renderHeadToString, renderHtmlAttrs, resolveHead };

package/dist/pages/head.mjs

@@ -1 +1 @@
-export { t as renderBodyAttrs, n as renderHeadToString, r as renderHtmlAttrs, i as resolveHead } from "../head-D2VF4ApL.mjs";
+export { t as renderBodyAttrs, n as renderHeadToString, r as renderHtmlAttrs, i as resolveHead } from "../head-5XPcnG-j.mjs";

package/dist/pages/index.d.mts

@@ -1,9 +1,9 @@
-import { a as renderHtmlAttrs, i as renderHeadToString, n as HeadDescriptor, o as resolveHead, r as renderBodyAttrs, t as HeadConfig } from "../head-C8K_iGe6.mjs";
-import "../config-CAdZVTLN.mjs";
-import { i as PageDefinition, n as LayoutDefinition, o as PageScanResult, r as NamedLayoutDefinition, s as RouteEnvironment } from "../types-w72dljaA.mjs";
-import { r as serializePageData } from "../serialize-DtR8Vwa_.mjs";
+import { a as renderHtmlAttrs, i as renderHeadToString, n as HeadDescriptor, o as resolveHead, r as renderBodyAttrs, t as HeadConfig } from "../head-MeF_5M_3.mjs";
+import "../config-CPxJmt4M.mjs";
+import { i as PageDefinition, n as LayoutDefinition, o as PageScanResult, r as NamedLayoutDefinition, s as RouteEnvironment } from "../types-agfx0alu.mjs";
+import { a as LinkPrefetchValue, n as CacheForInput } from "../prefetch-NdNeubbH.mjs";
+import { r as serializePageData } from "../serialize-I4EmS-Wf.mjs";
 import { Plugin, UserConfig } from "vite";
-//#region src/project-paths.d.ts
 type ProjectPaths = {
   root: string;
   sourceDir: string;
@@ -24,8 +24,6 @@ type ProjectPaths = {
   envFileCandidates: ReadonlyArray<string>;
 };
 export declare function resolvePagesDir(root?: string): string;
-//#endregion
-//#region src/pages/layout-resolution.d.ts
 /** Resolve the layout chain for a component (innermost last) */
 export declare function resolveLayoutChain(componentId: string, layouts: Array<LayoutDefinition>, componentPath?: string): Array<LayoutDefinition>;
 /** Walk up directory tree to find closest _layouts/<name> */
@@ -36,8 +34,6 @@ export declare function resolveEffectiveLayoutChain(page: {
   componentPath?: string;
   layout?: string | false;
 }, layouts: Array<LayoutDefinition>, namedLayouts: Array<NamedLayoutDefinition>): Array<LayoutDefinition | NamedLayoutDefinition>;
-//#endregion
-//#region src/pages/scan.d.ts
 type PageScanOptions = {
   output?: "server" | "static";
   paths?: ProjectPaths;
@@ -54,8 +50,6 @@ type PageScanOptions = {
  */
 export declare function pageFileEnvironment(relativePath: string): RouteEnvironment | null;
 export declare function scanPages(root: string, options?: PageScanOptions): Promise<PageScanResult>;
-//#endregion
-//#region src/pages/manifest.d.ts
 /**
  * Generates the component import map and layout tree as code strings.
  * Used by both SSR renderer and client entry virtual modules.
@@ -67,8 +61,6 @@ export declare function scanPages(root: string, options?: PageScanOptions): Prom
  * `matchRoute` takes a decoded pathname (see `decodePagePath`).
  */
 export declare function generateComponentManifest(scan: PageScanResult, pagesDir: string): string;
-//#endregion
-//#region src/pages/static-data.d.ts
 type StaticPageDataBuildOptions = {
   enabled: boolean;
   fastPath: boolean;
@@ -77,13 +69,29 @@ type ResolveStaticPageDataBuildOptionsInput = {
   publicDir?: string | false;
 };
 export declare function resolveStaticPageDataBuildOptions(root: string, options?: ResolveStaticPageDataBuildOptionsInput): StaticPageDataBuildOptions;
-//#endregion
-//#region src/pages/plugin.d.ts
 type PagesPluginContext = {
   isDev: boolean;
   scan: () => Promise<PageScanResult | null>;
 };
+/** The `prefetch` option of a framework adapter plugin. */
+type PrefetchConfig = {
+  /** How a Link without its own `prefetch` prop prefetches. Accepts the same values. */
+  defaultStrategy?: LinkPrefetchValue;
+  hoverDelay?: number;
+  cacheFor?: CacheForInput;
+};
+/** Options of a framework adapter's pages plugin. */
 type PagesPluginOptions = {
+  root?: string;
+  viewTransitions?: boolean;
+  prefetch?: PrefetchConfig;
+};
+/**
+ * `prefetch` with its defaults: Links prefetch only when they ask to, with a 75 ms
+ * hover delay and a 30 second cache.
+ */
+export declare function resolvePrefetchConfig(prefetch: PrefetchConfig | undefined): Required<PrefetchConfig>;
+type CreatePagesPluginOptions = {
   name: string;
   root?: string;
   generateRenderer: (scan: PageScanResult, isDev: boolean) => string;
@@ -91,6 +99,5 @@ type PagesPluginOptions = {
   config: (context: PagesPluginContext) => UserConfig | void | Promise<UserConfig | void>;
 };
 /** Shared Vite lifecycle; adapters own their generated code and environment configuration. */
-export declare function createPagesPlugin(pagesDir: string, options: PagesPluginOptions): Plugin;
-//#endregion
-export { type HeadConfig, type HeadDescriptor, type LayoutDefinition, type NamedLayoutDefinition, type PageDefinition, type PageScanResult, type StaticPageDataBuildOptions, renderBodyAttrs, renderHeadToString, renderHtmlAttrs, resolveHead, serializePageData };
+export declare function createPagesPlugin(pagesDir: string, options: CreatePagesPluginOptions): Plugin;
+export { type HeadConfig, type HeadDescriptor, type LayoutDefinition, type NamedLayoutDefinition, type PageDefinition, type PageScanResult, type PagesPluginOptions, type PrefetchConfig, type StaticPageDataBuildOptions, renderBodyAttrs, renderHeadToString, renderHtmlAttrs, resolveHead, serializePageData };

package/dist/pages/index.mjs

@@ -1,13 +1,14 @@
-import { a as join, n as dirname } from "../dist-ipQi0Q8y.mjs";
-import { r as resolvePagesDir } from "../project-paths-DGu_QZ_Q.mjs";
-import { p as readConfig } from "../config-OFOAimzt.mjs";
-import { a as resolveLayoutChain, i as resolveEffectiveLayoutChain, n as scanPages, r as generateComponentManifest, s as resolveNamedLayout, t as pageFileEnvironment } from "../scan-N9WzdcAl.mjs";
-import { r as parseRedirectsFile } from "../headers--vaK_chu.mjs";
-import { i as resolveHead, n as renderHeadToString, r as renderHtmlAttrs, t as renderBodyAttrs } from "../head-D2VF4ApL.mjs";
-import { r as serializePageData } from "../serialize-YHvlcG3Q.mjs";
+import { a as join, n as dirname } from "../dist-DMYe8CZJ.mjs";
+import { r as resolvePagesDir } from "../project-paths-CdGv9Tmi.mjs";
+import { p as readConfig } from "../config-BITKQ3O6.mjs";
+import { a as resolveLayoutChain, i as resolveEffectiveLayoutChain, n as scanPages, r as generateComponentManifest, s as resolveNamedLayout, t as pageFileEnvironment } from "../scan-X2rDDRNa.mjs";
+import { r as parseRedirectsFile } from "../headers-CuTEdP9C.mjs";
+import { i as resolveHead, n as renderHeadToString, r as renderHtmlAttrs, t as renderBodyAttrs } from "../head-5XPcnG-j.mjs";
+import { r as serializePageData } from "../serialize-DUuYuaY3.mjs";
+import { n as assertLinkPrefetchValue } from "../prefetch-Dx2jIbtg.mjs";
 import { existsSync } from "node:fs";
 import { normalizePath } from "vite";
-//#region src/pages/static-data.ts
+// src/pages/static-data.ts
 function resolveStaticPageDataBuildOptions(root, options = {}) {
 	const config = readConfig(root);
 	const enabled = config.output === "static";
@@ -24,10 +25,22 @@ function resolveStaticPageDataBuildOptions(root, options = {}) {
 		fastPath: enabled && !hasConfigRouting && !hasRedirectsFile
 	};
 }
-//#endregion
-//#region src/pages/plugin.ts
+// src/pages/plugin.ts
 const RENDERER_ID = "virtual:void-pages-renderer";
 const CLIENT_ENTRY_ID = "virtual:void-pages-client";
+/**
+* `prefetch` with its defaults: Links prefetch only when they ask to, with a 75 ms
+* hover delay and a 30 second cache.
+*/
+function resolvePrefetchConfig(prefetch) {
+	const defaultStrategy = prefetch?.defaultStrategy ?? false;
+	assertLinkPrefetchValue(defaultStrategy, "prefetch.defaultStrategy");
+	return {
+		defaultStrategy,
+		hoverDelay: prefetch?.hoverDelay ?? 75,
+		cacheFor: prefetch?.cacheFor ?? "30s"
+	};
+}
 /** Shared Vite lifecycle; adapters own their generated code and environment configuration. */
 function createPagesPlugin(pagesDir, options) {
 	let pageScan = null;
@@ -113,5 +126,4 @@ function createPagesPlugin(pagesDir, options) {
 		}
 	};
 }
-//#endregion
-export { createPagesPlugin, generateComponentManifest, pageFileEnvironment, renderBodyAttrs, renderHeadToString, renderHtmlAttrs, resolveEffectiveLayoutChain, resolveHead, resolveLayoutChain, resolveNamedLayout, resolvePagesDir, resolveStaticPageDataBuildOptions, scanPages, serializePageData };
+export { createPagesPlugin, generateComponentManifest, pageFileEnvironment, renderBodyAttrs, renderHeadToString, renderHtmlAttrs, resolveEffectiveLayoutChain, resolveHead, resolveLayoutChain, resolveNamedLayout, resolvePagesDir, resolvePrefetchConfig, resolveStaticPageDataBuildOptions, scanPages, serializePageData };