vike 0.4.228-commit-0e9e0f2 → 0.4.228-commit-1bb55f1

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

@@ -1,7 +1,7 @@
 export { getGlobalContext };
 export { getGlobalContextSync };
 export { getGlobalContextAsync };
-export { getGlobalContextInternal };
+export { getGlobalContextServerInternal };
 export { getViteDevServer };
 export { getViteConfig };
 export { initGlobalContext_renderPage };
@@ -16,14 +16,15 @@ export { clearGlobalContext };
 export { assertBuildInfo };
 export { updateUserFiles };
 export type { BuildInfo };
-export type { GlobalContextServerInternal as GlobalContextInternal };
+export type { GlobalContextServerInternal as GlobalContextServerInternal };
 export type { GlobalContextServer };
 import type { ViteManifest } from '../shared/ViteManifest.js';
 import type { ResolvedConfig, ViteDevServer } from 'vite';
 import type { ViteConfigRuntime } from '../plugin/shared/getViteConfigRuntime.js';
+import type { GlobalContext } from '../../shared/types.js';
 type GlobalContextServer = ReturnType<typeof makePublic> & Vike.GlobalContext & Vike.GlobalContextServer;
 type GlobalContextServerInternal = Awaited<ReturnType<typeof setGlobalContext>>;
-declare function getGlobalContextInternal(): Promise<{
+declare function getGlobalContextServerInternal(): Promise<{
     globalContext: (Record<string, unknown> & {
         isGlobalContext: true;
         _virtualFileExports: unknown;
@@ -246,13 +247,13 @@ declare function getGlobalContextInternal(): Promise<{
  *
  * https://vike.dev/getGlobalContext
  */
-declare function getGlobalContext(): Promise<GlobalContextServer>;
+declare function getGlobalContext(): Promise<GlobalContext>;
 /**
  * Get runtime information about your app.
  *
  * https://vike.dev/getGlobalContext
  */
-declare function getGlobalContextAsync(isProduction: boolean): Promise<GlobalContextServer>;
+declare function getGlobalContextAsync(isProduction: boolean): Promise<GlobalContext>;
 /**
  * Get runtime information about your app.
  *
@@ -260,7 +261,7 @@ declare function getGlobalContextAsync(isProduction: boolean): Promise<GlobalCon
  *
  * @deprecated
  */
-declare function getGlobalContextSync(): GlobalContextServer;
+declare function getGlobalContextSync(): GlobalContext;
 declare function makePublic(globalContext: GlobalContextServerInternal): Pick<{
     isGlobalContext: true;
     _virtualFileExports: unknown;

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

@@ -3,7 +3,7 @@ export { getGlobalContext };
 export { getGlobalContextSync };
 export { getGlobalContextAsync };
 // Internal use
-export { getGlobalContextInternal };
+export { getGlobalContextServerInternal };
 export { getViteDevServer };
 export { getViteConfig };
 export { initGlobalContext_renderPage };
@@ -32,14 +32,14 @@ import pc from '@brillout/picocolors';
 import { loadPageRoutes } from '../../shared/route/loadPageRoutes.js';
 import { assertV1Design } from '../shared/assertV1Design.js';
 import { resolveBase } from '../shared/resolveBase.js';
-import { createGlobalContextShared } from '../../shared/createGlobalContextShared.js';
+import { createGlobalContextShared, getGlobalContextSyncErrMsg } from '../../shared/createGlobalContextShared.js';
 const debug = createDebugger('vike:globalContext');
 const globalObject = getGlobalObject('runtime/globalContext.ts', getInitialGlobalContext());
 // Trick to break down TypeScript circular dependency
 // https://chat.deepseek.com/a/chat/s/d7e9f90a-c7f3-4108-9cd5-4ad6caed3539
 const globalObjectTyped = globalObject;
-async function getGlobalContextInternal() {
-    // getGlobalContextInternal() should always be called after initGlobalContext()
+async function getGlobalContextServerInternal() {
+    // getGlobalContextServerInternal() should always be called after initGlobalContext()
     assert(globalObject.isInitialized);
     assertGlobalContextIsDefined();
     if (globalObject.isProduction !== true)
@@ -61,6 +61,7 @@ function assertGlobalContextIsDefined() {
     assert(globalObject.globalContext);
     assert(globalObject.globalContext_public);
 }
+// We purposely return GlobalContext instead of GlobalContextServer because `import { getGlobalContext } from 'vike'` can resolve to the client-side implementation.
 /**
  * Get runtime information about your app.
  *
@@ -102,9 +103,9 @@ async function getGlobalContextAsync(isProduction) {
 function getGlobalContextSync() {
     debug('getGlobalContextSync()');
     const { globalContext_public } = globalObjectTyped;
-    assertUsage(globalContext_public, "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.");
+    assertUsage(globalContext_public, getGlobalContextSyncErrMsg);
     assertWarning(false, 
-    // We discourage users from using it because using `pageContext.globalContext` is better: it doesn't have the race condition issue that `getGlobalContextSync()` would have when called inside React/Vue components.
+    // 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 });
     return globalContext_public;

package/dist/esm/node/runtime/html/injectAssets/getViteDevScript.d.ts

@@ -1,5 +1,5 @@
 export { getViteDevScript };
-import type { GlobalContextInternal } from '../../globalContext.js';
+import type { GlobalContextServerInternal } from '../../globalContext.js';
 declare function getViteDevScript(pageContext: {
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
 }): Promise<string>;

package/dist/esm/node/runtime/html/injectAssets.d.ts

@@ -8,7 +8,7 @@ import { type PreloadFilter } from './injectAssets/getHtmlTags.js';
 import type { StreamFromReactStreamingPackage } from './stream/react-streaming.js';
 import type { PageConfigRuntime } from '../../../shared/page-configs/PageConfig.js';
 import type { PageContextSerialization } from './serializeContext.js';
-import type { GlobalContextInternal } from '../globalContext.js';
+import type { GlobalContextServerInternal } from '../globalContext.js';
 type PageContextInjectAssets = {
     urlPathname: string;
     __getPageAssets: () => Promise<PageAsset[]>;
@@ -22,7 +22,7 @@ type PageContextInjectAssets = {
     _baseServer: string;
     _pageConfigs: PageConfigRuntime[];
     is404: null | boolean;
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
 } & PageContextSerialization;
 declare function injectHtmlTagsToString(htmlParts: HtmlPart[], pageContext: PageContextInjectAssets & {
     _isStream: false;

package/dist/esm/node/runtime/index-deprecated.d.ts

@@ -1,16 +1 @@
-export * from './index-common.js';
-export * from '../../types/index-dreprecated.js';
-import { RenderErrorPage as RenderErrorPage_ } from '../../shared/route/abort.js';
-/** @deprecated
- * Replace:
- *   ```
- *   import { RenderErrorPage } from 'vike'
- *   ```
- * With:
- *   ```
- *   import { render } from 'vike/abort'
- *   ```
- *
- * See https://vike.dev/render
- */
-export declare const RenderErrorPage: (...args: Parameters<typeof RenderErrorPage_>) => Error;
+export * from './index.js';

package/dist/esm/node/runtime/index-deprecated.js

@@ -1,41 +1,14 @@
-// TODO/v1-release: replace this with:
-// assertUsage(false, "`import { something } from 'vike'` doesn't exist: instead import from 'vike/server', 'vike/client', 'vike/plugin', ...")
-import { isBrowser } from '../../utils/isBrowser.js';
-import { assertUsage } from '../../utils/assert.js';
-assertUsage(!isBrowser(), "It's forbidden to `import { something } from 'vike'` on the client-side: the module 'vike' is a server-only module.", { showStackTrace: true });
-export * from './index-common.js';
-export * from '../../types/index-dreprecated.js';
+// TODO/soon: point package.json#exports['./server'] to this file.
+// - Write migration guide, see comment below.
+export * from './index.js';
 import { assertWarning } from './utils.js';
 import pc from '@brillout/picocolors';
-import { RenderErrorPage as RenderErrorPage_ } from '../../shared/route/abort.js';
-/** @deprecated
- * Replace:
- *   ```
- *   import { RenderErrorPage } from 'vike'
- *   ```
- * With:
- *   ```
- *   import { render } from 'vike/abort'
- *   ```
- *
- * See https://vike.dev/render
- */
-export const RenderErrorPage = (...args) => {
-    assertWarning(false, [
-        'Replace:',
-        pc.red("  import { RenderErrorPage } from 'vike'"),
-        'With:',
-        pc.green("  import { render } from 'vike/abort'"),
-        'See https://vike.dev/render'
-    ].join('\n'), { onlyOnce: true, showStackTrace: true });
-    return RenderErrorPage_(...args);
-};
 assertWarning(false, [
-    'You have following imports which are outdated:',
-    pc.red("  import { something } from 'vike'"),
+    'You have outdated imports:',
+    pc.bold(pc.red("  import { something } from 'vike/server'")),
     'Replace them with:',
-    pc.green("  import { something } from 'vike/server'"),
-    `Or if ${pc.cyan('something')} is a type:`,
-    pc.green("  import type { something } from 'vike/types'"),
-    "Make sure to import renderPage(), escapeInject, html, dangerouslySkipEscape(), pipeWebStream(), pipeNodeStream(), pipeStream(), stampPipe() from 'vike/server'. (Or inspect the error stack below to find the import causing this warning.)"
+    pc.bold(pc.green("  import { something } from 'vike'"))
+    /* Add migration guide, with migration scritps such as `$ rename vike/server vike`
+    `See ${pc.underline('https://vike.dev/migration/0.4.xxx')}`
+    */
 ].join('\n'), { showStackTrace: true, onlyOnce: true });

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

@@ -1 +1,23 @@
-export * from './index-common.js';
+export { renderPage } from './renderPage.js';
+export { escapeInject, dangerouslySkipEscape } from './html/renderHtml.js';
+export { pipeWebStream, pipeNodeStream, pipeStream, stampPipe } from './html/stream.js';
+export { PROJECT_VERSION as version } from './utils.js';
+export { getGlobalContext, getGlobalContextSync, getGlobalContextAsync } from './globalContext.js';
+export { createDevMiddleware } from '../runtime-dev/index.js';
+export * from '../../types/index-dreprecated.js';
+export { injectAssets__public as _injectAssets } from './html/injectAssets/injectAssets__public.js';
+export { createPageRenderer } from '../createPageRenderer.js';
+import { RenderErrorPage as RenderErrorPage_ } from '../../shared/route/abort.js';
+/** @deprecated
+ * Replace:
+ *   ```
+ *   import { RenderErrorPage } from 'vike'
+ *   ```
+ * With:
+ *   ```
+ *   import { render } from 'vike/abort'
+ *   ```
+ *
+ * See https://vike.dev/render
+ */
+export declare const RenderErrorPage: (...args: Parameters<typeof RenderErrorPage_>) => Error;

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

@@ -1,4 +1,39 @@
 import { isBrowser } from '../../utils/isBrowser.js';
-import { assertUsage } from '../../utils/assert.js';
-assertUsage(!isBrowser(), "It's forbidden to `import { something } from 'vike/server'` on the client-side: the module 'vike/server' is a server-only module.", { showStackTrace: true });
-export * from './index-common.js';
+import { assert } from '../../utils/assert.js';
+assert(!isBrowser());
+export { renderPage } from './renderPage.js';
+export { escapeInject, dangerouslySkipEscape } from './html/renderHtml.js';
+export { pipeWebStream, pipeNodeStream, pipeStream, stampPipe } from './html/stream.js';
+export { PROJECT_VERSION as version } from './utils.js';
+export { getGlobalContext, getGlobalContextSync, getGlobalContextAsync } from './globalContext.js';
+export { createDevMiddleware } from '../runtime-dev/index.js';
+// TODO/v1-release: remove
+// Deprecated exports
+export * from '../../types/index-dreprecated.js';
+export { injectAssets__public as _injectAssets } from './html/injectAssets/injectAssets__public.js';
+export { createPageRenderer } from '../createPageRenderer.js';
+import { assertWarning } from './utils.js';
+import pc from '@brillout/picocolors';
+import { RenderErrorPage as RenderErrorPage_ } from '../../shared/route/abort.js';
+/** @deprecated
+ * Replace:
+ *   ```
+ *   import { RenderErrorPage } from 'vike'
+ *   ```
+ * With:
+ *   ```
+ *   import { render } from 'vike/abort'
+ *   ```
+ *
+ * See https://vike.dev/render
+ */
+export const RenderErrorPage = (...args) => {
+    assertWarning(false, [
+        'Replace:',
+        pc.red("  import { RenderErrorPage } from 'vike'"),
+        'With:',
+        pc.green("  import { render } from 'vike/abort'"),
+        'See https://vike.dev/render'
+    ].join('\n'), { onlyOnce: true, showStackTrace: true });
+    return RenderErrorPage_(...args);
+};

package/dist/esm/node/runtime/renderPage/analyzePage.d.ts

@@ -2,5 +2,5 @@ export { analyzePage };
 import type { PageFile } from '../../../shared/getPageFiles/getPageFileObject.js';
 import type { PageConfigRuntime } from '../../../shared/page-configs/PageConfig.js';
 import { type AnalysisResult } from '../../../shared/getPageFiles/analyzePageClientSide.js';
-import type { GlobalContextInternal } from '../globalContext.js';
-declare function analyzePage(pageFilesAll: PageFile[], pageConfig: null | PageConfigRuntime, pageId: string, globalContext: GlobalContextInternal): Promise<AnalysisResult>;
+import type { GlobalContextServerInternal } from '../globalContext.js';
+declare function analyzePage(pageFilesAll: PageFile[], pageConfig: null | PageConfigRuntime, pageId: string, globalContext: GlobalContextServerInternal): Promise<AnalysisResult>;

package/dist/esm/node/runtime/renderPage/createPageContextServerSide.d.ts

@@ -1,10 +1,10 @@
 export { createPageContextServerSide };
 export { createPageContextServerSideWithoutGlobalContext };
 export type { PageContextCreatedServerSide };
-import type { GlobalContextInternal, GlobalContextServer } from '../globalContext.js';
+import type { GlobalContextServerInternal, GlobalContextServer } from '../globalContext.js';
 import type { PageContextInit } from '../renderPage.js';
 type PageContextCreatedServerSide = Awaited<ReturnType<typeof createPageContextServerSide>>;
-declare function createPageContextServerSide(pageContextInit: PageContextInit, globalContext: GlobalContextInternal, globalObject_public: GlobalContextServer, { isPrerendering, ssr: { urlHandler, isClientSideNavigation } }: {
+declare function createPageContextServerSide(pageContextInit: PageContextInit, globalContext: GlobalContextServerInternal, globalObject_public: GlobalContextServer, { isPrerendering, ssr: { urlHandler, isClientSideNavigation } }: {
     isPrerendering: false;
     ssr: {
         urlHandler: null | ((url: string) => string);

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

@@ -5,7 +5,7 @@ export type { GetPageAssets };
 export type { PageContextGetPageAssets };
 import { type MediaType } from './inferMediaType.js';
 import type { ClientDependency } from '../../../shared/getPageFiles/analyzePageClientSide/ClientDependency.js';
-import type { GlobalContextInternal } from '../globalContext.js';
+import type { GlobalContextServerInternal } from '../globalContext.js';
 import type { ResolveClientEntriesDev } from '../../plugin/shared/resolveClientEntriesDev.js';
 type PageAsset = {
     src: string;
@@ -18,7 +18,7 @@ type PageContextGetPageAssets = {
     _baseServer: string;
     _baseAssets: string | null;
     _includeAssetsImportedByServer: boolean;
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
 };
 declare function getPageAssets(pageContext: PageContextGetPageAssets, clientDependencies: ClientDependency[], clientEntries: string[]): Promise<PageAsset[]>;
 declare function setResolveClientEntriesDev(resolveClientEntriesDev: ResolveClientEntriesDev): void;

package/dist/esm/node/runtime/renderPage/handleErrorWithoutErrorPage.d.ts

@@ -1,5 +1,5 @@
 export { handleErrorWithoutErrorPage };
-import type { GlobalContextInternal } from '../globalContext.js';
+import type { GlobalContextServerInternal } from '../globalContext.js';
 import type { PageContextAfterRender } from './renderPageAlreadyRouted.js';
 import type { PageConfigRuntime } from '../../../shared/page-configs/PageConfig.js';
 import type { PageFile } from '../../../shared/getPageFiles.js';
@@ -10,6 +10,6 @@ declare function handleErrorWithoutErrorPage<PageContext extends {
     pageId: null;
     _pageFilesAll: PageFile[];
     _pageConfigs: PageConfigRuntime[];
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
     urlOriginal: string;
 }>(pageContext: PageContext): Promise<PageContext & PageContextAfterRender>;

package/dist/esm/node/runtime/renderPage/loadUserFilesServerSide.d.ts

@@ -6,12 +6,12 @@ import { PromiseType } from '../utils.js';
 import { PageContextGetPageAssets, type PageAsset } from './getPageAssets.js';
 import { type PageContextDebugRouteMatches } from './debugPageFiles.js';
 import type { PageConfigRuntime } from '../../../shared/page-configs/PageConfig.js';
-import type { GlobalContextInternal } from '../globalContext.js';
+import type { GlobalContextServerInternal } from '../globalContext.js';
 type PageContext_loadUserFilesServerSide = PageContextGetPageAssets & PageContextDebugRouteMatches & {
     urlOriginal: string;
     _pageFilesAll: PageFile[];
     _pageConfigs: PageConfigRuntime[];
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
 };
 type PageFiles = PromiseType<ReturnType<typeof loadUserFilesServerSide>>;
 declare function loadUserFilesServerSide(pageContext: {

package/dist/esm/node/runtime/renderPage/log404/index.d.ts

@@ -1,12 +1,12 @@
 export { log404 };
 export { getRoutesInfo };
 import type { PageRoutes } from '../../../../shared/route/index.js';
-import type { GlobalContextInternal } from '../../globalContext.js';
+import type { GlobalContextServerInternal } from '../../globalContext.js';
 declare function log404(pageContext: {
     urlPathname: string;
     errorWhileRendering: null | Error;
     isClientSideNavigation: boolean;
     _pageRoutes: PageRoutes;
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
 }): Promise<void>;
 declare function getRoutesInfo(pageRoutes: PageRoutes): string | null;

package/dist/esm/node/runtime/renderPage/preparePageContextForUserConsumptionServerSide.d.ts

@@ -4,7 +4,7 @@ import { PageContextUrlInternal } from '../../../shared/getPageContextUrlCompute
 import type { PageConfigRuntime } from '../../../shared/page-configs/PageConfig.js';
 import type { PageConfigUserFriendlyOld } from '../../../shared/page-configs/getPageConfigUserFriendly.js';
 import { PageContextBuiltInServerInternal } from '../../../shared/types.js';
-import type { GlobalContextInternal, GlobalContextServer } from '../globalContext.js';
+import type { GlobalContextServerInternal, GlobalContextServer } from '../globalContext.js';
 type PageContextForUserConsumptionServerSide = PageContextBuiltInServerInternal & PageConfigUserFriendlyOld & {
     urlOriginal: string;
     /** @deprecated */
@@ -18,7 +18,7 @@ type PageContextForUserConsumptionServerSide = PageContextBuiltInServerInternal
     is404: null | boolean;
     isClientSideNavigation: boolean;
     pageProps?: Record<string, unknown>;
-    _globalContext: GlobalContextInternal;
+    _globalContext: GlobalContextServerInternal;
     globalContext: GlobalContextServer;
 } & Record<string, unknown>;
 declare function preparePageContextForUserConsumptionServerSide(pageContext: PageContextForUserConsumptionServerSide): void;

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

@@ -2,7 +2,7 @@ export { renderPage };
 export { renderPage_addAsyncHookwrapper };
 export type { PageContextInit };
 export type { PageContextBegin };
-import { type GlobalContextServer, type GlobalContextInternal } from './globalContext.js';
+import { type GlobalContextServer, type GlobalContextServerInternal } from './globalContext.js';
 import { type HttpResponse } from './renderPage/createHttpResponse.js';
 import type { PageContextServer } from '../../types/index.js';
 import type { PageContextBuiltInServerInternal } from '../../shared/types.js';
@@ -18,7 +18,7 @@ declare let asyncHookWrapper: <PageContext>(_httpRequestId: number, ret: () => P
     pageContextReturn: Awaited<PageContext>;
 }>;
 declare function renderPage_addAsyncHookwrapper(wrapper: typeof asyncHookWrapper): void;
-declare function getPageContextBegin(pageContextInit: PageContextInit, globalContext: GlobalContextInternal, globalContext_public: GlobalContextServer, httpRequestId: number): Promise<{
+declare function getPageContextBegin(pageContextInit: PageContextInit, globalContext: GlobalContextServerInternal, globalContext_public: GlobalContextServer, httpRequestId: number): Promise<{
     isClientSide: boolean;
     isPrerendering: boolean;
 } & Pick<PageContextBuiltInServerInternal, "urlOriginal" | "headersOriginal"> & {

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

@@ -5,7 +5,7 @@ import { createPageContextServerSide, createPageContextServerSideWithoutGlobalCo
 import { route } from '../../shared/route/index.js';
 import { assert, hasProp, objectAssign, isUrl, parseUrl, onSetupRuntime, assertWarning, getGlobalObject, checkType, assertUsage, normalizeUrlPathname, removeBaseServer, modifyUrlPathname, prependBase, removeUrlOrigin, setUrlOrigin, isUri, getUrlPretty } from './utils.js';
 import { assertNoInfiniteAbortLoop, getPageContextFromAllRewrites, isAbortError, logAbortErrorHandled } from '../../shared/route/abort.js';
-import { getGlobalContextInternal, initGlobalContext_renderPage } from './globalContext.js';
+import { getGlobalContextServerInternal, initGlobalContext_renderPage } from './globalContext.js';
 import { handlePageContextRequestUrl } from './renderPage/handlePageContextRequestUrl.js';
 import { createHttpResponseFavicon404, createHttpResponseRedirect, createHttpResponsePageContextJson, createHttpResponseError, createHttpResponseErrorWithoutGlobalContext, createHttpResponseBaseIsMissing } from './renderPage/createHttpResponse.js';
 import { logRuntimeError, logRuntimeInfo } from './renderPage/loggerRuntime.js';
@@ -76,7 +76,7 @@ async function renderPagePrepare(pageContextInit, httpRequestId) {
     else {
         // `globalContext` now contains the entire Vike config and getVikeConfig() isn't called anymore for this request.
     }
-    const { globalContext, globalContext_public } = await getGlobalContextInternal();
+    const { globalContext, globalContext_public } = await getGlobalContextServerInternal();
     const pageContextBegin = await getPageContextBegin(pageContextInit, globalContext, globalContext_public, httpRequestId);
     // Check Base URL
     {

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

@@ -1,6 +1,8 @@
 export { createGlobalContextShared };
+export { getGlobalContextSyncErrMsg };
 export type { GlobalContextShared };
 export type { GlobalContextSharedPublic };
+declare const getGlobalContextSyncErrMsg = "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.";
 declare function createGlobalContextShared<GlobalContextAddendum extends object>(virtualFileExports: unknown, globalObject: {
     globalContext?: Record<string, unknown>;
 }, addGlobalContext?: (globalContext: GlobalContextShared) => Promise<GlobalContextAddendum>): Promise<{

package/dist/esm/shared/createGlobalContextShared.js

@@ -1,4 +1,6 @@
 export { createGlobalContextShared };
+export { getGlobalContextSyncErrMsg };
+const getGlobalContextSyncErrMsg = "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.";
 import { getPageConfigsRuntime } from './getPageConfigsRuntime.js';
 import { executeHookGenericGlobalCumulative } from './hooks/executeHookGeneric.js';
 import { objectAssign } from './utils.js';

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

@@ -8,7 +8,7 @@ import { getDefinedAtString } from '../page-configs/getConfigDefinedAt.js';
 import { warnDeprecatedAllowKey } from './resolveRouteFunction.js';
 import { getHookFromPageConfigGlobal, getHookTimeoutDefault } from '../hooks/getHook.js';
 async function loadPageRoutes(
-// Remove all arguments and use GlobalContextInternal instead?
+// Remove all arguments and use GlobalContextServerInternal instead?
 pageFilesAll, pageConfigs, pageConfigGlobal, allPageIds) {
     // TODO/next-major: remove & make this function sync
     await Promise.all(pageFilesAll.filter((p) => p.fileType === '.page.route').map((p) => p.loadFile?.()));

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

@@ -35,21 +35,25 @@ type PageContextBuiltInCommon<Data> = {
     /** The `export { Page }` of your `.page.js` file.
      *
      * https://vike.dev/Page
+     * https://vike.dev/pageContext#Page
      */
     Page: Config['Page'];
     /** Route Parameters, e.g. `pageContext.routeParams.productId` for a Route String `/product/@productId`.
      *
      * https://vike.dev/route-string
+     * https://vike.dev/pageContext#routeParams
      */
     routeParams: Record<string, string>;
     /** The page's data which was fetched using the data() hook.
      *
      * https://vike.dev/data
+     * https://vike.dev/pageContext#data
      */
     data: Data;
     /** The page's configuration values.
      *
      * https://vike.dev/config
+     * https://vike.dev/pageContext#config
      */
     config: PageContextConfig;
     /** The page's configuration, including the configs origin and overriden configs.
@@ -78,9 +82,8 @@ type PageContextBuiltInCommon<Data> = {
      *
      * As a string object normalized by Vike.
      *
-     * See also:
-     * - https://vike.dev/headers
-     * - `pageContext.headersOriginal`
+     * https://vike.dev/headers
+     * https://vike.dev/pageContext#headers
      */
     headers: Record<string, string> | null;
     /**
@@ -88,9 +91,8 @@ type PageContextBuiltInCommon<Data> = {
      *
      * The original object provided by the server.
      *
-     * See also:
-     * - https://vike.dev/headers
-     * - `pageContext.headers`
+     * https://vike.dev/headers
+     * https://vike.dev/pageContext#headersOriginal
      */
     headersOriginal?: unknown;
     /** If an error occurs, whether the error is a `404 Page Not Found`.
@@ -101,25 +103,28 @@ type PageContextBuiltInCommon<Data> = {
     /**
      * Whether the page was navigated by the client-side router.
      *
-     * https://vike.dev/pageContext
+     * https://vike.dev/pageContext#isClientSideNavigation
      */
     isClientSideNavigation: boolean;
     /**
      * The reason why the original page was aborted. Usually used for showing a custom message on the error page.
      *
      * https://vike.dev/render
+     * https://vike.dev/pageContext#abortReason
      */
     abortReason?: unknown;
     /**
      * The status code set by `throw render(abortStatusCode)`.
      *
      * https://vike.dev/render
+     * https://vike.dev/pageContext#abortStatusCode
      */
     abortStatusCode?: AbortStatusCode;
     /**
      * Error that occured while rendering.
      *
      * https://vike.dev/error-tracking
+     * https://vike.dev/pageContext#errorWhileRendering
      */
     errorWhileRendering?: unknown;
     /**
@@ -140,6 +145,7 @@ type PageContextBuiltInCommon<Data> = {
      * Whether the Base URL is missing in the URL of the HTTP request made to the SSR server.
      *
      * https://vike.dev/base-url#setup
+     * https://vike.dev/pageContext#isBaseMissing
      */
     isBaseMissing?: true;
 };
@@ -147,7 +153,9 @@ type PageContextBuiltInServer<Data> = PageContextBuiltInCommon<Data> & PageConte
     /**
      * Whether the page is being rendered on the client-side or server-side / pre-rendered.
      *
-     * We recommend using `import.meta.env.SSR` instead, see https://vike.dev/pageContext
+     * We recommend using `import.meta.env.SSR` instead, see https://vike.dev/pageContext#isClientSide
+     *
+     * https://vike.dev/pageContext#isClientSide
      */
     isClientSide: false;
     /**
@@ -156,13 +164,14 @@ type PageContextBuiltInServer<Data> = PageContextBuiltInCommon<Data> & PageConte
      * The value is always `false` in development.
      *
      * https://vike.dev/pre-rendering
-     * https://vike.dev/pageContext
+     * https://vike.dev/pageContext#isPrerendering
      */
     isPrerendering: boolean;
     /**
      * Runtime information about your app.
      *
      * https://vike.dev/getGlobalContext
+     * https://vike.dev/pageContext#globalContext
      */
     globalContext: GlobalContextServer;
     isHydration?: undefined;
@@ -176,12 +185,14 @@ type PageContextBuiltInClientWithClientRouting<Data> = Partial<PageContextBuiltI
      * Whether the user is navigating back in history.
      *
      * The value is `true` when the user clicks on his browser's backward navigation button, or when invoking `history.back()`.
+     *
+     * https://vike.dev/pageContext#isBackwardNavigation
      */
     isBackwardNavigation: boolean | null;
     /**
      * Upon client-side page navigation, you can use `pageContext.previousPageContext` to access the `pageContext` of the previous page.
      *
-     * https://vike.dev/pageContext
+     * https://vike.dev/pageContext#previousPageContext
      */
     previousPageContext: PageContextClient<Data> | null;
     globalContext: GlobalContextClient;
@@ -191,12 +202,16 @@ type PageContextBuiltInClientWithServerRouting<Data> = Partial<PageContextBuiltI
      * Whether the current page is already rendered to HTML.
      *
      * The `isHydration` value is always `true` when using Server Routing.
+     *
+     * https://vike.dev/pageContext#isHydration
      */
     isHydration: true;
     /**
      * Whether the user is navigating back in history.
      *
      * The `isBackwardNavigation` property only works with Client Routing. (The value is always `null` when using Server Routing.)
+     *
+     * https://vike.dev/pageContext#isBackwardNavigation
      */
     isBackwardNavigation: null;
     globalContext: GlobalContextClientWithServerRouting;
@@ -205,7 +220,9 @@ type PageContextClientCommon = {
     /**
      * Whether the page is being rendered on the client-side, or rendered on the server-side / pre-rendered.
      *
-     * In order to save client-side KBs, we recommend using `import.meta.env.SSR` whenever possible instead, see https://vike.dev/pageContext
+     * In order to save client-side KBs, we recommend using `import.meta.env.SSR` whenever possible instead, see https://vike.dev/pageContext#isClientSide
+     *
+     * https://vike.dev/pageContext#isClientSide
      */
     isClientSide: true;
     /**
@@ -214,7 +231,7 @@ type PageContextClientCommon = {
      * The value is always `false` in development.
      *
      * https://vike.dev/pre-rendering
-     * https://vike.dev/pageContext
+     * https://vike.dev/pageContext#isPrerendering
      */
     isPrerendering: false;
 };

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

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.228-commit-0e9e0f2";
+export declare const PROJECT_VERSION: "0.4.228-commit-1bb55f1";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.228-commit-0e9e0f2';
+export const PROJECT_VERSION = '0.4.228-commit-1bb55f1';