vike 0.4.228-commit-84954ae → 0.4.228-commit-1bb55f1

package/dist/cjs/__internal/index.js

@@ -17,7 +17,7 @@ const assertSetup_js_1 = require("../utils/assertSetup.js");
 async function getPagesAndRoutes() {
     (0, assertSetup_js_1.setNodeEnvProduction)();
     await (0, globalContext_js_2.initGlobalContext_getPagesAndRoutes)();
-    const { globalContext } = await (0, globalContext_js_2.getGlobalContextInternal)();
+    const { globalContext } = await (0, globalContext_js_2.getGlobalContextServerInternal)();
     const { 
     //
     _pageRoutes: pageRoutes, _pageFilesAll: pageFilesAll, _pageConfigs: pageConfigs, _allPageIds: allPageIds } = globalContext;

package/dist/cjs/client/client-routing-runtime/globalContext.js

@@ -33,13 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGlobalContext = void 0;
-const createGetGlobalContext_js_1 = require("../shared/createGetGlobalContext.js");
+exports.getGlobalContextClientInternal = void 0;
+const createGetGlobalContextClient_js_1 = require("../shared/createGetGlobalContextClient.js");
 const loadPageRoutes_js_1 = require("../../shared/route/loadPageRoutes.js");
 // @ts-ignore
 const virtualFileExports = __importStar(require("virtual:vike:importUserCode:client:client-routing"));
-const getGlobalContext = (0, createGetGlobalContext_js_1.createGetGlobalContext)(virtualFileExports, true, addGlobalContext);
-exports.getGlobalContext = getGlobalContext;
+const getGlobalContextClientInternal = (0, createGetGlobalContextClient_js_1.createGetGlobalContextClient)(virtualFileExports, true, addGlobalContext);
+exports.getGlobalContextClientInternal = getGlobalContextClientInternal;
 async function addGlobalContext(globalContext) {
     const { pageRoutes, onBeforeRouteHook } = await (0, loadPageRoutes_js_1.loadPageRoutes)(globalContext._pageFilesAll, globalContext._pageConfigs, globalContext._pageConfigGlobal, globalContext._allPageIds);
     return {

package/dist/cjs/client/server-routing-runtime/globalContext.js

@@ -33,9 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGlobalContext = void 0;
-const createGetGlobalContext_js_1 = require("../shared/createGetGlobalContext.js");
+exports.getGlobalContextClientInternal = void 0;
+const createGetGlobalContextClient_js_1 = require("../shared/createGetGlobalContextClient.js");
 // @ts-ignore
 const virtualFileExports = __importStar(require("virtual:vike:importUserCode:client:server-routing"));
-const getGlobalContext = (0, createGetGlobalContext_js_1.createGetGlobalContext)(virtualFileExports, false);
-exports.getGlobalContext = getGlobalContext;
+const getGlobalContextClientInternal = (0, createGetGlobalContextClient_js_1.createGetGlobalContextClient)(virtualFileExports, false);
+exports.getGlobalContextClientInternal = getGlobalContextClientInternal;

package/dist/cjs/client/shared/{createGetGlobalContext.js → createGetGlobalContextClient.js}

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createGetGlobalContext = createGetGlobalContext;
+exports.getGlobalContext = getGlobalContext;
+exports.getGlobalContextSync = getGlobalContextSync;
+exports.createGetGlobalContextClient = createGetGlobalContextClient;
 const createGlobalContextShared_js_1 = require("../../shared/createGlobalContextShared.js");
 const getJsonSerializedInHtml_js_1 = require("./getJsonSerializedInHtml.js");
 const utils_js_1 = require("./utils.js");
-const globalObject = (0, utils_js_1.getGlobalObject)('createGetGlobalContext.ts', {});
-function createGetGlobalContext(virtualFileExports, isClientRouting, addGlobalContext) {
+const globalObject = (0, utils_js_1.getGlobalObject)('createGetGlobalContextClient.ts', (() => {
+    const { promise: globalContextPromise, resolve: globalContextPromiseResolve } = (0, utils_js_1.genPromise)();
+    return {
+        globalContextPromise,
+        globalContextPromiseResolve
+    };
+})());
+function createGetGlobalContextClient(virtualFileExports, isClientRouting, addGlobalContext) {
     (0, utils_js_1.assert)(globalObject.isClientRouting === undefined || globalObject.isClientRouting === isClientRouting);
     globalObject.isClientRouting = isClientRouting;
     // Eagerly call onCreateGlobalContext() hook
@@ -20,12 +28,31 @@ function createGetGlobalContext(virtualFileExports, isClientRouting, addGlobalCo
         }
         // Create
         const globalContext = await (0, createGlobalContextShared_js_1.createGlobalContextShared)(virtualFileExports, globalObject, async (globalContext) => {
-            const globalContextAddendum = {};
+            const globalContextAddendum = {
+                /**
+                 * 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
+            };
             (0, utils_js_1.objectAssign)(globalContextAddendum, (0, getJsonSerializedInHtml_js_1.getGlobalContextSerializedInHtml)());
             (0, utils_js_1.objectAssign)(globalContextAddendum, await addGlobalContext?.(globalContext));
             return globalContextAddendum;
         });
+        (0, utils_js_1.assert)(globalObject.globalContext);
+        globalObject.globalContextPromiseResolve(globalObject.globalContext);
         // Return
         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;
+}
+function getGlobalContextSync() {
+    const { globalContext } = globalObject;
+    (0, utils_js_1.assertUsage)(globalContext, createGlobalContextShared_js_1.getGlobalContextSyncErrMsg);
+    return globalContext;
+}

package/dist/cjs/client/shared/utils.js

@@ -19,3 +19,4 @@ __exportStar(require("../../utils/parseUrl.js"), exports);
 __exportStar(require("../../utils/getGlobalObject.js"), exports);
 __exportStar(require("../../utils/objectAssign.js"), exports);
 __exportStar(require("../../utils/hasProp.js"), exports);
+__exportStar(require("../../utils/genPromise.js"), exports);

package/dist/cjs/node/plugin/plugins/commonConfig.js

@@ -158,14 +158,17 @@ function assertSingleInstance(config) {
 function assertVikeCliOrApi(config) {
     if ((0, context_js_1.isVikeCliOrApi)())
         return;
-    if ((0, utils_js_1.isVitest)())
-        return;
     if ((0, isViteCliCall_js_1.isViteCliCall)()) {
+        (0, utils_js_1.assert)(!(0, utils_js_1.isVitest)());
         (0, utils_js_1.assertWarning)(false, `Vite's CLI is deprecated ${picocolors_1.default.underline('https://vike.dev/migration/cli')}`, {
             onlyOnce: true
         });
         return;
     }
+    if ((0, utils_js_1.isVitest)()) {
+        (0, utils_js_1.assertWarning)(false, `Unexpected Vitest setup: you seem to be using Vitest together with Vike's Vite plugin but without using Vike's JavaScript API which is unexpected, see ${picocolors_1.default.underline('https://vike.dev/vitest')}`, { onlyOnce: true });
+        return;
+    }
     if (config.server.middlewareMode) {
         (0, utils_js_1.assertWarning)(false, `${picocolors_1.default.cyan('vite.createServer()')} is deprecated ${picocolors_1.default.underline('https://vike.dev/migration/cli#api')}`, {
             onlyOnce: true

package/dist/cjs/node/plugin/plugins/importUserCode/v1-design/getVikeConfig/resolvePointerImport.js

@@ -73,7 +73,7 @@ function resolveImportPathWithNode(pointerImportData, importerFilePath, userRoot
     // filePathAbsoluteFilesystem is null when pointerImportData.importPath is a path alias that Node.js doesn't know about
     const filePathAbsoluteFilesystem = (0, utils_js_1.requireResolveOptional)({
         importPath: pointerImportData.importPath,
-        importerFile: importerFilePathAbsolute,
+        importerFilePath: importerFilePathAbsolute,
         userRootDir
     });
     if (!filePathAbsoluteFilesystem) {

package/dist/cjs/node/plugin/plugins/importUserCode/v1-design/getVikeConfig/transpileAndExecuteFile.js

@@ -212,7 +212,6 @@ async function transpileWithEsbuild(filePath, userRootDir, transformImports, esb
                             //   - Vike doesn't resolve path aliases at all.
                             //   - Node.js doesn't support `tsconfig.js#compilerOptions.paths`.
                             // - Esbuild path alias resolution seems reliable, e.g. it supports `tsconfig.js#compilerOptions.paths`.
-                            (0, utils_js_1.assert)(!(0, utils_js_1.isImportPathNpmPackageOrPathAlias)(importPathOriginal));
                             importPathTranspiled = importPathResolved;
                         }
                         else {

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

@@ -132,7 +132,7 @@ async function runPrerender(options = {}, standaloneTrigger) {
     }
     const concurrencyLimit = (0, utils_js_1.pLimit)(parallel === false || parallel === 0 ? 1 : parallel === true || parallel === undefined ? (0, os_1.cpus)().length : parallel);
     await (0, globalContext_js_1.initGlobalContext_runPrerender)();
-    const { globalContext, globalContext_public } = await (0, globalContext_js_1.getGlobalContextInternal)();
+    const { globalContext, globalContext_public } = await (0, globalContext_js_1.getGlobalContextServerInternal)();
     globalContext._pageFilesAll.forEach(assertExportNames);
     const prerenderContext = {
         pageContexts: [],

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGlobalContext = getGlobalContext;
 exports.getGlobalContextSync = getGlobalContextSync;
 exports.getGlobalContextAsync = getGlobalContextAsync;
-exports.getGlobalContextInternal = getGlobalContextInternal;
+exports.getGlobalContextServerInternal = getGlobalContextServerInternal;
 exports.getViteDevServer = getViteDevServer;
 exports.getViteConfig = getViteConfig;
 exports.initGlobalContext_renderPage = initGlobalContext_renderPage;
@@ -41,8 +41,8 @@ const globalObject = (0, utils_js_1.getGlobalObject)('runtime/globalContext.ts',
 // 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()
     (0, utils_js_1.assert)(globalObject.isInitialized);
     assertGlobalContextIsDefined();
     if (globalObject.isProduction !== true)
@@ -64,6 +64,7 @@ function assertGlobalContextIsDefined() {
     (0, utils_js_1.assert)(globalObject.globalContext);
     (0, utils_js_1.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.
  *
@@ -105,15 +106,24 @@ async function getGlobalContextAsync(isProduction) {
 function getGlobalContextSync() {
     debug('getGlobalContextSync()');
     const { globalContext_public } = globalObjectTyped;
-    (0, utils_js_1.assertUsage)(globalContext_public, "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.");
+    (0, utils_js_1.assertUsage)(globalContext_public, createGlobalContextShared_js_1.getGlobalContextSyncErrMsg);
     (0, utils_js_1.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;
 }
 function makePublic(globalContext) {
-    const globalContextPublic = (0, utils_js_1.getPublicProxy)(globalContext, 'globalContext', ['assetsManifest', 'config', 'viteConfig', 'viteConfigRuntime', 'pages', 'baseServer', 'baseAssets'], true);
+    const globalContextPublic = (0, utils_js_1.getPublicProxy)(globalContext, 'globalContext', [
+        'assetsManifest',
+        'config',
+        'viteConfig',
+        'viteConfigRuntime',
+        'pages',
+        'baseServer',
+        'baseAssets',
+        'isClientSide'
+    ], true);
     return globalContextPublic;
 }
 async function setGlobalContext_viteDevServer(viteDevServer) {
@@ -338,6 +348,7 @@ async function setGlobalContext(virtualFileExports) {
 async function addGlobalContext(globalContext) {
     const { pageRoutes, onBeforeRouteHook } = await (0, loadPageRoutes_js_1.loadPageRoutes)(globalContext._pageFilesAll, globalContext._pageConfigs, globalContext._pageConfigGlobal, globalContext._allPageIds);
     const globalContextBase = {
+        isClientSide: false,
         _pageRoutes: pageRoutes,
         _onBeforeRouteHook: onBeforeRouteHook
     };

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

@@ -1,6 +1,4 @@
 "use strict";
-// TODO/v1-release: replace this with:
-// assertUsage(false, "`import { something } from 'vike'` doesn't exist: instead import from 'vike/server', 'vike/client', 'vike/plugin', ...")
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -19,44 +17,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RenderErrorPage = void 0;
-const isBrowser_js_1 = require("../../utils/isBrowser.js");
-const assert_js_1 = require("../../utils/assert.js");
-(0, assert_js_1.assertUsage)(!(0, isBrowser_js_1.isBrowser)(), "It's forbidden to `import { something } from 'vike'` on the client-side: the module 'vike' is a server-only module.", { showStackTrace: true });
-__exportStar(require("./index-common.js"), exports);
-__exportStar(require("../../types/index-dreprecated.js"), exports);
+// TODO/soon: point package.json#exports['./server'] to this file.
+// - Write migration guide, see comment below.
+__exportStar(require("./index.js"), exports);
 const utils_js_1 = require("./utils.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-const abort_js_1 = require("../../shared/route/abort.js");
-/** @deprecated
- * Replace:
- *   ```
- *   import { RenderErrorPage } from 'vike'
- *   ```
- * With:
- *   ```
- *   import { render } from 'vike/abort'
- *   ```
- *
- * See https://vike.dev/render
- */
-const RenderErrorPage = (...args) => {
-    (0, utils_js_1.assertWarning)(false, [
-        'Replace:',
-        picocolors_1.default.red("  import { RenderErrorPage } from 'vike'"),
-        'With:',
-        picocolors_1.default.green("  import { render } from 'vike/abort'"),
-        'See https://vike.dev/render'
-    ].join('\n'), { onlyOnce: true, showStackTrace: true });
-    return (0, abort_js_1.RenderErrorPage)(...args);
-};
-exports.RenderErrorPage = RenderErrorPage;
 (0, utils_js_1.assertWarning)(false, [
-    'You have following imports which are outdated:',
-    picocolors_1.default.red("  import { something } from 'vike'"),
+    'You have outdated imports:',
+    picocolors_1.default.bold(picocolors_1.default.red("  import { something } from 'vike/server'")),
     'Replace them with:',
-    picocolors_1.default.green("  import { something } from 'vike/server'"),
-    `Or if ${picocolors_1.default.cyan('something')} is a type:`,
-    picocolors_1.default.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.)"
+    picocolors_1.default.bold(picocolors_1.default.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/cjs/node/runtime/index.js

@@ -13,8 +13,62 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderErrorPage = exports.createPageRenderer = exports._injectAssets = exports.createDevMiddleware = exports.getGlobalContextAsync = exports.getGlobalContextSync = exports.getGlobalContext = exports.version = exports.stampPipe = exports.pipeStream = exports.pipeNodeStream = exports.pipeWebStream = exports.dangerouslySkipEscape = exports.escapeInject = exports.renderPage = void 0;
 const isBrowser_js_1 = require("../../utils/isBrowser.js");
 const assert_js_1 = require("../../utils/assert.js");
-(0, assert_js_1.assertUsage)(!(0, isBrowser_js_1.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 });
-__exportStar(require("./index-common.js"), exports);
+(0, assert_js_1.assert)(!(0, isBrowser_js_1.isBrowser)());
+var renderPage_js_1 = require("./renderPage.js");
+Object.defineProperty(exports, "renderPage", { enumerable: true, get: function () { return renderPage_js_1.renderPage; } });
+var renderHtml_js_1 = require("./html/renderHtml.js");
+Object.defineProperty(exports, "escapeInject", { enumerable: true, get: function () { return renderHtml_js_1.escapeInject; } });
+Object.defineProperty(exports, "dangerouslySkipEscape", { enumerable: true, get: function () { return renderHtml_js_1.dangerouslySkipEscape; } });
+var stream_js_1 = require("./html/stream.js");
+Object.defineProperty(exports, "pipeWebStream", { enumerable: true, get: function () { return stream_js_1.pipeWebStream; } });
+Object.defineProperty(exports, "pipeNodeStream", { enumerable: true, get: function () { return stream_js_1.pipeNodeStream; } });
+Object.defineProperty(exports, "pipeStream", { enumerable: true, get: function () { return stream_js_1.pipeStream; } });
+Object.defineProperty(exports, "stampPipe", { enumerable: true, get: function () { return stream_js_1.stampPipe; } });
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return utils_js_1.PROJECT_VERSION; } });
+var globalContext_js_1 = require("./globalContext.js");
+Object.defineProperty(exports, "getGlobalContext", { enumerable: true, get: function () { return globalContext_js_1.getGlobalContext; } });
+Object.defineProperty(exports, "getGlobalContextSync", { enumerable: true, get: function () { return globalContext_js_1.getGlobalContextSync; } });
+Object.defineProperty(exports, "getGlobalContextAsync", { enumerable: true, get: function () { return globalContext_js_1.getGlobalContextAsync; } });
+var index_js_1 = require("../runtime-dev/index.js");
+Object.defineProperty(exports, "createDevMiddleware", { enumerable: true, get: function () { return index_js_1.createDevMiddleware; } });
+// TODO/v1-release: remove
+// Deprecated exports
+__exportStar(require("../../types/index-dreprecated.js"), exports);
+var injectAssets__public_js_1 = require("./html/injectAssets/injectAssets__public.js");
+Object.defineProperty(exports, "_injectAssets", { enumerable: true, get: function () { return injectAssets__public_js_1.injectAssets__public; } });
+var createPageRenderer_js_1 = require("../createPageRenderer.js");
+Object.defineProperty(exports, "createPageRenderer", { enumerable: true, get: function () { return createPageRenderer_js_1.createPageRenderer; } });
+const utils_js_2 = require("./utils.js");
+const picocolors_1 = __importDefault(require("@brillout/picocolors"));
+const abort_js_1 = require("../../shared/route/abort.js");
+/** @deprecated
+ * Replace:
+ *   ```
+ *   import { RenderErrorPage } from 'vike'
+ *   ```
+ * With:
+ *   ```
+ *   import { render } from 'vike/abort'
+ *   ```
+ *
+ * See https://vike.dev/render
+ */
+const RenderErrorPage = (...args) => {
+    (0, utils_js_2.assertWarning)(false, [
+        'Replace:',
+        picocolors_1.default.red("  import { RenderErrorPage } from 'vike'"),
+        'With:',
+        picocolors_1.default.green("  import { render } from 'vike/abort'"),
+        'See https://vike.dev/render'
+    ].join('\n'), { onlyOnce: true, showStackTrace: true });
+    return (0, abort_js_1.RenderErrorPage)(...args);
+};
+exports.RenderErrorPage = RenderErrorPage;

package/dist/cjs/node/runtime/renderPage/preparePageContextForUserConsumptionServerSide.js

@@ -9,7 +9,7 @@ function preparePageContextForUserConsumptionServerSide(pageContext) {
     (0, utils_js_1.assert)((0, utils_js_1.isPlainObject)(pageContext.routeParams));
     (0, utils_js_1.assert)('Page' in pageContext);
     (0, utils_js_1.assert)(typeof pageContext.isClientSideNavigation === 'boolean');
-    (0, utils_js_1.assert)(pageContext._isPageContextObject);
+    (0, utils_js_1.assert)(pageContext.isPageContext);
     (0, utils_js_1.assert)(pageContext.isClientSide === false);
     (0, utils_js_1.assert)(typeof pageContext.isPrerendering === 'boolean');
     (0, preparePageContextForUserConsumption_js_1.preparePageContextForUserConsumption)(pageContext);

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

@@ -81,7 +81,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 (0, globalContext_js_1.getGlobalContextInternal)();
+    const { globalContext, globalContext_public } = await (0, globalContext_js_1.getGlobalContextServerInternal)();
     const pageContextBegin = await getPageContextBegin(pageContextInit, globalContext, globalContext_public, httpRequestId);
     // Check Base URL
     {

package/dist/cjs/shared/assertPageContextProvidedByUser.js

@@ -12,7 +12,7 @@ function assertPageContextProvidedByUser(pageContextProvidedByUser, { hookName,
     (0, utils_js_1.assert)(!hookName.endsWith(')'));
     const errPrefix = `The ${picocolors_1.default.cyan('pageContext')} object provided by the ${hookName}() hook defined by ${hookFilePath}`;
     (0, utils_js_1.assertUsage)((0, utils_js_1.isObject)(pageContextProvidedByUser), `${errPrefix} should be an object (but it's ${picocolors_1.default.cyan(`typeof pageContext === ${JSON.stringify(typeof pageContextProvidedByUser)}`)} instead)`);
-    (0, utils_js_1.assertUsage)(!('_isPageContextObject' in pageContextProvidedByUser), `${errPrefix} shouldn't be the whole ${picocolors_1.default.cyan('pageContext')} object, see https://vike.dev/pageContext-manipulation#do-not-return-entire-pagecontext`);
+    (0, utils_js_1.assertUsage)(!('isPageContext' in pageContextProvidedByUser), `${errPrefix} shouldn't be the whole ${picocolors_1.default.cyan('pageContext')} object, see https://vike.dev/pageContext-manipulation#do-not-return-entire-pagecontext`);
     // In principle, it's possible to use onBeforeRoute()` to override and define the whole routing.
     // Is that a good idea to allow users to do this? Beyond deep integration with Vue Router or React Router, is there a use case for this?
     (0, utils_js_1.assertWarning)(!('pageId' in pageContextProvidedByUser), `${errPrefix} sets ${picocolors_1.default.cyan('pageContext.pageId')} which means that Vike's routing is overriden. This is an experimental feature: make sure to contact a vike maintainer before using this.`, { onlyOnce: true });

package/dist/cjs/shared/createGlobalContextShared.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalContextSyncErrMsg = void 0;
 exports.createGlobalContextShared = createGlobalContextShared;
+const getGlobalContextSyncErrMsg = "The global context isn't set yet, call getGlobalContextSync() later or use getGlobalContext() instead.";
+exports.getGlobalContextSyncErrMsg = getGlobalContextSyncErrMsg;
 const getPageConfigsRuntime_js_1 = require("./getPageConfigsRuntime.js");
 const executeHookGeneric_js_1 = require("./hooks/executeHookGeneric.js");
 const utils_js_1 = require("./utils.js");
@@ -33,6 +36,12 @@ async function createGlobalContextShared(virtualFileExports, globalObject, addGl
 function createGlobalContextBase(virtualFileExports) {
     const { pageFilesAll, allPageIds, pageConfigs, pageConfigGlobal, globalConfig, pageConfigsUserFriendly } = (0, getPageConfigsRuntime_js_1.getPageConfigsRuntime)(virtualFileExports);
     const globalContext = {
+        /**
+         * Useful for distinguishing `globalContext` from other objects and narrowing down TypeScript unions.
+         *
+         * https://vike.dev/globalContext#typescript
+         */
+        isGlobalContext: true,
         _virtualFileExports: virtualFileExports,
         _pageFilesAll: pageFilesAll,
         _pageConfigs: pageConfigs,

package/dist/cjs/shared/createPageContextShared.js

@@ -9,7 +9,7 @@ async function createPageContextShared(pageContextCreated, pageConfigGlobal) {
         pageConfigGlobalValues: pageConfigGlobal.configValues
     });
     (0, utils_js_1.objectAssign)(pageContextCreated, {
-        _isPageContextObject: true,
+        isPageContext: true,
         ...pageConfigGlobalUserFriendly
     }, true);
     await (0, executeHookGeneric_js_1.executeHookGenericGlobalCumulative)('onCreatePageContext', pageConfigGlobal, pageContextCreated, pageContextCreated);

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

@@ -10,7 +10,7 @@ const getConfigDefinedAt_js_1 = require("../page-configs/getConfigDefinedAt.js")
 const resolveRouteFunction_js_1 = require("./resolveRouteFunction.js");
 const getHook_js_1 = require("../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/cjs/utils/PROJECT_VERSION.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROJECT_VERSION = void 0;
 // Automatically updated by @brillout/release-me
-exports.PROJECT_VERSION = '0.4.228-commit-84954ae';
+exports.PROJECT_VERSION = '0.4.228-commit-1bb55f1';

package/dist/cjs/utils/objectAssign.js

@@ -9,6 +9,6 @@ function objectAssign(obj, objAddendum, objAddendumCanBePageContextObject) {
     if (!objAddendum)
         return;
     if (!objAddendumCanBePageContextObject)
-        (0, assert_js_1.assert)(!('_isPageContextObject' in objAddendum));
+        (0, assert_js_1.assert)(!('isPageContext' in objAddendum));
     Object.defineProperties(obj, Object.getOwnPropertyDescriptors(objAddendum));
 }