vike 0.4.235 → 0.4.236-commit-85d361d

package/dist/cjs/shared/getPageContextUrlComputed.js

@@ -40,7 +40,7 @@ function getUrlParsed(pageContext) {
     // Reproduction: https://github.com/vikejs/vike/discussions/1436#discussioncomment-8142023
     // Determine logical URL
     const assertUrlResolved = (src) => (0, utils_js_1.assert)(typeof urlResolved === 'string', 
-    // TODO/eventually: remove debug logs, see:
+    // TO-DO/eventually: remove debug logs, see:
     // - https://github.com/vikejs/vike/issues/2138#issuecomment-2631713411
     // - https://github.com/vikejs/vike/commit/5c7810f3080ab62536950f26e019bb2a3a517082
     { src, urlResolved });
@@ -85,7 +85,7 @@ function urlPathnameGetter() {
     return urlPathname;
 }
 function urlGetter() {
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     (0, utils_js_1.assertWarning)(false, '`pageContext.url` is outdated. Use `pageContext.urlPathname`, `pageContext.urlParsed`, or `pageContext.urlOriginal` instead. (See https://vike.dev/migration/0.4.23 for more information.)', { onlyOnce: true, showStackTrace: true });
     return urlPathnameGetter.call(this);
 }
@@ -107,7 +107,7 @@ function urlParsedGetter() {
             warnHashNotAvailable('hashOriginal');
             return urlParsed.hashOriginal;
         },
-        // TODO/next-major-release: remove
+        // TO-DO/next-major-release: remove
         get hashString() {
             (0, utils_js_1.assertWarning)(false, 'pageContext.urlParsed.hashString has been renamed to pageContext.urlParsed.hashOriginal', {
                 onlyOnce: true,
@@ -116,7 +116,7 @@ function urlParsedGetter() {
             warnHashNotAvailable('hashString');
             return urlParsed.hashOriginal;
         },
-        // TODO/next-major-release: remove
+        // TO-DO/next-major-release: remove
         get searchString() {
             (0, utils_js_1.assertWarning)(false, 'pageContext.urlParsed.searchString has been renamed to pageContext.urlParsed.searchOriginal', { onlyOnce: true, showStackTrace: true });
             return urlParsed.searchOriginal;

package/dist/cjs/shared/getPageFiles/analyzeClientSide.js

@@ -11,7 +11,7 @@ function analyzeClientSide(pageConfig, pageFilesAll, pageId) {
         return { isClientRuntimeLoaded, isClientRouting };
     }
     else {
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         // V0.4 design
         const { isHtmlOnly, isClientRouting } = (0, analyzePageClientSide_js_1.analyzePageClientSide)(pageFilesAll, pageId);
         return { isClientRuntimeLoaded: !isHtmlOnly, isClientRouting };

package/dist/cjs/shared/getPageFiles/analyzePageClientSide/analyzeExports.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeExports = analyzeExports;
 const getExportNames_js_1 = require("./getExportNames.js");
 const utils_js_1 = require("../../utils.js");
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 function analyzeExports({ pageFilesClientSide, pageFilesServerSide, pageId, }) {
     return { isHtmlOnly: isHtmlOnly(), isClientRouting: isClientRouting() };
     function isHtmlOnly() {

package/dist/cjs/shared/getPageFiles/analyzePageClientSide/determineClientEntry.js

@@ -1,5 +1,5 @@
 "use strict";
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.determineClientEntry = determineClientEntry;
 exports.getVikeClientEntry = getVikeClientEntry;

package/dist/cjs/shared/getPageFiles/analyzePageClientSide.js

@@ -8,7 +8,7 @@ const getAllPageIdFiles_js_1 = require("./getAllPageIdFiles.js");
 const getAllPageIdFiles_js_2 = require("./getAllPageIdFiles.js");
 const utils_js_1 = require("../utils.js");
 const getExportNames_js_1 = require("./analyzePageClientSide/getExportNames.js");
-// TODO/v1-release: remove analyzePageClientSide(), use analyzeClientSide() instead
+// TO-DO/next-major-release: remove analyzePageClientSide(), use analyzeClientSide() instead
 function analyzePageClientSide(pageFilesAll, pageId) {
     let pageFilesClientSide = (0, getAllPageIdFiles_js_1.getPageFilesClientSide)(pageFilesAll, pageId);
     const pageFilesServerSide = (0, getAllPageIdFiles_js_2.getPageFilesServerSide)(pageFilesAll, pageId);
@@ -26,7 +26,7 @@ function analyzePageClientSide(pageFilesAll, pageId) {
     });
     return { isHtmlOnly, isClientRouting, clientEntries, clientDependencies, pageFilesClientSide, pageFilesServerSide };
 }
-// TODO:v1-release: remove
+// TO-DO/next-major-release: remove
 async function analyzePageClientSideInit(pageFilesAll, pageId, { sharedPageFilesAlreadyLoaded }) {
     const pageFilesClientSide = (0, getAllPageIdFiles_js_1.getPageFilesClientSide)(pageFilesAll, pageId);
     await Promise.all(pageFilesClientSide.map(async (p) => {

package/dist/cjs/shared/getPageFiles/assert_exports_old_design.js

@@ -1,5 +1,5 @@
 "use strict";
-// TODO/v1-release: remove this
+// TO-DO/next-major-release: remove this
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.forbiddenDefaultExports = void 0;
 exports.assertDefaultExports = assertDefaultExports;

package/dist/cjs/shared/getPageFiles/fileTypes.js

@@ -1,5 +1,5 @@
 "use strict";
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fileTypes = void 0;
 exports.isValidFileType = isValidFileType;

package/dist/cjs/shared/getPageFiles/getAllPageIdFiles.js

@@ -1,5 +1,5 @@
 "use strict";
-// TODO:v1-release: remove this file
+// TO-DO/next-major-release: remove this file
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPageFilesClientSide = getPageFilesClientSide;
 exports.getPageFilesServerSide = getPageFilesServerSide;

package/dist/cjs/shared/getPageFiles/getPageFileObject.js

@@ -1,5 +1,5 @@
 "use strict";
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPageFileObject = getPageFileObject;
 const determinePageIdOld_js_1 = require("../determinePageIdOld.js");

package/dist/cjs/shared/getPageFiles/parseVirtualFileExports.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseVirtualFileExports = parseVirtualFileExports;
-// TODO/v1-release: remove old design code, and remove all assertions.
+// TO-DO/next-major-release: remove old design code, and remove all assertions.
 const utils_js_1 = require("../utils.js");
 const assert_exports_old_design_js_1 = require("./assert_exports_old_design.js");
 const getPageFileObject_js_1 = require("./getPageFileObject.js");

package/dist/cjs/shared/getProxyForPublicUsage.js

@@ -47,7 +47,7 @@ function onInternalProp(propStr, objName) {
     //     - If Rolldown Vite + Rolldowns always transpiles node_modules/ then we can simply use import.meta.env.SSR
     if ((0, utils_js_1.isBrowser)())
         return;
-    // TODO/now-proxy remove this and only warn on built-in access instead
+    // TO-DO/soon/proxy: remove this and only warn on built-in access instead
     if (propStr === '_configFromHook')
         return;
     if (propStr.startsWith('_')) {

package/dist/cjs/shared/page-configs/getConfigDefinedAt.js

@@ -38,12 +38,13 @@ function getDefinedAtString(definedAtData, configName) {
         if (definedAt.definedBy)
             return getDefinedByString(definedAt, configName);
         const { filePathToShowToUser, fileExportPathToShowToUser } = definedAt;
-        let s = filePathToShowToUser;
         const exportPath = (0, getExportPath_js_1.getExportPath)(fileExportPathToShowToUser, configName);
         if (exportPath) {
-            s = `${s} > ${picocolors_1.default.cyan(exportPath)}`;
+            return `${filePathToShowToUser} > ${picocolors_1.default.cyan(exportPath)}`;
+        }
+        else {
+            return filePathToShowToUser;
         }
-        return s;
     })
         .join(' / ');
     return definedAtString;

package/dist/cjs/shared/page-configs/resolveVikeConfigPublic.js

@@ -50,10 +50,10 @@ function resolveVikeConfigPublicPageLazy(pageFiles, // V0.4 design
 pageConfig, // V1 design
 pageConfigGlobal) {
     const config = {};
-    const configEntries = {}; // TODO/v1-release: remove
-    const exportsAll = {}; // TODO/v1-release: remove
+    const configEntries = {}; // TO-DO/next-major-release: remove
+    const exportsAll = {}; // TO-DO/next-major-release: remove
     // V0.4 design
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     pageFiles.forEach((pageFile) => {
         const exportValues = getExportValues(pageFile);
         exportValues.forEach(({ exportName, exportValue, isFromDefaultExport }) => {
@@ -63,7 +63,7 @@ pageConfigGlobal) {
                 exportValue,
                 exportSource: `${pageFile.filePath} > ${isFromDefaultExport ? `\`export default { ${exportName} }\`` : `\`export { ${exportName} }\``}`,
                 filePath: pageFile.filePath,
-                _filePath: pageFile.filePath, // TODO/next-major-release: remove
+                _filePath: pageFile.filePath, // TO-DO/next-major-release: remove
                 _fileType: pageFile.fileType,
                 _isFromDefaultExport: isFromDefaultExport,
             });
@@ -108,18 +108,18 @@ pageConfigGlobal) {
     });
     (0, utils_js_1.assert)(!('default' in exports));
     (0, utils_js_1.assert)(!('default' in exportsAll));
-    const pageContextExports = {
+    const configPublicPageLazy = {
         config: config,
         from,
         source,
         sources,
-        // TODO/now-flat-pageContext: deprecate every prop below
+        // TO-DO/soon/flat-pageContext: deprecate every prop below
         configEntries,
         exports,
         exportsAll,
     };
-    // TODO/v1-release: remove
-    (0, utils_js_1.objectDefineProperty)(pageContextExports, 'pageExports', {
+    // TO-DO/next-major-release: remove
+    (0, utils_js_1.objectDefineProperty)(configPublicPageLazy, 'pageExports', {
         get: () => {
             // We only show the warning in Node.js because when using Client Routing Vue integration uses `Object.assign(pageContextReactive, pageContext)` which will wrongully trigger the warning. There is no cross-browser way to catch whether the property accessor was initiated by an `Object.assign()` call.
             if (!(0, utils_js_1.isBrowser)()) {
@@ -133,7 +133,7 @@ pageConfigGlobal) {
         enumerable: false,
         configurable: true,
     });
-    return pageContextExports;
+    return configPublicPageLazy;
 }
 // V1 design
 function resolveVikeConfigPublic_V1Design(pageConfig) {
@@ -161,7 +161,7 @@ function resolveVikeConfigPublic_V1Design(pageConfig) {
             configDefinedAt,
             configDefinedByFile: configValueFilePathToShowToUser,
         });
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         const exportName = configName;
         exportsAll[exportName] = exportsAll[exportName] ?? [];
         exportsAll[exportName].push({

package/dist/cjs/shared/page-configs/serialize/serializeConfigValues.js

@@ -178,7 +178,7 @@ function logJsonSerializeError(err, configName, definedAtData) {
     //*/
     const configValueFilePathToShowToUser = (0, helpers_js_1.getConfigValueFilePathToShowToUser)(definedAtData);
     (0, utils_js_1.assert)(configValueFilePathToShowToUser);
-    (0, utils_js_1.assertUsage)(false, `${picocolors_1.default.cyan(configName)} defined by ${configValueFilePathToShowToUser} must be defined over a so-called "pointer import", see https://vike.dev/config#pointer-imports`);
+    (0, utils_js_1.assertUsage)(false, `${picocolors_1.default.cyan(configName)} defined by ${configValueFilePathToShowToUser} must be defined using a separate file ${picocolors_1.default.bold(`+${configName}.js`)}, see https://vike.dev/error/runtime-in-config`);
 }
 function getConfigValuesBase(pageConfig, isEnvMatch, isEager) {
     const fromComputed = Object.entries(pageConfig.configValuesComputed ?? {}).map(([configName, valueInfo]) => {

package/dist/cjs/shared/preparePageContextForPublicUsage.js

@@ -11,7 +11,7 @@ function preparePageContextForPublicUsage(pageContext) {
     (0, utils_js_1.assert)(!pageContext.globalContext); // pageContext.globalContext should only be available to users — Vike itself should use pageContext._globalContext instead
     (0, utils_js_1.assert)(pageContext._isOriginalObject); // ensure we preserve the original object reference
     (0, addIs404ToPageProps_js_1.addIs404ToPageProps)(pageContext);
-    // TODO/next-major-release: remove
+    // TO-DO/next-major-release: remove
     if (!('_pageId' in pageContext)) {
         Object.defineProperty(pageContext, '_pageId', {
             get() {
@@ -29,7 +29,7 @@ function preparePageContextForPublicUsage(pageContext) {
     const globalContextPublic = (0, prepareGlobalContextForPublicUsage_js_1.prepareGlobalContextForPublicUsage)(pageContext._globalContext);
     const pageContextPublic = (0, getProxyForPublicUsage_js_1.getProxyForPublicUsage)(pageContext, 'pageContext', 
     // We must skip it in the client-side because of the reactivity mechanism of UI frameworks like Solid.
-    // - TODO/now-proxy: double check whether that's true
+    // - TO-DO/soon/proxy: double check whether that's true
     true, (prop) => {
         if (prop === 'globalContext') {
             return globalContextPublic;
@@ -67,11 +67,11 @@ function assertPropertyGetters(pageContext) {
     ;
     [
         'urlPathname',
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         'urlParsed',
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         'url',
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         'pageExports',
     ].forEach((prop) => {
         if (pageContext.prop)

package/dist/cjs/shared/route/abort.js

@@ -87,7 +87,7 @@ function AbortRender(pageContextAbort) {
     (0, utils_js_1.checkType)(err);
     return err;
 }
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 /**
  * @deprecated Use `throw render()` or `throw redirect()` instead, see https://vike.dev/render'
  */

package/dist/cjs/shared/route/deduceRouteStringFromFilesystemPath.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deduceRouteStringFromFilesystemPath = deduceRouteStringFromFilesystemPath;
 const utils_js_1 = require("./utils.js");
-// TODO/next-major-update: remove this and whole filesystemRoot mechanism
+// TO-DO/next-major-release: remove this and whole filesystemRoot mechanism
 function deduceRouteStringFromFilesystemPath(pageId, filesystemRoots) {
     // Handle Filesystem Routing Root
     const filesystemRootsMatch = filesystemRoots

package/dist/cjs/shared/route/execHookGuard.js

@@ -8,7 +8,7 @@ const errIntro = 'The guard() hook defined by';
 async function execHookGuard(pageContext, prepareForPublicUsage) {
     let hook;
     if (pageContext._globalContext._pageFilesAll.length > 0) {
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         // V0.4 design
         (0, utils_js_1.assert)(pageContext._globalContext._pageConfigs.length === 0);
         hook = findPageGuard(pageContext.pageId, pageContext._globalContext._pageFilesAll);

package/dist/cjs/shared/route/execHookOnBeforeRoute.js

@@ -41,7 +41,7 @@ async function execHookOnBeforeRoute(pageContext) {
 async function getPageContextFromHook(onBeforeRouteHook, pageContext) {
     let { hookReturn } = (0, execHook_js_1.execHookDirectSync)(onBeforeRouteHook, pageContext, preparePageContextForPublicUsage_js_1.preparePageContextForPublicUsage);
     (0, resolveRouteFunction_js_1.assertSyncRouting)(hookReturn, `The onBeforeRoute() hook ${onBeforeRouteHook.hookFilePath}`);
-    // TODO/v1-release: make execHookOnBeforeRoute() and route() sync
+    // TO-DO/next-major-release: make execHookOnBeforeRoute() and route() sync
     hookReturn = await hookReturn;
     const errPrefix = `The onBeforeRoute() hook defined by ${onBeforeRouteHook.hookFilePath}`;
     (0, utils_js_1.assertUsage)(hookReturn === null ||

package/dist/cjs/shared/route/index.js

@@ -17,7 +17,7 @@ const resolveRouteFunction_js_1 = require("./resolveRouteFunction.js");
 const execHookOnBeforeRoute_js_1 = require("./execHookOnBeforeRoute.js");
 const debug_js_1 = require("./debug.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-// TODO/next-major-release: make it sync
+// TO-DO/next-major-release: make it sync
 async function route(pageContext, skipOnBeforeRouteHook) {
     (0, debug_js_1.debug)('Pages routes:', pageContext._globalContext._pageRoutes);
     const pageContextFromRoute = {};

package/dist/cjs/shared/route/loadPageRoutes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadPageRoutes = loadPageRoutes;
+exports.loadPageRoutesSync = loadPageRoutesSync;
 const error_page_js_1 = require("../error-page.js");
 const utils_js_1 = require("./utils.js");
 const deduceRouteStringFromFilesystemPath_js_1 = require("./deduceRouteStringFromFilesystemPath.js");
@@ -12,8 +13,13 @@ const getHook_js_1 = require("../hooks/getHook.js");
 async function loadPageRoutes(
 // Remove all arguments and use GlobalContextServerInternal instead?
 pageFilesAll, pageConfigs, pageConfigGlobal, allPageIds) {
-    // TODO/next-major: remove & make this function sync
+    // TO-DO/next-major-release: remove this line, remove this function, rename loadPageRoutesSync() to loadPageRoutes()
     await Promise.all(pageFilesAll.filter((p) => p.fileType === '.page.route').map((p) => p.loadFile?.()));
+    return loadPageRoutesSync(pageFilesAll, pageConfigs, pageConfigGlobal, allPageIds);
+}
+function loadPageRoutesSync(
+// Remove all arguments and use GlobalContextServerInternal instead?
+pageFilesAll, pageConfigs, pageConfigGlobal, allPageIds) {
     const { onBeforeRouteHook, filesystemRoots } = getGlobalHooks(pageFilesAll, pageConfigs, pageConfigGlobal);
     const pageRoutes = getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds);
     return { pageRoutes, onBeforeRouteHook };
@@ -51,7 +57,7 @@ function getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds) {
                         const { filePathToShowToUser } = definedAtData;
                         (0, utils_js_1.assert)(filePathToShowToUser);
                         (0, utils_js_1.assert)((0, utils_js_2.isCallable)(route));
-                        // TODO/next-major: remove
+                        // TO-DO/next-major-release: remove
                         if ((0, getConfigValueRuntime_js_1.getConfigValueRuntime)(pageConfig, 'iKnowThePerformanceRisksOfAsyncRouteFunctions', 'boolean'))
                             (0, resolveRouteFunction_js_1.warnDeprecatedAllowKey)();
                         pageRoute = {
@@ -84,7 +90,7 @@ function getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds) {
         });
     }
     // Old design
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if (pageConfigs.length === 0) {
         (0, utils_js_1.assert)(filesystemRoots);
         const comesFromV1PageConfig = false;
@@ -151,7 +157,7 @@ function getGlobalHooks(pageFilesAll, pageConfigs, pageConfigGlobal) {
         return { onBeforeRouteHook: hook, filesystemRoots: null };
     }
     // Old design
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     let onBeforeRouteHook = null;
     const filesystemRoots = [];
     pageFilesAll

package/dist/cjs/shared/route/resolveRouteFunction.js

@@ -18,7 +18,7 @@ async function resolveRouteFunction(routeFunction, pageContext, routeFunctionFil
         hookName: 'route',
     }, pageContext, preparePageContextForPublicUsage_js_1.preparePageContextForPublicUsage);
     assertSyncRouting(result, `The Route Function ${routeFunctionFilePath}`);
-    // TODO/v1-release: make resolveRouteFunction() and route() sync
+    // TO-DO/next-major-release: make resolveRouteFunction() and route() sync
     //* We disallow asynchronous routing, because we need to check whether a link is a Vike link in a synchronous fashion before calling ev.preventDefault() in the 'click' event listener
     result = await result;
     //*/
@@ -54,11 +54,11 @@ async function resolveRouteFunction(routeFunction, pageContext, routeFunctionFil
         routeParams,
     };
 }
-// TODO/v1-release: remove, and make routing synchronous (enabling Vike to synchronously check whether a link is a Vike link before even calling ev.preventDefault())
+// TO-DO/next-major-release: remove, and make routing synchronous (enabling Vike to synchronously check whether a link is a Vike link before even calling ev.preventDefault())
 function assertSyncRouting(res, errPrefix) {
     (0, utils_js_1.assertWarning)(!(0, utils_js_1.isPromise)(res), `${errPrefix} returned a promise, but asynchronous routing is deprecated and will be removed in the next major release, see https://vike.dev/route-function#async`, { onlyOnce: true });
 }
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 function warnDeprecatedAllowKey() {
     const allowKey = picocolors_1.default.cyan('iKnowThePerformanceRisksOfAsyncRouteFunctions');
     (0, utils_js_1.assertWarning)(false, `${allowKey} is deprecated and will be removed in the next major release`, { onlyOnce: true });

package/dist/cjs/shared/route/resolveRouteString.js

@@ -13,7 +13,7 @@ const utils_js_1 = require("../utils.js");
 const utils_js_2 = require("./utils.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
 const PARAM_TOKEN_NEW = '@';
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 const PARAM_TOKEN_OLD = ':';
 function assertRouteString(routeString, errPrefix = 'Invalid') {
     let errPrefix2 = `${errPrefix} Route String ${highlight(routeString)}`;

package/dist/cjs/shared/route/routing.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveRoute = void 0;
-// TODO/v1-release - move:
+// TO-DO/next-major-release: move
 //   import { resolveRoute } from 'vike/routing'
 // to:
 //   import { resolveRoute } from 'vike'

package/dist/cjs/utils/PROJECT_VERSION.js

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

package/dist/cjs/utils/assertSetup.js

@@ -35,16 +35,16 @@ function onSetupRuntime() {
         return;
     assertNodeEnvIsNotUndefinedString();
     if (!setup.viteDevServer && setup.isViteDev === undefined) {
-        // TODO: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-        (0, assert_js_1.assertWarning)(!isNodeEnvDev(), `The ${getEnvDescription()}, which is contradictory because the environment seems to be a production environment (Vite isn't loaded), see https://vike.dev/NODE_ENV`, { onlyOnce: true });
-        (0, assert_js_1.assertUsage)(!setup.vikeVitePlugin, `Loading Vike's Vite plugin (the ${picocolors_1.default.cyan('vike/plugin')} module) is prohibited in production.`);
+        // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
+        (0, assert_js_1.assertWarning)(!isNodeEnvDev(), `The ${getEnvDescription()}, which is contradictory because the environment seems to be a production environment (Vite isn't loaded), see ${picocolors_1.default.underline('https://vike.dev/NODE_ENV')} and ${picocolors_1.default.underline('https://vike.dev/warning/setup')}`, { onlyOnce: true });
+        (0, assert_js_1.assertUsage)(!setup.vikeVitePlugin, `Vike's Vite plugin (the ${picocolors_1.default.cyan('vike/plugin')} module) shouldn't be loaded in production, see ${picocolors_1.default.underline('https://vike.dev/warning/setup')}`);
         // This assert() one of the main goal of this file: it ensures assertIsNotProductionRuntime()
         (0, assert_js_1.assert)(!setup.shouldNotBeProduction);
     }
     else {
         if (!setup.isPreview && !setup.vitePreviewServer && !setup.isPrerendering) {
-            // TODO: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-            (0, assert_js_1.assertWarning)(isNodeEnvDev(), `The ${getEnvDescription()}, but Vite is loaded which is prohibited in production, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+            // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
+            (0, assert_js_1.assertWarning)(isNodeEnvDev(), `The ${getEnvDescription()} while Vite is loaded, but Vite shouldn't be loaded in production, see ${picocolors_1.default.underline('https://vike.dev/warning/setup')}`, { onlyOnce: true });
         }
         (0, assert_js_1.assert)(setup.vikeVitePlugin);
         (0, assert_js_1.assert)(setup.shouldNotBeProduction);
@@ -113,8 +113,8 @@ function markSetup_isPreview() {
 function assertUsageNodeEnvIsNotDev(operation) {
     if (!isNodeEnvDev())
         return;
-    // TODO: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-    (0, assert_js_1.assertWarning)(false, `The ${getEnvDescription()} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+    // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
+    (0, assert_js_1.assertWarning)(false, `The ${getEnvDescription()} upon ${operation} which shouldn't be the case, see ${picocolors_1.default.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
 }
 function getEnvDescription() {
     const envType = `${(isNodeEnvDev() ? 'development' : 'production')} environment`;
@@ -125,7 +125,7 @@ function getEnvDescription() {
 // https://github.com/cloudflare/workers-sdk/issues/7886
 function assertNodeEnvIsNotUndefinedString() {
     const nodeEnv = getNodeEnv();
-    (0, assert_js_1.assertWarning)(nodeEnv !== 'undefined', `${picocolors_1.default.cyan('process.env.NODE_ENV==="undefined"')} which is unexpected: ${picocolors_1.default.cyan('process.env.NODE_ENV')} is allowed to be the *value* ${picocolors_1.default.cyan('undefined')} (i.e. ${picocolors_1.default.cyan('process.env.NODE_ENV===undefined')}) but it shouldn't be the *string* ${picocolors_1.default.cyan('"undefined"')} ${picocolors_1.default.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
+    (0, assert_js_1.assertWarning)(nodeEnv !== 'undefined', `${picocolors_1.default.cyan('process.env.NODE_ENV==="undefined"')} which is unexpected: ${picocolors_1.default.cyan('process.env.NODE_ENV')} is allowed to be the *value* ${picocolors_1.default.cyan('undefined')} (i.e. ${picocolors_1.default.cyan('process.env.NODE_ENV===undefined')}) but it shouldn't be the *string* ${picocolors_1.default.cyan('"undefined"')} — see ${picocolors_1.default.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
 }
 function isNodeEnvDev() {
     const nodeEnv = getNodeEnv();

package/dist/cjs/utils/debugGlob.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.debugGlob = void 0;
 const debug_js_1 = require("./debug.js");
-// TODO/v1-release: remove (or rename?)
+// TO-DO/next-major-release: remove (or rename?)
 exports.debugGlob = (0, debug_js_1.createDebugger)('vike:glob');

package/dist/cjs/utils/parseNpmPackage.js

@@ -49,7 +49,7 @@ function isPathAliasRecommended(alias) {
     //  - In principle, we could allow path aliases that don't start with special character as long as they can be distinguished from npm package names.
     //    - But we still enforce path aliases to start with a special character because it's a much simpler rule to follow.
     if (alias.startsWith('@/'))
-        return true; // Needed by contra.com
+        return true; // Needed by contra.com and https://github.com/vikejs/vike/issues/1567#issuecomment-3076374243
     const firstLetter = alias[0];
     (0, assert_js_1.assert)(firstLetter);
     if (firstLetter === '@' || /[0-9a-z]/.test(firstLetter.toLowerCase()))

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

@@ -7,7 +7,7 @@ import { PageConfigRuntime } from '../types/PageConfig.js';
 /**
  * Used by {@link https://github.com/magne4000/vite-plugin-vercel|vite-plugin-vercel} to compute some rewrite rules and extract { isr } configs.
  *
- * TODO/eventually: remove
+ * TO-DO/eventually: remove
  */
 declare function getPagesAndRoutes(): Promise<{
     pageRoutes: PageRoutes;

package/dist/esm/__internal/index.js

@@ -8,7 +8,7 @@ import { setNodeEnvProduction } from '../utils/assertSetup.js';
 /**
  * Used by {@link https://github.com/magne4000/vite-plugin-vercel|vite-plugin-vercel} to compute some rewrite rules and extract { isr } configs.
  *
- * TODO/eventually: remove
+ * TO-DO/eventually: remove
  */
 async function getPagesAndRoutes() {
     setNodeEnvProduction();

package/dist/esm/client/node.js

@@ -1,4 +1,4 @@
-import { assertUsage } from './runtime-server-routing/utils.js';
+import { assertUsage } from '../utils/assert.js';
 assertUsage(false, [
     'Server imports are forbidden on the client-side:',
     "  import { something } from 'vike/server'",

package/dist/esm/client/runtime-client-routing/createPageContextClientSide.js

@@ -14,14 +14,14 @@ async function createPageContextClientSide(urlOriginal) {
         isPrerendering: false,
         urlOriginal,
         _globalContext: globalContext,
-        _pageFilesAll: globalContext._pageFilesAll, // TODO/v1-release: remove
+        _pageFilesAll: globalContext._pageFilesAll, // TO-DO/next-major-release: remove
         _urlHandler: null,
         _urlRewrite: null,
         _baseServer: baseServer,
     });
     const pageContextUrlComputed = getPageContextUrlComputed(pageContextCreated);
     objectAssign(pageContextCreated, pageContextUrlComputed);
-    const pageContextAugmented = await createPageContextShared(pageContextCreated, globalContext._pageConfigGlobal, globalContext._vikeConfigPublicGlobal);
+    const pageContextAugmented = createPageContextShared(pageContextCreated, globalContext._vikeConfigPublicGlobal);
     augmentType(pageContextCreated, pageContextAugmented);
     return pageContextCreated;
 }

package/dist/esm/client/runtime-client-routing/getPageContextFromHooks.d.ts

@@ -85,6 +85,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;
@@ -109,6 +110,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;
@@ -156,6 +158,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
     urlOriginal: string;
     headers: Record<string, string> | null;
     headersOriginal?: unknown;
+    headersResponse: Headers;
     is404: boolean | null;
     isClientSideNavigation: boolean;
     abortReason?: unknown;
@@ -180,6 +183,7 @@ declare function getPageContextFromHooks_isHydration(pageContext: PageContextSer
     urlOriginal: string;
     headers: Record<string, string> | null;
     headersOriginal?: unknown;
+    headersResponse: Headers;
     is404: boolean | null;
     isClientSideNavigation: boolean;
     abortReason?: unknown;
@@ -295,6 +299,7 @@ declare function getPageContextFromClientHooks(pageContext: {
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;
@@ -319,6 +324,7 @@ declare function getPageContextFromClientHooks(pageContext: {
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;
@@ -364,6 +370,7 @@ declare function getPageContextFromClientHooks(pageContext: {
     urlOriginal: string;
     headers: Record<string, string> | null;
     headersOriginal?: unknown;
+    headersResponse: Headers;
     is404: boolean | null;
     isClientSideNavigation: boolean;
     abortReason?: unknown;
@@ -388,6 +395,7 @@ declare function getPageContextFromClientHooks(pageContext: {
     urlOriginal: string;
     headers: Record<string, string> | null;
     headersOriginal?: unknown;
+    headersResponse: Headers;
     is404: boolean | null;
     isClientSideNavigation: boolean;
     abortReason?: unknown;