vike 0.4.245 → 0.4.246-commit-194db5c

package/dist/esm/__internal/index.js

@@ -4,14 +4,14 @@ export { setGlobalContext_prodBuildEntry } from '../node/runtime/globalContext.j
 export { route, getPagesAndRoutes };
 import { route as routeInternal } from '../shared/route/index.js';
 import { getGlobalContextServerInternal, initGlobalContext_getPagesAndRoutes } from '../node/runtime/globalContext.js';
-import { setNodeEnvProduction } from '../utils/assertSetup.js';
+import { setNodeEnvProductionIfUndefined } from '../utils/assertSetup.js';
 /**
  * Used by {@link https://github.com/magne4000/vite-plugin-vercel|vite-plugin-vercel} to compute some rewrite rules and extract { isr } configs.
  *
  * TO-DO/eventually: remove
  */
 async function getPagesAndRoutes() {
-    setNodeEnvProduction();
+    setNodeEnvProductionIfUndefined();
     await initGlobalContext_getPagesAndRoutes();
     const { globalContext } = await getGlobalContextServerInternal();
     const { 

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

@@ -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

@@ -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/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/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/globalContext.js

@@ -29,7 +29,7 @@ export { vikeConfigErrorRecoverMsg };
 //   - Without vike-server it's manually loaded here using importServerProductionEntry() which uses @brillout/vite-plugin-server-entry's autoImporter or crawler
 // - In development: globalObject.viteDevServer which is Vite's development server
 //   - globalObject.viteDevServer is used by updateUserFiles() which then sets virtualFileExportsGlobalEntry
-import { assert, onSetupRuntime, assertUsage, assertWarning, isPlainObject, objectReplace, isObject, hasProp, getGlobalObject, genPromise, createDebugger, checkType, PROJECT_VERSION, getViteRPC, isRunnableDevEnvironment, assertIsNotBrowser, isNonRunnableDev, objectAssign, } from './utils.js';
+import { assert, onSetupRuntime, assertUsage, assertWarning, isPlainObject, objectReplace, isObject, hasProp, getGlobalObject, genPromise, createDebugger, checkType, PROJECT_VERSION, getViteRPC, isRunnableDevEnvironment, assertIsNotBrowser, isNonRunnableDev, objectAssign, setNodeEnvProductionIfUndefined, } from './utils.js';
 import { importServerProductionEntry } from '@brillout/vite-plugin-server-entry/runtime';
 import { virtualFileIdGlobalEntryServer } from '../shared/virtualFileId.js';
 import pc from '@brillout/picocolors';
@@ -270,6 +270,7 @@ async function setGlobalContext_prodBuildEntry(prodBuildEntry) {
     debug('setGlobalContext_prodBuildEntry()');
     assert(!isNonRunnableDev());
     assertProdBuildEntry(prodBuildEntry);
+    setNodeEnvProductionIfUndefined();
     globalObject.prodBuildEntry = prodBuildEntry;
     globalObject.prodBuildEntryPrevious = prodBuildEntry;
     assert(globalObject.prodBuildEntry); // ensure no infinite loop

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/pluginDev/determineOptimizeDeps.js

@@ -17,6 +17,8 @@ async function determineOptimizeDeps(config) {
     // - The issue was closed as completed with https://github.com/vitejs/vite/pull/20495 but it doesn't fix the issue and the workaround is still needed.
     // - TO-DO/eventually: try removing the workaround and see if the CI fails (at test/@cloudflare_vite-plugin/) — maybe the issue will get fixed at some point.
     includeServer.push('react/jsx-dev-runtime');
+    includeClient.push('@compiled/react/runtime');
+    includeServer.push('@compiled/react/runtime');
     for (const envName in config.environments) {
         const env = config.environments[envName];
         if (env.consumer === 'server' && env.optimizeDeps.noDiscovery === false) {

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

@@ -263,8 +263,7 @@ function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRo
             return;
         pageConfigGlobal.configValueSources[configName] = sources;
     });
-    applyEffectsMetaEnv(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal);
-    applyEffectsConfVal(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal, plusFilesAll);
+    applyEffects(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal, plusFilesAll);
     sortConfigValueSources(pageConfigGlobal.configValueSources, null);
     assertPageConfigGlobal(pageConfigGlobal, plusFilesAll);
     const pageConfigs = objectEntries(configDefinitionsResolved.configDefinitionsLocal)
@@ -281,8 +280,7 @@ function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRo
             configValueSources[configName] = sources;
         });
         const pageConfigRoute = determineRouteFilesystem(locationId, configValueSources);
-        applyEffectsMetaEnv(configValueSources, configDefinitionsLocal);
-        applyEffectsConfVal(configValueSources, configDefinitionsLocal, plusFilesAll);
+        applyEffects(configValueSources, configDefinitionsLocal, plusFilesAll);
         sortConfigValueSources(configValueSources, locationId);
         const pageConfig = {
             pageId: locationId,
@@ -801,8 +799,8 @@ function assertMetaUsage(metaVal, metaConfigDefinedAt) {
         }
     });
 }
-// Test: https://github.com/vikejs/vike/blob/441a37c4c1a3b07bb8f6efb1d1f7be297a53974a/test/playground/vite.config.ts#L39
-function applyEffectsConfVal(configValueSources, configDefinitions, plusFilesAll) {
+// Test: https://github.com/vikejs/vike/blob/871a111a77d637bbd156b07be5ae728c3d595501/test/playground/pages/config-meta/effect/e2e-test.ts
+function applyEffects(configValueSources, configDefinitions, plusFilesAll) {
     objectEntries(configDefinitions).forEach(([configNameEffect, configDefEffect]) => {
         const sourceEffect = configValueSources[configNameEffect]?.[0];
         if (!sourceEffect)
@@ -811,19 +809,8 @@ function applyEffectsConfVal(configValueSources, configDefinitions, plusFilesAll
         if (!effect)
             return;
         const configModFromEffect = effect;
+        // Apply config value changes first to create sources, then meta.env changes to modify their env
         applyEffectConfVal(configModFromEffect, sourceEffect, configValueSources, configNameEffect, configDefEffect, configDefinitions, plusFilesAll);
-    });
-}
-// Test: https://github.com/vikejs/vike/blob/441a37c4c1a3b07bb8f6efb1d1f7be297a53974a/test/playground/pages/config-meta/effect/e2e-test.ts#L16
-function applyEffectsMetaEnv(configValueSources, configDefinitions) {
-    objectEntries(configDefinitions).forEach(([configNameEffect, configDefEffect]) => {
-        const sourceEffect = configValueSources[configNameEffect]?.[0];
-        if (!sourceEffect)
-            return;
-        const effect = runEffect(configNameEffect, configDefEffect, sourceEffect);
-        if (!effect)
-            return;
-        const configModFromEffect = effect;
         applyEffectMetaEnv(configModFromEffect, configValueSources, configDefEffect);
     });
 }

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/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.245";
+export declare const PROJECT_VERSION: "0.4.246-commit-194db5c";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.245';
+export const PROJECT_VERSION = '0.4.246-commit-194db5c';

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

@@ -3,7 +3,7 @@ export { onSetupRuntime };
 export { onSetupBuild };
 export { onSetupPrerender };
 export { onSetupPreview };
-export { setNodeEnvProduction };
+export { setNodeEnvProductionIfUndefined };
 export { markSetup_viteDevServer };
 export { markSetup_vitePreviewServer };
 export { markSetup_vikeVitePlugin };
@@ -17,4 +17,4 @@ declare function markSetup_viteDevServer(): void | undefined;
 declare function markSetup_vitePreviewServer(): void | undefined;
 declare function markSetup_vikeVitePlugin(): void;
 declare function markSetup_isViteDev(isViteDev: boolean): void;
-declare function setNodeEnvProduction(): void | undefined;
+declare function setNodeEnvProductionIfUndefined(): void | undefined;

package/dist/esm/utils/assertSetup.js

@@ -3,7 +3,7 @@ export { onSetupRuntime };
 export { onSetupBuild };
 export { onSetupPrerender };
 export { onSetupPreview };
-export { setNodeEnvProduction };
+export { setNodeEnvProductionIfUndefined };
 export { markSetup_viteDevServer };
 export { markSetup_vitePreviewServer };
 export { markSetup_vikeVitePlugin };
@@ -55,7 +55,7 @@ function onSetupRuntime() {
 function onSetupBuild() {
     assertUsageNodeEnvIsNotDev('building');
     /* Not needed: Vite already sets `process.env.NODE_ENV = 'production'`
-    setNodeEnvProduction()
+    setNodeEnvProductionIfUndefined()
     */
 }
 // Called by ../node/prerender/runPrerender.ts
@@ -63,7 +63,7 @@ function onSetupPrerender() {
     markSetup_isPrerendering();
     if (getNodeEnv())
         assertUsageNodeEnvIsNotDev('pre-rendering');
-    setNodeEnvProduction();
+    setNodeEnvProductionIfUndefined();
 }
 // Called by ../node/api/preview.ts
 function onSetupPreview() {
@@ -157,10 +157,20 @@ function getNodeEnv() {
     //*/
     return val;
 }
-function setNodeEnvProduction() {
+function setNodeEnvProductionIfUndefined() {
     // The statement `process.env['NODE_ENV'] = 'production'` chokes webpack v4
-    const proc = process;
+    let val;
+    let proc;
+    try {
+        proc = process;
+        val = process.env.NODE_ENV;
+    }
+    catch {
+        return;
+    }
+    if (val !== undefined)
+        return;
     const { env } = proc;
-    env.NODE_ENV = 'production';
+    env.NODE_ENV ?? (env.NODE_ENV = 'production');
     assert(isNodeEnv('production'));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.245",
+  "version": "0.4.246-commit-194db5c",
   "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",
@@ -245,7 +245,7 @@
     "@types/picomatch": "^3.0.2",
     "@types/semver": "^7.5.8",
     "@types/source-map-support": "^0.5.10",
-    "react-streaming": "^0.4.10",
+    "react-streaming": "^0.4.12",
     "rimraf": "^5.0.5",
     "typescript": "^5.9.2",
     "vite": "^7.1.5"