vike 0.4.244 → 0.4.245-commit-189d2b8

package/dist/esm/client/runtime-client-routing/getPageContextFromHooks.d.ts

@@ -89,6 +89,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
     url: string;
 } & import("../../shared/page-configs/resolveVikeConfigPublic.js").GlobalConfigPublic & {
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     isClientSideNavigation: boolean;
     isHydration: boolean;
     previousPageContext: ({
@@ -144,6 +145,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
     } & {
         isHydration: boolean;
         isBackwardNavigation: boolean | null;
+        isHistoryNavigation: boolean;
         previousPageContext: import("../../types/PageContext.js").PageContextClient<unknown> | null;
         globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
     } & {
@@ -209,6 +211,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
 } & {
     isHydration: boolean;
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     previousPageContext: import("../../types/PageContext.js").PageContextClient<unknown> | null;
     globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
 } & {
@@ -310,6 +313,7 @@ declare function getPageContextFromClientHooks(pageContext: {
     url: string;
 } & import("../../shared/page-configs/resolveVikeConfigPublic.js").GlobalConfigPublic & {
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     isClientSideNavigation: boolean;
     isHydration: boolean;
     previousPageContext: ({
@@ -365,6 +369,7 @@ declare function getPageContextFromClientHooks(pageContext: {
     } & {
         isHydration: boolean;
         isBackwardNavigation: boolean | null;
+        isHistoryNavigation: boolean;
         previousPageContext: import("../../types/PageContext.js").PageContextClient<unknown> | null;
         globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
     } & {
@@ -428,6 +433,7 @@ declare function getPageContextFromClientHooks(pageContext: {
 } & {
     isHydration: boolean;
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     previousPageContext: import("../../types/PageContext.js").PageContextClient<unknown> | null;
     globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
 } & {

package/dist/esm/client/runtime-client-routing/history.d.ts

@@ -23,8 +23,12 @@ type HistoryInfo = {
     state: StateEnhanced;
 };
 declare function onPopStateBegin(): {
-    isHistoryStateEnhanced: boolean;
+    skip: true;
+    previous?: undefined;
+    current?: undefined;
+} | {
     previous: HistoryInfo;
     current: HistoryInfo;
+    skip?: undefined;
 };
 declare function initHistory(): void;

package/dist/esm/client/runtime-client-routing/history.js

@@ -4,7 +4,7 @@ export { onPopStateBegin };
 export { saveScrollPosition };
 export { initHistory };
 import { getCurrentUrl } from '../shared/getCurrentUrl.js';
-import { assert, assertUsage, getGlobalObject, isObject, deepEqual, cast } from './utils.js';
+import { assert, assertUsage, getGlobalObject, isObject, deepEqual, cast, redirectHard } from './utils.js';
 const globalObject = getGlobalObject('history.ts', {
     monkeyPatched: false,
     previous: undefined,
@@ -66,6 +66,10 @@ function getTimestamp() {
 }
 function saveScrollPosition() {
     const scrollPosition = getScrollPosition();
+    // Don't overwrite history.state if it was set by a non-Vike history.pushState() call.
+    // https://github.com/vikejs/vike/issues/2801#issuecomment-3490431479
+    if (!isVikeEnhanced(window.history.state))
+        return;
     const state = getState();
     replaceHistoryState({ ...state, scrollPosition });
 }
@@ -160,13 +164,31 @@ function getHistoryInfo() {
 }
 function onPopStateBegin() {
     const { previous } = globalObject;
-    const isHistoryStateEnhanced = window.history.state !== null;
+    const isHistoryStateEnhanced = isVikeEnhanced(window.history.state);
+    // Either:
+    // - `window.history.pushState(null, '', '/some-path')` , or
+    // - hash navigation
+    //   - Click on `<a href="#some-hash">`
+    //   - Using the `location` API (only hash navigation)
+    // See comments a the top of the ./initOnPopState.ts file.
+    const isHistoryStatePristine = window.history.state === null;
+    if (!isHistoryStateEnhanced && !isHistoryStatePristine) {
+        // Going to a history entry not created by Vike — entering another "SPA realm" => hard reload
+        // https://github.com/vikejs/vike/issues/2801#issuecomment-3490431479
+        redirectHard(getCurrentUrl());
+        return { skip: true };
+    }
     if (!isHistoryStateEnhanced)
         enhanceHistoryState();
     assertIsVikeEnhanced(window.history.state);
     const current = getHistoryInfo();
     globalObject.previous = current;
-    return { isHistoryStateEnhanced, previous, current };
+    // Let the browser handle hash navigations.
+    // - Upon hash navigation: `isHistoryStatePristine===true` (see comment above).
+    if (isHistoryStatePristine) {
+        return { skip: true };
+    }
+    return { previous, current };
 }
 function initHistory() {
     monkeyPatchHistoryAPI(); // the earlier we call it the better (Vike can workaround erroneous library monkey patches if Vike is the last one in the monkey patch chain)

package/dist/esm/client/runtime-client-routing/initClientRouter.js

@@ -23,7 +23,6 @@ async function renderFirstPage() {
     assert(getRenderCount() === 0);
     await renderPageClientSide({
         scrollTarget: { preserveScroll: true },
-        isBackwardNavigation: null,
         isClientSideNavigation: false,
     });
 }

package/dist/esm/client/runtime-client-routing/initOnLinkClick.js

@@ -1,5 +1,5 @@
 export { initOnLinkClick };
-import { isLinkIgnored, isSameAsCurrentUrl, skipLink } from './skipLink.js';
+import { isLinkIgnored, isHrefCurrentUrl, isLinkSkipped } from './isLinkSkipped.js';
 import { renderPageClientSide } from './renderPageClientSide.js';
 import { scrollToHashOrTop } from './setScrollPosition.js';
 function initOnLinkClick() {
@@ -19,14 +19,14 @@ async function onLinkClick(ev) {
     // Workaround for Firefox bug: clicking on a hash link that doesn't change the current URL causes Firefox to erroneously set `window.history.state = null` without firing any signal that we can detect.
     // - https://github.com/vikejs/vike/issues/1962
     // - https://github.com/sveltejs/kit/issues/8725
-    if (href.includes('#') && isSameAsCurrentUrl(href)) {
+    if (href.includes('#') && isHrefCurrentUrl(href)) {
         // Prevent Firefox from setting `window.history.state` to `null`
         ev.preventDefault();
         // Replicate the browser's native behavior
         scrollToHashOrTop(href.split('#')[1]);
         return;
     }
-    if (skipLink(linkTag))
+    if (isLinkSkipped(linkTag))
         return;
     ev.preventDefault();
     let scrollTarget;
@@ -38,7 +38,6 @@ async function onLinkClick(ev) {
     await renderPageClientSide({
         scrollTarget,
         urlOriginal: href,
-        isBackwardNavigation: false,
     });
 }
 function isNormalLeftClick(ev) {

package/dist/esm/client/runtime-client-routing/initOnPopState.js

@@ -14,7 +14,7 @@ import { catchInfiniteLoop } from './utils.js';
 // 2. URL hash changes:
 //    - By the user clicking on `<a href="#some-hash">`
 //      - The popstate event is *only* triggered if `href` starts with '#' (even if `href==='/foo#bar'` and the current URL has the same pathname '/foo' then popstate isn't triggered)
-//      - Vike doesn't intercept hash links (see `skipLink()`) and let's the browser handle them.
+//      - Vike doesn't intercept hash links (see `isLinkSkipped()`) and let's the browser handle them.
 //    - By the app using a `location` API such as `location.hash = 'some-hash'`
 //      - Only upon hash navigation: setting `location.href='/foo'` triggers a full page reload and no popstate event is fired.
 //      - Also upon `location.href='/foo#bar'` while the current URL is '/foo' (unlike <a> clicks).
@@ -23,26 +23,20 @@ import { catchInfiniteLoop } from './utils.js';
 // - It isn't possible to monkey patch the `location` APIs. (Chrome throws `TypeError: Cannot redefine property` when attempt to overwrite any `location` property.)
 // - Text links aren't supported: https://github.com/vikejs/vike/issues/2114
 // - docs/ is a good playground to test all this.
+// - No 'popstate' event is fired upon Server Routing — when the user clicks on a link before the page's JavaScript loaded.
+// - On a pristine page without JavaScript such as https://brillout.com we have `window.history.state === null`.
 function initOnPopState() {
     window.addEventListener('popstate', onPopState);
 }
 async function onPopState() {
     catchInfiniteLoop('onPopState()');
-    const { isHistoryStateEnhanced, previous, current } = onPopStateBegin();
-    // - `isHistoryStateEnhanced===false` <=> new hash navigation:
-    //   - Click on `<a href="#some-hash">`
-    //   - Using the `location` API (only hash navigation, see comments above).
-    // - `isHistoryStateEnhanced===true` <=> back-/forward navigation (including back-/forward hash navigation).
-    //   > Only back-/forward client-side navigation: no 'popstate' event is fired upon Server Routing (when the user clicks on a link before the page's JavaScript loaded), see comments above.
-    if (!isHistoryStateEnhanced) {
-        // Let the browser handle it
+    const res = onPopStateBegin();
+    if (res.skip)
         return;
-    }
-    else {
-        await handleBackForwardNavigation(previous, current);
-    }
+    const { previous, current } = res;
+    await handleHistoryNavigation(previous, current);
 }
-async function handleBackForwardNavigation(previous, current) {
+async function handleHistoryNavigation(previous, current) {
     const scrollTarget = current.state.scrollPosition || undefined;
     const isHashNavigation = removeHash(current.url) === removeHash(previous.url) && current.url !== previous.url;
     if (isHashNavigation) {
@@ -53,7 +47,7 @@ async function handleBackForwardNavigation(previous, current) {
     const isUserPushStateNavigation = current.state.triggeredBy === 'user' || previous.state.triggeredBy === 'user';
     const doNotRenderIfSamePage = isUserPushStateNavigation;
     const isBackwardNavigation = !current.state.timestamp || !previous.state.timestamp ? null : current.state.timestamp < previous.state.timestamp;
-    await renderPageClientSide({ scrollTarget, isBackwardNavigation, doNotRenderIfSamePage });
+    await renderPageClientSide({ scrollTarget, isBackwardNavigation, doNotRenderIfSamePage, isHistoryNavigation: true });
 }
 function removeHash(url) {
     return url.split('#')[0];

package/dist/esm/client/runtime-client-routing/isLinkSkipped.d.ts

@@ -0,0 +1,6 @@
+export { isLinkSkipped };
+export { isLinkIgnored };
+export { isHrefCurrentUrl };
+declare function isLinkSkipped(linkTag: HTMLElement): boolean;
+declare function isLinkIgnored(linkTag: HTMLElement): boolean;
+declare function isHrefCurrentUrl(href: string): boolean;

package/dist/esm/client/runtime-client-routing/{skipLink.js → isLinkSkipped.js}

@@ -1,18 +1,17 @@
-// TODO: rename_full skipLink isLinkSkipped
-export { skipLink };
+export { isLinkSkipped };
 export { isLinkIgnored };
-export { isSameAsCurrentUrl };
+export { isHrefCurrentUrl };
 import { normalizeClientSideUrl } from '../shared/normalizeClientSideUrl.js';
 import { getBaseServer } from './getBaseServer.js';
 import { assert, parseUrl, isBaseServer, isUrl, isUrlExternal } from './utils.js';
-function skipLink(linkTag) {
+function isLinkSkipped(linkTag) {
     const href = linkTag.getAttribute('href');
     return (href === null ||
         !isUrl(href) ||
         href === '' ||
         isUrlExternal(href) ||
-        isSamePageHashLink(href) ||
-        isNewTabLink(linkTag) ||
+        isHrefSamePageHash(href) ||
+        isLinkExternal(linkTag) ||
         isLinkIgnored(linkTag) ||
         !hasBaseServer(href) ||
         // Purposely last because disableAutomaticLinkInterception will be removed in the next major release
@@ -25,13 +24,11 @@ function isVikeLink(linkTag) {
         return true;
     }
     else {
-        // TODO: rename target attrVal
-        const target = linkTag.getAttribute('data-vike-link');
-        return target !== null && target !== 'false';
+        const attrVal = linkTag.getAttribute('data-vike-link');
+        return attrVal !== null && attrVal !== 'false';
     }
 }
-// TODO rename
-function isNewTabLink(linkTag) {
+function isLinkExternal(linkTag) {
     const target = linkTag.getAttribute('target');
     const rel = linkTag.getAttribute('rel');
     return target === '_blank' || target === '_external' || rel === 'external' || linkTag.hasAttribute('download');
@@ -39,11 +36,9 @@ function isNewTabLink(linkTag) {
 function isLinkIgnored(linkTag) {
     return linkTag.getAttribute('data-vike') === 'false';
 }
-// TODO refactor both functions below?
-function isSamePageHashLink(href) {
+function isHrefSamePageHash(href) {
     if (href.startsWith('#'))
         return true;
-    // TODO: remove?
     if (href.includes('#') &&
         normalizeClientSideUrl(href, { withoutHash: true }) ===
             normalizeClientSideUrl(window.location.href, { withoutHash: true })) {
@@ -51,7 +46,7 @@ function isSamePageHashLink(href) {
     }
     return false;
 }
-function isSameAsCurrentUrl(href) {
+function isHrefCurrentUrl(href) {
     if (href.startsWith('#'))
         return href === window.location.hash;
     return normalizeClientSideUrl(href) === normalizeClientSideUrl(window.location.href);

package/dist/esm/client/runtime-client-routing/navigate.js

@@ -26,7 +26,6 @@ async function navigate(url, options) {
         scrollTarget,
         urlOriginal: url,
         overwriteLastHistoryEntry,
-        isBackwardNavigation: false,
         pageContextInitClient: pageContext,
     });
 }

package/dist/esm/client/runtime-client-routing/prefetch.js

@@ -7,7 +7,7 @@ export { addLinkPrefetchHandlers_watch };
 export { addLinkPrefetchHandlers_unwatch };
 import { assert, assertClientRouting, assertUsage, assertWarning, checkIfClientRouting, getGlobalObject, hasProp, objectAssign, } from './utils.js';
 import { isErrorFetchingStaticAssets, loadPageConfigsLazyClientSide } from '../shared/loadPageConfigsLazyClientSide.js';
-import { skipLink } from './skipLink.js';
+import { isLinkSkipped } from './isLinkSkipped.js';
 import { disableClientRouting } from './renderPageClientSide.js';
 import { isClientSideRoutable } from './isClientSideRoutable.js';
 import { createPageContextClientSide } from './createPageContextClientSide.js';
@@ -170,7 +170,7 @@ function addLinkPrefetchHandlers_apply() {
         if (globalObject.linkPrefetchHandlerAdded.has(linkTag))
             continue;
         globalObject.linkPrefetchHandlerAdded.add(linkTag);
-        if (skipLink(linkTag))
+        if (isLinkSkipped(linkTag))
             continue;
         linkTag.addEventListener('mouseover', () => {
             prefetchOnEvent(linkTag, 'hover');
@@ -205,7 +205,7 @@ async function prefetchOnEvent(linkTag, event) {
         }
     }
     // Check again in case DOM was manipulated since last check
-    if (skipLink(linkTag))
+    if (isLinkSkipped(linkTag))
         return;
     const urlOfLink = linkTag.getAttribute('href');
     const pageContextLink = await getPageContextLink(urlOfLink);

package/dist/esm/client/runtime-client-routing/renderPageClientSide.d.ts

@@ -19,7 +19,8 @@ type PageContextRouted = {
 type PageContextBegin = Awaited<ReturnType<typeof getPageContextBegin>>;
 type RenderArgs = {
     scrollTarget: ScrollTarget;
-    isBackwardNavigation: boolean | null;
+    isBackwardNavigation?: boolean | null;
+    isHistoryNavigation?: true;
     urlOriginal?: string;
     overwriteLastHistoryEntry?: boolean;
     pageContextsFromRewrite?: PageContextFromRewrite[];
@@ -103,6 +104,7 @@ declare function renderPageClientSide(renderArgs: RenderArgs): Promise<({
     url: string;
 } & import("../../shared/page-configs/resolveVikeConfigPublic.js").GlobalConfigPublic & {
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     isClientSideNavigation: boolean;
     isHydration: boolean;
     previousPageContext: ({
@@ -155,6 +157,7 @@ declare function renderPageClientSide(renderArgs: RenderArgs): Promise<({
     } & {
         isHydration: boolean;
         isBackwardNavigation: boolean | null;
+        isHistoryNavigation: boolean;
         previousPageContext: PageContextClient<unknown> | null;
         globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
     } & {
@@ -174,9 +177,10 @@ declare function renderPageClientSide(renderArgs: RenderArgs): Promise<({
     urlPathname: string;
     _hasPageContextFromServer: boolean;
 } & PageContextRouted) | undefined>;
-declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isBackwardNavigation, pageContextsFromRewrite, isClientSideNavigation, pageContextInitClient, isFirstRender, }: {
+declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isBackwardNavigation, isHistoryNavigation, pageContextsFromRewrite, isClientSideNavigation, pageContextInitClient, isFirstRender, }: {
     urlOriginal: string;
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     pageContextsFromRewrite: PageContextFromRewrite[];
     isClientSideNavigation: boolean;
     pageContextInitClient: Record<string, unknown> | undefined;
@@ -250,6 +254,7 @@ declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isB
     url: string;
 } & import("../../shared/page-configs/resolveVikeConfigPublic.js").GlobalConfigPublic & {
     isBackwardNavigation: boolean | null;
+    isHistoryNavigation: boolean;
     isClientSideNavigation: boolean;
     isHydration: boolean;
     previousPageContext: ({
@@ -302,6 +307,7 @@ declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isB
     } & {
         isHydration: boolean;
         isBackwardNavigation: boolean | null;
+        isHistoryNavigation: boolean;
         previousPageContext: PageContextClient<unknown> | null;
         globalContext: import("../../types/GlobalContext.js").GlobalContextClient;
     } & {

package/dist/esm/client/runtime-client-routing/renderPageClientSide.js

@@ -36,7 +36,7 @@ const globalObject = getGlobalObject('runtime-client-routing/renderPageClientSid
 const { firstRenderStartPromise } = globalObject;
 async function renderPageClientSide(renderArgs) {
     catchInfiniteLoop('renderPageClientSide()');
-    const { urlOriginal = getCurrentUrl(), overwriteLastHistoryEntry = false, isBackwardNavigation, pageContextsFromRewrite = [], redirectCount = 0, doNotRenderIfSamePage, isClientSideNavigation = true, pageContextInitClient, } = renderArgs;
+    const { urlOriginal = getCurrentUrl(), overwriteLastHistoryEntry = false, isBackwardNavigation = false, isHistoryNavigation = false, pageContextsFromRewrite = [], redirectCount = 0, doNotRenderIfSamePage, isClientSideNavigation = true, pageContextInitClient, } = renderArgs;
     let { scrollTarget } = renderArgs;
     const { previousPageContext } = globalObject;
     addLinkPrefetchHandlers_unwatch();
@@ -45,6 +45,7 @@ async function renderPageClientSide(renderArgs) {
     const pageContextBeginArgs = {
         urlOriginal,
         isBackwardNavigation,
+        isHistoryNavigation,
         pageContextsFromRewrite,
         isClientSideNavigation,
         pageContextInitClient,
@@ -369,7 +370,6 @@ async function renderPageClientSide(renderArgs) {
                     scrollTarget: undefined,
                     urlOriginal: urlRedirect,
                     overwriteLastHistoryEntry: false,
-                    isBackwardNavigation: false,
                     redirectCount: redirectCount + 1,
                 });
             }
@@ -476,11 +476,12 @@ async function renderPageClientSide(renderArgs) {
         return pageContext;
     }
 }
-async function getPageContextBegin(isForErrorPage, { urlOriginal, isBackwardNavigation, pageContextsFromRewrite, isClientSideNavigation, pageContextInitClient, isFirstRender, }) {
+async function getPageContextBegin(isForErrorPage, { urlOriginal, isBackwardNavigation, isHistoryNavigation, pageContextsFromRewrite, isClientSideNavigation, pageContextInitClient, isFirstRender, }) {
     const previousPageContext = globalObject.previousPageContext ?? null;
     const pageContext = await createPageContextClientSide(urlOriginal);
     objectAssign(pageContext, {
         isBackwardNavigation,
+        isHistoryNavigation,
         isClientSideNavigation,
         isHydration: isFirstRender && !isForErrorPage,
         previousPageContext,
@@ -662,7 +663,6 @@ if (import.meta.env.DEV && import.meta.hot)
                 scrollTarget: { preserveScroll: false },
                 urlOriginal: getCurrentUrl(),
                 overwriteLastHistoryEntry: true,
-                isBackwardNavigation: false,
             });
         }
     });

package/dist/esm/client/runtime-server-routing/createPageContextClientSide.d.ts

@@ -57,6 +57,7 @@ declare function createPageContextClientSide(): Promise<{
     };
     _pageFilesAll: import("../../shared/getPageFiles.js").PageFile[];
     isBackwardNavigation: null;
+    isHistoryNavigation: null;
     _hasPageContextFromServer: true;
 } & {
     pageId: string;

package/dist/esm/client/runtime-server-routing/createPageContextClientSide.js

@@ -18,6 +18,7 @@ async function createPageContextClientSide() {
         _globalContext: globalContext,
         _pageFilesAll: globalContext._pageFilesAll, // TO-DO/next-major-release: remove
         isBackwardNavigation: null,
+        isHistoryNavigation: null,
         _hasPageContextFromServer: true,
     });
     objectAssign(pageContextCreated, getPageContextSerializedInHtml());

package/dist/esm/node/runtime/renderPage/html/serializeContext.js

@@ -10,6 +10,7 @@ import { NOT_SERIALIZABLE } from '../../../../shared/NOT_SERIALIZABLE.js';
 import { pageContextInitIsPassedToClient } from '../../../../shared/misc/pageContextInitIsPassedToClient.js';
 import { isServerSideError } from '../../../../shared/misc/isServerSideError.js';
 import { getPropKeys, getPropVal, setPropVal } from './propKeys.js';
+import { assertRouteParams } from '../../../../shared/route/resolveRouteFunction.js';
 const passToClientBuiltInPageContext = [
     'abortReason',
     '_urlRewrite',
@@ -123,6 +124,7 @@ function serializeValue(value, isHtmlJsonScript, varName) {
     });
 }
 function getPassToClientPageContext(pageContext) {
+    assertPageContext(pageContext);
     let passToClient = [...pageContext._passToClient, ...passToClientBuiltInPageContext];
     if (isErrorPage(pageContext.pageId, pageContext._globalContext._pageConfigs)) {
         assert(hasProp(pageContext, 'is404', 'boolean'));
@@ -182,3 +184,9 @@ function applyPassToClient(passToClient, obj) {
     });
     return { objClient, objClientProps };
 }
+// Ensure the following client-side assert() don't fail:
+// https://github.com/vikejs/vike/blob/a33b6e6319a9a0e34ea78e23c5aa156022e3745c/packages/vike/client/shared/getJsonSerializedInHtml.ts#L15-L16
+function assertPageContext(pageContext) {
+    assertUsage(hasProp(pageContext, 'pageId', 'string'), `${pc.bold('pageContext.pageId')} should be a ${pc.bold('string')}`);
+    assertRouteParams(pageContext, `${pc.bold('pageContext.routeParams')} should`);
+}

package/dist/esm/node/vite/plugins/build/handleAssetsManifest.js

@@ -221,9 +221,10 @@ function handleAssetsManifest_assertUsageCssCodeSplit(config) {
 }
 function handleAssetsManifest_alignCssTarget(config) {
     globalObject.configsAll.push(config);
-    const { cssTarget } = globalObject.configsAll
-        .filter((c) => !isViteServerSide_viteEnvOptional(c, undefined))
-        .at(-1).build;
+    const clientSideConfigs = globalObject.configsAll.filter((c) => !isViteServerSide_viteEnvOptional(c, undefined));
+    if (clientSideConfigs.length === 0)
+        return;
+    const { cssTarget } = clientSideConfigs.at(-1).build;
     assert(cssTarget);
     globalObject.configsAll.forEach((c) => (c.build.cssTarget = cssTarget));
 }

package/dist/esm/node/vite/plugins/build/pluginBuildApp.js

@@ -89,6 +89,7 @@ function pluginBuildApp() {
                 */
                 async handler(options, bundle) {
                     try {
+                        handleAssetsManifest_assertUsageCssTarget(config, this.environment);
                         await handleAssetsManifest(config, this.environment, options, bundle);
                         await triggerPrerendering(config, this.environment, bundle);
                     }
@@ -112,7 +113,6 @@ function pluginBuildApp() {
                 order: 'post',
                 handler() {
                     onSetupBuild();
-                    handleAssetsManifest_assertUsageCssTarget(config, this.environment);
                 },
             },
         },

package/dist/esm/node/vite/plugins/pluginViteConfigVikeExtensions.js

@@ -1,6 +1,6 @@
 export { pluginViteConfigVikeExtensions };
 import { mergeConfig } from 'vite';
-import { assertUsage, isObject } from '../utils.js';
+import { assertUsage, isCallable, isObject } from '../utils.js';
 import { getVikeConfigInternalEarly } from '../../api/resolveViteConfigFromUser.js';
 // Apply +vite
 // - For example, Vike extensions adding Vite plugins
@@ -12,10 +12,13 @@ async function pluginViteConfigVikeExtensions() {
     const viteConfigsExtensions = vikeConfig._from.configsCumulative.vite;
     if (!viteConfigsExtensions)
         return [];
-    viteConfigsExtensions.values.forEach((v) => {
-        assertUsage(isObject(v.value), `${v.definedAt} should be an object`);
-        viteConfigFromExtensions = mergeConfig(viteConfigFromExtensions, v.value);
-    });
+    await Promise.all(viteConfigsExtensions.values.map(async (v) => {
+        let val = v.value;
+        if (isCallable(val))
+            val = await val();
+        assertUsage(isObject(val), `${v.definedAt} should be an object, or a function returning an object`);
+        viteConfigFromExtensions = mergeConfig(viteConfigFromExtensions, val);
+    }));
     const pluginsFromExtensions = (viteConfigFromExtensions.plugins ?? []);
     delete viteConfigFromExtensions.plugins;
     return [

package/dist/esm/node/vite/shared/resolveVikeConfigInternal.d.ts

@@ -2,7 +2,6 @@ export { getVikeConfig };
 export type { VikeConfig };
 export { getVikeConfigInternal };
 export { getVikeConfigInternalOptional };
-export { getVikeConfigInternalSync };
 export { setVikeConfigContext };
 export { isVikeConfigContextSet };
 export { reloadVikeConfig };
@@ -38,13 +37,14 @@ type VikeConfigInternal = GlobalConfigPublic & {
 };
 declare function reloadVikeConfig(): void;
 declare function getVikeConfigInternal(doNotRestartViteOnError?: boolean): Promise<VikeConfigInternal>;
-declare function getVikeConfigInternalSync(): VikeConfigInternal;
 /**
  * Get all the information Vike knows about the app in your Vite plugin.
  *
  * https://vike.dev/getVikeConfig
  */
-declare function getVikeConfig(config: ResolvedConfig | UserConfig): VikeConfig;
+declare function getVikeConfig(
+/** @deprecated the `config` argument isn't needed anymore — remove it (it doesn't have any effect) */
+config?: ResolvedConfig | UserConfig): VikeConfig;
 type VikeConfig = Pick<VikeConfigInternal, 'config' | 'pages' | 'prerenderContext'> & {
     /** https://vike.dev/warning/internals */
     dangerouslyUseInternals: DangerouslyUseInternals<VikeConfigInternal>;

package/dist/esm/node/vite/shared/resolveVikeConfigInternal.js

@@ -3,7 +3,6 @@ export { getVikeConfig };
 // Internal usage
 export { getVikeConfigInternal };
 export { getVikeConfigInternalOptional };
-export { getVikeConfigInternalSync };
 export { setVikeConfigContext };
 export { isVikeConfigContextSet };
 export { reloadVikeConfig };
@@ -58,11 +57,6 @@ doNotRestartViteOnError = false) {
     const vikeConfig = await getOrResolveVikeConfig(userRootDir, isDev, vikeVitePluginOptions, doNotRestartViteOnError);
     return vikeConfig;
 }
-// TO-DO/next-major-release: remove
-function getVikeConfigInternalSync() {
-    assert(globalObject.vikeConfigSync);
-    return globalObject.vikeConfigSync;
-}
 // TO-DO/eventually: this maybe(/probably?) isn't safe against race conditions upon file changes in development, thus:
 // - Like getGlobalContext() and getGlobalContextSync() — make getVikeConfig() async and provide a getVikeConfigSync() while discourage using it
 // Public usage
@@ -72,10 +66,17 @@ function getVikeConfigInternalSync() {
  * https://vike.dev/getVikeConfig
  */
 function getVikeConfig(
-// TO-DO/eventually: remove unused arguments (older versions used it and we didn't remove it yet to avoid a TypeScript breaking change)
-// - No rush: we can do it later since it's getVikeConfig() is a beta feature as documented at https://vike.dev/getVikeConfig
+/** @deprecated the `config` argument isn't needed anymore — remove it (it doesn't have any effect) */
 config) {
-    const vikeConfig = getVikeConfigInternalSync();
+    /* TO-DO/eventualy: add deprecation warning. We don't do it yet because of vike-server and vike-cloudflare which are using getVikeConfig() with the argument.
+    assertWarning(
+      config === undefined,
+      `getVikeConfig() doesn't accept any argument anymore — remove the argument (it doesn't have any effect)`,
+      { onlyOnce: true, showStackTrace: true },
+    )
+    */
+    assert(globalObject.vikeConfigSync);
+    const vikeConfig = globalObject.vikeConfigSync;
     assertUsage(vikeConfig, 'getVikeConfig() can only be used when Vite is loaded (i.e. during development or build) — Vite is never loaded in production.');
     const vikeConfigPublic = getProxyForPublicUsage(vikeConfig, 'vikeConfig');
     return vikeConfigPublic;

package/dist/esm/shared/route/resolveRouteFunction.d.ts

@@ -9,6 +9,6 @@ declare function resolveRouteFunction(routeFunction: (arg: unknown) => unknown,
 }>;
 declare function assertSyncRouting(res: unknown, errPrefix: string): void;
 declare function warnDeprecatedAllowKey(): void;
-declare function assertRouteParams<T>(result: T, errPrefix: string): asserts result is T & {
+declare function assertRouteParams<T>(result: T, errPrefix: `${string} should`): asserts result is T & {
     routeParams?: Record<string, string>;
 };

package/dist/esm/shared/route/resolveRouteFunction.js

@@ -63,6 +63,5 @@ function assertRouteParams(result, errPrefix) {
     if (!hasProp(result, 'routeParams')) {
         return;
     }
-    assert(errPrefix.endsWith(' should'));
-    assertUsage(hasProp(result, 'routeParams', 'string{}'), `${errPrefix} be an object holding string values.`);
+    assertUsage(hasProp(result, 'routeParams', 'string{}'), `${errPrefix} be ${pc.bold('Record<string, string>')}`);
 }

package/dist/esm/types/Config.d.ts

@@ -55,37 +55,64 @@ type HookNameOldDesign = 'render' | 'prerender' | 'onBeforePrerender';
 type ConfigNameBuiltIn = Exclude<keyof ConfigBuiltIn, keyof VikeVitePluginOptions | 'onBeforeRoute' | 'onPrerenderStart' | 'vite' | 'redirects'> | 'prerender' | 'hasServerOnlyHook' | 'isClientRuntimeLoaded' | 'onBeforeRenderEnv' | 'dataEnv' | 'hooksTimeout' | 'clientHooks' | 'middleware';
 type ConfigNameGlobal = 'onPrerenderStart' | 'onBeforeRoute' | 'prerender' | 'disableAutoFullBuild' | 'includeAssetsImportedByServer' | 'baseAssets' | 'baseServer' | 'redirects' | 'trailingSlash' | 'disableUrlNormalization' | 'vite';
 type Config = ConfigBuiltIn & Vike.Config;
-/** @deprecated This type is deprecated, see https://vike.dev/data */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/data
+ */
 type DataAsync<Data = unknown> = (pageContext: PageContextServer) => Promise<Data>;
-/** @deprecated This type is deprecated, see https://vike.dev/data */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/data
+ */
 type DataSync<Data = unknown> = (pageContext: PageContextServer) => Data;
-/** @deprecated This type is deprecated, see https://vike.dev/guard */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/guard
+ */
 type GuardAsync = (pageContext: PageContextServer) => Promise<void>;
-/** @deprecated This type is deprecated, see https://vike.dev/guard */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/guard
+ */
 type GuardSync = (pageContext: PageContextServer) => void;
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforePrerenderStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforePrerenderStart
+ */
 type OnBeforePrerenderStartAsync<Data = unknown> = () => Promise<(string | {
     url: string;
     pageContext: Partial<Vike.PageContext & {
         data: Data;
     }>;
 })[]>;
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforePrerenderStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforePrerenderStart
+ */
 type OnBeforePrerenderStartSync<Data = unknown> = () => (string | {
     url: string;
     pageContext: Partial<Vike.PageContext & {
         data: Data;
     }>;
 })[];
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRender */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforeRender
+ */
 type OnBeforeRenderAsync = (pageContext: PageContextServer) => Promise<{
     pageContext: Partial<Vike.PageContext>;
 } | void>;
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRender */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforeRender
+ */
 type OnBeforeRenderSync = (pageContext: PageContextServer) => {
     pageContext: Partial<Vike.PageContext>;
 } | void;
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRoute */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforeRoute
+ */
 type OnBeforeRouteAsync = (pageContext: PageContextServer) => Promise<{
     pageContext: Partial<{
         /** The URL you provided to Vike when calling `renderPage({ urlOriginal })` in your server middleware.
@@ -95,7 +122,10 @@ type OnBeforeRouteAsync = (pageContext: PageContextServer) => Promise<{
         urlOriginal: string;
     } | Vike.PageContext>;
 }>;
-/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRoute */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onBeforeRoute
+ */
 type OnBeforeRouteSync = (pageContext: PageContextServer) => {
     pageContext: Partial<{
         /** The URL you provided to Vike when calling `renderPage({ urlOriginal })` in your server middleware.
@@ -105,19 +135,40 @@ type OnBeforeRouteSync = (pageContext: PageContextServer) => {
         urlOriginal: string;
     } | Vike.PageContext>;
 };
-/** @deprecated This type is deprecated, see https://vike.dev/onHydrationEnd */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onHydrationEnd
+ */
 type OnHydrationEndAsync = (pageContext: PageContextClient) => Promise<void>;
-/** @deprecated This type is deprecated, see https://vike.dev/onHydrationEnd */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onHydrationEnd
+ */
 type OnHydrationEndSync = (pageContext: PageContextClient) => void;
-/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionEnd */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPageTransitionEnd
+ */
 type OnPageTransitionEndAsync = (pageContext: PageContextClient) => Promise<void>;
-/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionEnd */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPageTransitionEnd
+ */
 type OnPageTransitionEndSync = (pageContext: PageContextClient) => void;
-/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPageTransitionStart
+ */
 type OnPageTransitionStartAsync = (pageContext: PageContextClient) => Promise<void>;
-/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPageTransitionStart
+ */
 type OnPageTransitionStartSync = (pageContext: PageContextClient) => void;
-/** @deprecated This type is deprecated, see https://vike.dev/onPrerenderStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPrerenderStart
+ */
 type OnPrerenderStartAsync = (prerenderContext: {
     pageContexts: PageContextServer[];
 }) => Promise<{
@@ -125,7 +176,10 @@ type OnPrerenderStartAsync = (prerenderContext: {
         pageContexts: PageContextServer[];
     };
 }>;
-/** @deprecated This type is deprecated, see https://vike.dev/onPrerenderStart */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onPrerenderStart
+ */
 type OnPrerenderStartSync = (prerenderContext: {
     pageContexts: PageContextServer[];
 }) => {
@@ -133,13 +187,25 @@ type OnPrerenderStartSync = (prerenderContext: {
         pageContexts: PageContextServer[];
     };
 };
-/** @deprecated This type is deprecated, see https://vike.dev/onRenderClient */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onRenderClient
+ */
 type OnRenderClientAsync = (pageContext: PageContextClient) => Promise<void>;
-/** @deprecated This type is deprecated, see https://vike.dev/onRenderClient */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onRenderClient
+ */
 type OnRenderClientSync = (pageContext: PageContextClient) => void;
-/** @deprecated This type is deprecated, see https://vike.dev/onRenderHtml */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onRenderHtml
+ */
 type OnRenderHtmlAsync = (pageContext: PageContextServer) => Promise<OnRenderHtmlReturn>;
-/** @deprecated This type is deprecated, see https://vike.dev/onRenderHtml */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/onRenderHtml
+ */
 type OnRenderHtmlSync = (pageContext: PageContextServer) => OnRenderHtmlReturn;
 type OnRenderHtmlReturn = DocumentHtml | {
     injectFilter?: (assets: InjectFilterEntry[]) => void;
@@ -155,7 +221,10 @@ type RouteAsync = (pageContext: PageContextServer | PageContextClient) => Promis
     routeParams?: Record<string, string>;
     precedence?: number;
 } | boolean>;
-/** @deprecated This type is deprecated, see https://vike.dev/route */
+/** @deprecated This type is deprecated, see:
+ * - https://vike.dev/migration/hook-types
+ * - https://vike.dev/route
+ */
 type RouteSync = (pageContext: PageContextServer | PageContextClient) => {
     routeParams?: Record<string, string>;
     precedence?: number;
@@ -386,7 +455,7 @@ type ConfigBuiltIn = {
      *
      * https://vite.dev/config/
      */
-    vite?: InlineConfig;
+    vite?: InlineConfig | (() => InlineConfig | Promise<InlineConfig>);
     /** Permanent redirections (HTTP status code 301)
      *
      * https://vike.dev/redirects

package/dist/esm/types/PageContext.d.ts

@@ -170,19 +170,28 @@ type PageContextBuiltInServer<Data> = PageContextBuiltInCommon<Data> & PageConte
     cspNonce: string | null;
     isHydration?: undefined;
     isBackwardNavigation?: undefined;
+    isHistoryNavigation?: undefined;
     previousPageContext?: undefined;
 };
 type PageContextBuiltInClientWithClientRouting<Data> = Partial<PageContextBuiltInCommon<Data>> & Pick<PageContextBuiltInCommon<Data>, 'Page' | 'routeParams' | 'pageExports' | 'config' | 'configEntries' | 'exports' | 'exportsAll' | 'abortReason' | 'data' | 'pageId' | 'source' | 'sources' | 'from'> & PageContextClientCommon & {
     /** Whether the current page is already rendered to HTML */
     isHydration: boolean;
     /**
-     * Whether the user is navigating back in history.
+     * Whether the user is navigating backward in history.
      *
      * The value is `true` when the user clicks on his browser's backward navigation button, or when invoking `history.back()`.
      *
      * https://vike.dev/pageContext#isBackwardNavigation
      */
     isBackwardNavigation: boolean | null;
+    /**
+     * Whether the user is navigating back or forward in history.
+     *
+     * The value is `true` when the user clicks on his browser's backward/forward button, or when invoking `history.back()` or `history.forward()`.
+     *
+     * https://vike.dev/pageContext#isHistoryNavigation
+     */
+    isHistoryNavigation: boolean;
     /**
      * Upon client-side page navigation, you can use `pageContext.previousPageContext` to access the `pageContext` of the previous page.
      *
@@ -208,6 +217,14 @@ type PageContextBuiltInClientWithServerRouting<Data> = Partial<PageContextBuiltI
      * https://vike.dev/pageContext#isBackwardNavigation
      */
     isBackwardNavigation: null;
+    /**
+     * Whether the user is navigating back or forward in history.
+     *
+     * The `isHistoryNavigation` property only works with Client Routing. (The value is always `null` when using Server Routing.)
+     *
+     * https://vike.dev/pageContext#isHistoryNavigation
+     */
+    isHistoryNavigation: null;
     globalContext: GlobalContextClientWithServerRouting;
 };
 type PageContextClientCommon = {

package/dist/esm/utils/PROJECT_VERSION.d.ts

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.244";
+export declare const PROJECT_VERSION: "0.4.245-commit-189d2b8";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.244';
+export const PROJECT_VERSION = '0.4.245-commit-189d2b8';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.244",
+  "version": "0.4.245-commit-189d2b8",
   "repository": "https://github.com/vikejs/vike",
   "exports": {
     "./server": {
@@ -115,7 +115,7 @@
   "dependencies": {
     "@brillout/import": "^0.2.6",
     "@brillout/json-serializer": "^0.5.21",
-    "@brillout/picocolors": "^1.0.26",
+    "@brillout/picocolors": "^1.0.29",
     "@brillout/require-shim": "^0.1.2",
     "@brillout/vite-plugin-server-entry": "^0.7.15",
     "acorn": "^8.0.0",

package/dist/esm/client/runtime-client-routing/skipLink.d.ts

@@ -1,6 +0,0 @@
-export { skipLink };
-export { isLinkIgnored };
-export { isSameAsCurrentUrl };
-declare function skipLink(linkTag: HTMLElement): boolean;
-declare function isLinkIgnored(linkTag: HTMLElement): boolean;
-declare function isSameAsCurrentUrl(href: string): boolean;