vike 0.4.225-commit-2b7971f → 0.4.225-commit-6fc12fc

package/dist/cjs/shared/modifyUrlSameOrigin.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modifyUrlSameOrigin = modifyUrlSameOrigin;
+const utils_js_1 = require("./utils.js");
+function modifyUrlSameOrigin(url, modify) {
+    const urlParsed = (0, utils_js_1.parseUrl)(url, '/');
+    // Pathname
+    const pathname = modify.pathname ?? urlParsed.pathnameOriginal;
+    (0, utils_js_1.assertUsageUrlPathnameAbsolute)(pathname, 'modify.pathname');
+    // Search
+    let search = modify.search === null ? '' : !modify.search ? urlParsed.searchOriginal : resolveSearch(urlParsed, modify.search);
+    if (search === '?')
+        search = '';
+    // Hash
+    let hash;
+    if (modify.hash === null) {
+        hash = '';
+    }
+    else if (modify.hash === undefined) {
+        hash = urlParsed.hashOriginal ?? '';
+    }
+    else {
+        hash = modify.hash;
+        if (!hash.startsWith('#'))
+            hash = '#' + hash;
+    }
+    const urlModified = (0, utils_js_1.createUrlFromComponents)(urlParsed.origin, pathname, search, hash);
+    return urlModified;
+}
+function resolveSearch(urlParsed, search) {
+    let searchParams;
+    if (search instanceof URLSearchParams) {
+        // Overwrite
+        searchParams = search;
+    }
+    else {
+        // Merge
+        const searchMap = (0, utils_js_1.objectFilter)({ ...urlParsed.search, ...search }, (utils_js_1.isNotNullish_keyVal));
+        searchParams = new URLSearchParams(searchMap);
+    }
+    return '?' + searchParams.toString();
+}

package/dist/cjs/shared/utils.js

@@ -30,7 +30,7 @@ __exportStar(require("../utils/isBrowser.js"), exports);
 __exportStar(require("../utils/hasProp.js"), exports);
 __exportStar(require("../utils/isPlainObject.js"), exports);
 __exportStar(require("../utils/compareString.js"), exports);
-__exportStar(require("../utils/isNotNullish.js"), exports);
+__exportStar(require("../utils/isNullish.js"), exports);
 __exportStar(require("../utils/stringifyStringArray.js"), exports);
 __exportStar(require("../utils/cast.js"), exports);
 __exportStar(require("../utils/isPropertyGetter.js"), exports);
@@ -42,3 +42,4 @@ __exportStar(require("../utils/isArray.js"), exports);
 __exportStar(require("../utils/changeEnumerable.js"), exports);
 __exportStar(require("../utils/objectDefineProperty.js"), exports);
 __exportStar(require("../utils/isScriptFile.js"), exports);
+__exportStar(require("../utils/objectFilter.js"), exports);

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.225-commit-2b7971f';
+exports.PROJECT_VERSION = '0.4.225-commit-6fc12fc';

package/dist/cjs/utils/isNullish.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNullish = isNullish;
+exports.isNotNullish = isNotNullish;
+exports.isNotNullish_keyVal = isNotNullish_keyVal;
+function isNullish(val) {
+    return val === null || val === undefined;
+}
+// someArray.filter(isNotNullish)
+function isNotNullish(p) {
+    return !isNullish(p);
+}
+// objectFilter(obj).filter(isNotNullish_keyVal)
+function isNotNullish_keyVal(arg) {
+    return !isNullish(arg[1]);
+}

package/dist/cjs/utils/objectFilter.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectFilter = objectFilter;
+// Type inference for:
+// ```js
+// Object.fromEntries(Object.entries(obj).filter(someFilter))
+// ```
+function objectFilter(obj, filter) {
+    return Object.fromEntries(Object.entries(obj).filter(filter));
+}

package/dist/cjs/utils/pick.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pick = pick;
+function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}

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

@@ -1,5 +1,10 @@
 export { navigate };
 export { reload };
+type Options = {
+    keepScrollPosition?: boolean;
+    overwriteLastHistoryEntry?: boolean;
+    pageContext?: Record<string, unknown>;
+};
 /** Programmatically navigate to a new page.
  *
  * https://vike.dev/navigate
@@ -8,9 +13,5 @@ export { reload };
  * @param keepScrollPosition - Don't scroll to the top of the page, instead keep the current scroll position.
  * @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).
  */
-declare function navigate(url: string, { keepScrollPosition, overwriteLastHistoryEntry, pageContext }?: {
-    keepScrollPosition?: boolean;
-    overwriteLastHistoryEntry?: boolean;
-    pageContext?: Record<string, unknown>;
-}): Promise<void>;
+declare function navigate(url: string, options?: Options): Promise<void>;
 declare function reload(): Promise<void>;

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

@@ -1,5 +1,6 @@
 export { navigate };
 export { reload };
+// import { modifyUrlSameOrigin, ModifyUrlSameOriginOptions } from '../../shared/modifyUrlSameOrigin.js'
 import { getCurrentUrl } from '../shared/getCurrentUrl.js';
 import { normalizeUrlArgument } from './normalizeUrlArgument.js';
 import { firstRenderStartPromise, renderPageClientSide } from './renderPageClientSide.js';
@@ -13,11 +14,14 @@ assertClientRouting();
  * @param keepScrollPosition - Don't scroll to the top of the page, instead keep the current scroll position.
  * @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, pageContext } = {}) {
+async function navigate(url, options) {
+    // let url = normalizeUrlArgument(options.url ?? getCurrentUrl(), 'navigate')
+    // url = modifyUrlSameOrigin(url, options)
     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 };
+    const { keepScrollPosition, overwriteLastHistoryEntry, pageContext } = options ?? {};
+    const scrollTarget = { preserveScroll: keepScrollPosition ?? false };
     await renderPageClientSide({
         scrollTarget,
         urlOriginal: url,

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

@@ -2,7 +2,7 @@ export { normalizeUrlArgument };
 import { assertUsage, isUrl, isUrlRelative } from './utils.js';
 function normalizeUrlArgument(url, fnName) {
     // Succinct error message to save client-side KBs
-    const errMsg = `[${fnName}(url)] Invalid URL ${url}`;
+    const errMsg = `URL ${url} passed to ${fnName}() is invalid`;
     assertUsage(isUrl(url), errMsg);
     if (url.startsWith(location.origin)) {
         // Use normalizeClientSideUrl() instead?

package/dist/esm/node/api/build.js

@@ -11,13 +11,13 @@ import { assertVersion } from './utils.js';
  * https://vike.dev/api#build
  */
 async function build(options = {}) {
-    const { viteConfigEnhanced, vikeConfig } = await prepareViteApiCall(options, 'build');
+    const { viteConfigFromUserEnhanced, vikeConfig } = await prepareViteApiCall(options, 'build');
     // Pass it to pluginAutoFullBuild()
-    if (viteConfigEnhanced)
-        viteConfigEnhanced._viteConfigEnhanced = viteConfigEnhanced;
+    if (viteConfigFromUserEnhanced)
+        viteConfigFromUserEnhanced._viteConfigFromUserEnhanced = viteConfigFromUserEnhanced;
     if (vikeConfig.global.config.vite6BuilderApp) {
         assertVersion('Vite', version, '6.0.0');
-        const builder = await createBuilder(viteConfigEnhanced);
+        const builder = await createBuilder(viteConfigFromUserEnhanced);
         // See Vite plugin vike:build:pluginBuildApp
         await builder.buildApp();
     }
@@ -30,14 +30,14 @@ async function build(options = {}) {
         //    > See: https://github.com/vikejs/vike/blob/c6c7533a56b3a16fc43ed644fc5c10c02d0ff375/vike/node/plugin/plugins/autoFullBuild.ts#L98
         //    > We purposely don't start the pre-rendering in this `build()` function but in a Rollup hook instead.
         //    > Rationale: https://github.com/vikejs/vike/issues/2123
-        await buildVite(viteConfigEnhanced);
+        await buildVite(viteConfigFromUserEnhanced);
         // After pre-rendering, when using the Vike CLI, the process is forcefully exited at the end of the buildVite() call above.
         if (isVikeCli() && isPrerendering())
             assert(false);
     }
     return {
-    /* We don't return `viteConfig` because `viteConfigEnhanced` is `InlineConfig` not `ResolvedConfig`
-    viteConfig: viteConfigEnhanced,
+    /* We don't return `viteConfig` because `viteConfigFromUserEnhanced` is `InlineConfig` not `ResolvedConfig`
+    viteConfig: viteConfigFromUserEnhanced,
     */
     };
 }

package/dist/esm/node/api/dev.js

@@ -7,8 +7,8 @@ import { createServer } from 'vite';
  * https://vike.dev/api#dev
  */
 async function dev(options = {}) {
-    const { viteConfigEnhanced } = await prepareViteApiCall(options, 'dev');
-    const server = await createServer(viteConfigEnhanced);
+    const { viteConfigFromUserEnhanced } = await prepareViteApiCall(options, 'dev');
+    const server = await createServer(viteConfigFromUserEnhanced);
     return {
         viteServer: server,
         viteConfig: server.config

package/dist/esm/node/api/prepareViteApiCall.d.ts

@@ -7,7 +7,8 @@ import type { APIOptions, Operation } from './types.js';
 import { type VikeConfigObject } from '../plugin/plugins/importUserCode/v1-design/getVikeConfig.js';
 declare function prepareViteApiCall(options: APIOptions, operation: Operation): Promise<{
     vikeConfig: VikeConfigObject;
-    viteConfigEnhanced: InlineConfig | undefined;
+    viteConfigResolved: ResolvedConfig;
+    viteConfigFromUserEnhanced: InlineConfig | undefined;
 }>;
 declare function getViteRoot(operation: Operation): Promise<string>;
 declare function normalizeViteRoot(root: string): string;

package/dist/esm/node/api/prepareViteApiCall.js

@@ -4,9 +4,9 @@ export { assertViteRoot };
 export { normalizeViteRoot };
 import { loadConfigFromFile, mergeConfig, resolveConfig } from 'vite';
 import { clearContextApiOperation, setContextApiOperation } from './context.js';
-import { getVikeConfig2 } from '../plugin/plugins/importUserCode/v1-design/getVikeConfig.js';
+import { getVikeConfig2, getVikeConfigFromCliOrEnv } from '../plugin/plugins/importUserCode/v1-design/getVikeConfig.js';
 import path from 'path';
-import { assert, assertUsage, getGlobalObject, isObject, toPosixPath } from './utils.js';
+import { assert, assertUsage, getGlobalObject, isObject, pick, toPosixPath } from './utils.js';
 import pc from '@brillout/picocolors';
 import { clearGlobalContext } from '../runtime/globalContext.js';
 import { getEnvVarObject } from '../plugin/shared/getEnvVarObject.js';
@@ -14,34 +14,37 @@ const globalObject = getGlobalObject('api/prepareViteApiCall.ts', {});
 async function prepareViteApiCall(options, operation) {
     clear();
     setContextApiOperation(operation, options);
-    const viteConfigFromOptions = options.viteConfig;
-    return enhanceViteConfig(viteConfigFromOptions, operation);
+    const viteConfigFromUserApiOptions = options.viteConfig;
+    return resolveConfigs(viteConfigFromUserApiOptions, operation);
 }
 // For subsequent API calls, e.g. calling prerender() after build()
 function clear() {
     clearContextApiOperation();
     clearGlobalContext();
 }
-async function enhanceViteConfig(viteConfigFromOptions, operation) {
-    const viteInfo = await getViteInfo(viteConfigFromOptions, operation);
-    await assertViteRoot2(viteInfo.root, viteInfo.viteConfigEnhanced, operation);
+async function resolveConfigs(viteConfigFromUserApiOptions, operation) {
+    const viteInfo = await getViteInfo(viteConfigFromUserApiOptions, operation);
+    const { viteConfigResolved } = await assertViteRoot2(viteInfo.root, viteInfo.viteConfigFromUserEnhanced, operation);
     const vikeConfig = await getVikeConfig2(viteInfo.root, operation === 'dev', viteInfo.vikeVitePluginOptions);
-    const viteConfigEnhanced = addViteSettingsSetByVikeConfig(viteInfo.viteConfigEnhanced, vikeConfig);
+    const viteConfigFromUserEnhanced = applyVikeViteConfig(viteInfo.viteConfigFromUserEnhanced, vikeConfig);
     return {
         vikeConfig,
-        viteConfigEnhanced
+        viteConfigResolved, // ONLY USE if strictly necessary. (We plan to remove assertViteRoot2() as explained in the comments of that function.)
+        viteConfigFromUserEnhanced
     };
 }
-function addViteSettingsSetByVikeConfig(viteConfigEnhanced, vikeConfig) {
+// Apply +vite
+// - For example, Vike extensions adding Vite plugins
+function applyVikeViteConfig(viteConfigFromUserEnhanced, vikeConfig) {
     const viteConfigs = vikeConfig.global._from.configsCumulative.vite;
     if (!viteConfigs)
-        return viteConfigEnhanced;
+        return viteConfigFromUserEnhanced;
     viteConfigs.values.forEach((v) => {
         assertUsage(isObject(v.value), `${v.definedAt} should be an object`);
-        viteConfigEnhanced = mergeConfig(viteConfigEnhanced ?? {}, v.value);
+        viteConfigFromUserEnhanced = mergeConfig(viteConfigFromUserEnhanced ?? {}, v.value);
         assertUsage(!findVikeVitePlugin(v.value), "Using the +vite setting to add Vike's Vite plugin is forbidden");
     });
-    return viteConfigEnhanced;
+    return viteConfigFromUserEnhanced;
 }
 async function getViteRoot(operation) {
     if (!globalObject.root)
@@ -49,19 +52,30 @@ async function getViteRoot(operation) {
     assert(globalObject.root);
     return globalObject.root;
 }
-async function getViteInfo(viteConfigFromOptions, operation) {
-    let viteConfigEnhanced = viteConfigFromOptions;
+async function getViteInfo(viteConfigFromUserApiOptions, operation) {
+    let viteConfigFromUserEnhanced = viteConfigFromUserApiOptions;
     // Precedence:
-    //  - viteConfigFromUserEnvVar (highest precendence)
-    //  - viteConfigFromOptions
-    //  - viteConfigFromUserViteFile (lowest precendence)
+    //  1) viteConfigFromUserEnvVar (highest precendence)
+    //  2) viteConfigFromUserVikeConfig
+    //  2) viteConfigFromUserApiOptions
+    //  3) viteConfigFromUserViteFile (lowest precendence)
+    // Resolve Vike's +mode setting
+    {
+        const viteConfigFromUserVikeConfig = pick(getVikeConfigFromCliOrEnv().vikeConfigFromCliOrEnv, ['mode']);
+        if (Object.keys(viteConfigFromUserVikeConfig).length > 0) {
+            viteConfigFromUserEnhanced = mergeConfig(viteConfigFromUserEnhanced ?? {}, viteConfigFromUserVikeConfig);
+        }
+    }
+    // Resolve VITE_CONFIG
     const viteConfigFromUserEnvVar = getEnvVarObject('VITE_CONFIG');
-    if (viteConfigFromUserEnvVar)
-        viteConfigEnhanced = mergeConfig(viteConfigEnhanced ?? {}, viteConfigFromUserEnvVar);
-    const viteConfigFromUserViteFile = await loadViteConfigFile(viteConfigEnhanced, operation);
+    if (viteConfigFromUserEnvVar) {
+        viteConfigFromUserEnhanced = mergeConfig(viteConfigFromUserEnhanced ?? {}, viteConfigFromUserEnvVar);
+    }
+    // Resolve vite.config.js
+    const viteConfigFromUserViteFile = await loadViteConfigFile(viteConfigFromUserEnhanced, operation);
     // Correct precedence, replicates Vite:
     // https://github.com/vitejs/vite/blob/4f5845a3182fc950eb9cd76d7161698383113b18/packages/vite/src/node/config.ts#L1001
-    const viteConfigResolved = mergeConfig(viteConfigFromUserViteFile ?? {}, viteConfigEnhanced ?? {});
+    const viteConfigResolved = mergeConfig(viteConfigFromUserViteFile ?? {}, viteConfigFromUserEnhanced ?? {});
     const root = normalizeViteRoot(viteConfigResolved.root ?? process.cwd());
     globalObject.root = root;
     // - Find options `vike(options)` set in vite.config.js
@@ -76,16 +90,16 @@ async function getViteInfo(viteConfigFromOptions, operation) {
         // Add Vike to plugins if not present.
         // Using a dynamic import because the script calling the Vike API may not live in the same place as vite.config.js, thus vike/plugin may resolved to two different node_modules/vike directories.
         const { plugin: vikePlugin } = await import('../plugin/index.js');
-        viteConfigEnhanced = {
-            ...viteConfigEnhanced,
-            plugins: [...(viteConfigEnhanced?.plugins ?? []), vikePlugin()]
+        viteConfigFromUserEnhanced = {
+            ...viteConfigFromUserEnhanced,
+            plugins: [...(viteConfigFromUserEnhanced?.plugins ?? []), vikePlugin()]
         };
-        const res = findVikeVitePlugin(viteConfigEnhanced);
+        const res = findVikeVitePlugin(viteConfigFromUserEnhanced);
         assert(res);
         vikeVitePluginOptions = res.vikeVitePluginOptions;
     }
     assert(vikeVitePluginOptions);
-    return { root, vikeVitePluginOptions, viteConfigEnhanced };
+    return { root, vikeVitePluginOptions, viteConfigFromUserEnhanced };
 }
 function findVikeVitePlugin(viteConfig) {
     let vikeVitePluginOptions;
@@ -103,8 +117,8 @@ function findVikeVitePlugin(viteConfig) {
     return { vikeVitePluginOptions };
 }
 // Copied from https://github.com/vitejs/vite/blob/4f5845a3182fc950eb9cd76d7161698383113b18/packages/vite/src/node/config.ts#L961-L1005
-async function loadViteConfigFile(viteConfigFromOptions, operation) {
-    const [inlineConfig, command, defaultMode, _defaultNodeEnv, isPreview] = getResolveConfigArgs(viteConfigFromOptions, operation);
+async function loadViteConfigFile(viteConfigFromUserApiOptions, operation) {
+    const [inlineConfig, command, defaultMode, _defaultNodeEnv, isPreview] = getResolveConfigArgs(viteConfigFromUserApiOptions, operation);
     let config = inlineConfig;
     let mode = inlineConfig.mode || defaultMode;
     const configEnv = {
@@ -136,11 +150,12 @@ function normalizeViteRoot(root) {
     path.resolve(root));
 }
 const errMsg = `A Vite plugin is modifying Vite's setting ${pc.cyan('root')} which is forbidden`;
-async function assertViteRoot2(root, viteConfigEnhanced, operation) {
-    const args = getResolveConfigArgs(viteConfigEnhanced, operation);
-    // We can eventually this resolveConfig() call (along with removing the whole assertViteRoot2() function which is redundant with the assertViteRoot() function) so that Vike doesn't make any resolveConfig() (except for pre-rendering which is required). But let's keep it for now, just to see whether calling resolveConfig() can be problematic.
+async function assertViteRoot2(root, viteConfigFromUserEnhanced, operation) {
+    const args = getResolveConfigArgs(viteConfigFromUserEnhanced, operation);
+    // We can eventually remove this resolveConfig() call (along with removing the whole assertViteRoot2() function which is redundant with the assertViteRoot() function) so that Vike doesn't make any resolveConfig() (except for pre-rendering and preview which is required). But let's keep it for now, just to see whether calling resolveConfig() can be problematic.
     const viteConfigResolved = await resolveConfig(...args);
     assertUsage(normalizeViteRoot(viteConfigResolved.root) === normalizeViteRoot(root), errMsg);
+    return { viteConfigResolved };
 }
 function assertViteRoot(root, config) {
     if (globalObject.root)

package/dist/esm/node/api/prerender.js

@@ -1,15 +1,14 @@
 export { prerender };
 import { runPrerenderFromAPI } from '../prerender/runPrerender.js';
 import { prepareViteApiCall } from './prepareViteApiCall.js';
-// TODO/soon use importServerProductionIndex()
 /**
  * Programmatically trigger `$ vike prerender`
  *
  * https://vike.dev/api#prerender
  */
 async function prerender(options = {}) {
-    const { viteConfigEnhanced } = await prepareViteApiCall(options, 'prerender');
-    options.viteConfig = viteConfigEnhanced;
+    const { viteConfigFromUserEnhanced } = await prepareViteApiCall(options, 'prerender');
+    options.viteConfig = viteConfigFromUserEnhanced;
     const { viteConfig } = await runPrerenderFromAPI(options);
     return {
         viteConfig

package/dist/esm/node/api/preview.d.ts

@@ -7,6 +7,6 @@ import type { APIOptions } from './types.js';
  * https://vike.dev/api#preview
  */
 declare function preview(options?: APIOptions): Promise<{
-    viteServer: PreviewServer;
+    viteServer?: PreviewServer;
     viteConfig: ResolvedConfig;
 }>;

package/dist/esm/node/api/preview.js

@@ -1,16 +1,32 @@
 export { preview };
 import { prepareViteApiCall } from './prepareViteApiCall.js';
 import { preview as previewVite } from 'vite';
+import { importServerProductionIndex } from '@brillout/vite-plugin-server-entry/runtime';
+import { getOutDirs } from '../plugin/shared/getOutDirs.js';
+import { assertWarning } from './utils.js';
+import pc from '@brillout/picocolors';
+import path from 'node:path';
 /**
  * Programmatically trigger `$ vike preview`
  *
  * https://vike.dev/api#preview
  */
 async function preview(options = {}) {
-    const { viteConfigEnhanced } = await prepareViteApiCall(options, 'preview');
-    const server = await previewVite(viteConfigEnhanced);
-    return {
-        viteServer: server,
-        viteConfig: server.config
-    };
+    const { viteConfigFromUserEnhanced, viteConfigResolved } = await prepareViteApiCall(options, 'preview');
+    if (viteConfigResolved.vitePluginServerEntry?.inject) {
+        const outDir = getOutDirs(viteConfigResolved).outDirRoot;
+        const { outServerIndex } = await importServerProductionIndex({ outDir });
+        const outServerIndexRelative = path.relative(viteConfigResolved.root, outServerIndex);
+        assertWarning(false, `Never run ${pc.cyan('$ vike preview')} in production, run ${pc.cyan(`$ node ${outServerIndexRelative}`)} instead.`, { onlyOnce: true });
+        return {
+            viteConfig: viteConfigResolved
+        };
+    }
+    else {
+        const server = await previewVite(viteConfigFromUserEnhanced);
+        return {
+            viteServer: server,
+            viteConfig: server.config
+        };
+    }
 }

package/dist/esm/node/api/utils.d.ts

@@ -3,3 +3,4 @@ export * from '../../utils/getGlobalObject.js';
 export * from '../../utils/path.js';
 export * from '../../utils/isObject.js';
 export * from '../../utils/assertVersion.js';
+export * from '../../utils/pick.js';

package/dist/esm/node/api/utils.js

@@ -7,3 +7,4 @@ export * from '../../utils/getGlobalObject.js';
 export * from '../../utils/path.js';
 export * from '../../utils/isObject.js';
 export * from '../../utils/assertVersion.js';
+export * from '../../utils/pick.js';

package/dist/esm/node/cli/entry.js

@@ -57,8 +57,10 @@ async function cmdBuild() {
 async function cmdPreview() {
     try {
         const { viteServer } = await preview();
-        viteServer.printUrls();
-        viteServer.bindCLIShortcuts({ print: true });
+        if (viteServer) {
+            viteServer.printUrls();
+            viteServer.bindCLIShortcuts({ print: true });
+        }
     }
     catch (err) {
         console.error(pc.red(`Error while starting preview server:`));

package/dist/esm/node/cli/parseCli.js

@@ -6,7 +6,7 @@ const commands = [
     { name: 'dev', desc: 'Start development server' },
     { name: 'build', desc: 'Build for production' },
     { name: 'preview', desc: 'Start preview server using production build (only works for SSG apps)' },
-    { name: 'prerender', desc: 'Pre-render pages (only needed when partial.disableAutoRun is true)' }
+    { name: 'prerender', desc: 'Pre-render pages (only needed when prerender.disableAutoRun is true)' }
 ];
 function parseCli() {
     const command = getCommand();
@@ -57,10 +57,16 @@ function showHelp() {
         `vike@${PROJECT_VERSION}`,
         '',
         'Usage:',
-        ...[...commands, { name: '-v', desc: "Print Vike's installed version" }].map((c) => `  ${pc.dim('$')} ${pc.bold(`vike ${c.name}`)}${' '.repeat(nameMaxLength - c.name.length)}${TAB}${pc.dim(`# ${c.desc}`)}`),
+        ...[...commands, { name: '-v', desc: "Print Vike's installed version" }].map((c) => `  ${pc.dim('$')} vike ${c.name.startsWith('-') ? pc.cyan(`${c.name}`) : pc.bold(`${c.name}`)}${' '.repeat(nameMaxLength - c.name.length)}${TAB}${pc.dim(`# ${c.desc}`)}`),
         '',
-        `Vike settings can be passed over the ${pc.cyan('VIKE_CONFIG')} environment variable or as ${pc.cyan('CLI options')} such as --host.`,
-        `Vite settings can be passed over the ${pc.cyan('VITE_CONFIG')} environment variable.`,
+        'Common CLI options:',
+        [`vike dev ${pc.cyan('--host')}`, `vike dev ${pc.cyan('--port')} 80`, `vike build ${pc.cyan('--mode')} staging`]
+            .map((o) => `  ${pc.dim('$')} ${o}`)
+            .join('\n'),
+        '',
+        `More Vike settings can be passed over the ${pc.cyan('VIKE_CONFIG')} environment variable or as ${pc.cyan('CLI options')}.`,
+        `More Vite settings can be passed over the ${pc.cyan('VITE_CONFIG')} environment variable.`,
+        ``,
         `See ${pc.underline('https://vike.dev/cli')} for more information.`
     ].join('\n'));
     process.exit(1);

package/dist/esm/node/plugin/plugins/build/pluginAutoFullBuild.js

@@ -124,8 +124,8 @@ function isPrerenderForceExit() {
 }
 function getFullBuildInlineConfig(config) {
     const configFromCli = !isViteCliCall() ? null : getViteConfigFromCli();
-    if (config._viteConfigEnhanced) {
-        return config._viteConfigEnhanced;
+    if (config._viteConfigFromUserEnhanced) {
+        return config._viteConfigFromUserEnhanced;
     }
     else {
         return {

package/dist/esm/node/plugin/plugins/build/pluginModuleBanner.d.ts

@@ -0,0 +1,3 @@
+export { pluginModuleBanner };
+import type { Plugin } from 'vite';
+declare function pluginModuleBanner(): Plugin;

package/dist/esm/node/plugin/plugins/build/pluginModuleBanner.js

@@ -0,0 +1,49 @@
+export { pluginModuleBanner };
+import { assert } from '../../utils.js';
+import { removeVirtualIdTag } from '../../../shared/virtual-files.js';
+import { isViteServerBuild, isViteServerBuild_safe } from '../../shared/isViteServerBuild.js';
+// Rollup's banner feature doesn't work with Vite: https://github.com/vitejs/vite/issues/8412
+// But, anyways, we want to prepend the banner at the beginning of each module, not at the beginning of each file (I believe that's what Rollup's banner feature does).
+const vikeModuleBannerPlaceholder = 'vikeModuleBannerPlaceholder';
+function pluginModuleBanner() {
+    let config;
+    return {
+        name: 'vike:pluginModuleBanner',
+        enforce: 'post',
+        apply: 'build',
+        configResolved(config_) {
+            config = config_;
+        },
+        generateBundle: {
+            order: 'post',
+            handler(_options, bundle) {
+                for (const module of Object.values(bundle)) {
+                    if (module.type === 'chunk') {
+                        if (isViteServerBuild(config)) {
+                            const codeOld = module.code;
+                            const codeNew = codeOld.replace(/vikeModuleBannerPlaceholder\("([^"]*)"\);/g, '/* $1 [vike:pluginModuleBanner] */');
+                            assert(!codeNew.includes(vikeModuleBannerPlaceholder));
+                            module.code = codeNew;
+                        }
+                        else {
+                            assert(!module.code.includes(vikeModuleBannerPlaceholder));
+                        }
+                    }
+                }
+            }
+        },
+        transform: {
+            order: 'post',
+            handler(code, id, options) {
+                if (!isViteServerBuild_safe(config, options))
+                    return;
+                if (id.startsWith('\0'))
+                    id = id;
+                id = removeVirtualIdTag(id);
+                if (id.startsWith(config.root))
+                    id = id.slice(config.root.length + 1);
+                return `${vikeModuleBannerPlaceholder}(${JSON.stringify(id)}); ${code}`;
+            }
+        }
+    };
+}

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

@@ -6,6 +6,7 @@ import { pluginDistFileNames } from './build/pluginDistFileNames.js';
 import { pluginAutoFullBuild } from './build/pluginAutoFullBuild.js';
 import { pluginBuildEntry } from './build/pluginBuildEntry.js';
 import { pluginBuildConfig } from './build/pluginBuildConfig.js';
+import { pluginModuleBanner } from './build/pluginModuleBanner.js';
 function build() {
     return [
         ...pluginBuildConfig(),
@@ -14,6 +15,7 @@ function build() {
         ...pluginBuildEntry(),
         pluginDistPackageJsonFile(),
         pluginSuppressRollupWarning(),
-        pluginDistFileNames()
+        pluginDistFileNames(),
+        pluginModuleBanner()
     ];
 }

package/dist/esm/node/plugin/plugins/commonConfig.d.ts

@@ -4,13 +4,15 @@ export type { VikeConfigPublic };
 import { type InlineConfig, type Plugin, type ResolvedConfig, type UserConfig } from 'vite';
 import { type VikeConfigObject } from './importUserCode/v1-design/getVikeConfig.js';
 import type { PrerenderContextPublic } from '../../prerender/runPrerender.js';
+import type { VitePluginServerEntryOptions } from '@brillout/vite-plugin-server-entry/plugin';
 declare module 'vite' {
     interface UserConfig {
         _isDev?: boolean;
         _vikeVitePluginOptions?: unknown;
+        vitePluginServerEntry?: VitePluginServerEntryOptions;
         _root?: string;
         _baseViteOriginal?: string;
-        _viteConfigEnhanced?: InlineConfig;
+        _viteConfigFromUserEnhanced?: InlineConfig;
         _vike?: VikeConfigPublic;
         _vikeConfigObject?: VikeConfigObject;
     }

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

@@ -66,6 +66,10 @@ function commonConfig(vikeVitePluginOptions) {
                     assertEsm(config.root);
                     assertVikeCliOrApi(config);
                     temp_supportOldInterface(config);
+                    // Only emit dist/server/entry.mjs if necessary
+                    if (config.vitePluginServerEntry?.inject &&
+                        !resolvePrerenderConfigGlobal(config._vikeConfigObject).isPrerenderingEnabled)
+                        config.vitePluginServerEntry.disableServerEntryEmit = true;
                 }
             },
             config: {

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

@@ -131,6 +131,10 @@ const configDefinitionsBuiltIn = {
         env: { config: true },
         global: true
     },
+    mode: {
+        env: { config: true },
+        global: true
+    },
     injectScriptsAt: {
         env: { server: true }
     },