vike 0.4.166 → 0.4.167-commit-14e4b5e

package/dist/esm/node/runtime/html/stream.js

@@ -379,7 +379,7 @@ async function createStreamWrapper({ streamOriginal, onError, onData, onEnd, onF
         const writeChunk = (chunk) => {
             assert(writableOriginal);
             writableOriginal.write(chunk);
-            if (debug.isEnabled) {
+            if (debug.isActivated) {
                 debug('data written (Node.js Writable)', String(chunk));
             }
         };
@@ -452,7 +452,7 @@ async function createStreamWrapper({ streamOriginal, onError, onData, onEnd, onF
         const writeChunk = (chunk) => {
             assert(writerOriginal);
             writerOriginal.write(encodeForWebStream(chunk));
-            if (debug.isEnabled) {
+            if (debug.isActivated) {
                 debug('data written (Web Writable)', String(chunk));
             }
         };
@@ -545,12 +545,12 @@ async function createStreamWrapper({ streamOriginal, onError, onData, onEnd, onF
             // If readableOriginal doesn't implement readableOriginal.cancel() then it may still emit data after we close the stream. We therefore need to check whether we closed `controllerProxy`.
             !controllerProxyIsClosed) {
                 controllerProxy.enqueue(encodeForWebStream(chunk));
-                if (debug.isEnabled) {
+                if (debug.isActivated) {
                     debug('data written (Web Readable)', String(chunk));
                 }
             }
             else {
-                if (debug.isEnabled) {
+                if (debug.isActivated) {
                     debug('data emitted but not written (Web Readable)', String(chunk));
                 }
             }
@@ -572,7 +572,7 @@ async function createStreamWrapper({ streamOriginal, onError, onData, onEnd, onF
         }
         const writeChunk = (chunk) => {
             readableProxy.push(chunk);
-            if (debug.isEnabled) {
+            if (debug.isActivated) {
                 debug('data written (Node.js Readable)', String(chunk));
             }
         };

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

@@ -13,7 +13,7 @@ function analyzePage(pageFilesAll, pageConfig, pageId) {
         const clientDependencies = [];
         clientDependencies.push({
             id: getVirtualFileIdPageConfigValuesAll(pageConfig.pageId, true),
-            onlyAssets: false,
+            onlyAssets: isClientSideRenderable ? false : true,
             eagerlyImported: false
         });
         // In production we inject the import of the server virtual module with ?extractAssets inside the client virtual module

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

@@ -1,8 +1,8 @@
 export { executeOnBeforeRenderAndDataHooks };
 import { getHook } from '../../../shared/hooks/getHook.js';
 import { preparePageContextForUserConsumptionServerSide } from './preparePageContextForUserConsumptionServerSide.js';
-import { executeHook } from '../utils.js';
 import { assertOnBeforeRenderHookReturn } from '../../../shared/assertOnBeforeRenderHookReturn.js';
+import { executeHook } from '../../../shared/hooks/executeHook.js';
 async function executeOnBeforeRenderAndDataHooks(pageContext) {
     if (pageContext._pageContextAlreadyProvidedByOnPrerenderHook) {
         return;

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

@@ -1,13 +1,14 @@
 export { executeOnRenderHtmlHook };
 import { isDocumentHtml, renderDocumentHtml, dangerouslySkipEscape } from '../html/renderHtml.js';
 import { getHook } from '../../../shared/hooks/getHook.js';
-import { assert, assertUsage, assertWarning, isObject, objectAssign, isPromise, executeHook, isCallable } from '../utils.js';
+import { assert, assertUsage, assertWarning, isObject, objectAssign, isPromise, isCallable } from '../utils.js';
 import { isStream } from '../html/stream.js';
 import { assertPageContextProvidedByUser } from '../../../shared/assertPageContextProvidedByUser.js';
 import { preparePageContextForUserConsumptionServerSide } from './preparePageContextForUserConsumptionServerSide.js';
 import { assertHookReturnedObject } from '../../../shared/assertHookReturnedObject.js';
 import { logRuntimeError } from './loggerRuntime.js';
 import pc from '@brillout/picocolors';
+import { executeHook } from '../../../shared/hooks/executeHook.js';
 async function executeOnRenderHtmlHook(pageContext) {
     const { renderHook, hookFn } = getRenderHook(pageContext);
     objectAssign(pageContext, { _renderHook: renderHook });

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

@@ -1,10 +1,8 @@
 export { getManifestEntry };
-import { assert, slice, isNpmPackageImport } from '../../utils.js';
-import { assertClientEntryId } from './assertClientEntryId.js';
+import { assert, slice, assertIsNpmPackageImport } from '../../utils.js';
 import { isVirtualFileIdPageConfigValuesAll } from '../../../shared/virtual-files/virtualFilePageConfigValuesAll.js';
 import { prependEntriesDir } from '../../../shared/prependEntriesDir.js';
 function getManifestEntry(id, assetsManifest) {
-    assertClientEntryId(id);
     const debugInfo = getDebugInfo(id, assetsManifest);
     // Vike client entry
     if (id.startsWith('@@vike/')) {
@@ -42,12 +40,11 @@ function getManifestEntry(id, assetsManifest) {
         return { manifestEntry, manifestKey };
     }
     // npm package import
-    if (isNpmPackageImport(id)) {
-        const found = Object.entries(assetsManifest).find(([, e]) => e.name === prependEntriesDir(id));
-        assert(found);
-        const [manifestKey, manifestEntry] = found;
-        return { manifestEntry, manifestKey };
-    }
+    assertIsNpmPackageImport(id);
+    const found = Object.entries(assetsManifest).find(([, e]) => e.name === prependEntriesDir(id));
+    assert(found);
+    const [manifestKey, manifestEntry] = found;
+    return { manifestEntry, manifestKey };
     /* Can we remove this?
     // extensions[number].pageConfigsSrcDir
     if (id.startsWith('/node_modules/') || id.startsWith('/../')) {
@@ -79,7 +76,6 @@ function getManifestEntry(id, assetsManifest) {
       assert(false, debugInfo)
     }
     */
-    assert(false, debugInfo);
 }
 function findEntryWithKeyEnd(manifestKeyEnd, assetsManifest, id) {
     const debugInfo = getDebugInfo(id, assetsManifest, manifestKeyEnd);

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

@@ -9,15 +9,16 @@ function retrieveAssetsProd(clientDependencies, assetsManifest, includeAssetsImp
     clientDependencies.forEach(({ id, onlyAssets, eagerlyImported }) => {
         if (eagerlyImported)
             return; // Eagerly imported assets aren't imported with import() and therefore don't create a new Rollup entry and aren't listed in the manifest file
-        if (onlyAssets) {
-            if (!includeAssetsImportedByServer)
-                return;
+        // TODO/v1-release: remove
+        if (includeAssetsImportedByServer &&
+            onlyAssets &&
+            id.includes('.page.server.') &&
             // We assume that all npm packages have already built their files: bundlers (Rollup, esbuild, tsup, ...) extract the CSS out of JavaScript => we can assume JavaScript to not import any CSS/assets.
-            if (isNpmPackageImport(id))
-                return;
-            if (id.includes('.page.server.')) {
-                id = extractAssetsAddQuery(id);
-            }
+            !isNpmPackageImport(id, {
+                // I presume Vite already resolves path aliases when Vite sets the module's id
+                cannotBePathAlias: true
+            })) {
+            id = extractAssetsAddQuery(id);
         }
         const { manifestKey } = getManifestEntry(id, assetsManifest);
         collectAssets(manifestKey, assetUrls, visistedAssets, assetsManifest, onlyAssets);

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

@@ -1,12 +1,11 @@
 export { getPageAssets };
-import { assert, prependBase, assertPosixPath, toPosixPath, isNpmPackageImport, unique, pathJoin } from '../utils.js';
+import { assert, prependBase, assertPosixPath, toPosixPath, unique, pathJoin, assertIsNpmPackageImport } from '../utils.js';
 import { retrieveAssetsDev } from './getPageAssets/retrieveAssetsDev.js';
 import { retrieveAssetsProd } from './getPageAssets/retrieveAssetsProd.js';
 import { inferMediaType } from './inferMediaType.js';
 import { getManifestEntry } from './getPageAssets/getManifestEntry.js';
 import { sortPageAssetsForEarlyHintsHeader } from './getPageAssets/sortPageAssetsForEarlyHintsHeader.js';
 import { getGlobalContext } from '../globalContext.js';
-import { assertClientEntryId } from './getPageAssets/assertClientEntryId.js';
 import { import_ } from '@brillout/import';
 async function getPageAssets(pageContext, clientDependencies, clientEntries) {
     const globalContext = getGlobalContext();
@@ -56,7 +55,6 @@ async function getPageAssets(pageContext, clientDependencies, clientEntries) {
     return pageAssets;
 }
 async function resolveClientEntriesDev(clientEntry, viteDevServer) {
-    assertClientEntryId(clientEntry);
     let root = viteDevServer.config.root;
     assert(root);
     root = toPosixPath(root);
@@ -73,11 +71,9 @@ async function resolveClientEntriesDev(clientEntry, viteDevServer) {
     assertPosixPath(clientEntry);
     let filePath;
     if (clientEntry.startsWith('/')) {
-        // User files
         filePath = pathJoin(root, clientEntry);
     }
-    else if (clientEntry.startsWith('@@vike/') || isNpmPackageImport(clientEntry)) {
-        // Vike client entry
+    else {
         const { createRequire } = (await import_('module')).default;
         const { dirname } = (await import_('path')).default;
         const { fileURLToPath } = (await import_('url')).default;
@@ -88,10 +84,7 @@ async function resolveClientEntriesDev(clientEntry, viteDevServer) {
         // @ts-expect-error
         // Bun workaround https://github.com/vikejs/vike/pull/1048
         const res = typeof Bun !== 'undefined' ? (toPath) => Bun.resolveSync(toPath, __dirname_) : require_.resolve;
-        if (isNpmPackageImport(clientEntry)) {
-            filePath = res(clientEntry);
-        }
-        else {
+        if (clientEntry.startsWith('@@vike/')) {
             assert(clientEntry.endsWith('.js'));
             try {
                 // For Vitest (which doesn't resolve vike to its dist but to its source files)
@@ -104,9 +97,10 @@ async function resolveClientEntriesDev(clientEntry, viteDevServer) {
                 filePath = toPosixPath(res(clientEntry.replace('@@vike/dist/esm/client/', '../../../../../dist/esm/client/')));
             }
         }
-    }
-    else {
-        assert(false);
+        else {
+            assertIsNpmPackageImport(clientEntry);
+            filePath = res(clientEntry);
+        }
     }
     if (!filePath.startsWith('/')) {
         assert(process.platform === 'win32');

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

@@ -20,6 +20,10 @@ const knownErrors = [
         // ```
         errMsg: 'assets.json',
         link: 'https://vike.dev/getGlobalContext'
+    },
+    {
+        errMsg: /Named export.*not found/i,
+        link: 'https://vike.dev/broken-npm-package#named-export-not-found'
     }
 ];
 function logErrorHint(error) {
@@ -285,7 +289,15 @@ function extractFromNodeModulesPath(str) {
     return packageName;
 }
 function includes(str1, str2) {
-    return !!str1 && str1.toLowerCase().includes(str2.toLowerCase());
+    if (!str1)
+        return false;
+    if (str2 instanceof RegExp) {
+        return str2.test(str1.toLowerCase());
+    }
+    if (typeof str2 === 'string') {
+        return str1.toLowerCase().includes(str2.toLowerCase());
+    }
+    return false;
 }
 function includesNodeModules(str) {
     if (!str)

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

@@ -29,7 +29,6 @@ export * from '../../utils/isPropertyGetter.js';
 export * from '../../utils/debug.js';
 export * from '../../utils/urlToFile.js';
 export * from '../../utils/getGlobalObject.js';
-export * from '../../shared/hooks/executeHook.js';
 export * from '../../utils/freezePartial.js';
 export * from '../../utils/isNpmPackage.js';
 export * from '../../utils/isNotNullish.js';

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

@@ -32,7 +32,6 @@ export * from '../../utils/isPropertyGetter.js';
 export * from '../../utils/debug.js';
 export * from '../../utils/urlToFile.js';
 export * from '../../utils/getGlobalObject.js';
-export * from '../../shared/hooks/executeHook.js';
 export * from '../../utils/freezePartial.js';
 export * from '../../utils/isNpmPackage.js';
 export * from '../../utils/isNotNullish.js';

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

@@ -18,14 +18,14 @@ type Url = {
     searchAll: Record<string, string[]>;
     /** The URL search parameterer string, e.g. `?details=yes` of `https://example.com/product/42?details=yes#reviews` */
     searchOriginal: null | string;
-    /** @deprecated */
-    searchString: null | string;
     /** The URL hash, e.g. `reviews` of `https://example.com/product/42?details=yes#reviews` */
     hash: string;
     /** The URL hash string, e.g. `#reviews` of `https://example.com/product/42?details=yes#reviews` */
     hashOriginal: null | string;
     /** @deprecated */
     hashString: null | string;
+    /** @deprecated */
+    searchString: null | string;
 };
 type PageContextUrlComputedPropsClient = {
     /** @deprecated */

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

@@ -2,51 +2,63 @@ export type { FilePath };
 export type { FilePathResolved };
 type FilePathResolved = FilePath & {
     filePathAbsoluteFilesystem: string;
+    /**
+     * The file's path, shown to the user in logs.
+     *
+     * Resolved: it always shows a file path. (It nevers shows an import path such as `vike-react/config`.)
+     *
+     * Its value is equivalent to `filePath.filePathAbsoluteUserRootDir ?? filePath.filePathAbsoluteFilesystem`.
+     */
     filePathToShowToUserResolved: string;
 };
-type FilePath = {
-    /** The file's path, non-relative from Vite's perspective.
+type IsReferencedByUserLandFile = {
+    filePathAbsoluteUserRootDir: string;
+} | {
+    importPathAbsolute: string;
+};
+type FilePath = FilePathProps & IsReferencedByUserLandFile;
+type FilePathProps = {
+    /**
+     * The file's path, absolute starting from the filesystem root.
      *
-     * Its value is equivalent to `filePath.filePathAbsoluteUserRootDir ?? filePath.importPathAbsolute`, for example:
-     *   - `vike-react/config`, or
-     *   - `/pages/+config.js`.
+     * Example: `/home/rom/code/my-app/pages/some-page/+Page.js`
      *
-     * We use it to generate import paths in virtual modules. (Since virtual modules cannot have relative import paths.)
+     * The value is `null` for imports using path aliases. (Because Vike cannot resolve path aliases, otherwise Vike would need to re-implement https://www.npmjs.com/package/@rollup/plugin-alias.)
      */
-    filePathAbsoluteVite: string;
-    /** The file's path, absolute starting from the filesystem root.
+    filePathAbsoluteFilesystem: string | null;
+    /**
+     * The file's path, absolute starting from the user root directory (i.e. Vite's `config.root`).
+     *
+     * Example: `/pages/some-page/+Page.js`.
      *
-     * Example: `/home/rom/code/my-app/pages/some-page/Page.js`
+     * Its value is `null` if the file is outside of the user root directory (i.e. Vite's `config.root`).
      *
-     * The value is `null` upon aliased import paths which we cannot resolve (we'd need to re-implement https://www.npmjs.com/package/@rollup/plugin-alias).
      */
-    filePathAbsoluteFilesystem: string | null;
-    /** The file's path, shown to user upon logging.
+    filePathAbsoluteUserRootDir: string | null;
+    /**
+     * The file's path, shown to the user in logs.
      *
-     * Unresolved: it may show an import path of a package e.g. `vike-react/config`.
+     * Unresolved: it may show an import path instead of a file path such as `vike-react/config`.
      *
-     * Currently, its value is equivalent to `FilePath['filePathAbsoluteVite']`.
+     * Its value is equivalent to `filePath.filePathAbsoluteUserRootDir ?? filePath.importPathAbsolute`.
      */
     filePathToShowToUser: string;
-    /** The file's path, shown to user upon logging.
+    /**
+     * The file's non-relative path, from Vite's perspective.
      *
-     * Resolved: it always shows an absolute file path.
+     * Examples:
+     *   - `/pages/+config.js`
+     *   - `vike-react/config`
      *
-     * Currently, its value is equivalent to `FilePath['filePathAbsoluteUserRootDir'] | FilePath['filePathAbsoluteFilesystem'] `.
-     */
-    filePathToShowToUserResolved: string | null;
-    /** The file's path, absolute starting from the user root directory (i.e. Vite's `config.root`).
+     * We use it to generate import paths in virtual modules. (Since import paths in virtual modules cannot be relative.)
      *
-     * Example: `/pages/some-page/Page.js`
+     * Its value is equivalent to `filePath.filePathAbsoluteUserRootDir ?? filePath.importPathAbsolute`.
      */
-    filePathAbsoluteUserRootDir: string | null;
-    /** The file's path, as absolute import path. It's either:
+    filePathAbsoluteVite: string;
+    /**
+     * The file's non-relative import path. It's either:
      *  - an npm package import (e.g. `vike-react/config`), or
-     *  - an alias (`#components/Counter').
+     *  - a path alias import (e.g. `#components/Counter').
      */
     importPathAbsolute: string | null;
-} & ({
-    importPathAbsolute: string;
-} | {
-    filePathAbsoluteUserRootDir: string;
-});
+};

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

@@ -23,9 +23,7 @@ function assertPlusFileExport(fileExports, filePathToShowToUser, configName) {
         }
         else {
             assert(exportsAll.length === 2); // because `exportsInvalid.length === 0`
-            assertWarning(false, `${filePathToShowToUser} remove ${exportNamed} or ${exportDefault}`, {
-                onlyOnce: true
-            });
+            assertWarning(false, `The exports of ${filePathToShowToUser} are ambiguous: remove ${exportDefault} or ${exportNamed}`, { onlyOnce: true });
         }
     }
     else {

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

@@ -7,7 +7,8 @@ export { logAbortErrorHandled };
 export { getPageContextFromAllRewrites };
 export { AbortRender };
 export { assertNoInfiniteAbortLoop };
-import { assert, assertInfo, assertUsage, assertWarning, checkType, hasProp, isUriWithProtocol, isUserHookError, joinEnglish, objectAssign, truncateString } from './utils.js';
+import { isUserHookError } from '../hooks/executeHook.js';
+import { assert, assertInfo, assertUsage, assertWarning, checkType, hasProp, isUriWithProtocol, joinEnglish, objectAssign, truncateString } from './utils.js';
 import pc from '@brillout/picocolors';
 /**
  * Abort the rendering of the current page, and redirect the user to another URL instead.

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

@@ -1,6 +1,7 @@
 export { executeGuardHook };
 import { getHook, getHookTimeoutDefault } from '../hooks/getHook.js';
-import { assert, assertUsage, executeHook, isCallable } from './utils.js';
+import { assert, assertUsage, isCallable } from './utils.js';
+import { executeHook } from '../hooks/executeHook.js';
 const errIntro = 'The guard() hook defined by';
 async function executeGuardHook(pageContext, prepareForUserConsumption) {
     let hook;

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

@@ -1,8 +1,9 @@
 export { executeOnBeforeRouteHook };
 import { assertPageContextProvidedByUser } from '../assertPageContextProvidedByUser.js';
-import { assertUsage, hasProp, isObjectWithKeys, objectAssign, assertWarning, assertUsageUrl, joinEnglish, assert, executeHook } from './utils.js';
+import { assertUsage, hasProp, isObjectWithKeys, objectAssign, assertWarning, assertUsageUrl, joinEnglish, assert } from './utils.js';
 import { assertRouteParams, assertSyncRouting } from './resolveRouteFunction.js';
 import pc from '@brillout/picocolors';
+import { executeHook } from '../hooks/executeHook.js';
 async function executeOnBeforeRouteHook(pageContext) {
     const pageContextFromOnBeforeRouteHook = {};
     if (!pageContext._onBeforeRouteHook)

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

@@ -34,9 +34,8 @@ async function route(pageContextForRoute) {
     objectAssign(pageContext, pageContextFromOnBeforeRouteHook);
     // Vike's routing
     const allPageIds = pageContext._allPageIds;
-    assert(allPageIds.length >= 0);
-    assertUsage(pageContext._pageFilesAll.length > 0 || pageContext._pageConfigs.length > 0, 'No *.page.js file found. You must create at least one *.page.js file.');
-    assertUsage(allPageIds.length > 0, "You must create at least one *.page.js file that isn't _default.page.*");
+    assertUsage(allPageIds.length > 0, 'No page found. You must create at least one page.');
+    assert(pageContext._pageFilesAll.length > 0 || pageContext._pageConfigs.length > 0);
     const { urlPathname } = pageContext;
     assert(urlPathname.startsWith('/'));
     const routeMatches = [];

package/dist/esm/shared/route/utils.d.ts

@@ -10,7 +10,6 @@ export * from '../../utils/isStringRecord.js';
 export * from '../../utils/unique.js';
 export * from '../../utils/isBrowser.js';
 export * from '../../utils/parseUrl.js';
-export * from '../hooks/executeHook.js';
 export * from '../../utils/checkType.js';
 export * from '../../utils/joinEnglish.js';
 export * from '../../utils/projectInfo.js';

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

@@ -19,7 +19,6 @@ export * from '../../utils/isStringRecord.js';
 export * from '../../utils/unique.js';
 export * from '../../utils/isBrowser.js';
 export * from '../../utils/parseUrl.js';
-export * from '../hooks/executeHook.js';
 export * from '../../utils/checkType.js';
 export * from '../../utils/joinEnglish.js';
 export * from '../../utils/projectInfo.js';

package/dist/esm/utils/assertIsNotProductionRuntime.js

@@ -16,31 +16,31 @@ const vikeVitePluginLoadedInProductionError = `Loading Vike's Vite plugin (the v
 const env = getGlobalObject('utils/assertIsNotProductionRuntime.ts', {});
 // Called by Vike modules that want to ensure that they aren't loaded by the server runtime in production
 function assertIsNotProductionRuntime() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('assertIsNotProductionRuntime()', new Error().stack);
     env.shouldNotBeProduction = true;
 }
 // Called by Vite hook configureServer()
 function markEnvAsViteDev() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsViteDev()', new Error().stack);
     env.isViteDev = true;
 }
 // Called by Vite hook configurePreviewServer()
 function markEnvAsVitePreview() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsVitePreview()', new Error().stack);
     env.isVitePreview = true;
 }
 // Called by ../node/plugin/index.ts
 function markEnvAsVikePluginLoaded() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('markEnvAsVikePluginLoaded()', new Error().stack);
     env.isVikePluginLoaded = true;
 }
 // Called by ../node/runtime/index.ts
 function assertEnv() {
-    if (debug.isEnabled)
+    if (debug.isActivated)
         debug('assertEnv()', new Error().stack);
     if (isVitest())
         return;

package/dist/esm/utils/assertPathIsFilesystemAbsolute.js

@@ -5,6 +5,7 @@ import { assertPosixPath } from './filesystemPathHandling.js';
 /** Assert path is absolute from the filesystem root */
 function assertPathIsFilesystemAbsolute(p) {
     assertPosixPath(p);
+    assert(!p.startsWith('/@fs/'));
     if (process.platform === 'win32') {
         assert(path.win32.isAbsolute(p));
     }

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

@@ -1,7 +1,8 @@
 export { createDebugger };
-export { isDebugEnabled };
+export { isDebugActivated };
 export type { Debug };
-type Flag = 'vike:routing' | 'vike:error' | 'vike:stream' | 'vike:log' | 'vike:virtual-files' | 'vike:outDir' | 'vike:extractExportNames' | 'vike:extractAssets' | 'vike:glob' | 'vike:pageFiles' | 'vike:setup' | 'vike:pointer-imports';
+declare const flags: readonly ["vike:error", "vike:extractAssets", "vike:extractExportNames", "vike:glob", "vike:log", "vike:optimizeDeps", "vike:outDir", "vike:pageFiles", "vike:pointer-imports", "vike:routing", "vike:setup", "vike:stream", "vike:virtual-files"];
+type Flag = (typeof flags)[number];
 type Debug = ReturnType<typeof createDebugger>;
 type Options = {
     serialization?: {
@@ -10,6 +11,6 @@ type Options = {
 };
 declare function createDebugger(flag: Flag, optionsGlobal?: Options): ((...msgs: unknown[]) => void) & {
     options: (optionsLocal: Options) => (...msgs: unknown[]) => void;
-    isEnabled: boolean;
+    isActivated: boolean;
 };
-declare function isDebugEnabled(flag: Flag): boolean;
+declare function isDebugActivated(flag: Flag): boolean;

package/dist/esm/utils/debug.js

@@ -1,16 +1,35 @@
 export { createDebugger };
-export { isDebugEnabled };
+export { isDebugActivated };
 import { isBrowser } from './isBrowser.js';
 import { isCallable } from './isCallable.js';
 import { objectAssign } from './objectAssign.js';
-import { assert } from './assert.js';
+import { assert, assertUsage } from './assert.js';
 import { checkType } from './checkType.js';
 import { getTerminalWidth } from './getTerminWidth.js';
+import pc from '@brillout/picocolors';
 // 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;
+const flags = [
+    'vike:error',
+    'vike:extractAssets',
+    'vike:extractExportNames',
+    'vike:glob',
+    'vike:log',
+    'vike:optimizeDeps',
+    'vike:outDir',
+    'vike:pageFiles',
+    'vike:pointer-imports',
+    'vike:routing',
+    'vike:setup',
+    'vike:stream',
+    'vike:virtual-files'
+];
+const flagRegex = /\bvike:[a-zA-Z-]+/g;
+assertDEBUG();
 function createDebugger(flag, optionsGlobal) {
     checkType(flag);
+    assert(flags.includes(flag));
     const debugWithOptions = (optionsLocal) => {
         return (...msgs) => {
             const options = { ...optionsGlobal, ...optionsLocal };
@@ -18,11 +37,11 @@ function createDebugger(flag, optionsGlobal) {
         };
     };
     const debug = (...msgs) => debugWithOptions({})(...msgs);
-    objectAssign(debug, { options: debugWithOptions, isEnabled: isDebugEnabled(flag) });
+    objectAssign(debug, { options: debugWithOptions, isActivated: isDebugActivated(flag) });
     return debug;
 }
 function debug_(flag, options, ...msgs) {
-    if (!isDebugEnabled(flag))
+    if (!isDebugActivated(flag))
         return;
     let [msgFirst, ...msgsRest] = msgs;
     const padding = ' '.repeat(flag.length + 1);
@@ -47,17 +66,12 @@ function debug_(flag, options, ...msgs) {
         console.log(msg);
     });
 }
-function isDebugEnabled(flag) {
+function isDebugActivated(flag) {
     checkType(flag);
-    let DEBUG;
-    // - `process` can be undefined in edge workers
-    // - We want bundlers to be able to statically replace `process.env.*`
-    try {
-        DEBUG = process.env.DEBUG;
-    }
-    catch { }
-    const isEnabled = DEBUG?.includes(flag) ?? false;
-    return isEnabled;
+    assert(flags.includes(flag));
+    const DEBUG = getDEBUG();
+    const isActivated = DEBUG?.includes(flag) ?? false;
+    return isActivated;
 }
 function formatMsg(info, options, padding, position) {
     if (info === undefined) {
@@ -119,3 +133,20 @@ function replaceFunctionSerializer(_key, value) {
     }
     return value;
 }
+function assertDEBUG() {
+    const DEBUG = getDEBUG() ?? '';
+    const flagsActivated = DEBUG.match(flagRegex) ?? [];
+    flagsActivated.forEach((flag) => {
+        assertUsage(flags.includes(flag), `Unknown DEBUG flag ${pc.cyan(flag)}. Valid flags:\n${flags.map((f) => `  ${pc.cyan(f)}`).join('\n')}`);
+    });
+}
+function getDEBUG() {
+    let DEBUG;
+    // - `process` can be undefined in edge workers
+    // - We want bundlers to be able to statically replace `process.env.*`
+    try {
+        DEBUG = process.env.DEBUG;
+    }
+    catch { }
+    return DEBUG;
+}

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

@@ -4,5 +4,5 @@ export declare const debugGlob: ((...msgs: unknown[]) => void) & {
             emptyArray?: string | undefined;
         } | undefined;
     }) => (...msgs: unknown[]) => void;
-    isEnabled: boolean;
+    isActivated: boolean;
 };

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

@@ -1,8 +1,12 @@
 export { isNpmPackageImport };
+export { assertIsNpmPackageImport };
 export { isValidPathAlias };
 export { parse };
 export { isDistinguishable };
-declare function isNpmPackageImport(str: string): boolean;
+declare function isNpmPackageImport(str: string, { cannotBePathAlias }: {
+    cannotBePathAlias: true;
+}): boolean;
+declare function assertIsNpmPackageImport(str: string): void;
 declare function isValidPathAlias(alias: string): boolean;
 declare function isDistinguishable(alias: string): boolean;
 declare function parse(str: string | undefined): null | {