vike 0.4.230 → 0.4.231

package/dist/cjs/node/api/build.js

@@ -17,6 +17,7 @@ async function build(options = {}) {
     if (viteConfigFromUserEnhanced)
         viteConfigFromUserEnhanced._viteConfigFromUserEnhanced = viteConfigFromUserEnhanced;
     if (vikeConfig.global.config.vite6BuilderApp) {
+        // This assertion isn't reliable: the user may still use a Vite version older than 6.0.0 — see https://github.com/vitejs/vite/pull/19355
         (0, utils_js_1.assertVersion)('Vite', vite_1.version, '6.0.0');
         const builder = await (0, vite_1.createBuilder)(viteConfigFromUserEnhanced);
         // See Vite plugin vike:build:pluginBuildApp

package/dist/cjs/node/plugin/onLoad.js

@@ -11,6 +11,8 @@ function onLoad() {
     (0, assertIsNotBrowser_js_1.assertIsNotBrowser)();
     (0, assertNodeVersion_js_1.assertNodeVersion)();
     // package.json#peerDependencies isn't enough as users often ignore it
+    // This assertion isn't reliable: the user may still use a Vite version older than 5.1.0 — see https://github.com/vitejs/vite/pull/19355
+    // TO-DO/soon: let's also use this.meta.viteVersion https://github.com/vitejs/vite/pull/20088
     (0, assertVersion_js_1.assertVersion)('Vite', vite_1.version, '5.1.0');
     // Ensure we don't bloat the server runtime with heavy dependencies such Vite and esbuild
     (0, assertSetup_js_1.assertIsNotProductionRuntime)();

package/dist/cjs/node/plugin/plugins/build/pluginDistFileNames.js

@@ -52,6 +52,7 @@ function pluginDistFileNames() {
                             }
                         }
                         // Disable CSS bundling to workaround https://github.com/vikejs/vike/issues/1815
+                        // TO-DO/eventually: let's bundle CSS again once Rolldown replaces Rollup
                         if (id.endsWith('.css')) {
                             const userRootDir = config.root;
                             if (id.startsWith(userRootDir)) {

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

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertExtensionsConventions = assertExtensionsConventions;
 exports.assertExtensionsRequire = assertExtensionsRequire;
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-const isObjectOfStrings_js_1 = require("../../../../../../utils/isObjectOfStrings.js");
 const utils_js_1 = require("../../../../utils.js");
 const getVikeConfig_js_1 = require("../getVikeConfig.js");
 const path_1 = __importDefault(require("path"));
@@ -33,8 +32,8 @@ function assertExtensionName(plusFile) {
     const name = getNameValue(plusFile);
     (0, utils_js_1.assertUsage)(name, `Vike extension name missing: the config ${filePathToShowToUser} must define the setting ${picocolors_1.default.cyan('name')}`);
 }
-function assertExtensionsRequire(pageConfig) {
-    const plusFilesRelevantList = pageConfig.plusFiles;
+function assertExtensionsRequire(plusFiles) {
+    const plusFilesRelevantList = plusFiles;
     // Collect extensions
     const extensions = {};
     plusFilesRelevantList.forEach((plusFile) => {
@@ -46,34 +45,57 @@ function assertExtensionsRequire(pageConfig) {
     });
     // Enforce `require`
     plusFilesRelevantList.forEach((plusFile) => {
-        const require = getConfigRequireValue(plusFile);
+        const require = resolveRequireSetting(plusFile);
         if (!require)
             return;
         const name = getNameValue(plusFile);
         const filePathToShowToUser = getFilePathToShowToUser(plusFile);
         (0, utils_js_1.assertUsage)(name, `Setting ${picocolors_1.default.bold('name')} is required for being able to use setting ${picocolors_1.default.bold('require')} in ${filePathToShowToUser}.`);
-        Object.entries(require).forEach(([reqName, reqVersion]) => {
+        Object.entries(require).forEach(([reqName, req]) => {
             const errBase = `${picocolors_1.default.bold(name)} requires ${picocolors_1.default.bold(reqName)}`;
             if (reqName === 'vike') {
-                (0, utils_js_1.assertUsage)(isVersionRange(utils_js_1.PROJECT_VERSION, reqVersion), `${errBase} version ${picocolors_1.default.bold(reqVersion)}, but ${picocolors_1.default.bold(utils_js_1.PROJECT_VERSION)} is installed.`);
+                let errMsg = `${errBase} version ${picocolors_1.default.bold(req.version)}, but ${picocolors_1.default.bold(utils_js_1.PROJECT_VERSION)} is installed.`;
+                if (req.optional) {
+                    errMsg += " Either update it, or remove it (it's an optional peer dependency).";
+                }
+                (0, utils_js_1.assertUsage)(isVersionRange(utils_js_1.PROJECT_VERSION, req.version), errMsg);
                 return;
             }
             const extensionVersion = extensions[reqName];
-            (0, utils_js_1.assertUsage)(extensionVersion, `${errBase}.`);
-            (0, utils_js_1.assertUsage)(isVersionRange(extensionVersion, reqVersion), `${errBase} version ${picocolors_1.default.bold(reqVersion)}, but ${picocolors_1.default.bold(extensionVersion)} is installed.`);
+            if (!extensionVersion) {
+                if (req.optional) {
+                    return;
+                }
+                else {
+                    (0, utils_js_1.assertUsage)(false, `${errBase}.`);
+                }
+            }
+            (0, utils_js_1.assertUsage)(isVersionRange(extensionVersion, req.version), `${errBase} version ${picocolors_1.default.bold(req.version)}, but ${picocolors_1.default.bold(extensionVersion)} is installed.`);
         });
     });
 }
-function getConfigRequireValue(plusFile) {
+function resolveRequireSetting(plusFile) {
     const confVal = (0, getVikeConfig_js_1.getConfVal)(plusFile, 'require');
     if (!confVal)
         return null;
     (0, utils_js_1.assert)(confVal.valueIsLoaded);
-    const require = confVal.value;
+    const requireValue = confVal.value;
     const { filePathToShowToUserResolved } = plusFile.filePath;
     (0, utils_js_1.assert)(filePathToShowToUserResolved);
-    (0, utils_js_1.assertUsage)((0, isObjectOfStrings_js_1.isObjectOfStrings)(require), `The setting ${picocolors_1.default.bold('require')} defined at ${filePathToShowToUserResolved} should be an object with string values (${picocolors_1.default.bold('Record<string, string>')}).`);
-    return require;
+    (0, utils_js_1.assertUsage)((0, utils_js_1.isObject)(requireValue), `The setting ${picocolors_1.default.bold('+require')} defined at ${filePathToShowToUserResolved} should be an object`);
+    const requireSetting = {};
+    Object.entries(requireValue).forEach(([reqName, req]) => {
+        if (typeof req === 'string') {
+            requireSetting[reqName] = { version: req, optional: false };
+            return;
+        }
+        if ((0, utils_js_1.isObject)(req)) {
+            requireSetting[reqName] = req;
+            return;
+        }
+        (0, utils_js_1.assertUsage)(false, `Invalid +require[${JSON.stringify(reqName)}] value ${picocolors_1.default.cyan(JSON.stringify(req))}`);
+    });
+    return requireSetting;
 }
 function getNameValue(plusFile) {
     const confVal = (0, getVikeConfig_js_1.getConfVal)(plusFile, 'name');

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

@@ -82,8 +82,14 @@ async function getPlusFilesAll(userRootDir, esbuildCache) {
     Object.entries(plusFilesAll).forEach(([_locationId, plusFiles]) => {
         plusFiles.sort(sortMakeDeterministic);
     });
+    assertPlusFiles(plusFilesAll);
     return plusFilesAll;
 }
+function assertPlusFiles(plusFilesAll) {
+    const plusFiles = Object.values(plusFilesAll).flat();
+    // The earlier we call it the better, so that +require can be used by Vike extensions to depend on new Vike features
+    (0, assertExtensions_js_1.assertExtensionsRequire)(plusFiles);
+}
 function getPlusFileFromConfigFile(configFile, isExtensionConfig, locationId, userRootDir) {
     const { fileExports, filePath, extendsFilePaths } = configFile;
     const fileExportsByConfigName = {};

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

@@ -25,7 +25,6 @@ const loadFileAtConfigTime_js_1 = require("./getVikeConfig/loadFileAtConfigTime.
 const resolvePointerImport_js_1 = require("./getVikeConfig/resolvePointerImport.js");
 const getFilePath_js_1 = require("../../../shared/getFilePath.js");
 const getConfigValueBuildTime_js_1 = require("../../../../../shared/page-configs/getConfigValueBuildTime.js");
-const assertExtensions_js_1 = require("./getVikeConfig/assertExtensions.js");
 const getUserFriendlyConfigs_js_1 = require("../../../../../shared/page-configs/getUserFriendlyConfigs.js");
 const serializeConfigValues_js_1 = require("../../../../../shared/page-configs/serialize/serializeConfigValues.js");
 const getPlusFilesAll_js_1 = require("./getVikeConfig/getPlusFilesAll.js");
@@ -327,7 +326,6 @@ function assertGlobalConfigLocation(configName, sources, plusFilesAll, configDef
 }
 function assertPageConfigs(pageConfigs) {
     pageConfigs.forEach((pageConfig) => {
-        (0, assertExtensions_js_1.assertExtensionsRequire)(pageConfig);
         assertOnBeforeRenderEnv(pageConfig);
     });
 }
@@ -710,6 +708,8 @@ function getConfigDefinitions(plusFilesRelevant, filter) {
         assertMetaUsage(meta, `Config ${picocolors_1.default.cyan('meta')} defined at ${plusFile.filePath.filePathToShowToUser}`);
         // Set configDef._userEffectDefinedAtFilePath
         Object.entries(meta).forEach(([configName, configDef]) => {
+            if ('isDefinedByPeerDependency' in configDef)
+                return;
             if (!configDef.effect)
                 return;
             (0, utils_js_1.assert)(plusFile.isConfigFile);
@@ -719,6 +719,12 @@ function getConfigDefinitions(plusFilesRelevant, filter) {
             };
         });
         (0, utils_js_1.objectEntries)(meta).forEach(([configName, configDefinitionUserLand]) => {
+            if ('isDefinedByPeerDependency' in configDefinitionUserLand) {
+                configDefinitionUserLand = {
+                    env: { client: false, server: false, config: false },
+                    ...configDefinitionUserLand
+                };
+            }
             // User can override an existing config definition
             configDefinitions[configName] = {
                 ...configDefinitions[configName],
@@ -741,6 +747,8 @@ function assertMetaUsage(metaVal, metaConfigDefinedAt) {
             (0, utils_js_1.assert)(metaConfigDefinedAt); // We expect internal effects to return a valid meta value
             (0, utils_js_1.assertUsage)(false, `${metaConfigDefinedAt} sets ${picocolors_1.default.cyan(`meta.${configName}`)} to a value with an invalid type ${picocolors_1.default.cyan(typeof def)}: it should be an object instead.`);
         }
+        if (def.isDefinedByPeerDependency)
+            return;
         // env
         let configEnv;
         {
@@ -851,6 +859,7 @@ function applyEffectMetaEnv(configModFromEffect, configValueSources, configDefEf
         }
         assertMetaUsage(configValue, configDefinedAt);
         (0, utils_js_1.objectEntries)(configValue).forEach(([configTargetName, configTargetDef]) => {
+            (0, utils_js_1.assert)(!('isDefinedByPeerDependency' in configTargetDef));
             {
                 const keys = Object.keys(configTargetDef);
                 (0, utils_js_1.assertUsage)(keys.includes('env'), notSupported);

package/dist/cjs/node/runtime/html/serializeContext.js

@@ -71,7 +71,9 @@ function serializeObject(obj, objName, passToClient) {
                     if ((0, stringify_1.isJsonSerializerError)(err)) {
                         pathString = err.pathString;
                     }
-                    (0, utils_js_1.assertUsage)(false, `Cannot serialize config ${h(pathString)} set by useConfig(), see https://vike.dev/useConfig#serialization-error`);
+                    // There used to be a `## Serialization Error` section in the docs but we removed it at:
+                    // https://github.com/vikejs/vike/commit/c9da2f577db01bd1c8f72265ff83e78484ddc2c0
+                    (0, utils_js_1.assertUsage)(false, `Cannot serialize config value ${h(pathString)} set by useConfig()`);
                 }
                 // Non-serializable property set by the user
                 let msg = [

package/dist/cjs/node/runtime/renderPage/getHttpResponseBody.js

@@ -105,7 +105,7 @@ function getHttpResponseBodyStreamHandlers(htmlRender, renderHook) {
         (0, utils_js_1.assert)(['a ', 'an ', 'the '].some((s) => streamName.startsWith(s)));
         (0, utils_js_1.assert)(renderHook);
         const { hookFilePath, hookName } = renderHook;
-        return `Make sure the ${hookName}() defined by ${hookFilePath} hook provides ${streamName} instead`;
+        return `Make sure the ${hookName}() hook defined by ${hookFilePath} provides ${streamName} instead`;
     }
 }
 function getErrMsg(htmlRender, renderHook, method, msgAddendum) {

package/dist/cjs/utils/PROJECT_VERSION.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROJECT_VERSION = void 0;
 // Automatically updated by @brillout/release-me
-exports.PROJECT_VERSION = '0.4.230';
+exports.PROJECT_VERSION = '0.4.231';

package/dist/cjs/utils/isDev.js

@@ -6,7 +6,9 @@ exports.applyPreview = applyPreview;
 const assert_js_1 = require("./assert.js");
 function isDevCheck(configEnv) {
     const { isPreview, command } = configEnv;
-    // `assertVersion('Vite', version, '5.1.0')` isn't enough: https://github.com/vitejs/vite/pull/19355
+    // Note that:
+    // - `assertVersion('Vite', version, '5.1.0')` at node/plugin/onLoad.ts isn't enough: https://github.com/vitejs/vite/pull/19355
+    // - We'll eventually be able to make this an assert() instead of assertUsage() once Vike requires a Vite version that supports this.meta.viteVersion
     (0, assert_js_1.assertUsage)(typeof isPreview === 'boolean', 'You are using an old Vite version; make sure to use Vite 5.1.0 or above.');
     return command === 'serve' && !isPreview;
 }

package/dist/esm/node/api/build.js

@@ -15,6 +15,7 @@ async function build(options = {}) {
     if (viteConfigFromUserEnhanced)
         viteConfigFromUserEnhanced._viteConfigFromUserEnhanced = viteConfigFromUserEnhanced;
     if (vikeConfig.global.config.vite6BuilderApp) {
+        // This assertion isn't reliable: the user may still use a Vite version older than 6.0.0 — see https://github.com/vitejs/vite/pull/19355
         assertVersion('Vite', version, '6.0.0');
         const builder = await createBuilder(viteConfigFromUserEnhanced);
         // See Vite plugin vike:build:pluginBuildApp

package/dist/esm/node/plugin/onLoad.js

@@ -9,6 +9,8 @@ function onLoad() {
     assertIsNotBrowser();
     assertNodeVersion();
     // package.json#peerDependencies isn't enough as users often ignore it
+    // This assertion isn't reliable: the user may still use a Vite version older than 5.1.0 — see https://github.com/vitejs/vite/pull/19355
+    // TO-DO/soon: let's also use this.meta.viteVersion https://github.com/vitejs/vite/pull/20088
     assertVersion('Vite', version, '5.1.0');
     // Ensure we don't bloat the server runtime with heavy dependencies such Vite and esbuild
     assertIsNotProductionRuntime();

package/dist/esm/node/plugin/plugins/build/pluginDistFileNames.js

@@ -47,6 +47,7 @@ function pluginDistFileNames() {
                             }
                         }
                         // Disable CSS bundling to workaround https://github.com/vikejs/vike/issues/1815
+                        // TO-DO/eventually: let's bundle CSS again once Rolldown replaces Rollup
                         if (id.endsWith('.css')) {
                             const userRootDir = config.root;
                             if (id.startsWith(userRootDir)) {

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getVikeConfig/assertExtensions.d.ts

@@ -1,6 +1,5 @@
 export { assertExtensionsConventions };
 export { assertExtensionsRequire };
 import type { PlusFile } from './getPlusFilesAll.js';
-import { PageConfigBuildTime } from '../../../../../../shared/page-configs/PageConfig.js';
 declare function assertExtensionsConventions(plusFile: PlusFile): void;
-declare function assertExtensionsRequire(pageConfig: PageConfigBuildTime): void;
+declare function assertExtensionsRequire(plusFiles: PlusFile[]): void;

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

@@ -1,8 +1,7 @@
 export { assertExtensionsConventions };
 export { assertExtensionsRequire };
 import pc from '@brillout/picocolors';
-import { isObjectOfStrings } from '../../../../../../utils/isObjectOfStrings.js';
-import { PROJECT_VERSION, assert, assertUsage, assertWarning, findPackageJson } from '../../../../utils.js';
+import { PROJECT_VERSION, assert, assertUsage, assertWarning, findPackageJson, isObject } from '../../../../utils.js';
 import { getConfVal } from '../getVikeConfig.js';
 import path from 'path';
 import semver from 'semver';
@@ -28,8 +27,8 @@ function assertExtensionName(plusFile) {
     const name = getNameValue(plusFile);
     assertUsage(name, `Vike extension name missing: the config ${filePathToShowToUser} must define the setting ${pc.cyan('name')}`);
 }
-function assertExtensionsRequire(pageConfig) {
-    const plusFilesRelevantList = pageConfig.plusFiles;
+function assertExtensionsRequire(plusFiles) {
+    const plusFilesRelevantList = plusFiles;
     // Collect extensions
     const extensions = {};
     plusFilesRelevantList.forEach((plusFile) => {
@@ -41,34 +40,57 @@ function assertExtensionsRequire(pageConfig) {
     });
     // Enforce `require`
     plusFilesRelevantList.forEach((plusFile) => {
-        const require = getConfigRequireValue(plusFile);
+        const require = resolveRequireSetting(plusFile);
         if (!require)
             return;
         const name = getNameValue(plusFile);
         const filePathToShowToUser = getFilePathToShowToUser(plusFile);
         assertUsage(name, `Setting ${pc.bold('name')} is required for being able to use setting ${pc.bold('require')} in ${filePathToShowToUser}.`);
-        Object.entries(require).forEach(([reqName, reqVersion]) => {
+        Object.entries(require).forEach(([reqName, req]) => {
             const errBase = `${pc.bold(name)} requires ${pc.bold(reqName)}`;
             if (reqName === 'vike') {
-                assertUsage(isVersionRange(PROJECT_VERSION, reqVersion), `${errBase} version ${pc.bold(reqVersion)}, but ${pc.bold(PROJECT_VERSION)} is installed.`);
+                let errMsg = `${errBase} version ${pc.bold(req.version)}, but ${pc.bold(PROJECT_VERSION)} is installed.`;
+                if (req.optional) {
+                    errMsg += " Either update it, or remove it (it's an optional peer dependency).";
+                }
+                assertUsage(isVersionRange(PROJECT_VERSION, req.version), errMsg);
                 return;
             }
             const extensionVersion = extensions[reqName];
-            assertUsage(extensionVersion, `${errBase}.`);
-            assertUsage(isVersionRange(extensionVersion, reqVersion), `${errBase} version ${pc.bold(reqVersion)}, but ${pc.bold(extensionVersion)} is installed.`);
+            if (!extensionVersion) {
+                if (req.optional) {
+                    return;
+                }
+                else {
+                    assertUsage(false, `${errBase}.`);
+                }
+            }
+            assertUsage(isVersionRange(extensionVersion, req.version), `${errBase} version ${pc.bold(req.version)}, but ${pc.bold(extensionVersion)} is installed.`);
         });
     });
 }
-function getConfigRequireValue(plusFile) {
+function resolveRequireSetting(plusFile) {
     const confVal = getConfVal(plusFile, 'require');
     if (!confVal)
         return null;
     assert(confVal.valueIsLoaded);
-    const require = confVal.value;
+    const requireValue = confVal.value;
     const { filePathToShowToUserResolved } = plusFile.filePath;
     assert(filePathToShowToUserResolved);
-    assertUsage(isObjectOfStrings(require), `The setting ${pc.bold('require')} defined at ${filePathToShowToUserResolved} should be an object with string values (${pc.bold('Record<string, string>')}).`);
-    return require;
+    assertUsage(isObject(requireValue), `The setting ${pc.bold('+require')} defined at ${filePathToShowToUserResolved} should be an object`);
+    const requireSetting = {};
+    Object.entries(requireValue).forEach(([reqName, req]) => {
+        if (typeof req === 'string') {
+            requireSetting[reqName] = { version: req, optional: false };
+            return;
+        }
+        if (isObject(req)) {
+            requireSetting[reqName] = req;
+            return;
+        }
+        assertUsage(false, `Invalid +require[${JSON.stringify(reqName)}] value ${pc.cyan(JSON.stringify(req))}`);
+    });
+    return requireSetting;
 }
 function getNameValue(plusFile) {
     const confVal = getConfVal(plusFile, 'name');

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.d.ts

@@ -1,6 +1,7 @@
 export { configDefinitionsBuiltIn };
 export type { ConfigDefinition };
 export type { ConfigDefinitions };
+export type { ConfigDefinitionsInternal };
 export type { ConfigDefinitionInternal };
 export type { ConfigEffect };
 import type { ConfigEnvInternal, ConfigEnv, ConfigValueSources, DefinedAtFilePath } from '../../../../../../shared/page-configs/PageConfig.js';
@@ -10,7 +11,8 @@ import { type ConfigDefinedAt } from '../../../../../../shared/page-configs/getC
  *
  * https://vike.dev/meta
  */
-type ConfigDefinition = {
+type ConfigDefinition = ConfigDefinition_ | ConfigDefinitionDefinedByPeerDependency;
+type ConfigDefinition_ = {
     /** In what environment(s) the config value is loaded.
      *
      * https://vike.dev/meta
@@ -49,6 +51,12 @@ type ConfigDefinition = {
     }) => boolean);
     type?: string | string[];
 };
+type ConfigDefinitionDefinedByPeerDependency = {
+    /**
+     * Omit the "unknown config" error without defining the config — useful for optional peer dependencies: for example, vike-server sets +stream.require which is defined by vike-{react,vue,solid} but some users don't use vike-{react,vue,solid}
+     */
+    isDefinedByPeerDependency: true;
+};
 /**
  * Function called when the config value is defined.
  *
@@ -67,13 +75,15 @@ type ConfigEffect = (config: {
     configDefinedAt: ConfigDefinedAt;
 }) => Config | undefined;
 /** For Vike internal use */
-type ConfigDefinitionInternal = Omit<ConfigDefinition, 'env'> & {
+type ConfigDefinitionInternal = Omit<ConfigDefinition_, 'env'> & {
     _computed?: (configValueSources: ConfigValueSources) => unknown;
     _valueIsFilePath?: true;
     _userEffectDefinedAtFilePath?: DefinedAtFilePath;
     env: ConfigEnvInternal;
 };
 type ConfigDefinitions = Record<string, // configName
+ConfigDefinition>;
+type ConfigDefinitionsInternal = Record<string, // configName
 ConfigDefinitionInternal>;
 type ConfigDefinitionsBuiltIn = Record<ConfigNameBuiltIn | ConfigNameGlobal, ConfigDefinitionInternal>;
 declare const configDefinitionsBuiltIn: ConfigDefinitionsBuiltIn;

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

@@ -7,7 +7,7 @@ import { getConfigFileExport } from './getConfigFileExport.js';
 import { loadConfigFile, loadValueFile } from './loadFileAtConfigTime.js';
 import { resolvePointerImport } from './resolvePointerImport.js';
 import { getFilePathResolved } from '../../../../shared/getFilePath.js';
-import { assertExtensionsConventions } from './assertExtensions.js';
+import { assertExtensionsConventions, assertExtensionsRequire } from './assertExtensions.js';
 async function getPlusFilesAll(userRootDir, esbuildCache) {
     const plusFiles = await findPlusFiles(userRootDir);
     const configFiles = [];
@@ -80,8 +80,14 @@ async function getPlusFilesAll(userRootDir, esbuildCache) {
     Object.entries(plusFilesAll).forEach(([_locationId, plusFiles]) => {
         plusFiles.sort(sortMakeDeterministic);
     });
+    assertPlusFiles(plusFilesAll);
     return plusFilesAll;
 }
+function assertPlusFiles(plusFilesAll) {
+    const plusFiles = Object.values(plusFilesAll).flat();
+    // The earlier we call it the better, so that +require can be used by Vike extensions to depend on new Vike features
+    assertExtensionsRequire(plusFiles);
+}
 function getPlusFileFromConfigFile(configFile, isExtensionConfig, locationId, userRootDir) {
     const { fileExports, filePath, extendsFilePaths } = configFile;
     const fileExportsByConfigName = {};

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getVikeConfig/loadFileAtConfigTime.d.ts

@@ -7,20 +7,20 @@ import type { FilePathResolved } from '../../../../../../shared/page-configs/Fil
 import { type EsbuildCache } from './transpileAndExecuteFile.js';
 import type { PlusFileValue } from './getPlusFilesAll.js';
 import { PointerImport } from './resolvePointerImport.js';
-import type { ConfigDefinitions } from './configDefinitionsBuiltIn.js';
+import type { ConfigDefinitionsInternal } from './configDefinitionsBuiltIn.js';
 type ConfigFile = {
     fileExports: Record<string, unknown>;
     filePath: FilePathResolved;
     extendsFilePaths: string[];
 };
-declare function loadPointerImport(pointerImport: PointerImportLoaded, userRootDir: string, configName: string, configDefinitions: ConfigDefinitions, esbuildCache: EsbuildCache): Promise<unknown>;
+declare function loadPointerImport(pointerImport: PointerImportLoaded, userRootDir: string, configName: string, configDefinitions: ConfigDefinitionsInternal, esbuildCache: EsbuildCache): Promise<unknown>;
 type PointerImportLoaded = PointerImport & ({
     fileExportValueLoaded: true;
     fileExportValue: unknown;
 } | {
     fileExportValueLoaded: false;
 });
-declare function loadValueFile(interfaceValueFile: PlusFileValue, configDefinitions: ConfigDefinitions, userRootDir: string, esbuildCache: EsbuildCache): Promise<void>;
+declare function loadValueFile(interfaceValueFile: PlusFileValue, configDefinitions: ConfigDefinitionsInternal, userRootDir: string, esbuildCache: EsbuildCache): Promise<void>;
 declare function loadConfigFile(configFilePath: FilePathResolved, userRootDir: string, visited: string[], isExtensionConfig: boolean, esbuildCache: EsbuildCache): Promise<{
     configFile: ConfigFile;
     extendsConfigs: ConfigFile[];

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

@@ -9,7 +9,7 @@ export { getVikeConfigFromCliOrEnv };
 export { isOverriden };
 export type { VikeConfigObject };
 import type { PageConfigGlobalBuildTime, ConfigValueSource, PageConfigBuildTime } from '../../../../../shared/page-configs/PageConfig.js';
-import { type ConfigDefinitions, type ConfigDefinitionInternal } from './getVikeConfig/configDefinitionsBuiltIn.js';
+import { type ConfigDefinitionsInternal, type ConfigDefinitionInternal } from './getVikeConfig/configDefinitionsBuiltIn.js';
 import type { ResolvedConfig, UserConfig } from 'vite';
 import { type PageConfigUserFriendly, type PageConfigsUserFriendly } from '../../../../../shared/page-configs/getUserFriendlyConfigs.js';
 import { type PlusFile } from './getVikeConfig/getPlusFilesAll.js';
@@ -34,7 +34,7 @@ declare function getVikeConfigFromCliOrEnv(): {
     configFromCliOptions: import("../../../../cli/parseCli.js").CliOptions | null;
     configFromEnvVar: Record<string, unknown> | null;
 };
-declare function getConfigDefinitionOptional(configDefinitions: ConfigDefinitions, configName: string): ConfigDefinitionInternal | null;
+declare function getConfigDefinitionOptional(configDefinitions: ConfigDefinitionsInternal, configName: string): ConfigDefinitionInternal | null;
 declare function getConfVal(plusFile: PlusFile, configName: string): null | {
     value: unknown;
     valueIsLoaded: true;

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

@@ -20,7 +20,6 @@ import { loadPointerImport, loadValueFile } from './getVikeConfig/loadFileAtConf
 import { resolvePointerImport } from './getVikeConfig/resolvePointerImport.js';
 import { getFilePathResolved } from '../../../shared/getFilePath.js';
 import { getConfigValueBuildTime } from '../../../../../shared/page-configs/getConfigValueBuildTime.js';
-import { assertExtensionsRequire } from './getVikeConfig/assertExtensions.js';
 import { getUserFriendlyConfigsGlobal, getUserFriendlyConfigsPageEager } from '../../../../../shared/page-configs/getUserFriendlyConfigs.js';
 import { getConfigValuesBase, isJsonValue } from '../../../../../shared/page-configs/serialize/serializeConfigValues.js';
 import { getPlusFilesAll } from './getVikeConfig/getPlusFilesAll.js';
@@ -322,7 +321,6 @@ function assertGlobalConfigLocation(configName, sources, plusFilesAll, configDef
 }
 function assertPageConfigs(pageConfigs) {
     pageConfigs.forEach((pageConfig) => {
-        assertExtensionsRequire(pageConfig);
         assertOnBeforeRenderEnv(pageConfig);
     });
 }
@@ -705,6 +703,8 @@ function getConfigDefinitions(plusFilesRelevant, filter) {
         assertMetaUsage(meta, `Config ${pc.cyan('meta')} defined at ${plusFile.filePath.filePathToShowToUser}`);
         // Set configDef._userEffectDefinedAtFilePath
         Object.entries(meta).forEach(([configName, configDef]) => {
+            if ('isDefinedByPeerDependency' in configDef)
+                return;
             if (!configDef.effect)
                 return;
             assert(plusFile.isConfigFile);
@@ -714,6 +714,12 @@ function getConfigDefinitions(plusFilesRelevant, filter) {
             };
         });
         objectEntries(meta).forEach(([configName, configDefinitionUserLand]) => {
+            if ('isDefinedByPeerDependency' in configDefinitionUserLand) {
+                configDefinitionUserLand = {
+                    env: { client: false, server: false, config: false },
+                    ...configDefinitionUserLand
+                };
+            }
             // User can override an existing config definition
             configDefinitions[configName] = {
                 ...configDefinitions[configName],
@@ -736,6 +742,8 @@ function assertMetaUsage(metaVal, metaConfigDefinedAt) {
             assert(metaConfigDefinedAt); // We expect internal effects to return a valid meta value
             assertUsage(false, `${metaConfigDefinedAt} sets ${pc.cyan(`meta.${configName}`)} to a value with an invalid type ${pc.cyan(typeof def)}: it should be an object instead.`);
         }
+        if (def.isDefinedByPeerDependency)
+            return;
         // env
         let configEnv;
         {
@@ -846,6 +854,7 @@ function applyEffectMetaEnv(configModFromEffect, configValueSources, configDefEf
         }
         assertMetaUsage(configValue, configDefinedAt);
         objectEntries(configValue).forEach(([configTargetName, configTargetDef]) => {
+            assert(!('isDefinedByPeerDependency' in configTargetDef));
             {
                 const keys = Object.keys(configTargetDef);
                 assertUsage(keys.includes('env'), notSupported);

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

@@ -66,7 +66,9 @@ function serializeObject(obj, objName, passToClient) {
                     if (isJsonSerializerError(err)) {
                         pathString = err.pathString;
                     }
-                    assertUsage(false, `Cannot serialize config ${h(pathString)} set by useConfig(), see https://vike.dev/useConfig#serialization-error`);
+                    // There used to be a `## Serialization Error` section in the docs but we removed it at:
+                    // https://github.com/vikejs/vike/commit/c9da2f577db01bd1c8f72265ff83e78484ddc2c0
+                    assertUsage(false, `Cannot serialize config value ${h(pathString)} set by useConfig()`);
                 }
                 // Non-serializable property set by the user
                 let msg = [

package/dist/esm/node/runtime/renderPage/getHttpResponseBody.js

@@ -100,7 +100,7 @@ function getHttpResponseBodyStreamHandlers(htmlRender, renderHook) {
         assert(['a ', 'an ', 'the '].some((s) => streamName.startsWith(s)));
         assert(renderHook);
         const { hookFilePath, hookName } = renderHook;
-        return `Make sure the ${hookName}() defined by ${hookFilePath} hook provides ${streamName} instead`;
+        return `Make sure the ${hookName}() hook defined by ${hookFilePath} provides ${streamName} instead`;
     }
 }
 function getErrMsg(htmlRender, renderHook, method, msgAddendum) {

package/dist/esm/shared/page-configs/Config.d.ts

@@ -538,7 +538,10 @@ type ConfigBuiltIn = {
      *
      * https://vike.dev/require
      */
-    require?: Record<string, string>;
+    require?: Record<string, string | {
+        version: string;
+        optional?: boolean;
+    }>;
     /** Whether the page scrolls to the top upon navigation.
      *
      * https://vike.dev/keepScrollPosition

package/dist/esm/shared/page-configs/PageConfig.d.ts

@@ -23,7 +23,7 @@ export type { DefinedAtFilePath };
 import type { ConfigValueSerialized } from './serialize/PageConfigSerialized.js';
 import type { LocationId } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/filesystemRouting.js';
 import type { FilePath } from './FilePath.js';
-import type { ConfigDefinitions } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.js';
+import type { ConfigDefinitionsInternal } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.js';
 import type { PlusFile } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/getPlusFilesAll.js';
 import type { Operation } from '../../node/api/types.js';
 type PageConfigCommon = {
@@ -51,7 +51,7 @@ type PageConfigGlobalRuntime = {
 };
 /** Page config, build-time data structure */
 type PageConfigBuildTime = PageConfigCommon & {
-    configDefinitions: ConfigDefinitions;
+    configDefinitions: ConfigDefinitionsInternal;
     plusFiles: PlusFile[];
     configValueSources: ConfigValueSources;
     configValuesComputed: ConfigValuesComputed;
@@ -59,7 +59,7 @@ type PageConfigBuildTime = PageConfigCommon & {
 /** Global config that applies to all pages, build-time data structure */
 type PageConfigGlobalBuildTime = {
     configValueSources: ConfigValueSources;
-    configDefinitions: ConfigDefinitions;
+    configDefinitions: ConfigDefinitionsInternal;
     configValuesComputed?: undefined;
 };
 /** Same as PageConfigRuntime but also contains all lazily loaded config values such as config.Page */

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

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.230";
+export declare const PROJECT_VERSION: "0.4.231";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.230';
+export const PROJECT_VERSION = '0.4.231';

package/dist/esm/utils/isDev.js

@@ -4,7 +4,9 @@ export { applyPreview };
 import { assertUsage } from './assert.js';
 function isDevCheck(configEnv) {
     const { isPreview, command } = configEnv;
-    // `assertVersion('Vite', version, '5.1.0')` isn't enough: https://github.com/vitejs/vite/pull/19355
+    // Note that:
+    // - `assertVersion('Vite', version, '5.1.0')` at node/plugin/onLoad.ts isn't enough: https://github.com/vitejs/vite/pull/19355
+    // - We'll eventually be able to make this an assert() instead of assertUsage() once Vike requires a Vite version that supports this.meta.viteVersion
     assertUsage(typeof isPreview === 'boolean', 'You are using an old Vite version; make sure to use Vite 5.1.0 or above.');
     return command === 'serve' && !isPreview;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.230",
+  "version": "0.4.231",
   "repository": "https://github.com/vikejs/vike",
   "exports": {
     "./server": {