vike 0.4.235 → 0.4.236-commit-85d361d

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

@@ -113,7 +113,7 @@ async function execHookDataLike(hookName, pageContext) {
 }
 async function execHookData(pageContext) {
     const res = await execHookClient('data', pageContext);
-    const hook = res[0]; // TO-DO/soon: support cumulative
+    const hook = res[0]; // TO-DO/soon/cumulative-hooks: support cumulative
     if (!hook)
         return;
     const { hookReturn } = hook;
@@ -122,7 +122,7 @@ async function execHookData(pageContext) {
 }
 async function execHookOnBeforeRender(pageContext) {
     const res = await execHookClient('onBeforeRender', pageContext);
-    const hook = res[0]; // TO-DO/soon: support cumulative
+    const hook = res[0]; // TO-DO/soon/cumulative-hooks: support cumulative
     if (!hook)
         return;
     const { hookReturn, hookFilePath } = hook;
@@ -152,13 +152,13 @@ function setPageContextInitIsPassedToClient(pageContext) {
         globalObject.pageContextInitIsPassedToClient = true;
     }
 }
-// TODO/v1-release: make it sync
+// TO-DO/next-major-release: make it sync
 async function hasPageContextServer(pageContext) {
     return (!!globalObject.pageContextInitIsPassedToClient ||
         (await hookServerOnlyExists('data', pageContext)) ||
         (await hookServerOnlyExists('onBeforeRender', pageContext)));
 }
-// TODO/v1-release: make it sync
+// TO-DO/next-major-release: make it sync
 /**
  * @param hookName
  * @param pageContext
@@ -179,7 +179,7 @@ async function hookServerOnlyExists(hookName, pageContext) {
         return !!server && !client;
     }
     else {
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         // V0.4
         // data() hooks didn't exist in the V0.4 design
         if (hookName === 'data')
@@ -202,7 +202,7 @@ function getHookEnv(hookName, pageContext) {
         return hookEnv;
     }
     else {
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         // Client-only onBeforeRender() or data() hooks were never supported for the V0.4 design
         return { client: false, server: true };
     }

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

@@ -1,4 +1,4 @@
-// TODO/v1-release - move:
+// TO-DO/next-major-release: move
 //   import { navigate, prefetch } from 'vike/client/router'
 // to:
 //   import { navigate, prefetch } from 'vike'

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

@@ -2,7 +2,7 @@ export { isClientSideRoutable };
 import { analyzePageClientSideInit } from '../../shared/getPageFiles/analyzePageClientSide.js';
 import { findPageConfig } from '../../shared/page-configs/findPageConfig.js';
 import { analyzeClientSide } from '../../shared/getPageFiles/analyzeClientSide.js';
-// TODO/next-major-release: make it sync
+// TO-DO/next-major-release: make it sync
 async function isClientSideRoutable(pageId, pageContext) {
     await analyzePageClientSideInit(pageContext._pageFilesAll, pageId, {
         sharedPageFilesAlreadyLoaded: false,

package/dist/esm/client/runtime-client-routing/prefetch/getPrefetchSettings.js

@@ -1,8 +1,8 @@
-// TODO/pageContext-prefetch: rename this file to getPrefetchSettingResolved.ts
+// TO-DO/pageContext-prefetch: rename this file to getPrefetchSettingResolved.ts
 export { getPrefetchSettings };
 export { PAGE_CONTEXT_MAX_AGE_DEFAULT };
 import { assertUsage, assertInfo } from '../utils.js';
-// TODO/pageContext-prefetch: Make it `Infinity` for pre-rendered pages.
+// TO-DO/pageContext-prefetch: Make it `Infinity` for pre-rendered pages.
 const PAGE_CONTEXT_MAX_AGE_DEFAULT = 5000;
 const prefetchSettingTrue = {
     staticAssets: 'hover',
@@ -12,18 +12,18 @@ const prefetchSettingFalse = {
     staticAssets: 'hover',
     pageContext: false,
 };
-// TODO/v1-release: change to `prefetchSettingTrue`?
+// TO-DO/eventually: change to `prefetchSettingTrue`
 const prefetchSettingDefault = prefetchSettingFalse;
 function getPrefetchSettings(pageContext, linkTag) {
     let prefetchSetting = prefetchSettingDefault;
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if ('prefetchLinks' in pageContext.exports) {
         assertUsage(false, '`export { prefetchLinks }` is deprecated, use `export { prefetchStaticAssets }` instead.');
     }
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if ('prefetchStaticAssets' in pageContext.exports) {
         const prefetchStaticAssets = pageContext.exports.prefetchStaticAssets;
-        /* TODO/pageContext-prefetch: uncomment
+        /* TO-DO/pageContext-prefetch: uncomment
         const msg = `The 'prefetchStaticAssets' setting is deprecated in favor of the 'prefetch' setting, see https://vike.dev/prefetch`
         assertWarning(false, msg, { onlyOnce: true })
         assertUsage(

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

@@ -29,7 +29,7 @@ const globalObject = getGlobalObject('runtime-client-routing/prefetch.ts', {
 });
 function getPageContextPrefetched(pageContext) {
     const prefetchSettings = getPrefetchSettings(pageContext, null);
-    // TODO/pageContext-prefetch: I guess we need linkTag to make this condition work
+    // TO-DO/pageContext-prefetch: I guess we need linkTag to make this condition work
     if (!prefetchSettings.pageContext)
         return null;
     const key = getCacheKey(pageContext.urlPathname);
@@ -37,7 +37,7 @@ function getPageContextPrefetched(pageContext) {
     if (!found || found.result.is404ServerSideRouted || isExpired(found))
         return null;
     const pageContextPrefetched = found.result.pageContextFromServerHooks;
-    /* TODO/pageContext-prefetch: make it work for when resultMaxAge is Infinity.
+    /* TO-DO/pageContext-prefetch: make it work for when resultMaxAge is Infinity.
     // We discard the prefetched pageContext whenever we use it, so that the user always sees fresh data upon naivgating.
     delete globalObject.prefetchedPageContexts[key]
     */
@@ -61,7 +61,7 @@ async function prefetchPageContextFromServerHooks(pageContextLink, resultMaxAge)
     setPageContextPrefetchCache(pageContextLink, result, resultMaxAge);
 }
 function populatePageContextPrefetchCache(pageContext /*& VikeConfigPublicPageLazy*/, result) {
-    // TODO/pageContext-prefetch: replace with using pageContext.config.prerender instead. (For being able to do that: eager configs need to be accessible without have to use VikeConfigPublicPageLazy as it isn't available here.)
+    // TO-DO/pageContext-prefetch: replace with using pageContext.config.prerender instead. (For being able to do that: eager configs need to be accessible without have to use VikeConfigPublicPageLazy as it isn't available here.)
     if (!isBrilloutDocpress())
         return;
     setPageContextPrefetchCache(pageContext, result, null);
@@ -79,7 +79,7 @@ function setPageContextPrefetchCache(pageContext, result, resultMaxAge) {
 }
 function getResultMaxAge() {
     const pageContextCurrent = getPageContextCurrent();
-    // TODO/pageContext-prefetch: remove this dirty hack used by @brillout/docpress and, instead, use Vike's default if pageContextCurrent isn't defined yet.
+    // TO-DO/pageContext-prefetch: remove this dirty hack used by @brillout/docpress and, instead, use Vike's default if pageContextCurrent isn't defined yet.
     if (!pageContextCurrent)
         return Infinity;
     const prefetchSettings = getPrefetchSettings(pageContextCurrent, null);
@@ -94,7 +94,7 @@ function getResultMaxAge() {
  * @param url - The URL of the page you want to prefetch.
  */
 async function prefetch(url, 
-/* TODO/pageContext-prefetch
+/* TO-DO/pageContext-prefetch:
 options?: {
   pageContext?: boolean
   staticAssets?: boolean
@@ -196,11 +196,11 @@ async function prefetchOnEvent(linkTag, event) {
     }
     else {
         if (isBrilloutDocpress()) {
-            // TODO/pageContext-prefetch: remove this dirty hack used by @brillout/docpress and, instead, use Vike's default if pageContextCurrent isn't defined yet.
+            // TO-DO/pageContext-prefetch: remove this dirty hack used by @brillout/docpress and, instead, use Vike's default if pageContextCurrent isn't defined yet.
             prefetchSettings = { staticAssets: 'hover', pageContext: Infinity };
         }
         else {
-            // TODO/pageContext-prefetch: consider pageContextLink
+            // TO-DO/pageContext-prefetch: consider pageContextLink
             return;
         }
     }
@@ -225,7 +225,7 @@ async function prefetchOnEvent(linkTag, event) {
                 const key = getCacheKey(urlOfLink);
                 const found = globalObject.prefetchedPageContexts[key];
                 if (!found || isExpired(found)) {
-                    // TODO/pageContext-prefetch: move this logic in getPrefetchSettings()
+                    // TO-DO/pageContext-prefetch: move this logic in getPrefetchSettings()
                     const resultMaxAge = prefetchSettings.pageContext;
                     await prefetchPageContextFromServerHooks(pageContextLink, resultMaxAge);
                 }
@@ -236,7 +236,7 @@ async function prefetchOnEvent(linkTag, event) {
 function isExpired(found) {
     return Date.now() - found.resultFetchedAt > found.resultMaxAge;
 }
-// TODO/next-major-release: make it sync
+// TO-DO/next-major-release: make it sync
 async function getPageContextLink(urlOfLink) {
     const pageContextLink = await createPageContextClientSide(urlOfLink);
     let pageContextFromRoute;
@@ -257,7 +257,7 @@ function getCacheKey(url) {
     const key = url.split('#')[0];
     return key;
 }
-// TODO/pageContext-prefetch: remove
+// TO-DO/pageContext-prefetch: remove
 function isBrilloutDocpress() {
     return '_isBrilloutDocpress' in window;
 }

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

@@ -95,6 +95,7 @@ declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isB
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;
@@ -119,6 +120,7 @@ declare function getPageContextBegin(isForErrorPage: boolean, { urlOriginal, isB
         urlOriginal: string;
         headers: Record<string, string> | null;
         headersOriginal?: unknown;
+        headersResponse: Headers;
         is404: boolean | null;
         isClientSideNavigation: boolean;
         abortReason?: unknown;

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

@@ -90,7 +90,7 @@ async function renderPageClientSide(renderArgs) {
             // TO-DO/eventually: create helper assertPageContextFromHook()
             assert(!('urlOriginal' in pageContextSerialized));
             objectAssign(pageContext, pageContextSerialized);
-            // TODO/pageContext-prefetch: remove or change, because this only makes sense for a pre-rendered page
+            // TO-DO/pageContext-prefetch: remove or change, because this only makes sense for a pre-rendered page
             populatePageContextPrefetchCache(pageContext, { pageContextFromServerHooks: pageContextSerialized });
         }
         else {
@@ -188,7 +188,7 @@ async function renderPageClientSide(renderArgs) {
                     if (result.is404ServerSideRouted)
                         return;
                     pageContextFromServerHooks = result.pageContextFromServerHooks;
-                    // TODO/pageContext-prefetch: remove or change, because this only makes sense for a pre-rendered page
+                    // TO-DO/pageContext-prefetch: remove or change, because this only makes sense for a pre-rendered page
                     populatePageContextPrefetchCache(pageContext, result);
                 }
                 catch (err) {
@@ -462,7 +462,7 @@ async function getPageContextBegin(isForErrorPage, { urlOriginal, isBackwardNavi
         previousPageContext,
         ...pageContextInitClient,
     });
-    // TODO/next-major-release: remove
+    // TO-DO/next-major-release: remove
     Object.defineProperty(pageContext, '_previousPageContext', {
         get() {
             assertWarning(false, 'pageContext._previousPageContext has been renamed pageContext.previousPageContext', {

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

@@ -15,7 +15,7 @@ function skipLink(linkTag) {
         // Purposely last because disableAutomaticLinkInterception will be removed in the next major release
         !isVikeLink(linkTag));
 }
-// TODO/next-major-release: remove this in favor of synchronously checking whether URL matches the route of a page (possible since Async Route Functions will be deprecated)
+// TO-DO/next-major-release: remove this in favor of synchronously checking whether URL matches the route of a page (possible since Async Route Functions will be deprecated)
 function isVikeLink(linkTag) {
     const disableAutomaticLinkInterception = isDisableAutomaticLinkInterception();
     if (!disableAutomaticLinkInterception) {

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

@@ -16,13 +16,13 @@ async function createPageContextClientSide() {
         isPrerendering: false,
         isHydration: true,
         _globalContext: globalContext,
-        _pageFilesAll: globalContext._pageFilesAll, // TODO/v1-release: remove
+        _pageFilesAll: globalContext._pageFilesAll, // TO-DO/next-major-release: remove
         isBackwardNavigation: null,
         _hasPageContextFromServer: true,
     });
     objectAssign(pageContextCreated, getPageContextSerializedInHtml());
     // Sets pageContext.config to global configs
-    augmentType(pageContextCreated, await createPageContextShared(pageContextCreated, globalContext._pageConfigGlobal, globalContext._vikeConfigPublicGlobal));
+    augmentType(pageContextCreated, createPageContextShared(pageContextCreated, globalContext._vikeConfigPublicGlobal));
     // Sets pageContext.config to local configs (overrides the pageContext.config set above)
     augmentType(pageContextCreated, await loadPageConfigsLazyClientSideAndExecHook(pageContextCreated));
     assertPristineUrl();

package/dist/esm/client/runtime-server-routing/index.js

@@ -1,2 +1,2 @@
-// TODO/v1-release: remove this file
+// TO-DO/next-major-release: remove this file
 export {};

package/dist/esm/client/shared/createGetGlobalContextClient.d.ts

@@ -23,13 +23,14 @@ declare function createGetGlobalContextClient<GlobalContextAddendum extends obje
     pages: {
         [k: string]: import("../../shared/page-configs/resolveVikeConfigPublic.js").VikeConfigPublicPageEager;
     };
-} & Awaited<{
+} & {
     /**
      * Whether the environment is client-side or server-side / pre-rendering.
      *
      * We recommend using `import.meta.env.SSR` instead, see https://vike.dev/globalContext
      */
     isClientSide: true;
-} & Awaited<GlobalContextAddendum>>>;
-declare function getGlobalContext(): Promise<never>;
-declare function getGlobalContextSync(): never;
+} & Awaited<GlobalContextAddendum>>;
+type NeverExported = never;
+declare function getGlobalContext(): Promise<NeverExported>;
+declare function getGlobalContextSync(): NeverExported;

package/dist/esm/client/shared/createGetGlobalContextClient.js

@@ -46,7 +46,6 @@ function createGetGlobalContextClient(virtualFileExports, isClientRouting, addGl
         return globalContext;
     }
 }
-// The type is never used: it's the type of the server-side getGlobalContext() that is used.
 async function getGlobalContext() {
     const globalContext = await globalObject.globalContextPromise;
     return globalContext;

package/dist/esm/client/shared/execHookOnRenderClient.js

@@ -22,7 +22,7 @@ async function execHookOnRenderClient(pageContext, prepareForPublicUsage) {
             assertUsage(false, `No onRenderClient() hook defined for URL '${urlToShowToUser}', but it's needed, see https://vike.dev/onRenderClient`);
         }
         else {
-            // TODO/v1-release: remove
+            // TO-DO/next-major-release: remove
             // V0.4 design
             const pageClientsFilesLoaded = pageContext._pageFilesLoaded.filter((p) => p.fileType === '.page.client');
             let errMsg;

package/dist/esm/client/shared/loadPageConfigsLazyClientSide.js

@@ -30,9 +30,9 @@ async function loadPageConfigsLazyClientSide(pageId, pageFilesAll, pageConfigs,
         }
         throw err;
     }
-    const pageContextExports = resolveVikeConfigPublicPageLazy(pageFilesClientSide, pageConfigLoaded, pageConfigGlobal);
+    const configPublicPageLazy = resolveVikeConfigPublicPageLazy(pageFilesClientSide, pageConfigLoaded, pageConfigGlobal);
     const pageContextAddendum = {};
-    objectAssign(pageContextAddendum, pageContextExports);
+    objectAssign(pageContextAddendum, configPublicPageLazy);
     objectAssign(pageContextAddendum, { _pageFilesLoaded: pageFilesClientSide });
     return pageContextAddendum;
 }

package/dist/esm/client/shared/preparePageContextForPublicUsageClientShared.js

@@ -3,14 +3,14 @@ export { preparePageContextForPublicUsageClientMinimal };
 import { objectAssign } from '../runtime-server-routing/utils.js';
 import { assertPropertyGetters, preparePageContextForPublicUsage, } from '../../shared/preparePageContextForPublicUsage.js';
 function preparePageContextForPublicUsageClientShared(pageContext) {
-    // TODO/now-proxy use proxy
+    // TO-DO/soon/proxy: use proxy
     const Page = pageContext.config?.Page ||
-        // TODO/next-major-release: remove
+        // TO-DO/next-major-release: remove
         pageContext.exports?.Page;
     objectAssign(pageContext, { Page });
-    // TODO/next-major-release: after we remove supportVueReactiviy() we can call this later inside the agnostic preparePageContextForPublicUsage()
+    // TO-DO/next-major-release: after we remove supportVueReactiviy() we can call this later inside the agnostic preparePageContextForPublicUsage()
     assertPropertyGetters(pageContext);
-    // TODO/next-major-release: remove
+    // TO-DO/next-major-release: remove
     // - Requires https://github.com/vikejs/vike-vue/issues/198
     // - Last time I tried to remove it (https://github.com/vikejs/vike/commit/705fd23598d9d69bf46a52c8550216cd7117ce71) the tests were failing as expected: only the Vue integrations that used shallowReactive() failed.
     supportVueReactiviy(pageContext);

package/dist/esm/node/api/prepareViteApiCall.js

@@ -84,7 +84,7 @@ async function getViteInfo(viteConfigFromUserApiOptions, operation) {
     const root = normalizeViteRoot(viteConfigResolved.root ?? process.cwd());
     globalObject.root = root;
     // - Find options `vike(options)` set in vite.config.js
-    //   - TODO/next-major: remove
+    //   - TO-DO/next-major-release: remove
     // - Add Vike's Vite plugin if missing
     let vikeVitePluginOptions;
     const found = findVikeVitePlugin(viteConfigResolved);

package/dist/esm/node/cli/index.js

@@ -1,4 +1,4 @@
-// TODO/v1-release: remove this file
+// TO-DO/next-major-release: remove this file
 export { prerender } from '../api/prerender.js';
 import { assertWarning } from '../../utils/assert.js';
 import pc from '@brillout/picocolors';

package/dist/esm/node/createPageRenderer.js

@@ -1,4 +1,4 @@
-// TODO/v1-release: remove this file
+// TO-DO/next-major-release: remove this file
 //import { SsrEnv, setSsrEnv } from './ssrEnv.js'
 import { renderPage } from './runtime/renderPage.js';
 import { assertWarning } from './runtime/utils.js';

package/dist/esm/node/importBuild.js

@@ -1,3 +1,3 @@
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 console.warn("[vike][Warning] importBuild.js is not needed anymore; it has no effect. Remove `import 'dist/server/importBuild.js'` to remove this warning. More infos at https://vike.dev/importBuild.js");
 export {};

package/dist/esm/node/prerender/context.js

@@ -12,7 +12,7 @@ function isPrerenderAutoRunEnabled(vikeConfig) {
         !globalObject.isDisabled &&
         vikeConfig.config.disableAutoFullBuild !== 'prerender');
 }
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 function temp_disablePrerenderAutoRun() {
     globalObject.isDisabled = true;
 }

package/dist/esm/node/prerender/index.js

@@ -1,4 +1,4 @@
-// TODO/v1-release: remove this file
+// TO-DO/next-major-release: remove this file
 export { prerender } from '../api/prerender.js';
 import { assertWarning } from '../../utils/assert.js';
 import pc from '@brillout/picocolors';

package/dist/esm/node/prerender/resolvePrerenderConfig.js

@@ -22,7 +22,7 @@ function resolvePrerenderConfigGlobal(vikeConfig) {
             defaultLocalValue = true;
         }
     }
-    // TODO/next-major: remove
+    // TO-DO/next-major-release: remove
     // Backwards compatibility for `vike({prerender:true})` in vite.config.js
     {
         const valuesWithDefinedAt = vikeConfig._from.configsCumulative.prerender?.values ?? [];
@@ -37,7 +37,7 @@ function resolvePrerenderConfigGlobal(vikeConfig) {
         isPrerenderingEnabled: vikeConfig._pageConfigs.length > 0 &&
             vikeConfig._pageConfigs.some((pageConfig) => resolvePrerenderConfigLocal(pageConfig)?.value ?? defaultLocalValue),
     });
-    // TODO/next-major remove
+    // TO-DO/next-major-release: remove
     if (vikeConfig._pageConfigs.length === 0 && defaultLocalValue)
         prerenderConfigGlobal.isPrerenderingEnabled = true;
     return prerenderConfigGlobal;

package/dist/esm/node/prerender/runPrerender.d.ts

@@ -559,8 +559,9 @@ declare function createPageContextPrerendering(urlOriginal: string, prerenderCon
 })) & import("../../shared/getPageFiles.js").VikeConfigPublicPageLazy) & {
     Page: unknown;
     _isHtmlOnly: boolean;
-    _passToClient: string[];
+    _passToClient: import("../runtime/html/serializeContext.js").PassToClient;
     _pageFilePathsLoaded: string[];
+    headersResponse: Headers;
 } & {
     __getPageAssets: () => Promise<import("../runtime/renderPage/getPageAssets.js").PageAsset[]>;
 })) & {

package/dist/esm/node/prerender/runPrerender.js

@@ -49,7 +49,7 @@ async function runPrerender(options = {}, trigger) {
     const { partial, noExtraDir, parallel, defaultLocalValue, isPrerenderingEnabled } = prerenderConfigGlobal;
     if (!isPrerenderingEnabled) {
         assert(trigger !== 'auto-run');
-        /* TODO/v1-release: use this assertUsage() again.
+        /* TO-DO/next-major-release: use this assertUsage() again.
          * - Make sure https://github.com/magne4000/vite-plugin-vercel/pull/156 is merged before using this assertUsage() again. (Otherwise vite-plugin-vercel will trigger this assertUsage() call.)
          *   - Done: PR is merged as of June 20205
         assertUsage(
@@ -131,7 +131,7 @@ async function collectDoNoPrerenderList(pageConfigs, doNotPrerenderList, default
         }
     });
     // Old design
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     await Promise.all(globalContext._pageFilesAll
         .filter((p) => {
         assertExportNames(p);
@@ -294,7 +294,7 @@ async function createPageContextPrerendering(urlOriginal, prerenderContext, glob
         urlOriginal,
         ...prerenderContext._pageContextInit,
     };
-    const pageContext = await createPageContextServerSide(pageContextInit, globalContext, {
+    const pageContext = createPageContextServerSide(pageContextInit, globalContext, {
         isPrerendering: true,
     });
     assert(pageContext.isPrerendering === true);
@@ -385,7 +385,7 @@ async function callOnPrerenderStartHook(prerenderContext, globalContext, concurr
         }
     }
     // Old design
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if (globalContext._pageConfigs.length === 0) {
         const hookTimeout = getHookTimeoutDefault('onBeforePrerender');
         const pageFilesWithOnBeforePrerenderHook = globalContext._pageFilesAll.filter((p) => {
@@ -425,7 +425,7 @@ async function callOnPrerenderStartHook(prerenderContext, globalContext, concurr
     assertUsage(isCallable(hookFn), `${msgPrefix} should be a function.`);
     prerenderContext.pageContexts.forEach((pageContext) => {
         Object.defineProperty(pageContext, 'url', {
-            // TODO/v1-release: remove warning
+            // TO-DO/next-major-release: remove warning
             get() {
                 assertWarning(false, msgPrefix +
                     ' uses pageContext.url but it should use pageContext.urlOriginal instead, see https://vike.dev/migration/0.4.23', { showStackTrace: true, onlyOnce: true });
@@ -455,7 +455,7 @@ async function callOnPrerenderStartHook(prerenderContext, globalContext, concurr
     }
     const errPrefix = `The ${hookName}() hook exported by ${hookFilePath}`;
     const rightUsage = `${errPrefix} should return ${pc.cyan('null')}, ${pc.cyan('undefined')}, or ${pc.cyan('{ prerenderContext: { pageContexts } }')}`;
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if (hasProp(result, 'globalContext')) {
         assertUsage(isObjectWithKeys(result, ['globalContext']) &&
             hasProp(result, 'globalContext', 'object') &&
@@ -472,7 +472,7 @@ async function callOnPrerenderStartHook(prerenderContext, globalContext, concurr
         hasProp(result.prerenderContext, 'pageContexts', 'array'), rightUsage);
     prerenderContext.pageContexts = result.prerenderContext.pageContexts;
     prerenderContext.pageContexts.forEach((pageContext) => {
-        // TODO/v1-release: remove
+        // TO-DO/next-major-release: remove
         if (pageContext.url && !isPropertyGetter(pageContext, 'url')) {
             assertWarning(false, msgPrefix +
                 ' provided pageContext.url but it should provide pageContext.urlOriginal instead, see https://vike.dev/migration/0.4.23', { onlyOnce: true });
@@ -533,10 +533,6 @@ function warnContradictoryNoPrerenderList(prerenderedPageContexts, doNotPrerende
 async function warnMissingPages(prerenderedPageContexts, globalContext, doNotPrerenderList, partial) {
     const isV1 = globalContext._pageConfigs.length > 0;
     const hookName = isV1 ? 'onBeforePrerenderStart' : 'prerender';
-    /* TODO/after-v1-design-release: document setting `prerender: false` as an alternative to using prerender.partial (both in the warnings and the docs)
-    const optOutName = isV1 ? 'prerender' : 'doNotPrerender'
-    const msgAddendum = `Explicitly opt-out by setting the config ${optOutName} to ${isV1 ? 'false' : 'true'} or use the option prerender.partial`
-    */
     globalContext._allPageIds
         .filter((pageId) => !prerenderedPageContexts[pageId])
         .filter((pageId) => !doNotPrerenderList.find((p) => p.pageId === pageId))
@@ -639,7 +635,7 @@ function normalizeOnPrerenderHookResult(prerenderResult, prerenderHookFile, hook
         return prerenderElement;
     }
 }
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 function checkOutdatedOptions(options) {
     assertUsage(options.root === undefined, 'Option `prerender({ root })` deprecated: set `prerender({ viteConfig: { root }})` instead.', { showStackTrace: true });
     assertUsage(options.configFile === undefined, 'Option `prerender({ configFile })` deprecated: set `prerender({ viteConfig: { configFile }})` instead.', { showStackTrace: true });
@@ -684,7 +680,7 @@ function assertIsNotAbort(err, urlOriginal) {
     assertUsage(false, `${pc.cyan(abortCall)} thrown${thrownBy} while pre-rendering ${urlOriginal} but ${pc.cyan(abortCaller)} isn't supported for pre-rendered pages`);
 }
 function preparePrerenderContextForPublicUsage(prerenderContext) {
-    // TODO/v1-release: remove
+    // TO-DO/next-major-release: remove
     if (!('prerenderPageContexts' in prerenderContext)) {
         Object.defineProperty(prerenderContext, 'prerenderPageContexts', {
             get() {

package/dist/esm/node/runtime/globalContext.d.ts

@@ -21,8 +21,10 @@ export type { GlobalContextServerInternal as GlobalContextServerInternal };
 export type { GlobalContextServer };
 import type { ViteManifest } from '../../types/ViteManifest.js';
 import type { ResolvedConfig, ViteDevServer } from 'vite';
+import { type PageRoutes } from '../../shared/route/loadPageRoutes.js';
 import type { ViteConfigRuntime } from '../vite/shared/getViteConfigRuntime.js';
 import type { GlobalContext } from '../../types/PageContext.js';
+import type { Hook } from '../../shared/hooks/getHook.js';
 declare const vikeConfigErrorRecoverMsg: "Vike config loaded";
 type GlobalContextServer = Pick<GlobalContextServerInternal, 'assetsManifest' | 'config' | 'viteConfig' | 'viteConfigRuntime' | 'pages' | 'baseServer' | 'baseAssets' | 'isClientSide'> & Vike.GlobalContext & Vike.GlobalContextServer;
 type GlobalContextServerInternal = Awaited<ReturnType<typeof setGlobalContext>>;
@@ -64,8 +66,8 @@ declare function getGlobalContextServerInternal(): Promise<{
         baseServer: string;
         baseAssets: string;
         isClientSide: false;
-        _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-        _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+        _pageRoutes: PageRoutes;
+        _onBeforeRouteHook: Hook | null;
     }) | (Record<string, unknown> & {
         isGlobalContext: true;
         _isOriginalObject: true;
@@ -104,8 +106,8 @@ declare function getGlobalContextServerInternal(): Promise<{
         baseServer: string;
         baseAssets: string;
         isClientSide: false;
-        _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-        _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+        _pageRoutes: PageRoutes;
+        _onBeforeRouteHook: Hook | null;
     }) | (Record<string, unknown> & {
         isGlobalContext: true;
         _isOriginalObject: true;
@@ -144,8 +146,8 @@ declare function getGlobalContextServerInternal(): Promise<{
         baseServer: string;
         baseAssets: string;
         isClientSide: false;
-        _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-        _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+        _pageRoutes: PageRoutes;
+        _onBeforeRouteHook: Hook | null;
     });
 }>;
 /**
@@ -164,14 +166,12 @@ declare function getGlobalContextAsync(isProduction: boolean): Promise<GlobalCon
  * Get runtime information about your app.
  *
  * https://vike.dev/getGlobalContext
- *
- * @deprecated
  */
 declare function getGlobalContextSync(): GlobalContext;
 declare function setGlobalContext_viteDevServer(viteDevServer: ViteDevServer): Promise<void>;
 declare function setGlobalContext_viteConfig(viteConfig: ResolvedConfig, viteConfigRuntime: ViteConfigRuntime): void;
 declare function setGlobalContext_isPrerendering(): void;
-declare function setGlobalContext_isProduction(isProduction: boolean, tolerateContraditction?: true): void;
+declare function setGlobalContext_isProduction(isProduction: boolean, tolerateContraditction?: boolean): void;
 declare function getViteDevServer(): ViteDevServer | null;
 declare function getViteConfig(): ResolvedConfig | null;
 declare function initGlobalContext_renderPage(): Promise<void>;
@@ -224,8 +224,8 @@ declare function setGlobalContext(virtualFileExports: unknown): Promise<{
     baseServer: string;
     baseAssets: string;
     isClientSide: false;
-    _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-    _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+    _pageRoutes: PageRoutes;
+    _onBeforeRouteHook: Hook | null;
 } | {
     _isPrerendering: true;
     viteConfig: ResolvedConfig;
@@ -246,8 +246,8 @@ declare function setGlobalContext(virtualFileExports: unknown): Promise<{
     baseServer: string;
     baseAssets: string;
     isClientSide: false;
-    _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-    _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+    _pageRoutes: PageRoutes;
+    _onBeforeRouteHook: Hook | null;
 } | {
     _isPrerendering: false;
     viteConfig: null;
@@ -268,7 +268,7 @@ declare function setGlobalContext(virtualFileExports: unknown): Promise<{
     baseServer: string;
     baseAssets: string;
     isClientSide: false;
-    _pageRoutes: import("../../shared/route/loadPageRoutes.js").PageRoutes;
-    _onBeforeRouteHook: import("../../shared/hooks/getHook.js").Hook | null;
+    _pageRoutes: PageRoutes;
+    _onBeforeRouteHook: Hook | null;
 })>;
 declare function clearGlobalContext(): void;