vike 0.4.224 → 0.4.225-commit-37a36a5

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

@@ -297,7 +297,9 @@ type ConfigBuiltIn = {
          */
         disableAutoRun?: boolean;
         /**
-         * Set prerender settings without enabling pre-rendering.
+         * Whether to enable pre-rendering.
+         *
+         * Setting `value: null` enables you to set prerender settings without activating pre-rendering. (Useful for Vike extensions.)
          *
          * https://vike.dev/prerender#value
          *
@@ -471,6 +473,22 @@ type ConfigBuiltIn = {
      * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
      */
     cacheControl?: string;
+    /**
+     * Make development/preview server available over LAN and public addresses.
+     *
+     * Default: `false` (or `true` if running inside Docker/Podman).
+     *
+     * https://vike.dev/host
+     */
+    host?: boolean | string;
+    /**
+     * Change port of development/preview server.
+     *
+     * @default 3000
+     *
+     * https://vike.dev/port
+     */
+    port?: number;
     /** Where scripts are injected in the HTML.
      *
      * https://vike.dev/injectScriptsAt

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

@@ -17,12 +17,15 @@ export type { ConfigValueSources };
 export type { ConfigValuesComputed };
 export type { DefinedAtData };
 export type { DefinedAtFile };
+export type { DefinedAt };
+export type { DefinedBy };
 export type { DefinedAtFilePath };
 import type { ConfigValueSerialized } from './serialize/PageConfigSerialized.js';
 import type { LocationId } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/filesystemRouting.js';
 import type { FilePath } from './FilePath.js';
 import type { ConfigDefinitions } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.js';
 import type { PlusFile } from '../../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/getPlusFilesAll.js';
+import type { Operation } from '../../node/api/types.js';
 type PageConfigCommon = {
     pageId: string;
 } & PageConfigRoute;
@@ -33,7 +36,7 @@ type PageConfigRoute = {
     isErrorPage?: undefined;
     routeFilesystem: {
         routeString: string;
-        definedBy: string;
+        definedAtLocation: string;
     };
 };
 /** Page config, runtime data structure */
@@ -89,7 +92,7 @@ type ConfigValueSources = Record<string, // configName
 ConfigValueSource[]>;
 type ConfigValueSource = {
     configEnv: ConfigEnvInternal;
-    definedAtFilePath: DefinedAtFilePath;
+    definedAt: DefinedAtFilePath | DefinedBy;
     plusFile: PlusFile | null;
     locationId: LocationId;
     /** Wether the config value is loaded at runtime, for example config.Page or config.onBeforeRender */
@@ -119,13 +122,13 @@ type ConfigValue = ConfigValueStandard | ConfigValueCumulative | ConfigValueComp
 type ConfigValueStandard = {
     type: 'standard';
     value: unknown;
-    definedAtData: DefinedAtFile;
+    definedAtData: DefinedAt;
 };
 /** Defined by multiple sources (thus multiple file paths). */
 type ConfigValueCumulative = {
     type: 'cumulative';
     value: unknown[];
-    definedAtData: DefinedAtFile[];
+    definedAtData: DefinedAt[];
 };
 /** Defined internally by Vike (currently, Vike doesn't support computed configs created by users). */
 type ConfigValueComputed = {
@@ -133,8 +136,16 @@ type ConfigValueComputed = {
     value: unknown;
     definedAtData: null;
 };
-type DefinedAtData = DefinedAtFile | DefinedAtFile[] | null;
+type DefinedAtData = DefinedAt | DefinedAt[] | null;
+type DefinedAt = DefinedAtFile | DefinedBy;
+type DefinedBy = {
+    definedBy: 'cli' | 'env';
+} | {
+    definedBy: 'api';
+    operation: Operation;
+};
 type DefinedAtFile = {
     filePathToShowToUser: string;
     fileExportPathToShowToUser: null | string[];
+    definedBy?: undefined;
 };

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

@@ -1,11 +1,13 @@
 export { getConfigDefinedAt };
 export { getConfigDefinedAtOptional };
 export { getDefinedAtString };
+export { getDefinedByString };
 export type { ConfigDefinedAt };
 export type { ConfigDefinedAtOptional };
-import type { DefinedAtData, DefinedAtFile } from './PageConfig.js';
+import type { DefinedAtData, DefinedBy } from './PageConfig.js';
 type ConfigDefinedAtOptional = ConfigDefinedAt | `Config ${string} defined internally`;
 type ConfigDefinedAt = `Config ${string} defined at ${string}`;
-declare function getConfigDefinedAt<SentenceBegin extends 'Config' | 'config', ConfigName extends string>(sentenceBegin: SentenceBegin, configName: ConfigName, definedAtData: DefinedAtFile | DefinedAtFile[]): `${SentenceBegin} ${ConfigName} defined at ${string}`;
+declare function getConfigDefinedAt<SentenceBegin extends 'Config' | 'config', ConfigName extends string>(sentenceBegin: SentenceBegin, configName: ConfigName, definedAtData: NonNullable<DefinedAtData>): `${SentenceBegin} ${ConfigName} defined at ${string}`;
 declare function getConfigDefinedAtOptional<SentenceBegin extends 'Config' | 'config', ConfigName extends string>(sentenceBegin: SentenceBegin, configName: ConfigName, definedAtData: DefinedAtData): `${SentenceBegin} ${ConfigName} defined ${'internally' | `at ${string}`}`;
-declare function getDefinedAtString(definedAtData: DefinedAtFile | DefinedAtFile[], configName: string): string;
+declare function getDefinedAtString(definedAtData: NonNullable<DefinedAtData>, configName: string): string;
+declare function getDefinedByString(definedAt: DefinedBy, configName: string): `API call dev({ vikeConfig: { ${string} } })` | `API call build({ vikeConfig: { ${string} } })` | `API call preview({ vikeConfig: { ${string} } })` | `API call prerender({ vikeConfig: { ${string} } })` | `CLI option --${string}` | `environment variable VIKE_CONFIG="{${string}}"`;

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

@@ -1,7 +1,8 @@
 export { getConfigDefinedAt };
 export { getConfigDefinedAtOptional };
 export { getDefinedAtString };
-import { assert, isArray } from '../utils.js';
+export { getDefinedByString };
+import { assert, checkType, isArray } from '../utils.js';
 import pc from '@brillout/picocolors';
 import { getExportPath } from './getExportPath.js';
 function getConfigDefinedAt(sentenceBegin, configName, definedAtData) {
@@ -28,8 +29,10 @@ function getDefinedAtString(definedAtData, configName) {
     }
     assert(files.length >= 1);
     const definedAtString = files
-        .map((source) => {
-        const { filePathToShowToUser, fileExportPathToShowToUser } = source;
+        .map((definedAt) => {
+        if (definedAt.definedBy)
+            return getDefinedByString(definedAt, configName);
+        const { filePathToShowToUser, fileExportPathToShowToUser } = definedAt;
         let s = filePathToShowToUser;
         const exportPath = getExportPath(fileExportPathToShowToUser, configName);
         if (exportPath) {
@@ -40,3 +43,17 @@ function getDefinedAtString(definedAtData, configName) {
         .join(' / ');
     return definedAtString;
 }
+function getDefinedByString(definedAt, configName) {
+    if (definedAt.definedBy === 'api') {
+        return `API call ${pc.cyan(`${definedAt.operation}({ vikeConfig: { ${configName} } })`)}`;
+    }
+    const { definedBy } = definedAt;
+    if (definedBy === 'cli') {
+        return `CLI option ${pc.cyan(`--${configName}`)}`;
+    }
+    if (definedBy === 'env') {
+        return `environment variable ${pc.cyan(`VIKE_CONFIG="{${configName}}"`)}`;
+    }
+    checkType(definedBy);
+    assert(false);
+}

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

@@ -31,7 +31,7 @@ function getConfigValue(pageConfig, configName) {
         return {
             type: 'standard',
             value: configValueSource.value,
-            definedAtData: getDefinedAtFile(configValueSource)
+            definedAtData: getDefinedAt(configValueSource)
         };
     }
     else {
@@ -51,13 +51,16 @@ function mergeCumulative(configValueSources) {
         assert(configValueSource.configEnv.config === true);
         assert(configValueSource.valueIsLoaded);
         value.push(configValueSource.value);
-        definedAtData.push(getDefinedAtFile(configValueSource));
+        definedAtData.push(getDefinedAt(configValueSource));
     });
     return { value, definedAtData };
 }
-function getDefinedAtFile(configValueSource) {
+function getDefinedAt(configValueSource) {
+    const { definedAt } = configValueSource;
+    if (definedAt.definedBy)
+        return definedAt;
     return {
-        filePathToShowToUser: configValueSource.definedAtFilePath.filePathToShowToUser,
-        fileExportPathToShowToUser: configValueSource.definedAtFilePath.fileExportPathToShowToUser
+        filePathToShowToUser: definedAt.filePathToShowToUser,
+        fileExportPathToShowToUser: definedAt.fileExportPathToShowToUser
     };
 }

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

@@ -12,7 +12,7 @@ function getConfigValueFilePathToShowToUser(definedAtData) {
     // A unique file path only exists if the config value isn't cumulative nor computed:
     //  - cumulative config values have multiple file paths
     //  - computed values don't have any file path
-    if (!definedAtData || isArray(definedAtData))
+    if (!definedAtData || isArray(definedAtData) || definedAtData.definedBy)
         return null;
     const { filePathToShowToUser } = definedAtData;
     assert(filePathToShowToUser);

package/dist/esm/shared/page-configs/serialize/parsePageConfigs.d.ts

@@ -3,8 +3,8 @@ export { parseConfigValuesSerialized };
 import type { ConfigValues, PageConfigRuntime, PageConfigGlobalRuntime } from '../PageConfig.js';
 import type { PageConfigGlobalRuntimeSerialized, PageConfigRuntimeSerialized } from './PageConfigSerialized.js';
 import type { ConfigValueSerialized } from './PageConfigSerialized.js';
-declare function parseConfigValuesSerialized(configValuesSerialized: Record<string, ConfigValueSerialized>): ConfigValues;
 declare function parsePageConfigs(pageConfigsSerialized: PageConfigRuntimeSerialized[], pageConfigGlobalSerialized: PageConfigGlobalRuntimeSerialized): {
     pageConfigs: PageConfigRuntime[];
     pageConfigGlobal: PageConfigGlobalRuntime;
 };
+declare function parseConfigValuesSerialized(configValuesSerialized: Record<string, ConfigValueSerialized>): ConfigValues;

package/dist/esm/shared/page-configs/serialize/parsePageConfigs.js

@@ -4,10 +4,6 @@ import { assert, assertUsage, isCallable } from '../../utils.js';
 import { getConfigDefinedAt } from '../getConfigDefinedAt.js';
 import { parseTransform } from '@brillout/json-serializer/parse';
 import { assertPlusFileExport } from '../assertPlusFileExport.js';
-function parseConfigValuesSerialized(configValuesSerialized) {
-    const configValues = parseConfigValuesSerialized_tmp(configValuesSerialized);
-    return configValues;
-}
 function parsePageConfigs(pageConfigsSerialized, pageConfigGlobalSerialized) {
     // pageConfigs
     const pageConfigs = pageConfigsSerialized.map((pageConfigSerialized) => {
@@ -43,7 +39,7 @@ function assertRouteConfigValue(configValues) {
    }
    */
 }
-function parseConfigValuesSerialized_tmp(configValuesSerialized) {
+function parseConfigValuesSerialized(configValuesSerialized) {
     const configValues = {};
     Object.entries(configValuesSerialized).forEach(([configName, configValueSeriliazed]) => {
         let configValue;
@@ -100,6 +96,7 @@ function parseValueSerialized(valueSerialized, configName, getDefinedAtFile) {
     if (valueSerialized.type === 'plus-file') {
         const definedAtFile = getDefinedAtFile();
         const { exportValues } = valueSerialized;
+        assert(!definedAtFile.definedBy);
         assertPlusFileExport(exportValues, definedAtFile.filePathToShowToUser, configName);
         let value;
         let valueWasFound = false;

package/dist/esm/shared/page-configs/serialize/serializeConfigValues.d.ts

@@ -2,7 +2,7 @@ export { serializeConfigValues };
 export { getConfigValuesBase };
 export { isJsonValue };
 export type { FilesEnv };
-import type { ConfigEnvInternal, ConfigValueSource, DefinedAtFile, PageConfigBuildTime, PageConfigGlobalBuildTime } from '../PageConfig.js';
+import type { ConfigEnvInternal, ConfigValueSource, DefinedAt, PageConfigBuildTime, PageConfigGlobalBuildTime } from '../PageConfig.js';
 declare function serializeConfigValues(pageConfig: PageConfigBuildTime | PageConfigGlobalBuildTime, importStatements: string[], filesEnv: FilesEnv, isEnvMatch: (configEnv: ConfigEnvInternal) => boolean, tabspace: string, isEager: boolean | null): string[];
 declare function isJsonValue(value: unknown): boolean;
 declare function getConfigValuesBase(pageConfig: PageConfigBuildTime | PageConfigGlobalBuildTime, isEnvMatch: (configEnv: ConfigEnvInternal) => boolean, isEager: boolean | null): ConfigValuesBase;
@@ -17,14 +17,14 @@ type ConfigValuesBase = ({
 } | {
     configValueBase: {
         type: 'standard';
-        definedAtData: DefinedAtFile;
+        definedAtData: DefinedAt;
     };
     sourceRelevant: ConfigValueSource;
     configName: string;
 } | {
     configValueBase: {
         type: 'cumulative';
-        definedAtData: DefinedAtFile[];
+        definedAtData: DefinedAt[];
     };
     sourcesRelevant: ConfigValueSource[];
     configName: string;

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

@@ -47,7 +47,7 @@ function serializeConfigValues(pageConfig, importStatements, filesEnv, isEnvMatc
 function getValueSerializedFromSource(configValueSource, configName, importStatements, filesEnv) {
     let valueData;
     if (configValueSource.valueIsLoaded && !configValueSource.valueIsLoadedWithImport) {
-        valueData = getValueSerializedWithJson(configValueSource.value, configName, configValueSource.definedAtFilePath, importStatements, filesEnv, configValueSource.configEnv);
+        valueData = getValueSerializedWithJson(configValueSource.value, configName, configValueSource.definedAt, importStatements, filesEnv, configValueSource.configEnv);
     }
     else {
         valueData = getValueSerializedWithImport(configValueSource, importStatements, filesEnv, configName);
@@ -98,8 +98,9 @@ function serializeConfigValue(configValueBase, valueData, configName, lines, tab
 }
 function getValueSerializedWithImport(configValueSource, importStatements, filesEnv, configName) {
     assert(!configValueSource.valueIsFilePath);
-    const { valueIsDefinedByPlusValueFile, definedAtFilePath, configEnv } = configValueSource;
-    const { filePathAbsoluteVite, fileExportName } = definedAtFilePath;
+    const { valueIsDefinedByPlusValueFile, definedAt, configEnv } = configValueSource;
+    assert(!definedAt.definedBy);
+    const { filePathAbsoluteVite, fileExportName } = definedAt;
     if (valueIsDefinedByPlusValueFile)
         assert(fileExportName === undefined);
     const { importName } = addImportStatement(importStatements, filePathAbsoluteVite, fileExportName || '*', filesEnv, configEnv, configName);
@@ -226,9 +227,12 @@ function getConfigValuesBase(pageConfig, isEnvMatch, isEager) {
     return [...fromComputed, ...fromSources].filter((r) => r !== 'SKIP');
 }
 function getDefinedAtFileSource(source) {
+    const { definedAt } = source;
+    if (definedAt.definedBy)
+        return definedAt;
     const definedAtFile = {
-        filePathToShowToUser: source.definedAtFilePath.filePathToShowToUser,
-        fileExportPathToShowToUser: source.definedAtFilePath.fileExportPathToShowToUser
+        filePathToShowToUser: definedAt.filePathToShowToUser,
+        fileExportPathToShowToUser: definedAt.fileExportPathToShowToUser
     };
     return definedAtFile;
 }

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

@@ -60,11 +60,11 @@ function getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds) {
             if (!pageRoute) {
                 const { routeFilesystem } = pageConfig;
                 assert(routeFilesystem);
-                const { routeString, definedBy } = routeFilesystem;
+                const { routeString, definedAtLocation } = routeFilesystem;
                 assert(routeFilesystem.routeString.startsWith('/'));
                 pageRoute = {
                     pageId,
-                    routeFilesystemDefinedBy: definedBy,
+                    routeFilesystemDefinedBy: definedAtLocation,
                     comesFromV1PageConfig,
                     routeString,
                     routeDefinedAtString: null,

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

@@ -138,7 +138,11 @@ type PageContextBuiltInCommon<Data> = {
      */
     isBaseMissing?: true;
 };
-type PageContextBuiltInServer<Data> = PageContextBuiltInCommon<Data> & PageContextUrlServer;
+type PageContextBuiltInServer<Data> = PageContextBuiltInCommon<Data> & PageContextUrlServer & {
+    isHydration?: undefined;
+    isBackwardNavigation?: undefined;
+    previousPageContext?: undefined;
+};
 type PageContextBuiltInClientWithClientRouting<Data> = Partial<PageContextBuiltInCommon<Data>> & Pick<PageContextBuiltInCommon<Data>, 'Page' | 'routeParams' | 'pageExports' | 'config' | 'configEntries' | 'exports' | 'exportsAll' | 'abortReason' | 'data' | 'pageId' | 'source' | 'sources' | 'from'> & {
     /** Whether the current page is already rendered to HTML */
     isHydration: boolean;

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

@@ -8,9 +8,11 @@ export type { PageContextBuiltInServer } from '../shared/types.js';
 export type { PageContextBuiltInClientWithClientRouting } from '../shared/types.js';
 export type { PageContextBuiltInClientWithServerRouting } from '../shared/types.js';
 export type { Config, ConfigMeta as Meta, ImportString, DataAsync, DataSync, GuardAsync, GuardSync, OnBeforePrerenderStartAsync, OnBeforePrerenderStartSync, OnBeforeRenderAsync, OnBeforeRenderSync, OnBeforeRouteAsync, OnBeforeRouteSync, OnHydrationEndAsync, OnHydrationEndSync, OnPageTransitionEndAsync, OnPageTransitionEndSync, OnPageTransitionStartAsync, OnPageTransitionStartSync, OnPrerenderStartAsync, OnPrerenderStartSync, OnRenderClientAsync, OnRenderClientSync, OnRenderHtmlAsync, OnRenderHtmlSync, RouteAsync, RouteSync, KeepScrollPosition } from '../shared/page-configs/Config.js';
+export type { ConfigResolved } from '../shared/page-configs/Config/PageContextConfig.js';
 export type { ConfigEnv } from '../shared/page-configs/PageConfig.js';
 export type { ConfigDefinition, ConfigEffect } from '../node/plugin/plugins/importUserCode/v1-design/getVikeConfig/configDefinitionsBuiltIn.js';
 export type { ConfigEntries } from '../shared/page-configs/getPageConfigUserFriendly.js';
+export type { VikeConfigPublic as VikeConfig } from '../node/plugin/plugins/commonConfig.js';
 export type { UrlPublic as Url } from '../utils/parseUrl.js';
 export type { InjectFilterEntry } from '../node/runtime/html/injectAssets/getHtmlTags.js';
 export { defineConfig } from './defineConfig.js';

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

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.224";
+export declare const PROJECT_VERSION: "0.4.225-commit-37a36a5";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.224';
+export const PROJECT_VERSION = '0.4.225-commit-37a36a5';

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

@@ -10,8 +10,9 @@ export { isBug };
 export { setAlwaysShowStackTrace };
 type Logger = (msg: string | Error, logType: 'warn' | 'info') => void;
 declare function assert(condition: unknown, debugInfo?: unknown): asserts condition;
-declare function assertUsage(condition: unknown, errMsg: string, { showStackTrace }?: {
+declare function assertUsage(condition: unknown, errMsg: string, { showStackTrace, exitOnError }?: {
     showStackTrace?: true;
+    exitOnError?: boolean;
 }): asserts condition;
 declare function getProjectError(errMsg: string): Error;
 declare function assertWarning(condition: unknown, msg: string, { onlyOnce, showStackTrace }: {

package/dist/esm/utils/assert.js

@@ -12,7 +12,7 @@ import { assertSingleInstance_onAssertModuleLoad } from './assertSingleInstance.
 import { createErrorWithCleanStackTrace } from './createErrorWithCleanStackTrace.js';
 import { getGlobalObject } from './getGlobalObject.js';
 import { isObject } from './isObject.js';
-import { projectInfo } from './projectInfo.js';
+import { PROJECT_VERSION } from './PROJECT_VERSION.js';
 import pc from '@brillout/picocolors';
 const globalObject = getGlobalObject('utils/assert.ts', {
     alreadyLogged: new Set(),
@@ -29,7 +29,7 @@ const globalObject = getGlobalObject('utils/assert.ts', {
 });
 assertSingleInstance_onAssertModuleLoad();
 const projectTag = `[vike]`;
-const projectTagWithVersion = `[vike@${projectInfo.projectVersion}]`;
+const projectTagWithVersion = `[vike@${PROJECT_VERSION}]`;
 const bugTag = 'Bug';
 const numberOfStackTraceLinesToRemove = 2;
 function assert(condition, debugInfo) {
@@ -56,7 +56,7 @@ function assert(condition, debugInfo) {
     globalObject.onBeforeLog?.();
     throw internalError;
 }
-function assertUsage(condition, errMsg, { showStackTrace } = {}) {
+function assertUsage(condition, errMsg, { showStackTrace, exitOnError } = {}) {
     if (condition)
         return;
     showStackTrace = showStackTrace || globalObject.alwaysShowStackTrace;
@@ -68,7 +68,13 @@ function assertUsage(condition, errMsg, { showStackTrace } = {}) {
         globalObject.showStackTraceList.add(usageError);
     }
     globalObject.onBeforeLog?.();
-    throw usageError;
+    if (!exitOnError) {
+        throw usageError;
+    }
+    else {
+        console.error(showStackTrace ? usageError : errMsg);
+        process.exit(1);
+    }
 }
 function getProjectError(errMsg) {
     errMsg = addWhitespace(errMsg);
@@ -182,6 +188,7 @@ function overwriteAssertProductionLogger(logger) {
 function isBug(err) {
     return String(err).includes(`[${bugTag}]`);
 }
+// Called upon `DEBUG=vike:error`
 function setAlwaysShowStackTrace() {
     globalObject.alwaysShowStackTrace = true;
 }

package/dist/esm/utils/assertSingleInstance.js

@@ -1,15 +1,15 @@
 export { assertSingleInstance_onClientEntryServerRouting };
 export { assertSingleInstance_onClientEntryClientRouting };
 export { assertSingleInstance_onAssertModuleLoad };
-//  - Throw error if there are two different versions of vike loaded
+//  - Show warning if there are two different Vike versions loaded
 //  - Show warning if entry of Client Routing and entry of Server Routing are both loaded
-//  - Show warning if vike is loaded twice
+//  - Show warning if Vike is loaded twice
 import { unique } from './unique.js';
 import { getGlobalObject } from './getGlobalObject.js';
-import { projectInfo } from './projectInfo.js';
 import pc from '@brillout/picocolors';
-/* Use original assertUsage() & assertWarning() after all CJS is removed from node_modules/vike/dist/
-import { assertUsage, assertWarning } from './assert.js'
+import { PROJECT_VERSION } from './PROJECT_VERSION.js';
+/* Use original assertWarning() after all CJS is removed from node_modules/vike/dist/
+import { assertWarning } from './assert.js'
 */
 const globalObject = getGlobalObject('utils/assertSingleInstance.ts', {
     instances: [],
@@ -20,9 +20,10 @@ const clientNotSingleInstance = 'Client runtime loaded twice https://vike.dev/cl
 function assertSingleInstance() {
     {
         const versions = unique(globalObject.instances);
-        assertUsage(versions.length <= 1, 
-        // DO *NOT* patch vike to remove this error: because of multiple conflicting versions, you *will* eventually encounter insidious issues that hard to debug and potentially a security hazard, see for example https://github.com/vikejs/vike/issues/1108
-        `vike@${pc.bold(versions[0])} and vike@${pc.bold(versions[1])} loaded but it's forbidden to load different versions`);
+        assertWarning(versions.length <= 1, 
+        // Do *NOT* patch Vike to remove this warning: you *will* eventually encounter the issues listed at https://vike.dev/warning/version-mismatch
+        // - This happened before: https://github.com/vikejs/vike/issues/1108#issuecomment-1719061509
+        `vike@${pc.bold(versions[0])} and vike@${pc.bold(versions[1])} loaded which is highly discouraged, see ${pc.underline('https://vike.dev/warning/version-mismatch')}`, { onlyOnce: true, showStackTrace: false });
     }
     if (globalObject.checkSingleInstance && globalObject.instances.length > 1) {
         /*/ Not sure whether circular dependency can cause problems? In principle not since client-side code is ESM.
@@ -62,21 +63,14 @@ function assertSingleInstance_onClientEntryClientRouting(isProduction) {
 }
 // Called by utils/assert.ts which is (most certainly) loaded by all entries. That way we don't have to call a callback for every entry. (There are a lot of entries: `client/router/`, `client/`, `node/runtime/`, `node/plugin/`, `node/cli`.)
 function assertSingleInstance_onAssertModuleLoad() {
-    globalObject.instances.push(projectInfo.projectVersion);
+    globalObject.instances.push(PROJECT_VERSION);
     assertSingleInstance();
 }
-function assertUsage(condition, errorMessage) {
-    if (condition) {
-        return;
-    }
-    const errMsg = `[vike][Wrong Usage] ${errorMessage}`;
-    throw new Error(errMsg);
-}
 function assertWarning(condition, errorMessage, { onlyOnce, showStackTrace }) {
     if (condition) {
         return;
     }
-    const msg = `[vike][Warning] ${errorMessage}`;
+    const msg = `[Vike][Warning] ${errorMessage}`;
     if (onlyOnce) {
         const { alreadyLogged } = globalObject;
         const key = onlyOnce === true ? msg : onlyOnce;

package/dist/esm/utils/debug.js

@@ -11,6 +11,8 @@ import { isArray } from './isArray.js';
 // 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;
+// We purposely read process.env.DEBUG early, in order to avoid users from the temptation to set process.env.DEBUG with JavaScript, since reading & writing process.env.DEBUG dynamically leads to inconsistencies: for example https://github.com/vikejs/vike/issues/2239
+const DEBUG = getDEBUG() ?? '';
 const flags = [
     'vike:crawl',
     'vike:error',
@@ -145,7 +147,6 @@ function assertFlagsActivated() {
     });
 }
 function getFlagsActivated() {
-    const DEBUG = getDEBUG() ?? '';
     const flagsActivated = DEBUG.match(flagRegex) ?? [];
     const all = DEBUG.includes('vike:*');
     return { flagsActivated, all };

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

@@ -1,2 +1,2 @@
 export { getRandomId };
-declare function getRandomId(length: number): string;
+declare function getRandomId(length?: number): string;

package/dist/esm/utils/getRandomId.js

@@ -1,7 +1,7 @@
 export { getRandomId };
 import { assert } from './assert.js';
 // https://stackoverflow.com/questions/1349404/generate-random-string-characters-in-javascript
-function getRandomId(length) {
+function getRandomId(length = 12) {
     let randomId = '';
     while (randomId.length < length) {
         randomId += Math.random().toString(36).slice(2);

package/dist/esm/utils/normalizeHeaders.js

@@ -1,7 +1,7 @@
 export { normalizeHeaders };
 import { isObject } from './isObject.js';
 function normalizeHeaders(
-/* This type is precise, too precise which can be annoying: e.g. cannot pass a string[][] argument because it doesn't match the more precise [string,string][] type.
+/* This type is too strict which is annoying: cannot pass `string[][]` because it doesn't match the more precise type `[string,string][]`.
 headersOriginal ConstructorParameters<typeof Headers>[0]
 */
 headersOriginal) {

package/dist/esm/utils/parseUrl-extras.js

@@ -92,6 +92,7 @@ function modifyUrlPathname(url, modifier) {
 function removeUrlOrigin(url) {
     const { origin, pathnameOriginal, searchOriginal, hashOriginal } = parseUrl(url, '/');
     const urlModified = createUrlFromComponents(null, pathnameOriginal, searchOriginal, hashOriginal);
+    assert(urlModified.startsWith('/'));
     return { urlModified, origin };
 }
 function setUrlOrigin(url, origin) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.224",
+  "version": "0.4.225-commit-37a36a5",
   "repository": "https://github.com/vikejs/vike",
   "exports": {
     "./server": {
@@ -131,6 +131,7 @@
     "json5": "^2.0.0",
     "picomatch": "^4.0.2",
     "semver": "^7.0.0",
+    "sirv": "^3.0.1",
     "source-map-support": "^0.5.0",
     "tinyglobby": "^0.2.10",
     "vite": ">=5.1.0"
@@ -253,8 +254,8 @@
     "@types/source-map-support": "^0.5.10",
     "react-streaming": "^0.3.47",
     "rimraf": "^5.0.5",
-    "typescript": "^5.7.3",
-    "vite": "^6.2.0"
+    "typescript": "^5.8.2",
+    "vite": "^6.2.1"
   },
   "scripts": {
     "dev": "tsc --watch",
@@ -263,8 +264,10 @@
     "build:cjs": "pnpm run build:cjs:ts && pnpm run build:cjs:fixup",
     "build:cjs:ts": "tsc --project ./tsconfig.cjs.json",
     "build:cjs:fixup": "node ./dist-cjs-fixup.mjs",
+    "========= Release": "",
     "release": "release-me patch",
     "release:minor": "release-me minor",
+    "release:major": "release-me major",
     "release:commit": "release-me commit"
   }
 }

package/dist/cjs/utils/projectInfo.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.projectInfo = void 0;
-const PROJECT_VERSION_js_1 = require("./PROJECT_VERSION.js");
-exports.projectInfo = {
-    projectName: 'Vike',
-    projectVersion: PROJECT_VERSION_js_1.PROJECT_VERSION
-};

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

@@ -1,4 +0,0 @@
-export declare const projectInfo: {
-    projectName: "Vike";
-    projectVersion: "0.4.224";
-};

package/dist/esm/utils/projectInfo.js

@@ -1,5 +0,0 @@
-import { PROJECT_VERSION } from './PROJECT_VERSION.js';
-export const projectInfo = {
-    projectName: 'Vike',
-    projectVersion: PROJECT_VERSION
-};