vike 0.4.172-commit-55d8662 → 0.4.172-commit-24e2d90

package/dist/cjs/node/plugin/plugins/devConfig/index.js

@@ -6,7 +6,7 @@ const determineFsAllowList_js_1 = require("./determineFsAllowList.js");
 const addSsrMiddleware_js_1 = require("../../shared/addSsrMiddleware.js");
 const utils_js_1 = require("../../utils.js");
 const loggerVite_js_1 = require("../../shared/loggerVite.js");
-const isErrorDebug_js_1 = require("../../shared/isErrorDebug.js");
+const isErrorDebug_js_1 = require("../../../shared/isErrorDebug.js");
 const getHttpRequestAsyncStore_js_1 = require("../../shared/getHttpRequestAsyncStore.js");
 if ((0, isErrorDebug_js_1.isErrorDebug)()) {
     Error.stackTraceLimit = Infinity;

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

@@ -3,21 +3,68 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertExtensionsPeerDependencies = void 0;
+exports.assertExtensionsPeerDependencies = exports.assertExtensionsConventions = void 0;
 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"));
 const semver_1 = __importDefault(require("semver"));
+function assertExtensionsConventions(interfaceFile) {
+    assertExtensionName(interfaceFile);
+    assertConfigExportPath(interfaceFile);
+}
+exports.assertExtensionsConventions = assertExtensionsConventions;
+function assertConfigExportPath(interfaceFile) {
+    const { importPathAbsolute } = interfaceFile.filePath;
+    (0, utils_js_1.assert)(importPathAbsolute);
+    const name = getConfigNameValue(interfaceFile);
+    (0, utils_js_1.assert)(name); // already asserted in assertExtensionName()
+    const importPathAbsoluteExpected = `${name}/config`;
+    (0, utils_js_1.assertWarning)(importPathAbsolute === importPathAbsoluteExpected, `The Vike configuration of ${picocolors_1.default.bold(name)} is exported at ${picocolors_1.default.bold(importPathAbsolute)} but it should be exported at ${picocolors_1.default.bold(importPathAbsoluteExpected)} instead.`, { onlyOnce: true });
+}
+function assertExtensionName(interfaceFile) {
+    let nameDeduced;
+    {
+        const { importPathAbsolute } = interfaceFile.filePath;
+        (0, utils_js_1.assert)(importPathAbsolute);
+        nameDeduced = importPathAbsolute
+            .split('/')
+            .slice(0, importPathAbsolute.startsWith('@') ? 2 : 1)
+            .join('/');
+    }
+    const name = getConfigNameValue(interfaceFile);
+    const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+    if (name) {
+        (0, utils_js_1.assertWarning)(name === nameDeduced, `The setting ${picocolors_1.default.bold('name')} defined at ${filePathToShowToUser} is ${picocolors_1.default.bold(name)} but it should be ${picocolors_1.default.bold(nameDeduced)} instead (the name of the npm package).`, { onlyOnce: true });
+    }
+    else {
+        if (
+        // Let's eventually remove this
+        [
+            'vike-react',
+            'vike-react-query',
+            'vike-react-zustand',
+            'vike-vue',
+            'vike-vue-query',
+            'vike-vue-pinia',
+            'vike-pinia',
+            'vike-solid'
+        ].includes(nameDeduced)) {
+            (0, utils_js_1.assertUsage)(false, `Update ${nameDeduced} to its latest version.`);
+        }
+        else {
+            (0, utils_js_1.assertUsage)(false, `The setting ${picocolors_1.default.bold('name')} is missing: it should be set by the config ${filePathToShowToUser} of ${picocolors_1.default.bold(nameDeduced)}.`);
+        }
+    }
+}
 function assertExtensionsPeerDependencies(interfaceFilesRelevantList) {
     // Get installed extensions
     const extensions = {};
     interfaceFilesRelevantList.forEach((interfaceFile) => {
         const name = getConfigNameValue(interfaceFile);
         if (name) {
-            const extensionConfigFilePath = interfaceFile.filePath.filePathAbsoluteFilesystem;
-            const version = getExtensionVersion(extensionConfigFilePath, name);
+            const version = getExtensionVersion(name, interfaceFile);
             extensions[name] = version;
         }
     });
@@ -27,13 +74,16 @@ function assertExtensionsPeerDependencies(interfaceFilesRelevantList) {
         if (!require)
             return;
         const name = getConfigNameValue(interfaceFile);
-        // TODO: unify assertUsage()?
-        (0, utils_js_1.assertUsage)(name, `Setting ${picocolors_1.default.bold('name')} is required when using setting ${picocolors_1.default.bold('require')}.`);
+        const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+        (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]) => {
+            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.`);
+            }
             const extensionVersion = extensions[reqName];
-            const errBase = `The Vike extension ${picocolors_1.default.bold(name)} requires ${picocolors_1.default.bold(reqName)}`;
             (0, utils_js_1.assertUsage)(extensionVersion, `${errBase}.`);
-            (0, utils_js_1.assertUsage)(semver_1.default.satisfies(extensionVersion, reqVersion), `${errBase} version ${picocolors_1.default.bold(reqVersion)} but ${picocolors_1.default.bold(extensionVersion)} is installed.`);
+            (0, utils_js_1.assertUsage)(isVersionRange(extensionVersion, reqVersion), `${errBase} version ${picocolors_1.default.bold(reqVersion)} but ${picocolors_1.default.bold(extensionVersion)} is installed.`);
         });
     });
 }
@@ -51,21 +101,34 @@ function getConfigNameValue(interfaceFile) {
     const name = (0, getVikeConfig_js_1.getConfigValueInterfaceFile)(interfaceFile, 'name');
     if (!name)
         return null;
-    // TODO: move assertUsage() here
-    (0, utils_js_1.assert)(typeof name === 'string');
+    const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+    (0, utils_js_1.assertUsage)(typeof name === 'string', `The setting ${picocolors_1.default.bold('name')} defined at ${filePathToShowToUser} should be a string.`);
     return name;
 }
 // We use a forever cache: users need to restart the dev server anyways when touching node_modules/**/* (I presume Vite doesn't pick up node_modules/**/* changes).
 const extensionsVersion = {};
-function getExtensionVersion(extensionConfigFilePath, name) {
+function getExtensionVersion(name, interfaceFile) {
     if (!extensionsVersion[name]) {
+        const extensionConfigFilePath = interfaceFile.filePath.filePathAbsoluteFilesystem;
         const found = (0, utils_js_1.findPackageJson)(path_1.default.posix.dirname(extensionConfigFilePath));
         (0, utils_js_1.assert)(found);
         const { packageJson, packageJsonPath } = found;
-        (0, utils_js_1.assertUsage)(packageJson.name === name, `The setting ${picocolors_1.default.bold('name')} set by ${extensionConfigFilePath} is ${picocolors_1.default.bold(JSON.stringify(name))} but it should be equal to ${packageJsonPath}${picocolors_1.default.dim('#')}${picocolors_1.default.bold('name')} which is ${picocolors_1.default.bold(JSON.stringify(packageJson.name))}`);
+        const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+        const nameExpected = packageJson.name;
+        (0, utils_js_1.assertWarning)(name === nameExpected, `The setting ${picocolors_1.default.bold('name')} defined at ${filePathToShowToUser} is ${picocolors_1.default.bold(JSON.stringify(name))} but it should be equal to ${picocolors_1.default.bold(JSON.stringify(nameExpected))} (the value of ${packageJsonPath}${picocolors_1.default.dim('#')}${picocolors_1.default.bold('name')})`, { onlyOnce: true });
         const { version } = packageJson;
         (0, utils_js_1.assert)(typeof version === 'string');
         extensionsVersion[name] = version;
     }
     return extensionsVersion[name];
 }
+function getFilePathToShowToUser(interfaceFile) {
+    const { filePathToShowToUserResolved } = interfaceFile.filePath;
+    (0, utils_js_1.assert)(filePathToShowToUserResolved);
+    return filePathToShowToUserResolved;
+}
+function isVersionRange(version, range) {
+    // Remove pre-release tag
+    version = version.split('-')[0];
+    return semver_1.default.satisfies(version, range);
+}

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

@@ -126,7 +126,7 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, crawlWithGit)
                 ```
                 */
                 const interfaceFile = getInterfaceFileFromConfigFile(extendsConfig, true, locationId);
-                assertVikeExtensionConventions(extendsConfig, interfaceFile);
+                (0, assertExtensions_js_1.assertExtensionsConventions)(interfaceFile);
                 interfaceFilesByLocationId[locationId].push(interfaceFile);
             });
         }),
@@ -165,56 +165,6 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, crawlWithGit)
     assertAllConfigsAreKnown(interfaceFilesByLocationId);
     return interfaceFilesByLocationId;
 }
-function assertVikeExtensionConventions(extendsConfig, interfaceFile) {
-    const alreadyMigrated = [
-        'vike-react',
-        'vike-react-query',
-        'vike-react-zustand',
-        'vike-vue',
-        'vike-pinia',
-        'vike-solid'
-    ];
-    const { importPathAbsolute } = extendsConfig.filePath;
-    (0, utils_js_1.assert)(importPathAbsolute);
-    const extensionName = importPathAbsolute
-        .split('/')
-        .slice(0, importPathAbsolute.startsWith('@') ? 2 : 1)
-        .join('/');
-    const errMsg = alreadyMigrated.includes(extensionName)
-        ? `You're using a deprecated version of the Vike extension ${extensionName}, update ${extensionName} to its latest version.`
-        : `The config of the Vike extension ${extensionName} should define the ${picocolors_1.default.cyan('name')} setting.`;
-    const extensionNameValue = getConfigValueInterfaceFile(interfaceFile, 'name');
-    if (alreadyMigrated) {
-        // Eventually remove (always use assertUsage())
-        (0, utils_js_1.assertWarning)(extensionNameValue, errMsg, { onlyOnce: true });
-    }
-    else {
-        (0, utils_js_1.assertUsage)(extensionNameValue, errMsg);
-    }
-    {
-        const { filePathToShowToUserResolved } = interfaceFile.filePath;
-        (0, utils_js_1.assert)(filePathToShowToUserResolved);
-        const errPrefix = `The setting ${picocolors_1.default.bold('name')} defined at ${filePathToShowToUserResolved}`;
-        (0, utils_js_1.assertUsage)(typeof extensionNameValue === 'string', `${errPrefix} should be a string.`);
-        (0, utils_js_1.assertWarning)(extensionNameValue === extensionName, `${errPrefix} is ${picocolors_1.default.bold(extensionNameValue)} but it should be ${picocolors_1.default.bold(extensionName)} instead.`, { onlyOnce: true });
-    }
-    {
-        const importPathAbsoluteExpected = `${extensionName}/config`;
-        (0, utils_js_1.assertWarning)(importPathAbsolute === importPathAbsoluteExpected, `The Vike configuration of ${extensionName} is exported at ${picocolors_1.default.bold(importPathAbsolute)} but it should be exported at ${picocolors_1.default.bold(importPathAbsoluteExpected)} instead.`, { onlyOnce: true });
-    }
-    if (extensionName.startsWith('vike-')) {
-        const prefix = [
-            //
-            'vike-react',
-            'vike-vue',
-            'vike-solid',
-            'vike-svelte',
-            'vike-angular',
-            'vike-preact'
-        ];
-        (0, utils_js_1.assertWarning)(prefix.some((p) => extensionName === p || extensionName.startsWith(`${p}-`)), `The name of the Vike extension ${picocolors_1.default.bold(extensionName)} should be or start with ${(0, utils_js_1.joinEnglish)(prefix.map(picocolors_1.default.bold), 'or')}.`, { onlyOnce: true });
-    }
-}
 function getInterfaceFileFromConfigFile(configFile, isConfigExtend, locationId) {
     const { fileExports, filePath, extendsFilePaths } = configFile;
     const interfaceFile = {

package/dist/cjs/node/plugin/shared/loggerNotProd/log.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyViteSourceMapToStackTrace = exports.screenHasErrors = exports.clearScreen = exports.isFirstLog = exports.logDirectly = exports.logWithVikeTag = exports.logWithViteTag = void 0;
 const utils_js_1 = require("../../utils.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-const isErrorDebug_js_1 = require("../isErrorDebug.js");
+const isErrorDebug_js_1 = require("../../../shared/isErrorDebug.js");
 const globalContext_js_1 = require("../../../runtime/globalContext.js");
 (0, utils_js_1.assertIsNotProductionRuntime)();
 let isFirstLog = true;

package/dist/cjs/node/plugin/shared/loggerNotProd.js

@@ -15,7 +15,7 @@ const globalContext_js_1 = require("../../runtime/globalContext.js");
 const loggerRuntime_js_1 = require("../../runtime/renderPage/loggerRuntime.js");
 const utils_js_1 = require("../utils.js");
 const getHttpRequestAsyncStore_js_1 = require("./getHttpRequestAsyncStore.js");
-const isErrorDebug_js_1 = require("./isErrorDebug.js");
+const isErrorDebug_js_1 = require("../../shared/isErrorDebug.js");
 const errorWithCodeSnippet_js_1 = require("./loggerNotProd/errorWithCodeSnippet.js");
 const transpileAndExecuteFile_js_1 = require("../plugins/importUserCode/v1-design/getVikeConfig/transpileAndExecuteFile.js");
 const log_js_1 = require("./loggerNotProd/log.js");

package/dist/cjs/node/plugin/shared/loggerVite.js

@@ -5,7 +5,7 @@ const utils_js_1 = require("../utils.js");
 const loggerNotProd_js_1 = require("./loggerNotProd.js");
 const getHttpRequestAsyncStore_js_1 = require("./getHttpRequestAsyncStore.js");
 const removeSuperfluousViteLog_js_1 = require("./loggerVite/removeSuperfluousViteLog.js");
-const isErrorDebug_js_1 = require("./isErrorDebug.js");
+const isErrorDebug_js_1 = require("../../shared/isErrorDebug.js");
 function improveViteLogs(config) {
     intercept('info', config);
     intercept('warn', config);

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

@@ -4,9 +4,13 @@ exports.onLoad = void 0;
 const assertIsNotBrowser_js_1 = require("../../utils/assertIsNotBrowser.js");
 const assertNodeVersion_js_1 = require("../../utils/assertNodeVersion.js");
 const require_shim_1 = require("@brillout/require-shim");
+const utils_js_1 = require("./utils.js");
+const isErrorDebug_js_1 = require("../shared/isErrorDebug.js");
 function onLoad() {
     (0, assertIsNotBrowser_js_1.assertIsNotBrowser)();
     (0, assertNodeVersion_js_1.assertNodeVersion)();
     (0, require_shim_1.installRequireShim)();
+    if ((0, isErrorDebug_js_1.isErrorDebug)())
+        (0, utils_js_1.setAlwaysShowStackTrace)();
 }
 exports.onLoad = onLoad;

package/dist/cjs/node/{plugin/shared → shared}/isErrorDebug.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isErrorDebug = void 0;
-const utils_js_1 = require("../utils.js");
+const utils_js_1 = require("./utils.js");
 function isErrorDebug() {
     return (0, utils_js_1.isDebugActivated)('vike:error');
 }

package/dist/cjs/node/shared/utils.js

@@ -32,3 +32,4 @@ __exportStar(require("../../utils/virtual-files.js"), exports);
 __exportStar(require("../../utils/assertIsNotBrowser.js"), exports);
 __exportStar(require("../../utils/isNotNullish.js"), exports);
 __exportStar(require("../../utils/unique.js"), exports);
+__exportStar(require("../../utils/debug.js"), exports);

package/dist/cjs/utils/assert.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBug = exports.overwriteAssertProductionLogger = exports.getAssertErrMsg = exports.addOnBeforeLogHook = exports.getProjectError = exports.assertInfo = exports.assertWarning = exports.assertUsage = exports.assert = void 0;
+exports.setAlwaysShowStackTrace = exports.isBug = exports.overwriteAssertProductionLogger = exports.getAssertErrMsg = exports.addOnBeforeLogHook = exports.getProjectError = exports.assertInfo = exports.assertWarning = exports.assertUsage = exports.assert = void 0;
 const assertSingleInstance_js_1 = require("./assertSingleInstance.js");
 const createErrorWithCleanStackTrace_js_1 = require("./createErrorWithCleanStackTrace.js");
 const getGlobalObject_js_1 = require("./getGlobalObject.js");
@@ -55,6 +55,7 @@ exports.assert = assert;
 function assertUsage(condition, errMsg, { showStackTrace } = {}) {
     if (condition)
         return;
+    showStackTrace = showStackTrace || globalObject.alwaysShowStackTrace;
     errMsg = addWhitespace(errMsg);
     errMsg = addPrefixAssertType(errMsg, 'Wrong Usage');
     errMsg = addPrefixProjctName(errMsg);
@@ -77,6 +78,7 @@ exports.getProjectError = getProjectError;
 function assertWarning(condition, msg, { onlyOnce, showStackTrace }) {
     if (condition)
         return;
+    showStackTrace = showStackTrace || globalObject.alwaysShowStackTrace;
     msg = addWhitespace(msg);
     msg = addPrefixAssertType(msg, 'Warning');
     msg = addPrefixProjctName(msg);
@@ -193,3 +195,7 @@ function isBug(err) {
     return !String(err).includes('[Bug]');
 }
 exports.isBug = isBug;
+function setAlwaysShowStackTrace() {
+    globalObject.alwaysShowStackTrace = true;
+}
+exports.setAlwaysShowStackTrace = setAlwaysShowStackTrace;

package/dist/cjs/utils/projectInfo.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROJECT_VERSION = exports.projectInfo = void 0;
-const PROJECT_VERSION = '0.4.172-commit-55d8662';
+const PROJECT_VERSION = '0.4.172-commit-24e2d90';
 exports.PROJECT_VERSION = PROJECT_VERSION;
 const projectInfo = {
     projectName: 'Vike',

package/dist/esm/node/plugin/plugins/devConfig/index.js

@@ -4,7 +4,7 @@ import { determineFsAllowList } from './determineFsAllowList.js';
 import { addSsrMiddleware } from '../../shared/addSsrMiddleware.js';
 import { markEnvAsViteDev } from '../../utils.js';
 import { improveViteLogs } from '../../shared/loggerVite.js';
-import { isErrorDebug } from '../../shared/isErrorDebug.js';
+import { isErrorDebug } from '../../../shared/isErrorDebug.js';
 import { installHttpRequestAsyncStore } from '../../shared/getHttpRequestAsyncStore.js';
 if (isErrorDebug()) {
     Error.stackTraceLimit = Infinity;

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

@@ -1,3 +1,5 @@
+export { assertExtensionsConventions };
 export { assertExtensionsPeerDependencies };
 import { type InterfaceFile } from './getVikeConfig.js';
+declare function assertExtensionsConventions(interfaceFile: InterfaceFile): void;
 declare function assertExtensionsPeerDependencies(interfaceFilesRelevantList: InterfaceFile[]): void;

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

@@ -1,18 +1,65 @@
+export { assertExtensionsConventions };
 export { assertExtensionsPeerDependencies };
 import pc from '@brillout/picocolors';
 import { isObjectOfStrings } from '../../../../../utils/isObjectOfStrings.js';
-import { assert, assertUsage, findPackageJson } from '../../../utils.js';
+import { PROJECT_VERSION, assert, assertUsage, assertWarning, findPackageJson } from '../../../utils.js';
 import { getConfigValueInterfaceFile } from './getVikeConfig.js';
 import path from 'path';
 import semver from 'semver';
+function assertExtensionsConventions(interfaceFile) {
+    assertExtensionName(interfaceFile);
+    assertConfigExportPath(interfaceFile);
+}
+function assertConfigExportPath(interfaceFile) {
+    const { importPathAbsolute } = interfaceFile.filePath;
+    assert(importPathAbsolute);
+    const name = getConfigNameValue(interfaceFile);
+    assert(name); // already asserted in assertExtensionName()
+    const importPathAbsoluteExpected = `${name}/config`;
+    assertWarning(importPathAbsolute === importPathAbsoluteExpected, `The Vike configuration of ${pc.bold(name)} is exported at ${pc.bold(importPathAbsolute)} but it should be exported at ${pc.bold(importPathAbsoluteExpected)} instead.`, { onlyOnce: true });
+}
+function assertExtensionName(interfaceFile) {
+    let nameDeduced;
+    {
+        const { importPathAbsolute } = interfaceFile.filePath;
+        assert(importPathAbsolute);
+        nameDeduced = importPathAbsolute
+            .split('/')
+            .slice(0, importPathAbsolute.startsWith('@') ? 2 : 1)
+            .join('/');
+    }
+    const name = getConfigNameValue(interfaceFile);
+    const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+    if (name) {
+        assertWarning(name === nameDeduced, `The setting ${pc.bold('name')} defined at ${filePathToShowToUser} is ${pc.bold(name)} but it should be ${pc.bold(nameDeduced)} instead (the name of the npm package).`, { onlyOnce: true });
+    }
+    else {
+        if (
+        // Let's eventually remove this
+        [
+            'vike-react',
+            'vike-react-query',
+            'vike-react-zustand',
+            'vike-vue',
+            'vike-vue-query',
+            'vike-vue-pinia',
+            'vike-pinia',
+            'vike-solid'
+        ].includes(nameDeduced)) {
+            assertUsage(false, `Update ${nameDeduced} to its latest version.`);
+        }
+        else {
+            assertUsage(false, `The setting ${pc.bold('name')} is missing: it should be set by the config ${filePathToShowToUser} of ${pc.bold(nameDeduced)}.`);
+        }
+    }
+}
 function assertExtensionsPeerDependencies(interfaceFilesRelevantList) {
     // Get installed extensions
     const extensions = {};
     interfaceFilesRelevantList.forEach((interfaceFile) => {
         const name = getConfigNameValue(interfaceFile);
         if (name) {
-            const extensionConfigFilePath = interfaceFile.filePath.filePathAbsoluteFilesystem;
-            const version = getExtensionVersion(extensionConfigFilePath, name);
+            const version = getExtensionVersion(name, interfaceFile);
             extensions[name] = version;
         }
     });
@@ -22,13 +69,16 @@ function assertExtensionsPeerDependencies(interfaceFilesRelevantList) {
         if (!require)
             return;
         const name = getConfigNameValue(interfaceFile);
-        // TODO: unify assertUsage()?
-        assertUsage(name, `Setting ${pc.bold('name')} is required when using setting ${pc.bold('require')}.`);
+        const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+        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]) => {
+            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.`);
+            }
             const extensionVersion = extensions[reqName];
-            const errBase = `The Vike extension ${pc.bold(name)} requires ${pc.bold(reqName)}`;
             assertUsage(extensionVersion, `${errBase}.`);
-            assertUsage(semver.satisfies(extensionVersion, reqVersion), `${errBase} version ${pc.bold(reqVersion)} but ${pc.bold(extensionVersion)} is installed.`);
+            assertUsage(isVersionRange(extensionVersion, reqVersion), `${errBase} version ${pc.bold(reqVersion)} but ${pc.bold(extensionVersion)} is installed.`);
         });
     });
 }
@@ -45,21 +95,34 @@ function getConfigNameValue(interfaceFile) {
     const name = getConfigValueInterfaceFile(interfaceFile, 'name');
     if (!name)
         return null;
-    // TODO: move assertUsage() here
-    assert(typeof name === 'string');
+    const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+    assertUsage(typeof name === 'string', `The setting ${pc.bold('name')} defined at ${filePathToShowToUser} should be a string.`);
     return name;
 }
 // We use a forever cache: users need to restart the dev server anyways when touching node_modules/**/* (I presume Vite doesn't pick up node_modules/**/* changes).
 const extensionsVersion = {};
-function getExtensionVersion(extensionConfigFilePath, name) {
+function getExtensionVersion(name, interfaceFile) {
     if (!extensionsVersion[name]) {
+        const extensionConfigFilePath = interfaceFile.filePath.filePathAbsoluteFilesystem;
         const found = findPackageJson(path.posix.dirname(extensionConfigFilePath));
         assert(found);
         const { packageJson, packageJsonPath } = found;
-        assertUsage(packageJson.name === name, `The setting ${pc.bold('name')} set by ${extensionConfigFilePath} is ${pc.bold(JSON.stringify(name))} but it should be equal to ${packageJsonPath}${pc.dim('#')}${pc.bold('name')} which is ${pc.bold(JSON.stringify(packageJson.name))}`);
+        const filePathToShowToUser = getFilePathToShowToUser(interfaceFile);
+        const nameExpected = packageJson.name;
+        assertWarning(name === nameExpected, `The setting ${pc.bold('name')} defined at ${filePathToShowToUser} is ${pc.bold(JSON.stringify(name))} but it should be equal to ${pc.bold(JSON.stringify(nameExpected))} (the value of ${packageJsonPath}${pc.dim('#')}${pc.bold('name')})`, { onlyOnce: true });
         const { version } = packageJson;
         assert(typeof version === 'string');
         extensionsVersion[name] = version;
     }
     return extensionsVersion[name];
 }
+function getFilePathToShowToUser(interfaceFile) {
+    const { filePathToShowToUserResolved } = interfaceFile.filePath;
+    assert(filePathToShowToUserResolved);
+    return filePathToShowToUserResolved;
+}
+function isVersionRange(version, range) {
+    // Remove pre-release tag
+    version = version.split('-')[0];
+    return semver.satisfies(version, range);
+}

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

@@ -22,7 +22,7 @@ import { clearFilesEnvMap, resolvePointerImportOfConfig } from './getVikeConfig/
 import { getFilePathResolved } from '../../../shared/getFilePath.js';
 import { getConfigValueBuildTime } from '../../../../../shared/page-configs/getConfigValueBuildTime.js';
 import { getConfigVike } from '../../../../shared/getConfigVike.js';
-import { assertExtensionsPeerDependencies } from './assertExtensions.js';
+import { assertExtensionsPeerDependencies, assertExtensionsConventions } from './assertExtensions.js';
 assertIsNotProductionRuntime();
 let devServerIsCorrupt = false;
 let wasConfigInvalid = null;
@@ -122,7 +122,7 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, crawlWithGit)
                 ```
                 */
                 const interfaceFile = getInterfaceFileFromConfigFile(extendsConfig, true, locationId);
-                assertVikeExtensionConventions(extendsConfig, interfaceFile);
+                assertExtensionsConventions(interfaceFile);
                 interfaceFilesByLocationId[locationId].push(interfaceFile);
             });
         }),
@@ -161,56 +161,6 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, crawlWithGit)
     assertAllConfigsAreKnown(interfaceFilesByLocationId);
     return interfaceFilesByLocationId;
 }
-function assertVikeExtensionConventions(extendsConfig, interfaceFile) {
-    const alreadyMigrated = [
-        'vike-react',
-        'vike-react-query',
-        'vike-react-zustand',
-        'vike-vue',
-        'vike-pinia',
-        'vike-solid'
-    ];
-    const { importPathAbsolute } = extendsConfig.filePath;
-    assert(importPathAbsolute);
-    const extensionName = importPathAbsolute
-        .split('/')
-        .slice(0, importPathAbsolute.startsWith('@') ? 2 : 1)
-        .join('/');
-    const errMsg = alreadyMigrated.includes(extensionName)
-        ? `You're using a deprecated version of the Vike extension ${extensionName}, update ${extensionName} to its latest version.`
-        : `The config of the Vike extension ${extensionName} should define the ${pc.cyan('name')} setting.`;
-    const extensionNameValue = getConfigValueInterfaceFile(interfaceFile, 'name');
-    if (alreadyMigrated) {
-        // Eventually remove (always use assertUsage())
-        assertWarning(extensionNameValue, errMsg, { onlyOnce: true });
-    }
-    else {
-        assertUsage(extensionNameValue, errMsg);
-    }
-    {
-        const { filePathToShowToUserResolved } = interfaceFile.filePath;
-        assert(filePathToShowToUserResolved);
-        const errPrefix = `The setting ${pc.bold('name')} defined at ${filePathToShowToUserResolved}`;
-        assertUsage(typeof extensionNameValue === 'string', `${errPrefix} should be a string.`);
-        assertWarning(extensionNameValue === extensionName, `${errPrefix} is ${pc.bold(extensionNameValue)} but it should be ${pc.bold(extensionName)} instead.`, { onlyOnce: true });
-    }
-    {
-        const importPathAbsoluteExpected = `${extensionName}/config`;
-        assertWarning(importPathAbsolute === importPathAbsoluteExpected, `The Vike configuration of ${extensionName} is exported at ${pc.bold(importPathAbsolute)} but it should be exported at ${pc.bold(importPathAbsoluteExpected)} instead.`, { onlyOnce: true });
-    }
-    if (extensionName.startsWith('vike-')) {
-        const prefix = [
-            //
-            'vike-react',
-            'vike-vue',
-            'vike-solid',
-            'vike-svelte',
-            'vike-angular',
-            'vike-preact'
-        ];
-        assertWarning(prefix.some((p) => extensionName === p || extensionName.startsWith(`${p}-`)), `The name of the Vike extension ${pc.bold(extensionName)} should be or start with ${joinEnglish(prefix.map(pc.bold), 'or')}.`, { onlyOnce: true });
-    }
-}
 function getInterfaceFileFromConfigFile(configFile, isConfigExtend, locationId) {
     const { fileExports, filePath, extendsFilePaths } = configFile;
     const interfaceFile = {

package/dist/esm/node/plugin/shared/loggerNotProd/log.js

@@ -7,7 +7,7 @@ export { screenHasErrors };
 export { applyViteSourceMapToStackTrace };
 import { assert, projectInfo, stripAnsi, hasProp, assertIsNotProductionRuntime } from '../../utils.js';
 import pc from '@brillout/picocolors';
-import { isErrorDebug } from '../isErrorDebug.js';
+import { isErrorDebug } from '../../../shared/isErrorDebug.js';
 import { getViteDevServer } from '../../../runtime/globalContext.js';
 assertIsNotProductionRuntime();
 let isFirstLog = true;

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

@@ -16,7 +16,7 @@ import { getViteConfig } from '../../runtime/globalContext.js';
 import { overwriteRuntimeProductionLogger } from '../../runtime/renderPage/loggerRuntime.js';
 import { assert, assertIsNotProductionRuntime, formatHintLog, getAssertErrMsg, overwriteAssertProductionLogger, stripAnsi, warnIfErrorIsNotObject } from '../utils.js';
 import { getHttpRequestAsyncStore } from './getHttpRequestAsyncStore.js';
-import { isErrorDebug } from './isErrorDebug.js';
+import { isErrorDebug } from '../../shared/isErrorDebug.js';
 import { isErrorWithCodeSnippet, getPrettyErrorWithCodeSnippet } from './loggerNotProd/errorWithCodeSnippet.js';
 import { getConfigExecutionErrorIntroMsg, getConfigBuildErrorFormatted } from '../plugins/importUserCode/v1-design/getVikeConfig/transpileAndExecuteFile.js';
 import { logWithVikeTag, logWithViteTag, logDirectly, isFirstLog, screenHasErrors, clearScreen, applyViteSourceMapToStackTrace } from './loggerNotProd/log.js';

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

@@ -3,7 +3,7 @@ import { assert, removeEmptyLines, trimWithAnsi, trimWithAnsiTrailOnly } from '.
 import { logViteError, logViteAny, clearLogs } from './loggerNotProd.js';
 import { getHttpRequestAsyncStore } from './getHttpRequestAsyncStore.js';
 import { removeSuperfluousViteLog } from './loggerVite/removeSuperfluousViteLog.js';
-import { isErrorDebug } from './isErrorDebug.js';
+import { isErrorDebug } from '../../shared/isErrorDebug.js';
 function improveViteLogs(config) {
     intercept('info', config);
     intercept('warn', config);

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

@@ -2,8 +2,12 @@ export { onLoad };
 import { assertIsNotBrowser } from '../../utils/assertIsNotBrowser.js';
 import { assertNodeVersion } from '../../utils/assertNodeVersion.js';
 import { installRequireShim } from '@brillout/require-shim';
+import { setAlwaysShowStackTrace } from './utils.js';
+import { isErrorDebug } from '../shared/isErrorDebug.js';
 function onLoad() {
     assertIsNotBrowser();
     assertNodeVersion();
     installRequireShim();
+    if (isErrorDebug())
+        setAlwaysShowStackTrace();
 }

package/dist/esm/node/{plugin/shared → shared}/isErrorDebug.js

@@ -1,5 +1,5 @@
 export { isErrorDebug };
-import { isDebugActivated } from '../utils.js';
+import { isDebugActivated } from './utils.js';
 function isErrorDebug() {
     return isDebugActivated('vike:error');
 }

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

@@ -14,3 +14,4 @@ export * from '../../utils/virtual-files.js';
 export * from '../../utils/assertIsNotBrowser.js';
 export * from '../../utils/isNotNullish.js';
 export * from '../../utils/unique.js';
+export * from '../../utils/debug.js';

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

@@ -16,3 +16,4 @@ export * from '../../utils/virtual-files.js';
 export * from '../../utils/assertIsNotBrowser.js';
 export * from '../../utils/isNotNullish.js';
 export * from '../../utils/unique.js';
+export * from '../../utils/debug.js';

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

@@ -5,6 +5,7 @@ export type { ConfigMeta };
 export type { HookName };
 export type { HookNamePage };
 export type { HookNameGlobal };
+export type { ImportString };
 export type { DataAsync };
 export type { DataSync };
 export type { GuardAsync };
@@ -362,7 +363,7 @@ type ConfigBuiltIn = {
      *
      * https://vike.dev/require
      */
-    require?: string;
+    require?: Record<string, string>;
 };
 type ConfigMeta = Record<string, ConfigDefinition>;
 type ImportString = `import:${string}`;

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

@@ -6,7 +6,7 @@ export type { PageContextClientWithServerRouting } from '../shared/types.js';
 export type { PageContextBuiltInServer } from '../shared/types.js';
 export type { PageContextBuiltInClientWithClientRouting } from '../shared/types.js';
 export type { PageContextBuiltInClientWithServerRouting } from '../shared/types.js';
-export type { Config, ConfigMeta as Meta, DataAsync, DataSync, GuardAsync, GuardSync, OnBeforePrerenderStartAsync, OnBeforePrerenderStartSync, OnBeforeRenderAsync, OnBeforeRenderSync, OnBeforeRouteAsync, OnBeforeRouteSync, OnHydrationEndAsync, OnHydrationEndSync, OnPageTransitionEndAsync, OnPageTransitionEndSync, OnPageTransitionStartAsync, OnPageTransitionStartSync, OnPrerenderStartAsync, OnPrerenderStartSync, OnRenderClientAsync, OnRenderClientSync, OnRenderHtmlAsync, OnRenderHtmlSync, RouteAsync, RouteSync } from '../shared/page-configs/Config.js';
+export type { Config, ConfigMeta as Meta, ImportString, DataAsync, DataSync, GuardAsync, GuardSync, OnBeforePrerenderStartAsync, OnBeforePrerenderStartSync, OnBeforeRenderAsync, OnBeforeRenderSync, OnBeforeRouteAsync, OnBeforeRouteSync, OnHydrationEndAsync, OnHydrationEndSync, OnPageTransitionEndAsync, OnPageTransitionEndSync, OnPageTransitionStartAsync, OnPageTransitionStartSync, OnPrerenderStartAsync, OnPrerenderStartSync, OnRenderClientAsync, OnRenderClientSync, OnRenderHtmlAsync, OnRenderHtmlSync, RouteAsync, RouteSync } from '../shared/page-configs/Config.js';
 export type { ConfigEnv } from '../shared/page-configs/PageConfig.js';
 export type { ConfigDefinition, ConfigEffect } from '../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.js';
 export type { ConfigEntries } from '../shared/getPageFiles/getExports.js';

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

@@ -7,6 +7,7 @@ export { addOnBeforeLogHook };
 export { getAssertErrMsg };
 export { overwriteAssertProductionLogger };
 export { isBug };
+export { setAlwaysShowStackTrace };
 type Logger = (msg: string | Error, logType: 'warn' | 'info') => void;
 declare function assert(condition: unknown, debugInfo?: unknown): asserts condition;
 declare function assertUsage(condition: unknown, errMsg: string, { showStackTrace }?: {
@@ -27,3 +28,4 @@ declare function getAssertErrMsg(thing: unknown): {
 } | null;
 declare function overwriteAssertProductionLogger(logger: Logger): void;
 declare function isBug(err: unknown): boolean;
+declare function setAlwaysShowStackTrace(): void;

package/dist/esm/utils/assert.js

@@ -7,6 +7,7 @@ export { addOnBeforeLogHook };
 export { getAssertErrMsg };
 export { overwriteAssertProductionLogger };
 export { isBug };
+export { setAlwaysShowStackTrace };
 import { onAssertModuleLoad } from './assertSingleInstance.js';
 import { createErrorWithCleanStackTrace } from './createErrorWithCleanStackTrace.js';
 import { getGlobalObject } from './getGlobalObject.js';
@@ -57,6 +58,7 @@ function assert(condition, debugInfo) {
 function assertUsage(condition, errMsg, { showStackTrace } = {}) {
     if (condition)
         return;
+    showStackTrace = showStackTrace || globalObject.alwaysShowStackTrace;
     errMsg = addWhitespace(errMsg);
     errMsg = addPrefixAssertType(errMsg, 'Wrong Usage');
     errMsg = addPrefixProjctName(errMsg);
@@ -77,6 +79,7 @@ function getProjectError(errMsg) {
 function assertWarning(condition, msg, { onlyOnce, showStackTrace }) {
     if (condition)
         return;
+    showStackTrace = showStackTrace || globalObject.alwaysShowStackTrace;
     msg = addWhitespace(msg);
     msg = addPrefixAssertType(msg, 'Warning');
     msg = addPrefixProjctName(msg);
@@ -187,3 +190,6 @@ function overwriteAssertProductionLogger(logger) {
 function isBug(err) {
     return !String(err).includes('[Bug]');
 }
+function setAlwaysShowStackTrace() {
+    globalObject.alwaysShowStackTrace = true;
+}

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

@@ -1,7 +1,7 @@
 export { projectInfo };
 export { PROJECT_VERSION };
-declare const PROJECT_VERSION: "0.4.172-commit-55d8662";
+declare const PROJECT_VERSION: "0.4.172-commit-24e2d90";
 declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.172-commit-55d8662";
+    projectVersion: "0.4.172-commit-24e2d90";
 };

package/dist/esm/utils/projectInfo.js

@@ -1,6 +1,6 @@
 export { projectInfo };
 export { PROJECT_VERSION };
-const PROJECT_VERSION = '0.4.172-commit-55d8662';
+const PROJECT_VERSION = '0.4.172-commit-24e2d90';
 const projectInfo = {
     projectName: 'Vike',
     projectVersion: PROJECT_VERSION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.172-commit-55d8662",
+  "version": "0.4.172-commit-24e2d90",
   "scripts": {
     "dev": "tsc --watch",
     "build": "rimraf dist/ && pnpm run build:esm && pnpm run build:cjs",