vike 0.4.224 → 0.4.225-commit-2b7971f

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getVikeConfig.js

@@ -1,12 +1,12 @@
 export { getVikeConfig };
+export { getVikeConfigOptional };
 export { getVikeConfig2 };
 export { reloadVikeConfig };
-export { vikeConfigDependencies };
 export { isV1Design };
 export { getConfVal };
 export { getConfigDefinitionOptional };
 export { isOverriden };
-import { assertPosixPath, assert, isObject, assertUsage, assertWarning, objectEntries, hasProp, includes, assertIsNotProductionRuntime, getMostSimilar, joinEnglish, assertKeys, objectKeys, objectFromEntries, unique, isCallable, makeFirst, lowerFirst, makeLast } from '../../../utils.js';
+import { assertPosixPath, assert, isObject, assertUsage, assertWarning, objectEntries, hasProp, includes, assertIsNotProductionRuntime, getMostSimilar, joinEnglish, assertKeys, objectKeys, objectFromEntries, unique, isCallable, makeFirst, lowerFirst, makeLast, assertIsSingleModuleInstance } from '../../../utils.js';
 import { configDefinitionsBuiltIn } from './getVikeConfig/configDefinitionsBuiltIn.js';
 import { getLocationId, getFilesystemRouteString, getFilesystemRouteDefinedBy, isInherited, sortAfterInheritanceOrder, applyFilesystemRoutingRootEffect } from './getVikeConfig/filesystemRouting.js';
 import { isVikeConfigInvalid, isVikeConfigInvalid_set } from '../../../../runtime/renderPage/isVikeConfigInvalid.js';
@@ -14,7 +14,7 @@ import { getViteDevServer } from '../../../../runtime/globalContext.js';
 import { logConfigError, logConfigErrorRecover } from '../../../shared/loggerNotProd.js';
 import { removeSuperfluousViteLog_enable, removeSuperfluousViteLog_disable } from '../../../shared/loggerVite/removeSuperfluousViteLog.js';
 import pc from '@brillout/picocolors';
-import { getConfigDefinedAt } from '../../../../../shared/page-configs/getConfigDefinedAt.js';
+import { getConfigDefinedAt, getDefinedByString } from '../../../../../shared/page-configs/getConfigDefinedAt.js';
 import { loadPointerImport, loadValueFile } from './getVikeConfig/loadFileAtConfigTime.js';
 import { resolvePointerImport } from './getVikeConfig/resolvePointerImport.js';
 import { getFilePathResolved } from '../../../shared/getFilePath.js';
@@ -23,17 +23,18 @@ import { assertExtensionsRequire } from './getVikeConfig/assertExtensions.js';
 import { getPageConfigGlobalUserFriendly, getPageConfigUserFriendly } from '../../../../../shared/page-configs/getPageConfigUserFriendly.js';
 import { getConfigValuesBase, isJsonValue } from '../../../../../shared/page-configs/serialize/serializeConfigValues.js';
 import { getPlusFilesAll } from './getVikeConfig/getPlusFilesAll.js';
+import { getEnvVarObject } from '../../../shared/getEnvVarObject.js';
+import { getApiOperation } from '../../../../api/context.js';
+import { getCliOptions } from '../../../../cli/context.js';
 assertIsNotProductionRuntime();
+assertIsSingleModuleInstance('v1-design/getVikeConfig.ts');
 let restartVite = false;
 let wasConfigInvalid = null;
 let vikeConfigPromise = null;
-const vikeConfigDependencies = new Set();
 function reloadVikeConfig(config) {
     const userRootDir = config.root;
     const vikeVitePluginOptions = config._vikeVitePluginOptions;
     assert(vikeVitePluginOptions);
-    // TODO/now: unify with esbuildCache
-    vikeConfigDependencies.clear();
     vikeConfigPromise = loadVikeConfig_withErrorHandling(userRootDir, true, vikeVitePluginOptions);
     handleReloadSideEffects();
 }
@@ -87,6 +88,11 @@ async function getVikeConfigEntry(userRootDir, isDev, vikeVitePluginOptions, doN
     }
     return await vikeConfigPromise;
 }
+async function getVikeConfigOptional() {
+    if (!vikeConfigPromise)
+        return null;
+    return await vikeConfigPromise;
+}
 function isV1Design(config) {
     const vikeConfig = config._vikeConfigObject;
     assert(vikeConfig);
@@ -131,20 +137,24 @@ async function loadVikeConfig_withErrorHandling(userRootDir, isDev, vikeVitePlug
                     configValueSources: {}
                 },
                 global: getPageConfigGlobalUserFriendly({ pageConfigGlobalValues: {} }),
-                pages: {}
+                pages: {},
+                vikeConfigDependencies: new Set()
             };
             return dummyData;
         }
     }
 }
 async function loadVikeConfig(userRootDir, vikeVitePluginOptions) {
-    const esbuildCache = {};
+    const esbuildCache = {
+        transpileCache: {},
+        vikeConfigDependencies: new Set()
+    };
     const plusFilesAll = await getPlusFilesAll(userRootDir, esbuildCache);
     const configDefinitionsResolved = await resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache);
-    assertKnownConfigs(configDefinitionsResolved, plusFilesAll);
     const { pageConfigGlobal, pageConfigs } = getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRootDir);
     // Backwards compatibility for vike(options) in vite.config.js
     temp_interopVikeVitePlugin(pageConfigGlobal, vikeVitePluginOptions, userRootDir);
+    setCliAndApiOptions(pageConfigGlobal, configDefinitionsResolved);
     // global
     const pageConfigGlobalValues = getConfigValues(pageConfigGlobal);
     const global = getPageConfigGlobalUserFriendly({ pageConfigGlobalValues });
@@ -153,7 +163,7 @@ async function loadVikeConfig(userRootDir, vikeVitePluginOptions) {
         const pageConfigValues = getConfigValues(pageConfig, true);
         return getPageConfigUserFriendly(pageConfigGlobalValues, pageConfig, pageConfigValues);
     }));
-    return { pageConfigs, pageConfigGlobal, global, pages };
+    return { pageConfigs, pageConfigGlobal, global, pages, vikeConfigDependencies: esbuildCache.vikeConfigDependencies };
 }
 async function resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache) {
     const plusFilesAllOrdered = Object.values(plusFilesAll)
@@ -163,6 +173,10 @@ async function resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache)
     // We use `plusFilesAll` in order to allow local Vike extensions to create global configs, and to set the value of global configs such as `+vite` (enabling Vike extensions to add Vite plugins).
     plusFilesAllOrdered, (configDef) => !!configDef.global);
     await loadCustomConfigBuildTimeFiles(plusFilesAll, configDefinitionsGlobal, userRootDir, esbuildCache);
+    const configDefinitionsAll = getConfigDefinitions(Object.values(plusFilesAll).flat());
+    const configNamesKnownAll = Object.keys(configDefinitionsAll);
+    const configNamesKnownGlobal = Object.keys(configDefinitionsGlobal);
+    assert(configNamesKnownGlobal.every((configName) => configNamesKnownAll.includes(configName)));
     const configDefinitionsLocal = {};
     await Promise.all(objectEntries(plusFilesAll).map(async ([locationIdPage, plusFiles]) => {
         const plusFilesRelevant = objectEntries(plusFilesAll)
@@ -172,12 +186,23 @@ async function resolveConfigDefinitions(plusFilesAll, userRootDir, esbuildCache)
             .sort((plusFile1, plusFile2) => sortAfterInheritanceOrderPage(plusFile1, plusFile2, locationIdPage, null));
         const configDefinitions = getConfigDefinitions(plusFilesRelevant, (configDef) => configDef.global !== true);
         await loadCustomConfigBuildTimeFiles(plusFiles, configDefinitions, userRootDir, esbuildCache);
-        configDefinitionsLocal[locationIdPage] = { configDefinitions, plusFiles, plusFilesRelevant };
+        const configNamesKnownLocal = unique([...Object.keys(configDefinitions), ...configNamesKnownGlobal]);
+        assert(configNamesKnownLocal.every((configName) => configNamesKnownAll.includes(configName)));
+        configDefinitionsLocal[locationIdPage] = {
+            configDefinitions,
+            plusFiles,
+            plusFilesRelevant,
+            configNamesKnownLocal
+        };
     }));
     const configDefinitionsResolved = {
         configDefinitionsGlobal,
-        configDefinitionsLocal
+        configDefinitionsLocal,
+        configDefinitionsAll,
+        configNamesKnownAll,
+        configNamesKnownGlobal
     };
+    assertKnownConfigs(configDefinitionsResolved);
     return configDefinitionsResolved;
 }
 // Load value files (with `env.config===true`) of *custom* configs.
@@ -203,13 +228,13 @@ function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRo
     objectEntries(configDefinitionsResolved.configDefinitionsGlobal).forEach(([configName, configDef]) => {
         const sources = resolveConfigValueSources(configName, configDef, 
         // We use `plusFilesAll` in order to allow local Vike extensions to create global configs, and to set the value of global configs such as `+vite` (enabling Vike extensions to add Vite plugins).
-        Object.values(plusFilesAll).flat(), userRootDir, true);
+        Object.values(plusFilesAll).flat(), userRootDir, true, plusFilesAll);
         if (sources.length === 0)
             return;
         pageConfigGlobal.configValueSources[configName] = sources;
     });
     applyEffectsMetaEnv(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal);
-    applyEffectsConfVal(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal);
+    applyEffectsConfVal(pageConfigGlobal.configValueSources, configDefinitionsResolved.configDefinitionsGlobal, plusFilesAll);
     sortConfigValueSources(pageConfigGlobal.configValueSources, null);
     assertPageConfigGlobal(pageConfigGlobal, plusFilesAll);
     const pageConfigs = objectEntries(configDefinitionsResolved.configDefinitionsLocal)
@@ -220,14 +245,14 @@ function getPageConfigsBuildTime(configDefinitionsResolved, plusFilesAll, userRo
         objectEntries(configDefinitionsLocal)
             .filter(([_configName, configDef]) => configDef.global !== true)
             .forEach(([configName, configDef]) => {
-            const sources = resolveConfigValueSources(configName, configDef, plusFilesRelevant, userRootDir, false);
+            const sources = resolveConfigValueSources(configName, configDef, plusFilesRelevant, userRootDir, false, plusFilesAll);
             if (sources.length === 0)
                 return;
             configValueSources[configName] = sources;
         });
         const pageConfigRoute = determineRouteFilesystem(locationId, configValueSources);
         applyEffectsMetaEnv(configValueSources, configDefinitionsLocal);
-        applyEffectsConfVal(configValueSources, configDefinitionsLocal);
+        applyEffectsConfVal(configValueSources, configDefinitionsLocal, plusFilesAll);
         sortConfigValueSources(configValueSources, locationId);
         const configValuesComputed = getComputed(configValueSources, configDefinitionsLocal);
         const pageConfig = {
@@ -280,7 +305,7 @@ function assertGlobalConfigLocation(configName, sources, plusFilesAll, configDef
                 : 'to a value that is global';
             const what = isConditionallyGlobal ? 'global values' : pc.cyan(configName);
             const errEnd = configFilePathsGlobal.length > 0
-                ? `define ${what} at a global config file such as ${joinEnglish(configFilePathsGlobal, 'or')} instead`
+                ? `define ${what} at a global config file such as ${joinEnglish(configFilePathsGlobal.map(pc.bold), 'or')} instead`
                 : `create a global config file (e.g. /pages/+config.js) and define ${what} there instead`;
             // When updating this error message => also update error message at https://vike.dev/warning/global-config
             const errMsg = `${errBeg} ${errMid}: ${errEnd} (https://vike.dev/warning/global-config).`;
@@ -349,27 +374,58 @@ function temp_interopVikeVitePlugin(pageConfigGlobal, vikeVitePluginOptions, use
     assertWarning(Object.keys(vikeVitePluginOptions).length === 0, `Define Vike settings in +config.js instead of vite.config.js ${pc.underline('https://vike.dev/migration/settings')}`, { onlyOnce: true });
     Object.entries(vikeVitePluginOptions).forEach(([configName, value]) => {
         var _a;
-        assert(includes(objectKeys(configDefinitionsBuiltIn), configName));
-        const configDef = configDefinitionsBuiltIn[configName];
         const sources = ((_a = pageConfigGlobal.configValueSources)[configName] ?? (_a[configName] = []));
-        sources.push({
-            valueIsLoaded: true,
-            value,
-            configEnv: configDef.env,
-            definedAtFilePath: {
-                ...getFilePathResolved({
-                    userRootDir,
-                    filePathAbsoluteUserRootDir: '/vite.config.js'
-                }),
-                fileExportPathToShowToUser: null
-            },
-            locationId: '/',
-            plusFile: null,
-            valueIsLoadedWithImport: false,
-            valueIsDefinedByPlusValueFile: false
-        });
+        sources.push(getSourceNonConfigFile(configName, value, {
+            ...getFilePathResolved({
+                userRootDir,
+                filePathAbsoluteUserRootDir: '/vite.config.js'
+            }),
+            fileExportPathToShowToUser: null
+        }));
     });
 }
+function setCliAndApiOptions(pageConfigGlobal, configDefinitionsResolved) {
+    // Vike API — passed options [lowest precedence]
+    const apiOperation = getApiOperation();
+    if (apiOperation?.options.vikeConfig) {
+        addSources(apiOperation.options.vikeConfig, { definedBy: 'api', operation: apiOperation.operation }, false);
+    }
+    // Vike CLI options
+    const cliOptions = getCliOptions();
+    if (cliOptions) {
+        addSources(cliOptions, { definedBy: 'cli' }, true);
+    }
+    // VIKE_CONFIG [highest precedence]
+    const configFromEnv = getEnvVarObject('VIKE_CONFIG');
+    if (configFromEnv) {
+        addSources(configFromEnv, { definedBy: 'env' }, false);
+    }
+    return;
+    function addSources(configValues, definedBy, exitOnError) {
+        Object.entries(configValues).forEach(([configName, value]) => {
+            var _a;
+            const sourceName = `The ${getDefinedByString(definedBy, configName)}`;
+            assertKnownConfig(configName, configDefinitionsResolved.configNamesKnownGlobal, configDefinitionsResolved, '/', sourceName, exitOnError);
+            const sources = ((_a = pageConfigGlobal.configValueSources)[configName] ?? (_a[configName] = []));
+            sources.unshift(getSourceNonConfigFile(configName, value, definedBy));
+        });
+    }
+}
+function getSourceNonConfigFile(configName, value, definedAt) {
+    assert(includes(objectKeys(configDefinitionsBuiltIn), configName));
+    const configDef = configDefinitionsBuiltIn[configName];
+    const source = {
+        valueIsLoaded: true,
+        value,
+        configEnv: configDef.env,
+        definedAt,
+        locationId: '/',
+        plusFile: null,
+        valueIsLoadedWithImport: false,
+        valueIsDefinedByPlusValueFile: false
+    };
+    return source;
+}
 function sortConfigValueSources(configValueSources, locationIdPage) {
     Object.entries(configValueSources).forEach(([configName, sources]) => {
         sources
@@ -456,7 +512,7 @@ function sortPlusFilesSameLocationId(plusFile1, plusFile2, configName) {
     // No need to make it deterministic: the overall order is arleady deterministic, see sortMakeDeterministic() at getPlusFilesAll()
     return 0;
 }
-function resolveConfigValueSources(configName, configDef, plusFilesRelevant, userRootDir, isGlobal) {
+function resolveConfigValueSources(configName, configDef, plusFilesRelevant, userRootDir, isGlobal, plusFilesAll) {
     let sources = plusFilesRelevant
         .filter((plusFile) => isDefiningConfig(plusFile, configName))
         .map((plusFile) => getConfigValueSource(configName, plusFile, configDef, userRootDir));
@@ -471,14 +527,14 @@ function resolveConfigValueSources(configName, configDef, plusFilesRelevant, use
         sources = sources.filter((source) => {
             assert(source.configEnv.config);
             assert(source.valueIsLoaded);
-            const valueIsGlobal = resolveIsGlobalValue(configDef.global, source.value);
+            const valueIsGlobal = resolveIsGlobalValue(configDef.global, source, plusFilesAll);
             return isGlobal ? valueIsGlobal : !valueIsGlobal;
         });
     }
     return sources;
 }
 function isDefiningConfig(plusFile, configName) {
-    return getDefiningConfigNames(plusFile).includes(configName);
+    return getConfigNamesSetByPlusFile(plusFile).includes(configName);
 }
 function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
     const confVal = getConfVal(plusFile, configName);
@@ -521,7 +577,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             configEnv: configDef.env,
             valueIsLoadedWithImport: false,
             valueIsDefinedByPlusValueFile: false,
-            definedAtFilePath
+            definedAt: definedAtFilePath
         };
         return configValueSource;
     }
@@ -545,7 +601,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
                 configEnv: resolveConfigEnv(configDef.env, pointerImport.fileExportPath),
                 valueIsLoadedWithImport: true,
                 valueIsDefinedByPlusValueFile: false,
-                definedAtFilePath: pointerImport.fileExportPath
+                definedAt: pointerImport.fileExportPath
             };
             return configValueSource;
         }
@@ -557,7 +613,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             configEnv: configDef.env,
             valueIsLoadedWithImport: false,
             valueIsDefinedByPlusValueFile: false,
-            definedAtFilePath: definedAtFilePath_
+            definedAt: definedAtFilePath_
         };
         return configValueSource;
     }
@@ -571,7 +627,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
             configEnv: configEnvResolved,
             valueIsLoadedWithImport: !confVal.valueIsLoaded || !isJsonValue(confVal.value),
             valueIsDefinedByPlusValueFile: true,
-            definedAtFilePath: {
+            definedAt: {
                 ...plusFile.filePath,
                 fileExportPathToShowToUser: configName === plusFile.configName
                     ? []
@@ -585,7 +641,7 @@ function getConfigValueSource(configName, plusFile, configDef, userRootDir) {
 }
 function isDefiningPage(plusFiles) {
     for (const plusFile of plusFiles) {
-        const configNames = getDefiningConfigNames(plusFile);
+        const configNames = getConfigNamesSetByPlusFile(plusFile);
         if (configNames.some((configName) => isDefiningPageConfig(configName))) {
             return true;
         }
@@ -595,16 +651,19 @@ function isDefiningPage(plusFiles) {
 function isDefiningPageConfig(configName) {
     return ['Page', 'route'].includes(configName);
 }
-function resolveIsGlobalValue(configDefGlobal, configValue) {
+function resolveIsGlobalValue(configDefGlobal, source, plusFilesAll) {
+    assert(source.valueIsLoaded);
     let isGlobal;
     if (isCallable(configDefGlobal))
-        isGlobal = configDefGlobal(configValue);
+        isGlobal = configDefGlobal(source.value, {
+            isGlobalLocation: isGlobalLocation(source.locationId, plusFilesAll)
+        });
     else
         isGlobal = configDefGlobal ?? false;
     assert(typeof isGlobal === 'boolean');
     return isGlobal;
 }
-function getDefiningConfigNames(plusFile) {
+function getConfigNamesSetByPlusFile(plusFile) {
     let configNames = [];
     if (!plusFile.isConfigFile) {
         configNames.push(plusFile.configName);
@@ -688,7 +747,7 @@ function assertMetaUsage(metaVal, metaConfigDefinedAt) {
     });
 }
 // Test: https://github.com/vikejs/vike/blob/441a37c4c1a3b07bb8f6efb1d1f7be297a53974a/test/playground/vite.config.ts#L39
-function applyEffectsConfVal(configValueSources, configDefinitions) {
+function applyEffectsConfVal(configValueSources, configDefinitions, plusFilesAll) {
     objectEntries(configDefinitions).forEach(([configNameEffect, configDefEffect]) => {
         const sourceEffect = configValueSources[configNameEffect]?.[0];
         if (!sourceEffect)
@@ -696,8 +755,8 @@ function applyEffectsConfVal(configValueSources, configDefinitions) {
         const effect = runEffect(configNameEffect, configDefEffect, sourceEffect);
         if (!effect)
             return;
-        const { configModFromEffect, configValueEffectSource } = effect;
-        applyEffectConfVal(configModFromEffect, sourceEffect, configValueSources, configNameEffect, configDefEffect, configDefinitions, configValueEffectSource);
+        const configModFromEffect = effect;
+        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
@@ -709,7 +768,7 @@ function applyEffectsMetaEnv(configValueSources, configDefinitions) {
         const effect = runEffect(configNameEffect, configDefEffect, sourceEffect);
         if (!effect)
             return;
-        const { configModFromEffect } = effect;
+        const configModFromEffect = effect;
         applyEffectMetaEnv(configModFromEffect, configValueSources, configDefEffect);
     });
 }
@@ -721,17 +780,16 @@ function runEffect(configName, configDef, source) {
         `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);
-    const configValueEffectSource = source.value;
     // Call effect
     const configModFromEffect = configDef.effect({
-        configValue: configValueEffectSource,
-        configDefinedAt: getConfigDefinedAt('Config', configName, source.definedAtFilePath)
+        configValue: source.value,
+        configDefinedAt: getConfigDefinedAt('Config', configName, source.definedAt)
     });
     if (!configModFromEffect)
         return null;
-    return { configModFromEffect, configValueEffectSource };
+    return configModFromEffect;
 }
-function applyEffectConfVal(configModFromEffect, sourceEffect, configValueSources, configNameEffect, configDefEffect, configDefinitions, configValueEffectSource) {
+function applyEffectConfVal(configModFromEffect, sourceEffect, configValueSources, configNameEffect, configDefEffect, configDefinitions, plusFilesAll) {
     objectEntries(configModFromEffect).forEach(([configNameTarget, configValue]) => {
         if (configNameTarget === 'meta')
             return;
@@ -739,7 +797,7 @@ function applyEffectConfVal(configModFromEffect, sourceEffect, configValueSource
         assert(configDef);
         assert(configDefEffect._userEffectDefinedAtFilePath);
         const configValueSource = {
-            definedAtFilePath: configDefEffect._userEffectDefinedAtFilePath,
+            definedAt: configDefEffect._userEffectDefinedAtFilePath,
             plusFile: sourceEffect.plusFile,
             locationId: sourceEffect.locationId,
             configEnv: configDef.env,
@@ -748,11 +806,12 @@ function applyEffectConfVal(configModFromEffect, sourceEffect, configValueSource
             valueIsLoaded: true,
             value: configValue
         };
-        const isValueGlobalSource = resolveIsGlobalValue(configDefEffect.global, configValueEffectSource);
-        const isValueGlobalTarget = resolveIsGlobalValue(configDef.global, configValue);
+        assert(sourceEffect.valueIsLoaded);
+        const isValueGlobalSource = resolveIsGlobalValue(configDefEffect.global, sourceEffect, plusFilesAll);
+        const isValueGlobalTarget = resolveIsGlobalValue(configDef.global, configValueSource, plusFilesAll);
         const isGlobalHumanReadable = (isGlobal) => `${isGlobal ? 'non-' : ''}global`;
         // The error message make it sound like it's an inherent limitation, it actually isn't (both ways can make senses).
-        assertUsage(isValueGlobalSource === isValueGlobalTarget, `The configuration ${pc.cyan(configNameEffect)} is set to ${pc.cyan(JSON.stringify(configValueEffectSource))} which is considered ${isGlobalHumanReadable(isValueGlobalSource)}. However, it has a meta.effect that sets the configuration ${pc.cyan(configNameTarget)} to ${pc.cyan(JSON.stringify(configValue))} which is considered ${isGlobalHumanReadable(isValueGlobalTarget)}. This is contradictory: make sure the values are either both non-global or both global.`);
+        assertUsage(isValueGlobalSource === isValueGlobalTarget, `The configuration ${pc.cyan(configNameEffect)} is set to ${pc.cyan(JSON.stringify(sourceEffect.value))} which is considered ${isGlobalHumanReadable(isValueGlobalSource)}. However, it has a meta.effect that sets the configuration ${pc.cyan(configNameTarget)} to ${pc.cyan(JSON.stringify(configValue))} which is considered ${isGlobalHumanReadable(isValueGlobalTarget)}. This is contradictory: make sure the values are either both non-global or both global.`);
         configValueSources[configNameTarget] ?? (configValueSources[configNameTarget] = []);
         configValueSources[configNameTarget].push(configValueSource);
     });
@@ -801,33 +860,30 @@ function getComputed(configValueSources, configDefinitions) {
     return configValuesComputed;
 }
 // Show error message upon unknown config
-function assertKnownConfigs(configDefinitionsResolved, plusFilesAll) {
-    const configDefinitionsAll = getConfigDefinitions(Object.values(plusFilesAll).flat());
-    const configNamesKnownAll = Object.keys(configDefinitionsAll);
-    const configNamesGlobal = Object.keys(configDefinitionsResolved.configDefinitionsGlobal);
-    objectEntries(configDefinitionsResolved.configDefinitionsLocal).forEach(([_locationId, { configDefinitions, plusFiles }]) => {
-        const configDefinitionsLocal = configDefinitions;
-        const configNamesKnownLocal = [...Object.keys(configDefinitionsLocal), ...configNamesGlobal];
+function assertKnownConfigs(configDefinitionsResolved) {
+    objectEntries(configDefinitionsResolved.configDefinitionsLocal).forEach(([_locationId, { configNamesKnownLocal, plusFiles }]) => {
         plusFiles.forEach((plusFile) => {
-            const configNames = getDefiningConfigNames(plusFile);
+            const configNames = getConfigNamesSetByPlusFile(plusFile);
             configNames.forEach((configName) => {
-                assertKnownConfig(configName, configNamesKnownAll, configNamesKnownLocal, plusFile);
-                assert(configNamesKnownLocal.includes(configName));
-                assert(configNamesKnownAll.includes(configName));
+                const { locationId } = plusFile;
+                const sourceName = plusFile.filePath.filePathToShowToUser;
+                assertKnownConfig(configName, configNamesKnownLocal, configDefinitionsResolved, locationId, sourceName, false);
             });
         });
     });
 }
-function assertKnownConfig(configName, configNamesKnownAll, configNamesKnownLocal, plusFile) {
-    if (configNamesKnownLocal.includes(configName))
+function assertKnownConfig(configName, configNamesKnownRelevant, configDefinitionsResolved, locationId, sourceName, exitOnError) {
+    const { configNamesKnownAll } = configDefinitionsResolved;
+    if (configNamesKnownRelevant.includes(configName)) {
+        assert(configNamesKnownAll.includes(configName));
         return;
+    }
     const configNameColored = pc.cyan(configName);
-    const { locationId, filePath: { filePathToShowToUser } } = plusFile;
-    const errMsg = `${filePathToShowToUser} sets an unknown config ${configNameColored}`;
     // Inheritance issue: config is known but isn't defined at `locationId`
     if (configNamesKnownAll.includes(configName)) {
-        assertUsage(false, `${filePathToShowToUser} sets the value of the config ${configNameColored} which is a custom config that is defined with ${pc.underline('https://vike.dev/meta')} at a path that doesn't apply to ${locationId} — see ${pc.underline('https://vike.dev/config#inheritance')}`);
+        assertUsage(false, `${sourceName} sets the value of the config ${configNameColored} which is a custom config that is defined with ${pc.underline('https://vike.dev/meta')} at a path that doesn't apply to ${locationId} — see ${pc.underline('https://vike.dev/config#inheritance')}`, { exitOnError });
     }
+    const errMsg = `${sourceName} sets an unknown config ${configNameColored}`;
     // Missing vike-{react,vue,solid} installation
     {
         const ui = ['vike-react', 'vike-vue', 'vike-solid'];
@@ -843,11 +899,9 @@ function assertKnownConfig(configName, configNamesKnownAll, configNamesKnownLoca
             Wrapper: ui
         };
         if (configName in knownVikeExntensionConfigs) {
-            const requiredVikeExtension = knownVikeExntensionConfigs[configName]
-                .map((e) => pc.bold(e))
-                .join('/');
+            const requiredVikeExtension = joinEnglish(knownVikeExntensionConfigs[configName].map((e) => pc.bold(e)), 'or');
             const errMsgEnhanced = `${errMsg}. If you want to use the configuration ${configNameColored} documented at ${pc.underline(`https://vike.dev/${configName}`)} then make sure to install ${requiredVikeExtension}. (Alternatively, you can define ${configNameColored} yourself by using ${pc.cyan('meta')}, see ${pc.underline('https://vike.dev/meta')} for more information.)`;
-            assertUsage(false, errMsgEnhanced);
+            assertUsage(false, errMsgEnhanced, { exitOnError });
         }
     }
     // Similarity hint
@@ -864,9 +918,9 @@ function assertKnownConfig(configName, configNamesKnownAll, configNamesKnownLoca
         if (configName === 'page') {
             errMsgEnhanced += ` (The name of the config ${pc.cyan('Page')} starts with a capital letter ${pc.cyan('P')} because it defines a UI component: a ubiquitous JavaScript convention is that the name of UI components start with a capital letter.)`;
         }
-        assertUsage(false, errMsgEnhanced);
+        assertUsage(false, errMsgEnhanced, { exitOnError });
     }
-    assertUsage(false, errMsg);
+    assertUsage(false, errMsg, { exitOnError });
 }
 function determineRouteFilesystem(locationId, configValueSources) {
     const configName = 'filesystemRoutingRoot';
@@ -889,7 +943,7 @@ function determineRouteFilesystem(locationId, configValueSources) {
     assert(filesystemRouteString.startsWith('/'));
     const routeFilesystem = {
         routeString: filesystemRouteString,
-        definedBy: filesystemRouteDefinedBy
+        definedAtLocation: filesystemRouteDefinedBy
     };
     return { routeFilesystem, isErrorPage: undefined };
 }
@@ -898,10 +952,12 @@ function getFilesystemRoutingRootEffect(configFilesystemRoutingRoot, configName)
     // Eagerly loaded since it's config-only
     assert(configFilesystemRoutingRoot.valueIsLoaded);
     const { value } = configFilesystemRoutingRoot;
-    const configDefinedAt = getConfigDefinedAt('Config', configName, configFilesystemRoutingRoot.definedAtFilePath);
+    const configDefinedAt = getConfigDefinedAt('Config', configName, configFilesystemRoutingRoot.definedAt);
     assertUsage(typeof value === 'string', `${configDefinedAt} should be a string`);
     assertUsage(value.startsWith('/'), `${configDefinedAt} is ${pc.cyan(value)} but it should start with a leading slash ${pc.cyan('/')}`);
-    const { filePathAbsoluteUserRootDir } = configFilesystemRoutingRoot.definedAtFilePath;
+    const { definedAt } = configFilesystemRoutingRoot;
+    assert(!definedAt.definedBy);
+    const { filePathAbsoluteUserRootDir } = definedAt;
     assert(filePathAbsoluteUserRootDir);
     const before = getFilesystemRouteString(getLocationId(filePathAbsoluteUserRootDir));
     const after = value;
@@ -952,7 +1008,7 @@ function getConfigDefinitionOptional(configDefinitions, configName) {
     return configDefinitions[configName] ?? null;
 }
 function getConfVal(plusFile, configName) {
-    const configNames = getDefiningConfigNames(plusFile);
+    const configNames = getConfigNamesSetByPlusFile(plusFile);
     if (!configNames.includes(configName))
         return null;
     if (plusFile.isNotLoaded)

package/dist/esm/node/plugin/plugins/previewConfig.js

@@ -6,6 +6,8 @@ import { addSsrMiddleware } from '../shared/addSsrMiddleware.js';
 import pc from '@brillout/picocolors';
 import { logDockerHint } from './devConfig/index.js';
 import { getOutDirs, resolveOutDir } from '../shared/getOutDirs.js';
+import sirv from 'sirv';
+import { resolvePrerenderConfigGlobal } from '../../prerender/resolvePrerenderConfig.js';
 function previewConfig() {
     let config;
     // let vikeConfig: VikeConfigObject
@@ -32,23 +34,26 @@ function previewConfig() {
             */
             return () => {
                 assertDist();
-                /* We don't use this condition (we wrongfully always use the SSR middleware) because of the regression introduced by https://github.com/vitejs/vite/pull/14756 which stops servering .html files when `appType: 'custom'`.
-                if (!vikeConfig.global.config.prerender || vikeConfig.global.config.prerender.partial) {
-                  addSsrMiddleware(server.middlewares, config, true)
+                // We cannot re-use Vite's static middleware: https://github.com/vitejs/vite/pull/14836#issuecomment-1788540300
+                addStaticAssetsMiddleware(server.middlewares);
+                const prerenderConfigGlobal = resolvePrerenderConfigGlobal(config._vikeConfigObject);
+                if (!prerenderConfigGlobal.isPrerenderingEnabledForAllPages) {
+                    addSsrMiddleware(server.middlewares, config, true, prerenderConfigGlobal.isPrerenderingEnabled);
                 }
-                /*/
-                addSsrMiddleware(server.middlewares, config, true);
-                //*/
                 addStatic404Middleware(server.middlewares);
             };
         }
     };
     function assertDist() {
-        let { outDirRoot, outDirClient, outDirServer } = getOutDirs(config);
+        const { outDirRoot, outDirClient, outDirServer } = getOutDirs(config);
         [outDirRoot, outDirClient, outDirServer].forEach((outDirAny) => {
             assertUsage(fs.existsSync(outDirAny), `Cannot run ${pc.cyan('$ vike preview')}: your app isn't built (the build directory ${pc.cyan(outDirAny)} is missing). Make sure to run ${pc.cyan('$ vike build')} before running ${pc.cyan('$ vike preview')}.`);
         });
     }
+    function addStaticAssetsMiddleware(middlewares) {
+        const { outDirClient } = getOutDirs(config);
+        middlewares.use(sirv(outDirClient));
+    }
     function addStatic404Middleware(middlewares) {
         const { outDirClient } = getOutDirs(config);
         middlewares.use(config.base, (_, res, next) => {

package/dist/esm/node/plugin/plugins/setGlobalContext.js

@@ -1,15 +1,23 @@
 export { setGlobalContext };
 import { setGlobalContext_viteDevServer, setGlobalContext_viteConfig, setGlobalContext_isProduction } from '../../runtime/globalContext.js';
-import { assertFilePathAbsoluteFilesystem, isDevCheck, markSetup_isViteDev, markSetup_viteDevServer, markSetup_vitePreviewServer } from '../utils.js';
+import { assert, assertFilePathAbsoluteFilesystem, isDevCheck, markSetup_isViteDev, markSetup_viteDevServer, markSetup_vitePreviewServer } from '../utils.js';
 import { getOutDirs } from '../shared/getOutDirs.js';
+import { reloadVikeConfig } from './importUserCode/v1-design/getVikeConfig.js';
 function setGlobalContext() {
+    let isServerReload = false;
+    let config;
     return [
         {
             name: 'vike:setGlobalContext:pre',
             enforce: 'pre',
+            // This hook is called not only at server start but also at server restart (a new `viteDevServer` instance is created)
             configureServer: {
                 order: 'pre',
                 handler(viteDevServer) {
+                    assert(config);
+                    if (isServerReload)
+                        reloadVikeConfig(config);
+                    isServerReload = true;
                     setGlobalContext_viteDevServer(viteDevServer);
                     markSetup_viteDevServer();
                 }
@@ -31,7 +39,8 @@ function setGlobalContext() {
             enforce: 'post',
             configResolved: {
                 order: 'post',
-                async handler(config) {
+                async handler(config_) {
+                    config = config_;
                     const { outDirRoot } = getOutDirs(config);
                     assertFilePathAbsoluteFilesystem(outDirRoot); // Needed for `importServerProductionEntry({ outDir })` of @brillout/vite-plugin-server-entry
                     setGlobalContext_viteConfig(config, outDirRoot);

package/dist/esm/node/plugin/shared/addSsrMiddleware.d.ts

@@ -1,4 +1,4 @@
 export { addSsrMiddleware };
 import type { ResolvedConfig, ViteDevServer } from 'vite';
 type ConnectServer = ViteDevServer['middlewares'];
-declare function addSsrMiddleware(middlewares: ConnectServer, config: ResolvedConfig, isPreview: boolean): void;
+declare function addSsrMiddleware(middlewares: ConnectServer, config: ResolvedConfig, isPreview: boolean, isPrerenderingEnabled: boolean | null): void;

package/dist/esm/node/plugin/shared/addSsrMiddleware.js

@@ -2,7 +2,7 @@ export { addSsrMiddleware };
 import { renderPage } from '../../runtime/renderPage.js';
 import { assertWarning } from '../utils.js';
 import pc from '@brillout/picocolors';
-function addSsrMiddleware(middlewares, config, isPreview) {
+function addSsrMiddleware(middlewares, config, isPreview, isPrerenderingEnabled) {
     middlewares.use(async (req, res, next) => {
         if (res.headersSent)
             return next();
@@ -37,6 +37,10 @@ function addSsrMiddleware(middlewares, config, isPreview) {
             // - We purposely don't use next(err) to align behavior: we use our own/copied implementation of buildErrorMessage() regardless of whether the user uses Vite's dev middleware or Vite's standalone dev server
             return next();
         }
+        if (pageContext.httpResponse.statusCode === 404 && isPreview && isPrerenderingEnabled) {
+            // Serve /dist/client/404.html instead
+            return next();
+        }
         const configHeaders = (isPreview && config?.preview?.headers) || config?.server?.headers;
         if (configHeaders) {
             for (const [name, value] of Object.entries(configHeaders))

package/dist/esm/node/plugin/shared/getEnvVarObject.d.ts

@@ -1,2 +1,4 @@
 export { getEnvVarObject };
-declare function getEnvVarObject(envVarName: 'VITE_CONFIG' | 'VIKE_CRAWL'): null | Record<string, unknown>;
+export { parseJson5 };
+declare function getEnvVarObject(envVarName: 'VITE_CONFIG' | 'VIKE_CRAWL' | 'VIKE_CONFIG'): null | Record<string, unknown>;
+declare function parseJson5(valueStr: string, what: string): unknown;