vitest 3.2.0-beta.2 → 3.2.0-beta.3

package/dist/config.cjs

@@ -4,6 +4,7 @@ var os = require('node:os');
 var stdEnv = require('std-env');
 var vite = require('vite');
 
+// if changed, update also jsdocs and docs
 const defaultBrowserPort = 63315;
 const extraInlineDeps = [
 	/^(?!.*node_modules).*\.mjs$/,
@@ -43,6 +44,7 @@ const defaultCoverageExcludes = [
 	"**/vitest.{workspace,projects}.[jt]s?(on)",
 	"**/.{eslint,mocha,prettier}rc.{?(c|m)js,yml}"
 ];
+// These are the generic defaults for coverage. Providers may also set some provider specific defaults.
 const coverageConfigDefaults = {
 	provider: "v8",
 	enabled: false,

package/dist/config.d.ts

@@ -1,18 +1,18 @@
 import { UserConfig as UserConfig$1, ConfigEnv } from 'vite';
 export { ConfigEnv, Plugin, UserConfig as ViteUserConfig, mergeConfig } from 'vite';
-import { c as CoverageV8Options, R as ResolvedCoverageOptions, U as UserWorkspaceConfig, d as UserProjectConfigFn, e as UserProjectConfigExport, b as TestProjectConfiguration } from './chunks/reporters.d.CLC9rhKy.js';
-export { f as TestProjectInlineConfiguration, g as WatcherTriggerPattern, W as WorkspaceProjectConfiguration } from './chunks/reporters.d.CLC9rhKy.js';
-import './chunks/vite.d.CBZ3M_ru.js';
-import { F as FakeTimerInstallOpts } from './chunks/config.d.UqE-KR0o.js';
+import { c as CoverageV8Options, R as ResolvedCoverageOptions, U as UserWorkspaceConfig, d as UserProjectConfigFn, e as UserProjectConfigExport, b as TestProjectConfiguration } from './chunks/reporters.d.Bt4IGtsa.js';
+export { f as TestProjectInlineConfiguration, g as WatcherTriggerPattern, W as WorkspaceProjectConfiguration } from './chunks/reporters.d.Bt4IGtsa.js';
+import './chunks/vite.d.B-Kx3KCF.js';
+import { F as FakeTimerInstallOpts } from './chunks/config.d.D2ROskhv.js';
 import '@vitest/runner';
-import './chunks/environment.d.D8YDy2v5.js';
+import './chunks/environment.d.cL3nLXbE.js';
 import 'vitest/optional-types.js';
 import '@vitest/utils';
 import 'node:stream';
 import 'node:console';
 import '@vitest/mocker';
 import '@vitest/utils/source-map';
-import './chunks/worker.d.CoCI7hzP.js';
+import './chunks/worker.d.BKbBp2ga.js';
 import 'vite-node';
 import '@vitest/snapshot';
 import '@vitest/pretty-format';
@@ -32,6 +32,7 @@ declare const extraInlineDeps: RegExp[];
 
 declare const defaultInclude: string[];
 declare const defaultExclude: string[];
+// These are the generic defaults for coverage. Providers may also set some provider specific defaults.
 declare const coverageConfigDefaults: ResolvedCoverageOptions;
 declare const configDefaults: Readonly<{
 	allowOnly: boolean

package/dist/config.js

@@ -1,5 +1,5 @@
-export { d as defaultBrowserPort, e as extraInlineDeps } from './chunks/constants.BZZyIeIE.js';
-export { c as configDefaults, a as coverageConfigDefaults, d as defaultExclude, b as defaultInclude } from './chunks/defaults.DSxsTG0h.js';
+export { d as defaultBrowserPort, e as extraInlineDeps } from './chunks/constants.DnKduX2e.js';
+export { c as configDefaults, a as coverageConfigDefaults, d as defaultExclude, b as defaultInclude } from './chunks/defaults.DpVH7vbg.js';
 export { mergeConfig } from 'vite';
 import 'node:os';
 import './chunks/env.Dq0hM4Xv.js';

package/dist/coverage.d.ts

@@ -1,15 +1,15 @@
-import { R as ResolvedCoverageOptions, V as Vitest, C as CoverageMap, a as ReportContext } from './chunks/reporters.d.CLC9rhKy.js';
+import { R as ResolvedCoverageOptions, V as Vitest, C as CoverageMap, a as ReportContext } from './chunks/reporters.d.Bt4IGtsa.js';
 import { TransformResult } from 'vite';
-import { A as AfterSuiteRunMeta } from './chunks/environment.d.D8YDy2v5.js';
+import { A as AfterSuiteRunMeta } from './chunks/environment.d.cL3nLXbE.js';
 import '@vitest/runner';
 import '@vitest/utils';
 import 'node:stream';
 import 'node:console';
 import '@vitest/mocker';
 import '@vitest/utils/source-map';
-import './chunks/worker.d.CoCI7hzP.js';
+import './chunks/worker.d.BKbBp2ga.js';
 import 'vite-node';
-import './chunks/config.d.UqE-KR0o.js';
+import './chunks/config.d.D2ROskhv.js';
 import '@vitest/pretty-format';
 import '@vitest/snapshot';
 import '@vitest/snapshot/environment';

package/dist/coverage.js

@@ -1,9 +1,9 @@
-export { B as BaseCoverageProvider } from './chunks/coverage.OGU09Jbh.js';
+export { B as BaseCoverageProvider } from './chunks/coverage.C73DaDgS.js';
 import 'node:fs';
 import 'pathe';
 import 'picomatch';
 import 'tinyrainbow';
-import './chunks/defaults.DSxsTG0h.js';
+import './chunks/defaults.DpVH7vbg.js';
 import 'node:os';
 import './chunks/env.Dq0hM4Xv.js';
 import 'std-env';
@@ -17,13 +17,13 @@ import 'node:url';
 import 'node:assert';
 import 'node:v8';
 import 'node:util';
-import './chunks/constants.BZZyIeIE.js';
-import 'node:tty';
 import 'vite';
+import './chunks/constants.DnKduX2e.js';
+import 'node:tty';
 import 'node:events';
 import './chunks/index.CJ0plNrh.js';
 import 'tinypool';
-import './chunks/typechecker.DnTrplSJ.js';
+import './chunks/typechecker.BgzF-6iO.js';
 import 'node:perf_hooks';
 import '@vitest/utils/source-map';
 import 'tinyexec';

package/dist/environments.d.ts

@@ -1,5 +1,5 @@
-import { E as Environment } from './chunks/environment.d.D8YDy2v5.js';
-export { a as EnvironmentReturn, V as VmEnvironmentReturn } from './chunks/environment.d.D8YDy2v5.js';
+import { E as Environment } from './chunks/environment.d.cL3nLXbE.js';
+export { a as EnvironmentReturn, V as VmEnvironmentReturn } from './chunks/environment.d.cL3nLXbE.js';
 import 'vitest/optional-types.js';
 
 declare const environments: {
@@ -10,6 +10,10 @@ declare const environments: {
 };
 
 interface PopulateOptions {
+	// we bind functions such as addEventListener and others
+	// because they rely on `this` in happy-dom, and in jsdom it
+	// has a priority for getting implementation from symbols
+	// (global doesn't have these symbols, but window - does)
 	bindFunctions?: boolean;
 	additionalKeys?: string[];
 }

package/dist/environments.js

@@ -1,2 +1,2 @@
-export { e as builtinEnvironments, p as populateGlobal } from './chunks/index.DFXFpH3w.js';
+export { e as builtinEnvironments, p as populateGlobal } from './chunks/index.2jgTs_Q5.js';
 import 'node:console';

package/dist/execute.d.ts

@@ -1,16 +1,16 @@
 import { ViteNodeRunnerOptions } from 'vite-node';
 import { ViteNodeRunner, ModuleExecutionInfo } from 'vite-node/client';
-import { R as RuntimeRPC, W as WorkerGlobalState } from './chunks/worker.d.CoCI7hzP.js';
+import { R as RuntimeRPC, W as WorkerGlobalState } from './chunks/worker.d.BKbBp2ga.js';
 import vm from 'node:vm';
 import { MockedModule, MockedModuleType } from '@vitest/mocker';
 import { P as PendingSuiteMock, b as MockFactory, a as MockOptions } from './chunks/mocker.d.BE_2ls6u.js';
 import '@vitest/runner';
-import './chunks/config.d.UqE-KR0o.js';
+import './chunks/config.d.D2ROskhv.js';
 import '@vitest/pretty-format';
 import '@vitest/snapshot';
 import '@vitest/snapshot/environment';
 import '@vitest/utils/diff';
-import './chunks/environment.d.D8YDy2v5.js';
+import './chunks/environment.d.cL3nLXbE.js';
 import 'vitest/optional-types.js';
 
 declare class FileMap {
@@ -21,6 +21,8 @@ declare class FileMap {
 	readBuffer(path: string): Buffer;
 }
 
+// need to copy paste types for vm
+// because they require latest @types/node which we don't bundle
 interface ModuleEvaluateOptions {
 	timeout?: vm.RunningScriptOptions["timeout"] | undefined;
 	breakOnSigint?: vm.RunningScriptOptions["breakOnSigint"] | undefined;
@@ -48,6 +50,7 @@ interface ExternalModulesExecutorOptions {
 	interopDefault?: boolean;
 	viteClientModule: Record<string, unknown>;
 }
+// TODO: improve Node.js strict mode support in #2854
 declare class ExternalModulesExecutor {
 	#private;
 	private options;
@@ -61,6 +64,7 @@ declare class ExternalModulesExecutor {
 	import(identifier: string): Promise<object>;
 	require(identifier: string): any;
 	createRequire(identifier: string): NodeJS.Require;
+	// dynamic import can be used in both ESM and CJS, so we have it in the executor
 	importModuleDynamically: (specifier: string, referencer: VMModule) => Promise<VMModule>;
 	resolveModule: (specifier: string, referencer: string) => Promise<VMModule>;
 	resolve(specifier: string, parent: string): string;
@@ -98,7 +102,9 @@ declare class VitestMocker {
 	private resolvePath;
 	resolveMocks(): Promise<void>;
 	private callFunctionMock;
+	// public method to avoid circular dependency
 	getMockContext(): MockContext;
+	// path used to store mocked dependencies
 	getMockPath(dep: string): string;
 	getDependencyMock(id: string): MockedModule | undefined;
 	normalizePath(path: string): string;

package/dist/execute.js

@@ -1,4 +1,4 @@
-export { V as VitestExecutor } from './chunks/execute.JlGHLJZT.js';
+export { V as VitestExecutor } from './chunks/execute.B3q-2LPV.js';
 import 'node:fs';
 import 'node:url';
 import 'node:vm';

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 import { File as File$1, TaskResultPack as TaskResultPack$1, TaskEventPack, TaskPopulated, Suite as Suite$1, Test as Test$1, Custom as Custom$1, Task as Task$1, TaskBase as TaskBase$1, TaskResult as TaskResult$1, DoneCallback as DoneCallback$1, RuntimeContext as RuntimeContext$1, SuiteHooks as SuiteHooks$1, SequenceHooks as SequenceHooks$1, SequenceSetupFiles as SequenceSetupFiles$1 } from '@vitest/runner';
 export { CancelReason, ExtendedContext, HookCleanupCallback, HookListener, OnTestFailedHandler, OnTestFinishedHandler, RunMode, Custom as RunnerCustomCase, Task as RunnerTask, TaskBase as RunnerTaskBase, TaskEventPack as RunnerTaskEventPack, TaskResult as RunnerTaskResult, TaskResultPack as RunnerTaskResultPack, Test as RunnerTestCase, File as RunnerTestFile, Suite as RunnerTestSuite, SuiteAPI, SuiteCollector, SuiteFactory, TaskContext, TaskCustomOptions, TaskMeta, TaskState, TestAPI, TestContext, TestFunction, TestOptions, afterAll, afterEach, beforeAll, beforeEach, describe, it, onTestFailed, onTestFinished, suite, test } from '@vitest/runner';
-import { S as SerializedTestSpecification, h as CoverageProvider$1, a as ReportContext$1, i as CoverageProviderModule$1, j as CoverageReporter$1, k as CoverageProviderName, l as CoverageOptions$1, R as ResolvedCoverageOptions$1, B as BaseCoverageOptions$1, m as CoverageIstanbulOptions$1, c as CoverageV8Options$1, n as CustomProviderOptions$1, o as Reporter$1, V as Vitest$1, p as BrowserScript$1, q as BrowserConfigOptions$1, r as BuiltinEnvironment$1, s as VitestEnvironment$1, P as Pool$1, t as PoolOptions$1, u as CSSModuleScopeStrategy$1, A as ApiConfig$1, v as VitestRunMode$1, D as DepsOptimizationOptions$1, w as TransformModePatterns$1, I as InlineConfig$1, x as TypecheckConfig$1, y as UserConfig$1, z as ResolvedConfig$1, E as ProjectConfig$1, U as UserWorkspaceConfig$1, F as BenchmarkUserOptions$1 } from './chunks/reporters.d.CLC9rhKy.js';
-export { G as BrowserTesterOptions } from './chunks/reporters.d.CLC9rhKy.js';
-import { W as WorkerContext$1 } from './chunks/worker.d.D5Xdi-Zr.js';
-import { R as RawErrsMap$1, T as TscErrorInfo$1, C as CollectLineNumbers$1, a as CollectLines$1, b as RootAndTarget$1, c as Context$1 } from './chunks/global.d.BPa1eL3O.js';
-import { b as Awaitable$1, U as UserConsoleLog, L as LabelColor, M as ModuleGraphData, P as ProvidedContext, N as Nullable$1, c as Arrayable$1, d as ArgumentsType$1, e as MutableArray$1, C as Constructable$1, a as EnvironmentReturn$1, V as VmEnvironmentReturn$1, E as Environment$1, R as ResolvedTestEnvironment$1, J as JSDOMOptions$1, H as HappyDOMOptions$1, f as EnvironmentOptions$1 } from './chunks/environment.d.D8YDy2v5.js';
-export { A as AfterSuiteRunMeta, g as ModuleCache } from './chunks/environment.d.D8YDy2v5.js';
-import { a as BirpcReturn, b as WorkerRPC$1 } from './chunks/worker.d.CoCI7hzP.js';
-export { C as ContextRPC, d as ContextTestEnvironment, e as ResolveIdFunction, c as RunnerRPC, R as RuntimeRPC, T as TestExecutionMethod, W as WorkerGlobalState } from './chunks/worker.d.CoCI7hzP.js';
-import './chunks/vite.d.CBZ3M_ru.js';
-import { a as SerializedConfig, F as FakeTimerInstallOpts, R as RuntimeOptions } from './chunks/config.d.UqE-KR0o.js';
-export { b as RuntimeConfig, S as SerializedCoverageConfig } from './chunks/config.d.UqE-KR0o.js';
+import { S as SerializedTestSpecification, h as CoverageProvider$1, a as ReportContext$1, i as CoverageProviderModule$1, j as CoverageReporter$1, k as CoverageProviderName, l as CoverageOptions$1, R as ResolvedCoverageOptions$1, B as BaseCoverageOptions$1, m as CoverageIstanbulOptions$1, c as CoverageV8Options$1, n as CustomProviderOptions$1, o as Reporter$1, V as Vitest$1, p as BrowserScript$1, q as BrowserConfigOptions$1, r as BuiltinEnvironment$1, s as VitestEnvironment$1, P as Pool$1, t as PoolOptions$1, u as CSSModuleScopeStrategy$1, A as ApiConfig$1, v as VitestRunMode$1, D as DepsOptimizationOptions$1, w as TransformModePatterns$1, I as InlineConfig$1, x as TypecheckConfig$1, y as UserConfig$1, z as ResolvedConfig$1, E as ProjectConfig$1, U as UserWorkspaceConfig$1, F as BenchmarkUserOptions$1 } from './chunks/reporters.d.Bt4IGtsa.js';
+export { G as BrowserTesterOptions } from './chunks/reporters.d.Bt4IGtsa.js';
+import { W as WorkerContext$1 } from './chunks/worker.d.Bl1O4kuf.js';
+import { R as RawErrsMap$1, T as TscErrorInfo$1, C as CollectLineNumbers$1, a as CollectLines$1, b as RootAndTarget$1, c as Context$1 } from './chunks/global.d.BNLIi6yo.js';
+import { b as Awaitable$1, U as UserConsoleLog, L as LabelColor, M as ModuleGraphData, P as ProvidedContext, N as Nullable$1, c as Arrayable$1, d as ArgumentsType$1, e as MutableArray$1, C as Constructable$1, a as EnvironmentReturn$1, V as VmEnvironmentReturn$1, E as Environment$1, R as ResolvedTestEnvironment$1, J as JSDOMOptions$1, H as HappyDOMOptions$1, f as EnvironmentOptions$1 } from './chunks/environment.d.cL3nLXbE.js';
+export { A as AfterSuiteRunMeta, g as ModuleCache } from './chunks/environment.d.cL3nLXbE.js';
+import { a as BirpcReturn, b as WorkerRPC$1 } from './chunks/worker.d.BKbBp2ga.js';
+export { C as ContextRPC, d as ContextTestEnvironment, e as ResolveIdFunction, c as RunnerRPC, R as RuntimeRPC, T as TestExecutionMethod, W as WorkerGlobalState } from './chunks/worker.d.BKbBp2ga.js';
+import './chunks/vite.d.B-Kx3KCF.js';
+import { a as SerializedConfig, F as FakeTimerInstallOpts, R as RuntimeOptions } from './chunks/config.d.D2ROskhv.js';
+export { b as RuntimeConfig, S as SerializedCoverageConfig } from './chunks/config.d.D2ROskhv.js';
 import { ExpectStatic } from '@vitest/expect';
-export { Assertion, AsymmetricMatchersContaining, ExpectPollOptions, ExpectStatic, JestAssertion } from '@vitest/expect';
+export { Assertion, AsymmetricMatchersContaining, ExpectPollOptions, ExpectStatic, JestAssertion, Matchers } from '@vitest/expect';
 import { spyOn, fn, MaybeMockedDeep, MaybeMocked, MaybePartiallyMocked, MaybePartiallyMockedDeep, MockInstance } from '@vitest/spy';
 export { Mock, MockContext, MockInstance, Mocked, MockedClass, MockedFunction, MockedObject } from '@vitest/spy';
 import { M as MockFactoryWithHelper, a as MockOptions } from './chunks/mocker.d.BE_2ls6u.js';
@@ -68,6 +68,7 @@ interface WebSocketHandlers {
 	getTestFiles: () => Promise<SerializedTestSpecification[]>;
 	getPaths: () => string[];
 	getConfig: () => SerializedConfig;
+	// TODO: Remove in v4
 	/** @deprecated -- Use `getResolvedProjectLabels` instead */
 	getResolvedProjectNames: () => string[];
 	getResolvedProjectLabels: () => {
@@ -94,6 +95,8 @@ interface WebSocketEvents {
 }
 type WebSocketRPC = BirpcReturn<WebSocketEvents, WebSocketHandlers>;
 
+// CI fails only for this file, but it works locally
+
 declare function createExpect(test?: TaskPopulated): ExpectStatic;
 declare const globalExpect: ExpectStatic;
 
@@ -103,6 +106,7 @@ declare const globalExpect: ExpectStatic;
 */
 declare function inject<T extends keyof ProvidedContext & string>(key: T): ProvidedContext[T];
 
+// The waitFor function was inspired by https://github.com/testing-library/web-testing-library/pull/2
 type WaitForCallback<T> = () => T | Promise<T>;
 interface WaitForOptions {
 	/**
@@ -295,7 +299,9 @@ interface VitestUtils {
 	* @param path Path to the module. Can be aliased, if your Vitest config supports it
 	* @param factory Mocked module factory. The result of this function will be an exports object
 	*/
+	// eslint-disable-next-line ts/method-signature-style
 	mock(path: string, factory?: MockFactoryWithHelper | MockOptions): void;
+	// eslint-disable-next-line ts/method-signature-style
 	mock<T>(module: Promise<T>, factory?: MockFactoryWithHelper<T> | MockOptions): void;
 	/**
 	* Removes module from mocked registry. All calls to import will return the original module even if it was mocked before.
@@ -303,7 +309,9 @@ interface VitestUtils {
 	* This call is hoisted to the top of the file, so it will only unmock modules that were defined in `setupFiles`, for example.
 	* @param path Path to the module. Can be aliased, if your Vitest config supports it
 	*/
+	// eslint-disable-next-line ts/method-signature-style
 	unmock(path: string): void;
+	// eslint-disable-next-line ts/method-signature-style
 	unmock(module: Promise<unknown>): void;
 	/**
 	* Mocks every subsequent [dynamic import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import) call.
@@ -314,7 +322,9 @@ interface VitestUtils {
 	* @param path Path to the module. Can be aliased, if your Vitest config supports it
 	* @param factory Mocked module factory. The result of this function will be an exports object
 	*/
+	// eslint-disable-next-line ts/method-signature-style
 	doMock(path: string, factory?: MockFactoryWithHelper | MockOptions): void;
+	// eslint-disable-next-line ts/method-signature-style
 	doMock<T>(module: Promise<T>, factory?: MockFactoryWithHelper<T> | MockOptions): void;
 	/**
 	* Removes module from mocked registry. All subsequent calls to import will return original module.
@@ -322,7 +332,9 @@ interface VitestUtils {
 	* Unlike [`vi.unmock`](https://vitest.dev/api/vi#vi-unmock), this method is not hoisted to the top of the file.
 	* @param path Path to the module. Can be aliased, if your Vitest config supports it
 	*/
+	// eslint-disable-next-line ts/method-signature-style
 	doUnmock(path: string): void;
+	// eslint-disable-next-line ts/method-signature-style
 	doUnmock(module: Promise<unknown>): void;
 	/**
 	* Imports module, bypassing all checks if it should be mocked.

package/dist/index.js

@@ -1,6 +1,6 @@
-export { c as createExpect, a as expect, i as inject, v as vi, b as vitest } from './chunks/vi.BFR5YIgu.js';
-export { b as bench } from './chunks/benchmark.BoF7jW0Q.js';
-export { a as assertType } from './chunks/index.CfXMNXHg.js';
+export { c as createExpect, a as expect, i as inject, v as vi, b as vitest } from './chunks/vi.pkoYCV6A.js';
+export { b as bench } from './chunks/benchmark.Cf_PACH1.js';
+export { a as assertType } from './chunks/index.DNgLEKsQ.js';
 export { expectTypeOf } from 'expect-type';
 export { afterAll, afterEach, beforeAll, beforeEach, describe, it, onTestFailed, onTestFinished, suite, test } from '@vitest/runner';
 import * as chai from 'chai';
@@ -8,11 +8,11 @@ export { chai };
 export { assert, should } from 'chai';
 import '@vitest/expect';
 import '@vitest/runner/utils';
-import './chunks/utils.CgTj3MsC.js';
+import './chunks/utils.BlI4TC7Y.js';
 import '@vitest/utils';
 import './chunks/_commonjsHelpers.BFTU3MAI.js';
 import '@vitest/snapshot';
 import '@vitest/utils/error';
 import '@vitest/spy';
 import '@vitest/utils/source-map';
-import './chunks/date.CDOsz-HY.js';
+import './chunks/date.ByMsSlOr.js';

package/dist/node.d.ts

@@ -1,21 +1,21 @@
-import { z as ResolvedConfig, y as UserConfig, v as VitestRunMode, H as VitestOptions, V as Vitest, A as ApiConfig, T as TestProject, J as TestSequencer, K as TestSpecification, L as Logger, M as TestModule, N as ModuleDiagnostic } from './chunks/reporters.d.CLC9rhKy.js';
-export { B as BaseCoverageOptions, F as BenchmarkUserOptions, ag as BrowserBuiltinProvider, ah as BrowserCommand, ai as BrowserCommandContext, q as BrowserConfigOptions, aj as BrowserInstanceOption, ak as BrowserModuleMocker, al as BrowserOrchestrator, am as BrowserProvider, an as BrowserProviderInitializationOptions, ao as BrowserProviderModule, ap as BrowserProviderOptions, p as BrowserScript, aq as BrowserServerState, ar as BrowserServerStateSession, r as BuiltinEnvironment, as as CDPSession, u as CSSModuleScopeStrategy, m as CoverageIstanbulOptions, l as CoverageOptions, h as CoverageProvider, i as CoverageProviderModule, j as CoverageReporter, c as CoverageV8Options, n as CustomProviderOptions, D as DepsOptimizationOptions, a0 as HTMLOptions, I as InlineConfig, a2 as JUnitOptions, a1 as JsonOptions, O as OnServerRestartHandler, Q as OnTestsRerunHandler, at as ParentProjectBrowser, P as Pool, t as PoolOptions, Y as ProcessPool, au as ProjectBrowser, E as ProjectConfig, a as ReportContext, aA as ReportedHookContext, o as Reporter, ax as ResolveSnapshotPathHandler, ay as ResolveSnapshotPathHandlerContext, av as ResolvedBrowserOptions, R as ResolvedCoverageOptions, aw as ResolvedProjectConfig, $ as SerializedTestProject, a3 as TaskOptions, a4 as TestCase, a5 as TestCollection, a6 as TestDiagnostic, a7 as TestModuleState, a8 as TestResult, a9 as TestResultFailed, aa as TestResultPassed, ab as TestResultSkipped, aB as TestRunEndReason, az as TestRunResult, af as TestSequencerConstructor, ac as TestState, ad as TestSuite, ae as TestSuiteState, w as TransformModePatterns, x as TypecheckConfig, U as UserWorkspaceConfig, s as VitestEnvironment, X as VitestPackageInstaller, g as WatcherTriggerPattern, Z as WorkspaceSpec, _ as getFilePoolName } from './chunks/reporters.d.CLC9rhKy.js';
+import { z as ResolvedConfig, y as UserConfig, v as VitestRunMode, H as VitestOptions, V as Vitest, A as ApiConfig, T as TestProject, J as TestSequencer, K as TestSpecification, L as Logger, M as TestModule, N as ModuleDiagnostic } from './chunks/reporters.d.Bt4IGtsa.js';
+export { B as BaseCoverageOptions, F as BenchmarkUserOptions, ag as BrowserBuiltinProvider, ah as BrowserCommand, ai as BrowserCommandContext, q as BrowserConfigOptions, aj as BrowserInstanceOption, ak as BrowserModuleMocker, al as BrowserOrchestrator, am as BrowserProvider, an as BrowserProviderInitializationOptions, ao as BrowserProviderModule, ap as BrowserProviderOptions, p as BrowserScript, aq as BrowserServerState, ar as BrowserServerStateSession, r as BuiltinEnvironment, as as CDPSession, u as CSSModuleScopeStrategy, m as CoverageIstanbulOptions, l as CoverageOptions, h as CoverageProvider, i as CoverageProviderModule, j as CoverageReporter, c as CoverageV8Options, n as CustomProviderOptions, D as DepsOptimizationOptions, a0 as HTMLOptions, I as InlineConfig, a2 as JUnitOptions, a1 as JsonOptions, O as OnServerRestartHandler, Q as OnTestsRerunHandler, at as ParentProjectBrowser, P as Pool, t as PoolOptions, Y as ProcessPool, au as ProjectBrowser, E as ProjectConfig, a as ReportContext, aA as ReportedHookContext, o as Reporter, ax as ResolveSnapshotPathHandler, ay as ResolveSnapshotPathHandlerContext, av as ResolvedBrowserOptions, R as ResolvedCoverageOptions, aw as ResolvedProjectConfig, $ as SerializedTestProject, a3 as TaskOptions, a4 as TestCase, a5 as TestCollection, a6 as TestDiagnostic, a7 as TestModuleState, a8 as TestResult, a9 as TestResultFailed, aa as TestResultPassed, ab as TestResultSkipped, aB as TestRunEndReason, az as TestRunResult, af as TestSequencerConstructor, ac as TestState, ad as TestSuite, ae as TestSuiteState, w as TransformModePatterns, x as TypecheckConfig, U as UserWorkspaceConfig, s as VitestEnvironment, X as VitestPackageInstaller, g as WatcherTriggerPattern, Z as WorkspaceSpec, _ as getFilePoolName } from './chunks/reporters.d.Bt4IGtsa.js';
 import { InlineConfig, UserConfig as UserConfig$1, Plugin, ResolvedConfig as ResolvedConfig$1, LogLevel, LoggerOptions, Logger as Logger$1, createServer as createServer$1 } from 'vite';
 import * as vite from 'vite';
 export { vite as Vite };
 export { esbuildVersion, isFileServingAllowed, parseAst, parseAstAsync, rollupVersion, version as viteVersion } from 'vite';
 import { IncomingMessage } from 'node:http';
-import { R as RuntimeRPC } from './chunks/worker.d.CoCI7hzP.js';
-export { T as TestExecutionType } from './chunks/worker.d.CoCI7hzP.js';
+import { R as RuntimeRPC } from './chunks/worker.d.BKbBp2ga.js';
+export { T as TestExecutionType } from './chunks/worker.d.BKbBp2ga.js';
 import { Writable } from 'node:stream';
-export { V as VitestPluginContext } from './chunks/vite.d.CBZ3M_ru.js';
-export { W as WorkerContext } from './chunks/worker.d.D5Xdi-Zr.js';
-export { C as TypeCheckCollectLineNumbers, a as TypeCheckCollectLines, c as TypeCheckContext, T as TypeCheckErrorInfo, R as TypeCheckRawErrorsMap, b as TypeCheckRootAndTarget } from './chunks/global.d.BPa1eL3O.js';
+export { V as VitestPluginContext } from './chunks/vite.d.B-Kx3KCF.js';
+export { W as WorkerContext } from './chunks/worker.d.Bl1O4kuf.js';
+export { C as TypeCheckCollectLineNumbers, a as TypeCheckCollectLines, c as TypeCheckContext, T as TypeCheckErrorInfo, R as TypeCheckRawErrorsMap, b as TypeCheckRootAndTarget } from './chunks/global.d.BNLIi6yo.js';
 import { Debugger } from 'debug';
 export { Task as RunnerTask, TaskResult as RunnerTaskResult, TaskResultPack as RunnerTaskResultPack, Test as RunnerTestCase, File as RunnerTestFile, Suite as RunnerTestSuite, SequenceHooks, SequenceSetupFiles } from '@vitest/runner';
-export { f as EnvironmentOptions, H as HappyDOMOptions, J as JSDOMOptions } from './chunks/environment.d.D8YDy2v5.js';
+export { f as EnvironmentOptions, H as HappyDOMOptions, J as JSDOMOptions } from './chunks/environment.d.cL3nLXbE.js';
 export { SerializedError } from '@vitest/utils';
-export { b as RuntimeConfig } from './chunks/config.d.UqE-KR0o.js';
+export { b as RuntimeConfig } from './chunks/config.d.D2ROskhv.js';
 export { generateFileHash } from '@vitest/runner/utils';
 import 'node:console';
 import '@vitest/mocker';
@@ -96,8 +96,9 @@ declare class GitNotFoundError extends Error {
 /** @deprecated use `TestProject` instead */
 type GlobalSetupContext = TestProject;
 
-declare function VitestPlugin(options?: UserConfig, ctx?: Vitest): Promise<Plugin[]>;
+declare function VitestPlugin(options?: UserConfig, vitest?: Vitest): Promise<Plugin[]>;
 
+// this is only exported as a public function and not used inside vitest
 declare function resolveConfig(options?: UserConfig, viteOverrides?: UserConfig$1): Promise<{
 	vitestConfig: ResolvedConfig
 	viteConfig: ResolvedConfig$1
@@ -107,6 +108,7 @@ declare function resolveFsAllow(projectRoot: string, rootConfigFile: string | fa
 
 interface MethodsOptions {
 	cacheFs?: boolean;
+	// do not report files
 	collect?: boolean;
 }
 declare function createMethodsRPC(project: TestProject, options?: MethodsOptions): RuntimeRPC;
@@ -114,12 +116,18 @@ declare function createMethodsRPC(project: TestProject, options?: MethodsOptions
 declare class BaseSequencer implements TestSequencer {
 	protected ctx: Vitest;
 	constructor(ctx: Vitest);
+	// async so it can be extended by other sequelizers
 	shard(files: TestSpecification[]): Promise<TestSpecification[]>;
+	// async so it can be extended by other sequelizers
 	sort(files: TestSpecification[]): Promise<TestSpecification[]>;
 }
 
 declare function registerConsoleShortcuts(ctx: Vitest, stdin: NodeJS.ReadStream | undefined, stdout: NodeJS.WriteStream | Writable): () => void;
 
+// This is copy-pasted and needs to be synced from time to time. Ideally, Vite's `createLogger` should accept a custom `console`
+// https://github.com/vitejs/vite/blob/main/packages/vite/src/node/logger.ts?rgh-link-date=2024-10-16T23%3A29%3A19Z
+// When Vitest supports only Vite 6 and above, we can use Vite's `createLogger({ console })`
+// https://github.com/vitejs/vite/pull/18379
 declare function createViteLogger(console: Logger, level?: LogLevel, options?: LoggerOptions): Logger$1;
 
 declare const rootDir: string;

package/dist/node.js

@@ -1,14 +1,14 @@
 import { resolveConfig as resolveConfig$1, mergeConfig, createServer as createServer$1 } from 'vite';
 export { esbuildVersion, isFileServingAllowed, parseAst, parseAstAsync, rollupVersion, version as viteVersion } from 'vite';
-import { V as Vitest, a as VitestPlugin, T as TestModule } from './chunks/cli-api.d6IK1pnk.js';
-export { G as GitNotFoundError, F as TestsNotFoundError, b as VitestPackageInstaller, e as createViteLogger, c as createVitest, i as isValidApiRequest, d as registerConsoleShortcuts, r as resolveFsAllow, s as startVitest } from './chunks/cli-api.d6IK1pnk.js';
-export { p as parseCLI } from './chunks/cac.I9MLYfT-.js';
-import { r as resolveConfig$2 } from './chunks/coverage.OGU09Jbh.js';
-export { b as BaseSequencer, c as createMethodsRPC, g as getFilePoolName, a as resolveApiServerConfig } from './chunks/coverage.OGU09Jbh.js';
-import { slash } from '@vitest/utils';
+import { V as Vitest, a as VitestPlugin, T as TestModule } from './chunks/cli-api.CnmEXkxs.js';
+export { G as GitNotFoundError, F as TestsNotFoundError, b as VitestPackageInstaller, e as createViteLogger, c as createVitest, i as isValidApiRequest, d as registerConsoleShortcuts, r as resolveFsAllow, s as startVitest } from './chunks/cli-api.CnmEXkxs.js';
+export { p as parseCLI } from './chunks/cac.DWaWHIIE.js';
+import { r as resolveConfig$2 } from './chunks/coverage.C73DaDgS.js';
+export { b as BaseSequencer, c as createMethodsRPC, g as getFilePoolName, a as resolveApiServerConfig } from './chunks/coverage.C73DaDgS.js';
+import { slash, deepClone } from '@vitest/utils';
 import { f as findUp } from './chunks/index.X0nbfr6-.js';
 import { resolve } from 'pathe';
-import { c as configFiles } from './chunks/constants.BZZyIeIE.js';
+import { c as configFiles } from './chunks/constants.DnKduX2e.js';
 export { distDir, rootDir } from './path.js';
 import createDebug from 'debug';
 export { generateFileHash } from '@vitest/runner/utils';
@@ -19,13 +19,13 @@ import '@vitest/snapshot/manager';
 import 'vite-node/client';
 import 'vite-node/server';
 import './chunks/index.CJ0plNrh.js';
-import './chunks/index.CV36oG_L.js';
+import './chunks/index.Bter3jj9.js';
 import 'node:perf_hooks';
 import '@vitest/utils/source-map';
 import 'tinyrainbow';
 import './chunks/env.Dq0hM4Xv.js';
 import 'std-env';
-import './chunks/typechecker.DnTrplSJ.js';
+import './chunks/typechecker.BgzF-6iO.js';
 import 'node:os';
 import 'tinyexec';
 import 'node:util';
@@ -50,9 +50,9 @@ import 'picomatch';
 import 'tinyglobby';
 import 'vite-node/utils';
 import '@vitest/mocker/node';
-import './chunks/defaults.DSxsTG0h.js';
+import './chunks/defaults.DpVH7vbg.js';
 import 'magic-string';
-import './chunks/index.CmC5OK9L.js';
+import './chunks/index.JOzufsrU.js';
 import 'node:assert';
 import '@vitest/utils/error';
 import 'node:readline';
@@ -64,16 +64,18 @@ import 'tinypool';
 import 'node:worker_threads';
 import 'readline';
 
+// this is only exported as a public function and not used inside vitest
 async function resolveConfig(options = {}, viteOverrides = {}) {
 	const root = slash(resolve(options.root || process.cwd()));
 	const configPath = options.config === false ? false : options.config ? resolve(root, options.config) : await findUp(configFiles, { cwd: root });
 	options.config = configPath;
-	const vitest = new Vitest("test");
+	const vitest = new Vitest("test", deepClone(options));
 	const config = await resolveConfig$1(mergeConfig({
 		configFile: configPath,
 		mode: options.mode || "test",
 		plugins: [await VitestPlugin(options, vitest)]
 	}, mergeConfig(viteOverrides, { root: options.root })), "serve");
+	// Reflect just to avoid type error
 	const updatedOptions = Reflect.get(config, "_vitest");
 	const vitestConfig = resolveConfig$2(vitest, updatedOptions, config);
 	await vitest.close();

package/dist/reporters.d.ts

@@ -1,6 +1,6 @@
-export { aQ as BaseReporter, aC as BasicReporter, aR as BenchmarkBuiltinReporters, aD as BenchmarkReporter, aE as BenchmarkReportsMap, aS as BuiltinReporterOptions, aT as BuiltinReporters, aF as DefaultReporter, aG as DotReporter, aH as GithubActionsReporter, aI as HangingProcessReporter, aK as JUnitReporter, aU as JsonAssertionResult, aJ as JsonReporter, aV as JsonTestResult, aW as JsonTestResults, aA as ReportedHookContext, o as Reporter, aL as ReportersMap, aM as TapFlatReporter, aN as TapReporter, aB as TestRunEndReason, aO as VerboseBenchmarkReporter, aP as VerboseReporter } from './chunks/reporters.d.CLC9rhKy.js';
+export { aQ as BaseReporter, aC as BasicReporter, aR as BenchmarkBuiltinReporters, aD as BenchmarkReporter, aE as BenchmarkReportsMap, aS as BuiltinReporterOptions, aT as BuiltinReporters, aF as DefaultReporter, aG as DotReporter, aH as GithubActionsReporter, aI as HangingProcessReporter, aK as JUnitReporter, aU as JsonAssertionResult, aJ as JsonReporter, aV as JsonTestResult, aW as JsonTestResults, aA as ReportedHookContext, o as Reporter, aL as ReportersMap, aM as TapFlatReporter, aN as TapReporter, aB as TestRunEndReason, aO as VerboseBenchmarkReporter, aP as VerboseReporter } from './chunks/reporters.d.Bt4IGtsa.js';
 import '@vitest/runner';
-import './chunks/environment.d.D8YDy2v5.js';
+import './chunks/environment.d.cL3nLXbE.js';
 import 'vitest/optional-types.js';
 import '@vitest/utils';
 import 'node:stream';
@@ -8,9 +8,9 @@ import 'vite';
 import 'node:console';
 import '@vitest/mocker';
 import '@vitest/utils/source-map';
-import './chunks/worker.d.CoCI7hzP.js';
+import './chunks/worker.d.BKbBp2ga.js';
 import 'vite-node';
-import './chunks/config.d.UqE-KR0o.js';
+import './chunks/config.d.D2ROskhv.js';
 import '@vitest/pretty-format';
 import '@vitest/snapshot';
 import '@vitest/snapshot/environment';

package/dist/reporters.js

@@ -1,5 +1,5 @@
-export { B as BasicReporter, D as DefaultReporter, a as DotReporter, G as GithubActionsReporter, H as HangingProcessReporter, b as JUnitReporter, J as JsonReporter, R as ReportersMap, T as TapFlatReporter, c as TapReporter, V as VerboseReporter } from './chunks/index.CV36oG_L.js';
-export { B as BenchmarkReporter, a as BenchmarkReportsMap, V as VerboseBenchmarkReporter } from './chunks/index.CmC5OK9L.js';
+export { B as BasicReporter, D as DefaultReporter, a as DotReporter, G as GithubActionsReporter, H as HangingProcessReporter, b as JUnitReporter, J as JsonReporter, R as ReportersMap, T as TapFlatReporter, c as TapReporter, V as VerboseReporter } from './chunks/index.Bter3jj9.js';
+export { B as BenchmarkReporter, a as BenchmarkReportsMap, V as VerboseBenchmarkReporter } from './chunks/index.JOzufsrU.js';
 import 'node:perf_hooks';
 import '@vitest/runner/utils';
 import '@vitest/utils';
@@ -8,7 +8,7 @@ import 'pathe';
 import 'tinyrainbow';
 import './chunks/env.Dq0hM4Xv.js';
 import 'std-env';
-import './chunks/typechecker.DnTrplSJ.js';
+import './chunks/typechecker.BgzF-6iO.js';
 import 'node:os';
 import 'tinyexec';
 import './path.js';

package/dist/runners.d.ts

@@ -1,7 +1,7 @@
 import * as tinybench from 'tinybench';
 import { VitestRunner, VitestRunnerImportSource, Suite, File, Task, CancelReason, TestContext } from '@vitest/runner';
 export { VitestRunner } from '@vitest/runner';
-import { a as SerializedConfig } from './chunks/config.d.UqE-KR0o.js';
+import { a as SerializedConfig } from './chunks/config.d.D2ROskhv.js';
 import '@vitest/pretty-format';
 import '@vitest/snapshot';
 import '@vitest/snapshot/environment';

package/dist/runners.js

@@ -1,18 +1,18 @@
 import { updateTask } from '@vitest/runner';
 import { createDefer, getSafeTimers } from '@vitest/utils';
-import { a as getBenchOptions, g as getBenchFn } from './chunks/benchmark.BoF7jW0Q.js';
-import { g as getWorkerState } from './chunks/utils.CgTj3MsC.js';
+import { a as getBenchOptions, g as getBenchFn } from './chunks/benchmark.Cf_PACH1.js';
+import { g as getWorkerState } from './chunks/utils.BlI4TC7Y.js';
 import { setState, GLOBAL_EXPECT, getState } from '@vitest/expect';
 import { getTests, getNames, getTestName } from '@vitest/runner/utils';
-import { g as getSnapshotClient, i as inject, c as createExpect, v as vi } from './chunks/vi.BFR5YIgu.js';
-import { r as rpc } from './chunks/rpc.D9_013TY.js';
+import { g as getSnapshotClient, i as inject, c as createExpect, v as vi } from './chunks/vi.pkoYCV6A.js';
+import { r as rpc } from './chunks/rpc.BKExFSRG.js';
 import 'chai';
 import './chunks/_commonjsHelpers.BFTU3MAI.js';
 import '@vitest/snapshot';
 import '@vitest/utils/error';
 import '@vitest/spy';
 import '@vitest/utils/source-map';
-import './chunks/date.CDOsz-HY.js';
+import './chunks/date.ByMsSlOr.js';
 import './chunks/index.CJ0plNrh.js';
 
 function createBenchmarkResult(name) {
@@ -39,6 +39,7 @@ async function runBenchmarkSuite(suite, runner) {
 			benchmarkSuiteGroup.push(task);
 		}
 	}
+	// run sub suites sequentially
 	for (const subSuite of benchmarkSuiteGroup) {
 		await runBenchmarkSuite(subSuite, runner);
 	}
@@ -57,6 +58,7 @@ async function runBenchmarkSuite(suite, runner) {
 				const result = benchmark.result.benchmark;
 				benchmark.result.state = "pass";
 				Object.assign(result, taskRes);
+				// compute extra stats and free raw samples as early as possible
 				const samples = result.samples;
 				result.sampleCount = samples.length;
 				result.median = samples.length % 2 ? samples[Math.floor(samples.length / 2)] : (samples[samples.length / 2] + samples[samples.length / 2 - 1]) / 2;
@@ -153,6 +155,7 @@ class VitestTestRunner {
 			suite.result.heap = process.memoryUsage().heapUsed;
 		}
 		if (suite.mode !== "skip" && "filepath" in suite) {
+			// mark snapshots in skipped tests as not obsolete
 			for (const test of getTests(suite)) {
 				if (test.mode === "skip") {
 					const name = getNames(test).slice(1).join(" > ");
@@ -174,6 +177,8 @@ class VitestTestRunner {
 		this.cancelRun = true;
 	}
 	injectValue(key) {
+		// inject has a very limiting type controlled by ProvidedContext
+		// some tests override it which causes the build to fail
 		return inject(key);
 	}
 	async onBeforeRunTask(test) {
@@ -189,6 +194,7 @@ class VitestTestRunner {
 		if (this.cancelRun) {
 			suite.mode = "skip";
 		}
+		// initialize snapshot state before running file suite
 		if (suite.mode !== "skip" && "filepath" in suite) {
 			await this.snapshotClient.setup(suite.file.filepath, this.workerState.config.snapshotOptions);
 		}
@@ -220,6 +226,7 @@ class VitestTestRunner {
 		}
 	}
 	extendTaskContext(context) {
+		// create error during the test initialization so we have a nice stack trace
 		if (this.config.expect.requireAssertions) {
 			this.assertionsErrors.set(context.task, new Error("expected any number of assertion, but got none"));
 		}
@@ -238,6 +245,7 @@ class VitestTestRunner {
 }
 function clearModuleMocks(config) {
 	const { clearMocks, mockReset, restoreMocks, unstubEnvs, unstubGlobals } = config;
+	// since each function calls another, we can just call one
 	if (restoreMocks) {
 		vi.restoreAllMocks();
 	} else if (mockReset) {

package/dist/snapshot.js

@@ -1,4 +1,4 @@
-export { VitestNodeSnapshotEnvironment as VitestSnapshotEnvironment } from './chunks/node.3xsWotC9.js';
+export { VitestNodeSnapshotEnvironment as VitestSnapshotEnvironment } from './chunks/node.Be-ntJnD.js';
 import '@vitest/snapshot/environment';
-import './chunks/utils.CgTj3MsC.js';
+import './chunks/utils.BlI4TC7Y.js';
 import '@vitest/utils';

package/dist/suite.js

@@ -1,5 +1,5 @@
-export { g as getBenchFn, a as getBenchOptions } from './chunks/benchmark.BoF7jW0Q.js';
+export { g as getBenchFn, a as getBenchOptions } from './chunks/benchmark.Cf_PACH1.js';
 export { createTaskCollector, getCurrentSuite, getCurrentTest, getFn, getHooks, setFn, setHooks } from '@vitest/runner';
 export { createChainable } from '@vitest/runner/utils';
 import '@vitest/utils';
-import './chunks/utils.CgTj3MsC.js';
+import './chunks/utils.BlI4TC7Y.js';