vike 0.4.151 → 0.4.152-commit-3d25618

package/dist/cjs/node/plugin/index.js

@@ -32,7 +32,7 @@ const assertFileEnv_js_1 = require("./plugins/assertFileEnv.js");
 // Return as `any` to avoid Plugin type mismatches when there are multiple Vite versions installed
 function plugin(vikeConfig) {
     const plugins = [
-        (0, index_js_3.resolveVikeConfig)(vikeConfig),
+        (0, index_js_3.resolveVikeConfig)(vikeConfig), // The configResolved() hook of resolveVikeConfig() should be the first called
         ...(0, commonConfig_js_1.commonConfig)(),
         (0, index_js_2.importUserCode)(),
         ...(0, index_js_1.devConfig)(),

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

@@ -19,11 +19,11 @@ function baseUrls(configVike) {
             process.env.BASE_ASSETS = baseAssets;
             return {
                 envPrefix: [
-                    'VITE_',
+                    'VITE_', // Vite doesn't seem to merge in its default, see https://github.com/vikejs/vike/issues/554
                     'BASE_SERVER',
                     'BASE_ASSETS'
                 ],
-                base: baseAssets,
+                base: baseAssets, // Make Vite inject baseAssets to imports e.g. `import logoUrl from './logo.svg.js'`
                 _baseOriginal: config.base ?? '/__UNSET__' // Vite resolves `_baseOriginal: null` to `undefined`
             };
         },

package/dist/cjs/node/plugin/plugins/importBuild/getVikeManifest.js

@@ -13,7 +13,7 @@ function getVikeManifest(config, configVike) {
     const runtimeManifest = (0, globalContext_js_1.getRuntimeManifest)(configVike);
     const manifest = {
         version: utils_js_1.projectInfo.projectVersion,
-        usesClientRouter: (0, extractExportNamesPlugin_js_1.isUsingClientRouter)(),
+        usesClientRouter: (0, extractExportNamesPlugin_js_1.isUsingClientRouter)(), // TODO/v1-release: remove
         manifestKeyMap: getManifestKeyMap(configVike, config),
         ...runtimeManifest
     };

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

@@ -86,6 +86,9 @@ const configDefinitionsBuiltIn = {
     },
     hooksTimeout: {
         env: { server: true, client: true }
+    },
+    cacheControl: {
+        env: { server: true }
     }
 };
 exports.configDefinitionsBuiltIn = configDefinitionsBuiltIn;

package/dist/cjs/node/plugin/shared/loggerVite.js

@@ -31,7 +31,7 @@ function intercept(logType, config) {
         if (options.error && store?.shouldErrorBeSwallowed(options.error)) {
             return;
         }
-        // Remove this once https://github.com/vitejs/vite/pull/13495 is released
+        // Remove this once https://github.com/vitejs/vite/pull/13495 is released and widely used
         if (msg.startsWith('Transform failed with ') && store && logType === 'error') {
             store.markErrorMessageAsLogged(msg);
             return;

package/dist/cjs/node/runtime/html/injectAssets/getHtmlTags.js

@@ -39,6 +39,8 @@ async function getHtmlTags(pageContext, injectToStream, injectFilter) {
                 return 'HTML_BEGIN';
             }
             if (asset.assetType === 'script') {
+                if (isHtmlOnly)
+                    return false;
                 return 'HTML_END';
             }
             return false;

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCacheControl = void 0;
+const helpers_js_1 = require("../../../../shared/page-configs/helpers.js");
+const defaultValue = 'no-store, max-age=0';
+function getCacheControl(pageId, pageConfigs) {
+    // TODO/v1-release: remove
+    if (pageConfigs.length === 0)
+        return defaultValue;
+    const pageConfig = (0, helpers_js_1.getPageConfig)(pageId, pageConfigs);
+    const configValue = (0, helpers_js_1.getConfigValue)(pageConfig, 'cacheControl', 'string');
+    const value = configValue?.value;
+    if (value)
+        return value;
+    // - Disabling caching by default is the safest strategy, because caching is problematic with authentication as described in https://github.com/vikejs/vike/issues/1275#issuecomment-1824366875
+    // - Are there use cases when we don't need to disable caching?
+    //   - When there isn't any <script id="vike_pageContext" type="application/json"> then we can safely have caching. (We don't implement this exception because we're lazy and it's quite a rare situation.)
+    return defaultValue;
+}
+exports.getCacheControl = getCacheControl;

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

@@ -5,6 +5,7 @@ const utils_js_1 = require("../utils.js");
 const error_page_js_1 = require("../../../shared/error-page.js");
 const getHttpResponseBody_js_1 = require("./getHttpResponseBody.js");
 const getEarlyHints_js_1 = require("./getEarlyHints.js");
+const getCacheControl_js_1 = require("./createHttpResponseObject/getCacheControl.js");
 const assertNoInfiniteHttpRedirect_js_1 = require("./createHttpResponseObject/assertNoInfiniteHttpRedirect.js");
 async function createHttpResponseObject(htmlRender, renderHook, pageContext) {
     if (htmlRender === null) {
@@ -26,7 +27,13 @@ async function createHttpResponseObject(htmlRender, renderHook, pageContext) {
         }
     }
     const earlyHints = (0, getEarlyHints_js_1.getEarlyHints)(await pageContext.__getPageAssets());
-    return getHttpResponse(statusCode, 'text/html;charset=utf-8', [], htmlRender, earlyHints, renderHook);
+    const headers = [];
+    (0, utils_js_1.assert)(pageContext._pageId);
+    const cacheControl = (0, getCacheControl_js_1.getCacheControl)(pageContext._pageId, pageContext._pageConfigs);
+    if (cacheControl) {
+        headers.push(['Cache-Control', cacheControl]);
+    }
+    return getHttpResponse(statusCode, 'text/html;charset=utf-8', headers, htmlRender, earlyHints, renderHook);
 }
 exports.createHttpResponseObject = createHttpResponseObject;
 async function createHttpResponsePageContextJson(pageContextSerialized) {

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

@@ -46,7 +46,8 @@ function collectCss(mod, styleUrls, visitedModules, importer) {
             //    - I believe some Vite plugins don't respect the \0 virtual module convention. What should we do then?
             //  - https://github.com/vikejs/vike/issues/1327
             //  - https://github.com/vikejs/vike/commit/3f7b9916dddc84e29e2c20d2b0df7211b6f1acbd
-            styleUrls.add(`/@id/${mod.url.substring(1)}`);
+            //  - https://github.com/vikejs/vike/issues/479#issuecomment-1870043943
+            styleUrls.add(`/@id/__x00__${mod.url.substring(1)}`);
         }
         else {
             // Is this useful? Maybe for virtual modules that don't respect the \0 virtual module convention?

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

@@ -108,7 +108,7 @@ async function prerender404Page(renderContext, pageContextInit_) {
         _debugRouteMatches: []
     };
     const pageContextInit = {
-        urlOriginal: '/fake-404-url',
+        urlOriginal: '/fake-404-url', // A URL is needed for `applyViteHtmlTransform`
         ...pageContextInit_
     };
     {

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

@@ -343,21 +343,33 @@ function getPermanentRedirect(pageContextInit, httpRequestId) {
     const { redirects, baseServer } = (0, globalContext_js_1.getGlobalContext)();
     const urlWithoutBase = (0, utils_js_1.removeBaseServer)(pageContextInit.urlOriginal, baseServer);
     let origin = null;
+    let urlTargetExternal = null;
     let urlTarget = (0, utils_js_1.modifyUrlPathname)(urlWithoutBase, (urlPathname) => {
-        const urlTargetWithOrigin = (0, resolveRedirects_js_1.resolveRedirects)(redirects, urlPathname);
-        if (urlTargetWithOrigin === null)
+        const urlTarget = (0, resolveRedirects_js_1.resolveRedirects)(redirects, urlPathname);
+        if (urlTarget === null)
             return null;
-        const { urlModified, origin: origin_ } = (0, utils_js_1.removeUrlOrigin)(urlTargetWithOrigin);
+        if (!(0, utils_js_1.isParsable)(urlTarget)) {
+            // E.g. `urlTarget === 'mailto:some@example.com'`
+            (0, utils_js_1.assert)((0, utils_js_1.isUriWithProtocol)(urlTarget) && !urlTarget.startsWith('http'));
+            urlTargetExternal = urlTarget;
+            return null;
+        }
+        const { urlModified, origin: origin_ } = (0, utils_js_1.removeUrlOrigin)(urlTarget);
         origin = origin_;
         return urlModified;
     });
-    if (origin)
-        urlTarget = (0, utils_js_1.addUrlOrigin)(urlTarget, origin);
-    if (urlTarget === urlWithoutBase)
-        return null;
+    if (urlTargetExternal) {
+        urlTarget = urlTargetExternal;
+    }
+    else {
+        if (origin)
+            urlTarget = (0, utils_js_1.addUrlOrigin)(urlTarget, origin);
+        if (urlTarget === urlWithoutBase)
+            return null;
+        urlTarget = (0, utils_js_1.prependBase)(urlTarget, baseServer);
+        (0, utils_js_1.assert)(urlTarget !== pageContextInit.urlOriginal);
+    }
     (0, loggerRuntime_js_1.logRuntimeInfo)?.(`Permanent redirect defined by your config.redirects (https://vike.dev/redirects)`, httpRequestId, 'info');
-    urlTarget = (0, utils_js_1.prependBase)(urlTarget, baseServer);
-    (0, utils_js_1.assert)(urlTarget !== pageContextInit.urlOriginal);
     const httpResponse = (0, createHttpResponseObject_js_1.createHttpResponseObjectRedirect)({ url: urlTarget, statusCode: 301 }, urlWithoutBase);
     const pageContextHttpResponse = { ...pageContextInit, httpResponse };
     return pageContextHttpResponse;

package/dist/cjs/shared/getPageFiles/getExports.js

@@ -24,7 +24,7 @@ function getExports(pageFiles, pageConfig) {
                 exportValue,
                 exportSource: `${pageFile.filePath} > ${isFromDefaultExport ? `\`export default { ${exportName} }\`` : `\`export { ${exportName} }\``}`,
                 filePath: pageFile.filePath,
-                _filePath: pageFile.filePath,
+                _filePath: pageFile.filePath, // TODO/next-major-release: remove
                 _fileType: pageFile.fileType,
                 _isFromDefaultExport: isFromDefaultExport
             });

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

@@ -27,7 +27,7 @@ function resolveRouteStringRedirect(urlSource, urlTarget, urlPathname) {
     (0, utils_js_1.assertUsage)(urlTarget.startsWith('/') ||
         // Is allowing any protocol a safety issue? https://github.com/vikejs/vike/pull/1292#issuecomment-1828043917
         (0, parseUrl_extras_js_1.isUriWithProtocol)(urlTarget) ||
-        urlTarget === '*', `${configSrc} Invalid redirection target URL ${picocolors_1.default.cyan(urlTarget)}: the target URL should start with ${picocolors_1.default.cyan('/')}, a valid protocol (${picocolors_1.default.cyan('https:')}, ${picocolors_1.default.cyan('http:')}, ${picocolors_1.default.cyan('ipfs:')}, ${picocolors_1.default.cyan('magnet:')}, ...), or be ${picocolors_1.default.cyan('*')}`);
+        urlTarget === '*', `${configSrc} Invalid redirection target URL ${picocolors_1.default.cyan(urlTarget)}: the target URL should start with ${picocolors_1.default.cyan('/')}, a valid protocol (${picocolors_1.default.cyan('https:')}, ${picocolors_1.default.cyan('http:')}, ${picocolors_1.default.cyan('mailto:')}, ${picocolors_1.default.cyan('ipfs:')}, ${picocolors_1.default.cyan('magnet:')}, ...), or be ${picocolors_1.default.cyan('*')}`);
     assertParams(urlSource, urlTarget);
     const match = (0, resolveRouteString_js_1.resolveRouteString)(urlSource, urlPathname);
     if (!match)

package/dist/cjs/utils/debug.js

@@ -10,24 +10,24 @@ const getTerminWidth_js_1 = require("./getTerminWidth.js");
 // Avoid this to be loaded in the browser. For isomorphic code: instead of `import { createDebugger } from './utils.js'`, use `globalThis.createDebugger()`.
 (0, assert_js_1.assert)(!(0, isBrowser_js_1.isBrowser)());
 globalThis.__brillout_debug_createDebugger = createDebugger;
-function createDebugger(namespace, optionsGlobal) {
-    (0, checkType_js_1.checkType)(namespace);
+function createDebugger(flag, optionsGlobal) {
+    (0, checkType_js_1.checkType)(flag);
     const debugWithOptions = (optionsLocal) => {
         return (...msgs) => {
             const options = { ...optionsGlobal, ...optionsLocal };
-            debug_(namespace, options, ...msgs);
+            debug_(flag, options, ...msgs);
         };
     };
     const debug = (...msgs) => debugWithOptions({})(...msgs);
-    (0, objectAssign_js_1.objectAssign)(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(namespace) });
+    (0, objectAssign_js_1.objectAssign)(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(flag) });
     return debug;
 }
 exports.createDebugger = createDebugger;
-function debug_(namespace, options, ...msgs) {
-    if (!isDebugEnabled(namespace))
+function debug_(flag, options, ...msgs) {
+    if (!isDebugEnabled(flag))
         return;
     let [msgFirst, ...msgsRest] = msgs;
-    const padding = ' '.repeat(namespace.length + 1);
+    const padding = ' '.repeat(flag.length + 1);
     msgFirst = formatMsg(msgFirst, options, padding, 'FIRST');
     msgsRest = msgsRest.map((msg, i) => {
         const position = i === msgsRest.length - 1 ? 'LAST' : 'MIDDLE';
@@ -44,13 +44,13 @@ function debug_(namespace, options, ...msgs) {
         logFirst = [msgFirst];
         logsRest = msgsRest;
     }
-    console.log('\x1b[1m%s\x1b[0m', namespace, ...logFirst);
+    console.log('\x1b[1m%s\x1b[0m', flag, ...logFirst);
     logsRest.forEach((msg) => {
         console.log(msg);
     });
 }
-function isDebugEnabled(namespace) {
-    (0, checkType_js_1.checkType)(namespace);
+function isDebugEnabled(flag) {
+    (0, checkType_js_1.checkType)(flag);
     let DEBUG;
     // - `process` can be undefined in edge workers
     // - We want bundlers to be able to statically replace `process.env.*`
@@ -58,7 +58,7 @@ function isDebugEnabled(namespace) {
         DEBUG = process.env.DEBUG;
     }
     catch { }
-    return DEBUG?.includes(namespace) ?? false;
+    return DEBUG?.includes(flag) ?? false;
 }
 exports.isDebugEnabled = isDebugEnabled;
 function formatMsg(info, options, padding, position) {

package/dist/cjs/utils/projectInfo.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROJECT_VERSION = exports.projectInfo = void 0;
 const assertSingleInstance_js_1 = require("./assertSingleInstance.js");
-const PROJECT_VERSION = '0.4.151';
+const PROJECT_VERSION = '0.4.152-commit-3d25618';
 exports.PROJECT_VERSION = PROJECT_VERSION;
 const projectInfo = {
     projectName: 'Vike',

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

@@ -28,7 +28,7 @@ markEnvAsVite();
 // Return as `any` to avoid Plugin type mismatches when there are multiple Vite versions installed
 function plugin(vikeConfig) {
     const plugins = [
-        resolveVikeConfig(vikeConfig),
+        resolveVikeConfig(vikeConfig), // The configResolved() hook of resolveVikeConfig() should be the first called
         ...commonConfig(),
         importUserCode(),
         ...devConfig(),

package/dist/esm/node/plugin/plugins/baseUrls.js

@@ -17,11 +17,11 @@ function baseUrls(configVike) {
             process.env.BASE_ASSETS = baseAssets;
             return {
                 envPrefix: [
-                    'VITE_',
+                    'VITE_', // Vite doesn't seem to merge in its default, see https://github.com/vikejs/vike/issues/554
                     'BASE_SERVER',
                     'BASE_ASSETS'
                 ],
-                base: baseAssets,
+                base: baseAssets, // Make Vite inject baseAssets to imports e.g. `import logoUrl from './logo.svg.js'`
                 _baseOriginal: config.base ?? '/__UNSET__' // Vite resolves `_baseOriginal: null` to `undefined`
             };
         },

package/dist/esm/node/plugin/plugins/importBuild/getVikeManifest.js

@@ -8,7 +8,7 @@ function getVikeManifest(config, configVike) {
     const runtimeManifest = getRuntimeManifest(configVike);
     const manifest = {
         version: projectInfo.projectVersion,
-        usesClientRouter: isUsingClientRouter(),
+        usesClientRouter: isUsingClientRouter(), // TODO/v1-release: remove
         manifestKeyMap: getManifestKeyMap(configVike, config),
         ...runtimeManifest
     };

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

@@ -85,6 +85,9 @@ const configDefinitionsBuiltIn = {
     },
     hooksTimeout: {
         env: { server: true, client: true }
+    },
+    cacheControl: {
+        env: { server: true }
     }
 };
 const configDefinitionsBuiltInGlobal = {

package/dist/esm/node/plugin/shared/loggerVite.js

@@ -28,7 +28,7 @@ function intercept(logType, config) {
         if (options.error && store?.shouldErrorBeSwallowed(options.error)) {
             return;
         }
-        // Remove this once https://github.com/vitejs/vite/pull/13495 is released
+        // Remove this once https://github.com/vitejs/vite/pull/13495 is released and widely used
         if (msg.startsWith('Transform failed with ') && store && logType === 'error') {
             store.markErrorMessageAsLogged(msg);
             return;

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

@@ -34,6 +34,8 @@ async function getHtmlTags(pageContext, injectToStream, injectFilter) {
                 return 'HTML_BEGIN';
             }
             if (asset.assetType === 'script') {
+                if (isHtmlOnly)
+                    return false;
                 return 'HTML_END';
             }
             return false;

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

@@ -0,0 +1,3 @@
+export { getCacheControl };
+import type { PageConfigRuntime } from '../../../../shared/page-configs/PageConfig.js';
+declare function getCacheControl(pageId: string, pageConfigs: PageConfigRuntime[]): string;

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

@@ -0,0 +1,17 @@
+export { getCacheControl };
+import { getConfigValue, getPageConfig } from '../../../../shared/page-configs/helpers.js';
+const defaultValue = 'no-store, max-age=0';
+function getCacheControl(pageId, pageConfigs) {
+    // TODO/v1-release: remove
+    if (pageConfigs.length === 0)
+        return defaultValue;
+    const pageConfig = getPageConfig(pageId, pageConfigs);
+    const configValue = getConfigValue(pageConfig, 'cacheControl', 'string');
+    const value = configValue?.value;
+    if (value)
+        return value;
+    // - Disabling caching by default is the safest strategy, because caching is problematic with authentication as described in https://github.com/vikejs/vike/issues/1275#issuecomment-1824366875
+    // - Are there use cases when we don't need to disable caching?
+    //   - When there isn't any <script id="vike_pageContext" type="application/json"> then we can safely have caching. (We don't implement this exception because we're lazy and it's quite a rare situation.)
+    return defaultValue;
+}

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

@@ -5,6 +5,7 @@ import { assert, assertWarning } from '../utils.js';
 import { isErrorPage } from '../../../shared/error-page.js';
 import { getHttpResponseBody, getHttpResponseBodyStreamHandlers } from './getHttpResponseBody.js';
 import { getEarlyHints } from './getEarlyHints.js';
+import { getCacheControl } from './createHttpResponseObject/getCacheControl.js';
 import { assertNoInfiniteHttpRedirect } from './createHttpResponseObject/assertNoInfiniteHttpRedirect.js';
 async function createHttpResponseObject(htmlRender, renderHook, pageContext) {
     if (htmlRender === null) {
@@ -26,7 +27,13 @@ async function createHttpResponseObject(htmlRender, renderHook, pageContext) {
         }
     }
     const earlyHints = getEarlyHints(await pageContext.__getPageAssets());
-    return getHttpResponse(statusCode, 'text/html;charset=utf-8', [], htmlRender, earlyHints, renderHook);
+    const headers = [];
+    assert(pageContext._pageId);
+    const cacheControl = getCacheControl(pageContext._pageId, pageContext._pageConfigs);
+    if (cacheControl) {
+        headers.push(['Cache-Control', cacheControl]);
+    }
+    return getHttpResponse(statusCode, 'text/html;charset=utf-8', headers, htmlRender, earlyHints, renderHook);
 }
 async function createHttpResponsePageContextJson(pageContextSerialized) {
     const httpResponse = getHttpResponse(200, 'application/json', [], pageContextSerialized, [], null);

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

@@ -43,7 +43,8 @@ function collectCss(mod, styleUrls, visitedModules, importer) {
             //    - I believe some Vite plugins don't respect the \0 virtual module convention. What should we do then?
             //  - https://github.com/vikejs/vike/issues/1327
             //  - https://github.com/vikejs/vike/commit/3f7b9916dddc84e29e2c20d2b0df7211b6f1acbd
-            styleUrls.add(`/@id/${mod.url.substring(1)}`);
+            //  - https://github.com/vikejs/vike/issues/479#issuecomment-1870043943
+            styleUrls.add(`/@id/__x00__${mod.url.substring(1)}`);
         }
         else {
             // Is this useful? Maybe for virtual modules that don't respect the \0 virtual module convention?

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

@@ -105,7 +105,7 @@ async function prerender404Page(renderContext, pageContextInit_) {
         _debugRouteMatches: []
     };
     const pageContextInit = {
-        urlOriginal: '/fake-404-url',
+        urlOriginal: '/fake-404-url', // A URL is needed for `applyViteHtmlTransform`
         ...pageContextInit_
     };
     {

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

@@ -2,7 +2,7 @@ export { renderPage };
 export { renderPage_addWrapper };
 import { getRenderContext, getPageContextInitEnhanced, renderPageAlreadyRouted } from './renderPage/renderPageAlreadyRouted.js';
 import { route } from '../../shared/route/index.js';
-import { assert, hasProp, objectAssign, isParsable, parseUrl, assertEnv, assertWarning, getGlobalObject, checkType, assertUsage, normalizeUrlPathname, removeBaseServer, modifyUrlPathname, prependBase, removeUrlOrigin, addUrlOrigin, createUrlFromComponents } from './utils.js';
+import { assert, hasProp, objectAssign, isParsable, parseUrl, assertEnv, assertWarning, getGlobalObject, checkType, assertUsage, normalizeUrlPathname, removeBaseServer, modifyUrlPathname, prependBase, removeUrlOrigin, addUrlOrigin, createUrlFromComponents, isUriWithProtocol } from './utils.js';
 import { assertNoInfiniteAbortLoop, getPageContextFromAllRewrites, isAbortError, logAbortErrorHandled } from '../../shared/route/abort.js';
 import { getGlobalContext, initGlobalContext } from './globalContext.js';
 import { handlePageContextRequestUrl } from './renderPage/handlePageContextRequestUrl.js';
@@ -337,21 +337,33 @@ function getPermanentRedirect(pageContextInit, httpRequestId) {
     const { redirects, baseServer } = getGlobalContext();
     const urlWithoutBase = removeBaseServer(pageContextInit.urlOriginal, baseServer);
     let origin = null;
+    let urlTargetExternal = null;
     let urlTarget = modifyUrlPathname(urlWithoutBase, (urlPathname) => {
-        const urlTargetWithOrigin = resolveRedirects(redirects, urlPathname);
-        if (urlTargetWithOrigin === null)
+        const urlTarget = resolveRedirects(redirects, urlPathname);
+        if (urlTarget === null)
             return null;
-        const { urlModified, origin: origin_ } = removeUrlOrigin(urlTargetWithOrigin);
+        if (!isParsable(urlTarget)) {
+            // E.g. `urlTarget === 'mailto:some@example.com'`
+            assert(isUriWithProtocol(urlTarget) && !urlTarget.startsWith('http'));
+            urlTargetExternal = urlTarget;
+            return null;
+        }
+        const { urlModified, origin: origin_ } = removeUrlOrigin(urlTarget);
         origin = origin_;
         return urlModified;
     });
-    if (origin)
-        urlTarget = addUrlOrigin(urlTarget, origin);
-    if (urlTarget === urlWithoutBase)
-        return null;
+    if (urlTargetExternal) {
+        urlTarget = urlTargetExternal;
+    }
+    else {
+        if (origin)
+            urlTarget = addUrlOrigin(urlTarget, origin);
+        if (urlTarget === urlWithoutBase)
+            return null;
+        urlTarget = prependBase(urlTarget, baseServer);
+        assert(urlTarget !== pageContextInit.urlOriginal);
+    }
     logRuntimeInfo?.(`Permanent redirect defined by your config.redirects (https://vike.dev/redirects)`, httpRequestId, 'info');
-    urlTarget = prependBase(urlTarget, baseServer);
-    assert(urlTarget !== pageContextInit.urlOriginal);
     const httpResponse = createHttpResponseObjectRedirect({ url: urlTarget, statusCode: 301 }, urlWithoutBase);
     const pageContextHttpResponse = { ...pageContextInit, httpResponse };
     return pageContextHttpResponse;

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

@@ -28,6 +28,7 @@ declare global {
      *  - `vike-vue`
      *  - `vike-solid`
      *  - `vike-svelte`
+     *  - `vike-angular`
      *
      *  As a Vike user, you can ignore this.
      */
@@ -40,5 +41,7 @@ declare global {
         }
         interface ConfigVikeSvelte {
         }
+        interface ConfigVikeAngular {
+        }
     }
 }

package/dist/esm/shared/getPageFiles/getExports.js

@@ -20,7 +20,7 @@ function getExports(pageFiles, pageConfig) {
                 exportValue,
                 exportSource: `${pageFile.filePath} > ${isFromDefaultExport ? `\`export default { ${exportName} }\`` : `\`export { ${exportName} }\``}`,
                 filePath: pageFile.filePath,
-                _filePath: pageFile.filePath,
+                _filePath: pageFile.filePath, // TODO/next-major-release: remove
                 _fileType: pageFile.fileType,
                 _isFromDefaultExport: isFromDefaultExport
             });

package/dist/esm/shared/page-configs/Config/PageContextConfig.d.ts

@@ -1,8 +1,8 @@
 export type { PageContextConfig };
 import type { VikePackages } from '../../VikeNamespace.js';
 import type { ConfigBuiltIn } from '../Config.js';
-import type { Combine, IsNotEmpty, XOR4 } from './helpers.ts';
+import type { Combine, IsNotEmpty, XOR5 } from './helpers.ts';
 type PageContextConfig = ConfigBuiltIn & (ConfigVikePackagesNotEmptyXor extends true ? ConfigVikePackagesIntersection : ConfigVikePackagesCombined);
-type ConfigVikePackagesIntersection = VikePackages.ConfigVikeReact & VikePackages.ConfigVikeVue & VikePackages.ConfigVikeSolid & VikePackages.ConfigVikeSvelte;
-type ConfigVikePackagesCombined = Combine<VikePackages.ConfigVikeReact, Combine<VikePackages.ConfigVikeVue, Combine<VikePackages.ConfigVikeSolid, VikePackages.ConfigVikeSvelte>>>;
-type ConfigVikePackagesNotEmptyXor = XOR4<IsNotEmpty<VikePackages.ConfigVikeReact>, IsNotEmpty<VikePackages.ConfigVikeVue>, IsNotEmpty<VikePackages.ConfigVikeSolid>, IsNotEmpty<VikePackages.ConfigVikeSvelte>>;
+type ConfigVikePackagesIntersection = VikePackages.ConfigVikeReact & VikePackages.ConfigVikeVue & VikePackages.ConfigVikeSolid & VikePackages.ConfigVikeSvelte & VikePackages.ConfigVikeAngular;
+type ConfigVikePackagesCombined = Combine<VikePackages.ConfigVikeReact, Combine<VikePackages.ConfigVikeVue, Combine<VikePackages.ConfigVikeSolid, Combine<VikePackages.ConfigVikeSvelte, VikePackages.ConfigVikeAngular>>>>;
+type ConfigVikePackagesNotEmptyXor = XOR5<IsNotEmpty<VikePackages.ConfigVikeReact>, IsNotEmpty<VikePackages.ConfigVikeVue>, IsNotEmpty<VikePackages.ConfigVikeSolid>, IsNotEmpty<VikePackages.ConfigVikeSvelte>, IsNotEmpty<VikePackages.ConfigVikeAngular>>;

package/dist/esm/shared/page-configs/Config/helpers.d.ts

@@ -1,10 +1,10 @@
 export type { IsNotEmpty };
-export type { XOR4 };
+export type { XOR5 };
 export type { Combine };
 type IsNotEmpty<T> = Not<IsEmpty<T>>;
 type IsEmpty<T> = keyof T extends never ? true : false;
 type Combine<T1, T2> = {
     [K in keyof T1 | keyof T2]?: (K extends keyof T1 ? T1[K] : never) | (K extends keyof T2 ? T2[K] : never);
 };
-type XOR4<T1 extends boolean, T2 extends boolean, T3 extends boolean, T4 extends boolean> = (T1 extends true ? T2 extends true ? false : T3 extends true ? false : Not<T4> : T2 extends true ? T3 extends true ? false : Not<T4> : T3 extends true ? Not<T4> : T4);
+type XOR5<T1 extends boolean, T2 extends boolean, T3 extends boolean, T4 extends boolean, T5 extends boolean> = (T1 extends true ? T2 extends true ? false : T3 extends true ? false : T4 extends true ? false : Not<T5> : T2 extends true ? T3 extends true ? false : T4 extends true ? false : Not<T5> : T3 extends true ? T4 extends true ? false : Not<T5> : T4 extends true ? Not<T5> : T5);
 type Not<T extends boolean> = T extends true ? false : true;

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

@@ -41,7 +41,7 @@ type HookNamePage = 'onHydrationEnd' | 'onBeforePrerenderStart' | 'onBeforeRende
 type HookNameGlobal = 'onBeforePrerender' | 'onBeforeRoute' | 'onPrerenderStart';
 type HookNameOldDesign = 'render' | 'prerender';
 type ConfigNameBuiltIn = Exclude<keyof Config, keyof ConfigVikeUserProvided | 'onBeforeRoute' | 'onPrerenderStart'> | 'prerender' | 'isClientSideRenderable' | 'onBeforeRenderEnv' | 'dataEnv' | 'hooksTimeout';
-type Config = ConfigBuiltIn & Vike.Config & (VikePackages.ConfigVikeReact | VikePackages.ConfigVikeVue | VikePackages.ConfigVikeSolid | VikePackages.ConfigVikeSvelte);
+type Config = ConfigBuiltIn & Vike.Config & (VikePackages.ConfigVikeReact | VikePackages.ConfigVikeVue | VikePackages.ConfigVikeSolid | VikePackages.ConfigVikeSvelte | VikePackages.ConfigVikeAngular);
 /** Hook for fetching data.
  *
  *  https://vike.dev/data
@@ -66,17 +66,21 @@ type GuardSync = (pageContext: PageContextServer) => void;
  *
  * https://vike.dev/onBeforePrerenderStart
  */
-type OnBeforePrerenderStartAsync = () => Promise<(string | {
+type OnBeforePrerenderStartAsync<Data = unknown> = () => Promise<(string | {
     url: string;
-    pageContext: Partial<Vike.PageContext>;
+    pageContext: Partial<Vike.PageContext & {
+        data: Data;
+    }>;
 })[]>;
 /** Global Hook called before the whole pre-rendering process starts.
  *
  * https://vike.dev/onBeforePrerenderStart
  */
-type OnBeforePrerenderStartSync = () => (string | {
+type OnBeforePrerenderStartSync<Data = unknown> = () => (string | {
     url: string;
-    pageContext: Partial<Vike.PageContext>;
+    pageContext: Partial<Vike.PageContext & {
+        data: Data;
+    }>;
 })[];
 /** Hook called before the page is rendered.
  *
@@ -213,10 +217,6 @@ type RouteSync = (pageContext: PageContextServer | PageContextClient) => {
     routeParams?: Record<string, string>;
     precedence?: number;
 } | boolean;
-/** The page's URL(s).
- *
- *  https://vike.dev/route
- */
 /** Page configuration.
  *
  * https://vike.dev/config
@@ -336,8 +336,17 @@ type ConfigBuiltIn = {
      * https://vike.dev/prefetchStaticAssets
      */
     prefetchStaticAssets?: PrefetchStaticAssets | ImportString;
-    /** Modify the tiemouts of hooks. */
+    /** Modify the timeouts of hooks. */
     hooksTimeout?: HooksTimeoutProvidedByUser;
+    /** `Cache-Control` HTTP header value.
+     *
+     * Default: `no-store, max-age=0`
+     *
+     * Set to an empty string to not send the header.
+     *
+     * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
+     */
+    cacheControl?: string;
 };
 type ConfigMeta = Record<string, ConfigDefinition>;
 type ImportString = `import:${string}`;

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

@@ -23,7 +23,7 @@ function resolveRouteStringRedirect(urlSource, urlTarget, urlPathname) {
     assertUsage(urlTarget.startsWith('/') ||
         // Is allowing any protocol a safety issue? https://github.com/vikejs/vike/pull/1292#issuecomment-1828043917
         isUriWithProtocol(urlTarget) ||
-        urlTarget === '*', `${configSrc} Invalid redirection target URL ${pc.cyan(urlTarget)}: the target URL should start with ${pc.cyan('/')}, a valid protocol (${pc.cyan('https:')}, ${pc.cyan('http:')}, ${pc.cyan('ipfs:')}, ${pc.cyan('magnet:')}, ...), or be ${pc.cyan('*')}`);
+        urlTarget === '*', `${configSrc} Invalid redirection target URL ${pc.cyan(urlTarget)}: the target URL should start with ${pc.cyan('/')}, a valid protocol (${pc.cyan('https:')}, ${pc.cyan('http:')}, ${pc.cyan('mailto:')}, ${pc.cyan('ipfs:')}, ${pc.cyan('magnet:')}, ...), or be ${pc.cyan('*')}`);
     assertParams(urlSource, urlTarget);
     const match = resolveRouteString(urlSource, urlPathname);
     if (!match)

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

@@ -1,15 +1,15 @@
 export { createDebugger };
 export { isDebugEnabled };
 export type { Debug };
-type Namespace = 'vike:error' | 'vike:extractAssets' | 'vike:extractExportNames' | 'vike:glob' | 'vike:pageFiles' | 'vike:log' | 'vike:routing' | 'vike:virtual-files' | 'vike:stem' | 'vike:stream' | 'vike:outDir';
+type Flag = 'vike:routing' | 'vike:error' | 'vike:stream' | 'vike:log' | 'vike:virtual-files' | 'vike:outDir' | 'vike:extractExportNames' | 'vike:extractAssets' | 'vike:glob' | 'vike:pageFiles' | 'vike:stem';
 type Debug = ReturnType<typeof createDebugger>;
 type Options = {
     serialization?: {
         emptyArray?: string;
     };
 };
-declare function createDebugger(namespace: Namespace, optionsGlobal?: Options): ((...msgs: unknown[]) => void) & {
+declare function createDebugger(flag: Flag, optionsGlobal?: Options): ((...msgs: unknown[]) => void) & {
     options: (optionsLocal: Options) => (...msgs: unknown[]) => void;
     isEnabled: boolean;
 };
-declare function isDebugEnabled(namespace: Namespace): boolean;
+declare function isDebugEnabled(flag: Flag): boolean;

package/dist/esm/utils/debug.js

@@ -9,23 +9,23 @@ import { getTerminalWidth } from './getTerminWidth.js';
 // Avoid this to be loaded in the browser. For isomorphic code: instead of `import { createDebugger } from './utils.js'`, use `globalThis.createDebugger()`.
 assert(!isBrowser());
 globalThis.__brillout_debug_createDebugger = createDebugger;
-function createDebugger(namespace, optionsGlobal) {
-    checkType(namespace);
+function createDebugger(flag, optionsGlobal) {
+    checkType(flag);
     const debugWithOptions = (optionsLocal) => {
         return (...msgs) => {
             const options = { ...optionsGlobal, ...optionsLocal };
-            debug_(namespace, options, ...msgs);
+            debug_(flag, options, ...msgs);
         };
     };
     const debug = (...msgs) => debugWithOptions({})(...msgs);
-    objectAssign(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(namespace) });
+    objectAssign(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(flag) });
     return debug;
 }
-function debug_(namespace, options, ...msgs) {
-    if (!isDebugEnabled(namespace))
+function debug_(flag, options, ...msgs) {
+    if (!isDebugEnabled(flag))
         return;
     let [msgFirst, ...msgsRest] = msgs;
-    const padding = ' '.repeat(namespace.length + 1);
+    const padding = ' '.repeat(flag.length + 1);
     msgFirst = formatMsg(msgFirst, options, padding, 'FIRST');
     msgsRest = msgsRest.map((msg, i) => {
         const position = i === msgsRest.length - 1 ? 'LAST' : 'MIDDLE';
@@ -42,13 +42,13 @@ function debug_(namespace, options, ...msgs) {
         logFirst = [msgFirst];
         logsRest = msgsRest;
     }
-    console.log('\x1b[1m%s\x1b[0m', namespace, ...logFirst);
+    console.log('\x1b[1m%s\x1b[0m', flag, ...logFirst);
     logsRest.forEach((msg) => {
         console.log(msg);
     });
 }
-function isDebugEnabled(namespace) {
-    checkType(namespace);
+function isDebugEnabled(flag) {
+    checkType(flag);
     let DEBUG;
     // - `process` can be undefined in edge workers
     // - We want bundlers to be able to statically replace `process.env.*`
@@ -56,7 +56,7 @@ function isDebugEnabled(namespace) {
         DEBUG = process.env.DEBUG;
     }
     catch { }
-    return DEBUG?.includes(namespace) ?? false;
+    return DEBUG?.includes(flag) ?? false;
 }
 function formatMsg(info, options, padding, position) {
     if (info === undefined) {

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

@@ -1,13 +1,13 @@
 export { projectInfo };
 export type { ProjectTag };
 export { PROJECT_VERSION };
-declare const PROJECT_VERSION: "0.4.151";
+declare const PROJECT_VERSION: "0.4.152-commit-3d25618";
 type PackageName = typeof projectInfo.npmPackageName;
 type ProjectVersion = typeof projectInfo.projectVersion;
 type ProjectTag = `[${PackageName}]` | `[${PackageName}@${ProjectVersion}]`;
 declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.151";
+    projectVersion: "0.4.152-commit-3d25618";
     npmPackageName: "vike";
     githubRepository: "https://github.com/vikejs/vike";
 };

package/dist/esm/utils/projectInfo.js

@@ -1,7 +1,7 @@
 export { projectInfo };
 export { PROJECT_VERSION };
 import { onProjectInfo } from './assertSingleInstance.js';
-const PROJECT_VERSION = '0.4.151';
+const PROJECT_VERSION = '0.4.152-commit-3d25618';
 const projectInfo = {
     projectName: 'Vike',
     projectVersion: PROJECT_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.151",
+  "version": "0.4.152-commit-3d25618",
   "scripts": {
     "dev": "tsc --watch",
     "build": "rimraf dist/ && pnpm run build:esm && pnpm run build:cjs",
@@ -12,18 +12,18 @@
     "release:commit": "release-me commit"
   },
   "dependencies": {
-    "@brillout/import": "0.2.3",
+    "@brillout/import": "^0.2.3",
     "@brillout/json-serializer": "^0.5.8",
     "@brillout/picocolors": "^1.0.10",
     "@brillout/require-shim": "^0.1.2",
     "@brillout/vite-plugin-import-build": "^0.3.1",
-    "acorn": "^8.8.2",
-    "cac": "^6.7.14",
-    "es-module-lexer": "^1.3.0",
-    "esbuild": "^0.17.18",
-    "fast-glob": "^3.2.12",
-    "sirv": "^2.0.2",
-    "source-map-support": "^0.5.21"
+    "acorn": "^8.0.0",
+    "cac": "^6.0.0",
+    "es-module-lexer": "^1.0.0",
+    "esbuild": "^0.19.0",
+    "fast-glob": "^3.0.0",
+    "sirv": "^2.0.0",
+    "source-map-support": "^0.5.0"
   },
   "type": "module",
   "exports": {
@@ -169,15 +169,27 @@
     "vike": "./node/cli/bin-entry.js"
   },
   "devDependencies": {
-    "@brillout/release-me": "^0.1.11",
-    "@types/estree": "^1.0.0",
-    "@types/jest": "^27.4.1",
-    "@types/node": "^20.1.0",
-    "@types/resolve": "^1.20.2",
-    "@types/source-map-support": "^0.5.6",
-    "rimraf": "^3.0.2",
-    "typescript": "^5.2.2",
-    "vite": "^4.2.1"
+    "@brillout/import": "^0.2.3",
+    "@brillout/json-serializer": "^0.5.8",
+    "@brillout/picocolors": "^1.0.10",
+    "@brillout/require-shim": "^0.1.2",
+    "@brillout/vite-plugin-import-build": "^0.3.1",
+    "acorn": "^8.11.2",
+    "cac": "^6.7.14",
+    "es-module-lexer": "^1.4.1",
+    "esbuild": "^0.19.10",
+    "fast-glob": "^3.3.2",
+    "sirv": "^2.0.4",
+    "source-map-support": "^0.5.21",
+    "@brillout/release-me": "^0.1.13",
+    "@types/estree": "^1.0.5",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.5",
+    "@types/resolve": "^1.20.6",
+    "@types/source-map-support": "^0.5.10",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.10"
   },
   "engines": {
     "node": ">=16.0.0"