vike 0.4.197-commit-9330153 → 0.4.197-commit-1251ed9

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

@@ -838,6 +838,9 @@ function assertNoUnexpectedPlusSign(filePath: string, fileName: string) {
 }
 */
 function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
+    const configNameColored = picocolors_1.default.cyan(configName);
+    let errMsg = `${filePathToShowToUser} sets an unknown config ${configNameColored}.`;
+    // vike-{react,vue,solid} hint
     {
         const ui = ['vike-react', 'vike-vue', 'vike-solid'];
         const knownVikeExntensionConfigs = {
@@ -854,14 +857,16 @@ function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
         if (configName in knownVikeExntensionConfigs) {
             const requiredVikeExtension = knownVikeExntensionConfigs[configName];
             (0, utils_js_1.assertUsage)(false, [
-                `${filePathToShowToUser} uses the config ${picocolors_1.default.cyan(configName)} (https://vike.dev/${configName})`,
-                `which requires the Vike extension ${requiredVikeExtension.map((e) => picocolors_1.default.bold(e)).join('/')}.`,
-                `Make sure to install the Vike extension,`,
-                `and make sure it applies to ${filePathToShowToUser} as explained at https://vike.dev/extends#inheritance.`
+                errMsg,
+                `If you want to use the configuration documented at https://vike.dev/${configName} then make sure to install the Vike extension ${requiredVikeExtension
+                    .map((e) => picocolors_1.default.bold(e))
+                    .join('/')}.`,
+                `Also make sure it applies to ${filePathToShowToUser} (see https://vike.dev/extends#inheritance).`,
+                `Alternatively, if you don't want to use the aforementioned Vike extension, define it yourself by using ${picocolors_1.default.cyan('meta')} (https://vike.dev/meta).`
             ].join(' '));
         }
     }
-    let errMsg = `${filePathToShowToUser} sets an unknown config ${picocolors_1.default.cyan(configName)}`;
+    // Similarity hint
     let configNameSimilar = null;
     if (configName === 'page') {
         configNameSimilar = 'Page';
@@ -871,11 +876,15 @@ function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
     }
     if (configNameSimilar) {
         (0, utils_js_1.assert)(configNameSimilar !== configName);
-        errMsg += `, did you mean to set ${picocolors_1.default.cyan(configNameSimilar)} instead?`;
+        errMsg += ` Did you mean to set ${picocolors_1.default.cyan(configNameSimilar)} instead?`;
         if (configName === 'page') {
-            errMsg += ` (The name of the config ${picocolors_1.default.cyan('Page')} starts with a capital letter ${picocolors_1.default.cyan('P')} because it usually defines a UI component: a ubiquitous JavaScript convention is to start the name of UI components with a capital letter.)`;
+            errMsg += ` (The name of the config ${picocolors_1.default.cyan('Page')} starts with a capital letter ${picocolors_1.default.cyan('P')} because it defines a UI component: a ubiquitous JavaScript convention is that the name of UI components start with a capital letter.)`;
         }
     }
+    // `meta` hint
+    if (!configNameSimilar) {
+        errMsg += ` Make sure to define ${configNameColored} by using ${picocolors_1.default.cyan('meta')} (https://vike.dev/meta), and also make sure the meta configuration applies to ${filePathToShowToUser} (see https://vike.dev/config#inheritance).`;
+    }
     (0, utils_js_1.assertUsage)(false, errMsg);
 }
 function determineRouteFilesystem(locationId, configValueSources) {

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.197-commit-9330153';
+exports.PROJECT_VERSION = '0.4.197-commit-1251ed9';

package/dist/cjs/utils/parseUrl.js

@@ -7,12 +7,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseUrl = parseUrl;
-exports.assertUsageUrlPathname = assertUsageUrlPathname;
 exports.assertUsageUrlPathnameAbsolute = assertUsageUrlPathnameAbsolute;
 exports.assertUsageUrlRedirectTarget = assertUsageUrlRedirectTarget;
 exports.isUrl = isUrl;
 exports.isUri = isUri;
 exports.isUrlRedirectTarget = isUrlRedirectTarget;
+exports.isUrlPathnameRelative = isUrlPathnameRelative;
 exports.isUrlExternal = isUrlExternal;
 exports.isBaseServer = isBaseServer;
 exports.assertUrlComponents = assertUrlComponents;
@@ -297,16 +297,13 @@ function isUri(uri) {
     const { protocol } = parseProtocol(uri);
     return !!protocol && !isUrlProtocol(uri);
 }
-function assertUsageUrlPathname(url, errPrefix) {
-    assertUsageUrl(url, errPrefix, { allowRelative: true });
-}
 function assertUsageUrlPathnameAbsolute(url, errPrefix) {
     assertUsageUrl(url, errPrefix);
 }
 function assertUsageUrlRedirectTarget(url, errPrefix, isUnresolved) {
     assertUsageUrl(url, errPrefix, { isRedirectTarget: isUnresolved ? 'unresolved' : true });
 }
-function assertUsageUrl(url, errPrefix, { allowRelative, isRedirectTarget } = {}) {
+function assertUsageUrl(url, errPrefix, { isRedirectTarget } = {}) {
     if (url.startsWith('/'))
         return;
     let errMsg = `${errPrefix} is ${picocolors_1.default.string(url)} but it should start with ${picocolors_1.default.string('/')}`;
@@ -320,10 +317,5 @@ function assertUsageUrl(url, errPrefix, { allowRelative, isRedirectTarget } = {}
             errMsg += `, or be ${picocolors_1.default.string('*')}`;
         }
     }
-    if (allowRelative) {
-        if (isUrlPathnameRelative(url))
-            return;
-        errMsg += ', or be a relative URL';
-    }
     (0, assert_js_1.assertUsage)(false, errMsg);
 }

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

@@ -1,7 +1,8 @@
 export { navigate };
 export { reload };
+import { normalizeUrlArgument } from './normalizeUrlArgument.js';
 import { firstRenderStartPromise, renderPageClientSide } from './renderPageClientSide.js';
-import { assertClientRouting, assertUsageUrlPathname, getCurrentUrl } from './utils.js';
+import { assertClientRouting, getCurrentUrl } from './utils.js';
 assertClientRouting();
 /** Programmatically navigate to a new page.
  *
@@ -12,7 +13,7 @@ assertClientRouting();
  * @param overwriteLastHistoryEntry - Don't create a new entry in the browser's history, instead let the new URL replace the current URL. (This effectively removes the current URL from the browser history).
  */
 async function navigate(url, { keepScrollPosition = false, overwriteLastHistoryEntry = false } = {}) {
-    assertUsageUrlPathname(url, '[navigate(url)] url');
+    normalizeUrlArgument(url, 'navigate');
     // If `hydrationCanBeAborted === false` (e.g. Vue) then we can apply navigate() only after hydration is done
     await firstRenderStartPromise;
     const scrollTarget = { preserveScroll: keepScrollPosition };

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

@@ -0,0 +1,2 @@
+export { normalizeUrlArgument };
+declare function normalizeUrlArgument(url: string, fnName: 'prefetch' | 'navigate'): string;

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

@@ -0,0 +1,14 @@
+export { normalizeUrlArgument };
+import { assertUsage, isUrl, isUrlPathnameRelative } from './utils.js';
+function normalizeUrlArgument(url, fnName) {
+    // Succinct error message to save client-side KBs
+    const errMsg = `[${fnName}(url)] Invalid URL ${url}`;
+    assertUsage(isUrl(url), errMsg);
+    if (url.startsWith(location.origin)) {
+        url = url.slice(location.origin.length);
+    }
+    assertUsage(url.startsWith('/') || isUrlPathnameRelative(url), 
+    // `errMsg` used the original `url` value
+    errMsg);
+    return url;
+}

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

@@ -5,7 +5,7 @@ export { populatePageContextPrefetchCache };
 export { addLinkPrefetchHandlers };
 export { addLinkPrefetchHandlers_watch };
 export { addLinkPrefetchHandlers_unwatch };
-import { assert, assertClientRouting, assertUsage, assertUsageUrlPathname, assertWarning, checkIfClientRouting, getGlobalObject, hasProp, objectAssign } from './utils.js';
+import { assert, assertClientRouting, assertUsage, assertWarning, checkIfClientRouting, getGlobalObject, hasProp, objectAssign } from './utils.js';
 import { isErrorFetchingStaticAssets, loadUserFilesClientSide } from '../shared/loadUserFilesClientSide.js';
 import { skipLink } from './skipLink.js';
 import { disableClientRouting } from './renderPageClientSide.js';
@@ -17,6 +17,7 @@ import { getPageContextFromServerHooks } from './getPageContextFromHooks.js';
 import { getPageContextCurrent } from './getPageContextCurrent.js';
 import { PAGE_CONTEXT_MAX_AGE_DEFAULT, getPrefetchSettings } from './prefetch/getPrefetchSettings.js';
 import pc from '@brillout/picocolors';
+import { normalizeUrlArgument } from './normalizeUrlArgument.js';
 assertClientRouting();
 const globalObject = getGlobalObject('prefetch.ts', {
     linkPrefetchHandlerAdded: new WeakSet(),
@@ -96,11 +97,10 @@ async function prefetch(url, options) {
     assertUsage(checkIfClientRouting(), 'prefetch() only works with Client Routing, see https://vike.dev/prefetch', {
         showStackTrace: true
     });
-    const errPrefix = '[prefetch(url)] url';
-    assertUsageUrlPathname(url, errPrefix);
+    url = normalizeUrlArgument(url, 'prefetch');
     const pageContextLink = await getPageContextLink(url);
     if (!pageContextLink?.pageId) {
-        assertWarning(false, `${errPrefix} ${pc.string(url)} ${noRouteMatch}`, {
+        assertWarning(false, `[prefetch(url)] ${pc.string(url)} ${noRouteMatch}`, {
             showStackTrace: true,
             onlyOnce: false
         });
@@ -187,8 +187,10 @@ async function prefetchOnEvent(linkTag, event) {
         // TODO/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 };
     }
+    // Check again in case DOM was manipulated since last check
+    if (skipLink(linkTag))
+        return;
     const urlOfLink = linkTag.getAttribute('href');
-    assert(urlOfLink);
     const pageContextLink = await getPageContextLink(urlOfLink);
     if (!pageContextLink?.pageId)
         return;

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

@@ -832,6 +832,9 @@ function assertNoUnexpectedPlusSign(filePath: string, fileName: string) {
 }
 */
 function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
+    const configNameColored = pc.cyan(configName);
+    let errMsg = `${filePathToShowToUser} sets an unknown config ${configNameColored}.`;
+    // vike-{react,vue,solid} hint
     {
         const ui = ['vike-react', 'vike-vue', 'vike-solid'];
         const knownVikeExntensionConfigs = {
@@ -848,14 +851,16 @@ function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
         if (configName in knownVikeExntensionConfigs) {
             const requiredVikeExtension = knownVikeExntensionConfigs[configName];
             assertUsage(false, [
-                `${filePathToShowToUser} uses the config ${pc.cyan(configName)} (https://vike.dev/${configName})`,
-                `which requires the Vike extension ${requiredVikeExtension.map((e) => pc.bold(e)).join('/')}.`,
-                `Make sure to install the Vike extension,`,
-                `and make sure it applies to ${filePathToShowToUser} as explained at https://vike.dev/extends#inheritance.`
+                errMsg,
+                `If you want to use the configuration documented at https://vike.dev/${configName} then make sure to install the Vike extension ${requiredVikeExtension
+                    .map((e) => pc.bold(e))
+                    .join('/')}.`,
+                `Also make sure it applies to ${filePathToShowToUser} (see https://vike.dev/extends#inheritance).`,
+                `Alternatively, if you don't want to use the aforementioned Vike extension, define it yourself by using ${pc.cyan('meta')} (https://vike.dev/meta).`
             ].join(' '));
         }
     }
-    let errMsg = `${filePathToShowToUser} sets an unknown config ${pc.cyan(configName)}`;
+    // Similarity hint
     let configNameSimilar = null;
     if (configName === 'page') {
         configNameSimilar = 'Page';
@@ -865,11 +870,15 @@ function handleUnknownConfig(configName, configNames, filePathToShowToUser) {
     }
     if (configNameSimilar) {
         assert(configNameSimilar !== configName);
-        errMsg += `, did you mean to set ${pc.cyan(configNameSimilar)} instead?`;
+        errMsg += ` Did you mean to set ${pc.cyan(configNameSimilar)} instead?`;
         if (configName === 'page') {
-            errMsg += ` (The name of the config ${pc.cyan('Page')} starts with a capital letter ${pc.cyan('P')} because it usually defines a UI component: a ubiquitous JavaScript convention is to start the name of UI components with a capital letter.)`;
+            errMsg += ` (The name of the config ${pc.cyan('Page')} starts with a capital letter ${pc.cyan('P')} because it defines a UI component: a ubiquitous JavaScript convention is that the name of UI components start with a capital letter.)`;
         }
     }
+    // `meta` hint
+    if (!configNameSimilar) {
+        errMsg += ` Make sure to define ${configNameColored} by using ${pc.cyan('meta')} (https://vike.dev/meta), and also make sure the meta configuration applies to ${filePathToShowToUser} (see https://vike.dev/config#inheritance).`;
+    }
     assertUsage(false, errMsg);
 }
 function determineRouteFilesystem(locationId, configValueSources) {

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

@@ -1 +1 @@
-export declare const PROJECT_VERSION: "0.4.197-commit-9330153";
+export declare const PROJECT_VERSION: "0.4.197-commit-1251ed9";

package/dist/esm/utils/PROJECT_VERSION.js

@@ -1,2 +1,2 @@
 // Automatically updated by @brillout/release-me
-export const PROJECT_VERSION = '0.4.197-commit-9330153';
+export const PROJECT_VERSION = '0.4.197-commit-1251ed9';

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

@@ -1,10 +1,10 @@
 export { parseUrl };
-export { assertUsageUrlPathname };
 export { assertUsageUrlPathnameAbsolute };
 export { assertUsageUrlRedirectTarget };
 export { isUrl };
 export { isUri };
 export { isUrlRedirectTarget };
+export { isUrlPathnameRelative };
 export { isUrlExternal };
 export { isBaseServer };
 export { assertUrlComponents };
@@ -50,8 +50,8 @@ declare function assertUrlComponents(url: string, origin: string | null, pathnam
 declare function createUrlFromComponents(origin: string | null, pathname: string, search: string | null, hash: string | null): string;
 declare function isUrl(url: string): boolean;
 declare function isUrlRedirectTarget(url: string): boolean;
+declare function isUrlPathnameRelative(url: string): boolean;
 declare function isUrlExternal(url: string): boolean;
 declare function isUri(uri: string): boolean;
-declare function assertUsageUrlPathname(url: string, errPrefix: string): void;
 declare function assertUsageUrlPathnameAbsolute(url: string, errPrefix: string): void;
 declare function assertUsageUrlRedirectTarget(url: string, errPrefix: string, isUnresolved?: true): void;

package/dist/esm/utils/parseUrl.js

@@ -3,12 +3,12 @@
 //  - It doesn't support the tauri:// protocol
 // Unit tests at ./parseUrl.spec.ts
 export { parseUrl };
-export { assertUsageUrlPathname };
 export { assertUsageUrlPathnameAbsolute };
 export { assertUsageUrlRedirectTarget };
 export { isUrl };
 export { isUri };
 export { isUrlRedirectTarget };
+export { isUrlPathnameRelative };
 export { isUrlExternal };
 export { isBaseServer };
 export { assertUrlComponents };
@@ -293,16 +293,13 @@ function isUri(uri) {
     const { protocol } = parseProtocol(uri);
     return !!protocol && !isUrlProtocol(uri);
 }
-function assertUsageUrlPathname(url, errPrefix) {
-    assertUsageUrl(url, errPrefix, { allowRelative: true });
-}
 function assertUsageUrlPathnameAbsolute(url, errPrefix) {
     assertUsageUrl(url, errPrefix);
 }
 function assertUsageUrlRedirectTarget(url, errPrefix, isUnresolved) {
     assertUsageUrl(url, errPrefix, { isRedirectTarget: isUnresolved ? 'unresolved' : true });
 }
-function assertUsageUrl(url, errPrefix, { allowRelative, isRedirectTarget } = {}) {
+function assertUsageUrl(url, errPrefix, { isRedirectTarget } = {}) {
     if (url.startsWith('/'))
         return;
     let errMsg = `${errPrefix} is ${pc.string(url)} but it should start with ${pc.string('/')}`;
@@ -316,10 +313,5 @@ function assertUsageUrl(url, errPrefix, { allowRelative, isRedirectTarget } = {}
             errMsg += `, or be ${pc.string('*')}`;
         }
     }
-    if (allowRelative) {
-        if (isUrlPathnameRelative(url))
-            return;
-        errMsg += ', or be a relative URL';
-    }
     assertUsage(false, errMsg);
 }

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

@@ -1,4 +1,4 @@
 export declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.197-commit-9330153";
+    projectVersion: "0.4.197-commit-1251ed9";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.197-commit-9330153",
+  "version": "0.4.197-commit-1251ed9",
   "repository": "https://github.com/vikejs/vike",
   "exports": {
     "./server": {