vike-lite 1.15.14 → 1.15.16

package/dist/__internal/client.d.mts

@@ -1,7 +1,10 @@
+import { t as VikeState } from "../store-9UNcAe5D.mjs";
 //#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(scrollStateSetState: boolean): void;
+declare function finalizeNavigation(shouldScrollToTop: {
+  current: boolean;
+}): void;
 interface ViewComponents {
   Page: any | null;
   Layout: any | null;
@@ -49,5 +52,37 @@ declare function createRoutePrefetcher(): (route: PrefetchableRoute) => void;
  * Returns true if a reload was triggered — the caller should stop further error handling.
  */
 declare function tryRecoverFromStaleModuleGraph(message: string, urlToReload: string): boolean;
+/**
+ * Stamp the client-only flags that every `PageContextClient` requires (`isClientSide`,
+ * `isHydration`) onto the raw context blob the server injected via `window.__PAGE_CONTEXT__`.
+ * Centralized so every adapter sets these consistently instead of some silently omitting them.
+ */
+declare function buildInitialClientContext<T extends Record<string, any>>(rawContext: T | undefined, isHydration: boolean): T & {
+  isClientSide: true;
+  isHydration: boolean;
+};
+interface HydrationInitialContext {
+  urlPathname?: string;
+  is404?: boolean;
+  is500?: boolean;
+  errorMessage?: string;
+}
+/**
+ * Resolve the Page/Layout/Head modules to hydrate with, matching what the server
+ * actually rendered into the HTML: the error route's modules when the server
+ * reported a 404/500/error, otherwise the modules of the route matching the
+ * initial pathname. Returns a null view when hydration isn't happening (client
+ * takeover) — the router's own first-load effect performs the initial load instead.
+ */
+declare function resolveHydrationView(initialContext: HydrationInitialContext, isHydration: boolean, routes: VikeState['routes'], errorRoute: VikeState['errorRoute']): Promise<ViewComponents>;
+/**
+ * Consume the server-injected initial context if it still matches the given pathname
+ * (i.e. this is the very first client-side route load, right after SSR hydration/render).
+ * Clears the global reference so a later remount at the same pathname (e.g. React
+ * StrictMode double-invoke in dev) triggers a real fetch instead of being mistaken
+ * for the original initial load. Returns true if consumed — the caller should skip
+ * loading for this run.
+ */
+declare function consumeMatchingInitialContext(pathname: string): boolean;
 //#endregion
-export { ViewComponents, buildPageContextJsonUrl, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, tryRecoverFromStaleModuleGraph };
+export { ViewComponents, buildInitialClientContext, buildPageContextJsonUrl, consumeMatchingInitialContext, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, resolveHydrationView, tryRecoverFromStaleModuleGraph };

package/dist/__internal/client.mjs

@@ -1,4 +1,4 @@
-import { BASE_URL } from "./shared.mjs";
+import { BASE_URL, matchRoute } 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;
@@ -15,7 +15,7 @@ function isSamePage(url) {
 }
 function createLinkClickHandler(onNavigate) {
 	return (e) => {
-		if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+		if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || !(e.target instanceof Element)) return;
 		const url = getClientSideUrl(e.target.closest("a"));
 		if (!url || isSamePage(url)) return;
 		e.preventDefault();
@@ -25,15 +25,16 @@ function createLinkClickHandler(onNavigate) {
 }
 function createLinkPrefetchHandler(onPrefetch) {
 	return (e) => {
+		if (!(e.target instanceof Element)) return;
 		const url = getClientSideUrl(e.target.closest("a"));
 		if (!url || isSamePage(url)) return;
 		onPrefetch(url);
 	};
 }
-function finalizeNavigation(scrollStateSetState) {
-	if (scrollStateSetState) {
+function finalizeNavigation(shouldScrollToTop) {
+	if (shouldScrollToTop.current) {
 		globalThis.scrollTo(0, 0);
-		scrollStateSetState = false;
+		shouldScrollToTop.current = false;
 	} else if (globalThis.location.hash) requestAnimationFrame(() => {
 		try {
 			document.querySelector(decodeURIComponent(globalThis.location.hash))?.scrollIntoView();
@@ -111,5 +112,48 @@ function tryRecoverFromStaleModuleGraph(message, urlToReload) {
 	globalThis.location.assign(urlToReload);
 	return true;
 }
+/**
+* Stamp the client-only flags that every `PageContextClient` requires (`isClientSide`,
+* `isHydration`) onto the raw context blob the server injected via `window.__PAGE_CONTEXT__`.
+* Centralized so every adapter sets these consistently instead of some silently omitting them.
+*/
+function buildInitialClientContext(rawContext, isHydration) {
+	return {
+		...rawContext ?? {},
+		isClientSide: true,
+		isHydration
+	};
+}
+/**
+* Resolve the Page/Layout/Head modules to hydrate with, matching what the server
+* actually rendered into the HTML: the error route's modules when the server
+* reported a 404/500/error, otherwise the modules of the route matching the
+* initial pathname. Returns a null view when hydration isn't happening (client
+* takeover) — the router's own first-load effect performs the initial load instead.
+*/
+async function resolveHydrationView(initialContext, isHydration, routes, errorRoute) {
+	const emptyView = {
+		Page: null,
+		Layout: null,
+		Head: null
+	};
+	if (!isHydration) return emptyView;
+	if (errorRoute && (initialContext.is404 || initialContext.is500 || initialContext.errorMessage)) return loadViewModules(errorRoute);
+	const matched = matchRoute(initialContext.urlPathname ?? globalThis.location.pathname, routes);
+	return matched ? loadViewModules(matched.route) : emptyView;
+}
+/**
+* Consume the server-injected initial context if it still matches the given pathname
+* (i.e. this is the very first client-side route load, right after SSR hydration/render).
+* Clears the global reference so a later remount at the same pathname (e.g. React
+* StrictMode double-invoke in dev) triggers a real fetch instead of being mistaken
+* for the original initial load. Returns true if consumed — the caller should skip
+* loading for this run.
+*/
+function consumeMatchingInitialContext(pathname) {
+	if (globalThis.__PAGE_CONTEXT__?.urlPathname !== pathname) return false;
+	globalThis.__PAGE_CONTEXT__ = void 0;
+	return true;
+}
 //#endregion
-export { buildPageContextJsonUrl, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, tryRecoverFromStaleModuleGraph };
+export { buildInitialClientContext, buildPageContextJsonUrl, consumeMatchingInitialContext, createLinkClickHandler, createLinkPrefetchHandler, createRoutePrefetcher, fetchPageContextJson, finalizeNavigation, loadViewModules, resolveHydrationView, tryRecoverFromStaleModuleGraph };

package/dist/__internal/server.d.mts

@@ -1,11 +1,2 @@
-//#region src/server/store.d.ts
-interface VikeState {
-  routes: typeof import('virtual:vike-lite/routes')['routes'] | [];
-  errorRoute: typeof import('virtual:vike-lite/routes')['errorRoute'] | null;
-  config: typeof import('virtual:vike-lite/routes')['config'] | null;
-  manifest: typeof import('virtual:vike-lite/client-manifest')['default'] | null;
-}
-declare const store: VikeState;
-declare function setVikeState(newState: Partial<VikeState>): void;
-//#endregion
+import { n as setVikeState, r as store, t as VikeState } from "../store-9UNcAe5D.mjs";
 export { VikeState, setVikeState, store };

package/dist/store-9UNcAe5D.d.mts

@@ -0,0 +1,11 @@
+//#region src/server/store.d.ts
+interface VikeState {
+  routes: typeof import('virtual:vike-lite/routes')['routes'] | [];
+  errorRoute: typeof import('virtual:vike-lite/routes')['errorRoute'] | null;
+  config: typeof import('virtual:vike-lite/routes')['config'] | null;
+  manifest: typeof import('virtual:vike-lite/client-manifest')['default'] | null;
+}
+declare const store: VikeState;
+declare function setVikeState(newState: Partial<VikeState>): void;
+//#endregion
+export { setVikeState as n, store as r, VikeState as t };

package/dist/vite.mjs

@@ -209,7 +209,7 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 							} : VIRTUAL.entryServer,
 							output: {
 								format: "esm",
-								entryFileNames: "index.mjs",
+								entryFileNames: "[name].mjs",
 								chunkFileNames: (chunkInfo) => {
 									if (chunkInfo.facadeModuleId?.includes(`/${pagesDir}/`)) return "assets/pages/[name].[hash].mjs";
 									return "assets/chunks/[name].[hash].mjs";
@@ -221,7 +221,7 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 			};
 		},
 		configResolved(config) {
-			if (!config.plugins.some((plugin) => plugin.name?.startsWith("vike-lite-") && SUPPORTED_RENDERERS.includes(plugin.name.replace("vike-lite-", "")))) throw new Error(`[vike-lite] No UI renderer plugin found in 'vite.config': please install and configure one of ${SUPPORTED_RENDERERS.map((r) => `vike-lite-${r}`).join(", ")}`);
+			if (!config.plugins.some((plugin) => plugin.name?.startsWith("vike-lite-") && SUPPORTED_RENDERERS.includes(plugin.name.replace("vike-lite-", "")))) throw new Error(`❌ No UI adapter plugin found in 'vite.config': please install and configure one of ${SUPPORTED_RENDERERS.map((r) => `vike-lite-${r}`).join(", ")}`);
 		},
 		resolveId(id) {
 			if (VIRTUAL_VALUES.has(id)) return "\0" + id;
@@ -283,7 +283,7 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 							break;
 						}
 					}
-					if (!serverEntryPath) throw new Error(`[vike-lite] serverEntry '${serverEntry}' file not found`);
+					if (!serverEntryPath) throw new Error(`❌ serverEntry ${serverEntry} file not found`);
 					serverEntryPath = serverEntryPath.replaceAll("\\", "/");
 					return importSetup + `export*from'${serverEntryPath}';export{default}from'${serverEntryPath}';`;
 				}
@@ -314,7 +314,7 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 				}
 				if (shouldPrerender) {
 					if (route.path.includes(":") && dynamicUrls.length === 0) {
-						console.warn(`[vike-lite] ⚠️ Skipping dynamic route "${route.path}": no URLs provided by +prerender. Return an array of URLs to prerender it.`);
+						console.warn(`⚠️ Skipping dynamic route ${route.path}: no URLs provided by +prerender. Return an array of URLs to prerender it.`);
 						continue;
 					}
 					if (!route.path.includes(":")) urlsToPrerender.add(route.path);
@@ -322,7 +322,7 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 				}
 			}
 			if (urlsToPrerender.size === 0) return;
-			console.log("[vike-lite] 📦 Starting Static Site Generation (SSG)…");
+			console.log("📦 Starting Static Site Generation (SSG)…");
 			let generatedCount = 0;
 			const clientDir = path.join(viteConfigRoot, outDir, "client");
 			for (const urlPath of urlsToPrerender) {
@@ -331,18 +331,22 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 					const outDirRoute = path.join(clientDir, urlPath === "/" ? "" : urlPath);
 					fs.mkdirSync(outDirRoute, { recursive: true });
 					fs.writeFileSync(path.join(outDirRoute, "index.html"), await htmlRes.text());
-				} else throw new Error(`[vike-lite] ❌ SSG HTML Error for "${urlPath}"`);
+				} else throw new Error(`❌ SSG HTML Error for "${urlPath}"`);
 				const jsonTarget = urlPath === "/" ? "/index" : urlPath;
 				const jsonRes = await renderPage(new Request(`http://localhost${baseUrl}${jsonTarget}.pageContext.json`));
 				if (jsonRes?.ok) {
 					const jsonOutPath = path.join(clientDir, `${jsonTarget}.pageContext.json`);
 					fs.mkdirSync(path.dirname(jsonOutPath), { recursive: true });
 					fs.writeFileSync(jsonOutPath, await jsonRes.text());
-				} else throw new Error(`[vike-lite] ❌ SSG JSON Error for "${jsonTarget}"`);
-				console.log(`  → ${urlPath}`);
+				} else throw new Error(`❌ SSG JSON Error for "${jsonTarget}"`);
+				console.log(`  route → ${urlPath}`);
 				generatedCount++;
 			}
-			console.log(`[vike-lite] ✨ SSG Completed! Generated ${generatedCount} static routes`);
+			if (urlsToPrerender.size === 0) {
+				console.warn("ℹ️  No static routes to generate. If you don't want to use SSG, in the 'vite.config', set \"prerender\" option as \"false\" or remove.");
+				return;
+			}
+			console.log(`✨ SSG Completed! Generated ${generatedCount} static routes`);
 		},
 		configureServer(server) {
 			return () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike-lite",
-  "version": "1.15.14",
+  "version": "1.15.16",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -82,7 +82,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
-    "tsdown": "^0.22.9",
+    "tsdown": "^0.22.11",
     "vite": "^8.1.5",
     "vitest": "^4.1.10"
   },