vike 0.4.144-commit-756f5d7 → 0.4.144-commit-f7ab002

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

@@ -0,0 +1,27 @@
+export { getPageConfig };
+export { getConfigValueFilePathToShowToUser };
+export { getHookFilePathToShowToUser };
+export { getConfigDefinedAtString, getDefinedAtString } from './helpers/getConfigDefinedAtString.js';
+export { getConfigValue } from './helpers/getConfigValue.js';
+import { assert } from '../utils.js';
+function getPageConfig(pageId, pageConfigs) {
+    const pageConfig = pageConfigs.find((p) => p.pageId === pageId);
+    assert(pageConfigs.length > 0);
+    assert(pageConfig);
+    return pageConfig;
+}
+function getConfigValueFilePathToShowToUser({ definedAt }) {
+    // A unique file path only exists if the config value isn't cumulative nor computed:
+    //  - cumulative config values have multiple file paths
+    //  - computed values don't have any file path
+    if ('isComputed' in definedAt || 'files' in definedAt)
+        return null;
+    const { filePathToShowToUser } = definedAt;
+    assert(filePathToShowToUser);
+    return filePathToShowToUser;
+}
+function getHookFilePathToShowToUser({ definedAt }) {
+    const filePathToShowToUser = getConfigValueFilePathToShowToUser({ definedAt });
+    assert(filePathToShowToUser);
+    return filePathToShowToUser;
+}

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

@@ -2,7 +2,7 @@ export { loadConfigValues };
 import { objectAssign } from '../utils.js';
 import { parseConfigValuesImported } from './serialize/parseConfigValuesImported.js';
 async function loadConfigValues(pageConfig, isDev) {
-    if ('isLoaded' in pageConfig &&
+    if ('isAllLoaded' in pageConfig &&
         // We don't need to cache in dev, since Vite already caches the virtual module
         !isDev) {
         return pageConfig;
@@ -10,6 +10,6 @@ async function loadConfigValues(pageConfig, isDev) {
     const configValuesImported = await pageConfig.loadConfigValuesAll();
     const configValuesAddendum = parseConfigValuesImported(configValuesImported);
     Object.assign(pageConfig.configValues, configValuesAddendum);
-    objectAssign(pageConfig, { isLoaded: true });
+    objectAssign(pageConfig, { isAllLoaded: true });
     return pageConfig;
 }

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

@@ -3,9 +3,9 @@ export type { PageConfigGlobalRuntimeSerialized };
 export type { ConfigValueSerialized };
 export type { ConfigValueImported };
 import type { DefinedAt, PageConfigRuntime } from '../PageConfig.js';
-/** page config data structure serialized in virtual files: parsing it results in PageConfigRuntime */
+/** Page config data structure serialized in virtual files: parsing it results in PageConfigRuntime */
 type PageConfigRuntimeSerialized = Omit<PageConfigRuntime, 'configValues'> & {
-    /** Config values that are loaded eagerly and serializable such as config.passToClient */
+    /** Config values that are serializable and loaded eagerly such as config.passToClient */
     configValuesSerialized: Record<string, ConfigValueSerialized>;
     /** Config values imported eagerly such as config.route */
     configValuesImported: ConfigValueImported[];
@@ -13,12 +13,12 @@ type PageConfigRuntimeSerialized = Omit<PageConfigRuntime, 'configValues'> & {
 type PageConfigGlobalRuntimeSerialized = {
     configValuesImported: ConfigValueImported[];
 };
-/** Value is serialized. */
+/** Value is serialized */
 type ConfigValueSerialized = {
     valueSerialized: string;
     definedAt: DefinedAt;
 };
-/** Value is imported. */
+/** Value is imported */
 type ConfigValueImported = {
     configName: string;
     importPath: string;

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

@@ -8,14 +8,12 @@ function parseConfigValuesImported(configValuesImported) {
         configValues[configName] = {
             value,
             definedAt: {
-                file: {
-                    // importPath cannot be relative to the current file, since the current file is a virtual file
-                    filePathToShowToUser: importPath,
-                    fileExportPath: [configName, 'default'].includes(exportName)
-                        ? []
-                        : // Side-effect config
-                            [exportName]
-                }
+                // importPath cannot be relative to the current file, since the current file is a virtual file
+                filePathToShowToUser: importPath,
+                fileExportPathToShowToUser: [configName, 'default'].includes(exportName)
+                    ? []
+                    : // Side-effect config
+                        [exportName]
             }
         };
         assertIsNotNull(value, configName, importPath);

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

@@ -2,7 +2,7 @@ export { parsePageConfigs };
 import { parse } from '@brillout/json-serializer/parse';
 import { parseConfigValuesImported } from './parseConfigValuesImported.js';
 import { assert, assertUsage, isCallable } from '../../utils.js';
-import { getConfigDefinedAtString } from '../utils.js';
+import { getConfigDefinedAtString } from '../helpers.js';
 function parsePageConfigs(pageConfigsSerialized, pageConfigGlobalSerialized) {
     const pageConfigs = pageConfigsSerialized.map((pageConfigSerialized) => {
         const configValues = {};
@@ -49,7 +49,7 @@ function assertRouteConfigValue(configValues) {
         return;
     const { value } = configValue;
     const configValueType = typeof value;
-    const configDefinedAt = getConfigDefinedAtString(configName, configValue, true);
+    const configDefinedAt = getConfigDefinedAtString('Config', configName, configValue);
     assertUsage(configValueType === 'string' || isCallable(value), `${configDefinedAt} has an invalid type '${configValueType}': it should be a string or a function instead, see https://vike.dev/route`);
     /* We don't use assertRouteString() in order to avoid unnecessarily bloating the client-side bundle when using Server Routing:
     * - When using Server Routing, this file is loaded => loading assertRouteString() would bloat the client bundle.

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

@@ -23,29 +23,28 @@ function serializeConfigValue(lines, configName, configValueSerialized) {
 function serializeConfigValueImported(configValueSource, configName, whitespace, varCounterContainer, importStatements) {
     assert(!configValueSource.valueIsFilePath);
     assert(whitespace.replaceAll(' ', '').length === 0);
-    const { valueIsImportedAtRuntime, definedAtInfo } = configValueSource;
+    const { valueIsImportedAtRuntime, definedAt } = configValueSource;
     assert(valueIsImportedAtRuntime);
-    const { filePathRelativeToUserRootDir, importPathAbsolute, exportName } = definedAtInfo;
-    const importPath = filePathRelativeToUserRootDir ?? importPathAbsolute;
-    assertPosixPath(importPath);
-    const fileName = path.posix.basename(importPath);
+    const { filePathAbsoluteVite, fileExportName } = definedAt;
+    assertPosixPath(filePathAbsoluteVite);
+    const fileName = path.posix.basename(filePathAbsoluteVite);
     const isValueFile = fileName.startsWith('+');
     if (isValueFile)
-        assert(exportName === undefined);
-    const { importName, importStatement } = generateEagerImport(importPath, varCounterContainer.varCounter++, exportName);
+        assert(fileExportName === undefined);
+    const { importName, importStatement } = generateEagerImport(filePathAbsoluteVite, varCounterContainer.varCounter++, fileExportName);
     importStatements.push(importStatement);
     const lines = [];
     lines.push(`  {`);
     lines.push(`    configName: '${configName}',`);
-    lines.push(`    importPath: '${importPath}',`);
+    lines.push(`    importPath: '${filePathAbsoluteVite}',`);
     lines.push(`    isValueFile: ${JSON.stringify(isValueFile)},`);
     if (isValueFile) {
         lines.push(`    exportValues: ${importName},`);
     }
     else {
         lines.push(`    exportValue: ${importName},`);
-        assert(exportName);
-        lines.push(`    exportName: ${JSON.stringify(exportName)},`);
+        assert(fileExportName);
+        lines.push(`    exportName: ${JSON.stringify(fileExportName)},`);
     }
     lines.push(`  },`);
     return lines;

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

@@ -41,7 +41,7 @@ function redirect(url, statusCode) {
 function render(value, abortReason) {
     const args = [typeof value === 'number' ? String(value) : JSON.stringify(value)];
     if (abortReason !== undefined)
-        args.push(truncateString(JSON.stringify(abortReason), 30, null));
+        args.push(truncateString(JSON.stringify(abortReason), 30));
     const abortCaller = 'throw render()';
     const abortCall = `throw render(${args.join(', ')})`;
     return render_(value, abortReason, abortCall, abortCaller);

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

@@ -3,10 +3,10 @@ import { isErrorPageId } from '../error-page.js';
 import { assert, assertUsage, hasProp, slice } from './utils.js';
 import { deduceRouteStringFromFilesystemPath } from './deduceRouteStringFromFilesystemPath.js';
 import { isCallable } from '../utils.js';
-import { getConfigValue, getDefinedAtString, getHookFilePathToShowToUser } from '../page-configs/utils.js';
+import { getConfigDefinedAtString, getConfigValue, getDefinedAtString, getHookFilePathToShowToUser } from '../page-configs/helpers.js';
 import { warnDeprecatedAllowKey } from './resolveRouteFunction.js';
 async function loadPageRoutes(
-// TODO: remove all arguments and use GlobalContext instead
+// Remove all arguments and use GlobalContext instead?
 pageFilesAll, pageConfigs, pageConfigGlobal, allPageIds) {
     await Promise.all(pageFilesAll.filter((p) => p.fileType === '.page.route').map((p) => p.loadFile?.()));
     const { onBeforeRouteHook, filesystemRoots } = getGlobalHooks(pageFilesAll, pageConfigs, pageConfigGlobal);
@@ -31,7 +31,7 @@ function getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds) {
                 const configValue = getConfigValue(pageConfig, configName);
                 if (configValue) {
                     const route = configValue.value;
-                    const definedAt = getDefinedAtString(configValue, configName);
+                    const definedAt = getDefinedAtString(configValue.definedAt, configName);
                     if (typeof route === 'string') {
                         pageRoute = {
                             pageId,
@@ -136,12 +136,13 @@ function getPageRoutes(filesystemRoots, pageFilesAll, pageConfigs, allPageIds) {
 function getGlobalHooks(pageFilesAll, pageConfigs, pageConfigGlobal) {
     // V1 Design
     if (pageConfigs.length > 0) {
-        if (pageConfigGlobal.configValues.onBeforeRoute?.value) {
-            const configValue = pageConfigGlobal.configValues.onBeforeRoute;
+        const hookName = 'onBeforeRoute';
+        if (pageConfigGlobal.configValues[hookName]?.value) {
+            const configValue = pageConfigGlobal.configValues[hookName];
             const { value: hookFn } = configValue;
             const hookFilePath = getHookFilePathToShowToUser(configValue);
-            // TODO: use getConfigDefinedAtString()
-            assertUsage(isCallable(hookFn), `The hook onBeforeRoute() defined by ${hookFilePath} should be a function.`);
+            const hookDefinedAt = getConfigDefinedAtString('Hook', hookName, configValue);
+            assertUsage(isCallable(hookFn), `${hookDefinedAt} should be a function.`);
             const onBeforeRouteHook = {
                 hookFilePath: hookFilePath,
                 onBeforeRoute: hookFn

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

@@ -5,7 +5,7 @@ type ProjectVersion = typeof projectInfo.projectVersion;
 type ProjectTag = `[${PackageName}]` | `[${PackageName}@${ProjectVersion}]`;
 declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.144-commit-756f5d7";
+    projectVersion: "0.4.144-commit-f7ab002";
     npmPackageName: "vike";
     githubRepository: "https://github.com/vikejs/vike";
 };

package/dist/esm/utils/projectInfo.js

@@ -1,6 +1,6 @@
 export { projectInfo };
 import { onProjectInfo } from './assertSingleInstance.js';
-const PROJECT_VERSION = '0.4.144-commit-756f5d7';
+const PROJECT_VERSION = '0.4.144-commit-f7ab002';
 const projectInfo = {
     projectName: 'Vike',
     projectVersion: PROJECT_VERSION,

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

@@ -1 +1,2 @@
-export declare function truncateString(str: string, lenMax: number, dim: null | ((ellipsis: string) => string)): string;
+export { truncateString };
+declare function truncateString(str: string, lenMax: number): string;

package/dist/esm/utils/truncateString.js

@@ -1,14 +1,17 @@
-export function truncateString(str, lenMax, dim) {
+export { truncateString };
+import pc from '@brillout/picocolors';
+import { assert } from './assert.js';
+function truncateString(str, lenMax) {
+    const lenMaxReal = lenMax - 3;
+    assert(lenMaxReal >= 1); // Show at least one character before the ellipsis
     if (str.length < lenMax) {
         return str;
     }
     else {
-        // May break ANSI codes
-        //  - So far, the str we pass to truncateString(str) are expected to not contain any ANSI code
-        str = str.substring(0, lenMax - 3);
-        let ellipsis = '...';
-        if (dim)
-            ellipsis = dim(ellipsis);
+        // Breaks ANSI codes.
+        //  - So far, the `str` we pass to truncateString(str) is always expected to not contain any ANSI code
+        str = str.substring(0, lenMaxReal);
+        const ellipsis = pc.dim('...');
         str = str + ellipsis;
         return str;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.144-commit-756f5d7",
+  "version": "0.4.144-commit-f7ab002",
   "scripts": {
     "dev": "tsc --watch",
     "build": "rimraf dist/ && pnpm run build:esm && pnpm run build:cjs",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@brillout/import": "0.2.3",
-    "@brillout/json-serializer": "^0.5.6",
+    "@brillout/json-serializer": "^0.5.8",
     "@brillout/picocolors": "^1.0.9",
     "@brillout/require-shim": "^0.1.2",
     "@brillout/vite-plugin-import-build": "^0.2.20",

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

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilePathToShowToUser = void 0;
-const utils_js_1 = require("../../../utils.js");
-/*
-const f: FilePath = 1 as any
-if (f.filePathRelativeToUserRootDir === null) {
-  f.importPathAbsolute
-}
-//*/
-function getFilePathToShowToUser(filePath) {
-    const filePathToShowToUser = filePath.filePathRelativeToUserRootDir ?? filePath.filePathAbsoluteFilesystem;
-    (0, utils_js_1.assert)(filePathToShowToUser);
-    return filePathToShowToUser;
-}
-exports.getFilePathToShowToUser = getFilePathToShowToUser;

package/dist/cjs/shared/page-configs/utils.js

@@ -1,103 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHookFilePathToShowToUser = exports.getConfigValueFilePathToShowToUser = exports.getDefinedAtString = exports.getConfigDefinedAtString = exports.getPageConfig = exports.getConfigValue = void 0;
-const utils_js_1 = require("../utils.js");
-const picocolors_1 = __importDefault(require("@brillout/picocolors"));
-const getExportPath_js_1 = require("./getExportPath.js");
-// prettier-ignore
-function getConfigValue(pageConfig, configName, type) {
-    const configValue = getConfigValueEntry(pageConfig, configName);
-    if (configValue === null)
-        return null;
-    const { value, definedAt } = configValue;
-    if (type)
-        assertConfigValueType(value, type, configName, definedAt);
-    return configValue;
-}
-exports.getConfigValue = getConfigValue;
-function assertConfigValueType(value, type, configName, definedAt) {
-    (0, utils_js_1.assert)(value !== null);
-    const typeActual = typeof value;
-    if (typeActual === type)
-        return;
-    const valuePrintable = (0, utils_js_1.getValuePrintable)(value);
-    const problem = valuePrintable !== null ? `value ${picocolors_1.default.cyan(valuePrintable)}` : `type ${picocolors_1.default.cyan(typeActual)}`;
-    const configDefinedAt = getConfigDefinedAtString(configName, { definedAt }, true);
-    (0, utils_js_1.assertUsage)(false, `${configDefinedAt} has an invalid ${problem}: it should be a ${picocolors_1.default.cyan(type)} instead`);
-}
-function getConfigValueEntry(pageConfig, configName) {
-    const configValue = pageConfig.configValues[configName];
-    if (!configValue)
-        return null;
-    // Enable users to suppress global config values by setting the local config value to null
-    if (configValue.value === null)
-        return null;
-    return configValue;
-}
-function getPageConfig(pageId, pageConfigs) {
-    const pageConfig = pageConfigs.find((p) => p.pageId === pageId);
-    (0, utils_js_1.assert)(pageConfigs.length > 0);
-    (0, utils_js_1.assert)(pageConfig);
-    return pageConfig;
-}
-exports.getPageConfig = getPageConfig;
-function getConfigDefinedAtString(configName, { definedAt }, sentenceBegin) {
-    const configDefinedAt = `${sentenceBegin ? `Config` : `config`} ${picocolors_1.default.cyan(configName)} defined ${getSourceString(definedAt, configName)}`;
-    return configDefinedAt;
-}
-exports.getConfigDefinedAtString = getConfigDefinedAtString;
-function getSourceString(definedAt, configName) {
-    if (definedAt.isComputed) {
-        return 'internally';
-    }
-    let files;
-    if (definedAt.isCumulative) {
-        files = definedAt.files;
-    }
-    else {
-        files = [definedAt.file];
-    }
-    (0, utils_js_1.assert)(files.length >= 1);
-    const sourceString = files
-        .map((source) => {
-        const { filePathToShowToUser, fileExportPath } = source;
-        let s = filePathToShowToUser;
-        const exportPath = (0, getExportPath_js_1.getExportPath)(fileExportPath, configName);
-        if (exportPath) {
-            s = `${s} > ${picocolors_1.default.cyan(exportPath)}`;
-        }
-        if (definedAt.isEffect) {
-            s = `${s} > (${picocolors_1.default.blue('effect')})`;
-        }
-        return s;
-    })
-        .join(' / ');
-    return `at ${sourceString}`;
-}
-function getDefinedAtString(configValue, configName) {
-    let sourceString = getSourceString(configValue.definedAt, configName);
-    if (sourceString.startsWith('at '))
-        sourceString = sourceString.slice('at '.length);
-    return sourceString;
-}
-exports.getDefinedAtString = getDefinedAtString;
-function getConfigValueFilePathToShowToUser({ definedAt }) {
-    // A unique file path only exists if the config value isn't cumulative nor computed:
-    //  - cumulative config values have multiple file paths
-    //  - computed values don't have any file path
-    if (definedAt.isComputed || definedAt.isCumulative)
-        return null;
-    const { filePathToShowToUser } = definedAt.file;
-    (0, utils_js_1.assert)(filePathToShowToUser);
-    return filePathToShowToUser;
-}
-exports.getConfigValueFilePathToShowToUser = getConfigValueFilePathToShowToUser;
-function getHookFilePathToShowToUser({ definedAt }) {
-    const filePathToShowToUser = getConfigValueFilePathToShowToUser({ definedAt });
-    (0, utils_js_1.assert)(filePathToShowToUser);
-    return filePathToShowToUser;
-}
-exports.getHookFilePathToShowToUser = getHookFilePathToShowToUser;

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getFilePathToShowToUser.d.ts

@@ -1,24 +0,0 @@
-export { getFilePathToShowToUser };
-export type { FilePath };
-type FilePath = {
-    /** The file's path relative to the filesystem root.
-     *
-     * Example: `/home/rom/code/my-app/pages/some-page/Page.js`
-     */
-    filePathAbsoluteFilesystem: string;
-} & ({
-    /** The file's path relative to the Vite's root (i.e. the user's project root directory).
-     *
-     * Example: `/pages/some-page/Page.js`
-     */
-    filePathRelativeToUserRootDir: string;
-    importPathAbsolute: null;
-} | {
-    filePathRelativeToUserRootDir: null;
-    /** The file's absolute import path.
-     *
-     * Example: `vike-react/config`
-     */
-    importPathAbsolute: string;
-});
-declare function getFilePathToShowToUser(filePath: FilePath): string;

package/dist/esm/node/plugin/plugins/importUserCode/v1-design/getFilePathToShowToUser.js

@@ -1,13 +0,0 @@
-export { getFilePathToShowToUser };
-import { assert } from '../../../utils.js';
-/*
-const f: FilePath = 1 as any
-if (f.filePathRelativeToUserRootDir === null) {
-  f.importPathAbsolute
-}
-//*/
-function getFilePathToShowToUser(filePath) {
-    const filePathToShowToUser = filePath.filePathRelativeToUserRootDir ?? filePath.filePathAbsoluteFilesystem;
-    assert(filePathToShowToUser);
-    return filePathToShowToUser;
-}

package/dist/esm/shared/page-configs/utils.d.ts

@@ -1,35 +0,0 @@
-export { getConfigValue };
-export { getPageConfig };
-export { getConfigDefinedAtString };
-export { getDefinedAtString };
-export { getConfigValueFilePathToShowToUser };
-export { getHookFilePathToShowToUser };
-import type { PageConfigRuntime, PageConfigBuildTime, ConfigValue, DefinedAt } from './PageConfig.js';
-import type { ConfigNameBuiltIn } from './Config.js';
-type PageConfigCommon = PageConfigRuntime | PageConfigBuildTime;
-type ConfigName = ConfigNameBuiltIn;
-declare function getConfigValue(pageConfig: PageConfigCommon, configName: ConfigName, type: 'string'): null | ConfigValue & {
-    value: string;
-};
-declare function getConfigValue(pageConfig: PageConfigCommon, configName: ConfigName, type: 'boolean'): null | ConfigValue & {
-    value: boolean;
-};
-declare function getConfigValue(pageConfig: PageConfigCommon, configName: ConfigName): null | ConfigValue & {
-    value: unknown;
-};
-declare function getPageConfig(pageId: string, pageConfigs: PageConfigRuntime[]): PageConfigRuntime;
-type ConfigDefinedAtUppercase<ConfigName extends string> = `Config ${ConfigName} defined ${'internally' | `at ${string}`}`;
-type ConfigDefinedAtLowercase<ConfigName extends string> = `config ${ConfigName} defined ${'internally' | `at ${string}`}`;
-declare function getConfigDefinedAtString<ConfigName extends string>(configName: ConfigName, { definedAt }: {
-    definedAt: DefinedAt;
-}, sentenceBegin: true, append?: 'effect'): ConfigDefinedAtUppercase<ConfigName>;
-declare function getConfigDefinedAtString<ConfigName extends string>(configName: ConfigName, { definedAt }: {
-    definedAt: DefinedAt;
-}, sentenceBegin: false, append?: 'effect'): ConfigDefinedAtLowercase<ConfigName>;
-declare function getDefinedAtString(configValue: ConfigValue, configName: string): string;
-declare function getConfigValueFilePathToShowToUser({ definedAt }: {
-    definedAt: DefinedAt;
-}): null | string;
-declare function getHookFilePathToShowToUser({ definedAt }: {
-    definedAt: DefinedAt;
-}): string;

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

@@ -1,97 +0,0 @@
-export { getConfigValue };
-export { getPageConfig };
-export { getConfigDefinedAtString };
-export { getDefinedAtString };
-export { getConfigValueFilePathToShowToUser };
-export { getHookFilePathToShowToUser };
-import { assert, assertUsage, getValuePrintable } from '../utils.js';
-import pc from '@brillout/picocolors';
-import { getExportPath } from './getExportPath.js';
-// prettier-ignore
-function getConfigValue(pageConfig, configName, type) {
-    const configValue = getConfigValueEntry(pageConfig, configName);
-    if (configValue === null)
-        return null;
-    const { value, definedAt } = configValue;
-    if (type)
-        assertConfigValueType(value, type, configName, definedAt);
-    return configValue;
-}
-function assertConfigValueType(value, type, configName, definedAt) {
-    assert(value !== null);
-    const typeActual = typeof value;
-    if (typeActual === type)
-        return;
-    const valuePrintable = getValuePrintable(value);
-    const problem = valuePrintable !== null ? `value ${pc.cyan(valuePrintable)}` : `type ${pc.cyan(typeActual)}`;
-    const configDefinedAt = getConfigDefinedAtString(configName, { definedAt }, true);
-    assertUsage(false, `${configDefinedAt} has an invalid ${problem}: it should be a ${pc.cyan(type)} instead`);
-}
-function getConfigValueEntry(pageConfig, configName) {
-    const configValue = pageConfig.configValues[configName];
-    if (!configValue)
-        return null;
-    // Enable users to suppress global config values by setting the local config value to null
-    if (configValue.value === null)
-        return null;
-    return configValue;
-}
-function getPageConfig(pageId, pageConfigs) {
-    const pageConfig = pageConfigs.find((p) => p.pageId === pageId);
-    assert(pageConfigs.length > 0);
-    assert(pageConfig);
-    return pageConfig;
-}
-function getConfigDefinedAtString(configName, { definedAt }, sentenceBegin) {
-    const configDefinedAt = `${sentenceBegin ? `Config` : `config`} ${pc.cyan(configName)} defined ${getSourceString(definedAt, configName)}`;
-    return configDefinedAt;
-}
-function getSourceString(definedAt, configName) {
-    if (definedAt.isComputed) {
-        return 'internally';
-    }
-    let files;
-    if (definedAt.isCumulative) {
-        files = definedAt.files;
-    }
-    else {
-        files = [definedAt.file];
-    }
-    assert(files.length >= 1);
-    const sourceString = files
-        .map((source) => {
-        const { filePathToShowToUser, fileExportPath } = source;
-        let s = filePathToShowToUser;
-        const exportPath = getExportPath(fileExportPath, configName);
-        if (exportPath) {
-            s = `${s} > ${pc.cyan(exportPath)}`;
-        }
-        if (definedAt.isEffect) {
-            s = `${s} > (${pc.blue('effect')})`;
-        }
-        return s;
-    })
-        .join(' / ');
-    return `at ${sourceString}`;
-}
-function getDefinedAtString(configValue, configName) {
-    let sourceString = getSourceString(configValue.definedAt, configName);
-    if (sourceString.startsWith('at '))
-        sourceString = sourceString.slice('at '.length);
-    return sourceString;
-}
-function getConfigValueFilePathToShowToUser({ definedAt }) {
-    // A unique file path only exists if the config value isn't cumulative nor computed:
-    //  - cumulative config values have multiple file paths
-    //  - computed values don't have any file path
-    if (definedAt.isComputed || definedAt.isCumulative)
-        return null;
-    const { filePathToShowToUser } = definedAt.file;
-    assert(filePathToShowToUser);
-    return filePathToShowToUser;
-}
-function getHookFilePathToShowToUser({ definedAt }) {
-    const filePathToShowToUser = getConfigValueFilePathToShowToUser({ definedAt });
-    assert(filePathToShowToUser);
-    return filePathToShowToUser;
-}