vitest 3.2.0-beta.1 → 3.2.0-beta.3

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.BpmIjFTD.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.DGm4k1Wx.js';
-export { G as BrowserTesterOptions } from './chunks/reporters.d.DGm4k1Wx.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.BCOHQEpR.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.DjP_ALCZ.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,28 +106,7 @@ declare const globalExpect: ExpectStatic;
 */
 declare function inject<T extends keyof ProvidedContext & string>(key: T): ProvidedContext[T];
 
-/**
-* This utils allows computational intensive tasks to only be ran once
-* across test reruns to improve the watch mode performance.
-*
-* Currently only works with `poolOptions.<pool>.isolate: false`
-*
-* @experimental
-*/
-declare function runOnce<T>(fn: () => T, key?: string): T;
-/**
-* Get a boolean indicates whether the task is running in the first time.
-* Could only be `false` in watch mode.
-*
-* Currently only works with `isolate: false`
-*
-* @experimental
-*/
-declare function isFirstRun(): boolean;
-
-declare function getRunningMode(): "watch" | "run";
-declare function isWatchMode(): boolean;
-
+// The waitFor function was inspired by https://github.com/testing-library/web-testing-library/pull/2
 type WaitForCallback<T> = () => T | Promise<T>;
 interface WaitForOptions {
 	/**
@@ -317,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.
@@ -325,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.
@@ -336,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.
@@ -344,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.
@@ -656,5 +646,5 @@ type SerializableSpec = SerializedTestSpecification;
 /** @deprecated import from `vitest/node` instead */
 type BenchmarkUserOptions = BenchmarkUserOptions$1;
 
-export { LabelColor, ModuleGraphData, ProvidedContext, SerializedConfig, SerializedTestSpecification, UserConsoleLog, assertType, createExpect, globalExpect as expect, getRunningMode, inject, isFirstRun, isWatchMode, runOnce, vi, vitest };
+export { LabelColor, ModuleGraphData, ProvidedContext, SerializedConfig, SerializedTestSpecification, UserConsoleLog, assertType, createExpect, globalExpect as expect, inject, vi, vitest };
 export type { ApiConfig, ArgumentsType, Arrayable, AssertType, Awaitable, BaseCoverageOptions, BenchmarkUserOptions, BrowserConfigOptions, BrowserScript, BrowserUI, BuiltinEnvironment, CSSModuleScopeStrategy, CollectLineNumbers, CollectLines, Constructable, Context, CoverageIstanbulOptions, CoverageOptions, CoverageProvider, CoverageProviderModule, CoverageReporter, CoverageV8Options, Custom, CustomProviderOptions, DepsOptimizationOptions, DoneCallback, Environment, EnvironmentOptions, EnvironmentReturn, File, HappyDOMOptions, InlineConfig, JSDOMOptions, MutableArray, Nullable, Pool, PoolOptions, ProjectConfig, RawErrsMap, ReportContext, Reporter, ResolvedConfig, ResolvedCoverageOptions, ResolvedTestEnvironment, RootAndTarget, RuntimeContext, SequenceHooks, SequenceSetupFiles, SerializableSpec, Suite, SuiteHooks, Task, TaskBase, TaskResult, TaskResultPack, Test, TransformModePatterns, TransformResultWithSource, TscErrorInfo, TypecheckConfig, UserConfig, UserWorkspaceConfig, Vitest, VitestEnvironment, VitestRunMode, VitestUtils, VmEnvironmentReturn, WebSocketEvents, WebSocketHandlers, WebSocketRPC, WorkerContext, WorkerRPC };

package/dist/index.js

@@ -1,7 +1,6 @@
-export { c as createExpect, a as expect, i as inject, v as vi, b as vitest } from './chunks/vi.BFR5YIgu.js';
-export { i as isFirstRun, a as runOnce } from './chunks/run-once.Dimr7O9f.js';
-export { a as assertType, g as getRunningMode, i as isWatchMode } from './chunks/index.BPc7M5ni.js';
-export { b as bench } from './chunks/benchmark.BoF7jW0Q.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';
@@ -9,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.DGm4k1Wx.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.DGm4k1Wx.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.DjP_ALCZ.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.BCOHQEpR.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.2970Nj9J.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.2970Nj9J.js';
-export { p as parseCLI } from './chunks/cac.TfX2-DVH.js';
-import { r as resolveConfig$2 } from './chunks/coverage.z0LVMxgb.js';
-export { b as BaseSequencer, c as createMethodsRPC, g as getFilePoolName, a as resolveApiServerConfig } from './chunks/coverage.z0LVMxgb.js';
-import { slash } from '@vitest/utils';
-import { f as findUp } from './chunks/index.DBIGubLC.js';
+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,23 +19,20 @@ import '@vitest/snapshot/manager';
 import 'vite-node/client';
 import 'vite-node/server';
 import './chunks/index.CJ0plNrh.js';
-import './chunks/index.CUacZlWG.js';
-import 'tinyrainbow';
-import './chunks/utils.8gfOgtry.js';
-import 'node:util';
+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.DYQbn8uK.js';
-import 'node:fs/promises';
-import 'tinyexec';
+import './chunks/typechecker.BgzF-6iO.js';
 import 'node:os';
-import 'node:url';
-import 'node:module';
-import 'fs';
+import 'tinyexec';
+import 'node:util';
+import 'node:fs/promises';
 import 'node:console';
 import 'node:stream';
+import 'node:module';
 import 'events';
 import 'https';
 import 'http';
@@ -48,16 +45,17 @@ import 'zlib';
 import 'buffer';
 import './chunks/_commonjsHelpers.BFTU3MAI.js';
 import 'node:crypto';
+import 'node:url';
+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.JOzufsrU.js';
 import 'node:assert';
 import '@vitest/utils/error';
 import 'node:readline';
-import 'util';
-import 'path';
 import 'node:process';
 import 'node:v8';
 import 'node:tty';
@@ -66,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.DGm4k1Wx.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,23 +1,23 @@
-export { B as BasicReporter, a as BenchmarkReporter, b as BenchmarkReportsMap, D as DefaultReporter, c as DotReporter, G as GithubActionsReporter, H as HangingProcessReporter, d as JUnitReporter, J as JsonReporter, R as ReportersMap, T as TapFlatReporter, e as TapReporter, V as VerboseBenchmarkReporter, f as VerboseReporter } from './chunks/index.CUacZlWG.js';
-import 'node:fs';
+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 'pathe';
-import 'tinyrainbow';
-import './chunks/utils.8gfOgtry.js';
-import 'node:util';
 import '@vitest/utils';
-import 'node:perf_hooks';
 import '@vitest/utils/source-map';
+import 'pathe';
+import 'tinyrainbow';
 import './chunks/env.Dq0hM4Xv.js';
 import 'std-env';
-import './chunks/typechecker.DYQbn8uK.js';
-import 'node:fs/promises';
-import 'tinyexec';
-import 'vite';
+import './chunks/typechecker.BgzF-6iO.js';
 import 'node:os';
-import 'node:url';
+import 'tinyexec';
+import './path.js';
 import 'node:path';
-import 'node:module';
-import 'fs';
+import 'node:url';
+import 'vite';
+import 'node:util';
+import 'node:fs';
+import 'node:fs/promises';
 import 'node:console';
 import 'node:stream';
+import 'node:module';

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';

package/dist/worker.js

@@ -4,11 +4,11 @@ import { workerId } from 'tinypool';
 import { ViteNodeRunner, ModuleCacheMap } from 'vite-node/client';
 import { readFileSync } from 'node:fs';
 import { resolve, normalize } from 'pathe';
-import { e as environments } from './chunks/index.DFXFpH3w.js';
-import { s as setupInspect } from './chunks/inspector.DbDkSkFn.js';
-import { c as createRuntimeRpc, a as rpcDone } from './chunks/rpc.D9_013TY.js';
-import { i as isChildProcess, s as setProcessTitle } from './chunks/utils.CgTj3MsC.js';
-import { d as disposeInternalListeners } from './chunks/utils.BfxieIyZ.js';
+import { e as environments } from './chunks/index.2jgTs_Q5.js';
+import { s as setupInspect } from './chunks/inspector.BFsh5KO0.js';
+import { c as createRuntimeRpc, a as rpcDone } from './chunks/rpc.BKExFSRG.js';
+import { i as isChildProcess, s as setProcessTitle } from './chunks/utils.BlI4TC7Y.js';
+import { d as disposeInternalListeners } from './chunks/utils.DPCq3gzW.js';
 import 'node:console';
 import 'node:module';
 import '@vitest/utils';
@@ -59,11 +59,13 @@ if (isChildProcess()) {
 	setProcessTitle(`vitest ${workerId}`);
 	const isProfiling = process.execArgv.some((execArg) => execArg.startsWith("--prof") || execArg.startsWith("--cpu-prof") || execArg.startsWith("--heap-prof") || execArg.startsWith("--diagnostic-dir"));
 	if (isProfiling) {
+		// Work-around for nodejs/node#55094
 		process.on("SIGTERM", () => {
 			process.exit();
 		});
 	}
 }
+// this is what every pool executes when running tests
 async function execute(method, ctx) {
 	disposeInternalListeners();
 	const prepareStart = performance.now();
@@ -71,6 +73,7 @@ async function execute(method, ctx) {
 	process.env.VITEST_WORKER_ID = String(ctx.workerId);
 	process.env.VITEST_POOL_ID = String(workerId);
 	try {
+		// worker is a filepath or URL to a file that exposes a default export with "getRpcOptions" and "runTests" methods
 		if (ctx.worker[0] === ".") {
 			throw new Error(`Path to the test runner cannot be relative, received "${ctx.worker}"`);
 		}
@@ -83,6 +86,7 @@ async function execute(method, ctx) {
 		if (!worker.getRpcOptions || typeof worker.getRpcOptions !== "function") {
 			throw new TypeError(`Test worker should expose "getRpcOptions" method. Received "${typeof worker.getRpcOptions}".`);
 		}
+		// RPC is used to communicate between worker (be it a thread worker or child process or a custom implementation) and the main thread
 		const { rpc, onCancel } = createRuntimeRpc(worker.getRpcOptions(ctx));
 		const beforeEnvironmentTime = performance.now();
 		const environment = await loadEnvironment(ctx, rpc);

package/dist/workers/forks.js

@@ -1,8 +1,8 @@
 import v8 from 'node:v8';
-import { r as runBaseTests } from '../chunks/base.SfTiRNZf.js';
-import { c as createForksRpcOptions, u as unwrapSerializableConfig } from '../chunks/utils.BfxieIyZ.js';
+import { r as runBaseTests } from '../chunks/base.D4119yLM.js';
+import { c as createForksRpcOptions, u as unwrapSerializableConfig } from '../chunks/utils.DPCq3gzW.js';
 import 'vite-node/client';
-import '../chunks/execute.BpmIjFTD.js';
+import '../chunks/execute.B3q-2LPV.js';
 import 'node:fs';
 import 'node:url';
 import 'node:vm';
@@ -14,13 +14,15 @@ import 'node:path';
 import '@vitest/mocker';
 import 'node:module';
 import '@vitest/utils';
-import '../chunks/utils.CgTj3MsC.js';
+import '../chunks/utils.BlI4TC7Y.js';
 
 class ForksBaseWorker {
 	getRpcOptions() {
 		return createForksRpcOptions(v8);
 	}
 	async executeTests(method, state) {
+		// TODO: don't rely on reassigning process.exit
+		// https://github.com/vitest-dev/vitest/pull/4441#discussion_r1443771486
 		const exit = process.exit;
 		state.ctx.config = unwrapSerializableConfig(state.ctx.config);
 		try {