vike 0.4.231-commit-e1c3295 → 0.4.232-commit-134207d

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

@@ -8,33 +8,33 @@ export { isV1Design };
 export { getConfVal };
 export { getConfigDefinitionOptional };
 export { getVikeConfigFromCliOrEnv };
-export { isOverriden };
+export { isOverridden };
 // Public usage
 export { getVikeConfig };
-import { assertPosixPath, assert, isObject, assertUsage, assertWarning, objectEntries, hasProp, includes, assertIsNotProductionRuntime, getMostSimilar, joinEnglish, assertKeys, objectKeys, objectFromEntries, unique, isCallable, makeFirst, lowerFirst, makeLast, assertIsSingleModuleInstance, genPromise } from '../utils.js';
-import { configDefinitionsBuiltIn } from './resolveVikeConfigInternal/configDefinitionsBuiltIn.js';
-import { getLocationId, getFilesystemRouteString, getFilesystemRouteDefinedBy, isInherited, sortAfterInheritanceOrder, applyFilesystemRoutingRootEffect } from './resolveVikeConfigInternal/filesystemRouting.js';
+import { assertPosixPath, assert, isObject, assertUsage, assertWarning, objectEntries, hasProp, includes, assertIsNotProductionRuntime, getMostSimilar, joinEnglish, assertKeys, objectKeys, objectFromEntries, unique, isCallable, makeFirst, lowerFirst, makeLast, assertIsSingleModuleInstance, genPromise, } from '../utils.js';
+import { configDefinitionsBuiltIn, } from './resolveVikeConfigInternal/configDefinitionsBuiltIn.js';
+import { getLocationId, getFilesystemRouteString, getFilesystemRouteDefinedBy, isInherited, sortAfterInheritanceOrder, applyFilesystemRoutingRootEffect, } from './resolveVikeConfigInternal/filesystemRouting.js';
 import { getViteDevServer } from '../../runtime/globalContext.js';
 import { logConfigError, logConfigErrorRecover } from './loggerNotProd.js';
-import { removeSuperfluousViteLog_enable, removeSuperfluousViteLog_disable } from './loggerVite/removeSuperfluousViteLog.js';
+import { removeSuperfluousViteLog_enable, removeSuperfluousViteLog_disable, } from './loggerVite/removeSuperfluousViteLog.js';
 import pc from '@brillout/picocolors';
 import { getConfigDefinedAt, getDefinedByString } from '../../../shared/page-configs/getConfigDefinedAt.js';
 import { loadPointerImport, loadValueFile } from './resolveVikeConfigInternal/loadFileAtConfigTime.js';
 import { resolvePointerImport } from './resolveVikeConfigInternal/resolvePointerImport.js';
 import { getFilePathResolved } from './getFilePath.js';
 import { getConfigValueBuildTime } from '../../../shared/page-configs/getConfigValueBuildTime.js';
-import { resolveVikeConfigPublicGlobal, resolveVikeConfigPublicPageEager } from '../../../shared/page-configs/resolveVikeConfigPublic.js';
+import { resolveVikeConfigPublicGlobal, resolveVikeConfigPublicPageEager, } from '../../../shared/page-configs/resolveVikeConfigPublic.js';
 import { getConfigValuesBase, isJsonValue } from '../../../shared/page-configs/serialize/serializeConfigValues.js';
-import { getPlusFilesAll } from './resolveVikeConfigInternal/getPlusFilesAll.js';
+import { getPlusFilesAll, } from './resolveVikeConfigInternal/getPlusFilesAll.js';
 import { getEnvVarObject } from './getEnvVarObject.js';
 import { getApiOperation } from '../../api/context.js';
 import { getCliOptions } from '../../cli/context.js';
 import { resolvePrerenderConfigGlobal } from '../../prerender/resolvePrerenderConfig.js';
 import { getProxyForPublicUsage } from '../../../shared/getProxyForPublicUsage.js';
-import { renderPage_vikeConfigHasError } from '../../runtime/renderPage.js';
+import { setVikeConfigError } from '../../shared/getVikeConfigError.js';
 assertIsNotProductionRuntime();
 // We can simply use global variables since Vike's config is:
-//  - gobal
+//  - global
 //  - independent of Vite (therefore we don't need to tie Vike's config with Vite's `config` object)
 assertIsSingleModuleInstance('v1-design/getVikeConfig.ts');
 let restartVite = false;
@@ -109,7 +109,7 @@ async function resolveVikeConfigInternal_withErrorHandling(userRootDir, isDev, v
     vikeConfigPromise = promise;
     const esbuildCache = {
         transpileCache: {},
-        vikeConfigDependencies: new Set()
+        vikeConfigDependencies: new Set(),
     };
     let hasError = false;
     let ret;
@@ -138,7 +138,7 @@ async function resolveVikeConfigInternal_withErrorHandling(userRootDir, isDev, v
         assert(err === undefined);
         const hadError = vikeConfigHasBuildError;
         vikeConfigHasBuildError = false;
-        renderPage_vikeConfigHasError({ hasBuildError: false });
+        setVikeConfigError({ errorBuild: false });
         if (hadError) {
             logConfigErrorRecover();
             if (restartVite) {
@@ -152,7 +152,7 @@ async function resolveVikeConfigInternal_withErrorHandling(userRootDir, isDev, v
         assert(ret === undefined);
         assert(err);
         vikeConfigHasBuildError = true;
-        renderPage_vikeConfigHasError({ hasBuildError: { err } });
+        setVikeConfigError({ errorBuild: { err } });
         if (!doNotRestartViteOnError)
             restartVite = true;
         if (!isDev) {
@@ -184,7 +184,7 @@ async function resolveVikeConfigInternal(userRootDir, vikeVitePluginOptions, esb
     const prerenderContext = resolvePrerenderContext({
         config: vikeConfigPublicGlobal.config,
         _from: vikeConfigPublicGlobal._from,
-        _pageConfigs: pageConfigs
+        _pageConfigs: pageConfigs,
     });
     const vikeConfig = {
         _pageConfigs: pageConfigs,
@@ -193,7 +193,7 @@ async function resolveVikeConfigInternal(userRootDir, vikeVitePluginOptions, esb
         _from: vikeConfigPublicGlobal._from,
         pages: vikeConfigPublicPagesEager,
         prerenderContext,
-        _vikeConfigDependencies: esbuildCache.vikeConfigDependencies
+        _vikeConfigDependencies: esbuildCache.vikeConfigDependencies,
     };
     vikeConfigSync = vikeConfig;
     return vikeConfig;
@@ -225,7 +225,7 @@ async function resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache)
             configDefinitions,
             plusFiles,
             plusFilesRelevant,
-            configNamesKnownLocal
+            configNamesKnownLocal,
         };
     }));
     const configDefinitionsResolved = {
@@ -233,7 +233,7 @@ async function resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache)
         configDefinitionsLocal,
         configDefinitionsAll,
         configNamesKnownAll,
-        configNamesKnownGlobal
+        configNamesKnownGlobal,
     };
     assertKnownConfigs(configDefinitionsResolved);
     return configDefinitionsResolved;
@@ -256,7 +256,7 @@ async function loadCustomConfigBuildTimeFiles(plusFiles, configDefinitions, user
 function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRootDir) {
     const pageConfigGlobal = {
         configDefinitions: configDefinitionsResolved.configDefinitionsGlobal,
-        configValueSources: {}
+        configValueSources: {},
     };
     objectEntries(configDefinitionsResolved.configDefinitionsGlobal).forEach(([configName, configDef]) => {
         const sources = resolveConfigValueSources(configName, configDef, 
@@ -294,7 +294,7 @@ function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRo
             configDefinitions: configDefinitionsLocal,
             plusFiles: plusFilesRelevant,
             configValueSources,
-            configValuesComputed
+            configValuesComputed,
         };
         return pageConfig;
     });
@@ -324,7 +324,7 @@ function assertGlobalConfigLocation(configName, sources, plusFilesAll, configDef
         // It's `null` when the config is defined by `vike(options)` in vite.config.js
         assert(plusFile);
         const { filePathAbsoluteUserRootDir } = plusFile.filePath;
-        // Allow local Vike extensions to set gloabl configs (`filePathAbsoluteUserRootDir===null` for Vike extension)
+        // Allow local Vike extensions to set global configs (`filePathAbsoluteUserRootDir===null` for Vike extension)
         if (!filePathAbsoluteUserRootDir)
             return;
         assert(!plusFile.isExtensionConfig);
@@ -410,9 +410,9 @@ function temp_interopVikeVitePlugin(pageConfigGlobal, vikeVitePluginOptions, use
         sources.push(getSourceNonConfigFile(configName, value, {
             ...getFilePathResolved({
                 userRootDir,
-                filePathAbsoluteUserRootDir: '/vite.config.js'
+                filePathAbsoluteUserRootDir: '/vite.config.js',
             }),
-            fileExportPathToShowToUser: null
+            fileExportPathToShowToUser: null,
         }));
     });
 }
@@ -447,12 +447,12 @@ function getVikeConfigFromCliOrEnv() {
     const configFromEnvVar = getEnvVarObject('VIKE_CONFIG');
     const vikeConfigFromCliOrEnv = {
         ...configFromCliOptions, // Lower precedence
-        ...configFromEnvVar // Higher precedence
+        ...configFromEnvVar, // Higher precedence
     };
     return {
         vikeConfigFromCliOrEnv,
         configFromCliOptions,
-        configFromEnvVar
+        configFromEnvVar,
     };
 }
 function getSourceNonConfigFile(configName, value, definedAt) {
@@ -466,7 +466,7 @@ function getSourceNonConfigFile(configName, value, definedAt) {
         locationId: '/',
         plusFile: null,
         valueIsLoadedWithImport: false,
-        valueIsDefinedByPlusValueFile: false
+        valueIsDefinedByPlusValueFile: false,
     };
     return source;
 }
@@ -553,7 +553,7 @@ function sortPlusFilesSameLocationId(plusFile1, plusFile2, configName) {
             return ret;
     }
     // Config set by +{configName}.js (highest precedence)
-    // No need to make it deterministic: the overall order is arleady deterministic, see sortMakeDeterministic() at getPlusFilesAll()
+    // No need to make it deterministic: the overall order is already deterministic, see sortMakeDeterministic() at getPlusFilesAll()
     return 0;
 }
 function resolveConfigValueSources(configName, configDef, plusFilesRelevant, userRootDir, isGlobal, plusFilesAll) {
@@ -585,11 +585,11 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
     assert(confVal);
     const configValueSourceCommon = {
         locationId: plusFile.locationId,
-        plusFile
+        plusFile,
     };
     const definedAtFilePath_ = {
         ...plusFile.filePath,
-        fileExportPathToShowToUser: ['default', configName]
+        fileExportPathToShowToUser: ['default', configName],
     };
     // +client.js
     if (configDef._valueIsFilePath) {
@@ -610,7 +610,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             valueFilePath = plusFile.filePath.filePathAbsoluteVite;
             definedAtFilePath = {
                 ...plusFile.filePath,
-                fileExportPathToShowToUser: []
+                fileExportPathToShowToUser: [],
             };
         }
         const configValueSource = {
@@ -621,7 +621,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             configEnv: configDef.env,
             valueIsLoadedWithImport: false,
             valueIsDefinedByPlusValueFile: false,
-            definedAt: definedAtFilePath
+            definedAt: definedAtFilePath,
         };
         return configValueSource;
     }
@@ -634,10 +634,10 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             const value = pointerImport.fileExportValueLoaded
                 ? {
                     valueIsLoaded: true,
-                    value: pointerImport.fileExportValue
+                    value: pointerImport.fileExportValue,
                 }
                 : {
-                    valueIsLoaded: false
+                    valueIsLoaded: false,
                 };
             const configValueSource = {
                 ...configValueSourceCommon,
@@ -645,7 +645,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
                 configEnv: resolveConfigEnv(configDef.env, pointerImport.fileExportPath),
                 valueIsLoadedWithImport: true,
                 valueIsDefinedByPlusValueFile: false,
-                definedAt: pointerImport.fileExportPath
+                definedAt: pointerImport.fileExportPath,
             };
             return configValueSource;
         }
@@ -657,7 +657,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             configEnv: configDef.env,
             valueIsLoadedWithImport: false,
             valueIsDefinedByPlusValueFile: false,
-            definedAt: definedAtFilePath_
+            definedAt: definedAtFilePath_,
         };
         return configValueSource;
     }
@@ -676,8 +676,8 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
                 fileExportPathToShowToUser: configName === plusFile.configName
                     ? []
                     : // Side-effect config (e.g. `export { frontmatter }` of .md files)
-                        [configName]
-            }
+                        [configName],
+            },
         };
         return configValueSource;
     }
@@ -700,7 +700,7 @@ function resolveIsGlobalValue(configDefGlobal, source, plusFilesAll) {
     let isGlobal;
     if (isCallable(configDefGlobal))
         isGlobal = configDefGlobal(source.value, {
-            isGlobalLocation: isGlobalLocation(source.locationId, plusFilesAll)
+            isGlobalLocation: isGlobalLocation(source.locationId, plusFilesAll),
         });
     else
         isGlobal = configDefGlobal ?? false;
@@ -737,20 +737,20 @@ function getConfigDefinitions(plusFilesRelevant, filter) {
             assert(plusFile.isConfigFile);
             configDef._userEffectDefinedAtFilePath = {
                 ...plusFile.filePath,
-                fileExportPathToShowToUser: ['default', 'meta', configName, 'effect']
+                fileExportPathToShowToUser: ['default', 'meta', configName, 'effect'],
             };
         });
         objectEntries(meta).forEach(([configName, configDefinitionUserLand]) => {
             if ('isDefinedByPeerDependency' in configDefinitionUserLand) {
                 configDefinitionUserLand = {
                     env: { client: false, server: false, config: false },
-                    ...configDefinitionUserLand
+                    ...configDefinitionUserLand,
                 };
             }
             // User can override an existing config definition
             configDefinitions[configName] = {
                 ...configDefinitions[configName],
-                ...configDefinitionUserLand
+                ...configDefinitionUserLand,
             };
         });
     });
@@ -828,13 +828,13 @@ function runEffect(configName, configDef, source) {
         return null;
     // The value needs to be loaded at config time, that's why we only support effect for configs that are config-only for now.
     assertUsage(configDef.env.config, [
-        `Cannot add meta.effect to ${pc.cyan(configName)} because its meta.env is ${pc.cyan(JSON.stringify(configDef.env))} but an effect can only be added to a config that has a meta.env with ${pc.cyan('{ config: true }')}.`
+        `Cannot add meta.effect to ${pc.cyan(configName)} because its meta.env is ${pc.cyan(JSON.stringify(configDef.env))} but an effect can only be added to a config that has a meta.env with ${pc.cyan('{ config: true }')}.`,
     ].join(' '));
     assert(source.valueIsLoaded);
     // Call effect
     const configModFromEffect = configDef.effect({
         configValue: source.value,
-        configDefinedAt: getConfigDefinedAt('Config', configName, source.definedAt)
+        configDefinedAt: getConfigDefinedAt('Config', configName, source.definedAt),
     });
     if (!configModFromEffect)
         return null;
@@ -855,7 +855,7 @@ function applyEffectConfVal(configModFromEffect, sourceEffect, configValueSource
             valueIsLoadedWithImport: false,
             valueIsDefinedByPlusValueFile: false,
             valueIsLoaded: true,
-            value: configValue
+            value: configValue,
         };
         assert(sourceEffect.valueIsLoaded);
         const isValueGlobalSource = resolveIsGlobalValue(configDefEffect.global, sourceEffect, plusFilesAll);
@@ -887,11 +887,11 @@ function applyEffectMetaEnv(configModFromEffect, configValueSources, configDefEf
                 assertUsage(keys.includes('env'), notSupported);
                 assertUsage(keys.length === 1, notSupported);
             }
-            const envOverriden = configTargetDef.env;
+            const envOverridden = configTargetDef.env;
             const sources = configValueSources[configTargetName];
             sources?.forEach((configValueSource) => {
                 // Apply effect
-                configValueSource.configEnv = envOverriden;
+                configValueSource.configEnv = envOverridden;
             });
         });
     });
@@ -906,7 +906,7 @@ function getComputed(configValueSources, configDefinitions) {
             return;
         configValuesComputed[configName] = {
             value,
-            configEnv: configDef.env
+            configEnv: configDef.env,
         };
     });
     return configValuesComputed;
@@ -951,7 +951,7 @@ function assertKnownConfig(configName, configNamesKnownRelevant, configDefinitio
             title: ui,
             ssr: ui,
             stream: ui,
-            Wrapper: ui
+            Wrapper: ui,
         };
         if (configName in knownVikeExntensionConfigs) {
             const requiredVikeExtension = joinEnglish(knownVikeExntensionConfigs[configName].map((e) => pc.bold(e)), 'or');
@@ -998,7 +998,7 @@ function determineRouteFilesystem(locationId, configValueSources) {
     assert(filesystemRouteString.startsWith('/'));
     const routeFilesystem = {
         routeString: filesystemRouteString,
-        definedAtLocation: filesystemRouteDefinedBy
+        definedAtLocation: filesystemRouteDefinedBy,
     };
     return { routeFilesystem, isErrorPage: undefined };
 }
@@ -1097,7 +1097,7 @@ function isGlobalLocation(locationId, plusFilesAll) {
         .map(([locationId]) => locationId);
     return locationIdsPage.every((locId) => isInherited(locationId, locId));
 }
-function isOverriden(source, configName, pageConfig) {
+function isOverridden(source, configName, pageConfig) {
     const configDef = pageConfig.configDefinitions[configName];
     assert(configDef);
     if (configDef.cumulative)
@@ -1116,7 +1116,7 @@ function resolvePrerenderContext(vikeConfig) {
         // Set at runPrerender()
         output: null,
         // Set at runPrerender()
-        pageContexts: null
+        pageContexts: null,
     });
     prerenderContext.isPrerenderingEnabled = isPrerenderingEnabled;
     prerenderContext.isPrerenderingEnabledForAllPages = isPrerenderingEnabledForAllPages;
@@ -1143,19 +1143,19 @@ function getVikeConfigDummy(esbuildCache) {
     const prerenderContextDummy = resolvePrerenderContext({
         config: globalDummy.config,
         _from: globalDummy._from,
-        _pageConfigs: pageConfigsDummy
+        _pageConfigs: pageConfigsDummy,
     });
     const vikeConfigDummy = {
         _pageConfigs: pageConfigsDummy,
         _pageConfigGlobal: {
             configDefinitions: {},
-            configValueSources: {}
+            configValueSources: {},
         },
         config: globalDummy.config,
         _from: globalDummy._from,
         pages: {},
         prerenderContext: prerenderContextDummy,
-        _vikeConfigDependencies: esbuildCache.vikeConfigDependencies
+        _vikeConfigDependencies: esbuildCache.vikeConfigDependencies,
     };
     vikeConfigSync = vikeConfigDummy;
     isV1Design_ = true;

package/dist/esm/node/vite/utils.d.ts

@@ -4,22 +4,16 @@ export * from '../../utils/includes.js';
 export * from '../../utils/isDev.js';
 export * from '../../utils/getMostSimilar.js';
 export * from '../../utils/getRandomId.js';
-export * from '../../utils/joinEnglish.js';
 export * from '../../utils/escapeRegex.js';
-export * from '../../utils/stripAnsi.js';
 export * from '../../utils/trimWithAnsi.js';
 export * from '../../utils/removeEmptyLines.js';
 export * from '../../utils/findPackageJson.js';
-export * from '../../utils/getPropAccessNotation.js';
 export * from '../../utils/deepEqual.js';
 export * from '../../utils/assertKeys.js';
 export * from '../../utils/injectRollupInputs.js';
-export * from '../../utils/humanizeTime.js';
 export * from '../../utils/pLimit.js';
 export * from '../../utils/assertVersion.js';
 export * from '../../utils/isFilePathAbsoluteFilesystem.js';
-export * from '../../utils/isArray.js';
-export * from '../../utils/PROJECT_VERSION.js';
 export * from '../../utils/isEqualStringList.js';
 export * from '../../utils/isDocker.js';
 export * from '../../utils/isVitest.js';

package/dist/esm/node/vite/utils.js

@@ -2,7 +2,8 @@
 // We call onLoad() here so that it's called even when only a subset of the plugin is loaded. (Making the assert() calls inside onLoad() a lot stronger.)
 import { onLoad } from './onLoad.js';
 onLoad();
-// It's common practice for Vike's Vite plugin to import from Vike's sever runtime
+// - Server-side bloat is negligible
+// - The Vite plugin imports the server runtime anyways
 export * from '../runtime/utils.js';
 // Utils only needed by `plugin/*`
 export * from '../../utils/requireResolve.js';
@@ -10,22 +11,16 @@ export * from '../../utils/includes.js';
 export * from '../../utils/isDev.js';
 export * from '../../utils/getMostSimilar.js';
 export * from '../../utils/getRandomId.js';
-export * from '../../utils/joinEnglish.js';
 export * from '../../utils/escapeRegex.js';
-export * from '../../utils/stripAnsi.js';
 export * from '../../utils/trimWithAnsi.js';
 export * from '../../utils/removeEmptyLines.js';
 export * from '../../utils/findPackageJson.js';
-export * from '../../utils/getPropAccessNotation.js';
 export * from '../../utils/deepEqual.js';
 export * from '../../utils/assertKeys.js';
 export * from '../../utils/injectRollupInputs.js';
-export * from '../../utils/humanizeTime.js';
 export * from '../../utils/pLimit.js';
 export * from '../../utils/assertVersion.js';
 export * from '../../utils/isFilePathAbsoluteFilesystem.js';
-export * from '../../utils/isArray.js';
-export * from '../../utils/PROJECT_VERSION.js';
 export * from '../../utils/isEqualStringList.js';
 export * from '../../utils/isDocker.js';
 export * from '../../utils/isVitest.js';

package/dist/esm/shared/assertHookReturnedObject.js

@@ -14,6 +14,6 @@ function assertHookReturnedObject(obj, keysExpected, errPrefix) {
         'returned an object with following unknown keys:',
         stringifyStringArray(keysUnknown) + '.',
         'Only following keys are allowed:',
-        stringifyStringArray(keysExpected) + '.'
+        stringifyStringArray(keysExpected) + '.',
     ].join(' '));
 }

package/dist/esm/shared/assertPageContextProvidedByUser.d.ts

@@ -1,5 +1,5 @@
 export { assertPageContextProvidedByUser };
-declare function assertPageContextProvidedByUser(pageContextProvidedByUser: unknown, { hookName, hookFilePath }: {
+declare function assertPageContextProvidedByUser(pageContextProvidedByUser: unknown, { hookName, hookFilePath, }: {
     hookFilePath: string;
     hookName: 'onBeforeRender' | 'onRenderHtml' | 'render' | 'onBeforeRoute';
 }): asserts pageContextProvidedByUser is Record<string, unknown>;

package/dist/esm/shared/assertPageContextProvidedByUser.js

@@ -1,7 +1,7 @@
 export { assertPageContextProvidedByUser };
 import { assert, assertUsage, assertWarning, isObject } from './utils.js';
 import pc from '@brillout/picocolors';
-function assertPageContextProvidedByUser(pageContextProvidedByUser, { hookName, hookFilePath }) {
+function assertPageContextProvidedByUser(pageContextProvidedByUser, { hookName, hookFilePath, }) {
     if (pageContextProvidedByUser === undefined || pageContextProvidedByUser === null)
         return;
     assert(!hookName.endsWith(')'));
@@ -10,6 +10,6 @@ function assertPageContextProvidedByUser(pageContextProvidedByUser, { hookName,
     assertUsage(!('isPageContext' in pageContextProvidedByUser), `${errPrefix} shouldn't be the whole ${pc.cyan('pageContext')} object, see https://vike.dev/pageContext-manipulation#do-not-return-entire-pagecontext`);
     // In principle, it's possible to use onBeforeRoute()` to override and define the whole routing.
     // Is that a good idea to allow users to do this? Beyond deep integration with Vue Router or React Router, is there a use case for this?
-    assertWarning(!('pageId' in pageContextProvidedByUser), `${errPrefix} sets ${pc.cyan('pageContext.pageId')} which means that Vike's routing is overriden. This is an experimental feature: make sure to contact a vike maintainer before using this.`, { onlyOnce: true });
+    assertWarning(!('pageId' in pageContextProvidedByUser), `${errPrefix} sets ${pc.cyan('pageContext.pageId')} which means that Vike's routing is overridden. This is an experimental feature: make sure to contact a vike maintainer before using this.`, { onlyOnce: true });
     assertUsage(!('is404' in pageContextProvidedByUser), `${errPrefix} sets ${pc.cyan('pageContext.is404')} which is forbidden, use ${pc.cyan('throw render()')} instead, see https://vike.dev/render`);
 }

package/dist/esm/shared/createGlobalContextShared.d.ts

@@ -7,9 +7,11 @@ import type { PageFile } from './getPageFiles.js';
 import type { PageConfigRuntime } from '../types/PageConfig.js';
 import type { GlobalContextServerInternal } from '../node/runtime/globalContext.js';
 import type { GlobalContextClientInternal } from '../client/runtime-client-routing/globalContext.js';
+import { type Hook } from './hooks/getHook.js';
 declare const getGlobalContextSyncErrMsg = "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.";
 declare function createGlobalContextShared<GlobalContextAddendum extends object>(virtualFileExports: unknown, globalObject: {
     globalContext?: Record<string, unknown>;
+    onCreateGlobalContextHooks?: Hook[];
 }, addGlobalContext?: (globalContext: GlobalContextBase) => Promise<GlobalContextAddendum>): Promise<{
     /**
      * Useful for distinguishing `globalContext` from other objects and narrowing down TypeScript unions.

package/dist/esm/shared/createGlobalContextShared.js

@@ -1,39 +1,40 @@
 export { createGlobalContextShared };
 export { getGlobalContextSyncErrMsg };
-import { changeEnumerable, objectAssign, unique } from './utils.js';
+import { changeEnumerable, objectAssign, objectReplace, unique } from './utils.js';
 import { parseVirtualFileExports } from './getPageFiles/parseVirtualFileExports.js';
-import { resolveVikeConfigPublicGlobal, resolveVikeConfigPublicPageEager } from './page-configs/resolveVikeConfigPublic.js';
+import { resolveVikeConfigPublicGlobal, resolveVikeConfigPublicPageEager, } from './page-configs/resolveVikeConfigPublic.js';
 import { execHookGlobal } from './hooks/execHook.js';
 import { prepareGlobalContextForPublicUsage } from './prepareGlobalContextForPublicUsage.js';
+import { getHookFromPageConfigGlobalCumulative } from './hooks/getHook.js';
 const getGlobalContextSyncErrMsg = "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.";
 async function createGlobalContextShared(virtualFileExports, globalObject, addGlobalContext) {
     const globalContext = createGlobalContextBase(virtualFileExports);
     const globalContextAddendum = await addGlobalContext?.(globalContext);
     objectAssign(globalContext, globalContextAddendum);
+    const onCreateGlobalContextHooks = getHookFromPageConfigGlobalCumulative(globalContext._pageConfigGlobal, 'onCreateGlobalContext');
+    let hooksCalled = false;
+    if (!hooksAreEqual(globalObject.onCreateGlobalContextHooks ?? [], onCreateGlobalContextHooks)) {
+        globalObject.onCreateGlobalContextHooks = onCreateGlobalContextHooks;
+        await execHookGlobal('onCreateGlobalContext', globalContext._pageConfigGlobal, null, globalContext, prepareGlobalContextForPublicUsage);
+        hooksCalled = true;
+    }
     if (!globalObject.globalContext) {
         globalObject.globalContext = globalContext;
-        // - We deliberately call onCreateGlobalContext() only at the beginning and only once per process.
-        // - TO-DO/eventually: HMR
-        //    - Once Photon supports it: `server.hot.send({ type: 'full-server-reload' })`
-        //    - Either use:
-        //      - import.meta.hot
-        //        - https://vite.dev/guide/api-hmr.html
-        //        - Use a Vite transformer to inject import.meta.hot code into each user-land `+onCreateGlobalContext.js` file
-        //        - Seems more idiomatic
-        //      - globalContext._viteDevServer.hot.send()
-        //        - Send 'full-server-reload' signal whenever a onCreateGlobalContext() function is modified => we need a globalObject to track all hooks and see if one of them is new/modified.
-        //        - Seems less idiomatic
-        await execHookGlobal('onCreateGlobalContext', globalContext._pageConfigGlobal, null, globalContext, prepareGlobalContextForPublicUsage);
     }
     else {
         // Singleton: ensure all `globalContext` user-land references are preserved & updated.
-        // We don't use objectReplace() in order to keep user-land properties.
-        objectAssign(globalObject.globalContext, globalContext, true);
+        if (hooksCalled) {
+            objectReplace(globalObject.globalContext, globalContext);
+        }
+        else {
+            // We don't use objectReplace() in order to keep user-land properties.
+            objectAssign(globalObject.globalContext, globalContext, true);
+        }
     }
     return globalObject.globalContext;
 }
 function createGlobalContextBase(virtualFileExports) {
-    const { pageFilesAll, allPageIds, pageConfigs, pageConfigGlobal, vikeConfigPublicGlobal, vikeConfigPublicPagesEager } = getConfigsAll(virtualFileExports);
+    const { pageFilesAll, allPageIds, pageConfigs, pageConfigGlobal, vikeConfigPublicGlobal, vikeConfigPublicPagesEager, } = getConfigsAll(virtualFileExports);
     const globalContext = {
         /**
          * Useful for distinguishing `globalContext` from other objects and narrowing down TypeScript unions.
@@ -49,7 +50,7 @@ function createGlobalContextBase(virtualFileExports) {
         _allPageIds: allPageIds,
         _vikeConfigPublicGlobal: vikeConfigPublicGlobal,
         config: vikeConfigPublicGlobal.config,
-        pages: vikeConfigPublicPagesEager
+        pages: vikeConfigPublicPagesEager,
     };
     changeEnumerable(globalContext, '_isOriginalObject', false);
     return globalContext;
@@ -58,7 +59,7 @@ function getConfigsAll(virtualFileExports) {
     const { pageFilesAll, pageConfigs, pageConfigGlobal } = parseVirtualFileExports(virtualFileExports);
     const allPageIds = getAllPageIds(pageFilesAll, pageConfigs);
     const vikeConfigPublicGlobal = resolveVikeConfigPublicGlobal({
-        pageConfigGlobalValues: pageConfigGlobal.configValues
+        pageConfigGlobalValues: pageConfigGlobal.configValues,
     });
     const vikeConfigPublicPagesEager = Object.fromEntries(pageConfigs.map((pageConfig) => {
         return resolveVikeConfigPublicPageEager(pageConfigGlobal.configValues, pageConfig, pageConfig.configValues);
@@ -69,7 +70,7 @@ function getConfigsAll(virtualFileExports) {
         pageConfigs,
         pageConfigGlobal,
         vikeConfigPublicGlobal,
-        vikeConfigPublicPagesEager
+        vikeConfigPublicPagesEager,
     };
 }
 function getAllPageIds(pageFilesAll, pageConfigs) {
@@ -78,3 +79,10 @@ function getAllPageIds(pageFilesAll, pageConfigs) {
     const allPageIds2 = pageConfigs.map((p) => p.pageId);
     return [...allPageIds, ...allPageIds2];
 }
+function hooksAreEqual(hooks1, hooks2) {
+    const hooksFn1 = hooks1.map((hook) => hook.hookFn);
+    const hooksFn2 = hooks2.map((hook) => hook.hookFn);
+    return (hooksFn1.every((hook) => hooksFn2.includes(hook)) &&
+        //
+        hooksFn2.every((hook) => hooksFn1.includes(hook)));
+}

package/dist/esm/shared/createPageContextShared.js

@@ -11,7 +11,7 @@ async function createPageContextShared(pageContextCreated, pageConfigGlobal, vik
 function createPageContextObject() {
     const pageContext = {
         _isOriginalObject: true,
-        isPageContext: true
+        isPageContext: true,
     };
     changeEnumerable(pageContext, '_isOriginalObject', false);
     return pageContext;

package/dist/esm/shared/getPageContextRequestUrl.js

@@ -1,7 +1,7 @@
 export { getPageContextRequestUrl };
 export { pageContextJsonFileExtension };
 export { doNotCreateExtraDirectory };
-// This module isn't loaded by the client-side of Server Routing => we don't inlcude `urlToFile` to `./utils.ts`
+// This module isn't loaded by the client-side of Server Routing => we don't include `urlToFile` to `./utils.ts`
 import { urlToFile } from '../utils/urlToFile.js';
 const pageContextJsonFileExtension = '.pageContext.json';
 // `/some-base-url/index.pageContext.json` instead of `/some-base-url.pageContext.json` in order to comply to common reverse proxy setups, see https://github.com/vikejs/vike/issues/443

package/dist/esm/shared/getPageContextUrlComputed.js

@@ -13,17 +13,17 @@ function getPageContextUrlComputed(pageContext) {
     objectDefineProperty(pageContextUrlComputed, 'urlPathname', {
         get: urlPathnameGetter,
         enumerable: true,
-        configurable: true
+        configurable: true,
     });
     objectDefineProperty(pageContextUrlComputed, 'url', {
         get: urlGetter,
         enumerable: false,
-        configurable: true
+        configurable: true,
     });
     objectDefineProperty(pageContextUrlComputed, 'urlParsed', {
         get: urlParsedGetter,
         enumerable: true,
-        configurable: true
+        configurable: true,
     });
     return pageContextUrlComputed;
 }
@@ -109,7 +109,7 @@ function urlParsedGetter() {
         get hashString() {
             assertWarning(false, 'pageContext.urlParsed.hashString has been renamed to pageContext.urlParsed.hashOriginal', {
                 onlyOnce: true,
-                showStackTrace: true
+                showStackTrace: true,
             });
             warnHashNotAvailable('hashString');
             return urlParsed.hashOriginal;
@@ -118,7 +118,7 @@ function urlParsedGetter() {
         get searchString() {
             assertWarning(false, 'pageContext.urlParsed.searchString has been renamed to pageContext.urlParsed.searchOriginal', { onlyOnce: true, showStackTrace: true });
             return urlParsed.searchOriginal;
-        }
+        },
     };
     changeEnumerable(urlParsedEnhanced, 'hashString', false);
     changeEnumerable(urlParsedEnhanced, 'searchString', false);

package/dist/esm/shared/getPageFiles/analyzePageClientSide/analyzeExports.d.ts

@@ -1,6 +1,6 @@
 export { analyzeExports };
 import type { PageFile } from '../getPageFileObject.js';
-declare function analyzeExports({ pageFilesClientSide, pageFilesServerSide, pageId }: {
+declare function analyzeExports({ pageFilesClientSide, pageFilesServerSide, pageId, }: {
     pageFilesClientSide: PageFile[];
     pageFilesServerSide: PageFile[];
     pageId: string;