vike 0.4.166 → 0.4.167

package/dist/esm/shared/page-configs/assertPlusFileExport.js

@@ -23,9 +23,7 @@ function assertPlusFileExport(fileExports, filePathToShowToUser, configName) {
         }
         else {
             assert(exportsAll.length === 2); // because `exportsInvalid.length === 0`
-            assertWarning(false, `${filePathToShowToUser} remove ${exportNamed} or ${exportDefault}`, {
-                onlyOnce: true
-            });
+            assertWarning(false, `The exports of ${filePathToShowToUser} are ambiguous: remove ${exportDefault} or ${exportNamed}`, { onlyOnce: true });
         }
     }
     else {

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

@@ -7,7 +7,8 @@ export { logAbortErrorHandled };
 export { getPageContextFromAllRewrites };
 export { AbortRender };
 export { assertNoInfiniteAbortLoop };
-import { assert, assertInfo, assertUsage, assertWarning, checkType, hasProp, isUriWithProtocol, isUserHookError, joinEnglish, objectAssign, truncateString } from './utils.js';
+import { isUserHookError } from '../hooks/executeHook.js';
+import { assert, assertInfo, assertUsage, assertWarning, checkType, hasProp, isUriWithProtocol, joinEnglish, objectAssign, truncateString } from './utils.js';
 import pc from '@brillout/picocolors';
 /**
  * Abort the rendering of the current page, and redirect the user to another URL instead.

package/dist/esm/shared/route/executeGuardHook.js

@@ -1,6 +1,7 @@
 export { executeGuardHook };
 import { getHook, getHookTimeoutDefault } from '../hooks/getHook.js';
-import { assert, assertUsage, executeHook, isCallable } from './utils.js';
+import { assert, assertUsage, isCallable } from './utils.js';
+import { executeHook } from '../hooks/executeHook.js';
 const errIntro = 'The guard() hook defined by';
 async function executeGuardHook(pageContext, prepareForUserConsumption) {
     let hook;

package/dist/esm/shared/route/executeOnBeforeRouteHook.js

@@ -1,8 +1,9 @@
 export { executeOnBeforeRouteHook };
 import { assertPageContextProvidedByUser } from '../assertPageContextProvidedByUser.js';
-import { assertUsage, hasProp, isObjectWithKeys, objectAssign, assertWarning, assertUsageUrl, joinEnglish, assert, executeHook } from './utils.js';
+import { assertUsage, hasProp, isObjectWithKeys, objectAssign, assertWarning, assertUsageUrl, joinEnglish, assert } from './utils.js';
 import { assertRouteParams, assertSyncRouting } from './resolveRouteFunction.js';
 import pc from '@brillout/picocolors';
+import { executeHook } from '../hooks/executeHook.js';
 async function executeOnBeforeRouteHook(pageContext) {
     const pageContextFromOnBeforeRouteHook = {};
     if (!pageContext._onBeforeRouteHook)

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

@@ -34,9 +34,8 @@ async function route(pageContextForRoute) {
     objectAssign(pageContext, pageContextFromOnBeforeRouteHook);
     // Vike's routing
     const allPageIds = pageContext._allPageIds;
-    assert(allPageIds.length >= 0);
-    assertUsage(pageContext._pageFilesAll.length > 0 || pageContext._pageConfigs.length > 0, 'No *.page.js file found. You must create at least one *.page.js file.');
-    assertUsage(allPageIds.length > 0, "You must create at least one *.page.js file that isn't _default.page.*");
+    assertUsage(allPageIds.length > 0, 'No page found. You must create at least one page.');
+    assert(pageContext._pageFilesAll.length > 0 || pageContext._pageConfigs.length > 0);
     const { urlPathname } = pageContext;
     assert(urlPathname.startsWith('/'));
     const routeMatches = [];

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

@@ -10,7 +10,6 @@ export * from '../../utils/isStringRecord.js';
 export * from '../../utils/unique.js';
 export * from '../../utils/isBrowser.js';
 export * from '../../utils/parseUrl.js';
-export * from '../hooks/executeHook.js';
 export * from '../../utils/checkType.js';
 export * from '../../utils/joinEnglish.js';
 export * from '../../utils/projectInfo.js';

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

@@ -19,7 +19,6 @@ export * from '../../utils/isStringRecord.js';
 export * from '../../utils/unique.js';
 export * from '../../utils/isBrowser.js';
 export * from '../../utils/parseUrl.js';
-export * from '../hooks/executeHook.js';
 export * from '../../utils/checkType.js';
 export * from '../../utils/joinEnglish.js';
 export * from '../../utils/projectInfo.js';

package/dist/esm/utils/assertIsNotProductionRuntime.js

@@ -16,31 +16,31 @@ const vikeVitePluginLoadedInProductionError = `Loading Vike's Vite plugin (the v
 const env = getGlobalObject('utils/assertIsNotProductionRuntime.ts', {});
 // Called by Vike modules that want to ensure that they aren't loaded by the server runtime in production
 function assertIsNotProductionRuntime() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('assertIsNotProductionRuntime()', new Error().stack);
     env.shouldNotBeProduction = true;
 }
 // Called by Vite hook configureServer()
 function markEnvAsViteDev() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsViteDev()', new Error().stack);
     env.isViteDev = true;
 }
 // Called by Vite hook configurePreviewServer()
 function markEnvAsVitePreview() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsVitePreview()', new Error().stack);
     env.isVitePreview = true;
 }
 // Called by ../node/plugin/index.ts
 function markEnvAsVikePluginLoaded() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsVikePluginLoaded()', new Error().stack);
     env.isVikePluginLoaded = true;
 }
 // Called by ../node/runtime/index.ts
 function assertEnv() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('assertEnv()', new Error().stack);
     if (isVitest())
         return;

package/dist/esm/utils/assertPathIsFilesystemAbsolute.js

@@ -5,6 +5,7 @@ import { assertPosixPath } from './filesystemPathHandling.js';
 /** Assert path is absolute from the filesystem root */
 function assertPathIsFilesystemAbsolute(p) {
     assertPosixPath(p);
+    assert(!p.startsWith('/@fs/'));
     if (process.platform === 'win32') {
         assert(path.win32.isAbsolute(p));
     }

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

@@ -1,7 +1,8 @@
 export { createDebugger };
-export { isDebugEnabled };
+export { isDebugActivated };
 export type { Debug };
-type Flag = 'vike:routing' | 'vike:error' | 'vike:stream' | 'vike:log' | 'vike:virtual-files' | 'vike:outDir' | 'vike:extractExportNames' | 'vike:extractAssets' | 'vike:glob' | 'vike:pageFiles' | 'vike:setup' | 'vike:pointer-imports';
+declare const flags: readonly ["vike:error", "vike:extractAssets", "vike:extractExportNames", "vike:glob", "vike:log", "vike:optimizeDeps", "vike:outDir", "vike:pageFiles", "vike:pointer-imports", "vike:routing", "vike:setup", "vike:stream", "vike:virtual-files"];
+type Flag = (typeof flags)[number];
 type Debug = ReturnType<typeof createDebugger>;
 type Options = {
     serialization?: {
@@ -10,6 +11,6 @@ type Options = {
 };
 declare function createDebugger(flag: Flag, optionsGlobal?: Options): ((...msgs: unknown[]) => void) & {
     options: (optionsLocal: Options) => (...msgs: unknown[]) => void;
-    isEnabled: boolean;
+    isActivated: boolean;
 };
-declare function isDebugEnabled(flag: Flag): boolean;
+declare function isDebugActivated(flag: Flag): boolean;

package/dist/esm/utils/debug.js

@@ -1,16 +1,35 @@
 export { createDebugger };
-export { isDebugEnabled };
+export { isDebugActivated };
 import { isBrowser } from './isBrowser.js';
 import { isCallable } from './isCallable.js';
 import { objectAssign } from './objectAssign.js';
-import { assert } from './assert.js';
+import { assert, assertUsage } from './assert.js';
 import { checkType } from './checkType.js';
 import { getTerminalWidth } from './getTerminWidth.js';
+import pc from '@brillout/picocolors';
 // Avoid this to be loaded in the browser. For isomorphic code: instead of `import { createDebugger } from './utils.js'`, use `globalThis.createDebugger()`.
 assert(!isBrowser());
 globalThis.__brillout_debug_createDebugger = createDebugger;
+const flags = [
+    'vike:error',
+    'vike:extractAssets',
+    'vike:extractExportNames',
+    'vike:glob',
+    'vike:log',
+    'vike:optimizeDeps',
+    'vike:outDir',
+    'vike:pageFiles',
+    'vike:pointer-imports',
+    'vike:routing',
+    'vike:setup',
+    'vike:stream',
+    'vike:virtual-files'
+];
+const flagRegex = /\bvike:[a-zA-Z-]+/g;
+assertDEBUG();
 function createDebugger(flag, optionsGlobal) {
     checkType(flag);
+    assert(flags.includes(flag));
     const debugWithOptions = (optionsLocal) => {
         return (...msgs) => {
             const options = { ...optionsGlobal, ...optionsLocal };
@@ -18,11 +37,11 @@ function createDebugger(flag, optionsGlobal) {
         };
     };
     const debug = (...msgs) => debugWithOptions({})(...msgs);
-    objectAssign(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(flag) });
+    objectAssign(debug, { options: debugWithOptions, isActivated: isDebugActivated(flag) });
     return debug;
 }
 function debug_(flag, options, ...msgs) {
-    if (!isDebugEnabled(flag))
+    if (!isDebugActivated(flag))
         return;
     let [msgFirst, ...msgsRest] = msgs;
     const padding = ' '.repeat(flag.length + 1);
@@ -47,17 +66,12 @@ function debug_(flag, options, ...msgs) {
         console.log(msg);
     });
 }
-function isDebugEnabled(flag) {
+function isDebugActivated(flag) {
     checkType(flag);
-    let DEBUG;
-    // - `process` can be undefined in edge workers
-    // - We want bundlers to be able to statically replace `process.env.*`
-    try {
-        DEBUG = process.env.DEBUG;
-    }
-    catch { }
-    const isEnabled = DEBUG?.includes(flag) ?? false;
-    return isEnabled;
+    assert(flags.includes(flag));
+    const DEBUG = getDEBUG();
+    const isActivated = DEBUG?.includes(flag) ?? false;
+    return isActivated;
 }
 function formatMsg(info, options, padding, position) {
     if (info === undefined) {
@@ -119,3 +133,20 @@ function replaceFunctionSerializer(_key, value) {
     }
     return value;
 }
+function assertDEBUG() {
+    const DEBUG = getDEBUG() ?? '';
+    const flagsActivated = DEBUG.match(flagRegex) ?? [];
+    flagsActivated.forEach((flag) => {
+        assertUsage(flags.includes(flag), `Unknown DEBUG flag ${pc.cyan(flag)}. Valid flags:\n${flags.map((f) => `  ${pc.cyan(f)}`).join('\n')}`);
+    });
+}
+function getDEBUG() {
+    let DEBUG;
+    // - `process` can be undefined in edge workers
+    // - We want bundlers to be able to statically replace `process.env.*`
+    try {
+        DEBUG = process.env.DEBUG;
+    }
+    catch { }
+    return DEBUG;
+}

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

@@ -4,5 +4,5 @@ export declare const debugGlob: ((...msgs: unknown[]) => void) & {
             emptyArray?: string | undefined;
         } | undefined;
     }) => (...msgs: unknown[]) => void;
-    isEnabled: boolean;
+    isActivated: boolean;
 };

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

@@ -1,8 +1,12 @@
 export { isNpmPackageImport };
+export { assertIsNpmPackageImport };
 export { isValidPathAlias };
 export { parse };
 export { isDistinguishable };
-declare function isNpmPackageImport(str: string): boolean;
+declare function isNpmPackageImport(str: string, { cannotBePathAlias }: {
+    cannotBePathAlias: true;
+}): boolean;
+declare function assertIsNpmPackageImport(str: string): void;
 declare function isValidPathAlias(alias: string): boolean;
 declare function isDistinguishable(alias: string): boolean;
 declare function parse(str: string | undefined): null | {

package/dist/esm/utils/isNpmPackage.js

@@ -1,4 +1,5 @@
 export { isNpmPackageImport };
+export { assertIsNpmPackageImport };
 export { isValidPathAlias };
 /* Currently not used
 export { isNpmPackageName }
@@ -11,10 +12,18 @@ export { isDistinguishable };
 import { assert } from './assert.js';
 import { assertIsNotBrowser } from './assertIsNotBrowser.js';
 assertIsNotBrowser();
-function isNpmPackageImport(str) {
+function isNpmPackageImport(str, { cannotBePathAlias }) {
+    // We cannot distinguish path alises that look like npm package imports
+    assert(cannotBePathAlias);
     const res = parse(str);
     return res !== null;
 }
+function assertIsNpmPackageImport(str) {
+    assert(isNpmPackageImport(str, {
+        // If `str` is a path alias that looks like an npm package => assertIsNpmPackageImport() is erroneous but that's okay because the assertion will eventually fail for some other user using a disambiguated path alias.
+        cannotBePathAlias: true
+    }));
+}
 function isNpmPackageName(str) {
     const res = parse(str);
     return res !== null && res.importPath === null;

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

@@ -1,7 +1,7 @@
 export { projectInfo };
 export { PROJECT_VERSION };
-declare const PROJECT_VERSION: "0.4.166";
+declare const PROJECT_VERSION: "0.4.167";
 declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.166";
+    projectVersion: "0.4.167";
 };

package/dist/esm/utils/projectInfo.js

@@ -1,6 +1,6 @@
 export { projectInfo };
 export { PROJECT_VERSION };
-const PROJECT_VERSION = '0.4.166';
+const PROJECT_VERSION = '0.4.167';
 const projectInfo = {
     projectName: 'Vike',
     projectVersion: PROJECT_VERSION

package/dist/esm/utils/trackLogs.js

@@ -1,8 +1,8 @@
-import { isDebugEnabled } from './debug.js';
+import { isDebugActivated } from './debug.js';
 import pc from '@brillout/picocolors';
 import { assertIsNotBrowser } from './assertIsNotBrowser.js';
 assertIsNotBrowser();
-if (isDebugEnabled('vike:log')) {
+if (isDebugActivated('vike:log')) {
     trackLogs();
 }
 // https://stackoverflow.com/questions/45395369/how-to-get-console-log-line-numbers-shown-in-nodejs/75109905#75109905

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.166",
+  "version": "0.4.167",
   "scripts": {
     "dev": "tsc --watch",
     "build": "rimraf dist/ && pnpm run build:esm && pnpm run build:cjs",

package/dist/cjs/node/runtime/renderPage/getPageAssets/assertClientEntryId.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertClientEntryId = void 0;
-const utils_js_1 = require("../../utils.js");
-const virtualFilePageConfigValuesAll_js_1 = require("../../../shared/virtual-files/virtualFilePageConfigValuesAll.js");
-function assertClientEntryId(id) {
-    (0, utils_js_1.assertPosixPath)(id);
-    (0, utils_js_1.assert)(!id.startsWith('/@fs'), id);
-    (0, utils_js_1.assert)(
-    // Client entry
-    id.startsWith('@@vike/') ||
-        // User files
-        id.startsWith('/') ||
-        // Page code importer
-        (0, virtualFilePageConfigValuesAll_js_1.isVirtualFileIdPageConfigValuesAll)(id) ||
-        // Import
-        (0, utils_js_1.isNpmPackageImport)(id), id);
-}
-exports.assertClientEntryId = assertClientEntryId;

package/dist/cjs/utils/getFilePathAbsolute.js

@@ -1,70 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilePathAbsoluteUserRootDir = exports.getFilePathAbsoluteFilesystem = void 0;
-const filesystemPathHandling_js_1 = require("./filesystemPathHandling.js");
-const assert_js_1 = require("./assert.js");
-const path_1 = __importDefault(require("path"));
-const assertIsNotProductionRuntime_js_1 = require("./assertIsNotProductionRuntime.js");
-const isNpmPackage_js_1 = require("./isNpmPackage.js");
-const assertPathIsFilesystemAbsolute_js_1 = require("./assertPathIsFilesystemAbsolute.js");
-const module_1 = require("module");
-// @ts-ignore Shimmed by dist-cjs-fixup.js for CJS build.
-const importMetaUrl = `file://${__filename}`;
-const require_ = (0, module_1.createRequire)(importMetaUrl);
-(0, assertIsNotProductionRuntime_js_1.assertIsNotProductionRuntime)();
-// Vite handles paths such as /pages/index.page.js which are relative to `config.root`.
-// Make them absolute starting from the filesystem root.
-// Also resolve plus files living in npm packages such as restack/renderer/+onRenderHtml.js
-function getFilePathAbsoluteFilesystem(filePath, config) {
-    (0, filesystemPathHandling_js_1.assertPosixPath)(filePath);
-    if (filePath.startsWith('/@fs/')) {
-        return filePath;
-    }
-    let filePathUnresolved;
-    if ((0, isNpmPackage_js_1.isNpmPackageImport)(filePath)) {
-        filePathUnresolved = filePath;
-    }
-    else {
-        (0, assert_js_1.assert)(filePath.startsWith('/'));
-        const { root } = config;
-        (0, assertPathIsFilesystemAbsolute_js_1.assertPathIsFilesystemAbsolute)(root);
-        filePathUnresolved = path_1.default.posix.join(root, filePath);
-        (0, assertPathIsFilesystemAbsolute_js_1.assertPathIsFilesystemAbsolute)(filePathUnresolved);
-    }
-    let filePathAbsoluteFilesystem;
-    try {
-        filePathAbsoluteFilesystem = require_.resolve(filePathUnresolved, { paths: [config.root] });
-    }
-    catch (err) {
-        console.error(err);
-        (0, assert_js_1.assert)(false);
-    }
-    filePathAbsoluteFilesystem = (0, filesystemPathHandling_js_1.toPosixPath)(filePathAbsoluteFilesystem);
-    (0, assertPathIsFilesystemAbsolute_js_1.assertPathIsFilesystemAbsolute)(filePathAbsoluteFilesystem);
-    return filePathAbsoluteFilesystem;
-}
-exports.getFilePathAbsoluteFilesystem = getFilePathAbsoluteFilesystem;
-function getFilePathAbsoluteUserRootDir(filePathAbsoluteFilesystem, userRootDir, alwaysRelative = false) {
-    (0, filesystemPathHandling_js_1.assertPosixPath)(filePathAbsoluteFilesystem);
-    (0, filesystemPathHandling_js_1.assertPosixPath)(userRootDir);
-    let filePathAbsoluteUserRootDir = path_1.default.posix.relative(userRootDir, filePathAbsoluteFilesystem);
-    if (filePathAbsoluteFilesystem.startsWith(userRootDir)) {
-        (0, assert_js_1.assert)(!filePathAbsoluteUserRootDir.startsWith('.') && !filePathAbsoluteUserRootDir.startsWith('/'), 
-        // Surprinsingly, this assertion seem to fail sometimes: https://github.com/vikejs/vike/issues/1139
-        { filePathAbsoluteUserRootDir, filePathAbsoluteFilesystem, userRootDir });
-        filePathAbsoluteUserRootDir = `/${filePathAbsoluteUserRootDir}`;
-        return filePathAbsoluteUserRootDir;
-    }
-    else {
-        if (alwaysRelative) {
-            return filePathAbsoluteUserRootDir;
-        }
-        else {
-            return filePathAbsoluteFilesystem;
-        }
-    }
-}
-exports.getFilePathAbsoluteUserRootDir = getFilePathAbsoluteUserRootDir;

package/dist/esm/node/runtime/renderPage/getPageAssets/assertClientEntryId.d.ts

@@ -1,2 +0,0 @@
-export { assertClientEntryId };
-declare function assertClientEntryId(id: string): void;

package/dist/esm/node/runtime/renderPage/getPageAssets/assertClientEntryId.js

@@ -1,16 +0,0 @@
-export { assertClientEntryId };
-import { assert, assertPosixPath, isNpmPackageImport } from '../../utils.js';
-import { isVirtualFileIdPageConfigValuesAll } from '../../../shared/virtual-files/virtualFilePageConfigValuesAll.js';
-function assertClientEntryId(id) {
-    assertPosixPath(id);
-    assert(!id.startsWith('/@fs'), id);
-    assert(
-    // Client entry
-    id.startsWith('@@vike/') ||
-        // User files
-        id.startsWith('/') ||
-        // Page code importer
-        isVirtualFileIdPageConfigValuesAll(id) ||
-        // Import
-        isNpmPackageImport(id), id);
-}

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

@@ -1,5 +0,0 @@
-export { getFilePathAbsoluteFilesystem };
-export { getFilePathAbsoluteUserRootDir };
-import type { ResolvedConfig } from 'vite';
-declare function getFilePathAbsoluteFilesystem(filePath: string, config: ResolvedConfig): string;
-declare function getFilePathAbsoluteUserRootDir(filePathAbsoluteFilesystem: string, userRootDir: string, alwaysRelative?: boolean): string;

package/dist/esm/utils/getFilePathAbsolute.js

@@ -1,64 +0,0 @@
-export { getFilePathAbsoluteFilesystem };
-export { getFilePathAbsoluteUserRootDir };
-import { assertPosixPath, toPosixPath } from './filesystemPathHandling.js';
-import { assert } from './assert.js';
-import path from 'path';
-import { assertIsNotProductionRuntime } from './assertIsNotProductionRuntime.js';
-import { isNpmPackageImport } from './isNpmPackage.js';
-import { assertPathIsFilesystemAbsolute } from './assertPathIsFilesystemAbsolute.js';
-import { createRequire } from 'module';
-// @ts-ignore Shimmed by dist-cjs-fixup.js for CJS build.
-const importMetaUrl = import.meta.url;
-const require_ = createRequire(importMetaUrl);
-assertIsNotProductionRuntime();
-// Vite handles paths such as /pages/index.page.js which are relative to `config.root`.
-// Make them absolute starting from the filesystem root.
-// Also resolve plus files living in npm packages such as restack/renderer/+onRenderHtml.js
-function getFilePathAbsoluteFilesystem(filePath, config) {
-    assertPosixPath(filePath);
-    if (filePath.startsWith('/@fs/')) {
-        return filePath;
-    }
-    let filePathUnresolved;
-    if (isNpmPackageImport(filePath)) {
-        filePathUnresolved = filePath;
-    }
-    else {
-        assert(filePath.startsWith('/'));
-        const { root } = config;
-        assertPathIsFilesystemAbsolute(root);
-        filePathUnresolved = path.posix.join(root, filePath);
-        assertPathIsFilesystemAbsolute(filePathUnresolved);
-    }
-    let filePathAbsoluteFilesystem;
-    try {
-        filePathAbsoluteFilesystem = require_.resolve(filePathUnresolved, { paths: [config.root] });
-    }
-    catch (err) {
-        console.error(err);
-        assert(false);
-    }
-    filePathAbsoluteFilesystem = toPosixPath(filePathAbsoluteFilesystem);
-    assertPathIsFilesystemAbsolute(filePathAbsoluteFilesystem);
-    return filePathAbsoluteFilesystem;
-}
-function getFilePathAbsoluteUserRootDir(filePathAbsoluteFilesystem, userRootDir, alwaysRelative = false) {
-    assertPosixPath(filePathAbsoluteFilesystem);
-    assertPosixPath(userRootDir);
-    let filePathAbsoluteUserRootDir = path.posix.relative(userRootDir, filePathAbsoluteFilesystem);
-    if (filePathAbsoluteFilesystem.startsWith(userRootDir)) {
-        assert(!filePathAbsoluteUserRootDir.startsWith('.') && !filePathAbsoluteUserRootDir.startsWith('/'), 
-        // Surprinsingly, this assertion seem to fail sometimes: https://github.com/vikejs/vike/issues/1139
-        { filePathAbsoluteUserRootDir, filePathAbsoluteFilesystem, userRootDir });
-        filePathAbsoluteUserRootDir = `/${filePathAbsoluteUserRootDir}`;
-        return filePathAbsoluteUserRootDir;
-    }
-    else {
-        if (alwaysRelative) {
-            return filePathAbsoluteUserRootDir;
-        }
-        else {
-            return filePathAbsoluteFilesystem;
-        }
-    }
-}