vike 0.4.236 → 0.4.237-commit-8749e81

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

@@ -1,14 +1,14 @@
 // TO-DO/soon/same-api: use public API internally?
 // TO-DO/soon/flat-pageContext: rename definedAt => definedBy
 export { resolveVikeConfigPublicGlobal };
-export { resolveVikeConfigPublicPageEager };
-export { resolveVikeConfigPublicPageLazy };
+export { resolveVikeConfigPublicPageEagerLoaded };
+export { resolveVikeConfigPublicPageLazyLoaded };
 import { assertDefaultExports, forbiddenDefaultExports } from '../getPageFiles/assert_exports_old_design.js';
 import { getConfigDefinedAtOptional, getDefinedAtString } from './getConfigDefinedAt.js';
 import { getConfigValueFilePathToShowToUser } from './helpers.js';
 import { assert, isObject, assertWarning, assertUsage, makeLast, isBrowser, isScriptFile, isTemplateFile, objectDefineProperty, } from '../utils.js';
 import pc from '@brillout/picocolors';
-function resolveVikeConfigPublicPageEager(pageConfigGlobalValues, pageConfig, pageConfigValues) {
+function resolveVikeConfigPublicPageEagerLoaded(pageConfigGlobalValues, pageConfig, pageConfigValues) {
     const vikeConfigPublicPage_ = resolveVikeConfigPublic_base({ pageConfigGlobalValues, pageConfigValues });
     const vikeConfigPublicPage = getPublicCopy(vikeConfigPublicPage_);
     let page;
@@ -43,7 +43,7 @@ function resolveVikeConfigPublicGlobal({ pageConfigGlobalValues, }) {
     const vikeConfigPublicGlobal = resolveVikeConfigPublic_V1Design({ configValues: pageConfigGlobalValues });
     return getPublicCopy(vikeConfigPublicGlobal);
 }
-function resolveVikeConfigPublicPageLazy(pageFiles, // V0.4 design
+function resolveVikeConfigPublicPageLazyLoaded(pageFiles, // V0.4 design
 pageConfig, // V1 design
 pageConfigGlobal) {
     const config = {};

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

@@ -7,7 +7,7 @@ import type { ConfigValueStandard, ConfigValueComputed, ConfigValueCumulative, P
 type PageConfigRuntimeSerialized = PageConfigCommon & {
     /** Config values that are serializable and loaded eagerly such as config.passToClient */
     configValuesSerialized: Record<string, ConfigValueSerialized>;
-    loadConfigLazy: PageConfigRuntime['loadConfigLazy'];
+    loadVirtualFilePageEntry: PageConfigRuntime['loadVirtualFilePageEntry'];
 };
 type PageConfigGlobalRuntimeSerialized = {
     configValuesSerialized: Record<string, ConfigValueSerialized>;

package/dist/esm/shared/page-configs/serialize/{parsePageConfigs.d.ts → parsePageConfigsSerialized.d.ts}

@@ -1,9 +1,9 @@
-export { parsePageConfigs };
+export { parsePageConfigsSerialized };
 export { parseConfigValuesSerialized };
 import type { ConfigValues, PageConfigRuntime, PageConfigGlobalRuntime } from '../../../types/PageConfig.js';
 import type { PageConfigGlobalRuntimeSerialized, PageConfigRuntimeSerialized } from './PageConfigSerialized.js';
 import type { ConfigValueSerialized } from './PageConfigSerialized.js';
-declare function parsePageConfigs(pageConfigsSerialized: PageConfigRuntimeSerialized[], pageConfigGlobalSerialized: PageConfigGlobalRuntimeSerialized): {
+declare function parsePageConfigsSerialized(pageConfigsSerialized: PageConfigRuntimeSerialized[], pageConfigGlobalSerialized: PageConfigGlobalRuntimeSerialized): {
     pageConfigs: PageConfigRuntime[];
     pageConfigGlobal: PageConfigGlobalRuntime;
 };

package/dist/esm/shared/page-configs/serialize/{parsePageConfigs.js → parsePageConfigsSerialized.js}

@@ -1,10 +1,10 @@
-export { parsePageConfigs };
+export { parsePageConfigsSerialized };
 export { parseConfigValuesSerialized };
 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 parsePageConfigs(pageConfigsSerialized, pageConfigGlobalSerialized) {
+function parsePageConfigsSerialized(pageConfigsSerialized, pageConfigGlobalSerialized) {
     // pageConfigs
     const pageConfigs = pageConfigsSerialized.map((pageConfigSerialized) => {
         const configValues = parseConfigValuesSerialized(pageConfigSerialized.configValuesSerialized);

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

@@ -3,9 +3,10 @@ export { getConfigValuesBase };
 export { isJsonValue };
 export type { FilesEnv };
 import type { ConfigEnvInternal, ConfigValueSource, DefinedAt, PageConfigBuildTime, PageConfigGlobalBuildTime } from '../../../types/PageConfig.js';
-declare function serializeConfigValues(pageConfig: PageConfigBuildTime | PageConfigGlobalBuildTime, importStatements: string[], filesEnv: FilesEnv, isEnvMatch: (configEnv: ConfigEnvInternal) => boolean, tabspace: string, isEager: boolean | null): string[];
+import { type RuntimeEnv } from '../../../node/vite/plugins/pluginVirtualFiles/getConfigValueSourcesRelevant.js';
+declare function serializeConfigValues(pageConfig: PageConfigBuildTime | PageConfigGlobalBuildTime, importStatements: string[], filesEnv: FilesEnv, runtimeEnv: RuntimeEnv, 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;
+declare function getConfigValuesBase(pageConfig: PageConfigBuildTime | PageConfigGlobalBuildTime, runtimeEnv: RuntimeEnv, isEager: boolean | null): ConfigValuesBase;
 type ConfigValuesBase = ({
     configValueBase: {
         type: 'computed';

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

@@ -2,23 +2,24 @@ export { serializeConfigValues };
 export { getConfigValuesBase };
 export { isJsonValue };
 import { assertIsNotProductionRuntime } from '../../../utils/assertSetup.js';
-import { assert, assertPosixPath, assertUsage, deepEqual, getPropAccessNotation, isImportPathRelative, } from '../../../node/vite/utils.js';
+import { assert, assertIsNotBrowser, assertPosixPath, assertUsage, deepEqual, getPropAccessNotation, isImportPathRelative, } from '../../../node/vite/utils.js';
 import { parsePointerImportData } from '../../../node/vite/shared/resolveVikeConfigInternal/pointerImports.js';
 import { getConfigValueFilePathToShowToUser } from '../helpers.js';
 import { stringify } from '@brillout/json-serializer/stringify';
 import pc from '@brillout/picocolors';
-import { isOverridden } from '../../../node/vite/shared/resolveVikeConfigInternal.js';
+import { getConfigValueSourcesRelevant, isRuntimeEnvMatch, } from '../../../node/vite/plugins/pluginVirtualFiles/getConfigValueSourcesRelevant.js';
 const stringifyOptions = { forbidReactElements: true };
 const REPLACE_ME_BEFORE = '__VIKE__REPLACE_ME_BEFORE__';
 const REPLACE_ME_AFTER = '__VIKE__REPLACE_ME_AFTER__';
-// This file is never loaded on the client-side but we save it under the vike/shared/ directory in order to collocate it with parsePageConfigs()
-// - vike/shared/page-configs/serialize/parsePageConfigs.ts
-// - parsePageConfigs() is loaded on both the client- and server-side.
+// This file is never loaded on the client-side but we save it under the vike/shared/ directory in order to collocate it with parsePageConfigsSerialized()
+// - vike/shared/page-configs/serialize/parsePageConfigsSerialized.ts
+// - parsePageConfigsSerialized() is loaded on both the client- and server-side.
+assertIsNotBrowser();
 assertIsNotProductionRuntime();
-function serializeConfigValues(pageConfig, importStatements, filesEnv, isEnvMatch, tabspace, isEager) {
+function serializeConfigValues(pageConfig, importStatements, filesEnv, runtimeEnv, tabspace, isEager) {
     const lines = [];
     tabspace += '  ';
-    getConfigValuesBase(pageConfig, isEnvMatch, isEager).forEach((entry) => {
+    getConfigValuesBase(pageConfig, runtimeEnv, isEager).forEach((entry) => {
         if (entry.configValueBase.type === 'computed') {
             assert('value' in entry); // Help TS
             const { configValueBase, value, configName, configEnv } = entry;
@@ -175,12 +176,12 @@ function logJsonSerializeError(err, configName, definedAtData) {
     assert(configValueFilePathToShowToUser);
     assertUsage(false, `${pc.cyan(configName)} defined by ${configValueFilePathToShowToUser} must be defined using a separate file ${pc.bold(`+${configName}.js`)}, see https://vike.dev/error/runtime-in-config`);
 }
-function getConfigValuesBase(pageConfig, isEnvMatch, isEager) {
+function getConfigValuesBase(pageConfig, runtimeEnv, isEager) {
     const fromComputed = Object.entries(pageConfig.configValuesComputed ?? {}).map(([configName, valueInfo]) => {
         const { configEnv, value } = valueInfo;
-        if (!isEnvMatch(configEnv))
+        if (!isRuntimeEnvMatch(configEnv, runtimeEnv))
             return 'SKIP';
-        // Is there a use case for overriding computed values? If yes, then configValeSources has higher precedence
+        // AFAICT this should never happen: I ain't aware of a use case for overriding computed values. If there is a use case, then configValueSources has higher precedence.
         if (pageConfig.configValueSources[configName])
             return 'SKIP';
         const configValueBase = {
@@ -189,16 +190,17 @@ function getConfigValuesBase(pageConfig, isEnvMatch, isEager) {
         };
         return { configValueBase, value, configName, configEnv };
     });
-    const fromSources = Object.entries(pageConfig.configValueSources).map(([configName, sources]) => {
+    const fromSources = Object.entries(pageConfig.configValueSources).map(([configName]) => {
         const configDef = pageConfig.configDefinitions[configName];
         assert(configDef);
         if (isEager !== null && isEager !== !!configDef.eager)
             return 'SKIP';
         if (!configDef.cumulative) {
-            const source = sources[0];
-            assert(source);
-            if (!isEnvMatch(source.configEnv))
+            const sourcesRelevant = getConfigValueSourcesRelevant(configName, runtimeEnv, pageConfig);
+            const source = sourcesRelevant[0];
+            if (!source)
                 return 'SKIP';
+            assert(sourcesRelevant.length === 1);
             const definedAtFile = getDefinedAtFileSource(source);
             const configValueBase = {
                 type: 'standard',
@@ -207,9 +209,7 @@ function getConfigValuesBase(pageConfig, isEnvMatch, isEager) {
             return { configValueBase, sourceRelevant: source, configName };
         }
         else {
-            const sourcesRelevant = sources
-                .filter((source) => !isOverridden(source, configName, pageConfig))
-                .filter((source) => isEnvMatch(source.configEnv));
+            const sourcesRelevant = getConfigValueSourcesRelevant(configName, runtimeEnv, pageConfig);
             if (sourcesRelevant.length === 0)
                 return 'SKIP';
             const definedAtData = [];

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

@@ -25,3 +25,5 @@ export * from '../utils/objectDefineProperty.js';
 export * from '../utils/isScriptFile.js';
 export * from '../utils/objectFilter.js';
 export * from '../utils/getPropAccessNotation.js';
+export * from '../utils/getGlobalObject.js';
+export * from '../utils/genPromise.js';

package/dist/esm/shared/utils.js

@@ -29,3 +29,5 @@ export * from '../utils/objectDefineProperty.js';
 export * from '../utils/isScriptFile.js';
 export * from '../utils/objectFilter.js';
 export * from '../utils/getPropAccessNotation.js';
+export * from '../utils/getGlobalObject.js';
+export * from '../utils/genPromise.js';

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

@@ -9,6 +9,8 @@ export type { HookNameOld };
 export type { HookNamePage };
 export type { HookNameGlobal };
 export type { ImportString };
+export type { Route };
+export type { KeepScrollPosition };
 export type { DataAsync };
 export type { DataSync };
 export type { GuardAsync };
@@ -33,8 +35,6 @@ export type { OnRenderHtmlAsync };
 export type { OnRenderHtmlSync };
 export type { RouteAsync };
 export type { RouteSync };
-export type { Route };
-export type { KeepScrollPosition };
 import type { PrefetchSetting, PrefetchStaticAssets } from '../client/runtime-client-routing/prefetch/PrefetchSetting.js';
 import type { ConfigDefinition } from '../node/vite/shared/resolveVikeConfigInternal/configDefinitionsBuiltIn.js';
 import type { DocumentHtml } from '../node/runtime/html/renderHtml.js';
@@ -44,73 +44,46 @@ import type { Vike, VikePackages } from './VikeNamespace.js';
 import type { HooksTimeoutProvidedByUser } from '../shared/hooks/getHook.js';
 import type { GlobalContext, PageContextClient, PageContextServer } from './PageContext.js';
 import type { InlineConfig } from 'vite';
-import type { PassToClient } from '../node/runtime/html/serializeContext.js';
+import type { PassToClientPublic } from '../node/runtime/html/serializeContext.js';
 type HookNameOld = HookName | HookNameOldDesign;
 type HookName = HookNamePage | HookNameGlobal;
 type HookNamePage = 'onHydrationEnd' | 'onBeforePrerenderStart' | 'onBeforeRender' | 'onPageTransitionStart' | 'onPageTransitionEnd' | 'onRenderHtml' | 'onRenderClient' | 'guard' | 'data' | 'onData' | 'route';
 type HookNameGlobal = 'onBeforeRoute' | 'onPrerenderStart' | 'onCreatePageContext' | 'onCreateGlobalContext';
 type HookNameOldDesign = 'render' | 'prerender' | 'onBeforePrerender';
-type ConfigNameBuiltIn = Exclude<keyof Config, keyof VikeVitePluginOptions | 'onBeforeRoute' | 'onPrerenderStart' | 'vite' | 'redirects'> | 'prerender' | 'isClientRuntimeLoaded' | 'onBeforeRenderEnv' | 'dataEnv' | 'hooksTimeout' | 'clientHooks' | 'middleware';
+type ConfigNameBuiltIn = Exclude<keyof ConfigBuiltIn, keyof VikeVitePluginOptions | 'onBeforeRoute' | 'onPrerenderStart' | 'vite' | 'redirects'> | 'prerender' | 'serverOnlyHooks' | 'isClientRuntimeLoaded' | 'onBeforeRenderEnv' | 'dataEnv' | 'hooksTimeout' | 'clientHooks' | 'middleware';
 type ConfigNameGlobal = 'onPrerenderStart' | 'onBeforeRoute' | 'prerender' | 'disableAutoFullBuild' | 'includeAssetsImportedByServer' | 'baseAssets' | 'baseServer' | 'redirects' | 'trailingSlash' | 'disableUrlNormalization' | 'vite';
 type Config = ConfigBuiltIn & Vike.Config & (VikePackages.ConfigVikeReact | VikePackages.ConfigVikeVue | VikePackages.ConfigVikeSolid | VikePackages.ConfigVikeSvelte | VikePackages.ConfigVikeAngular);
-/** Hook for fetching data.
- *
- *  https://vike.dev/data
- */
+/** @deprecated This type is deprecated, see https://vike.dev/data */
 type DataAsync<Data = unknown> = (pageContext: PageContextServer) => Promise<Data>;
-/** Hook for fetching data.
- *
- *  https://vike.dev/data
- */
+/** @deprecated This type is deprecated, see https://vike.dev/data */
 type DataSync<Data = unknown> = (pageContext: PageContextServer) => Data;
-/** Protect page(s), e.g. forbid unauthorized access.
- *
- *  https://vike.dev/guard
- */
+/** @deprecated This type is deprecated, see https://vike.dev/guard */
 type GuardAsync = (pageContext: PageContextServer) => Promise<void>;
-/** Protect page(s), e.g. forbid unauthorized access.
- *
- *  https://vike.dev/guard
- */
+/** @deprecated This type is deprecated, see https://vike.dev/guard */
 type GuardSync = (pageContext: PageContextServer) => void;
-/** Global Hook called before the whole pre-rendering process starts.
- *
- * https://vike.dev/onBeforePrerenderStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforePrerenderStart */
 type OnBeforePrerenderStartAsync<Data = unknown> = () => Promise<(string | {
     url: string;
     pageContext: Partial<Vike.PageContext & {
         data: Data;
     }>;
 })[]>;
-/** Global Hook called before the whole pre-rendering process starts.
- *
- * https://vike.dev/onBeforePrerenderStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforePrerenderStart */
 type OnBeforePrerenderStartSync<Data = unknown> = () => (string | {
     url: string;
     pageContext: Partial<Vike.PageContext & {
         data: Data;
     }>;
 })[];
-/** Hook called before the page is rendered.
- *
- *  https://vike.dev/onBeforeRender
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRender */
 type OnBeforeRenderAsync = (pageContext: PageContextServer) => Promise<{
     pageContext: Partial<Vike.PageContext>;
 } | void>;
-/** Hook called before the page is rendered.
- *
- *  https://vike.dev/onBeforeRender
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRender */
 type OnBeforeRenderSync = (pageContext: PageContextServer) => {
     pageContext: Partial<Vike.PageContext>;
 } | void;
-/** Hook called before the URL is routed to a page.
- *
- * https://vike.dev/onBeforeRoute
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRoute */
 type OnBeforeRouteAsync = (pageContext: PageContextServer) => Promise<{
     pageContext: Partial<{
         /** The URL you provided to Vike when calling `renderPage({ urlOriginal })` in your server middleware.
@@ -120,10 +93,7 @@ type OnBeforeRouteAsync = (pageContext: PageContextServer) => Promise<{
         urlOriginal: string;
     } | Vike.PageContext>;
 }>;
-/** Hook called before the URL is routed to a page.
- *
- * https://vike.dev/onBeforeRoute
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onBeforeRoute */
 type OnBeforeRouteSync = (pageContext: PageContextServer) => {
     pageContext: Partial<{
         /** The URL you provided to Vike when calling `renderPage({ urlOriginal })` in your server middleware.
@@ -133,40 +103,19 @@ type OnBeforeRouteSync = (pageContext: PageContextServer) => {
         urlOriginal: string;
     } | Vike.PageContext>;
 };
-/** Hook called after the page is hydrated.
- *
- * https://vike.dev/onHydrationEnd
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onHydrationEnd */
 type OnHydrationEndAsync = (pageContext: PageContextClient) => Promise<void>;
-/** Hook called after the page is hydrated.
- *
- * https://vike.dev/onHydrationEnd
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onHydrationEnd */
 type OnHydrationEndSync = (pageContext: PageContextClient) => void;
-/** Hook called after the user navigates to a new page.
- *
- * https://vike.dev/onPageTransitionEnd
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionEnd */
 type OnPageTransitionEndAsync = (pageContext: PageContextClient) => Promise<void>;
-/** Hook called after the user navigates to a new page.
- *
- * https://vike.dev/onPageTransitionEnd
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionEnd */
 type OnPageTransitionEndSync = (pageContext: PageContextClient) => void;
-/** Hook called before the user navigates to a new page.
- *
- * https://vike.dev/onPageTransitionStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionStart */
 type OnPageTransitionStartAsync = (pageContext: PageContextClient) => Promise<void>;
-/** Hook called before the user navigates to a new page.
- *
- * https://vike.dev/onPageTransitionStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPageTransitionStart */
 type OnPageTransitionStartSync = (pageContext: PageContextClient) => void;
-/** Page Hook called when pre-rendering starts.
- *
- * https://vike.dev/onPrerenderStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPrerenderStart */
 type OnPrerenderStartAsync = (prerenderContext: {
     pageContexts: PageContextServer[];
 }) => Promise<{
@@ -174,10 +123,7 @@ type OnPrerenderStartAsync = (prerenderContext: {
         pageContexts: PageContextServer[];
     };
 }>;
-/** Page Hook called when pre-rendering starts.
- *
- * https://vike.dev/onPrerenderStart
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onPrerenderStart */
 type OnPrerenderStartSync = (prerenderContext: {
     pageContexts: PageContextServer[];
 }) => {
@@ -185,25 +131,13 @@ type OnPrerenderStartSync = (prerenderContext: {
         pageContexts: PageContextServer[];
     };
 };
-/** Hook called when page is rendered on the client-side.
- *
- * https://vike.dev/onRenderClient
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onRenderClient */
 type OnRenderClientAsync = (pageContext: PageContextClient) => Promise<void>;
-/** Hook called when page is rendered on the client-side.
- *
- * https://vike.dev/onRenderClient
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onRenderClient */
 type OnRenderClientSync = (pageContext: PageContextClient) => void;
-/** Hook called when page is rendered to HTML on the server-side.
- *
- * https://vike.dev/onRenderHtml
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onRenderHtml */
 type OnRenderHtmlAsync = (pageContext: PageContextServer) => Promise<OnRenderHtmlReturn>;
-/** Hook called when page is rendered to HTML on the server-side.
- *
- * https://vike.dev/onRenderHtml
- */
+/** @deprecated This type is deprecated, see https://vike.dev/onRenderHtml */
 type OnRenderHtmlSync = (pageContext: PageContextServer) => OnRenderHtmlReturn;
 type OnRenderHtmlReturn = DocumentHtml | {
     injectFilter?: (assets: InjectFilterEntry[]) => void;
@@ -219,20 +153,21 @@ type RouteAsync = (pageContext: PageContextServer | PageContextClient) => Promis
     routeParams?: Record<string, string>;
     precedence?: number;
 } | boolean>;
-/** The page's URL(s).
- *
- *  https://vike.dev/route
- */
+/** @deprecated This type is deprecated, see https://vike.dev/route */
 type RouteSync = (pageContext: PageContextServer | PageContextClient) => {
     routeParams?: Record<string, string>;
     precedence?: number;
 } | boolean;
-type Route = string | RouteSync | RouteAsync;
 /** Whether the page scrolls to the top upon navigation.
  *
  * https://vike.dev/keepScrollPosition
  */
 type KeepScrollPosition = boolean | string | string[] | ((pageContext: PageContextClient) => boolean | string | string[]);
+/** The page's route.
+ *
+ * https://vike.dev/routing
+ */
+type Route = string | RouteSync | RouteAsync;
 /** Page configuration.
  *
  * https://vike.dev/config
@@ -363,7 +298,7 @@ type ConfigBuiltIn = {
      *
      * https://vike.dev/passToClient
      */
-    passToClient?: PassToClient | ImportString;
+    passToClient?: PassToClientPublic | ImportString;
     /** Hook called when page is rendered on the client-side.
      *
      * https://vike.dev/onRenderClient

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

@@ -20,6 +20,7 @@ export type { DefinedAtFile };
 export type { DefinedAt };
 export type { DefinedBy };
 export type { DefinedAtFilePath };
+export type { VirtualFileExportsPageEntry };
 import type { ConfigValueSerialized } from '../shared/page-configs/serialize/PageConfigSerialized.js';
 import type { LocationId } from '../node/vite/shared/resolveVikeConfigInternal/filesystemRouting.js';
 import type { FilePath } from './FilePath.js';
@@ -43,7 +44,7 @@ type PageConfigRoute = {
 type PageConfigRuntime = PageConfigCommon & {
     configValues: ConfigValues;
     /** Load config values that are lazily loaded such as config.Page */
-    loadConfigLazy: LoadConfigLazy;
+    loadVirtualFilePageEntry: LoadVirtualFilePageEntry;
 };
 /** Global config that applies to all pages, runtime data structure */
 type PageConfigGlobalRuntime = {
@@ -64,14 +65,15 @@ type PageConfigGlobalBuildTime = {
 };
 /** Same as PageConfigRuntime but also contains all lazily loaded config values such as config.Page */
 type PageConfigRuntimeLoaded = PageConfigRuntime & {
-    /** Whether loadConfigLazy() was called */
-    isAllLoaded: true;
+    /** Whether loadVirtualFilePageEntry() was called */
+    isPageEntryLoaded: true;
 };
-type LoadConfigLazy = () => {
+type LoadVirtualFilePageEntry = () => {
     moduleId: string;
-    moduleExports: Promise<{
-        configValuesSerialized: Record<string, ConfigValueSerialized>;
-    }>;
+    moduleExportsPromise: Promise<VirtualFileExportsPageEntry>;
+};
+type VirtualFileExportsPageEntry = {
+    configValuesSerialized: Record<string, ConfigValueSerialized>;
 };
 /** In what environment(s) the config value is loaded.
  *

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

@@ -8,6 +8,7 @@ declare global {
          *  https://vike.dev/meta#typescript
          */
         interface Config {
+            _interfaceIsNotAny?: never;
         }
         /** Refine the `pageContext.config` type.
          *
@@ -16,42 +17,49 @@ declare global {
          *  https://vike.dev/meta#typescript
          */
         interface ConfigResolved {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `PageContext` type (`import type { PageContext } from 'vike/types'`).
          *
          *  https://vike.dev/pageContext#typescript
          */
         interface PageContext {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `PageContextClient` type (`import type { PageContextClient } from 'vike/types'`).
          *
          *  https://vike.dev/pageContext#typescript
          */
         interface PageContextClient {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `PageContextServer` type (`import type { PageContextServer } from 'vike/types'`).
          *
          *  https://vike.dev/pageContext#typescript
          */
         interface PageContextServer {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `GlobalContext` type (`import type { GlobalContext } from 'vike/types'`).
          *
          *  https://vike.dev/globalContext#typescript
          */
         interface GlobalContext {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `GlobalContextClient` type (`import type { GlobalContextClient } from 'vike/types'`).
          *
          *  https://vike.dev/globalContext#typescript
          */
         interface GlobalContextClient {
+            _interfaceIsNotAny?: never;
         }
         /** Extend the `GlobalContextServer` type (`import type { GlobalContextServer } from 'vike/types'`).
          *
          *  https://vike.dev/globalContext#typescript
          */
         interface GlobalContextServer {
+            _interfaceIsNotAny?: never;
         }
     }
     /** This namespace is only used by:
@@ -65,14 +73,19 @@ declare global {
      */
     namespace VikePackages {
         interface ConfigVikeReact {
+            _interfaceIsNotAny?: never;
         }
         interface ConfigVikeVue {
+            _interfaceIsNotAny?: never;
         }
         interface ConfigVikeSolid {
+            _interfaceIsNotAny?: never;
         }
         interface ConfigVikeSvelte {
+            _interfaceIsNotAny?: never;
         }
         interface ConfigVikeAngular {
+            _interfaceIsNotAny?: never;
         }
     }
 }

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

@@ -1,8 +1,10 @@
 export type { PageContext, PageContextServer, PageContextClient, GlobalContext, GlobalContextServer, GlobalContextClient, PageContextWithServerRouting, PageContextClientWithServerRouting, GlobalContextClientWithServerRouting, } from './PageContext.js';
+export type { PrerenderContextPublic as PrerenderContext } from '../node/prerender/runPrerender.js';
 export type { PageContextBuiltInServer } from './PageContext.js';
 export type { PageContextBuiltInClientWithClientRouting } from './PageContext.js';
 export type { PageContextBuiltInClientWithServerRouting } from './PageContext.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 './Config.js';
+export type { Config, ConfigMeta as Meta, ImportString, KeepScrollPosition, } from './Config.js';
+export type { DataAsync, DataSync, GuardAsync, GuardSync, OnBeforePrerenderStartAsync, OnBeforePrerenderStartSync, OnBeforeRenderAsync, OnBeforeRenderSync, OnBeforeRouteAsync, OnBeforeRouteSync, OnHydrationEndAsync, OnHydrationEndSync, OnPageTransitionEndAsync, OnPageTransitionEndSync, OnPageTransitionStartAsync, OnPageTransitionStartSync, OnPrerenderStartAsync, OnPrerenderStartSync, OnRenderClientAsync, OnRenderClientSync, OnRenderHtmlAsync, OnRenderHtmlSync, RouteAsync, RouteSync, } from './Config.js';
 export type { ConfigResolved } from './Config/PageContextConfig.js';
 export type { ConfigEnv } from './PageConfig.js';
 export type { ConfigDefinition, ConfigEffect, } from '../node/vite/shared/resolveVikeConfigInternal/configDefinitionsBuiltIn.js';

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

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.236";
+export declare const PROJECT_VERSION: "0.4.237-commit-8749e81";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.236';
+export const PROJECT_VERSION = '0.4.237-commit-8749e81';

package/dist/esm/utils/assertSetup.js

@@ -24,6 +24,8 @@ function assertIsNotProductionRuntime() {
     setup.shouldNotBeProduction = true;
 }
 function onSetupRuntime() {
+    if (true)
+        return; // TODO/now refactor this
     if (debug.isActivated)
         debug('assertSetup()', new Error().stack);
     if (isTest())
@@ -31,15 +33,15 @@ function onSetupRuntime() {
     assertNodeEnvIsNotUndefinedString();
     if (!setup.viteDevServer && setup.isViteDev === undefined) {
         // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-        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 });
-        assertUsage(!setup.vikeVitePlugin, `Loading Vike's Vite plugin (the ${pc.cyan('vike/plugin')} module) is prohibited in production.`);
+        assertWarning(!isNodeEnvDev(), `The ${getEnvDescription()}, which is contradictory because the environment seems to be a production environment (Vite isn't loaded), see ${pc.underline('https://vike.dev/NODE_ENV')} and ${pc.underline('https://vike.dev/warning/setup')}`, { onlyOnce: true });
+        assertUsage(!setup.vikeVitePlugin, `Vike's Vite plugin (the ${pc.cyan('vike/plugin')} module) shouldn't be loaded in production, see ${pc.underline('https://vike.dev/warning/setup')}`);
         // This assert() one of the main goal of this file: it ensures assertIsNotProductionRuntime()
         assert(!setup.shouldNotBeProduction);
     }
     else {
         if (!setup.isPreview && !setup.vitePreviewServer && !setup.isPrerendering) {
             // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-            assertWarning(isNodeEnvDev(), `The ${getEnvDescription()}, but Vite is loaded which is prohibited in production, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+            assertWarning(isNodeEnvDev(), `The ${getEnvDescription()} while Vite is loaded, but Vite shouldn't be loaded in production, see ${pc.underline('https://vike.dev/warning/setup')}`, { onlyOnce: true });
         }
         assert(setup.vikeVitePlugin);
         assert(setup.shouldNotBeProduction);
@@ -109,7 +111,7 @@ function assertUsageNodeEnvIsNotDev(operation) {
     if (!isNodeEnvDev())
         return;
     // TO-DO/eventually: make it assertUsage() again once https://github.com/vikejs/vike/issues/1528 is implemented.
-    assertWarning(false, `The ${getEnvDescription()} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+    assertWarning(false, `The ${getEnvDescription()} upon ${operation} which shouldn't be the case, see ${pc.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
 }
 function getEnvDescription() {
     const envType = `${(isNodeEnvDev() ? 'development' : 'production')} environment`;
@@ -120,7 +122,7 @@ function getEnvDescription() {
 // https://github.com/cloudflare/workers-sdk/issues/7886
 function assertNodeEnvIsNotUndefinedString() {
     const nodeEnv = getNodeEnv();
-    assertWarning(nodeEnv !== 'undefined', `${pc.cyan('process.env.NODE_ENV==="undefined"')} which is unexpected: ${pc.cyan('process.env.NODE_ENV')} is allowed to be the *value* ${pc.cyan('undefined')} (i.e. ${pc.cyan('process.env.NODE_ENV===undefined')}) but it shouldn't be the *string* ${pc.cyan('"undefined"')} ${pc.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
+    assertWarning(nodeEnv !== 'undefined', `${pc.cyan('process.env.NODE_ENV==="undefined"')} which is unexpected: ${pc.cyan('process.env.NODE_ENV')} is allowed to be the *value* ${pc.cyan('undefined')} (i.e. ${pc.cyan('process.env.NODE_ENV===undefined')}) but it shouldn't be the *string* ${pc.cyan('"undefined"')} — see ${pc.underline('https://vike.dev/NODE_ENV')}`, { onlyOnce: true });
 }
 function isNodeEnvDev() {
     const nodeEnv = getNodeEnv();

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

@@ -1,4 +1,4 @@
 export { cast };
 export { castProp };
-declare function cast<T>(_thing: unknown): asserts _thing is T;
-declare function castProp<PropType, ObjectType, PropName extends PropertyKey>(_obj: ObjectType, _prop: PropName): asserts _obj is ObjectType & Record<PropName, PropType>;
+declare function cast<Type>(_thing: unknown): asserts _thing is Type;
+declare function castProp<PropType>(_obj: object, prop: PropertyKey): asserts _obj is Record<typeof prop, PropType>;

package/dist/esm/utils/cast.js

@@ -1,4 +1,4 @@
 export { cast };
 export { castProp };
 function cast(_thing) { }
-function castProp(_obj, _prop) { }
+function castProp(_obj, prop) { }

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

@@ -1,7 +1,7 @@
 export { createDebugger };
 export { isDebugActivated };
 export type { Debug };
-declare const flags: readonly ["vike:crawl", "vike:error", "vike:esbuild-resolve", "vike:pluginExtractAssets", "vike:pluginExtractExportNames", "vike:glob", "vike:globalContext", "vike:log", "vike:optimizeDeps", "vike:outDir", "vike:pageFiles", "vike:pointer-imports", "vike:resolve", "vike:routing", "vike:setup", "vike:stream", "vike:virtualFiles"];
+declare const flags: readonly ["vike:crawl", "vike:error", "vike:esbuild-resolve", "vike:pluginExtractAssets", "vike:pluginExtractExportNames", "vike:glob", "vike:globalContext", "vike:log", "vike:optimizeDeps", "vike:outDir", "vike:pageFiles", "vike:pointer-imports", "vike:resolve", "vike:routing", "vike:setup", "vike:stream", "vike:virtualFiles", "vike:vite-rpc"];
 type Flag = (typeof flags)[number];
 type Debug = ReturnType<typeof createDebugger>;
 type Options = {