vitest 4.0.0-beta.8 → 4.0.0

package/dist/chunks/{reporters.d.37tJQ2uV.d.ts → reporters.d.BMKt7f6I.d.ts}

@@ -1,16 +1,17 @@
-import { CancelReason, TaskMeta, Suite, File, TestAnnotation, ImportDuration, Test, Task, TaskResultPack, SequenceSetupFiles, SequenceHooks } from '@vitest/runner';
-import { Awaitable, ParsedStack, TestError, SerializedError, Arrayable as Arrayable$1 } from '@vitest/utils';
-import { P as ProvidedContext, c as Arrayable, A as AfterSuiteRunMeta, U as UserConsoleLog, b as Awaitable$1, L as LabelColor } from './environment.d.2fYMoz3o.js';
+import { TaskMeta, Suite, File, TestAnnotation, ImportDuration, Test, Task, TaskResultPack, FileSpecification, CancelReason, SequenceSetupFiles, SequenceHooks } from '@vitest/runner';
+import { TestError, SerializedError, Arrayable, ParsedStack, Awaitable } from '@vitest/utils';
+import { A as AfterSuiteRunMeta, U as UserConsoleLog, P as ProvidedContext, C as ContextRPC, L as LabelColor } from './worker.d.BFk-vvBU.js';
 import { Writable } from 'node:stream';
-import { ViteDevServer, TransformResult as TransformResult$1, DepOptimizationConfig, ServerOptions, UserConfig as UserConfig$1, ConfigEnv, AliasOptions } from 'vite';
+import { TransformResult as TransformResult$1, ViteDevServer, Plugin, UserConfig as UserConfig$1, DepOptimizationConfig, ServerOptions, ConfigEnv, AliasOptions } from 'vite';
 import { MockedModule } from '@vitest/mocker';
 import { StackTraceParserOptions } from '@vitest/utils/source-map';
-import { B as BrowserTesterOptions, S as SerializedTestSpecification } from './browser.d.DOMmqJQx.js';
-import { a as SerializedConfig, F as FakeTimerInstallOpts } from './config.d._GBBbReY.js';
+import { BrowserCommands } from 'vitest/browser';
+import { B as BrowserTraceViewMode, S as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.u2CUDWwS.js';
+import { S as SerializedTestSpecification, B as BrowserTesterOptions } from './browser.d.B9iJzZyn.js';
 import { PrettyFormatOptions } from '@vitest/pretty-format';
 import { SnapshotSummary, SnapshotStateOptions } from '@vitest/snapshot';
 import { SerializedDiffOptions } from '@vitest/utils/diff';
-import * as chai from 'chai';
+import { chai } from '@vitest/expect';
 import { happyDomTypes, jsdomTypes } from 'vitest/optional-types.js';
 import { B as BenchmarkResult } from './benchmark.d.DAaHLpsq.js';
 import { a as RuntimeCoverageProviderModule } from './coverage.d.BZtK59WP.js';
@@ -69,477 +70,323 @@ interface ConstructorOptionsOverride {
 	resources?: "usable";
 }
 
-interface BrowserProviderInitializationOptions {
-	browser: string;
-	options?: BrowserProviderOptions;
-}
-interface CDPSession {
-	send: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
-	on: (event: string, listener: (...args: unknown[]) => void) => void;
-	once: (event: string, listener: (...args: unknown[]) => void) => void;
-	off: (event: string, listener: (...args: unknown[]) => void) => void;
-}
-interface BrowserModuleMocker {
-	register: (sessionId: string, module: MockedModule) => Promise<void>;
-	delete: (sessionId: string, url: string) => Promise<void>;
-	clear: (sessionId: string) => Promise<void>;
-}
-interface BrowserProvider {
-	name: string;
-	mocker?: BrowserModuleMocker;
+declare class ReportedTaskImplementation {
 	/**
-	* @experimental opt-in into file parallelisation
+	* The project associated with the test or suite.
 	*/
-	supportsParallelism: boolean;
-	getSupportedBrowsers: () => readonly string[];
-	getCommandsContext: (sessionId: string) => Record<string, unknown>;
-	openPage: (sessionId: string, url: string, beforeNavigate?: () => Promise<void>) => Promise<void>;
-	getCDPSession?: (sessionId: string) => Promise<CDPSession>;
-	close: () => Awaitable<void>;
-	// eslint-disable-next-line ts/method-signature-style -- we want to allow extended options
-	initialize(ctx: TestProject, options: BrowserProviderInitializationOptions): Awaitable<void>;
-}
-interface BrowserProviderModule {
-	new (): BrowserProvider;
-}
-interface BrowserProviderOptions {}
-type BrowserBuiltinProvider = "webdriverio" | "playwright" | "preview";
-type UnsupportedProperties = "browser" | "typecheck" | "alias" | "sequence" | "root" | "pool" | "poolOptions" | "runner" | "api" | "deps" | "environment" | "environmentOptions" | "server" | "benchmark" | "name";
-interface BrowserInstanceOption extends BrowserProviderOptions, Omit<ProjectConfig, UnsupportedProperties>, Pick<BrowserConfigOptions, "headless" | "locators" | "viewport" | "testerHtmlPath" | "screenshotDirectory" | "screenshotFailures"> {
+	readonly project: TestProject;
 	/**
-	* Name of the browser
+	* Unique identifier.
+	* This ID is deterministic and will be the same for the same test across multiple runs.
+	* The ID is based on the project name, module url and test order.
 	*/
-	browser: string;
-	name?: string;
-}
-interface BrowserConfigOptions {
+	readonly id: string;
 	/**
-	* if running tests in the browser should be the default
-	*
-	* @default false
+	* Location in the module where the test or suite is defined.
 	*/
-	enabled?: boolean;
+	readonly location: {
+		line: number;
+		column: number;
+	} | undefined;
 	/**
-	* Name of the browser
-	* @deprecated use `instances` instead. if both are defined, this will filter `instances` by name.
+	* Checks if the test did not fail the suite.
+	* If the test is not finished yet or was skipped, it will return `true`.
 	*/
-	name?: string;
+	ok(): boolean;
 	/**
-	* Configurations for different browser setups
+	* Custom metadata that was attached to the test during its execution.
 	*/
-	instances?: BrowserInstanceOption[];
+	meta(): TaskMeta;
+}
+declare class TestCase extends ReportedTaskImplementation {
+	#private;
+	readonly type = "test";
 	/**
-	* Browser provider
-	*
-	* @default 'preview'
+	* Direct reference to the test module where the test or suite is defined.
 	*/
-	provider?: BrowserBuiltinProvider | (string & {});
+	readonly module: TestModule;
 	/**
-	* Options that are passed down to a browser provider.
-	* To support type hinting, add one of the types to your tsconfig.json "compilerOptions.types" field:
-	*
-	* - for webdriverio: `@vitest/browser/providers/webdriverio`
-	* - for playwright: `@vitest/browser/providers/playwright`
-	*
-	* @example
-	* { playwright: { launch: { devtools: true } }
-	* @deprecated use `instances` instead
+	* Name of the test.
 	*/
-	providerOptions?: BrowserProviderOptions;
+	readonly name: string;
 	/**
-	* enable headless mode
-	*
-	* @default process.env.CI
+	* Options that the test was initiated with.
 	*/
-	headless?: boolean;
+	readonly options: TaskOptions;
 	/**
-	* Serve API options.
-	*
-	* The default port is 63315.
+	* Parent suite. If the test was called directly inside the module, the parent will be the module itself.
 	*/
-	api?: ApiConfig | number;
+	readonly parent: TestSuite | TestModule;
 	/**
-	* Isolate test environment after each test
-	*
-	* @default true
+	* Full name of the test including all parent suites separated with `>`.
 	*/
-	isolate?: boolean;
+	get fullName(): string;
 	/**
-	* Run test files in parallel if provider supports this option
-	* This option only has effect in headless mode (enabled in CI by default)
-	*
-	* @default // Same as "test.fileParallelism"
+	* Test results.
+	* - **pending**: Test was collected, but didn't finish running yet.
+	* - **passed**: Test passed successfully
+	* - **failed**: Test failed to execute
+	* - **skipped**: Test was skipped during collection or dynamically with `ctx.skip()`.
 	*/
-	fileParallelism?: boolean;
+	result(): TestResult;
 	/**
-	* Show Vitest UI
-	*
-	* @default !process.env.CI
+	* Test annotations added via the `task.annotate` API during the test execution.
 	*/
-	ui?: boolean;
+	annotations(): ReadonlyArray<TestAnnotation>;
 	/**
-	* Default viewport size
+	* Useful information about the test like duration, memory usage, etc.
+	* Diagnostic is only available after the test has finished.
 	*/
-	viewport?: {
-		/**
-		* Width of the viewport
-		* @default 414
-		*/
-		width: number;
-		/**
-		* Height of the viewport
-		* @default 896
-		*/
-		height: number;
-	};
+	diagnostic(): TestDiagnostic | undefined;
+}
+declare class TestCollection {
+	#private;
+	constructor(task: Suite | File, project: TestProject);
 	/**
-	* Locator options
+	* Returns the test or suite at a specific index.
 	*/
-	locators?: {
-		/**
-		* Attribute used to locate elements by test id
-		* @default 'data-testid'
-		*/
-		testIdAttribute?: string;
-	};
+	at(index: number): TestCase | TestSuite | undefined;
 	/**
-	* Directory where screenshots will be saved when page.screenshot() is called
-	* If not set, all screenshots are saved to __screenshots__ directory in the same folder as the test file.
-	* If this is set, it will be resolved relative to the project root.
-	* @default __screenshots__
+	* The number of tests and suites in the collection.
 	*/
-	screenshotDirectory?: string;
+	get size(): number;
 	/**
-	* Should Vitest take screenshots if the test fails
-	* @default !browser.ui
+	* Returns the collection in array form for easier manipulation.
 	*/
-	screenshotFailures?: boolean;
+	array(): (TestCase | TestSuite)[];
 	/**
-	* Path to the index.html file that will be used to run tests.
+	* Filters all tests that are part of this collection and its children.
 	*/
-	testerHtmlPath?: string;
+	allTests(state?: TestState): Generator<TestCase, undefined, void>;
 	/**
-	* Scripts injected into the main window.
+	* Filters only the tests that are part of this collection.
 	*/
-	orchestratorScripts?: BrowserScript[];
+	tests(state?: TestState): Generator<TestCase, undefined, void>;
 	/**
-	* Commands that will be executed on the server
-	* via the browser `import("@vitest/browser/context").commands` API.
-	* @see {@link https://vitest.dev/guide/browser/commands}
+	* Filters only the suites that are part of this collection.
 	*/
-	commands?: Record<string, BrowserCommand<any>>;
+	suites(): Generator<TestSuite, undefined, void>;
 	/**
-	* Timeout for connecting to the browser
-	* @default 30000
+	* Filters all suites that are part of this collection and its children.
 	*/
-	connectTimeout?: number;
-	expect?: {
-		toMatchScreenshot?: { [ComparatorName in keyof ToMatchScreenshotComparators] : {
-			/**
-			* The name of the comparator to use for visual diffing.
-			*
-			* @defaultValue `'pixelmatch'`
-			*/
-			comparatorName?: ComparatorName;
-			comparatorOptions?: ToMatchScreenshotComparators[ComparatorName];
-		} }[keyof ToMatchScreenshotComparators] & ToMatchScreenshotOptions;
-	};
+	allSuites(): Generator<TestSuite, undefined, void>;
+	[Symbol.iterator](): Generator<TestSuite | TestCase, undefined, void>;
+}
+
+type ReportedHookContext = {
+	readonly name: "beforeAll" | "afterAll";
+	readonly entity: TestSuite | TestModule;
+} | {
+	readonly name: "beforeEach" | "afterEach";
+	readonly entity: TestCase;
+};
+declare abstract class SuiteImplementation extends ReportedTaskImplementation {
 	/**
-	* Enables tracking uncaught errors and exceptions so they can be reported by Vitest.
-	*
-	* If you need to hide certain errors, it is recommended to use [`onUnhandledError`](https://vitest.dev/config/#onunhandlederror) option instead.
-	*
-	* Disabling this will completely remove all Vitest error handlers, which can help debugging with the "Pause on exceptions" checkbox turned on.
-	* @default true
+	* Collection of suites and tests that are part of this suite.
 	*/
-	trackUnhandledErrors?: boolean;
-}
-interface BrowserCommandContext {
-	testPath: string | undefined;
-	provider: BrowserProvider;
-	project: TestProject;
-	sessionId: string;
-}
-interface BrowserServerStateSession {
-	project: TestProject;
-	connected: () => void;
-	fail: (v: Error) => void;
-}
-interface BrowserOrchestrator {
-	cleanupTesters: () => Promise<void>;
-	createTesters: (options: BrowserTesterOptions) => Promise<void>;
-	onCancel: (reason: CancelReason) => Promise<void>;
-	$close: () => void;
-}
-interface BrowserServerState {
-	orchestrators: Map<string, BrowserOrchestrator>;
-}
-interface ParentProjectBrowser {
-	spawn: (project: TestProject) => ProjectBrowser;
-}
-interface ProjectBrowser {
-	vite: ViteDevServer;
-	state: BrowserServerState;
-	provider: BrowserProvider;
-	close: () => Promise<void>;
-	initBrowserProvider: (project: TestProject) => Promise<void>;
-	parseStacktrace: (stack: string) => ParsedStack[];
-	parseErrorStacktrace: (error: TestError, options?: StackTraceParserOptions) => ParsedStack[];
-}
-interface BrowserCommand<Payload extends unknown[]> {
-	(context: BrowserCommandContext, ...payload: Payload): Awaitable<any>;
-}
-interface BrowserScript {
+	readonly children: TestCollection;
 	/**
-	* If "content" is provided and type is "module", this will be its identifier.
-	*
-	* If you are using TypeScript, you can add `.ts` extension here for example.
-	* @default `injected-${index}.js`
+	* Errors that happened outside of the test run during collection, like syntax errors.
 	*/
-	id?: string;
+	errors(): SerializedError[];
+}
+declare class TestSuite extends SuiteImplementation {
+	#private;
+	readonly type = "suite";
 	/**
-	* JavaScript content to be injected. This string is processed by Vite plugins if type is "module".
-	*
-	* You can use `id` to give Vite a hint about the file extension.
+	* Name of the test or the suite.
 	*/
-	content?: string;
+	readonly name: string;
 	/**
-	* Path to the script. This value is resolved by Vite so it can be a node module or a file path.
+	* Direct reference to the test module where the test or suite is defined.
 	*/
-	src?: string;
+	readonly module: TestModule;
 	/**
-	* If the script should be loaded asynchronously.
+	* Parent suite. If suite was called directly inside the module, the parent will be the module itself.
 	*/
-	async?: boolean;
+	readonly parent: TestSuite | TestModule;
 	/**
-	* Script type.
-	* @default 'module'
+	* Options that suite was initiated with.
 	*/
-	type?: string;
-}
-interface ResolvedBrowserOptions extends BrowserConfigOptions {
-	name: string;
-	providerOptions?: BrowserProviderOptions;
-	enabled: boolean;
-	headless: boolean;
-	isolate: boolean;
-	fileParallelism: boolean;
-	api: ApiConfig;
-	ui: boolean;
-	viewport: {
-		width: number;
-		height: number;
-	};
-	screenshotFailures: boolean;
-	locators: {
-		testIdAttribute: string;
-	};
-}
-type ToMatchScreenshotResolvePath = (data: {
+	readonly options: TaskOptions;
 	/**
-	* Path **without** extension, sanitized and relative to the test file.
-	*
-	* This comes from the arguments passed to `toMatchScreenshot`; if called
-	* without arguments this will be the auto-generated name.
-	*
-	* @example
-	* test('calls `onClick`', () => {
-	*   expect(locator).toMatchScreenshot()
-	*   // arg = "calls-onclick-1"
-	* })
-	*
-	* @example
-	* expect(locator).toMatchScreenshot('foo/bar/baz.png')
-	* // arg = "foo/bar/baz"
-	*
-	* @example
-	* expect(locator).toMatchScreenshot('../foo/bar/baz.png')
-	* // arg = "foo/bar/baz"
+	* Checks if the suite has any failed tests.
+	* This will also return `false` if suite failed during collection.
 	*/
-	arg: string;
+	ok: () => boolean;
 	/**
-	* Screenshot extension, with leading dot.
-	*
-	* This can be set through the arguments passed to `toMatchScreenshot`, but
-	* the value will fall back to `'.png'` if an unsupported extension is used.
+	* The meta information attached to the suite during its collection or execution.
 	*/
-	ext: string;
+	meta: () => TaskMeta;
 	/**
-	* The instance's browser name.
+	* Checks the running state of the suite.
 	*/
-	browserName: string;
+	state(): TestSuiteState;
 	/**
-	* The value of {@linkcode process.platform}.
+	* Full name of the suite including all parent suites separated with `>`.
 	*/
-	platform: NodeJS.Platform;
+	get fullName(): string;
+}
+declare class TestModule extends SuiteImplementation {
+	readonly location: undefined;
+	readonly type = "module";
 	/**
-	* The value provided to
-	* {@linkcode https://vitest.dev/guide/browser/config#browser-screenshotdirectory|browser.screenshotDirectory},
-	* if none is provided, its default value.
+	* This is usually an absolute UNIX file path.
+	* It can be a virtual ID if the file is not on the disk.
+	* This value corresponds to the ID in the Vite's module graph.
 	*/
-	screenshotDirectory: string;
+	readonly moduleId: string;
 	/**
-	* Absolute path to the project's
-	* {@linkcode https://vitest.dev/config/#root|root}.
+	* Module id relative to the project. This is the same as `task.name`.
 	*/
-	root: string;
+	readonly relativeModuleId: string;
 	/**
-	* Path to the test file, relative to the project's
-	* {@linkcode https://vitest.dev/config/#root|root}.
+	* Checks the running state of the test file.
 	*/
-	testFileDirectory: string;
+	state(): TestModuleState;
 	/**
-	* The test's filename.
+	* Checks if the module has any failed tests.
+	* This will also return `false` if module failed during collection.
 	*/
-	testFileName: string;
+	ok: () => boolean;
 	/**
-	* The {@linkcode https://vitest.dev/api/#test|test}'s name, including
-	* parent {@linkcode https://vitest.dev/api/#describe|describe}, sanitized.
+	* The meta information attached to the module during its collection or execution.
 	*/
-	testName: string;
+	meta: () => TaskMeta;
 	/**
-	* The value provided to
-	* {@linkcode https://vitest.dev/config/#attachmentsdir|attachmentsDir},
-	* if none is provided, its default value.
+	* Useful information about the module like duration, memory usage, etc.
+	* If the module was not executed yet, all diagnostic values will return `0`.
 	*/
-	attachmentsDir: string;
-}) => string;
-interface ToMatchScreenshotOptions {
+	diagnostic(): ModuleDiagnostic;
+}
+interface TaskOptions {
+	readonly each: boolean | undefined;
+	readonly fails: boolean | undefined;
+	readonly concurrent: boolean | undefined;
+	readonly shuffle: boolean | undefined;
+	readonly retry: number | undefined;
+	readonly repeats: number | undefined;
+	readonly mode: "run" | "only" | "skip" | "todo";
+}
+type TestSuiteState = "skipped" | "pending" | "failed" | "passed";
+type TestModuleState = TestSuiteState | "queued";
+type TestState = TestResult["state"];
+type TestResult = TestResultPassed | TestResultFailed | TestResultSkipped | TestResultPending;
+interface TestResultPending {
 	/**
-	* Overrides default reference screenshot path.
-	*
-	* @default `${root}/${testFileDirectory}/${screenshotDirectory}/${testFileName}/${arg}-${browserName}-${platform}${ext}`
+	* The test was collected, but didn't finish running yet.
 	*/
-	resolveScreenshotPath?: ToMatchScreenshotResolvePath;
+	readonly state: "pending";
 	/**
-	* Overrides default screenshot path used for diffs.
-	*
-	* @default `${root}/${attachmentsDir}/${testFileDirectory}/${testFileName}/${arg}-${browserName}-${platform}${ext}`
+	* Pending tests have no errors.
 	*/
-	resolveDiffPath?: ToMatchScreenshotResolvePath;
+	readonly errors: undefined;
 }
-interface ToMatchScreenshotComparators {}
-
-type BuiltinPool = "browser" | "threads" | "forks" | "vmThreads" | "vmForks" | "typescript";
-type Pool = BuiltinPool | (string & {});
-interface PoolOptions extends Record<string, unknown> {
+interface TestResultPassed {
 	/**
-	* Run tests in `node:worker_threads`.
-	*
-	* Test isolation (when enabled) is done by spawning a new thread for each test file.
-	*
-	* This pool is used by default.
+	* The test passed successfully.
 	*/
-	threads?: ThreadsOptions & WorkerContextOptions;
+	readonly state: "passed";
 	/**
-	* Run tests in `node:child_process` using [`fork()`](https://nodejs.org/api/child_process.html#child_processforkmodulepath-args-options)
+	* Errors that were thrown during the test execution.
 	*
-	* Test isolation (when enabled) is done by spawning a new child process for each test file.
+	* **Note**: If test was retried successfully, errors will still be reported.
 	*/
-	forks?: ForksOptions & WorkerContextOptions;
+	readonly errors: ReadonlyArray<TestError> | undefined;
+}
+interface TestResultFailed {
 	/**
-	* Run tests in isolated `node:vm`.
-	* Test files are run parallel using `node:worker_threads`.
-	*
-	* This makes tests run faster, but VM module is unstable. Your tests might leak memory.
+	* The test failed to execute.
 	*/
-	vmThreads?: ThreadsOptions & VmOptions;
+	readonly state: "failed";
 	/**
-	* Run tests in isolated `node:vm`.
-	*
-	* Test files are run parallel using `node:child_process` [`fork()`](https://nodejs.org/api/child_process.html#child_processforkmodulepath-args-options)
-	*
-	* This makes tests run faster, but VM module is unstable. Your tests might leak memory.
+	* Errors that were thrown during the test execution.
 	*/
-	vmForks?: ForksOptions & VmOptions;
-}
-interface ResolvedPoolOptions extends PoolOptions {
-	threads?: ResolvedThreadsOptions & WorkerContextOptions;
-	forks?: ResolvedForksOptions & WorkerContextOptions;
-	vmThreads?: ResolvedThreadsOptions & VmOptions;
-	vmForks?: ResolvedForksOptions & VmOptions;
+	readonly errors: ReadonlyArray<TestError>;
 }
-interface ThreadsOptions {
-	/** Minimum amount of threads to use */
-	minThreads?: number | string;
-	/** Maximum amount of threads to use */
-	maxThreads?: number | string;
+interface TestResultSkipped {
 	/**
-	* Run tests inside a single thread.
-	*
-	* @default false
+	* The test was skipped with `only` (on another test), `skip` or `todo` flag.
+	* You can see which one was used in the `options.mode` option.
 	*/
-	singleThread?: boolean;
+	readonly state: "skipped";
 	/**
-	* Use Atomics to synchronize threads
-	*
-	* This can improve performance in some cases, but might cause segfault in older Node versions.
-	*
-	* @default false
+	* Skipped tests have no errors.
 	*/
-	useAtomics?: boolean;
-}
-interface ResolvedThreadsOptions extends ThreadsOptions {
-	minThreads?: number;
-	maxThreads?: number;
-}
-interface ForksOptions {
-	/** Minimum amount of child processes to use */
-	minForks?: number | string;
-	/** Maximum amount of child processes to use */
-	maxForks?: number | string;
+	readonly errors: undefined;
 	/**
-	* Run tests inside a single fork.
-	*
-	* @default false
+	* A custom note passed down to `ctx.skip(note)`.
 	*/
-	singleFork?: boolean;
-}
-interface ResolvedForksOptions extends ForksOptions {
-	minForks?: number;
-	maxForks?: number;
+	readonly note: string | undefined;
 }
-interface WorkerContextOptions {
+interface TestDiagnostic {
 	/**
-	* Isolate test environment by recycling `worker_threads` or `child_process` after each test
-	*
-	* @default true
+	* If the duration of the test is above `slowTestThreshold`.
 	*/
-	isolate?: boolean;
+	readonly slow: boolean;
 	/**
-	* Pass additional arguments to `node` process when spawning `worker_threads` or `child_process`.
-	*
-	* See [Command-line API | Node.js](https://nodejs.org/docs/latest/api/cli.html) for more information.
-	*
-	* Set to `process.execArgv` to pass all arguments of the current process.
-	*
-	* Be careful when using, it as some options may crash worker, e.g. --prof, --title. See https://github.com/nodejs/node/issues/41103
-	*
-	* @default [] // no execution arguments are passed
+	* The amount of memory used by the test in bytes.
+	* This value is only available if the test was executed with `logHeapUsage` flag.
 	*/
-	execArgv?: string[];
+	readonly heap: number | undefined;
+	/**
+	* The time it takes to execute the test in ms.
+	*/
+	readonly duration: number;
+	/**
+	* The time in ms when the test started.
+	*/
+	readonly startTime: number;
+	/**
+	* The amount of times the test was retried.
+	*/
+	readonly retryCount: number;
+	/**
+	* The amount of times the test was repeated as configured by `repeats` option.
+	* This value can be lower if the test failed during the repeat and no `retry` is configured.
+	*/
+	readonly repeatCount: number;
+	/**
+	* If test passed on a second retry.
+	*/
+	readonly flaky: boolean;
 }
-interface VmOptions {
+interface ModuleDiagnostic {
 	/**
-	* Specifies the memory limit for `worker_thread` or `child_process` before they are recycled.
-	* If you see memory leaks, try to tinker this value.
+	* The time it takes to import and initiate an environment.
 	*/
-	memoryLimit?: string | number;
-	/** Isolation is always enabled */
-	isolate?: true;
+	readonly environmentSetupDuration: number;
 	/**
-	* Pass additional arguments to `node` process when spawning `worker_threads` or `child_process`.
-	*
-	* See [Command-line API | Node.js](https://nodejs.org/docs/latest/api/cli.html) for more information.
-	*
-	* Set to `process.execArgv` to pass all arguments of the current process.
-	*
-	* Be careful when using, it as some options may crash worker, e.g. --prof, --title. See https://github.com/nodejs/node/issues/41103
-	*
-	* @default [] // no execution arguments are passed
+	* The time it takes Vitest to setup test harness (runner, mocks, etc.).
 	*/
-	execArgv?: string[];
+	readonly prepareDuration: number;
+	/**
+	* The time it takes to import the test module.
+	* This includes importing everything in the module and executing suite callbacks.
+	*/
+	readonly collectDuration: number;
+	/**
+	* The time it takes to import the setup module.
+	*/
+	readonly setupDuration: number;
+	/**
+	* Accumulated duration of all tests and hooks in the module.
+	*/
+	readonly duration: number;
+	/**
+	* The amount of memory used by the test module in bytes.
+	* This value is only available if the test was executed with `logHeapUsage` flag.
+	*/
+	readonly heap: number | undefined;
+	/**
+	* The time spent importing every non-externalized dependency that Vitest has processed.
+	*/
+	readonly importDurations: Record<string, ImportDuration>;
 }
+declare function experimental_getRunnerTask(entity: TestCase): Test;
+declare function experimental_getRunnerTask(entity: TestSuite): Suite;
+declare function experimental_getRunnerTask(entity: TestModule): File;
+declare function experimental_getRunnerTask(entity: TestCase | TestSuite | TestModule): Suite | File | Test;
 
 declare class TestSpecification {
 	/**
@@ -571,440 +418,6 @@ declare class TestSpecification {
 	toJSON(): SerializedTestSpecification;
 }
 
-declare class TestProject {
-	options?: Vitest;
-	/**
-	* The global Vitest instance.
-	* @experimental The public Vitest API is experimental and does not follow semver.
-	*/
-	readonly vitest: Vitest;
-	/**
-	* Resolved global configuration. If there are no workspace projects, this will be the same as `config`.
-	*/
-	readonly globalConfig: ResolvedConfig;
-	/**
-	* Browser instance if the browser is enabled. This is initialized when the tests run for the first time.
-	*/
-	browser?: ProjectBrowser;
-	/**
-	* Temporary directory for the project. This is unique for each project. Vitest stores transformed content here.
-	*/
-	readonly tmpDir: string;
-	/** @inetrnal */ testFilesList: string[] | null;
-	private runner;
-	private closingPromise;
-	private typecheckFilesList;
-	private _globalSetups?;
-	private _provided;
-	constructor(vitest: Vitest, options?: InitializeProjectOptions | undefined);
-	/**
-	* The unique hash of this project. This value is consistent between the reruns.
-	*
-	* It is based on the root of the project (not consistent between OS) and its name.
-	*/
-	get hash(): string;
-	// "provide" is a property, not a method to keep the context when destructed in the global setup,
-	// making it a method would be a breaking change, and can be done in Vitest 3 at minimum
-	/**
-	* Provide a value to the test context. This value will be available to all tests with `inject`.
-	*/
-	provide: <T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]) => void;
-	/**
-	* Get the provided context. The project context is merged with the global context.
-	*/
-	getProvidedContext(): ProvidedContext;
-	/**
-	* Creates a new test specification. Specifications describe how to run tests.
-	* @param moduleId The file path
-	*/
-	createSpecification(moduleId: string, locations?: number[] | undefined, pool?: string): TestSpecification;
-	toJSON(): SerializedTestProject;
-	/**
-	* Vite's dev server instance. Every workspace project has its own server.
-	*/
-	get vite(): ViteDevServer;
-	/**
-	* Resolved project configuration.
-	*/
-	get config(): ResolvedConfig;
-	/**
-	* The name of the project or an empty string if not set.
-	*/
-	get name(): string;
-	/**
-	* The color used when reporting tasks of this project.
-	*/
-	get color(): ProjectName["color"];
-	/**
-	* Serialized project configuration. This is the config that tests receive.
-	*/
-	get serializedConfig(): SerializedConfig;
-	/**
-	* Check if this is the root project. The root project is the one that has the root config.
-	*/
-	isRootProject(): boolean;
-	onTestsRerun(cb: OnTestsRerunHandler): void;
-	/**
-	* Get all files in the project that match the globs in the config and the filters.
-	* @param filters String filters to match the test files.
-	*/
-	globTestFiles(filters?: string[]): Promise<{
-		/**
-		* Test files that match the filters.
-		*/
-		testFiles: string[];
-		/**
-		* Typecheck test files that match the filters. This will be empty unless `typecheck.enabled` is `true`.
-		*/
-		typecheckTestFiles: string[];
-	}>;
-	private globAllTestFiles;
-	isBrowserEnabled(): boolean;
-	private markTestFile;
-	/**
-	* Test if a file matches the test globs. This does the actual glob matching if the test is not cached, unlike `isCachedTestFile`.
-	*/
-	matchesTestGlob(moduleId: string, source?: () => string): boolean;
-	private isInSourceTestCode;
-	private filterFiles;
-	private _parentBrowser?;
-	/**
-	* Closes the project and all associated resources. This can only be called once; the closing promise is cached until the server restarts.
-	* If the resources are needed again, create a new project.
-	*/
-	close(): Promise<void>;
-	/**
-	* Import a file using Vite module runner.
-	* @param moduleId The ID of the module in Vite module graph
-	*/
-	import<T>(moduleId: string): Promise<T>;
-	private _setHash;
-	private _serializeOverriddenConfig;
-	private clearTmpDir;
-}
-interface SerializedTestProject {
-	name: string;
-	serializedConfig: SerializedConfig;
-	context: ProvidedContext;
-}
-interface InitializeProjectOptions extends TestProjectInlineConfiguration {
-	configFile: string | false;
-}
-
-declare class ReportedTaskImplementation {
-	/**
-	* The project associated with the test or suite.
-	*/
-	readonly project: TestProject;
-	/**
-	* Unique identifier.
-	* This ID is deterministic and will be the same for the same test across multiple runs.
-	* The ID is based on the project name, module url and test order.
-	*/
-	readonly id: string;
-	/**
-	* Location in the module where the test or suite is defined.
-	*/
-	readonly location: {
-		line: number;
-		column: number;
-	} | undefined;
-	/**
-	* Checks if the test did not fail the suite.
-	* If the test is not finished yet or was skipped, it will return `true`.
-	*/
-	ok(): boolean;
-	/**
-	* Custom metadata that was attached to the test during its execution.
-	*/
-	meta(): TaskMeta;
-}
-declare class TestCase extends ReportedTaskImplementation {
-	#private;
-	readonly type = "test";
-	/**
-	* Direct reference to the test module where the test or suite is defined.
-	*/
-	readonly module: TestModule;
-	/**
-	* Name of the test.
-	*/
-	readonly name: string;
-	/**
-	* Options that the test was initiated with.
-	*/
-	readonly options: TaskOptions;
-	/**
-	* Parent suite. If the test was called directly inside the module, the parent will be the module itself.
-	*/
-	readonly parent: TestSuite | TestModule;
-	/**
-	* Full name of the test including all parent suites separated with `>`.
-	*/
-	get fullName(): string;
-	/**
-	* Test results.
-	* - **pending**: Test was collected, but didn't finish running yet.
-	* - **passed**: Test passed successfully
-	* - **failed**: Test failed to execute
-	* - **skipped**: Test was skipped during collection or dynamically with `ctx.skip()`.
-	*/
-	result(): TestResult;
-	/**
-	* Test annotations added via the `task.annotate` API during the test execution.
-	*/
-	annotations(): ReadonlyArray<TestAnnotation>;
-	/**
-	* Useful information about the test like duration, memory usage, etc.
-	* Diagnostic is only available after the test has finished.
-	*/
-	diagnostic(): TestDiagnostic | undefined;
-}
-declare class TestCollection {
-	#private;
-	constructor(task: Suite | File, project: TestProject);
-	/**
-	* Returns the test or suite at a specific index.
-	*/
-	at(index: number): TestCase | TestSuite | undefined;
-	/**
-	* The number of tests and suites in the collection.
-	*/
-	get size(): number;
-	/**
-	* Returns the collection in array form for easier manipulation.
-	*/
-	array(): (TestCase | TestSuite)[];
-	/**
-	* Filters all tests that are part of this collection and its children.
-	*/
-	allTests(state?: TestState): Generator<TestCase, undefined, void>;
-	/**
-	* Filters only the tests that are part of this collection.
-	*/
-	tests(state?: TestState): Generator<TestCase, undefined, void>;
-	/**
-	* Filters only the suites that are part of this collection.
-	*/
-	suites(): Generator<TestSuite, undefined, void>;
-	/**
-	* Filters all suites that are part of this collection and its children.
-	*/
-	allSuites(): Generator<TestSuite, undefined, void>;
-	[Symbol.iterator](): Generator<TestSuite | TestCase, undefined, void>;
-}
-
-type ReportedHookContext = {
-	readonly name: "beforeAll" | "afterAll";
-	readonly entity: TestSuite | TestModule;
-} | {
-	readonly name: "beforeEach" | "afterEach";
-	readonly entity: TestCase;
-};
-declare abstract class SuiteImplementation extends ReportedTaskImplementation {
-	/**
-	* Collection of suites and tests that are part of this suite.
-	*/
-	readonly children: TestCollection;
-	/**
-	* Errors that happened outside of the test run during collection, like syntax errors.
-	*/
-	errors(): SerializedError[];
-}
-declare class TestSuite extends SuiteImplementation {
-	#private;
-	readonly type = "suite";
-	/**
-	* Name of the test or the suite.
-	*/
-	readonly name: string;
-	/**
-	* Direct reference to the test module where the test or suite is defined.
-	*/
-	readonly module: TestModule;
-	/**
-	* Parent suite. If suite was called directly inside the module, the parent will be the module itself.
-	*/
-	readonly parent: TestSuite | TestModule;
-	/**
-	* Options that suite was initiated with.
-	*/
-	readonly options: TaskOptions;
-	/**
-	* Checks if the suite has any failed tests.
-	* This will also return `false` if suite failed during collection.
-	*/
-	ok: () => boolean;
-	/**
-	* The meta information attached to the suite during its collection or execution.
-	*/
-	meta: () => TaskMeta;
-	/**
-	* Checks the running state of the suite.
-	*/
-	state(): TestSuiteState;
-	/**
-	* Full name of the suite including all parent suites separated with `>`.
-	*/
-	get fullName(): string;
-}
-declare class TestModule extends SuiteImplementation {
-	readonly location: undefined;
-	readonly type = "module";
-	/**
-	* This is usually an absolute UNIX file path.
-	* It can be a virtual ID if the file is not on the disk.
-	* This value corresponds to the ID in the Vite's module graph.
-	*/
-	readonly moduleId: string;
-	/**
-	* Checks the running state of the test file.
-	*/
-	state(): TestModuleState;
-	/**
-	* Checks if the module has any failed tests.
-	* This will also return `false` if module failed during collection.
-	*/
-	ok: () => boolean;
-	/**
-	* The meta information attached to the module during its collection or execution.
-	*/
-	meta: () => TaskMeta;
-	/**
-	* Useful information about the module like duration, memory usage, etc.
-	* If the module was not executed yet, all diagnostic values will return `0`.
-	*/
-	diagnostic(): ModuleDiagnostic;
-}
-interface TaskOptions {
-	readonly each: boolean | undefined;
-	readonly fails: boolean | undefined;
-	readonly concurrent: boolean | undefined;
-	readonly shuffle: boolean | undefined;
-	readonly retry: number | undefined;
-	readonly repeats: number | undefined;
-	readonly mode: "run" | "only" | "skip" | "todo";
-}
-type TestSuiteState = "skipped" | "pending" | "failed" | "passed";
-type TestModuleState = TestSuiteState | "queued";
-type TestState = TestResult["state"];
-type TestResult = TestResultPassed | TestResultFailed | TestResultSkipped | TestResultPending;
-interface TestResultPending {
-	/**
-	* The test was collected, but didn't finish running yet.
-	*/
-	readonly state: "pending";
-	/**
-	* Pending tests have no errors.
-	*/
-	readonly errors: undefined;
-}
-interface TestResultPassed {
-	/**
-	* The test passed successfully.
-	*/
-	readonly state: "passed";
-	/**
-	* Errors that were thrown during the test execution.
-	*
-	* **Note**: If test was retried successfully, errors will still be reported.
-	*/
-	readonly errors: ReadonlyArray<TestError> | undefined;
-}
-interface TestResultFailed {
-	/**
-	* The test failed to execute.
-	*/
-	readonly state: "failed";
-	/**
-	* Errors that were thrown during the test execution.
-	*/
-	readonly errors: ReadonlyArray<TestError>;
-}
-interface TestResultSkipped {
-	/**
-	* The test was skipped with `only` (on another test), `skip` or `todo` flag.
-	* You can see which one was used in the `options.mode` option.
-	*/
-	readonly state: "skipped";
-	/**
-	* Skipped tests have no errors.
-	*/
-	readonly errors: undefined;
-	/**
-	* A custom note passed down to `ctx.skip(note)`.
-	*/
-	readonly note: string | undefined;
-}
-interface TestDiagnostic {
-	/**
-	* If the duration of the test is above `slowTestThreshold`.
-	*/
-	readonly slow: boolean;
-	/**
-	* The amount of memory used by the test in bytes.
-	* This value is only available if the test was executed with `logHeapUsage` flag.
-	*/
-	readonly heap: number | undefined;
-	/**
-	* The time it takes to execute the test in ms.
-	*/
-	readonly duration: number;
-	/**
-	* The time in ms when the test started.
-	*/
-	readonly startTime: number;
-	/**
-	* The amount of times the test was retried.
-	*/
-	readonly retryCount: number;
-	/**
-	* The amount of times the test was repeated as configured by `repeats` option.
-	* This value can be lower if the test failed during the repeat and no `retry` is configured.
-	*/
-	readonly repeatCount: number;
-	/**
-	* If test passed on a second retry.
-	*/
-	readonly flaky: boolean;
-}
-interface ModuleDiagnostic {
-	/**
-	* The time it takes to import and initiate an environment.
-	*/
-	readonly environmentSetupDuration: number;
-	/**
-	* The time it takes Vitest to setup test harness (runner, mocks, etc.).
-	*/
-	readonly prepareDuration: number;
-	/**
-	* The time it takes to import the test module.
-	* This includes importing everything in the module and executing suite callbacks.
-	*/
-	readonly collectDuration: number;
-	/**
-	* The time it takes to import the setup module.
-	*/
-	readonly setupDuration: number;
-	/**
-	* Accumulated duration of all tests and hooks in the module.
-	*/
-	readonly duration: number;
-	/**
-	* The amount of memory used by the test module in bytes.
-	* This value is only available if the test was executed with `logHeapUsage` flag.
-	*/
-	readonly heap: number | undefined;
-	/**
-	* The time spent importing every non-externalized dependency that Vitest has processed.
-	*/
-	readonly importDurations: Record<string, ImportDuration>;
-}
-declare function experimental_getRunnerTask(entity: TestCase): Test;
-declare function experimental_getRunnerTask(entity: TestSuite): Suite;
-declare function experimental_getRunnerTask(entity: TestModule): File;
-declare function experimental_getRunnerTask(entity: TestCase | TestSuite | TestModule): Suite | File | Test;
-
 interface CoverageSummaryData {
     lines: Totals;
     statements: Totals;
@@ -1376,10 +789,11 @@ interface Thresholds {
 	perFile?: boolean;
 	/**
 	* Update threshold values automatically when current coverage is higher than earlier thresholds
+	* Also can accept a function to format the new threshold values
 	*
 	* @default false
 	*/
-	autoUpdate?: boolean;
+	autoUpdate?: boolean | ((newThreshold: number) => number);
 	/** Thresholds for statements */
 	statements?: number;
 	/** Thresholds for functions */
@@ -1489,6 +903,80 @@ declare class VitestPackageInstaller {
 	ensureInstalled(dependency: string, root: string, version?: string): Promise<boolean>;
 }
 
+type TestRunEndReason = "passed" | "interrupted" | "failed";
+interface Reporter {
+	onInit?: (vitest: Vitest) => void;
+	/**
+	* Called when the project initiated the browser instance.
+	* project.browser will always be defined.
+	* @experimental
+	*/
+	onBrowserInit?: (project: TestProject) => Awaitable<void>;
+	onTestRemoved?: (trigger?: string) => Awaitable<void>;
+	onWatcherStart?: (files?: File[], errors?: unknown[]) => Awaitable<void>;
+	onWatcherRerun?: (files: string[], trigger?: string) => Awaitable<void>;
+	onServerRestart?: (reason?: string) => Awaitable<void>;
+	onUserConsoleLog?: (log: UserConsoleLog) => Awaitable<void>;
+	onProcessTimeout?: () => Awaitable<void>;
+	/**
+	* Called when the new test run starts.
+	*/
+	onTestRunStart?: (specifications: ReadonlyArray<TestSpecification>) => Awaitable<void>;
+	/**
+	* Called when the test run is finished.
+	*/
+	onTestRunEnd?: (testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason) => Awaitable<void>;
+	/**
+	* Called when the module is enqueued for testing. The file itself is not loaded yet.
+	*/
+	onTestModuleQueued?: (testModule: TestModule) => Awaitable<void>;
+	/**
+	* Called when the test file is loaded and the module is ready to run tests.
+	*/
+	onTestModuleCollected?: (testModule: TestModule) => Awaitable<void>;
+	/**
+	* Called when starting to run tests of the test file
+	*/
+	onTestModuleStart?: (testModule: TestModule) => Awaitable<void>;
+	/**
+	* Called when all tests of the test file have finished running.
+	*/
+	onTestModuleEnd?: (testModule: TestModule) => Awaitable<void>;
+	/**
+	* Called when test case is ready to run.
+	* Called before the `beforeEach` hooks for the test are run.
+	*/
+	onTestCaseReady?: (testCase: TestCase) => Awaitable<void>;
+	/**
+	* Called after the test and its hooks are finished running.
+	* The `result()` cannot be `pending`.
+	*/
+	onTestCaseResult?: (testCase: TestCase) => Awaitable<void>;
+	/**
+	* Called when annotation is added via the `task.annotate` API.
+	*/
+	onTestCaseAnnotate?: (testCase: TestCase, annotation: TestAnnotation) => Awaitable<void>;
+	/**
+	* Called when test suite is ready to run.
+	* Called before the `beforeAll` hooks for the test are run.
+	*/
+	onTestSuiteReady?: (testSuite: TestSuite) => Awaitable<void>;
+	/**
+	* Called after the test suite and its hooks are finished running.
+	* The `state` cannot be `pending`.
+	*/
+	onTestSuiteResult?: (testSuite: TestSuite) => Awaitable<void>;
+	/**
+	* Called before the hook starts to run.
+	*/
+	onHookStart?: (hook: ReportedHookContext) => Awaitable<void>;
+	/**
+	* Called after the hook finished running.
+	*/
+	onHookEnd?: (hook: ReportedHookContext) => Awaitable<void>;
+	onCoverage?: (coverage: unknown) => Awaitable<void>;
+}
+
 interface BlobOptions {
 	outputFile?: string;
 }
@@ -1515,10 +1003,19 @@ declare class StateManager {
 	idMap: Map<string, Task>;
 	taskFileMap: WeakMap<Task, File>;
 	errorsSet: Set<unknown>;
-	processTimeoutCauses: Set<string>;
 	reportedTasksMap: WeakMap<Task, TestModule | TestCase | TestSuite>;
 	blobs?: MergedBlobs;
 	transformTime: number;
+	metadata: Record<string, {
+		externalized: Record<string, string>;
+		duration: Record<string, number[]>;
+		tmps: Record<string, string>;
+		dumpDir?: string;
+		outline?: {
+			externalized: number;
+			inlined: number;
+		};
+	}>;
 	onUnhandledError?: OnUnhandledErrorCallback;
 	constructor(options: {
 		onUnhandledError?: OnUnhandledErrorCallback;
@@ -1526,8 +1023,6 @@ declare class StateManager {
 	catchError(error: unknown, type: string): void;
 	clearErrors(): void;
 	getUnhandledErrors(): unknown[];
-	addProcessTimeoutCause(cause: string): void;
-	getProcessTimeoutCauses(): string[];
 	getPaths(): string[];
 	/**
 	* Return files that were running or collected.
@@ -1541,10 +1036,11 @@ declare class StateManager {
 	clearFiles(project: TestProject, paths?: string[]): void;
 	updateId(task: Task, project: TestProject): void;
 	getReportedEntity(task: Task): TestModule | TestCase | TestSuite | undefined;
+	getReportedEntityById(taskId: string): TestModule | TestCase | TestSuite | undefined;
 	updateTasks(packs: TaskResultPack[]): void;
 	updateUserLog(log: UserConsoleLog): void;
 	getCountOfFailedTests(): number;
-	cancelFiles(files: string[], project: TestProject): void;
+	cancelFiles(files: FileSpecification[], project: TestProject): void;
 }
 
 declare class VitestWatcher {
@@ -1665,260 +1161,773 @@ declare class Vitest {
 	disableCoverage(): void;
 	private _coverageOverrideCache;
 	/**
-	* Inject new test projects into the workspace.
-	* @param config Glob, config path or a custom config options.
-	* @returns An array of new test projects. Can be empty if the name was filtered out.
+	* Inject new test projects into the workspace.
+	* @param config Glob, config path or a custom config options.
+	* @returns An array of new test projects. Can be empty if the name was filtered out.
+	*/
+	private injectTestProject;
+	/**
+	* Provide a value to the test context. This value will be available to all tests with `inject`.
+	*/
+	provide: <T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]) => void;
+	/**
+	* Get global provided context.
+	*/
+	getProvidedContext(): ProvidedContext;
+	/**
+	* Return project that has the root (or "global") config.
+	*/
+	getRootProject(): TestProject;
+	getProjectByName(name: string): TestProject;
+	/**
+	* Import a file using Vite module runner. The file will be transformed by Vite and executed in a separate context.
+	* @param moduleId The ID of the module in Vite module graph
+	*/
+	import<T>(moduleId: string): Promise<T>;
+	/**
+	* Creates a coverage provider if `coverage` is enabled in the config.
+	*/
+	createCoverageProvider(): Promise<CoverageProvider | null>;
+	private resolveProjects;
+	/**
+	* Glob test files in every project and create a TestSpecification for each file and pool.
+	* @param filters String filters to match the test files.
+	*/
+	globTestSpecifications(filters?: string[]): Promise<TestSpecification[]>;
+	private initCoverageProvider;
+	/**
+	* Merge reports from multiple runs located in the specified directory (value from `--merge-reports` if not specified).
+	*/
+	mergeReports(directory?: string): Promise<TestRunResult>;
+	/**
+	* Returns the seed, if tests are running in a random order.
+	*/
+	getSeed(): number | null;
+	collect(filters?: string[]): Promise<TestRunResult>;
+	/**
+	* Returns the list of test files that match the config and filters.
+	* @param filters String filters to match the test files
+	*/
+	getRelevantTestSpecifications(filters?: string[]): Promise<TestSpecification[]>;
+	/**
+	* Initialize reporters, the coverage provider, and run tests.
+	* This method can throw an error:
+	*   - `FilesNotFoundError` if no tests are found
+	*   - `GitNotFoundError` if `--related` flag is used, but git repository is not initialized
+	*   - `Error` from the user reporters
+	* @param filters String filters to match the test files
+	*/
+	start(filters?: string[]): Promise<TestRunResult>;
+	/**
+	* Initialize reporters and the coverage provider. This method doesn't run any tests.
+	* If the `--watch` flag is provided, Vitest will still run changed tests even if this method was not called.
+	*/
+	init(): Promise<void>;
+	/**
+	* If there is a test run happening, returns a promise that will
+	* resolve when the test run is finished.
+	*/
+	waitForTestRunEnd(): Promise<void>;
+	/**
+	* Get test specifications associated with the given module. If module is not a test file, an empty array is returned.
+	*
+	* **Note:** this method relies on a cache generated by `globTestSpecifications`. If the file was not processed yet, use `project.matchesGlobPattern` instead.
+	* @param moduleId The module ID to get test specifications for.
+	*/
+	getModuleSpecifications(moduleId: string): TestSpecification[];
+	/**
+	* Vitest automatically caches test specifications for each file. This method clears the cache for the given file or the whole cache altogether.
+	*/
+	clearSpecificationsCache(moduleId?: string): void;
+	/**
+	* Run tests for the given test specifications. This does not trigger `onWatcher*` events.
+	* @param specifications A list of specifications to run.
+	* @param allTestsRun Indicates whether all tests were run. This only matters for coverage.
+	*/
+	runTestSpecifications(specifications: TestSpecification[], allTestsRun?: boolean): Promise<TestRunResult>;
+	/**
+	* Rerun files and trigger `onWatcherRerun`, `onWatcherStart` and `onTestsRerun` events.
+	* @param specifications A list of specifications to run.
+	* @param allTestsRun Indicates whether all tests were run. This only matters for coverage.
+	*/
+	rerunTestSpecifications(specifications: TestSpecification[], allTestsRun?: boolean): Promise<TestRunResult>;
+	private runFiles;
+	experimental_parseSpecifications(specifications: TestSpecification[], options?: {
+		/** @default os.availableParallelism() */
+		concurrency?: number;
+	}): Promise<TestModule[]>;
+	experimental_parseSpecification(specification: TestSpecification): Promise<TestModule>;
+	/**
+	* Collect tests in specified modules. Vitest will run the files to collect tests.
+	* @param specifications A list of specifications to run.
+	*/
+	collectTests(specifications: TestSpecification[]): Promise<TestRunResult>;
+	/**
+	* Gracefully cancel the current test run. Vitest will wait until all running tests are finished before cancelling.
+	*/
+	cancelCurrentRun(reason: CancelReason): Promise<void>;
+	private initializeGlobalSetup;
+	/**
+	* Update snapshots in specified files. If no files are provided, it will update files with failed tests and obsolete snapshots.
+	* @param files The list of files on the file system
+	*/
+	updateSnapshot(files?: string[]): Promise<TestRunResult>;
+	/**
+	* Enable the mode that allows updating snapshots when running tests.
+	* This method doesn't run any tests.
+	*
+	* Every test that runs after this method is called will update snapshots.
+	* To disable the mode, call `resetSnapshotUpdate`.
+	*/
+	enableSnapshotUpdate(): void;
+	/**
+	* Disable the mode that allows updating snapshots when running tests.
+	*/
+	resetSnapshotUpdate(): void;
+	/**
+	* Set the global test name pattern to a regexp.
+	* This method doesn't run any tests.
+	*/
+	setGlobalTestNamePattern(pattern: string | RegExp): void;
+	/**
+	* Returns the regexp used for the global test name pattern.
+	*/
+	getGlobalTestNamePattern(): RegExp | undefined;
+	/**
+	* Resets the global test name pattern. This method doesn't run any tests.
+	*/
+	resetGlobalTestNamePattern(): void;
+	private _rerunTimer;
+	private scheduleRerun;
+	/**
+	* Invalidate a file in all projects.
+	*/
+	invalidateFile(filepath: string): void;
+	private reportCoverage;
+	/**
+	* Closes all projects and their associated resources.
+	* This can only be called once; the closing promise is cached until the server restarts.
+	*/
+	close(): Promise<void>;
+	/**
+	* Closes all projects and exit the process
+	* @param force If true, the process will exit immediately after closing the projects.
+	*/
+	exit(force?: boolean): Promise<void>;
+	/**
+	* Should the server be kept running after the tests are done.
+	*/
+	shouldKeepServer(): boolean;
+	/**
+	* Register a handler that will be called when the server is restarted due to a config change.
+	*/
+	onServerRestart(fn: OnServerRestartHandler): void;
+	/**
+	* Register a handler that will be called when the test run is cancelled with `vitest.cancelCurrentRun`.
+	*/
+	onCancel(fn: (reason: CancelReason) => Awaitable<void>): void;
+	/**
+	* Register a handler that will be called when the server is closed.
+	*/
+	onClose(fn: () => Awaitable<void>): void;
+	/**
+	* Register a handler that will be called when the tests are rerunning.
+	*/
+	onTestsRerun(fn: OnTestsRerunHandler): void;
+	/**
+	* Register a handler that will be called when a file is changed.
+	* This callback should return `true` of `false` indicating whether the test file needs to be rerun.
+	* @example
+	* const testsToRun = [resolve('./test.spec.ts')]
+	* vitest.onFilterWatchedSpecification(specification => testsToRun.includes(specification.moduleId))
+	*/
+	onFilterWatchedSpecification(fn: (specification: TestSpecification) => boolean): void;
+	/**
+	* Check if the project with a given name should be included.
+	*/
+	matchesProjectFilter(name: string): boolean;
+}
+type OnServerRestartHandler = (reason?: string) => Promise<void> | void;
+type OnTestsRerunHandler = (testFiles: TestSpecification[]) => Promise<void> | void;
+
+interface CDPSession {
+	send: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
+	on: (event: string, listener: (...args: unknown[]) => void) => void;
+	once: (event: string, listener: (...args: unknown[]) => void) => void;
+	off: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+interface BrowserModuleMocker {
+	register: (sessionId: string, module: MockedModule) => Promise<void>;
+	delete: (sessionId: string, url: string) => Promise<void>;
+	clear: (sessionId: string) => Promise<void>;
+}
+interface BrowserProviderOption<Options extends object = object> {
+	name: string;
+	supportedBrowser?: ReadonlyArray<string>;
+	options: Options;
+	providerFactory: (project: TestProject) => BrowserProvider;
+	serverFactory: BrowserServerFactory;
+}
+interface BrowserServerOptions {
+	project: TestProject;
+	coveragePlugin: () => Plugin;
+	mocksPlugins: (options: {
+		filter: (id: string) => boolean;
+	}) => Plugin[];
+	metaEnvReplacer: () => Plugin;
+}
+interface BrowserServerFactory {
+	(otpions: BrowserServerOptions): Promise<ParentProjectBrowser>;
+}
+interface BrowserProvider {
+	name: string;
+	mocker?: BrowserModuleMocker;
+	readonly initScripts?: string[];
+	/**
+	* @experimental opt-in into file parallelisation
+	*/
+	supportsParallelism: boolean;
+	getCommandsContext: (sessionId: string) => Record<string, unknown>;
+	openPage: (sessionId: string, url: string) => Promise<void>;
+	getCDPSession?: (sessionId: string) => Promise<CDPSession>;
+	close: () => Awaitable<void>;
+}
+type BrowserBuiltinProvider = "webdriverio" | "playwright" | "preview";
+interface _BrowserNames {}
+type UnsupportedProperties = "browser" | "typecheck" | "alias" | "sequence" | "root" | "pool" | "runner" | "api" | "deps" | "environment" | "environmentOptions" | "server" | "benchmark" | "name";
+interface BrowserInstanceOption extends Omit<ProjectConfig, UnsupportedProperties>, Pick<BrowserConfigOptions, "headless" | "locators" | "viewport" | "testerHtmlPath" | "screenshotDirectory" | "screenshotFailures"> {
+	/**
+	* Name of the browser
+	*/
+	browser: keyof _BrowserNames extends never ? string : _BrowserNames[keyof _BrowserNames];
+	name?: string;
+	provider?: BrowserProviderOption;
+}
+interface BrowserConfigOptions {
+	/**
+	* if running tests in the browser should be the default
+	*
+	* @default false
+	*/
+	enabled?: boolean;
+	/**
+	* Configurations for different browser setups
+	*/
+	instances?: BrowserInstanceOption[];
+	/**
+	* Browser provider
+	* @example
+	* ```ts
+	* import { playwright } from '@vitest/browser-playwright'
+	* export default defineConfig({
+	*   test: {
+	*     browser: {
+	*       provider: playwright(),
+	*     },
+	*   },
+	* })
+	* ```
+	*/
+	provider?: BrowserProviderOption;
+	/**
+	* enable headless mode
+	*
+	* @default process.env.CI
+	*/
+	headless?: boolean;
+	/**
+	* Serve API options.
+	*
+	* The default port is 63315.
+	*/
+	api?: ApiConfig | number;
+	/**
+	* Isolate test environment after each test
+	*
+	* @default true
 	*/
-	private injectTestProject;
+	isolate?: boolean;
 	/**
-	* Provide a value to the test context. This value will be available to all tests with `inject`.
+	* Run test files in parallel if provider supports this option
+	* This option only has effect in headless mode (enabled in CI by default)
+	*
+	* @default // Same as "test.fileParallelism"
 	*/
-	provide: <T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]) => void;
+	fileParallelism?: boolean;
 	/**
-	* Get global provided context.
+	* Show Vitest UI
+	*
+	* @default !process.env.CI
 	*/
-	getProvidedContext(): ProvidedContext;
+	ui?: boolean;
 	/**
-	* Return project that has the root (or "global") config.
+	* Default viewport size
 	*/
-	getRootProject(): TestProject;
-	getProjectByName(name: string): TestProject;
+	viewport?: {
+		/**
+		* Width of the viewport
+		* @default 414
+		*/
+		width: number;
+		/**
+		* Height of the viewport
+		* @default 896
+		*/
+		height: number;
+	};
 	/**
-	* Import a file using Vite module runner. The file will be transformed by Vite and executed in a separate context.
-	* @param moduleId The ID of the module in Vite module graph
+	* Locator options
 	*/
-	import<T>(moduleId: string): Promise<T>;
+	locators?: {
+		/**
+		* Attribute used to locate elements by test id
+		* @default 'data-testid'
+		*/
+		testIdAttribute?: string;
+	};
 	/**
-	* Creates a coverage provider if `coverage` is enabled in the config.
+	* Generate traces that can be viewed on https://trace.playwright.dev/
+	*
+	* This option is supported only by **playwright** provider.
 	*/
-	createCoverageProvider(): Promise<CoverageProvider | null>;
-	private resolveProjects;
+	trace?: BrowserTraceViewMode | {
+		mode: BrowserTraceViewMode;
+		/**
+		* The directory where all traces will be stored. By default, Vitest
+		* stores all traces in `__traces__` folder close to the test file.
+		*/
+		tracesDir?: string;
+		/**
+		* Whether to capture screenshots during tracing. Screenshots are used to build a timeline preview.
+		* @default true
+		*/
+		screenshots?: boolean;
+		/**
+		* If this option is true tracing will
+		* - capture DOM snapshot on every action
+		* - record network activity
+		* @default true
+		*/
+		snapshots?: boolean;
+	};
 	/**
-	* Glob test files in every project and create a TestSpecification for each file and pool.
-	* @param filters String filters to match the test files.
+	* Directory where screenshots will be saved when page.screenshot() is called
+	* If not set, all screenshots are saved to __screenshots__ directory in the same folder as the test file.
+	* If this is set, it will be resolved relative to the project root.
+	* @default __screenshots__
 	*/
-	globTestSpecifications(filters?: string[]): Promise<TestSpecification[]>;
-	private initCoverageProvider;
+	screenshotDirectory?: string;
 	/**
-	* Merge reports from multiple runs located in the specified directory (value from `--merge-reports` if not specified).
+	* Should Vitest take screenshots if the test fails
+	* @default !browser.ui
 	*/
-	mergeReports(directory?: string): Promise<TestRunResult>;
-	collect(filters?: string[]): Promise<TestRunResult>;
+	screenshotFailures?: boolean;
 	/**
-	* Returns the list of test files that match the config and filters.
-	* @param filters String filters to match the test files
+	* Path to the index.html file that will be used to run tests.
 	*/
-	getRelevantTestSpecifications(filters?: string[]): Promise<TestSpecification[]>;
+	testerHtmlPath?: string;
 	/**
-	* Initialize reporters, the coverage provider, and run tests.
-	* This method can throw an error:
-	*   - `FilesNotFoundError` if no tests are found
-	*   - `GitNotFoundError` if `--related` flag is used, but git repository is not initialized
-	*   - `Error` from the user reporters
-	* @param filters String filters to match the test files
+	* Scripts injected into the main window.
 	*/
-	start(filters?: string[]): Promise<TestRunResult>;
+	orchestratorScripts?: BrowserScript[];
 	/**
-	* Initialize reporters and the coverage provider. This method doesn't run any tests.
-	* If the `--watch` flag is provided, Vitest will still run changed tests even if this method was not called.
+	* Commands that will be executed on the server
+	* via the browser `import("vitest/browser").commands` API.
+	* @see {@link https://vitest.dev/guide/browser/commands}
 	*/
-	init(): Promise<void>;
+	commands?: Record<string, BrowserCommand<any>>;
 	/**
-	* If there is a test run happening, returns a promise that will
-	* resolve when the test run is finished.
+	* Timeout for connecting to the browser
+	* @default 30000
 	*/
-	waitForTestRunEnd(): Promise<void>;
+	connectTimeout?: number;
+	expect?: {
+		toMatchScreenshot?: { [ComparatorName in keyof ToMatchScreenshotComparators] : {
+			/**
+			* The name of the comparator to use for visual diffing.
+			*
+			* @defaultValue `'pixelmatch'`
+			*/
+			comparatorName?: ComparatorName;
+			comparatorOptions?: ToMatchScreenshotComparators[ComparatorName];
+		} }[keyof ToMatchScreenshotComparators] & ToMatchScreenshotOptions;
+	};
 	/**
-	* Get test specifications associated with the given module. If module is not a test file, an empty array is returned.
+	* Enables tracking uncaught errors and exceptions so they can be reported by Vitest.
 	*
-	* **Note:** this method relies on a cache generated by `globTestSpecifications`. If the file was not processed yet, use `project.matchesGlobPattern` instead.
-	* @param moduleId The module ID to get test specifications for.
+	* If you need to hide certain errors, it is recommended to use [`onUnhandledError`](https://vitest.dev/config/#onunhandlederror) option instead.
+	*
+	* Disabling this will completely remove all Vitest error handlers, which can help debugging with the "Pause on exceptions" checkbox turned on.
+	* @default true
 	*/
-	getModuleSpecifications(moduleId: string): TestSpecification[];
+	trackUnhandledErrors?: boolean;
+}
+interface BrowserCommandContext {
+	testPath: string | undefined;
+	provider: BrowserProvider;
+	project: TestProject;
+	sessionId: string;
+	triggerCommand: <K extends keyof BrowserCommands>(name: K, ...args: Parameters<BrowserCommands[K]>) => ReturnType<BrowserCommands[K]>;
+}
+interface BrowserServerStateSession {
+	project: TestProject;
+	connected: () => void;
+	fail: (v: Error) => void;
+}
+interface BrowserOrchestrator {
+	cleanupTesters: () => Promise<void>;
+	createTesters: (options: BrowserTesterOptions) => Promise<void>;
+	onCancel: (reason: CancelReason) => Promise<void>;
+	$close: () => void;
+}
+interface BrowserServerState {
+	orchestrators: Map<string, BrowserOrchestrator>;
+}
+interface ParentProjectBrowser {
+	spawn: (project: TestProject) => ProjectBrowser;
+	vite: ViteDevServer;
+}
+interface ProjectBrowser {
+	vite: ViteDevServer;
+	state: BrowserServerState;
+	provider: BrowserProvider;
+	close: () => Promise<void>;
+	initBrowserProvider: (project: TestProject) => Promise<void>;
+	parseStacktrace: (stack: string) => ParsedStack[];
+	parseErrorStacktrace: (error: TestError, options?: StackTraceParserOptions) => ParsedStack[];
+	registerCommand: <K extends keyof BrowserCommands>(name: K, cb: BrowserCommand<Parameters<BrowserCommands[K]>, ReturnType<BrowserCommands[K]>>) => void;
+	triggerCommand: <K extends keyof BrowserCommands>(name: K, context: BrowserCommandContext, ...args: Parameters<BrowserCommands[K]>) => ReturnType<BrowserCommands[K]>;
+}
+interface BrowserCommand<
+	Payload extends unknown[] = [],
+	ReturnValue = any
+> {
+	(context: BrowserCommandContext, ...payload: Payload): Awaitable<ReturnValue>;
+}
+interface BrowserScript {
 	/**
-	* Vitest automatically caches test specifications for each file. This method clears the cache for the given file or the whole cache altogether.
+	* If "content" is provided and type is "module", this will be its identifier.
+	*
+	* If you are using TypeScript, you can add `.ts` extension here for example.
+	* @default `injected-${index}.js`
 	*/
-	clearSpecificationsCache(moduleId?: string): void;
+	id?: string;
 	/**
-	* Run tests for the given test specifications. This does not trigger `onWatcher*` events.
-	* @param specifications A list of specifications to run.
-	* @param allTestsRun Indicates whether all tests were run. This only matters for coverage.
+	* JavaScript content to be injected. This string is processed by Vite plugins if type is "module".
+	*
+	* You can use `id` to give Vite a hint about the file extension.
 	*/
-	runTestSpecifications(specifications: TestSpecification[], allTestsRun?: boolean): Promise<TestRunResult>;
+	content?: string;
 	/**
-	* Rerun files and trigger `onWatcherRerun`, `onWatcherStart` and `onTestsRerun` events.
-	* @param specifications A list of specifications to run.
-	* @param allTestsRun Indicates whether all tests were run. This only matters for coverage.
+	* Path to the script. This value is resolved by Vite so it can be a node module or a file path.
 	*/
-	rerunTestSpecifications(specifications: TestSpecification[], allTestsRun?: boolean): Promise<TestRunResult>;
-	private runFiles;
-	experimental_parseSpecifications(specifications: TestSpecification[], options?: {
-		/** @default os.availableParallelism() */
-		concurrency?: number;
-	}): Promise<TestModule[]>;
-	experimental_parseSpecification(specification: TestSpecification): Promise<TestModule>;
+	src?: string;
 	/**
-	* Collect tests in specified modules. Vitest will run the files to collect tests.
-	* @param specifications A list of specifications to run.
+	* If the script should be loaded asynchronously.
 	*/
-	collectTests(specifications: TestSpecification[]): Promise<TestRunResult>;
+	async?: boolean;
 	/**
-	* Gracefully cancel the current test run. Vitest will wait until all running tests are finished before cancelling.
+	* Script type.
+	* @default 'module'
 	*/
-	cancelCurrentRun(reason: CancelReason): Promise<void>;
-	private initializeGlobalSetup;
+	type?: string;
+}
+interface ResolvedBrowserOptions extends BrowserConfigOptions {
+	name: string;
+	enabled: boolean;
+	headless: boolean;
+	isolate: boolean;
+	fileParallelism: boolean;
+	api: ApiConfig;
+	ui: boolean;
+	viewport: {
+		width: number;
+		height: number;
+	};
+	screenshotFailures: boolean;
+	locators: {
+		testIdAttribute: string;
+	};
+	trace: {
+		mode: BrowserTraceViewMode;
+		tracesDir?: string;
+		screenshots?: boolean;
+		snapshots?: boolean;
+	};
+}
+type ToMatchScreenshotResolvePath = (data: {
 	/**
-	* Update snapshots in specified files. If no files are provided, it will update files with failed tests and obsolete snapshots.
-	* @param files The list of files on the file system
+	* Path **without** extension, sanitized and relative to the test file.
+	*
+	* This comes from the arguments passed to `toMatchScreenshot`; if called
+	* without arguments this will be the auto-generated name.
+	*
+	* @example
+	* test('calls `onClick`', () => {
+	*   expect(locator).toMatchScreenshot()
+	*   // arg = "calls-onclick-1"
+	* })
+	*
+	* @example
+	* expect(locator).toMatchScreenshot('foo/bar/baz.png')
+	* // arg = "foo/bar/baz"
+	*
+	* @example
+	* expect(locator).toMatchScreenshot('../foo/bar/baz.png')
+	* // arg = "foo/bar/baz"
 	*/
-	updateSnapshot(files?: string[]): Promise<TestRunResult>;
+	arg: string;
 	/**
-	* Enable the mode that allows updating snapshots when running tests.
-	* This method doesn't run any tests.
+	* Screenshot extension, with leading dot.
 	*
-	* Every test that runs after this method is called will update snapshots.
-	* To disable the mode, call `resetSnapshotUpdate`.
+	* This can be set through the arguments passed to `toMatchScreenshot`, but
+	* the value will fall back to `'.png'` if an unsupported extension is used.
 	*/
-	enableSnapshotUpdate(): void;
+	ext: string;
 	/**
-	* Disable the mode that allows updating snapshots when running tests.
+	* The instance's browser name.
+	*/
+	browserName: string;
+	/**
+	* The value of {@linkcode process.platform}.
 	*/
-	resetSnapshotUpdate(): void;
+	platform: NodeJS.Platform;
 	/**
-	* Set the global test name pattern to a regexp.
-	* This method doesn't run any tests.
+	* The value provided to
+	* {@linkcode https://vitest.dev/guide/browser/config#browser-screenshotdirectory|browser.screenshotDirectory},
+	* if none is provided, its default value.
 	*/
-	setGlobalTestNamePattern(pattern: string | RegExp): void;
+	screenshotDirectory: string;
 	/**
-	* Resets the global test name pattern. This method doesn't run any tests.
+	* Absolute path to the project's
+	* {@linkcode https://vitest.dev/config/#root|root}.
 	*/
-	resetGlobalTestNamePattern(): void;
-	private _rerunTimer;
-	private scheduleRerun;
+	root: string;
 	/**
-	* Invalidate a file in all projects.
+	* Path to the test file, relative to the project's
+	* {@linkcode https://vitest.dev/config/#root|root}.
 	*/
-	invalidateFile(filepath: string): void;
-	private reportCoverage;
+	testFileDirectory: string;
 	/**
-	* Closes all projects and their associated resources.
-	* This can only be called once; the closing promise is cached until the server restarts.
+	* The test's filename.
 	*/
-	close(): Promise<void>;
+	testFileName: string;
 	/**
-	* Closes all projects and exit the process
-	* @param force If true, the process will exit immediately after closing the projects.
+	* The {@linkcode https://vitest.dev/api/#test|test}'s name, including
+	* parent {@linkcode https://vitest.dev/api/#describe|describe}, sanitized.
 	*/
-	exit(force?: boolean): Promise<void>;
+	testName: string;
 	/**
-	* Should the server be kept running after the tests are done.
+	* The value provided to
+	* {@linkcode https://vitest.dev/config/#attachmentsdir|attachmentsDir},
+	* if none is provided, its default value.
 	*/
-	shouldKeepServer(): boolean;
+	attachmentsDir: string;
+}) => string;
+interface ToMatchScreenshotOptions {
 	/**
-	* Register a handler that will be called when the server is restarted due to a config change.
+	* Overrides default reference screenshot path.
+	*
+	* @default `${root}/${testFileDirectory}/${screenshotDirectory}/${testFileName}/${arg}-${browserName}-${platform}${ext}`
 	*/
-	onServerRestart(fn: OnServerRestartHandler): void;
+	resolveScreenshotPath?: ToMatchScreenshotResolvePath;
 	/**
-	* Register a handler that will be called when the test run is cancelled with `vitest.cancelCurrentRun`.
+	* Overrides default screenshot path used for diffs.
+	*
+	* @default `${root}/${attachmentsDir}/${testFileDirectory}/${testFileName}/${arg}-${browserName}-${platform}${ext}`
 	*/
-	onCancel(fn: (reason: CancelReason) => Awaitable<void>): void;
+	resolveDiffPath?: ToMatchScreenshotResolvePath;
+}
+interface ToMatchScreenshotComparators {}
+
+declare class TestProject {
+	options?: InitializeProjectOptions | undefined;
 	/**
-	* Register a handler that will be called when the server is closed.
+	* The global Vitest instance.
 	*/
-	onClose(fn: () => Awaitable<void>): void;
+	readonly vitest: Vitest;
 	/**
-	* Register a handler that will be called when the tests are rerunning.
+	* Resolved global configuration. If there are no workspace projects, this will be the same as `config`.
 	*/
-	onTestsRerun(fn: OnTestsRerunHandler): void;
+	readonly globalConfig: ResolvedConfig;
 	/**
-	* Register a handler that will be called when a file is changed.
-	* This callback should return `true` of `false` indicating whether the test file needs to be rerun.
-	* @example
-	* const testsToRun = [resolve('./test.spec.ts')]
-	* vitest.onFilterWatchedSpecification(specification => testsToRun.includes(specification.moduleId))
+	* Browser instance if the browser is enabled. This is initialized when the tests run for the first time.
 	*/
-	onFilterWatchedSpecification(fn: (specification: TestSpecification) => boolean): void;
+	browser?: ProjectBrowser;
 	/**
-	* Check if the project with a given name should be included.
+	* Temporary directory for the project. This is unique for each project. Vitest stores transformed content here.
 	*/
-	matchesProjectFilter(name: string): boolean;
-}
-type OnServerRestartHandler = (reason?: string) => Promise<void> | void;
-type OnTestsRerunHandler = (testFiles: TestSpecification[]) => Promise<void> | void;
-
-type TestRunEndReason = "passed" | "interrupted" | "failed";
-interface Reporter {
-	onInit?: (vitest: Vitest) => void;
+	readonly tmpDir: string;
+	/** @inetrnal */ testFilesList: string[] | null;
+	private runner;
+	private closingPromise;
+	private typecheckFilesList;
+	private _globalSetups?;
+	private _provided;
+	constructor(vitest: Vitest, options?: InitializeProjectOptions | undefined, tmpDir?: string);
 	/**
-	* Called when the project initiated the browser instance.
-	* project.browser will always be defined.
-	* @experimental
+	* The unique hash of this project. This value is consistent between the reruns.
+	*
+	* It is based on the root of the project (not consistent between OS) and its name.
 	*/
-	onBrowserInit?: (project: TestProject) => Awaitable$1<void>;
-	onTestRemoved?: (trigger?: string) => Awaitable$1<void>;
-	onWatcherStart?: (files?: File[], errors?: unknown[]) => Awaitable$1<void>;
-	onWatcherRerun?: (files: string[], trigger?: string) => Awaitable$1<void>;
-	onServerRestart?: (reason?: string) => Awaitable$1<void>;
-	onUserConsoleLog?: (log: UserConsoleLog) => Awaitable$1<void>;
-	onProcessTimeout?: () => Awaitable$1<void>;
+	get hash(): string;
 	/**
-	* Called when the new test run starts.
+	* Provide a value to the test context. This value will be available to all tests with `inject`.
 	*/
-	onTestRunStart?: (specifications: ReadonlyArray<TestSpecification>) => Awaitable$1<void>;
+	provide: <T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]) => void;
 	/**
-	* Called when the test run is finished.
+	* Get the provided context. The project context is merged with the global context.
 	*/
-	onTestRunEnd?: (testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason) => Awaitable$1<void>;
+	getProvidedContext(): ProvidedContext;
 	/**
-	* Called when the module is enqueued for testing. The file itself is not loaded yet.
+	* Creates a new test specification. Specifications describe how to run tests.
+	* @param moduleId The file path
 	*/
-	onTestModuleQueued?: (testModule: TestModule) => Awaitable$1<void>;
+	createSpecification(moduleId: string, locations?: number[] | undefined, pool?: string): TestSpecification;
+	toJSON(): SerializedTestProject;
 	/**
-	* Called when the test file is loaded and the module is ready to run tests.
+	* Vite's dev server instance. Every workspace project has its own server.
 	*/
-	onTestModuleCollected?: (testModule: TestModule) => Awaitable$1<void>;
+	get vite(): ViteDevServer;
 	/**
-	* Called when starting to run tests of the test file
+	* Resolved project configuration.
 	*/
-	onTestModuleStart?: (testModule: TestModule) => Awaitable$1<void>;
+	get config(): ResolvedConfig;
 	/**
-	* Called when all tests of the test file have finished running.
+	* The name of the project or an empty string if not set.
 	*/
-	onTestModuleEnd?: (testModule: TestModule) => Awaitable$1<void>;
+	get name(): string;
 	/**
-	* Called when test case is ready to run.
-	* Called before the `beforeEach` hooks for the test are run.
+	* The color used when reporting tasks of this project.
 	*/
-	onTestCaseReady?: (testCase: TestCase) => Awaitable$1<void>;
+	get color(): ProjectName["color"];
 	/**
-	* Called after the test and its hooks are finished running.
-	* The `result()` cannot be `pending`.
+	* Serialized project configuration. This is the config that tests receive.
 	*/
-	onTestCaseResult?: (testCase: TestCase) => Awaitable$1<void>;
+	get serializedConfig(): SerializedConfig;
 	/**
-	* Called when annotation is added via the `task.annotate` API.
+	* Check if this is the root project. The root project is the one that has the root config.
 	*/
-	onTestCaseAnnotate?: (testCase: TestCase, annotation: TestAnnotation) => Awaitable$1<void>;
+	isRootProject(): boolean;
+	onTestsRerun(cb: OnTestsRerunHandler): void;
 	/**
-	* Called when test suite is ready to run.
-	* Called before the `beforeAll` hooks for the test are run.
+	* Get all files in the project that match the globs in the config and the filters.
+	* @param filters String filters to match the test files.
 	*/
-	onTestSuiteReady?: (testSuite: TestSuite) => Awaitable$1<void>;
+	globTestFiles(filters?: string[]): Promise<{
+		/**
+		* Test files that match the filters.
+		*/
+		testFiles: string[];
+		/**
+		* Typecheck test files that match the filters. This will be empty unless `typecheck.enabled` is `true`.
+		*/
+		typecheckTestFiles: string[];
+	}>;
+	private globAllTestFiles;
+	isBrowserEnabled(): boolean;
+	private markTestFile;
 	/**
-	* Called after the test suite and its hooks are finished running.
-	* The `state` cannot be `pending`.
+	* Test if a file matches the test globs. This does the actual glob matching if the test is not cached, unlike `isCachedTestFile`.
 	*/
-	onTestSuiteResult?: (testSuite: TestSuite) => Awaitable$1<void>;
+	matchesTestGlob(moduleId: string, source?: () => string): boolean;
+	private isInSourceTestCode;
+	private filterFiles;
+	private _parentBrowser?;
 	/**
-	* Called before the hook starts to run.
+	* Closes the project and all associated resources. This can only be called once; the closing promise is cached until the server restarts.
+	* If the resources are needed again, create a new project.
 	*/
-	onHookStart?: (hook: ReportedHookContext) => Awaitable$1<void>;
+	close(): Promise<void>;
 	/**
-	* Called after the hook finished running.
+	* Import a file using Vite module runner.
+	* @param moduleId The ID of the module in Vite module graph
 	*/
-	onHookEnd?: (hook: ReportedHookContext) => Awaitable$1<void>;
-	onCoverage?: (coverage: unknown) => Awaitable$1<void>;
+	import<T>(moduleId: string): Promise<T>;
+	private _setHash;
+	private _serializeOverriddenConfig;
+	private clearTmpDir;
+}
+interface SerializedTestProject {
+	name: string;
+	serializedConfig: SerializedConfig;
+	context: ProvidedContext;
+}
+interface InitializeProjectOptions extends TestProjectInlineConfiguration {
+	configFile: string | false;
+}
+
+interface PoolRunnerInitializer {
+	readonly name: string;
+	createPoolWorker: (options: PoolOptions) => PoolWorker;
 }
+interface PoolOptions {
+	distPath: string;
+	project: TestProject;
+	method: "run" | "collect";
+	cacheFs?: boolean;
+	environment: string;
+	execArgv: string[];
+	env: Partial<NodeJS.ProcessEnv>;
+}
+interface PoolWorker {
+	readonly name: string;
+	readonly reportMemory?: boolean;
+	readonly cacheFs?: boolean;
+	on: (event: string, callback: (arg: any) => void) => void;
+	off: (event: string, callback: (arg: any) => void) => void;
+	send: (message: WorkerRequest) => void;
+	deserialize: (data: unknown) => unknown;
+	start: () => Promise<void>;
+	stop: () => Promise<void>;
+	/**
+	* This is called on workers that already satisfy certain constraints:
+	* - The task has the same project
+	* - The task has the same environment
+	*/
+	canReuse?: (task: PoolTask) => boolean;
+}
+interface PoolTask {
+	worker: "forks" | "threads" | "vmForks" | "vmThreads" | (string & {});
+	project: TestProject;
+	isolate: boolean;
+	env: Partial<NodeJS.ProcessEnv>;
+	execArgv: string[];
+	context: ContextRPC;
+	memoryLimit: number | null;
+}
+type WorkerRequest = {
+	__vitest_worker_request__: true;
+} & ({
+	type: "start";
+	options: {
+		reportMemory: boolean;
+	};
+} | {
+	type: "stop";
+} | {
+	type: "run";
+	context: ContextRPC;
+	poolId: number;
+} | {
+	type: "collect";
+	context: ContextRPC;
+	poolId: number;
+} | {
+	type: "cancel";
+});
+type WorkerResponse = {
+	__vitest_worker_response__: true;
+} & ({
+	type: "started";
+} | {
+	type: "stopped";
+	error?: unknown;
+} | {
+	type: "testfileFinished";
+	usedMemory?: number;
+	error?: unknown;
+});
 
 interface BaseOptions {
 	isTTY?: boolean;
@@ -1947,13 +1956,15 @@ declare abstract class BaseReporter implements Reporter {
 	protected printTestModule(testModule: TestModule): void;
 	protected printTestCase(moduleState: TestModuleState, test: TestCase): void;
 	private getModuleLog;
-	protected printTestSuite(_suite: TestSuite): void;
-	protected getTestName(test: Task, separator?: string): string;
+	protected printTestSuite(testSuite: TestSuite): void;
+	protected getTestName(test: Task, _separator?: string): string;
 	protected getFullName(test: Task, separator?: string): string;
-	protected formatShortError(error: TestError): string;
-	protected getTestIndentation(_test: Task): string;
+	protected getTestIndentation(test: Task): string;
 	protected printAnnotations(test: TestCase, console: "log" | "error", padding?: number): void;
-	protected getDurationPrefix(task: Task): string;
+	protected getEntityPrefix(entity: TestCase | TestModule | TestSuite): string;
+	protected getTestCaseSuffix(testCase: TestCase): string;
+	protected getStateSymbol(test: TestCase | TestModule | TestSuite): string;
+	private getDurationPrefix;
 	onWatcherStart(files?: File[], errors?: unknown[]): void;
 	onWatcherRerun(files: string[], trigger?: string): void;
 	onUserConsoleLog(log: UserConsoleLog, taskState?: TestResult["state"]): void;
@@ -1986,13 +1997,26 @@ declare class DefaultReporter extends BaseReporter {
 	onInit(ctx: Vitest): void;
 }
 
+interface GithubActionsReporterOptions {
+	onWritePath?: (path: string) => string;
+	/**
+	* @default true
+	*/
+	displayAnnotations?: boolean;
+}
+declare class GithubActionsReporter implements Reporter {
+	ctx: Vitest;
+	options: GithubActionsReporterOptions;
+	constructor(options?: GithubActionsReporterOptions);
+	onInit(ctx: Vitest): void;
+	onTestCaseAnnotate(testCase: TestCase, annotation: TestAnnotation): void;
+	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>): void;
+}
+
 interface HTMLOptions {
 	outputFile?: string;
 }
 
-// for compatibility reasons, the reporter produces a JSON similar to the one produced by the Jest JSON reporter
-// the following types are extracted from the Jest repository (and simplified)
-// the commented-out fields are the missing ones
 type Status = "passed" | "failed" | "skipped" | "pending" | "todo" | "disabled";
 type Milliseconds = number;
 interface Callsite {
@@ -2096,7 +2120,6 @@ declare class DotReporter extends BaseReporter {
 	private tests;
 	private finishedTests;
 	onInit(ctx: Vitest): void;
-	// Ignore default logging of base reporter
 	printTestModule(): void;
 	onWatcherRerun(files: string[], trigger?: string): void;
 	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): void;
@@ -2107,18 +2130,6 @@ declare class DotReporter extends BaseReporter {
 	private createSummary;
 }
 
-interface GithubActionsReporterOptions {
-	onWritePath?: (path: string) => string;
-}
-declare class GithubActionsReporter implements Reporter {
-	ctx: Vitest;
-	options: GithubActionsReporterOptions;
-	constructor(options?: GithubActionsReporterOptions);
-	onInit(ctx: Vitest): void;
-	onTestCaseAnnotate(testCase: TestCase, annotation: TestAnnotation): void;
-	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>): void;
-}
-
 declare class HangingProcessReporter implements Reporter {
 	whyRunning: (() => void) | undefined;
 	onInit(): void;
@@ -2140,15 +2151,16 @@ declare class TapFlatReporter extends TapReporter {
 	onTestRunEnd(testModules: ReadonlyArray<TestModule>): void;
 }
 
+declare class TreeReporter extends DefaultReporter {
+	protected verbose: boolean;
+	renderSucceed: boolean;
+}
+
 declare class VerboseReporter extends DefaultReporter {
 	protected verbose: boolean;
 	renderSucceed: boolean;
-	printTestModule(module: TestModule): void;
+	printTestModule(_module: TestModule): void;
 	onTestCaseResult(test: TestCase): void;
-	protected printTestSuite(testSuite: TestSuite): void;
-	protected getTestName(test: Task): string;
-	protected getTestIndentation(test: Task): string;
-	protected formatShortError(): string;
 }
 
 type FormattedBenchmarkResult = BenchmarkResult & {
@@ -2194,6 +2206,7 @@ declare const ReportersMap: {
 	tap: typeof TapReporter;
 	"tap-flat": typeof TapFlatReporter;
 	junit: typeof JUnitReporter;
+	tree: typeof TreeReporter;
 	"hanging-process": typeof HangingProcessReporter;
 	"github-actions": typeof GithubActionsReporter;
 };
@@ -2202,6 +2215,7 @@ interface BuiltinReporterOptions {
 	"default": DefaultReporterOptions;
 	"verbose": DefaultReporterOptions;
 	"dot": BaseOptions;
+	"tree": BaseOptions;
 	"json": JsonOptions;
 	"blob": BlobOptions;
 	"tap": never;
@@ -2209,6 +2223,7 @@ interface BuiltinReporterOptions {
 	"junit": JUnitOptions;
 	"hanging-process": never;
 	"html": HTMLOptions;
+	"github-actions": GithubActionsReporterOptions;
 }
 
 interface TestSequencer {
@@ -2216,8 +2231,8 @@ interface TestSequencer {
 	* Slicing tests into shards. Will be run before `sort`.
 	* Only run, if `shard` is defined.
 	*/
-	shard: (files: TestSpecification[]) => Awaitable$1<TestSpecification[]>;
-	sort: (files: TestSpecification[]) => Awaitable$1<TestSpecification[]>;
+	shard: (files: TestSpecification[]) => Awaitable<TestSpecification[]>;
+	sort: (files: TestSpecification[]) => Awaitable<TestSpecification[]>;
 }
 interface TestSequencerConstructor {
 	new (ctx: Vitest): TestSequencer;
@@ -2247,7 +2262,7 @@ interface BenchmarkUserOptions {
 	*
 	* @default ['default']
 	*/
-	reporters?: Arrayable$1<BenchmarkBuiltinReporters | Reporter>;
+	reporters?: Arrayable<BenchmarkBuiltinReporters | Reporter>;
 	/**
 	* @deprecated Use `benchmark.outputJson` instead
 	*/
@@ -2269,9 +2284,7 @@ interface BenchmarkUserOptions {
 }
 
 type BuiltinEnvironment = "node" | "jsdom" | "happy-dom" | "edge-runtime";
-// Record is used, so user can get intellisense for builtin environments, but still allow custom environments
 type VitestEnvironment = BuiltinEnvironment | (string & Record<never, never>);
-
 type CSSModuleScopeStrategy = "stable" | "scoped" | "non-scoped";
 type ApiConfig = Pick<ServerOptions, "port" | "strictPort" | "host" | "middlewareMode">;
 interface EnvironmentOptions {
@@ -2408,6 +2421,8 @@ interface ResolveSnapshotPathHandlerContext {
 	config: SerializedConfig;
 }
 type ResolveSnapshotPathHandler = (testPath: string, snapExtension: string, context: ResolveSnapshotPathHandlerContext) => string;
+type BuiltinPool = "browser" | "threads" | "forks" | "vmThreads" | "vmForks" | "typescript";
+type Pool = BuiltinPool | (string & {});
 interface InlineConfig {
 	/**
 	* Name of the project. Will be used to display in the reporter.
@@ -2443,6 +2458,23 @@ interface InlineConfig {
 	deps?: DepsOptions;
 	server?: {
 		deps?: ServerDepsOptions;
+		debug?: {
+			/**
+			* The folder where Vitest stores the contents of transformed
+			* test files that can be inspected manually.
+			*
+			* If `true`, Vitest dumps the files in `.vitest-dump` folder relative to the root of the project.
+			*
+			* You can also use `VITEST_DEBUG_DUMP` env variable to enable this.
+			*/
+			dump?: string | true;
+			/**
+			* If dump is enabled, should Vitest load the files from there instead of transforming them.
+			*
+			* You can also use `VITEST_DEBUG_LOAD_DUMP` env variable to enable this.
+			*/
+			load?: boolean;
+		};
 	};
 	/**
 	* Base directory to scan for the test files
@@ -2473,34 +2505,43 @@ interface InlineConfig {
 	/**
 	* Run tests in an isolated environment. This option has no effect on vmThreads pool.
 	*
-	* Disabling this option might improve performance if your code doesn't rely on side effects.
+	* Disabling this option improves performance if your code doesn't rely on side effects.
 	*
 	* @default true
 	*/
 	isolate?: boolean;
 	/**
-	* Pool used to run tests in.
+	* Pass additional arguments to `node` process when spawning the worker.
 	*
-	* Supports 'threads', 'forks', 'vmThreads'
+	* See [Command-line API | Node.js](https://nodejs.org/docs/latest/api/cli.html) for more information.
 	*
-	* @default 'forks'
+	* Set to `process.execArgv` to pass all arguments of the current process.
+	*
+	* Be careful when using, it as some options may crash worker, e.g. --prof, --title. See https://github.com/nodejs/node/issues/41103
+	*
+	* @default [] // no execution arguments are passed
 	*/
-	pool?: Exclude<Pool, "browser">;
+	execArgv?: string[];
 	/**
-	* Pool options
+	* Specifies the memory limit for `worker_thread` or `child_process` before they are recycled.
+	* If you see memory leaks, try to tinker this value.
 	*/
-	poolOptions?: PoolOptions;
+	vmMemoryLimit?: string | number;
 	/**
-	* Maximum number or percentage of workers to run tests in. `poolOptions.{threads,vmThreads}.maxThreads`/`poolOptions.forks.maxForks` has higher priority.
+	* Pool used to run tests in.
+	*
+	* Supports 'threads', 'forks', 'vmThreads', 'vmForks'
+	*
+	* @default 'forks'
 	*/
-	maxWorkers?: number | string;
+	pool?: Exclude<Pool, "browser"> | PoolRunnerInitializer;
 	/**
-	* Minimum number or percentage of workers to run tests in. `poolOptions.{threads,vmThreads}.minThreads`/`poolOptions.forks.minForks` has higher priority.
+	* Maximum number or percentage of workers to run tests in.
 	*/
-	minWorkers?: number | string;
+	maxWorkers?: number | string;
 	/**
 	* Should all test files run in parallel. Doesn't affect tests running in the same file.
-	* Setting this to `false` will override `maxWorkers` and `minWorkers` options to `1`.
+	* Setting this to `false` will override `maxWorkers` option to `1`.
 	*
 	* @default true
 	*/
@@ -2641,7 +2682,6 @@ interface InlineConfig {
 	ui?: boolean;
 	/**
 	* options for test in a browser environment
-	* @experimental
 	*
 	* @default false
 	*/
@@ -2782,14 +2822,14 @@ interface InlineConfig {
 	* Debug tests by opening `node:inspector` in worker / child process.
 	* Provides similar experience as `--inspect` Node CLI argument.
 	*
-	* Requires `poolOptions.threads.singleThread: true` OR `poolOptions.forks.singleFork: true`.
+	* Requires `fileParallelism: false`.
 	*/
 	inspect?: boolean | string;
 	/**
 	* Debug tests by opening `node:inspector` in worker / child process and wait for debugger to connect.
 	* Provides similar experience as `--inspect-brk` Node CLI argument.
 	*
-	* Requires `poolOptions.threads.singleThread: true` OR `poolOptions.forks.singleFork: true`.
+	* Requires `fileParallelism: false`.
 	*/
 	inspectBrk?: boolean | string;
 	/**
@@ -3023,7 +3063,7 @@ interface UserConfig extends InlineConfig {
 type OnUnhandledErrorCallback = (error: (TestError | Error) & {
 	type: string;
 }) => boolean | void;
-interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config" | "filters" | "browser" | "coverage" | "testNamePattern" | "related" | "api" | "reporters" | "resolveSnapshotPath" | "benchmark" | "shard" | "cache" | "sequence" | "typecheck" | "runner" | "poolOptions" | "pool" | "cliExclude" | "diff" | "setupFiles" | "snapshotEnvironment" | "bail" | "name"> {
+interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config" | "filters" | "browser" | "coverage" | "testNamePattern" | "related" | "api" | "reporters" | "resolveSnapshotPath" | "benchmark" | "shard" | "cache" | "sequence" | "typecheck" | "runner" | "pool" | "cliExclude" | "diff" | "setupFiles" | "snapshotEnvironment" | "bail" | "name" | "vmMemoryLimit"> {
 	mode: VitestRunMode;
 	name: ProjectName["label"];
 	color?: ProjectName["color"];
@@ -3040,7 +3080,7 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config"
 	snapshotOptions: SnapshotStateOptions;
 	browser: ResolvedBrowserOptions;
 	pool: Pool;
-	poolOptions?: ResolvedPoolOptions;
+	poolRunner?: PoolRunnerInitializer;
 	reporters: (InlineReporter | ReporterWithOptions)[];
 	defines: Record<string, any>;
 	api: ApiConfig & {
@@ -3073,9 +3113,10 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config"
 	};
 	runner?: string;
 	maxWorkers: number;
-	minWorkers: number;
+	vmMemoryLimit?: UserConfig["vmMemoryLimit"];
+	dumpDir?: string;
 }
-type NonProjectOptions = "shard" | "watch" | "run" | "cache" | "update" | "reporters" | "outputFile" | "teardownTimeout" | "silent" | "forceRerunTriggers" | "testNamePattern" | "ui" | "open" | "uiBase" | "snapshotFormat" | "resolveSnapshotPath" | "passWithNoTests" | "onConsoleLog" | "onStackTrace" | "dangerouslyIgnoreUnhandledErrors" | "slowTestThreshold" | "inspect" | "inspectBrk" | "coverage" | "maxWorkers" | "minWorkers" | "fileParallelism" | "watchTriggerPatterns";
+type NonProjectOptions = "shard" | "watch" | "run" | "cache" | "update" | "reporters" | "outputFile" | "teardownTimeout" | "silent" | "forceRerunTriggers" | "testNamePattern" | "ui" | "open" | "uiBase" | "snapshotFormat" | "resolveSnapshotPath" | "passWithNoTests" | "onConsoleLog" | "onStackTrace" | "dangerouslyIgnoreUnhandledErrors" | "slowTestThreshold" | "inspect" | "inspectBrk" | "coverage" | "watchTriggerPatterns";
 interface ServerDepsOptions {
 	/**
 	* Externalize means that Vite will bpass the package to native Node.
@@ -3100,21 +3141,16 @@ interface ServerDepsOptions {
 	*/
 	fallbackCJS?: boolean;
 }
-type ProjectConfig = Omit<InlineConfig, NonProjectOptions | "sequencer" | "deps" | "poolOptions"> & {
+type ProjectConfig = Omit<InlineConfig, NonProjectOptions | "sequencer" | "deps"> & {
 	mode?: string;
 	sequencer?: Omit<SequenceOptions, "sequencer" | "seed">;
 	deps?: Omit<DepsOptions, "moduleDirectories">;
-	poolOptions?: {
-		threads?: Pick<NonNullable<PoolOptions["threads"]>, "singleThread" | "isolate">;
-		vmThreads?: Pick<NonNullable<PoolOptions["vmThreads"]>, "singleThread">;
-		forks?: Pick<NonNullable<PoolOptions["forks"]>, "singleFork" | "isolate">;
-	};
+	fileParallelism?: boolean;
 };
 type ResolvedProjectConfig = Omit<ResolvedConfig, Exclude<NonProjectOptions, "coverage" | "watch">>;
 interface UserWorkspaceConfig extends UserConfig$1 {
 	test?: ProjectConfig;
 }
-// TODO: remove types when "workspace" support is removed
 type UserProjectConfigFn = (env: ConfigEnv) => UserWorkspaceConfig | Promise<UserWorkspaceConfig>;
 type UserProjectConfigExport = UserWorkspaceConfig | Promise<UserWorkspaceConfig> | UserProjectConfigFn;
 type TestProjectInlineConfiguration = (UserWorkspaceConfig & {
@@ -3127,5 +3163,5 @@ type TestProjectInlineConfiguration = (UserWorkspaceConfig & {
 });
 type TestProjectConfiguration = string | TestProjectInlineConfiguration | Promise<UserWorkspaceConfig> | UserProjectConfigFn;
 
-export { TestSuite as B, CoverageMap as C, experimental_getRunnerTask as E, Logger as L, TestProject as T, Vitest as V, DefaultReporter as aA, DotReporter as aB, GithubActionsReporter as aC, HangingProcessReporter as aD, JsonReporter as aE, JUnitReporter as aF, ReportersMap as aG, TapFlatReporter as aH, TapReporter as aI, VerboseBenchmarkReporter as aJ, VerboseReporter as aK, BaseReporter as aL, BenchmarkReporter as ay, BenchmarkReportsMap as az, TestSpecification as k, VitestPackageInstaller as n, TestCase as q, TestCollection as r, TestModule as t };
-export type { BrowserProvider as $, ApiConfig as A, TestSuiteState as D, TestSequencerConstructor as F, BenchmarkUserOptions as G, HTMLOptions as H, InlineConfig as I, JsonOptions as J, BrowserBuiltinProvider as K, ModuleDiagnostic as M, BrowserCommand as N, OnServerRestartHandler as O, Pool as P, BrowserCommandContext as Q, ResolvedCoverageOptions as R, SerializedTestProject as S, UserWorkspaceConfig as U, WatcherTriggerPattern as W, BrowserConfigOptions as X, BrowserInstanceOption as Y, BrowserModuleMocker as Z, BrowserOrchestrator as _, TestProjectConfiguration as a, BrowserProviderInitializationOptions as a0, BrowserProviderModule as a1, BrowserProviderOptions as a2, BrowserScript as a3, BrowserServerState as a4, BrowserServerStateSession as a5, CDPSession as a6, ParentProjectBrowser as a7, ProjectBrowser as a8, ResolvedBrowserOptions as a9, BenchmarkBuiltinReporters as aM, BuiltinReporterOptions as aN, BuiltinReporters as aO, JsonAssertionResult as aP, JsonTestResult as aQ, JsonTestResults as aR, ToMatchScreenshotComparators as aa, ToMatchScreenshotOptions as ab, BuiltinEnvironment as ac, CSSModuleScopeStrategy as ad, DepsOptimizationOptions as ae, EnvironmentOptions as af, PoolOptions as ag, ProjectConfig as ah, ResolvedProjectConfig as ai, ResolveSnapshotPathHandler as aj, ResolveSnapshotPathHandlerContext as ak, TypecheckConfig as al, VitestEnvironment as am, BaseCoverageOptions as an, CoverageIstanbulOptions as ao, CoverageOptions as ap, CoverageProvider as aq, CoverageProviderModule as ar, CoverageReporter as as, CustomProviderOptions as at, TestRunResult as au, ReportedHookContext as av, Reporter as aw, TestRunEndReason as ax, ReportContext as b, CoverageV8Options as c, UserProjectConfigFn as d, UserProjectConfigExport as e, UserConfig as f, TestProjectInlineConfiguration as g, ResolvedConfig as h, VitestRunMode as i, VitestOptions as j, TestSequencer as l, OnTestsRerunHandler as m, JUnitOptions as o, TaskOptions as p, TestDiagnostic as s, TestModuleState as u, TestResult as v, TestResultFailed as w, TestResultPassed as x, TestResultSkipped as y, TestState as z };
+export { CoverageMap as C, TestSuite as K, Logger as L, experimental_getRunnerTask as Q, TestProject as T, Vitest as V, BenchmarkReporter as aE, BenchmarkReportsMap as aF, DefaultReporter as aG, DotReporter as aH, GithubActionsReporter as aI, HangingProcessReporter as aJ, JsonReporter as aK, JUnitReporter as aL, ReportersMap as aM, TapFlatReporter as aN, TapReporter as aO, VerboseBenchmarkReporter as aP, VerboseReporter as aQ, BaseReporter as aR, TestSpecification as k, VitestPackageInstaller as p, TestCase as v, TestCollection as w, TestModule as y };
+export type { BrowserCommand as $, ApiConfig as A, TestResult as B, TestResultFailed as D, TestResultPassed as E, TestResultSkipped as F, TestState as G, HTMLOptions as H, InlineConfig as I, JsonOptions as J, ModuleDiagnostic as M, TestSuiteState as N, OnServerRestartHandler as O, PoolWorker as P, ResolvedCoverageOptions as R, SerializedTestProject as S, UserWorkspaceConfig as U, WatcherTriggerPattern as W, TestSequencerConstructor as X, BenchmarkUserOptions as Y, BrowserBuiltinProvider as Z, _BrowserNames as _, TestProjectConfiguration as a, BrowserCommandContext as a0, BrowserConfigOptions as a1, BrowserInstanceOption as a2, BrowserModuleMocker as a3, BrowserOrchestrator as a4, BrowserProvider as a5, BrowserProviderOption as a6, BrowserScript as a7, BrowserServerFactory as a8, BrowserServerOptions as a9, TestRunResult as aA, ReportedHookContext as aB, Reporter as aC, TestRunEndReason as aD, BenchmarkBuiltinReporters as aS, BuiltinReporterOptions as aT, BuiltinReporters as aU, JsonAssertionResult as aV, JsonTestResult as aW, JsonTestResults as aX, BrowserServerState as aa, BrowserServerStateSession as ab, CDPSession as ac, ParentProjectBrowser as ad, ProjectBrowser as ae, ResolvedBrowserOptions as af, ToMatchScreenshotComparators as ag, ToMatchScreenshotOptions as ah, BuiltinEnvironment as ai, CSSModuleScopeStrategy as aj, DepsOptimizationOptions as ak, EnvironmentOptions as al, Pool as am, ProjectConfig as an, ResolvedProjectConfig as ao, ResolveSnapshotPathHandler as ap, ResolveSnapshotPathHandlerContext as aq, TypecheckConfig as ar, VitestEnvironment as as, BaseCoverageOptions as at, CoverageIstanbulOptions as au, CoverageOptions as av, CoverageProvider as aw, CoverageProviderModule as ax, CoverageReporter as ay, CustomProviderOptions as az, ReportContext as b, CoverageV8Options as c, UserProjectConfigFn as d, UserProjectConfigExport as e, UserConfig as f, TestProjectInlineConfiguration as g, ResolvedConfig as h, VitestRunMode as i, VitestOptions as j, PoolOptions as l, WorkerRequest as m, TestSequencer as n, OnTestsRerunHandler as o, PoolRunnerInitializer as q, PoolTask as r, WorkerResponse as s, JUnitOptions as t, TaskOptions as u, TestDiagnostic as x, TestModuleState as z };