vitest 5.0.0-beta.7 → 5.0.0-rc.1

package/LICENSE.md

@@ -31,7 +31,7 @@ BSD-3-Clause, ISC, MIT
 ## @antfu/install-pkg
 License: MIT
 By: Anthony Fu
-Repository: git+https://github.com/antfu/install-pkg.git
+Repository: git+https://github.com/antfu-collective/install-pkg.git
 
 > MIT License
 >

package/dist/browser.d.ts

@@ -1,7 +1,9 @@
-import { az as SerializedCoverageConfig, be as FileSpecification, V as VitestRunner, F as File, x as SerializedConfig, bf as SerializedDiffOptions, a8 as DiffOptions, aU as TestError } from './chunks/config.d.DsC1jkby.js';
-export { au as ParsedStack, bg as SpyModule, bh as StringifyOptions, bi as format, bj as inspect, bk as stringify } from './chunks/config.d.DsC1jkby.js';
-import { R as RuntimeCoverageModuleLoader } from './chunks/coverage.d.ByaAMV4A.js';
-export { D as DecodedMap, g as getOriginalPosition } from './chunks/coverage.d.ByaAMV4A.js';
+import { F as FileSpecification, c as SerializedDiffOptions } from './chunks/config.d.BpALOMjL.js';
+import { SerializedCoverageConfig, RunnerTestFile as File, SerializedConfig, DiffOptions, TestError } from './index.js';
+import { VitestRunner } from './runtime.js';
+export { P as ParsedStack, _ as SpyModule, d as StringifyOptions, f as format, i as inspect, s as stringify } from './chunks/config.d.BpALOMjL.js';
+import { R as RuntimeCoverageModuleLoader } from './chunks/source-map.d.DRVw4m2c.js';
+export { D as DecodedMap, g as getOriginalPosition } from './chunks/source-map.d.DRVw4m2c.js';
 import 'vitest/optional-runtime-types.js';
 import 'tinybench';
 

package/dist/browser.js

@@ -1,15 +1,15 @@
-export { s as startCoverageInsideWorker, a as stopCoverageInsideWorker, t as takeCoverageInsideWorker } from './chunks/coverage.BfSEMtie.js';
-export { p as collectTests, a as processError, s as startTests } from './chunks/artifact.DC5WoEgy.js';
-export { l as loadDiffConfig, a as loadSnapshotSerializers, s as setupCommonEnv, b as setupEnv } from './chunks/setup-common.vxjAyUtK.js';
-export { s as SpyModule } from './chunks/spy.B8mHA9qu.js';
-export { f as format, i as inspect, s as stringify } from './chunks/display.CYwyMF4S.js';
-export { g as getType } from './chunks/pathe.M-eThtNZ.CbK_Vbae.js';
-export { D as DecodedMap, g as getOriginalPosition, a as getSafeTimers, s as setSafeTimers } from './chunks/source-map.DZdIqpIJ.js';
-import './chunks/coverage.BVb1JqW7.js';
-import './chunks/index.DzTmMrSM.js';
+export { s as startCoverageInsideWorker, a as stopCoverageInsideWorker, t as takeCoverageInsideWorker } from './chunks/coverage.VANpXofm.js';
+export { p as collectTests, a as processError, s as startTests } from './chunks/run.DS9d28OG.js';
+export { l as loadDiffConfig, a as loadSnapshotSerializers, s as setupCommonEnv, b as setupEnv } from './chunks/setup-common.D_kw2djf.js';
+export { s as SpyModule } from './chunks/spy.DPpyuUIA.js';
+export { f as format, i as inspect, s as stringify } from './chunks/display.pkpxlVcY.js';
+export { g as getType } from './chunks/pathe.M-eThtNZ.k2RS39sQ.js';
+export { D as DecodedMap, g as getOriginalPosition, a as getSafeTimers, s as setSafeTimers } from './chunks/source-map.CTObTzjj.js';
+import './chunks/coverage.CPiksdSj.js';
+import './chunks/index.M2dsQ_UQ.js';
 import './chunks/tinyrainbow.Ht9iggcq.js';
 import './task-utils.js';
-import './chunks/plugins.CsoX-42X.js';
+import './chunks/plugins.Cigb0uSy.js';
 
 /**
 * @internal

package/dist/chunks/{acorn.B2iPLyUM.js → acorn.C1kjbUFw.js}

@@ -817,10 +817,10 @@ var pp$8 = Parser.prototype;
 // to its body instead of creating a new node.
 
 pp$8.parseTopLevel = function(node) {
-  var exports$1 = Object.create(null);
+  var exports = Object.create(null);
   if (!node.body) { node.body = []; }
   while (this.type !== types$1.eof) {
-    var stmt = this.parseStatement(null, true, exports$1);
+    var stmt = this.parseStatement(null, true, exports);
     node.body.push(stmt);
   }
   if (this.inModule)
@@ -884,7 +884,7 @@ pp$8.isAsyncFunction = function() {
 // `if (foo) /blah/.exec(foo)`, where looking at the previous token
 // does not help.
 
-pp$8.parseStatement = function(context, topLevel, exports$1) {
+pp$8.parseStatement = function(context, topLevel, exports) {
   var starttype = this.type, node = this.startNode(), kind;
 
   if (this.isLet(context)) {
@@ -939,7 +939,7 @@ pp$8.parseStatement = function(context, topLevel, exports$1) {
       if (!this.inModule)
         { this.raise(this.start, "'import' and 'export' may appear only with 'sourceType: module'"); }
     }
-    return starttype === types$1._import ? this.parseImport(node) : this.parseExport(node, exports$1)
+    return starttype === types$1._import ? this.parseImport(node) : this.parseExport(node, exports)
 
     // If the statement does not start with a statement keyword or a
     // brace, it's an ExpressionStatement or LabeledStatement. We
@@ -1654,11 +1654,11 @@ function checkKeyName(node, name) {
 
 // Parses module export declaration.
 
-pp$8.parseExportAllDeclaration = function(node, exports$1) {
+pp$8.parseExportAllDeclaration = function(node, exports) {
   if (this.options.ecmaVersion >= 11) {
     if (this.eatContextual("as")) {
       node.exported = this.parseModuleExportName();
-      this.checkExport(exports$1, node.exported, this.lastTokStart);
+      this.checkExport(exports, node.exported, this.lastTokStart);
     } else {
       node.exported = null;
     }
@@ -1670,14 +1670,14 @@ pp$8.parseExportAllDeclaration = function(node, exports$1) {
   return this.finishNode(node, "ExportAllDeclaration")
 };
 
-pp$8.parseExport = function(node, exports$1) {
+pp$8.parseExport = function(node, exports) {
   this.next();
   // export * from '...'
   if (this.eat(types$1.star)) {
-    return this.parseExportAllDeclaration(node, exports$1)
+    return this.parseExportAllDeclaration(node, exports)
   }
   if (this.eat(types$1._default)) { // export default ...
-    this.checkExport(exports$1, "default", this.lastTokStart);
+    this.checkExport(exports, "default", this.lastTokStart);
     node.declaration = this.parseExportDefaultDeclaration();
     return this.finishNode(node, "ExportDefaultDeclaration")
   }
@@ -1685,14 +1685,14 @@ pp$8.parseExport = function(node, exports$1) {
   if (this.shouldParseExportStatement()) {
     node.declaration = this.parseExportDeclaration(node);
     if (node.declaration.type === "VariableDeclaration")
-      { this.checkVariableExport(exports$1, node.declaration.declarations); }
+      { this.checkVariableExport(exports, node.declaration.declarations); }
     else
-      { this.checkExport(exports$1, node.declaration.id, node.declaration.id.start); }
+      { this.checkExport(exports, node.declaration.id, node.declaration.id.start); }
     node.specifiers = [];
     node.source = null;
   } else { // export { x, y as z } [from '...']
     node.declaration = null;
-    node.specifiers = this.parseExportSpecifiers(exports$1);
+    node.specifiers = this.parseExportSpecifiers(exports);
     if (this.eatContextual("from")) {
       if (this.type !== types$1.string) { this.unexpected(); }
       node.source = this.parseExprAtom();
@@ -1738,47 +1738,47 @@ pp$8.parseExportDefaultDeclaration = function() {
   }
 };
 
-pp$8.checkExport = function(exports$1, name, pos) {
-  if (!exports$1) { return }
+pp$8.checkExport = function(exports, name, pos) {
+  if (!exports) { return }
   if (typeof name !== "string")
     { name = name.type === "Identifier" ? name.name : name.value; }
-  if (hasOwn(exports$1, name))
+  if (hasOwn(exports, name))
     { this.raiseRecoverable(pos, "Duplicate export '" + name + "'"); }
-  exports$1[name] = true;
+  exports[name] = true;
 };
 
-pp$8.checkPatternExport = function(exports$1, pat) {
+pp$8.checkPatternExport = function(exports, pat) {
   var type = pat.type;
   if (type === "Identifier")
-    { this.checkExport(exports$1, pat, pat.start); }
+    { this.checkExport(exports, pat, pat.start); }
   else if (type === "ObjectPattern")
     { for (var i = 0, list = pat.properties; i < list.length; i += 1)
       {
         var prop = list[i];
 
-        this.checkPatternExport(exports$1, prop);
+        this.checkPatternExport(exports, prop);
       } }
   else if (type === "ArrayPattern")
     { for (var i$1 = 0, list$1 = pat.elements; i$1 < list$1.length; i$1 += 1) {
       var elt = list$1[i$1];
 
-        if (elt) { this.checkPatternExport(exports$1, elt); }
+        if (elt) { this.checkPatternExport(exports, elt); }
     } }
   else if (type === "Property")
-    { this.checkPatternExport(exports$1, pat.value); }
+    { this.checkPatternExport(exports, pat.value); }
   else if (type === "AssignmentPattern")
-    { this.checkPatternExport(exports$1, pat.left); }
+    { this.checkPatternExport(exports, pat.left); }
   else if (type === "RestElement")
-    { this.checkPatternExport(exports$1, pat.argument); }
+    { this.checkPatternExport(exports, pat.argument); }
 };
 
-pp$8.checkVariableExport = function(exports$1, decls) {
-  if (!exports$1) { return }
+pp$8.checkVariableExport = function(exports, decls) {
+  if (!exports) { return }
   for (var i = 0, list = decls; i < list.length; i += 1)
     {
     var decl = list[i];
 
-    this.checkPatternExport(exports$1, decl.id);
+    this.checkPatternExport(exports, decl.id);
   }
 };
 
@@ -1793,13 +1793,13 @@ pp$8.shouldParseExportStatement = function() {
 
 // Parses a comma-separated list of module exports.
 
-pp$8.parseExportSpecifier = function(exports$1) {
+pp$8.parseExportSpecifier = function(exports) {
   var node = this.startNode();
   node.local = this.parseModuleExportName();
 
   node.exported = this.eatContextual("as") ? this.parseModuleExportName() : node.local;
   this.checkExport(
-    exports$1,
+    exports,
     node.exported,
     node.exported.start
   );
@@ -1807,7 +1807,7 @@ pp$8.parseExportSpecifier = function(exports$1) {
   return this.finishNode(node, "ExportSpecifier")
 };
 
-pp$8.parseExportSpecifiers = function(exports$1) {
+pp$8.parseExportSpecifiers = function(exports) {
   var nodes = [], first = true;
   // export { x, y as z } [from '...']
   this.expect(types$1.braceL);
@@ -1817,7 +1817,7 @@ pp$8.parseExportSpecifiers = function(exports$1) {
       if (this.afterTrailingComma(types$1.braceR)) { break }
     } else { first = false; }
 
-    nodes.push(this.parseExportSpecifier(exports$1));
+    nodes.push(this.parseExportSpecifier(exports));
   }
   return nodes
 };

package/dist/chunks/{base.B0fUxpj9.js → base.IQV3unVv.js}

@@ -1,21 +1,21 @@
 import { runInThisContext } from 'node:vm';
-import { s as spyModule } from './spy.B8mHA9qu.js';
-import { r as resolveTestRunner, a as resolveSnapshotEnvironment, d as detectAsyncLeaks, s as setupChaiConfig } from './index.JaztIWgW.js';
-import { l as loadEnvironment, e as emitModuleRunner, a as listenForErrors } from './init.CfiYZpFg.js';
+import { s as spyModule } from './spy.DPpyuUIA.js';
+import { r as resolveTestRunner, a as resolveSnapshotEnvironment, d as detectAsyncLeaks, s as setupChaiConfig } from './index.CePpwRnE.js';
+import { l as loadEnvironment, e as emitModuleRunner, a as listenForErrors } from './init.BU4khizz.js';
 import { Traces } from '../traces.js';
-import { V as VitestEvaluatedModules } from './rpc.iNjF664v.js';
-import { s as startVitestModuleRunner, c as createNodeImportMeta } from './index.DxR-nMjO.js';
+import { V as VitestEvaluatedModules } from './rpc.DaPTofpf.js';
+import { s as startVitestModuleRunner, c as createNodeImportMeta } from './index.BfU4rh_M.js';
 import { performance as performance$1 } from 'node:perf_hooks';
-import { s as startCoverageInsideWorker, a as stopCoverageInsideWorker } from './coverage.BfSEMtie.js';
-import { i as index, g as globalExpect, v as vi } from './index.CLtI1k_4.js';
+import { s as startCoverageInsideWorker, a as stopCoverageInsideWorker } from './coverage.VANpXofm.js';
+import { i as index, g as globalExpect, v as vi } from './index.DRmbsPYf.js';
 import { c as closeInspector } from './inspector.CvyFGlXm.js';
-import { s as startTests, p as publicCollect } from './artifact.DC5WoEgy.js';
+import { s as startTests, p as publicCollect } from './run.DS9d28OG.js';
 import { createRequire } from 'node:module';
 import timers from 'node:timers';
 import timersPromises from 'node:timers/promises';
 import util from 'node:util';
-import { K as KNOWN_ASSET_TYPES } from './pathe.M-eThtNZ.CbK_Vbae.js';
-import { s as setupCommonEnv, b as setupEnv } from './setup-common.vxjAyUtK.js';
+import { K as KNOWN_ASSET_TYPES } from './pathe.M-eThtNZ.k2RS39sQ.js';
+import { s as setupCommonEnv, b as setupEnv } from './setup-common.D_kw2djf.js';
 import { g as getWorkerState, r as resetModules, p as provideWorkerState, a as getSafeWorkerState } from './utils.DYj33du9.js';
 
 // this should only be used in Node
@@ -57,7 +57,7 @@ function resolveAsset(mod, url) {
 	mod.exports = url;
 }
 async function setupConsoleLogSpy() {
-	const { createCustomConsole } = await import('./console.omGxyKMT.js');
+	const { createCustomConsole } = await import('./console.DWNMLVgF.js');
 	globalThis.console = createCustomConsole();
 }
 
@@ -72,30 +72,34 @@ async function run(method, files, config, moduleRunner, environment, traces) {
 			if (!workerState.config.snapshotOptions.snapshotEnvironment) workerState.config.snapshotOptions.snapshotEnvironment = await resolveSnapshotEnvironment(config, moduleRunner);
 		})
 	]);
-	workerState.onCancel((reason) => {
+	const offCancel = workerState.onCancel((reason) => {
 		closeInspector(config);
 		testRunner.cancel?.(reason);
 	});
 	workerState.durations.prepare = performance$1.now() - workerState.durations.prepare;
-	await traces.$(`vitest.test.runner.${method}`, async () => {
-		for (const file of files) {
-			if (config.isolate) {
-				moduleRunner.mocker?.reset();
-				resetModules(workerState.evaluatedModules, true);
+	try {
+		await traces.$(`vitest.test.runner.${method}`, async () => {
+			for (const file of files) {
+				if (config.isolate) {
+					moduleRunner.mocker?.reset();
+					resetModules(workerState.evaluatedModules, true);
+				}
+				workerState.filepath = file.filepath;
+				if (method === "run") {
+					const collectAsyncLeaks = config.detectAsyncLeaks ? detectAsyncLeaks(file.filepath, workerState.ctx.projectName) : void 0;
+					await traces.$(`vitest.test.runner.${method}.module`, { attributes: { "code.file.path": file.filepath } }, () => startTests([file], testRunner));
+					const leaks = await collectAsyncLeaks?.();
+					if (leaks?.length) workerState.rpc.onAsyncLeaks(leaks);
+				} else await traces.$(`vitest.test.runner.${method}.module`, { attributes: { "code.file.path": file.filepath } }, () => publicCollect([file], testRunner));
+				// reset after tests, because user might call `vi.setConfig` in setupFile
+				vi.resetConfig();
+				// mocks should not affect different files
+				vi.restoreAllMocks();
 			}
-			workerState.filepath = file.filepath;
-			if (method === "run") {
-				const collectAsyncLeaks = config.detectAsyncLeaks ? detectAsyncLeaks(file.filepath, workerState.ctx.projectName) : void 0;
-				await traces.$(`vitest.test.runner.${method}.module`, { attributes: { "code.file.path": file.filepath } }, () => startTests([file], testRunner));
-				const leaks = await collectAsyncLeaks?.();
-				if (leaks?.length) workerState.rpc.onAsyncLeaks(leaks);
-			} else await traces.$(`vitest.test.runner.${method}.module`, { attributes: { "code.file.path": file.filepath } }, () => publicCollect([file], testRunner));
-			// reset after tests, because user might call `vi.setConfig` in setupFile
-			vi.resetConfig();
-			// mocks should not affect different files
-			vi.restoreAllMocks();
-		}
-	});
+		});
+	} finally {
+		offCancel();
+	}
 	await traces.$("vitest.runtime.coverage.stop", () => stopCoverageInsideWorker(config.coverage, moduleRunner, { isolate: config.isolate }));
 }
 
@@ -114,7 +118,7 @@ async function startModuleRunner(options) {
 		let mocker;
 		if (options.state.config.experimental.nodeLoader !== false) {
 			// this additionally imports acorn/magic-string
-			const { NativeModuleMocker } = await import('./nativeModuleMocker.Uot80PXb.js');
+			const { NativeModuleMocker } = await import('./nativeModuleMocker.0CD1hdFV.js');
 			mocker = new NativeModuleMocker({
 				async resolveId(id, importer) {
 					// TODO: use import.meta.resolve instead
@@ -131,7 +135,7 @@ async function startModuleRunner(options) {
 		}
 		// imported lazily (pulls in `local-pkg`) so it stays out of the default
 		// worker startup graph; only the `viteModuleRunner: false` path needs it
-		const { NativeModuleRunner } = await import('./nativeModuleRunner.BDnwGb8g.js').then(function (n) { return n.n; });
+		const { NativeModuleRunner } = await import('./nativeModuleRunner.Bc3kXpWn.js').then(function (n) { return n.n; });
 		_moduleRunner = new NativeModuleRunner(root, mocker);
 		return _moduleRunner;
 	}
@@ -143,21 +147,12 @@ let _environmentTime;
 /** @experimental */
 async function setupBaseEnvironment(context) {
 	if (context.config.experimental.viteModuleRunner === false) {
-		const { setupNodeLoaderHooks } = await import('./native.BUCvPRKp.js');
+		const { setupNodeLoaderHooks } = await import('./native.offEPk9l.js');
 		await setupNodeLoaderHooks(context);
 	}
 	const startTime = performance.now();
 	const { environment: { name: environmentName, options: environmentOptions }, rpc, config } = context;
 	setupEnv(config.env, context.metaEnv);
-	// we could load @vite/env, but it would take ~8ms, while this takes ~0,02ms
-	if (context.config.serializedDefines) try {
-		runInThisContext(`(() =>{\n${context.config.serializedDefines}})()`, {
-			lineOffset: 1,
-			filename: "virtual:load-defines.js"
-		});
-	} catch (error) {
-		throw new Error(`Failed to load custom "defines": ${error.message}`);
-	}
 	const otel = context.traces;
 	const { environment, loader } = await loadEnvironment(environmentName, config.root, rpc, otel, context.config.experimental.viteModuleRunner);
 	_currentEnvironment = environment;
@@ -181,6 +176,15 @@ async function runBaseTests(method, state, traces) {
 	state.evaluatedModules = evaluatedModules;
 	state.moduleExecutionInfo = moduleExecutionInfo;
 	provideWorkerState(globalThis, state);
+	// we could load @vite/env, but it would take ~8ms, while this takes ~0,02ms
+	if (state.config.serializedDefines) try {
+		runInThisContext(`(() =>{\n${state.config.serializedDefines}})()`, {
+			lineOffset: 1,
+			filename: "virtual:load-defines.js"
+		});
+	} catch (error) {
+		throw new Error(`Failed to load custom "defines": ${error.message}`);
+	}
 	if (ctx.invalidates) ctx.invalidates.forEach((filepath) => {
 		(state.evaluatedModules.fileToModulesMap.get(filepath) || []).forEach((module) => {
 			state.evaluatedModules.invalidateModule(module);

package/dist/chunks/{browser.d.BFOby8YL.d.ts → browser.d.Dp8LNQdx.d.ts}

@@ -1,17 +1,6 @@
-import { be as FileSpecification } from './config.d.DsC1jkby.js';
-import { O as OTELCarrier } from './rpc.d.BeasqWpO.js';
-import { T as TestExecutionMethod } from './worker.d.s_RdeZtI.js';
-
-type SerializedTestSpecification = [project: {
-	name: string | undefined;
-	root: string;
-}, file: string, options: {
-	pool: string;
-	testLines?: number[] | undefined;
-	testIds?: string[] | undefined;
-	testNamePattern?: RegExp | undefined;
-	testTagsFilter?: string[] | undefined;
-}];
+import { F as FileSpecification } from './config.d.BpALOMjL.js';
+import { O as OTELCarrier } from './rpc.d.DWQfGdI1.js';
+import { T as TestExecutionMethod } from './worker.d.D7LKSMQN.js';
 
 interface ModuleDefinitionLocation {
 	line: number;
@@ -52,6 +41,17 @@ interface SourceModuleDiagnostic {
 	untrackedModules: UntrackedModuleDefinitionDiagnostic[];
 }
 
+type SerializedTestSpecification = [project: {
+	name: string | undefined;
+	root: string;
+}, file: string, options: {
+	pool: string;
+	testLines?: number[] | undefined;
+	testIds?: string[] | undefined;
+	testNamePattern?: RegExp | undefined;
+	testTagsFilter?: string[] | undefined;
+}];
+
 interface BrowserTesterOptions {
 	method: TestExecutionMethod;
 	files: FileSpecification[];

package/dist/chunks/{cac.B41kXwyU.js → cac.CM6y_f_i.js}

@@ -1,4 +1,4 @@
-import { n as normalize, t as toArray } from './pathe.M-eThtNZ.CbK_Vbae.js';
+import { n as normalize, t as toArray } from './pathe.M-eThtNZ.k2RS39sQ.js';
 import { EventEmitter } from 'events';
 import { m } from './tinyrainbow.Ht9iggcq.js';
 import { a as isForceColor } from './env.DzFJjrmK.js';
@@ -620,7 +620,7 @@ class CAC extends EventEmitter {
 
 const cac = (name = "") => new CAC(name);
 
-var version = "5.0.0-beta.7";
+var version = "5.0.0-rc.1";
 
 const apiConfig = (port) => ({
 	port: {
@@ -1128,6 +1128,7 @@ const cliOptionsConfig = {
 		}
 	},
 	project: {
+		shorthand: "p",
 		description: "The name of the project to run if you are using Vitest workspace feature. This can be repeated for multiple projects: `--project=1 --project=2`. You can also filter projects using wildcards like `--project=packages*`, and exclude projects with `--project=!pattern`.",
 		argument: "<name>",
 		array: true
@@ -1145,6 +1146,7 @@ const cliOptionsConfig = {
 		argument: "",
 		subcommands: { dir: null },
 		default: true,
+		// cache can only be "false" or an object
 		transform(cache) {
 			if (typeof cache !== "boolean" && cache) throw new Error("--cache.dir is deprecated");
 			if (cache) return {};
@@ -1195,6 +1197,7 @@ const cliOptionsConfig = {
 		description: "The directory where attachments from `context.annotate` are stored in (default: `.vitest/attachments`)",
 		argument: "<dir>"
 	},
+	// CLI only options
 	run: { description: "Disable watch mode" },
 	color: {
 		description: "Removes colors from the console output",
@@ -1225,6 +1228,7 @@ const cliOptionsConfig = {
 		array: true
 	},
 	strictTags: { description: "Should Vitest throw an error if test has a tag that is not defined in the config. (default: `true`)" },
+	sharedViteServer: { description: "Let inline projects that don't modify the Vite config reuse the Vite server of the config that declares them. (default: `true`)" },
 	experimental: {
 		description: "Experimental features.",
 		argument: "<features>",
@@ -1274,9 +1278,20 @@ const cliOptionsConfig = {
 				description: "Custom provider for detecting changed files. (default: `git`)",
 				subcommands: null
 			},
-			preParse: { description: "Parse test specifications before running them. This will apply `.only` flag and test name pattern across all files without running them. (default: `false`)" }
+			preParse: { description: "Parse test specifications before running them. This will apply `.only` flag and test name pattern across all files without running them. (default: `false`)" },
+			diagnostics: {
+				description: "Print performance hints after the run when a configuration change would make it significantly faster. Hints never suggest changing options that were set explicitly. (default: `true`)",
+				argument: "",
+				subcommands: {
+					isolate: { description: "Print a hint estimating how much time `isolate: false` would save when `isolate: true` spends a significant amount of time spawning a worker per test file. (default: `true`)" },
+					environment: { description: "Print a hint when re-creating a DOM environment for every test file dominates the run and a `vm` pool would set it up once per worker. (default: `true`)" },
+					import: { description: "Print a hint when test files repeatedly evaluate the same module graph (typical for barrel-file imports) and `isolate: false` would evaluate it once per worker. (default: `true`)" },
+					transform: { description: "Print a hint when transforming modules dominates the run and `fsModuleCache` would persist the results across runs. (default: `true`)" }
+				}
+			}
 		}
 	},
+	// disable CLI options
 	cliExclude: null,
 	server: null,
 	setupFiles: null,
@@ -1333,7 +1348,7 @@ const collectCliOptionsConfig = {
 	}
 };
 
-const a={ShellCompDirectiveError:1,ShellCompDirectiveNoSpace:2,ShellCompDirectiveNoFileComp:4,ShellCompDirectiveFilterFileExt:8,ShellCompDirectiveFilterDirs:16,ShellCompDirectiveKeepOrder:32,ShellCompDirectiveDefault:0};var o$1=class o{name;variadic;command;handler;constructor(e,t,n,r=false){this.command=e,this.name=t,this.handler=n,this.variadic=r;}},s$1=class s{value;description;command;handler;alias;isBoolean;constructor(e,t,n,r,i,a){this.command=e,this.value=t,this.description=n,this.handler=r,this.alias=i,this.isBoolean=a;}},c$1=class c{value;description;options=new Map;arguments=new Map;parent;constructor(e,t){this.value=e,this.description=t;}option(e,t,n,r){let i,a,o;typeof n==`function`?(i=n,a=r,o=false):typeof n==`string`?(i=void 0,a=n,o=true):(i=void 0,a=void 0,o=true);let c=new s$1(this,e,t,i,a,o);return this.options.set(e,c),this}argument(e,t,n=false){let r=new o$1(this,e,t,n);return this.arguments.set(e,r),this}},l$1=class l extends c$1{commands=new Map;completions=[];directive=a.ShellCompDirectiveDefault;constructor(){super(``,``);}command(e,t){let n=new c$1(e,t);return this.commands.set(e,n),n}stripOptions(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.startsWith(`-`)){n++;let t=false,i=this.findOption(this,r);if(i)t=i.isBoolean??false;else for(let[,e]of this.commands){let n=this.findOption(e,r);if(n){t=n.isBoolean??false;break}}!t&&n<e.length&&!e[n].startsWith(`-`)&&n++;}else t.push(r),n++;}return t}matchCommand(e){e=this.stripOptions(e);let t=[],n=[],r=null;for(let i=0;i<e.length;i++){let a=e[i];t.push(a);let o=this.commands.get(t.join(` `));if(o)r=o;else {n=e.slice(i,e.length);break}}return [r||this,n]}shouldCompleteFlags(e,t){if(t.startsWith(`-`))return  true;if(e?.startsWith(`-`)){let t=this.findOption(this,e);if(!t){for(let[,n]of this.commands)if(t=this.findOption(n,e),t)break}return !(t&&t.isBoolean)}return  false}shouldCompleteCommands(e){return !e.startsWith(`-`)}handleFlagCompletion(e,t,n,r){let i;if(n.includes(`=`)){let[e]=n.split(`=`);i=e;}else if(r?.startsWith(`-`)){let t=this.findOption(e,r);t&&!t.isBoolean&&(i=r);}if(i){let t=this.findOption(e,i);if(t?.handler){let n=[];t.handler.call(t,(e,t)=>n.push({value:e,description:t}),e.options),this.completions=n;}return}if(n.startsWith(`-`)){let t=n.startsWith(`-`)&&!n.startsWith(`--`),r=n.replace(/^-+/,``);for(let[i,a]of e.options)t&&a.alias&&`-${a.alias}`.startsWith(n)?this.completions.push({value:`-${a.alias}`,description:a.description}):!t&&i.startsWith(r)&&this.completions.push({value:`--${i}`,description:a.description});}}findOption(e,t){let n=e.options.get(t);if(n||(n=e.options.get(t.replace(/^-+/,``)),n))return n;for(let[n,r]of e.options)if(r.alias&&`-${r.alias}`===t)return r}handleCommandCompletion(e,t){let n=this.stripOptions(e);for(let[e,r]of this.commands){if(e===``)continue;let i=e.split(` `);i.slice(0,n.length).every((e,t)=>e===n[t])&&i[n.length]?.startsWith(t)&&this.completions.push({value:i[n.length],description:r.description});}}handlePositionalCompletion(e,t){let n=e.value.split(` `).length,r=Math.max(0,t.length-n),i=Array.from(e.arguments.entries());if(i.length>0){let t;if(r<i.length){let[e,n]=i[r];t=n;}else {let e=i[i.length-1][1];e.variadic&&(t=e);}if(t&&t.handler&&typeof t.handler==`function`){let n=[];t.handler.call(t,(e,t)=>n.push({value:e,description:t}),e.options),this.completions.push(...n);}}}complete(e){this.directive=a.ShellCompDirectiveNoFileComp;let t=new Set;this.completions.filter(e=>t.has(e.value)?false:(t.add(e.value),true)).filter(t=>{if(e.includes(`=`)){let[,n]=e.split(`=`);return t.value.startsWith(n)}return t.value.startsWith(e)}).forEach(e=>console.log(`${e.value}\t${e.description??``}`)),console.log(`:${this.directive}`);}parse(e){this.completions=[];let t=e[e.length-1]===``;t&&e.pop();let n=e[e.length-1]||``,r=e.slice(0,-1);t&&(n!==``&&r.push(n),n=``);let[i]=this.matchCommand(r),a=r[r.length-1];if(this.shouldCompleteFlags(a,n))this.handleFlagCompletion(i,r,n,a);else {if(a?.startsWith(`-`)&&n===``&&t){let e=this.findOption(this,a);if(!e){for(let[,t]of this.commands)if(e=this.findOption(t,a),e)break}if(e&&e.isBoolean){this.complete(n);return}}this.shouldCompleteCommands(n)&&this.handleCommandCompletion(r,n),i&&i.arguments.size>0&&this.handlePositionalCompletion(i,r);}this.complete(n);}setup(a,o,s){switch(assert(s===`zsh`||s===`bash`||s===`fish`||s===`powershell`,`Unsupported shell`),s){case `zsh`:{let t$1=t(a,o);console.log(t$1);break}case `bash`:{let e=n(a,o);console.log(e);break}case `fish`:{let e=r(a,o);console.log(e);break}case `powershell`:{let e=i(a,o);console.log(e);break}}}};const u$1=new l$1;
+const a={ShellCompDirectiveError:1,ShellCompDirectiveNoSpace:2,ShellCompDirectiveNoFileComp:4,ShellCompDirectiveFilterFileExt:8,ShellCompDirectiveFilterDirs:16,ShellCompDirectiveKeepOrder:32,ShellCompDirectiveDefault:0};var o$1=class o{name;variadic;command;handler;constructor(e,t,n,r=false){this.command=e,this.name=t,this.handler=n,this.variadic=r;}},s$1=class s{value;description;command;handler;alias;isBoolean;constructor(e,t,n,r,i,a){this.command=e,this.value=t,this.description=n,this.handler=r,this.alias=i,this.isBoolean=a;}},c$1=class c{value;description;options=new Map;arguments=new Map;parent;constructor(e,t){this.value=e,this.description=t;}option(e,t,n,r){let i,a,o;typeof n==`function`?(i=n,a=r,o=false):typeof n==`string`?(i=void 0,a=n,o=true):(i=void 0,a=void 0,o=true);let c=new s$1(this,e,t,i,a,o);return this.options.set(e,c),this}argument(e,t,n=false){let r=new o$1(this,e,t,n);return this.arguments.set(e,r),this}},l$1=class l extends c$1{commands=new Map;completions=[];directive=a.ShellCompDirectiveDefault;constructor(){super(``,``);}command(e,t){let n=new c$1(e,t);return this.commands.set(e,n),n}stripOptions(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.startsWith(`-`)){n++;let t=false,i=this.findOption(this,r);if(i)t=i.isBoolean??false;else for(let[,e]of this.commands){let n=this.findOption(e,r);if(n){t=n.isBoolean??false;break}}!t&&n<e.length&&!e[n].startsWith(`-`)&&n++;}else t.push(r),n++;}return t}matchCommand(e){e=this.stripOptions(e);let t=[],n=[],r=null;for(let i=0;i<e.length;i++){let a=e[i];t.push(a);let o=this.commands.get(t.join(` `));if(o)r=o;else {n=e.slice(i,e.length);break}}return [r||this,n]}shouldCompleteFlags(e,t){if(t.startsWith(`-`))return  true;if(e?.startsWith(`-`)){let t=this.findOption(this,e);if(!t){for(let[,n]of this.commands)if(t=this.findOption(n,e),t)break}return !(t&&t.isBoolean)}return  false}shouldCompleteCommands(e){return !e.startsWith(`-`)}handleFlagCompletion(e,t,n,r){let i;if(n.includes(`=`)){let[e]=n.split(`=`);i=e;}else if(r?.startsWith(`-`)){let t=this.findOption(e,r);t&&!t.isBoolean&&(i=r);}if(i){let t=this.findOption(e,i);if(t?.handler){let n=[];t.handler.call(t,(e,t)=>n.push({value:e,description:t}),e.options),this.completions=n;}return}if(n.startsWith(`-`)){let t=n.startsWith(`-`)&&!n.startsWith(`--`),r=n.replace(/^-+/,``);for(let[i,a]of e.options)t&&a.alias&&`-${a.alias}`.startsWith(n)?this.completions.push({value:`-${a.alias}`,description:a.description}):!t&&i.startsWith(r)&&this.completions.push({value:`--${i}`,description:a.description});}}findOption(e,t){let n=e.options.get(t);if(n||(n=e.options.get(t.replace(/^-+/,``)),n))return n;for(let[n,r]of e.options)if(r.alias&&`-${r.alias}`===t)return r}handleCommandCompletion(e,t){let n=this.stripOptions(e);for(let[e,r]of this.commands){if(e===``)continue;let i=e.split(` `);i.slice(0,n.length).every((e,t)=>e===n[t])&&i[n.length]?.startsWith(t)&&this.completions.push({value:i[n.length],description:r.description});}}handlePositionalCompletion(e,t){let n=this.stripOptions(t),r=e.value.split(` `).length,i=Math.max(0,n.length-r),a=Array.from(e.arguments.entries());if(a.length>0){let t;if(i<a.length){let[e,n]=a[i];t=n;}else {let e=a[a.length-1][1];e.variadic&&(t=e);}if(t&&t.handler&&typeof t.handler==`function`){let n=[];t.handler.call(t,(e,t)=>n.push({value:e,description:t}),e.options),this.completions.push(...n);}}}complete(e){this.directive=a.ShellCompDirectiveNoFileComp;let t=new Set;this.completions.filter(e=>t.has(e.value)?false:(t.add(e.value),true)).filter(t=>{if(e.includes(`=`)){let[,n]=e.split(`=`);return t.value.startsWith(n)}return t.value.startsWith(e)}).forEach(e=>console.log(`${e.value}\t${e.description??``}`)),console.log(`:${this.directive}`);}parse(e){this.completions=[];let t=e[e.length-1]===``;t&&e.pop();let n=e[e.length-1]||``,r=e.slice(0,-1);t&&(n!==``&&r.push(n),n=``);let[i]=this.matchCommand(r),a=r[r.length-1];this.shouldCompleteFlags(a,n)?this.handleFlagCompletion(i,r,n,a):(this.shouldCompleteCommands(n)&&this.handleCommandCompletion(r,n),i&&i.arguments.size>0&&this.handlePositionalCompletion(i,r)),this.complete(n);}setup(a,o,s){switch(assert(s===`zsh`||s===`bash`||s===`fish`||s===`powershell`,`Unsupported shell`),s){case `zsh`:{let t$1=t(a,o);console.log(t$1);break}case `bash`:{let e=n(a,o);console.log(e);break}case `fish`:{let e=r(a,o);console.log(e);break}case `powershell`:{let e=i(a,o);console.log(e);break}}}};const u=new l$1;
 
 function t(t,n){return `#compdef ${t}
 compdef _${t} ${t}
@@ -1382,7 +1397,7 @@ _${t}() {
 
     # Prepare the command to obtain completions, ensuring arguments are quoted for eval
     local -a args_to_quote=("\${(@)words[2,-1]}")
-    if [ "\${lastChar}" = "" ]; then
+    if [ "\${lastChar}" = "" ] && [ "\${args_to_quote[-1]}" != "" ]; then
         # If the last parameter is complete (there is a space following it)
         # We add an extra empty parameter so we can indicate this to the go completion code.
         __${t}_debug "Adding extra empty parameter"
@@ -1664,17 +1679,15 @@ function __${r}_perform_completion
 
     # Extract all args except the last one
     set -l args (commandline -opc)
-    # Extract the last arg and escape it in case it is a space or wildcard
-    set -l lastArg (string escape -- (commandline -ct))
+    # Extract the token currently being completed (may be empty on a trailing space)
+    set -l lastArg (commandline -ct)
 
     __${r}_debug "args: $args"
     __${r}_debug "last arg: $lastArg"
 
-    # Build the completion request command
-    set -l requestComp "${n} complete -- (string join ' ' -- (string escape -- $args[2..-1])) $lastArg"
-
-    __${r}_debug "Calling $requestComp"
-    set -l results (eval $requestComp 2> /dev/null)
+    # Pass each arg as its own token (no string join/eval, which would collapse multi-segment paths); quote "$lastArg" so an empty trailing token is still sent.
+    __${r}_debug "Calling ${n} complete -- $args[2..-1] $lastArg"
+    set -l results (${n} complete -- $args[2..-1] "$lastArg" 2> /dev/null)
 
     # Some programs may output extra empty lines after the directive.
     # Let's ignore them or else it will break completion.
@@ -1955,8 +1968,10 @@ complete -k -c ${t} -n '__${r}_requires_order_preservation && __${r}_prepare_com
         # Remove the flag part
         $Flag, $WordToComplete = $WordToComplete.Split("=", 2)
     }
-
-    if ( $WordToComplete -eq "" -And ( -Not $IsEqualFlag )) {
+    $HasTrailingEmptyArg = $QuotedArgs -match "(^| )''$"
+    __${t}_debug "HasTrailingEmptyArg: $HasTrailingEmptyArg"
+    
+    if ( $WordToComplete -eq "" -And ( -Not $IsEqualFlag ) -And ( -Not $HasTrailingEmptyArg )) {
         # If the last parameter is complete (there is a space following it)
         # We add an extra empty parameter so we can indicate this to the go method.
         __${t}_debug "Adding extra empty parameter"
@@ -2136,10 +2151,10 @@ Register-ArgumentCompleter -CommandName '${t}' -ScriptBlock $__${r}CompleterBloc
 
 function e(e=`cli`){if(process.argv.indexOf(`--`)===-1){let t=`Error: You need to use -- to separate completion arguments.\nExample: ${e} complete -- <args>`;console.error(t),process.exit(1);}}
 
-const o=process.execPath,s=process.argv.slice(1),c=f(o),l=s.map(f),u=`${c} ${process.execArgv.map(f).join(` `)} ${l[0]}`,d=/<[^>]+>|\[[^\]]+\]/;function f(e){return e.includes(` `)?`'${e}'`:e}async function p(c,l){for(let e of [c.globalCommand,...c.commands]){if(e.name===`complete`)continue;let t=(e.rawName.match(/\[.*?\]|<.*?>/g)||[]).map(e=>e.startsWith(`[`)),n=e.name===`@@global@@`,r=n?l:l?.subCommands?.[e.name],a=n?``:e.name,o=n?u$1:u$1.command(a,e.description||``);if(o){let n=(e.rawName.match(/<([^>]+)>|\[\.\.\.([^\]]+)\]/g)||[]).map(e=>e.startsWith(`<`)&&e.endsWith(`>`)?e.slice(1,-1):e.startsWith(`[...`)&&e.endsWith(`]`)?e.slice(4,-1):e);t.forEach((e,t)=>{let i=n[t]||`arg${t}`,a=r?.args?.[i];a?o.argument(i,a,e):o.argument(i,void 0,e);});}for(let t of [...c.globalCommand.options,...e.options]){let e=t.rawName.match(/^-([a-zA-Z]), --/)?.[1],a=t.name,s=n?u$1:o;if(s){let n=r?.options?.[a],i=t.required||d.test(t.rawName);n?e?s.option(a,t.description||``,n,e):s.option(a,t.description||``,n):i?e?s.option(a,t.description||``,async()=>[],e):s.option(a,t.description||``,async()=>[]):e?s.option(a,t.description||``,e):s.option(a,t.description||``);}}}return c.command(`complete [shell]`).action(async(l,d)=>{switch(l){case `zsh`:{let t$1=t(c.name,u);console.log(t$1);break}case `bash`:{let e=n(c.name,u);console.log(e);break}case `fish`:{let e=r(c.name,u);console.log(e);break}case `powershell`:{let e=i(c.name,u);console.log(e);break}default:{e(c.name);let e$1=d[`--`]||[];return c.showHelpOnExit=false,c.unsetMatchedCommand(),c.parse([o,s[0],...e$1],{run:false}),u$1.parse(e$1)}}}),u$1}
+const o=process.execPath,s=process.argv.slice(1),c=/<[^>]+>|\[[^\]]+\]/;async function l(l,u$1){for(let e of [l.globalCommand,...l.commands]){if(e.name===`complete`)continue;let t=(e.rawName.match(/\[.*?\]|<.*?>/g)||[]).map(e=>e.startsWith(`[`)),n=e.name===`@@global@@`,r=n?u$1:u$1?.subCommands?.[e.name],a=n?``:e.name,o=n?u:u.command(a,e.description||``);if(o){let n=(e.rawName.match(/<([^>]+)>|\[\.\.\.([^\]]+)\]/g)||[]).map(e=>e.startsWith(`<`)&&e.endsWith(`>`)?e.slice(1,-1):e.startsWith(`[...`)&&e.endsWith(`]`)?e.slice(4,-1):e);t.forEach((e,t)=>{let i=n[t]||`arg${t}`,a=r?.args?.[i];a?o.argument(i,a,e):o.argument(i,void 0,e);});}for(let t of [...l.globalCommand.options,...e.options]){let e=t.rawName.match(/^-([a-zA-Z]), --/)?.[1],a=t.name,s=n?u:o;if(s){let n=r?.options?.[a],i=t.required||c.test(t.rawName);n?e?s.option(a,t.description||``,n,e):s.option(a,t.description||``,n):i?e?s.option(a,t.description||``,async()=>[],e):s.option(a,t.description||``,async()=>[]):e?s.option(a,t.description||``,e):s.option(a,t.description||``);}}}return l.command(`complete [shell]`).action(async(c,u$1)=>{let d=l.name;switch(c){case `zsh`:{let t$1=t(l.name,d);console.log(t$1);break}case `bash`:{let e=n(l.name,d);console.log(e);break}case `fish`:{let e=r(l.name,d);console.log(e);break}case `powershell`:{let e=i(l.name,d);console.log(e);break}default:{e(l.name);let e$1=u$1[`--`]||[];return l.showHelpOnExit=false,l.unsetMatchedCommand(),l.parse([o,s[0],...e$1],{run:false}),u.parse(e$1)}}}),u}
 
 async function setupTabCompletions(cli) {
-	await p(cli, {
+	await l(cli, {
 		subCommands: {},
 		options: {
 			environment(complete) {
@@ -2273,6 +2288,7 @@ function createCLI(options = {}) {
 	cli.command("dev [...filters]", void 0, options).action(watch);
 	cli.command("bench [...filters]", void 0, options).action(benchmark);
 	cli.command("init <project>", void 0, options).action(init);
+	cli.command("doctor [...filters]", void 0, options).action(doctorCommand);
 	addCliOptions(cli.command("list [...filters]", void 0, options).action((filters, options) => collect(filters, options)), collectCliOptionsConfig);
 	cli.command("[...filters]", void 0, options).action((filters, options) => start(filters, options));
 	setupTabCompletions(cli);
@@ -2347,11 +2363,11 @@ function normalizeCliOptions(cliFilters, argv) {
 }
 async function start(cliFilters, options) {
 	try {
-		const { startVitest } = await import('./cli-api.bqNN5viV.js').then(function (n) { return n.a; });
+		const { startVitest } = await import('./cli-api.B4r6twmv.js').then(function (n) { return n.a; });
 		const ctx = await startVitest(cliFilters.map(normalize), normalizeCliOptions(cliFilters, options));
 		if (!ctx.shouldKeepServer()) await ctx.exit();
 	} catch (e) {
-		const { errorBanner } = await import('./utils.CO-iLyCr.js').then(function (n) { return n.u; });
+		const { errorBanner } = await import('./utils.DtdLoSPT.js').then(function (n) { return n.u; });
 		console.error(`\n${errorBanner("Startup Error")}`);
 		console.error(e);
 		console.error("\n\n");
@@ -2359,17 +2375,31 @@ async function start(cliFilters, options) {
 		process.exit();
 	}
 }
+async function doctorCommand(cliFilters, options) {
+	try {
+		const { doctor } = await import('./doctor.oxixVMjH.js');
+		await doctor(cliFilters.map(normalize), normalizeCliOptions(cliFilters, options));
+		process.exit();
+	} catch (e) {
+		const { errorBanner } = await import('./utils.DtdLoSPT.js').then(function (n) { return n.u; });
+		console.error(`\n${errorBanner("Doctor Error")}`);
+		console.error(e);
+		console.error("\n\n");
+		process.exitCode ??= 1;
+		process.exit();
+	}
+}
 async function init(project) {
 	if (project !== "browser") {
 		console.error(/* @__PURE__ */ new Error("Only the \"browser\" project is supported. Use \"vitest init browser\" to create a new project."));
 		process.exit(1);
 	}
-	const { create } = await import('./creator.BzMFaPC-.js');
+	const { create } = await import('./creator.BW8mSwbG.js');
 	await create();
 }
 async function collect(cliFilters, options) {
 	try {
-		const { prepareVitest, processCollected, outputFileList } = await import('./cli-api.bqNN5viV.js').then(function (n) { return n.a; });
+		const { prepareVitest, processCollected, outputFileList } = await import('./cli-api.B4r6twmv.js').then(function (n) { return n.a; });
 		const ctx = await prepareVitest({
 			...normalizeCliOptions(cliFilters, options),
 			watch: false,
@@ -2391,7 +2421,7 @@ async function collect(cliFilters, options) {
 		} else outputFileList(await ctx.getRelevantTestSpecifications(cliFilters.map(normalize)), options);
 		await ctx.close();
 	} catch (e) {
-		const { errorBanner } = await import('./utils.CO-iLyCr.js').then(function (n) { return n.u; });
+		const { errorBanner } = await import('./utils.DtdLoSPT.js').then(function (n) { return n.u; });
 		console.error(`\n${errorBanner("Collect Error")}`);
 		console.error(e);
 		console.error("\n\n");