vike 0.4.235 → 0.4.236

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,8 +166,6 @@ 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>;
@@ -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;

package/dist/esm/node/runtime/globalContext.js

@@ -13,7 +13,7 @@ export { setGlobalContext_viteDevServer };
 export { setGlobalContext_viteConfig };
 export { setGlobalContext_isPrerendering };
 export { setGlobalContext_isProduction };
-export { setGlobalContext_buildEntry };
+export { setGlobalContext_buildEntry }; // production entry
 export { clearGlobalContext };
 export { assertBuildInfo };
 export { updateUserFiles };
@@ -30,7 +30,7 @@ import { assert, onSetupRuntime, assertUsage, assertWarning, isPlainObject, obje
 import { importServerProductionEntry } from '@brillout/vite-plugin-server-entry/runtime';
 import { virtualFileIdEntryServer } from '../shared/virtualFiles/virtualFileEntry.js';
 import pc from '@brillout/picocolors';
-import { loadPageRoutes } from '../../shared/route/loadPageRoutes.js';
+import { loadPageRoutes, loadPageRoutesSync } from '../../shared/route/loadPageRoutes.js';
 import { assertV1Design } from '../shared/assertV1Design.js';
 import { resolveBase } from '../shared/resolveBase.js';
 import { createGlobalContextShared, getGlobalContextSyncErrMsg, } from '../../shared/createGlobalContextShared.js';
@@ -39,7 +39,7 @@ import { logRuntimeError, logRuntimeInfo } from './loggerRuntime.js';
 import { getVikeConfigErrorBuild, setVikeConfigError } from '../shared/getVikeConfigError.js';
 import { hasAlreadyLogged } from './renderPage/isNewError.js';
 const debug = createDebugger('vike:globalContext');
-const globalObject = getGlobalObject('runtime/globalContext.ts', getInitialGlobalContext());
+const globalObject = getGlobalObject('runtime/globalContext.ts', getInitialGlobalObject());
 // Trick to break down TypeScript circular dependency
 // https://chat.deepseek.com/a/chat/s/d7e9f90a-c7f3-4108-9cd5-4ad6caed3539
 const globalObjectTyped = globalObject;
@@ -99,17 +99,19 @@ async function getGlobalContextAsync(isProduction) {
  * Get runtime information about your app.
  *
  * https://vike.dev/getGlobalContext
- *
- * @deprecated
  */
 function getGlobalContextSync() {
     debug('getGlobalContextSync()');
     const { globalContext } = globalObjectTyped;
     assertUsage(globalContext, getGlobalContextSyncErrMsg);
-    assertWarning(false, 
-    // We discourage users from using it because `pageContext.globalContext` is safer: I ain't sure but there could be race conditions when using `getGlobalContextSync()` inside React/Vue components upon HMR.
-    // We're lying about "is going to be deprecated in the next major release": let's keep it and see if users need it (so far I can't see a use case for it).
-    'getGlobalContextSync() is going to be deprecated in the next major release, see https://vike.dev/getGlobalContext', { onlyOnce: true });
+    const isProd = globalContext._isProduction;
+    assert(typeof isProd === 'boolean');
+    assertWarning(isProd, 
+    // - We discourage users from using it in development because `pageContext.globalContext` is safer: I ain't sure but there could be race conditions when using `getGlobalContextSync()` inside React/Vue components upon HMR.
+    // - I don't see any issues with getGlobalContextSync() in production.
+    // - getGlobalContextSync() is used in production by vike-vercel
+    //   - https://discord.com/channels/@me/942519153502339072/1389546794676916344 (PM between Rom and Joël)
+    "getGlobalContextSync() shouldn't be used in development, see https://vike.dev/getGlobalContext", { onlyOnce: true });
     return getGlobalContextForPublicUsage();
 }
 function getGlobalContextForPublicUsage() {
@@ -230,6 +232,7 @@ function assertViteManifest(manifest) {
 async function loadBuildEntry(outDir) {
     debug('loadBuildEntry()');
     if (globalObject.globalContext) {
+        debug('loadBuildEntry() - already done');
         return;
     }
     if (!globalObject.buildEntry) {
@@ -255,6 +258,8 @@ async function loadBuildEntry(outDir) {
     globalObject.buildInfo = buildEntry.buildInfo;
     await setGlobalContext(buildEntry.virtualFileExports);
 }
+// This is the production entry, see:
+// https://github.com/vikejs/vike/blob/798e5465dc3e3e6723b38b601a50350c0a006fb8/packages/vike/node/vite/plugins/pluginBuild/pluginBuildEntry.ts#L47
 async function setGlobalContext_buildEntry(buildEntry) {
     debug('setGlobalContext_buildEntry()');
     setIsProduction(true);
@@ -264,6 +269,7 @@ async function setGlobalContext_buildEntry(buildEntry) {
     assert(globalObject.buildEntry); // ensure no infinite loop
     await loadBuildEntry();
     assertGlobalContextIsDefined();
+    debug('setGlobalContext_buildEntry() - done');
 }
 function assertBuildEntry(buildEntry) {
     assert(isObject(buildEntry));
@@ -360,18 +366,29 @@ async function updateUserFiles() {
     return onSuccess();
 }
 async function setGlobalContext(virtualFileExports) {
+    debug('setGlobalContext()');
     assert(!getVikeConfigErrorBuild());
-    const globalContext = await createGlobalContextShared(virtualFileExports, globalObject, addGlobalContext);
+    const globalContext = await createGlobalContextShared(virtualFileExports, globalObject, addGlobalContextAsync, addGlobalContextSync);
     assertV1Design(
     // pageConfigs is PageConfigRuntime[] but assertV1Design() requires PageConfigBuildTime[]
     globalContext._pageConfigs.length > 0, globalContext._pageFilesAll);
     assertGlobalContextIsDefined();
     onSetupRuntime();
+    debug('setGlobalContext() - done');
     // Never actually used, only used for TypeScript `ReturnType<typeof setGlobalContext>`
     return globalContext;
 }
-async function addGlobalContext(globalContext) {
+async function addGlobalContextAsync(globalContext) {
+    debug('addGlobalContextAsync()');
     const { pageRoutes, onBeforeRouteHook } = await loadPageRoutes(globalContext._pageFilesAll, globalContext._pageConfigs, globalContext._pageConfigGlobal, globalContext._allPageIds);
+    return addGlobalContextCommon(globalContext, pageRoutes, onBeforeRouteHook);
+}
+function addGlobalContextSync(globalContext) {
+    debug('addGlobalContextSync()');
+    const { pageRoutes, onBeforeRouteHook } = loadPageRoutesSync(globalContext._pageFilesAll, globalContext._pageConfigs, globalContext._pageConfigGlobal, globalContext._allPageIds);
+    return addGlobalContextCommon(globalContext, pageRoutes, onBeforeRouteHook);
+}
+function addGlobalContextCommon(globalContext, pageRoutes, onBeforeRouteHook) {
     const globalContextBase = {
         isClientSide: false,
         _pageRoutes: pageRoutes,
@@ -430,10 +447,10 @@ async function addGlobalContext(globalContext) {
 }
 function clearGlobalContext() {
     debug('clearGlobalContext()');
-    objectReplace(globalObject, getInitialGlobalContext(), ['buildEntryPrevious']);
+    objectReplace(globalObject, getInitialGlobalObject(), ['buildEntryPrevious']);
 }
-function getInitialGlobalContext() {
-    debug('getInitialGlobalContext()');
+function getInitialGlobalObject() {
+    debug('getInitialGlobalObject()');
     const { promise: viteDevServerPromise, resolve: viteDevServerPromiseResolve } = genPromise();
     return {
         viteDevServerPromise,

package/dist/esm/node/runtime/html/injectAssets/injectAssets__public.js

@@ -1,7 +1,7 @@
 export { injectAssets__public };
 import { assertUsage, assertWarning, castProp, hasProp } from '../../utils.js';
 import { injectHtmlTagsToString } from '../injectAssets.js';
-// TODO/v1-release: remove
+// TO-DO/next-major-release: remove
 async function injectAssets__public(htmlString, pageContext) {
     assertWarning(false, '`_injectAssets()` is deprecated and will be removed.', { onlyOnce: true, showStackTrace: true });
     assertUsage(typeof htmlString === 'string', '[injectAssets(htmlString, pageContext)]: Argument `htmlString` should be a string.', { showStackTrace: true });

package/dist/esm/node/runtime/html/injectAssets/injectHtmlTags.js

@@ -149,6 +149,8 @@ function getTagClosing(tag) {
     return tagClosing;
 }
 function injectAtPlaceholder(htmlFragment, htmlString, isFirst) {
+    // TO-DO/eventually: soft deprecate in favor of https://github.com/vikejs/vike/issues/695
+    // Used by BurdaForward https://github.com/vikejs/vike/discussions/2528#discussioncomment-13637156
     const placeholder = isFirst ? '__VITE_PLUGIN_SSR__ASSETS_FIRST__' : '__VITE_PLUGIN__SSR_ASSETS_LAST__';
     const parts = htmlString.split(placeholder);
     if (parts.length === 1)