vike-lite 1.15.10 → 1.15.12

package/dist/__internal/client.d.mts

@@ -1,6 +1,55 @@
 //#region src/__internal/client.d.ts
 declare function createLinkClickHandler(onNavigate: (url: URL) => void): (e: MouseEvent) => void;
 declare function createLinkPrefetchHandler(onPrefetch: (url: URL) => void): (e: Event) => void;
-declare function finalizeNavigation(shouldScrollToTop: boolean): void;
+declare function finalizeNavigation(scrollState: {
+  [key: string]: boolean;
+}, key: string): void;
+interface ViewComponents {
+  Page: any | null;
+  Layout: any | null;
+  Head: any | null;
+}
+interface RouteModuleLoaders {
+  Page: () => Promise<any>;
+  Layout?: () => Promise<any>;
+  Head?: () => Promise<any>;
+}
+/**
+ * Load a route's Page/Layout/Head modules in parallel and resolve each
+ * module's export (named export first, falling back to the default export).
+ */
+declare function loadViewModules(route: RouteModuleLoaders): Promise<ViewComponents>;
+/**
+ * Build the URL of the `+data`/`+title` JSON endpoint for a given pathname
+ * (e.g. base "/my-app" and path "/about" → "/my-app/about.pageContext.json").
+ */
+declare function buildPageContextJsonUrl(pathname: string, search: string): string;
+/**
+ * Fetch and parse a `.pageContext.json` endpoint, throwing a descriptive error
+ * if a proxy/CDN intercepted the request with a non-JSON response.
+ */
+declare function fetchPageContextJson(jsonUrl: string, options: {
+  signal: AbortSignal;
+  cache?: RequestCache;
+}): Promise<any>;
+interface PrefetchableRoute {
+  page?: string;
+  layout?: string;
+  head?: string;
+  Page?: () => Promise<any>;
+  Layout?: () => Promise<any>;
+  Head?: () => Promise<any>;
+}
+/**
+ * Create a per-router-instance prefetcher that loads a route's modules at most once
+ * (e.g. on link hover/focus), retrying later if the load failed.
+ */
+declare function createRoutePrefetcher(): (route: PrefetchableRoute) => void;
+/**
+ * Detect a stale module graph error (dev server restarted / new build deployed) and
+ * force a full browser reload, guarded against reload loops via sessionStorage.
+ * Returns true if a reload was triggered — the caller should stop further error handling.
+ */
+declare function tryRecoverFromStaleModuleGraph(message: string, urlToReload: string): boolean;
 //#endregion
-export { createLinkClickHandler, createLinkPrefetchHandler, finalizeNavigation };
+export { ViewComponents, buildPageContextJsonUrl, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, tryRecoverFromStaleModuleGraph };

package/dist/__internal/client.mjs

@@ -1,3 +1,4 @@
+import { BASE_URL } from "./shared.mjs";
 //#region src/__internal/client.ts
 function getClientSideUrl(target) {
 	if (!target?.href || target.target && target.target !== "_self" || target.hasAttribute("download") || target.hasAttribute("data-native") || target.getAttribute("rel")?.includes("external")) return null;
@@ -29,15 +30,86 @@ function createLinkPrefetchHandler(onPrefetch) {
 		onPrefetch(url);
 	};
 }
-function finalizeNavigation(shouldScrollToTop) {
-	if (shouldScrollToTop) {
+function finalizeNavigation(scrollState, key) {
+	if (scrollState[key] === true) {
 		globalThis.scrollTo(0, 0);
-		shouldScrollToTop = false;
+		scrollState[key] = false;
 	} else if (globalThis.location.hash) requestAnimationFrame(() => {
 		try {
 			document.querySelector(decodeURIComponent(globalThis.location.hash))?.scrollIntoView();
 		} catch {}
 	});
 }
+/**
+* Load a route's Page/Layout/Head modules in parallel and resolve each
+* module's export (named export first, falling back to the default export).
+*/
+async function loadViewModules(route) {
+	const [PageMod, LayoutMod, HeadMod] = await Promise.all([
+		route.Page(),
+		route.Layout?.() ?? null,
+		route.Head?.() ?? null
+	]);
+	return {
+		Page: PageMod.Page ?? PageMod.default,
+		Layout: LayoutMod?.Layout ?? LayoutMod?.default ?? null,
+		Head: HeadMod?.Head ?? HeadMod?.default ?? null
+	};
+}
+/**
+* Build the URL of the `+data`/`+title` JSON endpoint for a given pathname
+* (e.g. base "/my-app" and path "/about" → "/my-app/about.pageContext.json").
+*/
+function buildPageContextJsonUrl(pathname, search) {
+	return `${BASE_URL}${pathname === "/" ? "/index" : pathname}.pageContext.json${search}`;
+}
+/**
+* Fetch and parse a `.pageContext.json` endpoint, throwing a descriptive error
+* if a proxy/CDN intercepted the request with a non-JSON response.
+*/
+async function fetchPageContextJson(jsonUrl, options) {
+	const res = await fetch(jsonUrl, options);
+	const contentType = res.headers.get("content-type") ?? "";
+	if (!contentType.includes("application/json")) throw new Error(`Expected JSON but got "${contentType}" for ${jsonUrl}. Check your proxy/CDN configuration.`);
+	return res.json();
+}
+/**
+* Create a per-router-instance prefetcher that loads a route's modules at most once
+* (e.g. on link hover/focus), retrying later if the load failed.
+*/
+function createRoutePrefetcher() {
+	const prefetchedModules = /* @__PURE__ */ new Set();
+	return function prefetchRoute(route) {
+		const modules = [
+			[route.page, route.Page],
+			[route.layout, route.Layout],
+			[route.head, route.Head]
+		];
+		for (const [key, loader] of modules) {
+			if (!key || !loader || prefetchedModules.has(key)) continue;
+			prefetchedModules.add(key);
+			loader().catch(() => {
+				prefetchedModules.delete(key);
+			});
+		}
+	};
+}
+const STALE_MODULE_GRAPH_PATTERN = /dynamically imported module|importing a module script failed/i;
+const RELOAD_GUARD_KEY = "vike-lite:reload-guard";
+const RELOAD_GUARD_WINDOW_MS = 1e4;
+/**
+* Detect a stale module graph error (dev server restarted / new build deployed) and
+* force a full browser reload, guarded against reload loops via sessionStorage.
+* Returns true if a reload was triggered — the caller should stop further error handling.
+*/
+function tryRecoverFromStaleModuleGraph(message, urlToReload) {
+	if (!STALE_MODULE_GRAPH_PATTERN.test(message)) return false;
+	const last = Number(sessionStorage.getItem(RELOAD_GUARD_KEY) ?? 0);
+	if (Date.now() - last <= RELOAD_GUARD_WINDOW_MS) return false;
+	sessionStorage.setItem(RELOAD_GUARD_KEY, String(Date.now()));
+	console.warn("App update detected, forcing reload…");
+	globalThis.location.assign(urlToReload);
+	return true;
+}
 //#endregion
-export { createLinkClickHandler, createLinkPrefetchHandler, finalizeNavigation };
+export { buildPageContextJsonUrl, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, tryRecoverFromStaleModuleGraph };

package/dist/__internal/shared.d.mts

@@ -18,6 +18,15 @@ declare function matchRoute(urlPathname: string, routes: typeof import('virtual:
   routeParams: Record<string, string>;
 } | null;
 declare const BASE_URL: string;
+/**
+ * Remove the base path from a pathname (e.g. `location.pathname` on the client,
+ * or the incoming request pathname on the server).
+ * Returns the pathname unchanged if it doesn't match the base.
+ */
 declare function stripBase(pathname: string): string;
+/**
+ * Prepend the base path to an absolute, root-relative path (e.g. '/about').
+ */
+declare function prependBase(pathname: string): string;
 //#endregion
-export { BASE_URL, RenderContext, matchRoute, stripBase };
+export { BASE_URL, RenderContext, matchRoute, prependBase, stripBase };

package/dist/__internal/shared.mjs

@@ -44,11 +44,22 @@ const BASE_URL = (() => {
 	const { BASE_URL } = import.meta.env;
 	return BASE_URL.endsWith("/") ? BASE_URL.slice(0, -1) : BASE_URL;
 })();
+/**
+* Remove the base path from a pathname (e.g. `location.pathname` on the client,
+* or the incoming request pathname on the server).
+* Returns the pathname unchanged if it doesn't match the base.
+*/
 function stripBase(pathname) {
 	if (BASE_URL === "") return pathname;
 	if (pathname === BASE_URL) return "/";
 	if (pathname.startsWith(BASE_URL + "/")) return pathname.slice(BASE_URL.length);
 	return pathname;
 }
+/**
+* Prepend the base path to an absolute, root-relative path (e.g. '/about').
+*/
+function prependBase(pathname) {
+	return BASE_URL + (pathname === "/" ? "" : pathname);
+}
 //#endregion
-export { BASE_URL, matchRoute, stripBase };
+export { BASE_URL, matchRoute, prependBase, stripBase };

package/dist/__internal/vite.d.mts

@@ -0,0 +1,19 @@
+import { Plugin } from "vite";
+//#region src/__internal/vite.d.ts
+/**
+ * Creates the Vite plugin that wires a UI framework adapter (react/vue/solid) into vike-lite,
+ * by providing the virtual `virtual:vike-lite/client` and `virtual:vike-lite/server` modules
+ * that vike-lite's core plugin reads to discover the framework's onRenderClient/onRenderHtml hooks.
+ *
+ * This centralizes logic that is otherwise identical across every `vike-lite-*` package.
+ */
+declare function createFrameworkAdapterPlugin({ packageName, hydration, wrapServerHydration }: {
+  /** The framework adapter's package name, e.g. 'vike-lite-react'. */
+  packageName: string;
+  /** @default true */
+  hydration?: boolean;
+  /** @default true */
+  wrapServerHydration?: boolean;
+}): Plugin;
+//#endregion
+export { createFrameworkAdapterPlugin };

package/dist/__internal/vite.mjs

@@ -0,0 +1,28 @@
+//#region src/__internal/vite.ts
+/**
+* Creates the Vite plugin that wires a UI framework adapter (react/vue/solid) into vike-lite,
+* by providing the virtual `virtual:vike-lite/client` and `virtual:vike-lite/server` modules
+* that vike-lite's core plugin reads to discover the framework's onRenderClient/onRenderHtml hooks.
+*
+* This centralizes logic that is otherwise identical across every `vike-lite-*` package.
+*/
+function createFrameworkAdapterPlugin({ packageName, hydration = true, wrapServerHydration = true }) {
+	const virtualClientId = "virtual:vike-lite/client";
+	const virtualServerId = "virtual:vike-lite/server";
+	const resolvedVirtualClientId = "\0virtual:vike-lite/client";
+	const resolvedVirtualServerId = "\0virtual:vike-lite/server";
+	return {
+		name: packageName,
+		enforce: "pre",
+		resolveId(id) {
+			if (id === virtualClientId) return resolvedVirtualClientId;
+			if (id === virtualServerId) return resolvedVirtualServerId;
+		},
+		load(id) {
+			if (id === resolvedVirtualClientId) return `export const onRenderClient=async(options)=>(await import("${packageName}/__internal/client/onRenderClient")).onRenderClient({...options,hydration:${hydration}});`;
+			if (id === resolvedVirtualServerId) return wrapServerHydration ? `import { onRenderHtml as _onRenderHtml } from '${packageName}/__internal/server/onRenderHtml';export const onRenderHtml = (ctx) => _onRenderHtml({ ...ctx, hydration: ${hydration} });` : `export{onRenderHtml}from'${packageName}/__internal/server/onRenderHtml';`;
+		}
+	};
+}
+//#endregion
+export { createFrameworkAdapterPlugin };

package/dist/client/router.mjs

@@ -1,4 +1,4 @@
-import { BASE_URL } from "../__internal/shared.mjs";
+import { prependBase } from "../__internal/shared.mjs";
 //#region src/client/router.ts
 /**
 * Change page programmatically on the client without reloading the browser.
@@ -8,7 +8,7 @@ import { BASE_URL } from "../__internal/shared.mjs";
 function navigate(url, options) {
 	if (typeof globalThis === "undefined") throw new Error("navigate() can only be called on the client side.");
 	let finalUrl = url;
-	if (finalUrl.startsWith("/")) finalUrl = BASE_URL + (finalUrl === "/" ? "" : finalUrl);
+	if (finalUrl.startsWith("/")) finalUrl = prependBase(finalUrl);
 	globalThis.history.pushState({ triggeredBy: "vike-lite" }, "", finalUrl);
 	globalThis.dispatchEvent(new CustomEvent("vike-navigate", { detail: {
 		keepScrollPosition: options?.keepScrollPosition,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike-lite",
-  "version": "1.15.10",
+  "version": "1.15.12",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -67,6 +67,10 @@
     "./__internal/server": {
       "types": "./dist/__internal/server.d.mts",
       "import": "./dist/__internal/server.mjs"
+    },
+    "./__internal/vite": {
+      "types": "./dist/__internal/vite.d.mts",
+      "import": "./dist/__internal/vite.mjs"
     }
   },
   "files": [