void 1.5.0 → 1.6.0

package/dist/pages/client.mjs

@@ -1,7 +1,7 @@
 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 { n as parseCacheFor, t as PrefetchCache } from "../prefetch-L93_1Jk7.mjs";
+import { r as parseCacheFor, t as PrefetchCache } from "../prefetch-Dx2jIbtg.mjs";
 import { readUsageLimit } from "@void/edge";
 // src/pages/action-result.ts
 var VoidActionError = class extends Error {
@@ -10,9 +10,9 @@ var VoidActionError = class extends Error {
 	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,9 +52,16 @@ 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
@@ -362,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;
@@ -659,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")) {
@@ -743,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();
@@ -777,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;
 		};
@@ -791,6 +800,7 @@ async function createPageNavigationEngine(config) {
 	_htmlDeferredRegistry = initialDeferredRegistry;
 	return {
 		_hoverDelay: PREFETCH_HOVER_DELAY,
+		_prefetchDefaultStrategy: PREFETCH_DEFAULT_STRATEGY,
 		initialPageData,
 		initialComponent,
 		initialLayouts,
@@ -834,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;
@@ -971,6 +982,147 @@ 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;
 }
+// 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, {
@@ -1081,8 +1233,12 @@ function currentUrl() {
 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) {
 	const urlString = toUrlString(value);
@@ -1115,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;
@@ -1144,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;
@@ -1229,6 +1388,7 @@ function createActionClient(defaults = {}) {
 		return submitAction(_router, resolvedUrl, {
 			method,
 			data,
+			preserveScroll: options?.preserveScroll,
 			...defaults
 		});
 	}
@@ -1320,6 +1480,7 @@ async function createVoidRouter(config) {
 	}
 	const router = {
 		_hoverDelay: engine._hoverDelay,
+		_prefetchDefaultStrategy: engine._prefetchDefaultStrategy,
 		get url() {
 			return toUrl(routeUrl);
 		},
@@ -1397,4 +1558,4 @@ function initIslands(islands, hydrateFn) {
 		if (loader) scheduleHydration(el, loader, props, strategy, hydrate);
 	});
 }
-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, toUrlString };
+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/index.d.mts

@@ -1,6 +1,7 @@
 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-CzsNzGVH.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";
 type ProjectPaths = {
@@ -72,7 +73,25 @@ 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;
@@ -80,5 +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;
-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,10 +1,11 @@
 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-DkA9jYF2.mjs";
-import { a as resolveLayoutChain, i as resolveEffectiveLayoutChain, n as scanPages, r as generateComponentManifest, s as resolveNamedLayout, t as pageFileEnvironment } from "../scan-DSQtH3oS.mjs";
-import { r as parseRedirectsFile } from "../headers-DEUBAM6W.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";
 // src/pages/static-data.ts
@@ -27,6 +28,19 @@ function resolveStaticPageDataBuildOptions(root, options = {}) {
 // 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;
@@ -112,4 +126,4 @@ function createPagesPlugin(pagesDir, options) {
 		}
 	};
 }
-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 };

package/dist/pages/islands-plugin.d.mts

@@ -1,5 +1,5 @@
 import { o as PageScanResult } from "../types-agfx0alu.mjs";
-import { Plugin, ResolvedConfig, ViteDevServer } from "vite";
+import { Plugin, ResolvedConfig, UserConfig, ViteDevServer } from "vite";
 //#region src/SourceMap.d.ts
 interface SourceMapOptions {
   /**
@@ -306,14 +306,43 @@ export type IslandEntry = {
   islandId: string;
   hydrate: string;
 };
+/** The pages whose Markdown script `@void/md` serves to the browser. */
+export declare function mdClientScriptIds(resolvedConfig: ResolvedConfig | null): Set<string>;
 /** Resolve a relative import specifier to an absolute path by checking extensions. */
-export declare function resolveSpecifier(specifier: string, importerDir: string, extensions: Array<string>): string | null;
+export declare function resolveSpecifier(specifier: string, importerDir: string, extensions: ReadonlyArray<string>): string | null;
+/** The islands that island pages and layouts import, for the islands client entry. */
+export type IslandManifest = {
+  readonly entries: Map<string, IslandEntry>;
+  /**
+   * Resolve an island import and record it. An import that does not resolve
+   * keeps its specifier as its id and is not recorded.
+   */
+  register(specifier: string, importerDir: string, hydrate: string): {
+    absPath: string | null;
+    islandId: string;
+  };
+  /**
+   * Record the island imports of every island page and layout. The client
+   * build may load the islands client entry before their transforms run.
+   */
+  registerPages(pageScan: PageScanResult, pagesDir: string): void;
+};
+/** `extensions` are tried, in order, for an island import without one. */
+export declare function createIslandManifest(root: string, extensions: ReadonlyArray<string>): IslandManifest;
+/**
+ * The island pages that match `componentPattern` and the layouts of every
+ * island page. Without a server build, the islands client entry imports their
+ * own styles and stylesheet imports.
+ */
+export declare function islandCssFiles(pageScan: PageScanResult, pagesDir: string, componentPattern: RegExp): Set<string>;
 /**
  * Whether the app has island pages (`*.island.*` files or Markdown). Their
  * layouts can reach a stylesheet through a component, which only the module
  * graph shows, so the islands client entry is built for every such app.
  */
 export declare function hasIslandPages(root: string, pagesDir: string): Promise<boolean>;
+/** Build config that adds the islands client entry to the client build of an app with island pages. */
+export declare function islandsBuildConfig(root: string, pagesDir: string): Promise<UserConfig | undefined>;
 /**
  * The layouts of every island page, outermost first, then the pages. All
  * island pages share one production stylesheet, so layout styles come first.
@@ -357,6 +386,21 @@ export declare function islandStylesPlugin(pagesDir: string): Plugin;
  * virtual module. Absolute and bare specifiers are kept as-is.
  */
 export declare function rewriteCssImportForVirtualModule(matchedLine: string, specifier: string, sourceFilePath: string): string;
+export type IslandClientEntryOptions = {
+  manifest: IslandManifest;
+  /** From `islandCssFiles`. */
+  cssFiles: ReadonlySet<string>;
+  /** From `recordedIslandStyles`. */
+  styles: ReadonlyArray<string> | null;
+  /** Whether a built page loads the entry for its islands. */
+  needsRuntime: boolean;
+  isDev: boolean;
+  /** Imports for the style blocks of a Vue or Svelte component. */
+  styleBlockImports?: (file: string, content: string) => Array<string>;
+  /** Source that defines `async function hydrateIsland(el, mod, props, frontmatter)`. */
+  hydrateIsland: string;
+};
+export declare function generateIslandClientEntry(options: IslandClientEntryOptions): string;
 /** Extract CSS import statements from a file and return them as @import rules. */
 export declare function extractCssImports(filePath: string): string;
 /** Compute which island pages need client-side JavaScript. */

package/dist/pages/islands-plugin.mjs

@@ -1,5 +1,5 @@
-import { c as resolve, n as dirname } from "../dist-DMYe8CZJ.mjs";
-import { c as editIslandSource, i as resolveEffectiveLayoutChain, l as findIslandImports, n as scanPages, u as findStaticCssImports } from "../scan-DSQtH3oS.mjs";
+import { c as resolve, n as dirname, s as relative } from "../dist-DMYe8CZJ.mjs";
+import { c as editIslandSource, i as resolveEffectiveLayoutChain, l as findIslandImports, n as scanPages, u as findStaticCssImports } from "../scan-X2rDDRNa.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { isCSSRequest, normalizePath } from "vite";
 // src/pages/islands-plugin.ts
@@ -8,6 +8,11 @@ const ISLANDS_CLIENT_ENTRY_ID = "virtual:void-islands-client";
 function hasIslandImports(code, filename) {
 	return findIslandImports(code, filename).length > 0;
 }
+/** The pages whose Markdown script `@void/md` serves to the browser. */
+function mdClientScriptIds(resolvedConfig) {
+	const mdPlugin = resolvedConfig?.plugins?.find((plugin) => plugin.name === "void-md");
+	return new Set(mdPlugin?.api?.getClientScripts?.()?.keys() ?? []);
+}
 /** Resolve a relative import specifier to an absolute path by checking extensions. */
 function resolveSpecifier(specifier, importerDir, extensions) {
 	const base = normalizePath(resolve(importerDir, specifier));
@@ -15,6 +20,61 @@ function resolveSpecifier(specifier, importerDir, extensions) {
 	if (existsSync(base)) return base;
 	return null;
 }
+/** `extensions` are tried, in order, for an island import without one. */
+function createIslandManifest(root, extensions) {
+	const entries = /* @__PURE__ */ new Map();
+	function register(specifier, importerDir, hydrate) {
+		const absPath = resolveSpecifier(specifier, importerDir, extensions);
+		if (!absPath) return {
+			absPath,
+			islandId: specifier
+		};
+		const islandId = normalizePath(relative(root, absPath)).replace(/\.[^.]+$/, "");
+		entries.set(islandId, {
+			componentPath: absPath,
+			islandId,
+			hydrate
+		});
+		return {
+			absPath,
+			islandId
+		};
+	}
+	return {
+		entries,
+		register,
+		registerPages(pageScan, pagesDir) {
+			const files = [
+				...pageScan.pages.map((page) => ({
+					filePath: page.componentPath,
+					island: page.island
+				})),
+				...pageScan.layouts,
+				...pageScan.namedLayouts
+			];
+			for (const entry of files) {
+				if (!entry.island) continue;
+				const filePath = resolve(pagesDir, entry.filePath);
+				const code = readFileSync(filePath, "utf-8");
+				for (const islandImport of findIslandImports(code, filePath)) register(islandImport.specifier, dirname(filePath), islandImport.hydrate);
+			}
+		}
+	};
+}
+/**
+* The island pages that match `componentPattern` and the layouts of every
+* island page. Without a server build, the islands client entry imports their
+* own styles and stylesheet imports.
+*/
+function islandCssFiles(pageScan, pagesDir, componentPattern) {
+	const files = /* @__PURE__ */ new Set();
+	for (const page of pageScan.pages) {
+		if (!page.island) continue;
+		if (componentPattern.test(page.componentPath)) files.add(normalizePath(resolve(pagesDir, page.componentPath)));
+		for (const layout of resolveEffectiveLayoutChain(page, pageScan.layouts, pageScan.namedLayouts)) files.add(normalizePath(resolve(pagesDir, layout.filePath)));
+	}
+	return files;
+}
 /**
 * Whether the app has island pages (`*.island.*` files or Markdown). Their
 * layouts can reach a stylesheet through a component, which only the module
@@ -31,6 +91,14 @@ async function hasIslandPages(root, pagesDir) {
 		return false;
 	}
 }
+/** Build config that adds the islands client entry to the client build of an app with island pages. */
+async function islandsBuildConfig(root, pagesDir) {
+	if (!await hasIslandPages(root, pagesDir)) return;
+	return { environments: { client: { build: {
+		manifest: true,
+		rollupOptions: { input: { "islands-client": ISLANDS_CLIENT_ENTRY_ID } }
+	} } } };
+}
 /**
 * The layouts of every island page, outermost first, then the pages. All
 * island pages share one production stylesheet, so layout styles come first.
@@ -131,6 +199,25 @@ function rewriteCssImportForVirtualModule(matchedLine, specifier, sourceFilePath
 	const statement = matchedLine.trim();
 	return statement.endsWith(";") ? statement : statement + ";";
 }
+function generateIslandClientEntry(options) {
+	const uniqueIslands = /* @__PURE__ */ new Map();
+	for (const entry of options.manifest.entries.values()) uniqueIslands.set(entry.islandId, entry.componentPath);
+	const lines = [];
+	if (!options.isDev && options.styles) for (const id of options.styles) lines.push(`import ${JSON.stringify(id)};`);
+	else if (!options.isDev) for (const file of options.cssFiles) {
+		const content = readFileSync(file, "utf-8");
+		lines.push(...options.styleBlockImports?.(file, content) ?? []);
+		for (const item of findStaticCssImports(content, file)) lines.push(rewriteCssImportForVirtualModule(item.statement, item.specifier, file));
+	}
+	if (!options.needsRuntime && !options.isDev) return lines.join("\n");
+	lines.push("import { initIslands } from \"void/pages-client\";");
+	lines.push("const islands = {");
+	for (const [id, path] of uniqueIslands) lines.push(`  ${JSON.stringify(id)}: () => import(${JSON.stringify(path)}),`);
+	lines.push("};");
+	lines.push(options.hydrateIsland);
+	lines.push("initIslands(islands, hydrateIsland);");
+	return lines.join("\n");
+}
 /** Extract CSS import statements from a file and return them as @import rules. */
 function extractCssImports(filePath) {
 	const code = readFileSync(filePath, "utf-8");
@@ -138,8 +225,7 @@ function extractCssImports(filePath) {
 }
 /** Compute which island pages need client-side JavaScript. */
 function computePagesNeedingClientJS(pageScan, pagesDir, resolvedConfig) {
-	const mdPlugin = resolvedConfig?.plugins?.find((plugin) => plugin.name === "void-md");
-	const mdScriptIds = new Set(mdPlugin?.api?.getClientScripts?.()?.keys() ?? []);
+	const mdScriptIds = mdClientScriptIds(resolvedConfig);
 	const layoutDirsWithIslands = /* @__PURE__ */ new Set();
 	for (const layout of pageScan.layouts) {
 		if (!layout.island) continue;
@@ -205,4 +291,4 @@ function watchPagesForRescan(server, pagesDir, root, onRescan) {
 	});
 	return { flush: () => pending ?? Promise.resolve() };
 }
-export { ISLANDS_CLIENT_ENTRY_ID, ISLANDS_RENDERER_ID, collectIslandStyles, computePagesNeedingClientJS, editIslandSource, extractCssImports, findIslandImports, findStaticCssImports, hasIslandPages, islandStyleRoots, islandStylesPlugin, recordIslandStyles, recordedIslandStyles, resolveSpecifier, rewriteCssImportForVirtualModule, watchPagesForRescan };
+export { ISLANDS_CLIENT_ENTRY_ID, ISLANDS_RENDERER_ID, collectIslandStyles, computePagesNeedingClientJS, createIslandManifest, editIslandSource, extractCssImports, findIslandImports, findStaticCssImports, generateIslandClientEntry, hasIslandPages, islandCssFiles, islandStyleRoots, islandStylesPlugin, islandsBuildConfig, mdClientScriptIds, recordIslandStyles, recordedIslandStyles, resolveSpecifier, rewriteCssImportForVirtualModule, watchPagesForRescan };

package/dist/pages/prefetch.d.mts

@@ -1,2 +1,2 @@
-import { a as parseCacheFor, i as PrefetchCache, n as CacheForInput, r as CacheForResult, t as CacheEntry } from "../prefetch-CG0K6JPd.mjs";
-export { CacheEntry, CacheForInput, CacheForResult, PrefetchCache, parseCacheFor };
+import { a as LinkPrefetchValue, c as parseCacheFor, i as LinkPrefetchStrategy, n as CacheForInput, o as PrefetchCache, r as CacheForResult, s as assertLinkPrefetchValue, t as CacheEntry } from "../prefetch-NdNeubbH.mjs";
+export { CacheEntry, CacheForInput, CacheForResult, LinkPrefetchStrategy, LinkPrefetchValue, PrefetchCache, assertLinkPrefetchValue, parseCacheFor };

package/dist/pages/prefetch.mjs

@@ -1 +1 @@
-export { t as PrefetchCache, n as parseCacheFor } from "../prefetch-L93_1Jk7.mjs";
+export { t as PrefetchCache, n as assertLinkPrefetchValue, r as parseCacheFor } from "../prefetch-Dx2jIbtg.mjs";

package/dist/pages/protocol.d.mts

@@ -1,3 +1,3 @@
-import { w as ValidationError } from "../handler-Drm_lyrV.mjs";
-import { a as handlePageMutation, i as handlePageGet, n as PageRenderResult, o as safeJsonStringify, r as flattenValidationErrors, t as PageObject } from "../protocol-xdrl-In0.mjs";
+import { w as ValidationError } from "../handler-BR6Tvjkp.mjs";
+import { a as handlePageMutation, i as handlePageGet, n as PageRenderResult, o as safeJsonStringify, r as flattenValidationErrors, t as PageObject } from "../protocol-CkwjASep.mjs";
 export { PageObject, PageRenderResult, ValidationError, flattenValidationErrors, handlePageGet, handlePageMutation, safeJsonStringify };

package/dist/pages/protocol.mjs

@@ -1,3 +1,3 @@
-import { t as ValidationError } from "../validation-error-rDVbUJet.mjs";
-import { i as safeJsonStringify, n as handlePageGet, r as handlePageMutation, t as flattenValidationErrors } from "../protocol-0-lp9ZYx.mjs";
+import { t as ValidationError } from "../validation-error-uAAjlsiW.mjs";
+import { i as safeJsonStringify, n as handlePageGet, r as handlePageMutation, t as flattenValidationErrors } from "../protocol-COyySMki.mjs";
 export { ValidationError, flattenValidationErrors, handlePageGet, handlePageMutation, safeJsonStringify };

package/dist/platform-args-C7XUw9mw.mjs

@@ -0,0 +1 @@
+export { t as parsePlatformArgs } from "./platform-args-Cx1M-7bq.mjs";