vike 0.4.144 → 0.4.145-commit-2520555

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

@@ -15,11 +15,11 @@ const isConfigInvalid_js_1 = require("../../../../runtime/renderPage/isConfigInv
 const globalContext_js_1 = require("../../../../runtime/globalContext.js");
 const loggerNotProd_js_1 = require("../../../shared/loggerNotProd.js");
 const removeSuperfluousViteLog_js_1 = require("../../../shared/loggerVite/removeSuperfluousViteLog.js");
-const getFilePathToShowToUser_js_1 = require("./getFilePathToShowToUser.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-const utils_js_2 = require("../../../../../shared/page-configs/utils.js");
+const helpers_js_1 = require("../../../../../shared/page-configs/helpers.js");
 const assertExports_js_1 = require("../../../../../shared/page-configs/assertExports.js");
 const getVirtualFilePageConfigs_js_1 = require("./getVirtualFilePageConfigs.js");
+const getConfigVike_js_1 = require("../../../../shared/getConfigVike.js");
 (0, utils_js_1.assertIsNotProductionRuntime)();
 let devServerIsCorrupt = false;
 let wasConfigInvalid = null;
@@ -65,9 +65,11 @@ async function handleReloadSideEffects() {
         }
     }
 }
-async function getVikeConfig(userRootDir, outDirRoot, isDev, extensions, tolerateInvalidConfig = false) {
+async function getVikeConfig(config, isDev, tolerateInvalidConfig = false, extensions) {
+    const { outDirRoot } = (0, utils_js_1.getOutDirs)(config);
+    const userRootDir = config.root;
     if (!vikeConfigPromise) {
-        vikeConfigPromise = loadVikeConfig_withErrorHandling(userRootDir, outDirRoot, isDev, extensions, tolerateInvalidConfig);
+        vikeConfigPromise = loadVikeConfig_withErrorHandling(userRootDir, outDirRoot, isDev, extensions ?? (await (0, getConfigVike_js_1.getConfigVike)(config)).extensions, tolerateInvalidConfig);
     }
     return await vikeConfigPromise;
 }
@@ -77,7 +79,7 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, extensions) {
     const configFiles = [];
     const valueFiles = [];
     plusFiles.forEach((f) => {
-        if (getConfigName(f.filePathRelativeToUserRootDir) === 'config') {
+        if (getConfigName(f.filePathAbsoluteFilesystem) === 'config') {
             configFiles.push(f);
         }
         else {
@@ -86,15 +88,10 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, extensions) {
     });
     let interfaceFilesByLocationId = {};
     // Config files
-    await Promise.all(configFiles.map(async ({ filePathAbsolute, filePathRelativeToUserRootDir }) => {
-        const configFilePath = {
-            filePathAbsolute: filePathAbsolute,
-            filePathRelativeToUserRootDir: filePathRelativeToUserRootDir,
-            importPathAbsolute: null
-        };
-        const { configFile, extendsConfigs } = await loadConfigFile(configFilePath, userRootDir, []);
+    await Promise.all(configFiles.map(async (filePath) => {
+        const { configFile, extendsConfigs } = await loadConfigFile(filePath, userRootDir, []);
         const interfaceFile = getInterfaceFileFromConfigFile(configFile, false);
-        const locationId = (0, filesystemRouting_js_1.getLocationId)(filePathRelativeToUserRootDir);
+        const locationId = (0, filesystemRouting_js_1.getLocationId)(filePath.filePathAbsoluteVite);
         interfaceFilesByLocationId[locationId] = interfaceFilesByLocationId[locationId] ?? [];
         interfaceFilesByLocationId[locationId].push(interfaceFile);
         extendsConfigs.forEach((extendsConfig) => {
@@ -103,15 +100,11 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, extensions) {
         });
     }));
     // Value files
-    await Promise.all(valueFiles.map(async ({ filePathAbsolute, filePathRelativeToUserRootDir }) => {
-        const configName = getConfigName(filePathRelativeToUserRootDir);
+    await Promise.all(valueFiles.map(async (filePath) => {
+        const configName = getConfigName(filePath.filePathAbsoluteVite);
         (0, utils_js_1.assert)(configName);
         const interfaceFile = {
-            filePath: {
-                filePathRelativeToUserRootDir,
-                filePathAbsolute,
-                importPathAbsolute: null
-            },
+            filePath,
             configMap: {
                 [configName]: {}
             },
@@ -120,25 +113,25 @@ async function loadInterfaceFiles(userRootDir, outDirRoot, isDev, extensions) {
             configName
         };
         {
-            // We don't have access to custom config definitions yet
-            //  - We load +{configName}.js later
-            //  - But we do need to eagerly load +meta.js (to get all the custom config definitions)
+            // We don't have access to the custom config definitions defined by the user yet.
+            //  - If `configDef` is `undefined` => we load the file +{configName}.js later.
+            //  - We already need to load +meta.js here (to get the custom config definitions defined by the user)
             const configDef = getConfigDefinitionOptional(configDefinitionsBuiltIn_js_1.configDefinitionsBuiltIn, configName);
-            if (configDef?.env === 'config-only') {
+            if (configDef && isConfigEnv(configDef, configName)) {
                 await loadValueFile(interfaceFile, configName, userRootDir);
             }
         }
         {
-            const locationId = (0, filesystemRouting_js_1.getLocationId)(filePathRelativeToUserRootDir);
+            const locationId = (0, filesystemRouting_js_1.getLocationId)(filePath.filePathAbsoluteVite);
             interfaceFilesByLocationId[locationId] = interfaceFilesByLocationId[locationId] ?? [];
             interfaceFilesByLocationId[locationId].push(interfaceFile);
         }
     }));
     return interfaceFilesByLocationId;
 }
-function getConfigDefinition(configDefinitionsRelevant, configName, definedByFile) {
+function getConfigDefinition(configDefinitionsRelevant, configName, filePathToShowToUser) {
     const configDef = configDefinitionsRelevant[configName];
-    assertConfigExists(configName, Object.keys(configDefinitionsRelevant), definedByFile);
+    assertConfigExists(configName, Object.keys(configDefinitionsRelevant), filePathToShowToUser);
     (0, utils_js_1.assert)(configDef);
     return configDef;
 }
@@ -147,13 +140,29 @@ function getConfigDefinitionOptional(configDefinitions, configName) {
 }
 async function loadValueFile(interfaceValueFile, configName, userRootDir) {
     const { fileExports } = await (0, transpileAndExecuteFile_js_1.transpileAndExecuteFile)(interfaceValueFile.filePath, true, userRootDir);
-    const filePathToShowToUser = (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(interfaceValueFile.filePath);
+    const { filePathToShowToUser } = interfaceValueFile.filePath;
     (0, assertExports_js_1.assertExportsOfValueFile)(fileExports, filePathToShowToUser, configName);
     Object.entries(fileExports).forEach(([exportName, configValue]) => {
         const configName_ = exportName === 'default' ? configName : exportName;
         interfaceValueFile.configMap[configName_] = { configValue };
     });
 }
+async function loadImportedFile(filePath, userRootDir, importedFilesLoaded) {
+    const f = filePath.filePathAbsoluteFilesystem;
+    if (!importedFilesLoaded[f]) {
+        importedFilesLoaded[f] = (0, transpileAndExecuteFile_js_1.transpileAndExecuteFile)(filePath, true, userRootDir).then((r) => r.fileExports);
+    }
+    const fileExports = await importedFilesLoaded[f];
+    return fileExports;
+}
+function isConfigEnv(configDef, configName) {
+    if (configDef.cumulative)
+        return true;
+    if (configDef.env === 'config-only')
+        return true;
+    // TODO: replace with proper `env: { config: boolean }` implementation
+    return configName === 'clientRouting';
+}
 function getInterfaceFileFromConfigFile(configFile, isConfigExtend) {
     const { fileExports, filePath, extendsFilePaths } = configFile;
     const interfaceFile = {
@@ -164,7 +173,7 @@ function getInterfaceFileFromConfigFile(configFile, isConfigExtend) {
         isConfigExtend,
         extendsFilePaths
     };
-    const filePathToShowToUser = (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(filePath);
+    const { filePathToShowToUser } = filePath;
     (0, assertExports_js_1.assertExportsOfConfigFile)(fileExports, filePathToShowToUser);
     Object.entries(fileExports.default).forEach(([configName, configValue]) => {
         interfaceFile.configMap[configName] = { configValue };
@@ -214,7 +223,8 @@ async function loadVikeConfig_withErrorHandling(userRootDir, outDirRoot, isDev,
 }
 async function loadVikeConfig(userRootDir, outDirRoot, isDev, extensions) {
     const interfaceFilesByLocationId = await loadInterfaceFiles(userRootDir, outDirRoot, isDev, extensions);
-    const { globalVikeConfig, pageConfigGlobal } = getGlobalConfigs(interfaceFilesByLocationId, userRootDir);
+    const importedFilesLoaded = {};
+    const { globalVikeConfig, pageConfigGlobal } = await getGlobalConfigs(interfaceFilesByLocationId, userRootDir, importedFilesLoaded);
     const pageConfigs = await Promise.all(Object.entries(interfaceFilesByLocationId)
         .filter(([_pageId, interfaceFiles]) => isDefiningPage(interfaceFiles))
         .map(async ([locationId]) => {
@@ -227,25 +237,25 @@ async function loadVikeConfig(userRootDir, outDirRoot, isDev, extensions) {
             const { configName } = interfaceFile;
             if (isGlobalConfig(configName))
                 return;
-            const configDef = getConfigDefinition(configDefinitionsRelevant, configName, (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(interfaceFile.filePath));
-            if (configDef.env !== 'config-only')
+            const configDef = getConfigDefinition(configDefinitionsRelevant, configName, interfaceFile.filePath.filePathToShowToUser);
+            if (!isConfigEnv(configDef, configName))
                 return;
             const isAlreadyLoaded = interfacefileIsAlreaydLoaded(interfaceFile);
             if (isAlreadyLoaded)
                 return;
-            // Value files for built-in confg-only configs should have already been loaded at loadInterfaceFiles()
+            // Value files of built-in configs should have already been loaded at loadInterfaceFiles()
             (0, utils_js_1.assert)(!(configName in configDefinitionsBuiltIn_js_1.configDefinitionsBuiltIn));
             await loadValueFile(interfaceFile, configName, userRootDir);
         }));
         const configValueSources = {};
-        (0, utils_js_1.objectEntries)(configDefinitionsRelevant)
+        await Promise.all((0, utils_js_1.objectEntries)(configDefinitionsRelevant)
             .filter(([configName]) => !isGlobalConfig(configName))
-            .forEach(([configName, configDef]) => {
-            const sources = resolveConfigValueSources(configName, configDef, interfaceFilesRelevant, userRootDir);
-            if (!sources)
+            .map(async ([configName, configDef]) => {
+            const sources = await resolveConfigValueSources(configName, configDef, interfaceFilesRelevant, userRootDir, importedFilesLoaded);
+            if (sources.length === 0)
                 return;
             configValueSources[configName] = sources;
-        });
+        }));
         const { routeFilesystem, isErrorPage } = determineRouteFilesystem(locationId, configValueSources);
         applyEffectsAll(configValueSources, configDefinitionsRelevant);
         const configValuesComputed = getComputed(configValueSources, configDefinitionsRelevant);
@@ -266,7 +276,7 @@ async function loadVikeConfig(userRootDir, outDirRoot, isDev, extensions) {
         const configDefinitionsRelevant = getConfigDefinitions(interfaceFilesRelevant);
         interfaceFiles.forEach((interfaceFile) => {
             Object.keys(interfaceFile.configMap).forEach((configName) => {
-                assertConfigExists(configName, Object.keys(configDefinitionsRelevant), (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(interfaceFile.filePath));
+                assertConfigExists(configName, Object.keys(configDefinitionsRelevant), interfaceFile.filePath.filePathToShowToUser);
             });
         });
     });
@@ -295,7 +305,7 @@ function getInterfaceFileList(interfaceFilesByLocationId) {
     });
     return interfaceFiles;
 }
-function getGlobalConfigs(interfaceFilesByLocationId, userRootDir) {
+async function getGlobalConfigs(interfaceFilesByLocationId, userRootDir, importedFilesLoaded) {
     const locationIds = Object.keys(interfaceFilesByLocationId);
     const interfaceFilesGlobal = Object.fromEntries(Object.entries(interfaceFilesByLocationId).filter(([locationId]) => {
         return (0, filesystemRouting_js_1.isGlobalLocation)(locationId, locationIds);
@@ -317,7 +327,7 @@ function getGlobalConfigs(interfaceFilesByLocationId, userRootDir) {
                 Object.keys(interfaceFile.configMap).forEach((configName) => {
                     if (!(0, filesystemRouting_js_1.isGlobalLocation)(locationId, locationIds) && isGlobalConfig(configName)) {
                         (0, utils_js_1.assertUsage)(false, [
-                            `${(0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(interfaceFile.filePath)} defines the config ${picocolors_1.default.cyan(configName)} which is global:`,
+                            `${interfaceFile.filePath.filePathToShowToUser} defines the config ${picocolors_1.default.cyan(configName)} which is global:`,
                             globalPaths.length
                                 ? `define ${picocolors_1.default.cyan(configName)} in ${(0, utils_js_1.joinEnglish)(globalPaths, 'or')} instead`
                                 : `create a global config (e.g. /pages/+config.js) and define ${picocolors_1.default.cyan(configName)} there instead`
@@ -331,9 +341,9 @@ function getGlobalConfigs(interfaceFilesByLocationId, userRootDir) {
     const pageConfigGlobal = {
         configValueSources: {}
     };
-    (0, utils_js_1.objectEntries)(configDefinitionsBuiltIn_js_1.configDefinitionsBuiltInGlobal).forEach(([configName, configDef]) => {
-        const sources = resolveConfigValueSources(configName, configDef, interfaceFilesGlobal, userRootDir);
-        const configValueSource = sources?.[0];
+    await Promise.all((0, utils_js_1.objectEntries)(configDefinitionsBuiltIn_js_1.configDefinitionsBuiltInGlobal).map(async ([configName, configDef]) => {
+        const sources = await resolveConfigValueSources(configName, configDef, interfaceFilesGlobal, userRootDir, importedFilesLoaded);
+        const configValueSource = sources[0];
         if (!configValueSource)
             return;
         if (configName === 'onBeforeRoute' || configName === 'onPrerenderStart') {
@@ -344,28 +354,25 @@ function getGlobalConfigs(interfaceFilesByLocationId, userRootDir) {
             (0, utils_js_1.assert)('value' in configValueSource);
             if (configName === 'prerender' && typeof configValueSource.value === 'boolean')
                 return;
-            const sourceFilePath = getDefinedAtFilePathToShowToUser(configValueSource.definedAtInfo);
-            (0, utils_js_1.assert)(sourceFilePath);
-            (0, utils_js_1.assertWarning)(false, `Being able to define config ${picocolors_1.default.cyan(configName)} in ${sourceFilePath} is experimental and will likely be removed. Define the config ${picocolors_1.default.cyan(configName)} in Vike's Vite plugin options instead.`, { onlyOnce: true });
+            const { filePathToShowToUser } = configValueSource.definedAt;
+            (0, utils_js_1.assertWarning)(false, `Being able to define config ${picocolors_1.default.cyan(configName)} in ${filePathToShowToUser} is experimental and will likely be removed. Define the config ${picocolors_1.default.cyan(configName)} in Vike's Vite plugin options instead.`, { onlyOnce: true });
             globalVikeConfig[configName] = configValueSource.value;
         }
-    });
+    }));
     return { pageConfigGlobal, globalVikeConfig };
 }
-function resolveConfigValueSources(configName, configDef, interfaceFilesRelevant, userRootDir) {
-    let sources = null;
+async function resolveConfigValueSources(configName, configDef, interfaceFilesRelevant, userRootDir, importedFilesLoaded) {
+    const sourcesInfo = [];
     // interfaceFilesRelevant is sorted by sortAfterInheritanceOrder()
     for (const interfaceFiles of Object.values(interfaceFilesRelevant)) {
         const interfaceFilesDefiningConfig = interfaceFiles.filter((interfaceFile) => interfaceFile.configMap[configName]);
         if (interfaceFilesDefiningConfig.length === 0)
             continue;
-        sources = sources ?? [];
         const visited = new WeakSet();
         const add = (interfaceFile) => {
             (0, utils_js_1.assert)(!visited.has(interfaceFile));
             visited.add(interfaceFile);
-            const configValueSource = getConfigValueSource(configName, interfaceFile, configDef, userRootDir);
-            sources.push(configValueSource);
+            sourcesInfo.push([configName, interfaceFile, configDef, userRootDir, importedFilesLoaded]);
         };
         // Main resolution logic
         {
@@ -389,7 +396,7 @@ function resolveConfigValueSources(configName, configDef, interfaceFilesRelevant
             if (interfaceFileWinner) {
                 const interfaceFilesOverriden = [...interfaceValueFiles, ...interfaceConfigFiles].filter((f) => f !== interfaceFileWinner);
                 // A user-land conflict of interfaceFiles with the same locationId means that the user has superfluously defined the config twice; the user should remove such redundancy making things unnecessarily ambiguous
-                warnOverridenConfigValues(interfaceFileWinner, interfaceFilesOverriden, configName, configDef, userRootDir);
+                warnOverridenConfigValues(interfaceFileWinner, interfaceFilesOverriden, configName);
                 [interfaceFileWinner, ...interfaceFilesOverriden].forEach((interfaceFile) => {
                     add(interfaceFile);
                 });
@@ -414,7 +421,7 @@ function resolveConfigValueSources(configName, configDef, interfaceFilesRelevant
             (0, utils_js_1.assert)(visited.has(interfaceFile));
         });
     }
-    (0, utils_js_1.assert)(sources === null || sources.length > 0);
+    const sources = await Promise.all(sourcesInfo.map(async (args) => await getConfigValueSource(...args)));
     return sources;
 }
 function makeOrderDeterministic(interfaceFile1, interfaceFile2) {
@@ -425,41 +432,41 @@ function makeOrderDeterministic(interfaceFile1, interfaceFile2) {
         return filePathRelativeToUserRootDir.length;
     })(interfaceFile1, interfaceFile2);
 }
-function warnOverridenConfigValues(interfaceFileWinner, interfaceFilesOverriden, configName, configDef, userRootDir) {
+function warnOverridenConfigValues(interfaceFileWinner, interfaceFilesOverriden, configName) {
     interfaceFilesOverriden.forEach((interfaceFileLoser) => {
-        const configValueSourceWinner = getConfigValueSource(configName, interfaceFileWinner, configDef, userRootDir);
-        const configValueSourceLoser = getConfigValueSource(configName, interfaceFileLoser, configDef, userRootDir);
-        (0, utils_js_1.assertWarning)(false, `${getConfigSourceDefinedAtString(configName, configValueSourceLoser, undefined, true)} overriden by another ${getConfigSourceDefinedAtString(configName, configValueSourceWinner, undefined, false)}, remove one of the two`, { onlyOnce: false });
+        const loserFilePath = interfaceFileLoser.filePath.filePathToShowToUser;
+        const winnerFilePath = interfaceFileWinner.filePath.filePathToShowToUser;
+        (0, utils_js_1.assertWarning)(false, `Config ${configName} defined at ${loserFilePath} is always overwritten by ${configName} defined at ${winnerFilePath}, remove the superfluous ${configName} value defined at ${interfaceFileLoser}`, { onlyOnce: false });
     });
 }
 function isInterfaceFileUserLand(interfaceFile) {
     return (interfaceFile.isConfigFile && !interfaceFile.isConfigExtend) || interfaceFile.isValueFile;
 }
-function getConfigValueSource(configName, interfaceFile, configDef, userRootDir) {
+async function getConfigValueSource(configName, interfaceFile, configDef, userRootDir, importedFilesLoaded) {
     const conf = interfaceFile.configMap[configName];
     (0, utils_js_1.assert)(conf);
     const configEnv = configDef.env;
     const definedAtConfigFile = {
         ...interfaceFile.filePath,
-        fileExportPath: ['default', configName]
+        fileExportPathToShowToUser: ['default', configName]
     };
     if (configDef._valueIsFilePath) {
-        let definedAtInfo;
+        let definedAt;
         let valueFilePath;
         if (interfaceFile.isConfigFile) {
             const { configValue } = conf;
             const import_ = resolveImport(configValue, interfaceFile.filePath, userRootDir, configEnv, configName);
-            const configDefinedAt = getConfigSourceDefinedAtString(configName, { definedAtInfo: definedAtConfigFile });
+            const configDefinedAt = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, { definedAt: definedAtConfigFile });
             (0, utils_js_1.assertUsage)(import_, `${configDefinedAt} should be an import`);
-            valueFilePath = import_.filePathRelativeToUserRootDir ?? import_.importPathAbsolute;
-            definedAtInfo = import_;
+            valueFilePath = import_.filePathAbsoluteVite;
+            definedAt = import_;
         }
         else {
             (0, utils_js_1.assert)(interfaceFile.isValueFile);
-            valueFilePath = interfaceFile.filePath.filePathRelativeToUserRootDir;
-            definedAtInfo = {
+            valueFilePath = interfaceFile.filePath.filePathAbsoluteVite;
+            definedAt = {
                 ...interfaceFile.filePath,
-                fileExportPath: []
+                fileExportPathToShowToUser: []
             };
         }
         const configValueSource = {
@@ -467,7 +474,7 @@ function getConfigValueSource(configName, interfaceFile, configDef, userRootDir)
             valueIsFilePath: true,
             configEnv,
             valueIsImportedAtRuntime: true,
-            definedAtInfo
+            definedAt
         };
         return configValueSource;
     }
@@ -479,8 +486,20 @@ function getConfigValueSource(configName, interfaceFile, configDef, userRootDir)
             const configValueSource = {
                 configEnv,
                 valueIsImportedAtRuntime: true,
-                definedAtInfo: import_
+                definedAt: import_
             };
+            // Load config value
+            if (isConfigEnv(configDef, configName)) {
+                if (import_.filePathAbsoluteFilesystem) {
+                    (0, utils_js_1.assert)((0, utils_js_1.hasProp)(import_, 'filePathAbsoluteFilesystem', 'string')); // Help TS
+                    const fileExports = await loadImportedFile(import_, userRootDir, importedFilesLoaded);
+                    configValueSource.value = fileExports[import_.fileExportName];
+                }
+                else {
+                    const configDefinedAt = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, configValueSource);
+                    (0, utils_js_1.assertUsage)(!configDef.cumulative, `${configDefinedAt} cannot be defined over an aliased import`);
+                }
+            }
             return configValueSource;
         }
         else {
@@ -488,7 +507,7 @@ function getConfigValueSource(configName, interfaceFile, configDef, userRootDir)
                 value: configValue,
                 configEnv,
                 valueIsImportedAtRuntime: false,
-                definedAtInfo: definedAtConfigFile
+                definedAt: definedAtConfigFile
             };
             return configValueSource;
         }
@@ -498,9 +517,9 @@ function getConfigValueSource(configName, interfaceFile, configDef, userRootDir)
         const configValueSource = {
             configEnv,
             valueIsImportedAtRuntime: !valueAlreadyLoaded,
-            definedAtInfo: {
+            definedAt: {
                 ...interfaceFile.filePath,
-                fileExportPath: configName === interfaceFile.configName
+                fileExportPathToShowToUser: configName === interfaceFile.configName
                     ? []
                     : // Side-effect config (e.g. `export { frontmatter }` of .md files)
                         [configName]
@@ -551,51 +570,61 @@ function resolveImport(configValue, importerFilePath, userRootDir, configEnv, co
     if (!importData)
         return null;
     const { importPath, exportName } = importData;
-    const filePathAbsolute = resolveImportPath(importData, importerFilePath);
-    assertFileEnv(filePathAbsolute ?? importPath, configEnv, configName);
-    const fileExportPath = exportName === 'default' || exportName === configName ? [] : [exportName];
+    const filePathAbsoluteFilesystem = resolveImportPath(importData, importerFilePath);
+    assertFileEnv(filePathAbsoluteFilesystem ?? importPath, configEnv, configName);
+    const fileExportPathToShowToUser = exportName === 'default' || exportName === configName ? [] : [exportName];
     if (importPath.startsWith('.')) {
         // We need to resolve relative paths into absolute paths. Because the import paths are included in virtual files:
         // ```
         // [vite] Internal server error: Failed to resolve import "./onPageTransitionHooks" from "virtual:vike:pageConfigValuesAll:client:/pages/index". Does the file exist?
         // ```
-        assertImportPath(filePathAbsolute, importData, importerFilePath);
-        const filePathRelativeToUserRootDir = resolveImportPath_relativeToUserRootDir(filePathAbsolute, importData, importerFilePath, userRootDir);
-        return {
-            exportName,
-            fileExportPath,
-            filePathAbsolute,
+        assertImportPath(filePathAbsoluteFilesystem, importData, importerFilePath);
+        const filePathRelativeToUserRootDir = resolveImportPath_relativeToUserRootDir(filePathAbsoluteFilesystem, importData, importerFilePath, userRootDir);
+        const filePath = {
+            filePathAbsoluteFilesystem,
             filePathRelativeToUserRootDir,
+            filePathAbsoluteVite: filePathRelativeToUserRootDir,
+            filePathToShowToUser: filePathRelativeToUserRootDir,
             importPathAbsolute: null
         };
+        return {
+            ...filePath,
+            fileExportName: exportName,
+            fileExportPathToShowToUser
+        };
     }
     else {
         // importPath can be:
         //  - an npm package import
         //  - a path alias
-        return {
-            exportName,
-            fileExportPath,
-            filePathAbsolute,
+        const filePath = {
+            filePathAbsoluteFilesystem,
             filePathRelativeToUserRootDir: null,
+            filePathAbsoluteVite: importPath,
+            filePathToShowToUser: importPath,
             importPathAbsolute: importPath
         };
+        return {
+            ...filePath,
+            fileExportName: exportName,
+            fileExportPathToShowToUser
+        };
     }
 }
-function resolveImportPath_relativeToUserRootDir(filePathAbsolute, importData, configFilePath, userRootDir) {
+function resolveImportPath_relativeToUserRootDir(filePathAbsoluteFilesystem, importData, configFilePath, userRootDir) {
     (0, utils_js_1.assertPosixPath)(userRootDir);
     let filePathRelativeToUserRootDir;
-    if (filePathAbsolute.startsWith(userRootDir)) {
-        filePathRelativeToUserRootDir = getVitePathFromAbsolutePath(filePathAbsolute, userRootDir);
+    if (filePathAbsoluteFilesystem.startsWith(userRootDir)) {
+        filePathRelativeToUserRootDir = getVitePathFromAbsolutePath(filePathAbsoluteFilesystem, userRootDir);
     }
     else {
-        (0, utils_js_1.assertUsage)(false, `${(0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(configFilePath)} imports from a relative path ${picocolors_1.default.cyan(importData.importPath)} outside of ${userRootDir} which is forbidden: import from a relative path inside ${userRootDir}, or import from a dependency's package.json#exports entry instead`);
+        (0, utils_js_1.assertUsage)(false, `${configFilePath.filePathToShowToUser} imports from a relative path ${picocolors_1.default.cyan(importData.importPath)} outside of ${userRootDir} which is forbidden: import from a relative path inside ${userRootDir}, or import from a dependency's package.json#exports entry instead`);
         // None of the following works. Seems to be a Vite bug?
         // /*
-        // assert(filePathAbsolute.startsWith('/'))
-        // filePath = `/@fs${filePathAbsolute}`
+        // assert(filePathAbsoluteFilesystem.startsWith('/'))
+        // filePath = `/@fs${filePathAbsoluteFilesystem}`
         // /*/
-        // filePathRelativeToUserRootDir = path.posix.relative(userRootDir, filePathAbsolute)
+        // filePathRelativeToUserRootDir = path.posix.relative(userRootDir, filePathAbsoluteFilesystem)
         // assert(filePathRelativeToUserRootDir.startsWith('../'))
         // filePathRelativeToUserRootDir = '/' + filePathRelativeToUserRootDir
         // //*/
@@ -604,11 +633,11 @@ function resolveImportPath_relativeToUserRootDir(filePathAbsolute, importData, c
     (0, utils_js_1.assert)(filePathRelativeToUserRootDir.startsWith('/'));
     return filePathRelativeToUserRootDir;
 }
-function getVitePathFromAbsolutePath(filePathAbsolute, root) {
-    (0, utils_js_1.assertPosixPath)(filePathAbsolute);
+function getVitePathFromAbsolutePath(filePathAbsoluteFilesystem, root) {
+    (0, utils_js_1.assertPosixPath)(filePathAbsoluteFilesystem);
     (0, utils_js_1.assertPosixPath)(root);
-    (0, utils_js_1.assert)(filePathAbsolute.startsWith(root));
-    let vitePath = path_1.default.posix.relative(root, filePathAbsolute);
+    (0, utils_js_1.assert)(filePathAbsoluteFilesystem.startsWith(root));
+    let vitePath = path_1.default.posix.relative(root, filePathAbsoluteFilesystem);
     (0, utils_js_1.assert)(!vitePath.startsWith('/') && !vitePath.startsWith('.'));
     vitePath = '/' + vitePath;
     return vitePath;
@@ -621,9 +650,17 @@ function getConfigDefinitions(interfaceFilesRelevant) {
             if (!configMeta)
                 return;
             const meta = configMeta.configValue;
-            assertMetaValue(meta, 
-            // Maybe we should use the getConfigDefinedAtString() helper?
-            `Config ${picocolors_1.default.cyan('meta')} defined at ${(0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(interfaceFile.filePath)}`);
+            assertMetaValue(meta, `Config ${picocolors_1.default.cyan('meta')} defined at ${interfaceFile.filePath.filePathToShowToUser}`);
+            // Set configDef._userEffectDefinedAt
+            Object.entries(meta).forEach(([configName, configDef]) => {
+                if (!configDef.effect)
+                    return;
+                (0, utils_js_1.assert)(interfaceFile.isConfigFile);
+                configDef._userEffectDefinedAt = {
+                    ...interfaceFile.filePath,
+                    fileExportPathToShowToUser: ['default', 'meta', configName, 'effect']
+                };
+            });
             (0, utils_js_1.objectEntries)(meta).forEach(([configName, configDefinition]) => {
                 // User can override an existing config definition
                 configDefinitions[configName] = {
@@ -636,9 +673,15 @@ function getConfigDefinitions(interfaceFilesRelevant) {
     return configDefinitions;
 }
 function assertMetaValue(metaVal, configMetaDefinedAt) {
-    (0, utils_js_1.assertUsage)((0, utils_js_1.isObject)(metaVal), `${configMetaDefinedAt} has an invalid type ${picocolors_1.default.cyan(typeof metaVal)}: it should be an object instead.`);
+    if (!(0, utils_js_1.isObject)(metaVal)) {
+        (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+        (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} has an invalid type ${picocolors_1.default.cyan(typeof metaVal)}: it should be an object instead.`);
+    }
     (0, utils_js_1.objectEntries)(metaVal).forEach(([configName, def]) => {
-        (0, utils_js_1.assertUsage)((0, utils_js_1.isObject)(def), `${configMetaDefinedAt} sets meta.${configName} to a value with an invalid type ${picocolors_1.default.cyan(typeof def)}: it should be an object instead.`);
+        if (!(0, utils_js_1.isObject)(def)) {
+            (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+            (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} 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.`);
+        }
         // env
         {
             const envValues = [
@@ -647,19 +690,34 @@ function assertMetaValue(metaVal, configMetaDefinedAt) {
                 'server-and-client',
                 'config-only'
             ];
-            const hint = [
-                `Set the value of ${picocolors_1.default.cyan('env')} to `,
+            const fix = [
+                `Set the value of ${picocolors_1.default.cyan(`meta.${configName}.env`)} to `,
                 (0, utils_js_1.joinEnglish)(envValues.map((s) => picocolors_1.default.cyan(`'${s}'`)), 'or'),
                 '.'
             ].join('');
-            (0, utils_js_1.assertUsage)('env' in def, `${configMetaDefinedAt} doesn't set meta.${configName}.env but it's required. ${hint}`);
-            (0, utils_js_1.assertUsage)((0, utils_js_1.hasProp)(def, 'env', 'string'), `${configMetaDefinedAt} sets meta.${configName}.env to an invalid type ${picocolors_1.default.cyan(typeof def.env)}. ${hint}`);
-            (0, utils_js_1.assertUsage)(envValues.includes(def.env), `${configMetaDefinedAt} sets meta.${configName}.env to an invalid value ${picocolors_1.default.cyan(`'${def.env}'`)}. ${hint}`);
+            if (!('env' in def)) {
+                (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+                (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} doesn't set ${picocolors_1.default.cyan(`meta.${configName}.env`)} but it's required. ${fix}`);
+            }
+            if (!(0, utils_js_1.hasProp)(def, 'env', 'string')) {
+                (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+                (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} sets ${picocolors_1.default.cyan(`meta.${configName}.env`)} to an invalid type ${picocolors_1.default.cyan(typeof def.env)}. ${fix}`);
+            }
+            if (!envValues.includes(def.env)) {
+                (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+                (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} sets ${picocolors_1.default.cyan(`meta.${configName}.env`)} to an unknown value ${picocolors_1.default.cyan(`'${def.env}'`)}. ${fix}`);
+            }
         }
         // effect
         if ('effect' in def) {
-            (0, utils_js_1.assertUsage)((0, utils_js_1.hasProp)(def, 'effect', 'function'), `${configMetaDefinedAt} sets meta.${configName}.effect to an invalid type ${picocolors_1.default.cyan(typeof def.effect)}: it should be a function instead`);
-            (0, utils_js_1.assertUsage)(def.env === 'config-only', `${configMetaDefinedAt} sets meta.${configName}.effect but it's only supported if meta.${configName}.env is ${picocolors_1.default.cyan('config-only')} (but it's ${picocolors_1.default.cyan(def.env)} instead)`);
+            if (!(0, utils_js_1.hasProp)(def, 'effect', 'function')) {
+                (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+                (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} sets ${picocolors_1.default.cyan(`meta.${configName}.effect`)} to an invalid type ${picocolors_1.default.cyan(typeof def.effect)}: it should be a function instead`);
+            }
+            if (def.env !== 'config-only') {
+                (0, utils_js_1.assert)(configMetaDefinedAt); // We expect internal effects to return a valid meta value
+                (0, utils_js_1.assertUsage)(false, `${configMetaDefinedAt} sets ${picocolors_1.default.cyan(`meta.${configName}.effect`)} but it's only supported if meta.${configName}.env is ${picocolors_1.default.cyan('config-only')} (but it's ${picocolors_1.default.cyan(def.env)} instead)`);
+            }
         }
     });
 }
@@ -670,7 +728,7 @@ function applyEffectsAll(configValueSources, configDefinitionsRelevant) {
         // The value needs to be loaded at config time, that's why we only support effect for configs that are config-only for now.
         // (We could support effect for non config-only by always loading its value at config time, regardless of the config's `env` value.)
         (0, utils_js_1.assertUsage)(configDef.env === 'config-only', [
-            `Cannot add effect to ${picocolors_1.default.cyan(configName)} because its ${picocolors_1.default.cyan('env')} is ${picocolors_1.default.cyan(configDef.env)}: effects can only be added to configs with an env that is ${picocolors_1.default.cyan('config-only')}.`
+            `Cannot add effect to ${picocolors_1.default.cyan(configName)} because its ${picocolors_1.default.cyan('env')} is ${picocolors_1.default.cyan(configDef.env)}: effects can only be added to configs with an ${picocolors_1.default.cyan('env')} value of ${picocolors_1.default.cyan('config-only')}.`
         ].join(' '));
         const source = configValueSources[configName]?.[0];
         if (!source)
@@ -680,19 +738,28 @@ function applyEffectsAll(configValueSources, configDefinitionsRelevant) {
         // Call effect
         const configModFromEffect = configDef.effect({
             configValue: source.value,
-            configDefinedAt: getConfigSourceDefinedAtString(configName, source)
+            configDefinedAt: (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, source)
         });
         if (!configModFromEffect)
             return;
         (0, utils_js_1.assert)((0, utils_js_1.hasProp)(source, 'value')); // We need to assume that the config value is loaded at build-time
-        applyEffect(configModFromEffect, source, configValueSources);
+        applyEffect(configModFromEffect, configValueSources, configDef);
     });
 }
-function applyEffect(configModFromEffect, configValueEffectSource, configValueSources) {
+function applyEffect(configModFromEffect, configValueSources, configDefEffect) {
     const notSupported = `Effects currently only supports modifying the the ${picocolors_1.default.cyan('env')} of a config.`;
     (0, utils_js_1.objectEntries)(configModFromEffect).forEach(([configName, configValue]) => {
         if (configName === 'meta') {
-            assertMetaValue(configValue, getConfigSourceDefinedAtString(configName, configValueEffectSource, true));
+            let configDefinedAtString;
+            if (configDefEffect._userEffectDefinedAt) {
+                configDefinedAtString = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, {
+                    definedAt: configDefEffect._userEffectDefinedAt
+                });
+            }
+            else {
+                configDefinedAtString = null;
+            }
+            assertMetaValue(configValue, configDefinedAtString);
             (0, utils_js_1.objectEntries)(configValue).forEach(([configTargetName, configTargetDef]) => {
                 {
                     const keys = Object.keys(configTargetDef);
@@ -710,7 +777,7 @@ function applyEffect(configModFromEffect, configValueEffectSource, configValueSo
         else {
             (0, utils_js_1.assertUsage)(false, notSupported);
             // If we do end implementing being able to set the value of a config:
-            //  - For setting definedAtInfo: we could take the definedAtInfo of the effect config while appending '(effect)' to definedAtInfo.fileExportPath
+            //  - For setting definedAt: we could take the definedAt of the effect config while appending '(effect)' to definedAt.fileExportPathToShowToUser
         }
     });
 }
@@ -761,20 +828,29 @@ async function findPlusFiles(userRootDir, ignoreDirs, isDev, extensions) {
     const plusFiles = result.map((p) => {
         p = (0, utils_js_1.toPosixPath)(p);
         const filePathRelativeToUserRootDir = path_1.default.posix.join('/', p);
-        const filePathAbsolute = path_1.default.posix.join(userRootDir, p);
-        return { filePathRelativeToUserRootDir, filePathAbsolute };
+        const filePathAbsoluteFilesystem = path_1.default.posix.join(userRootDir, p);
+        return {
+            filePathRelativeToUserRootDir,
+            filePathAbsoluteVite: filePathRelativeToUserRootDir,
+            filePathAbsoluteFilesystem,
+            filePathToShowToUser: filePathRelativeToUserRootDir,
+            importPathAbsolute: null
+        };
     });
+    // TODO/v1-release: remove
     extensions.forEach((extension) => {
         extension.pageConfigsDistFiles?.forEach((pageConfigDistFile) => {
-            // TODO/v1-release: remove
             if (!pageConfigDistFile.importPath.includes('+'))
                 return;
             (0, utils_js_1.assert)(pageConfigDistFile.importPath.includes('+'));
             (0, utils_js_1.assert)(path_1.default.posix.basename(pageConfigDistFile.importPath).startsWith('+'));
             const { importPath, filePath } = pageConfigDistFile;
             plusFiles.push({
-                filePathRelativeToUserRootDir: importPath,
-                filePathAbsolute: filePath
+                filePathRelativeToUserRootDir: null,
+                filePathAbsoluteVite: importPath,
+                filePathAbsoluteFilesystem: filePath,
+                filePathToShowToUser: importPath,
+                importPathAbsolute: importPath
             });
         });
     });
@@ -804,12 +880,12 @@ function assertNoUnexpectedPlusSign(filePath, fileName) {
     (0, utils_js_1.assertUsage)(!fileName.slice(1).includes('+'), `Character '+' is only allowed at the beginning of filenames: make sure ${filePath} doesn't contain any '+' in its filename other than its first letter`);
 }
 async function loadConfigFile(configFilePath, userRootDir, visited) {
-    const { filePathAbsolute } = configFilePath;
-    assertNoInfiniteLoop(visited, filePathAbsolute);
+    const { filePathAbsoluteFilesystem } = configFilePath;
+    assertNoInfiniteLoop(visited, filePathAbsoluteFilesystem);
     const { fileExports } = await (0, transpileAndExecuteFile_js_1.transpileAndExecuteFile)(configFilePath, false, userRootDir);
     const { extendsConfigs, extendsFilePaths } = await loadExtendsConfigs(fileExports, configFilePath, userRootDir, [
         ...visited,
-        filePathAbsolute
+        filePathAbsoluteFilesystem
     ]);
     const configFile = {
         fileExports,
@@ -818,31 +894,31 @@ async function loadConfigFile(configFilePath, userRootDir, visited) {
     };
     return { configFile, extendsConfigs };
 }
-function assertNoInfiniteLoop(visited, filePathAbsolute) {
-    const idx = visited.indexOf(filePathAbsolute);
+function assertNoInfiniteLoop(visited, filePathAbsoluteFilesystem) {
+    const idx = visited.indexOf(filePathAbsoluteFilesystem);
     if (idx === -1)
         return;
     const loop = visited.slice(idx);
-    (0, utils_js_1.assert)(loop[0] === filePathAbsolute);
-    (0, utils_js_1.assertUsage)(idx === -1, `Infinite extends loop ${[...loop, filePathAbsolute].join('>')}`);
+    (0, utils_js_1.assert)(loop[0] === filePathAbsoluteFilesystem);
+    (0, utils_js_1.assertUsage)(idx === -1, `Infinite extends loop ${[...loop, filePathAbsoluteFilesystem].join('>')}`);
 }
 async function loadExtendsConfigs(configFileExports, configFilePath, userRootDir, visited) {
     const extendsImportData = getExtendsImportData(configFileExports, configFilePath);
     const extendsConfigFiles = [];
     extendsImportData.map((importData) => {
         const { importPath: importPath } = importData;
-        // TODO
-        //  - validate extends configs
-        const filePathAbsolute = resolveImportPath(importData, configFilePath);
-        assertImportPath(filePathAbsolute, importData, configFilePath);
-        assertExtendsImportPath(importPath, filePathAbsolute, configFilePath);
+        const filePathAbsoluteFilesystem = resolveImportPath(importData, configFilePath);
+        assertImportPath(filePathAbsoluteFilesystem, importData, configFilePath);
+        assertExtendsImportPath(importPath, filePathAbsoluteFilesystem, configFilePath);
         // - filePathRelativeToUserRootDir has no functionality beyond nicer error messages for user
-        // - Using importPath would be visually nicer but it's ambigous => we rather pick filePathAbsolute for added clarity
-        const filePathRelativeToUserRootDir = determineFilePathRelativeToUserDir(filePathAbsolute, userRootDir);
+        // - Using importPath would be visually nicer but it's ambigous => we rather pick filePathAbsoluteFilesystem for added clarity
+        const filePathRelativeToUserRootDir = determineFilePathRelativeToUserDir(filePathAbsoluteFilesystem, userRootDir);
+        const filePathAbsoluteVite = filePathRelativeToUserRootDir ?? importPath;
         extendsConfigFiles.push({
-            filePathAbsolute,
-            // TODO: fix type cast
-            filePathRelativeToUserRootDir: filePathRelativeToUserRootDir,
+            filePathAbsoluteFilesystem,
+            filePathAbsoluteVite,
+            filePathRelativeToUserRootDir,
+            filePathToShowToUser: filePathAbsoluteVite,
             importPathAbsolute: importPath
         });
     });
@@ -852,16 +928,16 @@ async function loadExtendsConfigs(configFileExports, configFilePath, userRootDir
         extendsConfigs.push(result.configFile);
         extendsConfigs.push(...result.extendsConfigs);
     }));
-    const extendsFilePaths = extendsConfigFiles.map((f) => f.filePathAbsolute);
+    const extendsFilePaths = extendsConfigFiles.map((f) => f.filePathAbsoluteFilesystem);
     return { extendsConfigs, extendsFilePaths };
 }
-function determineFilePathRelativeToUserDir(filePathAbsolute, userRootDir) {
-    (0, utils_js_1.assertPosixPath)(filePathAbsolute);
+function determineFilePathRelativeToUserDir(filePathAbsoluteFilesystem, userRootDir) {
+    (0, utils_js_1.assertPosixPath)(filePathAbsoluteFilesystem);
     (0, utils_js_1.assertPosixPath)(userRootDir);
-    if (!filePathAbsolute.startsWith(userRootDir)) {
+    if (!filePathAbsoluteFilesystem.startsWith(userRootDir)) {
         return null;
     }
-    let filePathRelativeToUserRootDir = filePathAbsolute.slice(userRootDir.length);
+    let filePathRelativeToUserRootDir = filePathAbsoluteFilesystem.slice(userRootDir.length);
     if (!filePathRelativeToUserRootDir.startsWith('/'))
         filePathRelativeToUserRootDir = '/' + filePathRelativeToUserRootDir;
     return filePathRelativeToUserRootDir;
@@ -878,14 +954,14 @@ function assertExtendsImportPath(importPath, filePath, configFilePath) {
         });
     }
     else {
-        (0, utils_js_1.assertWarning)(false, `${(0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(configFilePath)} uses ${picocolors_1.default.cyan('extends')} to inherit from ${picocolors_1.default.cyan(importPath)} which is a user-land file: this is experimental and may be remove at any time. Reach out to a maintainer if you need this feature.`, { onlyOnce: true });
+        (0, utils_js_1.assertWarning)(false, `${configFilePath.filePathToShowToUser} uses ${picocolors_1.default.cyan('extends')} to inherit from ${picocolors_1.default.cyan(importPath)} which is a user-land file: this is experimental and may be remove at any time. Reach out to a maintainer if you need this feature.`, { onlyOnce: true });
     }
 }
 function getExtendsImportData(configFileExports, configFilePath) {
-    const filePathToShowToUser = (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(configFilePath);
+    const { filePathToShowToUser } = configFilePath;
     (0, assertExports_js_1.assertExportsOfConfigFile)(configFileExports, filePathToShowToUser);
     const defaultExports = configFileExports.default;
-    const wrongUsage = `${filePathToShowToUser} sets the config 'extends' to an invalid value, see https://vike.dev/extends`;
+    const wrongUsage = `${filePathToShowToUser} sets the config ${picocolors_1.default.cyan('extends')} to an invalid value, see https://vike.dev/extends`;
     let extendList;
     if (!('extends' in defaultExports)) {
         return [];
@@ -906,38 +982,6 @@ function getExtendsImportData(configFileExports, configFilePath) {
     });
     return extendsImportData;
 }
-// TODO: re-use this
-function handleUserFileError(err, isDev) {
-    // Properly handle error during transpilation so that we can use assertUsage() during transpilation
-    if (isDev) {
-        throw err;
-    }
-    else {
-        // Avoid ugly error format:
-        // ```
-        // [vike:importUserCode] Could not load virtual:vike:importUserCode:server: [vike@0.4.70][Wrong Usage] /pages/+config.ts sets the config 'onRenderHtml' to the value './+config/onRenderHtml-i-dont-exist.js' but no file was found at /home/rom/code/vike/examples/v1/pages/+config/onRenderHtml-i-dont-exist.js
-        // Error: [vike@0.4.70][Wrong Usage] /pages/+config.ts sets the config 'onRenderHtml' to the value './+config/onRenderHtml-i-dont-exist.js' but no file was found at /home/rom/code/vike/examples/v1/pages/+config/onRenderHtml-i-dont-exist.js
-        //     at ...
-        //     at ...
-        //     at ...
-        //     at ...
-        //     at ...
-        //     at ...
-        //   code: 'PLUGIN_ERROR',
-        //   plugin: 'vike:importUserCode',
-        //   hook: 'load',
-        //   watchFiles: [
-        //     '/home/rom/code/vike/vike/dist/esm/node/importBuild.js',
-        //     '\x00virtual:vike:importUserCode:server'
-        //   ]
-        // }
-        //  ELIFECYCLE  Command failed with exit code 1.
-        // ```
-        console.log('');
-        console.error(err);
-        process.exit(1);
-    }
-}
 function isGlobalConfig(configName) {
     if (configName === 'prerender')
         return false;
@@ -947,15 +991,15 @@ function isGlobalConfig(configName) {
 function getConfigNamesGlobal() {
     return Object.keys(configDefinitionsBuiltIn_js_1.configDefinitionsBuiltInGlobal);
 }
-function assertConfigExists(configName, configNamesRelevant, definedByFile) {
+function assertConfigExists(configName, configNamesRelevant, filePathToShowToUser) {
     const configNames = [...configNamesRelevant, ...getConfigNamesGlobal()];
     if (configNames.includes(configName))
         return;
-    handleUnknownConfig(configName, configNames, definedByFile);
+    handleUnknownConfig(configName, configNames, filePathToShowToUser);
     (0, utils_js_1.assert)(false);
 }
-function handleUnknownConfig(configName, configNames, definedByFile) {
-    let errMsg = `${definedByFile} defines an unknown config ${picocolors_1.default.cyan(configName)}`;
+function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
+    let errMsg = `${filePathToShowToUser} defines an unknown config ${picocolors_1.default.cyan(configName)}`;
     let configNameSimilar = null;
     if (configName === 'page') {
         configNameSimilar = 'Page';
@@ -987,11 +1031,11 @@ function determineRouteFilesystem(locationId, configValueSources) {
     if (configFilesystemRoutingRoot) {
         const routingRoot = getFilesystemRoutingRootEffect(configFilesystemRoutingRoot, configName);
         if (routingRoot) {
-            const { filesystemRoutingRootEffect, filesystemRoutingRootDefinedAt } = routingRoot;
+            const { filesystemRoutingRootEffect /*, filesystemRoutingRootDefinedAt*/ } = routingRoot;
             const debugInfo = { locationId, routeFilesystem: filesystemRouteString, configFilesystemRoutingRoot };
             (0, utils_js_1.assert)(filesystemRouteString.startsWith(filesystemRoutingRootEffect.before), debugInfo);
             filesystemRouteString = (0, filesystemRouting_js_1.applyFilesystemRoutingRootEffect)(filesystemRouteString, filesystemRoutingRootEffect);
-            filesystemRouteDefinedBy = `${filesystemRouteDefinedBy} (with ${filesystemRoutingRootDefinedAt})`;
+            // filesystemRouteDefinedBy = `${filesystemRouteDefinedBy} (with ${filesystemRoutingRootDefinedAt})`
         }
     }
     (0, utils_js_1.assert)(filesystemRouteString.startsWith('/'));
@@ -1006,10 +1050,10 @@ function getFilesystemRoutingRootEffect(configFilesystemRoutingRoot, configName)
     // Eagerly loaded since it's config-only
     (0, utils_js_1.assert)('value' in configFilesystemRoutingRoot);
     const { value } = configFilesystemRoutingRoot;
-    const configDefinedAt = getConfigSourceDefinedAtString(configName, configFilesystemRoutingRoot);
+    const configDefinedAt = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, configFilesystemRoutingRoot);
     (0, utils_js_1.assertUsage)(typeof value === 'string', `${configDefinedAt} should be a string`);
     (0, utils_js_1.assertUsage)(value.startsWith('/'), `${configDefinedAt} is ${picocolors_1.default.cyan(value)} but it should start with a leading slash ${picocolors_1.default.cyan('/')}`);
-    const { filePathRelativeToUserRootDir } = configFilesystemRoutingRoot.definedAtInfo;
+    const { filePathRelativeToUserRootDir } = configFilesystemRoutingRoot.definedAt;
     (0, utils_js_1.assert)(filePathRelativeToUserRootDir);
     const before = (0, filesystemRouting_js_1.getFilesystemRouteString)((0, filesystemRouting_js_1.getLocationId)(filePathRelativeToUserRootDir));
     const after = value;
@@ -1021,17 +1065,17 @@ function determineIsErrorPage(routeFilesystem) {
     return routeFilesystem.split('/').includes('_error');
 }
 function resolveImportPath(importData, importerFilePath) {
-    const importerFilePathAbsolute = importerFilePath.filePathAbsolute;
+    const importerFilePathAbsolute = importerFilePath.filePathAbsoluteFilesystem;
     (0, utils_js_1.assertPosixPath)(importerFilePathAbsolute);
     const cwd = path_1.default.posix.dirname(importerFilePathAbsolute);
-    // filePathAbsolute is expected to be null when importData.importPath is a Vite path alias
-    const filePathAbsolute = (0, utils_js_1.requireResolve)(importData.importPath, cwd);
-    return filePathAbsolute;
+    // filePathAbsoluteFilesystem is expected to be null when importData.importPath is a Vite path alias
+    const filePathAbsoluteFilesystem = (0, utils_js_1.requireResolve)(importData.importPath, cwd);
+    return filePathAbsoluteFilesystem;
 }
-function assertImportPath(filePathAbsolute, importData, importerFilePath) {
+function assertImportPath(filePathAbsoluteFilesystem, importData, importerFilePath) {
     const { importPath: importPath, importStringWasGenerated, importString } = importData;
-    const filePathToShowToUser = (0, getFilePathToShowToUser_js_1.getFilePathToShowToUser)(importerFilePath);
-    if (!filePathAbsolute) {
+    const { filePathToShowToUser } = importerFilePath;
+    if (!filePathAbsoluteFilesystem) {
         const importPathString = picocolors_1.default.cyan(`'${importPath}'`);
         const errIntro = importStringWasGenerated
             ? `The import path ${importPathString} in ${filePathToShowToUser}`
@@ -1074,7 +1118,6 @@ function getConfigValues(configValueSources, configValuesComputed, configDefinit
             configValues[configName] = {
                 value,
                 definedAt: {
-                    isCumulative: true,
                     files: sources.map((source) => getDefinedAtFile(source))
                 }
             };
@@ -1082,18 +1125,23 @@ function getConfigValues(configValueSources, configValuesComputed, configDefinit
     });
     return configValues;
 }
+function getDefinedAtFile(configValueSource) {
+    return {
+        filePathToShowToUser: configValueSource.definedAt.filePathToShowToUser,
+        fileExportPathToShowToUser: configValueSource.definedAt.fileExportPathToShowToUser
+    };
+}
+function getDefinedAt(configValueSource) {
+    return getDefinedAtFile(configValueSource);
+}
 function mergeCumulative(configName, configValueSources) {
     const valuesArr = [];
     const valuesSet = [];
     let configValueSourcePrevious = null;
     configValueSources.forEach((configValueSource) => {
-        const configDefinedAt = getConfigSourceDefinedAtString(configName, configValueSource);
-        const configNameColored = picocolors_1.default.cyan(configName);
-        // We could, in principle, also support cumulative values to be defined in +${configName}.js but it ins't completely trivial to implement
-        (0, utils_js_1.assertUsage)('value' in configValueSource, `${configDefinedAt} is only allowed to be defined in a +config.h.js file. (Because the values of ${configNameColored} are cumulative.)`);
-        /* This is more confusing than adding value. For example, this explanation shouldn't be shown for the passToClient config.
-        const explanation = `(Because the values of ${configNameColored} are cumulative and therefore merged together.)` as const
-        */
+        const configDefinedAt = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, configValueSource);
+        // We could, in principle, also support cumulative for values that aren't loaded at config-time but it isn't completely trivial to implement.
+        (0, utils_js_1.assert)('value' in configValueSource);
         // Make sure configValueSource.value is serializable
         (0, getVirtualFilePageConfigs_js_1.getConfigValueSerialized)(configValueSource.value, configName, getDefinedAt(configValueSource));
         const assertNoMixing = (isSet) => {
@@ -1105,7 +1153,7 @@ function mergeCumulative(configName, configValueSources) {
             if (vals2.length === 0)
                 return;
             (0, utils_js_1.assert)(configValueSourcePrevious);
-            const configPreviousDefinedAt = getConfigSourceDefinedAtString(configName, configValueSourcePrevious, undefined, false);
+            const configPreviousDefinedAt = (0, helpers_js_1.getConfigDefinedAtString)('Config', configName, configValueSourcePrevious);
             (0, utils_js_1.assertUsage)(false, `${configDefinedAt} sets ${t1} but another ${configPreviousDefinedAt} sets ${t2} which is forbidden: the values must be all arrays or all sets (you cannot mix).`);
         };
         const { value } = configValueSource;
@@ -1136,30 +1184,3 @@ function mergeCumulative(configName, configValueSources) {
     }
     (0, utils_js_1.assert)(false);
 }
-// TODO: rename
-// TODO: refactor
-function getConfigSourceDefinedAtString(configName, { definedAtInfo }, isEffect = undefined, sentenceBegin = true) {
-    return (0, utils_js_2.getConfigDefinedAtString)(configName, {
-        definedAt: {
-            isEffect,
-            file: {
-                filePathToShowToUser: getDefinedAtFilePathToShowToUser(definedAtInfo),
-                fileExportPath: definedAtInfo.fileExportPath
-            }
-        }
-    }, sentenceBegin);
-}
-function getDefinedAtFilePathToShowToUser(definedAtInfo) {
-    return definedAtInfo.filePathRelativeToUserRootDir ?? definedAtInfo.importPathAbsolute;
-}
-function getDefinedAtFile(source) {
-    return {
-        filePathToShowToUser: getDefinedAtFilePathToShowToUser(source.definedAtInfo),
-        fileExportPath: source.definedAtInfo.fileExportPath
-    };
-}
-function getDefinedAt(configValueSource) {
-    return {
-        file: getDefinedAtFile(configValueSource)
-    };
-}