vitest 4.0.0-beta.6 → 4.0.0-beta.7

package/dist/chunks/{reporters.d.CqR9-CDJ.d.ts → reporters.d.BC86JJdB.d.ts}

@@ -1,13 +1,13 @@
-import { Task, CancelReason, TaskMeta, Suite, File, TestAnnotation, ImportDuration, TaskResultPack, SequenceSetupFiles, SequenceHooks } from '@vitest/runner';
-import { ParsedStack, Awaitable, TestError, SerializedError, Arrayable } from '@vitest/utils';
-import { P as ProvidedContext, U as UserConsoleLog, b as Awaitable$1, c as Arrayable$1, A as AfterSuiteRunMeta, L as LabelColor } from './environment.d.2fYMoz3o.js';
+import { Task, CancelReason, TaskMeta, Suite, File, TestAnnotation, ImportDuration, Test, TaskResultPack, SequenceSetupFiles, SequenceHooks } from '@vitest/runner';
+import { ParsedStack, Awaitable, 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 { Writable } from 'node:stream';
 import { ViteDevServer, ModuleNode, TransformResult as TransformResult$1, DepOptimizationConfig, ServerOptions, UserConfig as UserConfig$1, ConfigEnv, AliasOptions } from 'vite';
 import { Console } from 'node:console';
-import { B as BrowserTesterOptions, S as SerializedTestSpecification } from './browser.d.Cawq_X_N.js';
+import { B as BrowserTesterOptions, S as SerializedTestSpecification } from './browser.d.DOMmqJQx.js';
 import { MockedModule } from '@vitest/mocker';
 import { StackTraceParserOptions } from '@vitest/utils/source-map';
-import { a as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.CKNVOKm0.js';
+import { a as SerializedConfig, F as FakeTimerInstallOpts } from './config.d._GBBbReY.js';
 import { PrettyFormatOptions } from '@vitest/pretty-format';
 import { SnapshotSummary, SnapshotStateOptions } from '@vitest/snapshot';
 import { SerializedDiffOptions } from '@vitest/utils/diff';
@@ -108,7 +108,7 @@ declare class Logger {
 	printNoTestFound(filters?: string[]): void;
 	printBanner(): void;
 	printBrowserBanner(project: TestProject): void;
-	printUnhandledErrors(errors: unknown[]): void;
+	printUnhandledErrors(errors: ReadonlyArray<unknown>): void;
 	printSourceTypeErrors(errors: TypeCheckError[]): void;
 	getColumns(): number;
 	onTerminalCleanup(listener: Listener): void;
@@ -296,6 +296,15 @@ interface BrowserConfigOptions {
 			comparatorOptions?: ToMatchScreenshotComparators[ComparatorName];
 		} }[keyof ToMatchScreenshotComparators] & ToMatchScreenshotOptions;
 	};
+	/**
+	* 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
+	*/
+	trackUnhandledErrors?: boolean;
 }
 interface BrowserCommandContext {
 	testPath: string | undefined;
@@ -772,6 +781,10 @@ interface ModuleDiagnostic {
 	*/
 	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;
 
 type BuiltinPool = "browser" | "threads" | "forks" | "vmThreads" | "vmForks" | "typescript";
 type Pool = BuiltinPool | (string & {});
@@ -966,9 +979,9 @@ declare class TestProject {
 	* 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 testFilesList;
 	private typecheckFilesList;
 	private _globalSetups?;
 	private _provided;
@@ -1114,213 +1127,633 @@ interface ProcessPool {
 }
 declare function getFilePoolName(project: TestProject): Pool;
 
-interface TestRunResult {
-	testModules: TestModule[];
-	unhandledErrors: unknown[];
+interface CoverageSummaryData {
+    lines: Totals;
+    statements: Totals;
+    branches: Totals;
+    functions: Totals;
 }
 
-interface SuiteResultCache {
-	failed: boolean;
-	duration: number;
+declare class CoverageSummary {
+    constructor(data: CoverageSummary | CoverageSummaryData);
+    merge(obj: CoverageSummary): CoverageSummary;
+    toJSON(): CoverageSummaryData;
+    isEmpty(): boolean;
+    data: CoverageSummaryData;
+    lines: Totals;
+    statements: Totals;
+    branches: Totals;
+    functions: Totals;
 }
-declare class ResultsCache {
-	private cache;
-	private workspacesKeyMap;
-	private cachePath;
-	private version;
-	private root;
-	constructor(version: string);
-	getCachePath(): string | null;
-	setConfig(root: string, config: ResolvedConfig["cache"]): void;
-	getResults(key: string): SuiteResultCache | undefined;
-	readFromCache(): Promise<void>;
-	updateResults(files: File[]): void;
-	removeFromCache(filepath: string): void;
-	writeToCache(): Promise<void>;
+
+interface CoverageMapData {
+    [key: string]: FileCoverage | FileCoverageData;
 }
 
-type FileStatsCache = Pick<Stats, "size">;
-declare class FilesStatsCache {
-	cache: Map<string, FileStatsCache>;
-	getStats(key: string): FileStatsCache | undefined;
-	populateStats(root: string, specs: TestSpecification[]): Promise<void>;
-	updateStats(fsPath: string, key: string): Promise<void>;
-	removeStats(fsPath: string): void;
+declare class CoverageMap {
+    constructor(data: CoverageMapData | CoverageMap);
+    addFileCoverage(pathOrObject: string | FileCoverage | FileCoverageData): void;
+    files(): string[];
+    fileCoverageFor(filename: string): FileCoverage;
+    filter(callback: (key: string) => boolean): void;
+    getCoverageSummary(): CoverageSummary;
+    merge(data: CoverageMapData | CoverageMap): void;
+    toJSON(): CoverageMapData;
+    data: CoverageMapData;
 }
 
-declare class VitestCache {
-	results: ResultsCache;
-	stats: FilesStatsCache;
-	constructor(version: string);
-	getFileTestResults(key: string): SuiteResultCache | undefined;
-	getFileStats(key: string): {
-		size: number;
-	} | undefined;
-	static resolveCacheDir(root: string, dir?: string, projectName?: string): string;
+interface Location {
+    line: number;
+    column: number;
 }
 
-declare class VitestPackageInstaller {
-	isPackageExists(name: string, options?: {
-		paths?: string[];
-	}): boolean;
-	ensureInstalled(dependency: string, root: string, version?: string): Promise<boolean>;
+interface Range {
+    start: Location;
+    end: Location;
 }
 
-interface BlobOptions {
-	outputFile?: string;
+interface BranchMapping {
+    loc: Range;
+    type: string;
+    locations: Range[];
+    line: number;
 }
-declare class BlobReporter implements Reporter {
-	start: number;
-	ctx: Vitest;
-	options: BlobOptions;
-	coverage: unknown | undefined;
-	constructor(options: BlobOptions);
-	onInit(ctx: Vitest): void;
-	onCoverage(coverage: unknown): void;
-	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>): Promise<void>;
+
+interface FunctionMapping {
+    name: string;
+    decl: Range;
+    loc: Range;
+    line: number;
 }
-interface MergedBlobs {
-	files: File[];
-	errors: unknown[];
-	coverages: unknown[];
-	executionTimes: number[];
+
+interface FileCoverageData {
+    path: string;
+    statementMap: { [key: string]: Range };
+    fnMap: { [key: string]: FunctionMapping };
+    branchMap: { [key: string]: BranchMapping };
+    s: { [key: string]: number };
+    f: { [key: string]: number };
+    b: { [key: string]: number[] };
 }
 
-declare class StateManager {
-	filesMap: Map<string, File[]>;
-	pathsSet: Set<string>;
-	idMap: Map<string, Task>;
-	taskFileMap: WeakMap<Task, File>;
-	errorsSet: Set<unknown>;
-	processTimeoutCauses: Set<string>;
-	reportedTasksMap: WeakMap<Task, TestModule | TestCase | TestSuite>;
-	blobs?: MergedBlobs;
-	transformTime: number;
-	onUnhandledError?: OnUnhandledErrorCallback;
-	constructor(options: {
-		onUnhandledError?: OnUnhandledErrorCallback;
-	});
-	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.
-	*/
-	getFiles(keys?: string[]): File[];
-	getTestModules(keys?: string[]): TestModule[];
-	getFilepaths(): string[];
-	getFailedFilepaths(): string[];
-	collectPaths(paths?: string[]): void;
-	collectFiles(project: TestProject, files?: File[]): void;
-	clearFiles(project: TestProject, paths?: string[]): void;
-	updateId(task: Task, project: TestProject): void;
-	getReportedEntity(task: Task): TestModule | TestCase | TestSuite | undefined;
-	updateTasks(packs: TaskResultPack[]): void;
-	updateUserLog(log: UserConsoleLog): void;
-	getCountOfFailedTests(): number;
-	cancelFiles(files: string[], project: TestProject): void;
+interface Totals {
+    total: number;
+    covered: number;
+    skipped: number;
+    pct: number;
 }
 
-interface VitestOptions {
-	packageInstaller?: VitestPackageInstaller;
-	stdin?: NodeJS.ReadStream;
-	stdout?: NodeJS.WriteStream | Writable;
-	stderr?: NodeJS.WriteStream | Writable;
+interface Coverage {
+    covered: number;
+    total: number;
+    coverage: number;
 }
-declare class Vitest {
-	readonly mode: VitestRunMode;
-	/**
-	* Current Vitest version.
-	* @example '2.0.0'
-	*/
-	readonly version: string;
-	static readonly version: string;
-	/**
-	* The logger instance used to log messages. It's recommended to use this logger instead of `console`.
-	* It's possible to override stdout and stderr streams when initiating Vitest.
-	* @example
-	* new Vitest('test', {
-	*   stdout: new Writable(),
-	* })
-	*/
-	readonly logger: Logger;
-	/**
-	* The package installer instance used to install Vitest packages.
-	* @example
-	* await vitest.packageInstaller.ensureInstalled('@vitest/browser', process.cwd())
-	*/
-	readonly packageInstaller: VitestPackageInstaller;
-	/**
-	* A path to the built Vitest directory. This is usually a folder in `node_modules`.
-	*/
-	readonly distPath: string;
-	/**
-	* A list of projects that are currently running.
-	* If projects were filtered with `--project` flag, they won't appear here.
-	*/
-	projects: TestProject[];
-	private isFirstRun;
-	private restartsCount;
-	private readonly specifications;
-	private readonly watcher;
-	private pool;
-	private _config?;
-	private _vite?;
-	private _state?;
-	private _cache?;
-	private _snapshot?;
-	constructor(mode: VitestRunMode, cliOptions: UserConfig, options?: VitestOptions);
-	private _onRestartListeners;
-	private _onClose;
-	private _onSetServer;
-	private _onCancelListeners;
-	private _onUserTestsRerun;
-	private _onFilterWatchedSpecification;
-	/** @deprecated will be removed in 4.0, use `onFilterWatchedSpecification` instead */
-	get invalidates(): Set<string>;
-	/** @deprecated will be removed in 4.0, use `onFilterWatchedSpecification` instead */
-	get changedTests(): Set<string>;
-	/**
-	* The global config.
-	*/
-	get config(): ResolvedConfig;
-	/** @deprecated use `vitest.vite` instead */
-	get server(): ViteDevServer;
-	/**
-	* Global Vite's dev server instance.
-	*/
-	get vite(): ViteDevServer;
-	/**
-	* The global test state manager.
-	* @experimental The State API is experimental and not subject to semver.
-	*/
-	get state(): StateManager;
-	/**
-	* The global snapshot manager. You can access the current state on `snapshot.summary`.
-	*/
-	get snapshot(): SnapshotManager;
-	/**
-	* Test results and test file stats cache. Primarily used by the sequencer to sort tests.
-	*/
-	get cache(): VitestCache;
-	/** @deprecated internal */
-	setServer(options: UserConfig, server: ViteDevServer): Promise<void>;
-	/**
-	* 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.
-	*/
+
+declare class FileCoverage implements FileCoverageData {
+    constructor(data: string | FileCoverage | FileCoverageData);
+    merge(other: FileCoverageData): void;
+    getBranchCoverageByLine(): { [line: number]: Coverage };
+    getLineCoverage(): { [line: number]: number };
+    getUncoveredLines(): number[];
+    resetHits(): void;
+    computeBranchTotals(): Totals;
+    computeSimpleTotals(): Totals;
+    toSummary(): CoverageSummary;
+    toJSON(): object;
+
+    data: FileCoverageData;
+    path: string;
+    statementMap: { [key: string]: Range };
+    fnMap: { [key: string]: FunctionMapping };
+    branchMap: { [key: string]: BranchMapping };
+    s: { [key: string]: number };
+    f: { [key: string]: number };
+    b: { [key: string]: number[] };
+}
+
+interface Node {
+    isRoot(): boolean;
+    visit(visitor: Visitor, state: any): void;
+}
+
+interface Visitor<N extends Node = Node> {
+    onStart(root: N, state: any): void;
+    onSummary(root: N, state: any): void;
+    onDetail(root: N, state: any): void;
+    onSummaryEnd(root: N, state: any): void;
+    onEnd(root: N, state: any): void;
+}
+
+interface FileOptions {
+    file: string;
+}
+
+interface ProjectOptions {
+    projectRoot: string;
+}
+
+interface ReportOptions {
+    clover: CloverOptions;
+    cobertura: CoberturaOptions;
+    "html-spa": HtmlSpaOptions;
+    html: HtmlOptions;
+    json: JsonOptions$1;
+    "json-summary": JsonSummaryOptions;
+    lcov: LcovOptions;
+    lcovonly: LcovOnlyOptions;
+    none: never;
+    teamcity: TeamcityOptions;
+    text: TextOptions;
+    "text-lcov": TextLcovOptions;
+    "text-summary": TextSummaryOptions;
+}
+
+interface CloverOptions extends FileOptions, ProjectOptions {}
+
+interface CoberturaOptions extends FileOptions, ProjectOptions {}
+
+interface HtmlSpaOptions extends HtmlOptions {
+    metricsToShow: Array<"lines" | "branches" | "functions" | "statements">;
+}
+interface HtmlOptions {
+    verbose: boolean;
+    skipEmpty: boolean;
+    subdir: string;
+    linkMapper: LinkMapper;
+}
+
+type JsonOptions$1 = FileOptions;
+type JsonSummaryOptions = FileOptions;
+
+interface LcovOptions extends FileOptions, ProjectOptions {}
+interface LcovOnlyOptions extends FileOptions, ProjectOptions {}
+
+interface TeamcityOptions extends FileOptions {
+    blockName: string;
+}
+
+interface TextOptions extends FileOptions {
+    maxCols: number;
+    skipEmpty: boolean;
+    skipFull: boolean;
+}
+type TextLcovOptions = ProjectOptions;
+type TextSummaryOptions = FileOptions;
+
+interface LinkMapper {
+    getPath(node: string | Node): string;
+    relativePath(source: string | Node, target: string | Node): string;
+    assetPath(node: Node, name: string): string;
+}
+
+type TransformResult = string | Partial<TransformResult$1> | undefined | null | void;
+type CoverageResults = unknown;
+interface CoverageProvider {
+	name: string;
+	/** Called when provider is being initialized before tests run */
+	initialize: (ctx: Vitest) => Promise<void> | void;
+	/** Called when setting coverage options for Vitest context (`ctx.config.coverage`) */
+	resolveOptions: () => ResolvedCoverageOptions;
+	/** Callback to clean previous reports */
+	clean: (clean?: boolean) => void | Promise<void>;
+	/** Called with coverage results after a single test file has been run */
+	onAfterSuiteRun: (meta: AfterSuiteRunMeta) => void | Promise<void>;
+	/** Callback called when test run fails */
+	onTestFailure?: () => void | Promise<void>;
+	/** Callback to generate final coverage results */
+	generateCoverage: (reportContext: ReportContext) => CoverageResults | Promise<CoverageResults>;
+	/** Callback to convert coverage results to coverage reports. Called with results returned from `generateCoverage` */
+	reportCoverage: (coverage: CoverageResults, reportContext: ReportContext) => void | Promise<void>;
+	/** Callback for `--merge-reports` options. Called with multiple coverage results generated by `generateCoverage`. */
+	mergeReports?: (coverages: CoverageResults[]) => void | Promise<void>;
+	/** Callback called for instrumenting files with coverage counters. */
+	onFileTransform?: (sourceCode: string, id: string, pluginCtx: any) => TransformResult | Promise<TransformResult>;
+}
+interface ReportContext {
+	/** Indicates whether all tests were run. False when only specific tests were run. */
+	allTestsRun?: boolean;
+}
+interface CoverageProviderModule extends RuntimeCoverageProviderModule {
+	/**
+	* Factory for creating a new coverage provider
+	*/
+	getProvider: () => CoverageProvider | Promise<CoverageProvider>;
+}
+type CoverageReporter = keyof ReportOptions | (string & {});
+type CoverageReporterWithOptions<ReporterName extends CoverageReporter = CoverageReporter> = ReporterName extends keyof ReportOptions ? ReportOptions[ReporterName] extends never ? [ReporterName, object] : [ReporterName, Partial<ReportOptions[ReporterName]>] : [ReporterName, Record<string, unknown>];
+type CoverageProviderName = "v8" | "istanbul" | "custom" | undefined;
+type CoverageOptions<T extends CoverageProviderName = CoverageProviderName> = T extends "istanbul" ? {
+	provider: T;
+} & CoverageIstanbulOptions : T extends "v8" ? {
+	/**
+	* Provider to use for coverage collection.
+	*
+	* @default 'v8'
+	*/
+	provider: T;
+} & CoverageV8Options : T extends "custom" ? {
+	provider: T;
+} & CustomProviderOptions : {
+	provider?: T;
+} & CoverageV8Options;
+/** Fields that have default values. Internally these will always be defined. */
+type FieldsWithDefaultValues = "enabled" | "clean" | "cleanOnRerun" | "reportsDirectory" | "exclude" | "reportOnFailure" | "allowExternal" | "processingConcurrency";
+type ResolvedCoverageOptions<T extends CoverageProviderName = CoverageProviderName> = CoverageOptions<T> & Required<Pick<CoverageOptions<T>, FieldsWithDefaultValues>> & {
+	reporter: CoverageReporterWithOptions[];
+};
+interface BaseCoverageOptions {
+	/**
+	* Enables coverage collection. Can be overridden using `--coverage` CLI option.
+	*
+	* @default false
+	*/
+	enabled?: boolean;
+	/**
+	* List of files included in coverage as glob patterns.
+	* By default only files covered by tests are included.
+	*
+	* See [Including and excluding files from coverage report](https://vitest.dev/guide/coverage.html#including-and-excluding-files-from-coverage-report) for examples.
+	*/
+	include?: string[];
+	/**
+	* List of files excluded from coverage as glob patterns.
+	* Files are first checked against `coverage.include`.
+	*
+	* See [Including and excluding files from coverage report](https://vitest.dev/guide/coverage.html#including-and-excluding-files-from-coverage-report) for examples.
+	*/
+	exclude?: string[];
+	/**
+	* Clean coverage results before running tests
+	*
+	* @default true
+	*/
+	clean?: boolean;
+	/**
+	* Clean coverage report on watch rerun
+	*
+	* @default true
+	*/
+	cleanOnRerun?: boolean;
+	/**
+	* Directory to write coverage report to
+	*
+	* @default './coverage'
+	*/
+	reportsDirectory?: string;
+	/**
+	* Coverage reporters to use.
+	* See [istanbul documentation](https://istanbul.js.org/docs/advanced/alternative-reporters/) for detailed list of all reporters.
+	*
+	* @default ['text', 'html', 'clover', 'json']
+	*/
+	reporter?: Arrayable<CoverageReporter> | (CoverageReporter | [CoverageReporter] | CoverageReporterWithOptions)[];
+	/**
+	* Do not show files with 100% statement, branch, and function coverage
+	*
+	* @default false
+	*/
+	skipFull?: boolean;
+	/**
+	* Configurations for thresholds
+	*
+	* @example
+	*
+	* ```ts
+	* {
+	*   // Thresholds for all files
+	*   functions: 95,
+	*   branches: 70,
+	*   perFile: true,
+	*   autoUpdate: true,
+	*
+	*   // Thresholds for utilities
+	*   'src/utils/**.ts': {
+	*     lines: 100,
+	*     statements: 95,
+	*   }
+	* }
+	* ```
+	*/
+	thresholds?: Thresholds | ({
+		[glob: string]: Pick<Thresholds, 100 | "statements" | "functions" | "branches" | "lines">;
+	} & Thresholds);
+	/**
+	* Watermarks for statements, lines, branches and functions.
+	*
+	* Default value is `[50,80]` for each property.
+	*/
+	watermarks?: {
+		statements?: [number, number];
+		functions?: [number, number];
+		branches?: [number, number];
+		lines?: [number, number];
+	};
+	/**
+	* Generate coverage report even when tests fail.
+	*
+	* @default false
+	*/
+	reportOnFailure?: boolean;
+	/**
+	* Collect coverage of files outside the project `root`.
+	*
+	* @default false
+	*/
+	allowExternal?: boolean;
+	/**
+	* Apply exclusions again after coverage has been remapped to original sources.
+	* This is useful when your source files are transpiled and may contain source maps
+	* of non-source files.
+	*
+	* Use this option when you are seeing files that show up in report even if they
+	* match your `coverage.exclude` patterns.
+	*
+	* @default false
+	*/
+	excludeAfterRemap?: boolean;
+	/**
+	* Concurrency limit used when processing the coverage results.
+	* Defaults to `Math.min(20, os.availableParallelism?.() ?? os.cpus().length)`
+	*/
+	processingConcurrency?: number;
+	/**
+	* Set to array of class method names to ignore for coverage
+	*
+	* @default []
+	*/
+	ignoreClassMethods?: string[];
+}
+interface CoverageIstanbulOptions extends BaseCoverageOptions {}
+interface CoverageV8Options extends BaseCoverageOptions {}
+interface CustomProviderOptions extends Pick<BaseCoverageOptions, FieldsWithDefaultValues> {
+	/** Name of the module or path to a file to load the custom provider from */
+	customProviderModule: string;
+}
+interface Thresholds {
+	/** Set global thresholds to `100` */
+	100?: boolean;
+	/** Check thresholds per file. */
+	perFile?: boolean;
+	/**
+	* Update threshold values automatically when current coverage is higher than earlier thresholds
+	*
+	* @default false
+	*/
+	autoUpdate?: boolean;
+	/** Thresholds for statements */
+	statements?: number;
+	/** Thresholds for functions */
+	functions?: number;
+	/** Thresholds for branches */
+	branches?: number;
+	/** Thresholds for lines */
+	lines?: number;
+}
+
+interface TestRunResult {
+	testModules: TestModule[];
+	unhandledErrors: unknown[];
+}
+
+interface SuiteResultCache {
+	failed: boolean;
+	duration: number;
+}
+declare class ResultsCache {
+	private cache;
+	private workspacesKeyMap;
+	private cachePath;
+	private version;
+	private root;
+	constructor(version: string);
+	getCachePath(): string | null;
+	setConfig(root: string, config: ResolvedConfig["cache"]): void;
+	getResults(key: string): SuiteResultCache | undefined;
+	readFromCache(): Promise<void>;
+	updateResults(files: File[]): void;
+	removeFromCache(filepath: string): void;
+	writeToCache(): Promise<void>;
+}
+
+type FileStatsCache = Pick<Stats, "size">;
+declare class FilesStatsCache {
+	cache: Map<string, FileStatsCache>;
+	getStats(key: string): FileStatsCache | undefined;
+	populateStats(root: string, specs: TestSpecification[]): Promise<void>;
+	updateStats(fsPath: string, key: string): Promise<void>;
+	removeStats(fsPath: string): void;
+}
+
+declare class VitestCache {
+	results: ResultsCache;
+	stats: FilesStatsCache;
+	constructor(version: string);
+	getFileTestResults(key: string): SuiteResultCache | undefined;
+	getFileStats(key: string): {
+		size: number;
+	} | undefined;
+	static resolveCacheDir(root: string, dir?: string, projectName?: string): string;
+}
+
+declare class VitestPackageInstaller {
+	isPackageExists(name: string, options?: {
+		paths?: string[];
+	}): boolean;
+	ensureInstalled(dependency: string, root: string, version?: string): Promise<boolean>;
+}
+
+interface BlobOptions {
+	outputFile?: string;
+}
+declare class BlobReporter implements Reporter {
+	start: number;
+	ctx: Vitest;
+	options: BlobOptions;
+	coverage: unknown | undefined;
+	constructor(options: BlobOptions);
+	onInit(ctx: Vitest): void;
+	onCoverage(coverage: unknown): void;
+	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>): Promise<void>;
+}
+interface MergedBlobs {
+	files: File[];
+	errors: unknown[];
+	coverages: unknown[];
+	executionTimes: number[];
+}
+
+declare class StateManager {
+	filesMap: Map<string, File[]>;
+	pathsSet: Set<string>;
+	idMap: Map<string, Task>;
+	taskFileMap: WeakMap<Task, File>;
+	errorsSet: Set<unknown>;
+	processTimeoutCauses: Set<string>;
+	reportedTasksMap: WeakMap<Task, TestModule | TestCase | TestSuite>;
+	blobs?: MergedBlobs;
+	transformTime: number;
+	onUnhandledError?: OnUnhandledErrorCallback;
+	constructor(options: {
+		onUnhandledError?: OnUnhandledErrorCallback;
+	});
+	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.
+	*/
+	getFiles(keys?: string[]): File[];
+	getTestModules(keys?: string[]): TestModule[];
+	getFilepaths(): string[];
+	getFailedFilepaths(): string[];
+	collectPaths(paths?: string[]): void;
+	collectFiles(project: TestProject, files?: File[]): void;
+	clearFiles(project: TestProject, paths?: string[]): void;
+	updateId(task: Task, project: TestProject): void;
+	getReportedEntity(task: Task): TestModule | TestCase | TestSuite | undefined;
+	updateTasks(packs: TaskResultPack[]): void;
+	updateUserLog(log: UserConsoleLog): void;
+	getCountOfFailedTests(): number;
+	cancelFiles(files: string[], project: TestProject): void;
+}
+
+declare class VitestWatcher {
+	private vitest;
+	/**
+	* Modules that will be invalidated on the next run.
+	*/
+	readonly invalidates: Set<string>;
+	/**
+	* Test files that have changed and need to be rerun.
+	*/
+	readonly changedTests: Set<string>;
+	private readonly _onRerun;
+	constructor(vitest: Vitest);
+	unregisterWatcher: () => void;
+	registerWatcher(): this;
+	private scheduleRerun;
+	private getTestFilesFromWatcherTrigger;
+	onFileChange: (id: string) => void;
+	onFileDelete: (id: string) => void;
+	onFileCreate: (id: string) => void;
+	private handleSetupFile;
+	/**
+	* @returns A value indicating whether rerun is needed (changedTests was mutated)
+	*/
+	private handleFileChanged;
+}
+interface WatcherTriggerPattern {
+	pattern: RegExp;
+	testsToRun: (file: string, match: RegExpMatchArray) => string[] | string | null | undefined | void;
+}
+
+interface VitestOptions {
+	packageInstaller?: VitestPackageInstaller;
+	stdin?: NodeJS.ReadStream;
+	stdout?: NodeJS.WriteStream | Writable;
+	stderr?: NodeJS.WriteStream | Writable;
+}
+declare class Vitest {
+	readonly mode: VitestRunMode;
+	/**
+	* Current Vitest version.
+	* @example '2.0.0'
+	*/
+	readonly version: string;
+	static readonly version: string;
+	/**
+	* The logger instance used to log messages. It's recommended to use this logger instead of `console`.
+	* It's possible to override stdout and stderr streams when initiating Vitest.
+	* @example
+	* new Vitest('test', {
+	*   stdout: new Writable(),
+	* })
+	*/
+	readonly logger: Logger;
+	/**
+	* The package installer instance used to install Vitest packages.
+	* @example
+	* await vitest.packageInstaller.ensureInstalled('@vitest/browser', process.cwd())
+	*/
+	readonly packageInstaller: VitestPackageInstaller;
+	/**
+	* A path to the built Vitest directory. This is usually a folder in `node_modules`.
+	*/
+	readonly distPath: string;
+	/**
+	* A list of projects that are currently running.
+	* If projects were filtered with `--project` flag, they won't appear here.
+	*/
+	projects: TestProject[];
+	/**
+	* A watcher handler. This is not the file system watcher. The handler only
+	* exposes methods to handle changed files.
+	*
+	* If you have your own watcher, you can use these methods to replicate
+	* Vitest behaviour.
+	*/
+	readonly watcher: VitestWatcher;
+	private isFirstRun;
+	private restartsCount;
+	private readonly specifications;
+	private pool;
+	private _config?;
+	private _vite?;
+	private _state?;
+	private _cache?;
+	private _snapshot?;
+	constructor(mode: VitestRunMode, cliOptions: UserConfig, options?: VitestOptions);
+	private _onRestartListeners;
+	private _onClose;
+	private _onSetServer;
+	private _onCancelListeners;
+	private _onUserTestsRerun;
+	private _onFilterWatchedSpecification;
+	/** @deprecated will be removed in 4.0, use `onFilterWatchedSpecification` instead */
+	get invalidates(): Set<string>;
+	/** @deprecated will be removed in 4.0, use `onFilterWatchedSpecification` instead */
+	get changedTests(): Set<string>;
+	/**
+	* The global config.
+	*/
+	get config(): ResolvedConfig;
+	/** @deprecated use `vitest.vite` instead */
+	get server(): ViteDevServer;
+	/**
+	* Global Vite's dev server instance.
+	*/
+	get vite(): ViteDevServer;
+	/**
+	* The global test state manager.
+	* @experimental The State API is experimental and not subject to semver.
+	*/
+	get state(): StateManager;
+	/**
+	* The global snapshot manager. You can access the current state on `snapshot.summary`.
+	*/
+	get snapshot(): SnapshotManager;
+	/**
+	* Test results and test file stats cache. Primarily used by the sequencer to sort tests.
+	*/
+	get cache(): VitestCache;
+	/** @deprecated internal */
+	setServer(options: UserConfig, server: ViteDevServer): Promise<void>;
+	/**
+	* 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;
 	/** @deprecated use `getRootProject` instead */
 	getCoreWorkspaceProject(): TestProject;
@@ -1338,6 +1771,10 @@ declare class Vitest {
 	* @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.
@@ -1378,6 +1815,11 @@ declare class Vitest {
 	/** @deprecated */
 	getFileWorkspaceSpecs(file: string): WorkspaceSpec[];
 	/**
+	* 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.
@@ -1401,6 +1843,11 @@ declare class Vitest {
 	*/
 	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.
@@ -1438,7 +1885,6 @@ declare class Vitest {
 	*/
 	resetGlobalTestNamePattern(): void;
 	private _rerunTimer;
-	// we can't use a single `triggerId` yet because vscode extension relies on this
 	private scheduleRerun;
 	/**
 	* Invalidate a file in all projects.
@@ -1573,182 +2019,78 @@ interface Reporter {
 	/**
 	* Called after the hook finished running.
 	*/
-	onHookEnd?: (hook: ReportedHookContext) => Awaitable$1<void>;
-	onCoverage?: (coverage: unknown) => Awaitable$1<void>;
-}
-
-interface BaseOptions {
-	isTTY?: boolean;
-}
-declare abstract class BaseReporter implements Reporter {
-	start: number;
-	end: number;
-	watchFilters?: string[];
-	failedUnwatchedFiles: TestModule[];
-	isTTY: boolean;
-	ctx: Vitest;
-	renderSucceed: boolean;
-	protected verbose: boolean;
-	private _filesInWatchMode;
-	private _timeStart;
-	constructor(options?: BaseOptions);
-	onInit(ctx: Vitest): void;
-	log(...messages: any): void;
-	error(...messages: any): void;
-	relative(path: string): string;
-	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, _reason: TestRunEndReason): void;
-	onTestCaseResult(testCase: TestCase): void;
-	onTestSuiteResult(testSuite: TestSuite): void;
-	onTestModuleEnd(testModule: TestModule): void;
-	private logFailedTask;
-	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 getFullName(test: Task, separator?: string): string;
-	protected formatShortError(error: TestError): string;
-	protected getTestIndentation(_test: Task): string;
-	protected printAnnotations(test: TestCase, console: "log" | "error", padding?: number): void;
-	protected getDurationPrefix(task: Task): string;
-	onWatcherStart(files?: File[], errors?: unknown[]): void;
-	onWatcherRerun(files: string[], trigger?: string): void;
-	onUserConsoleLog(log: UserConsoleLog, taskState?: TestResult["state"]): void;
-	onTestRemoved(trigger?: string): void;
-	shouldLog(log: UserConsoleLog, taskState?: TestResult["state"]): boolean;
-	onServerRestart(reason?: string): void;
-	reportSummary(files: File[], errors: unknown[]): void;
-	reportTestSummary(files: File[], errors: unknown[]): void;
-	private printErrorsSummary;
-	reportBenchmarkSummary(files: File[]): void;
-	private printTaskErrors;
-}
-
-interface DefaultReporterOptions extends BaseOptions {
-	summary?: boolean;
-}
-declare class DefaultReporter extends BaseReporter {
-	private options;
-	private summary?;
-	constructor(options?: DefaultReporterOptions);
-	onTestRunStart(specifications: ReadonlyArray<TestSpecification>): void;
-	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): void;
-	onTestModuleQueued(file: TestModule): void;
-	onTestModuleCollected(module: TestModule): void;
-	onTestModuleEnd(module: TestModule): void;
-	onTestCaseReady(test: TestCase): void;
-	onTestCaseResult(test: TestCase): void;
-	onHookStart(hook: ReportedHookContext): void;
-	onHookEnd(hook: ReportedHookContext): void;
-	onInit(ctx: Vitest): void;
-}
-
-interface HTMLOptions {
-	outputFile?: string;
-}
-
-interface CoverageSummaryData {
-    lines: Totals;
-    statements: Totals;
-    branches: Totals;
-    functions: Totals;
-}
-
-declare class CoverageSummary {
-    constructor(data: CoverageSummary | CoverageSummaryData);
-    merge(obj: CoverageSummary): CoverageSummary;
-    toJSON(): CoverageSummaryData;
-    isEmpty(): boolean;
-    data: CoverageSummaryData;
-    lines: Totals;
-    statements: Totals;
-    branches: Totals;
-    functions: Totals;
-}
-
-interface CoverageMapData {
-    [key: string]: FileCoverage | FileCoverageData;
-}
-
-declare class CoverageMap {
-    constructor(data: CoverageMapData | CoverageMap);
-    addFileCoverage(pathOrObject: string | FileCoverage | FileCoverageData): void;
-    files(): string[];
-    fileCoverageFor(filename: string): FileCoverage;
-    filter(callback: (key: string) => boolean): void;
-    getCoverageSummary(): CoverageSummary;
-    merge(data: CoverageMapData | CoverageMap): void;
-    toJSON(): CoverageMapData;
-    data: CoverageMapData;
-}
-
-interface Location {
-    line: number;
-    column: number;
-}
-
-interface Range {
-    start: Location;
-    end: Location;
-}
-
-interface BranchMapping {
-    loc: Range;
-    type: string;
-    locations: Range[];
-    line: number;
-}
-
-interface FunctionMapping {
-    name: string;
-    decl: Range;
-    loc: Range;
-    line: number;
-}
-
-interface FileCoverageData {
-    path: string;
-    statementMap: { [key: string]: Range };
-    fnMap: { [key: string]: FunctionMapping };
-    branchMap: { [key: string]: BranchMapping };
-    s: { [key: string]: number };
-    f: { [key: string]: number };
-    b: { [key: string]: number[] };
+	onHookEnd?: (hook: ReportedHookContext) => Awaitable$1<void>;
+	onCoverage?: (coverage: unknown) => Awaitable$1<void>;
 }
 
-interface Totals {
-    total: number;
-    covered: number;
-    skipped: number;
-    pct: number;
+interface BaseOptions {
+	isTTY?: boolean;
 }
-
-interface Coverage {
-    covered: number;
-    total: number;
-    coverage: number;
+declare abstract class BaseReporter implements Reporter {
+	start: number;
+	end: number;
+	watchFilters?: string[];
+	failedUnwatchedFiles: TestModule[];
+	isTTY: boolean;
+	ctx: Vitest;
+	renderSucceed: boolean;
+	protected verbose: boolean;
+	private _filesInWatchMode;
+	private _timeStart;
+	constructor(options?: BaseOptions);
+	onInit(ctx: Vitest): void;
+	log(...messages: any): void;
+	error(...messages: any): void;
+	relative(path: string): string;
+	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, _reason: TestRunEndReason): void;
+	onTestCaseResult(testCase: TestCase): void;
+	onTestSuiteResult(testSuite: TestSuite): void;
+	onTestModuleEnd(testModule: TestModule): void;
+	private logFailedTask;
+	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 getFullName(test: Task, separator?: string): string;
+	protected formatShortError(error: TestError): string;
+	protected getTestIndentation(_test: Task): string;
+	protected printAnnotations(test: TestCase, console: "log" | "error", padding?: number): void;
+	protected getDurationPrefix(task: Task): string;
+	onWatcherStart(files?: File[], errors?: unknown[]): void;
+	onWatcherRerun(files: string[], trigger?: string): void;
+	onUserConsoleLog(log: UserConsoleLog, taskState?: TestResult["state"]): void;
+	onTestRemoved(trigger?: string): void;
+	shouldLog(log: UserConsoleLog, taskState?: TestResult["state"]): boolean;
+	onServerRestart(reason?: string): void;
+	reportSummary(files: File[], errors: unknown[]): void;
+	reportTestSummary(files: File[], errors: unknown[]): void;
+	private printErrorsSummary;
+	reportBenchmarkSummary(files: File[]): void;
+	private printTaskErrors;
 }
 
-declare class FileCoverage implements FileCoverageData {
-    constructor(data: string | FileCoverage | FileCoverageData);
-    merge(other: FileCoverageData): void;
-    getBranchCoverageByLine(): { [line: number]: Coverage };
-    getLineCoverage(): { [line: number]: number };
-    getUncoveredLines(): number[];
-    resetHits(): void;
-    computeBranchTotals(): Totals;
-    computeSimpleTotals(): Totals;
-    toSummary(): CoverageSummary;
-    toJSON(): object;
+interface DefaultReporterOptions extends BaseOptions {
+	summary?: boolean;
+}
+declare class DefaultReporter extends BaseReporter {
+	private options;
+	private summary?;
+	constructor(options?: DefaultReporterOptions);
+	onTestRunStart(specifications: ReadonlyArray<TestSpecification>): void;
+	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): void;
+	onTestModuleQueued(file: TestModule): void;
+	onTestModuleCollected(module: TestModule): void;
+	onTestModuleEnd(module: TestModule): void;
+	onTestCaseReady(test: TestCase): void;
+	onTestCaseResult(test: TestCase): void;
+	onHookStart(hook: ReportedHookContext): void;
+	onHookEnd(hook: ReportedHookContext): void;
+	onInit(ctx: Vitest): void;
+}
 
-    data: FileCoverageData;
-    path: string;
-    statementMap: { [key: string]: Range };
-    fnMap: { [key: string]: FunctionMapping };
-    branchMap: { [key: string]: BranchMapping };
-    s: { [key: string]: number };
-    f: { [key: string]: number };
-    b: { [key: string]: number[] };
+interface HTMLOptions {
+	outputFile?: string;
 }
 
 // for compatibility reasons, the reporter produces a JSON similar to the one produced by the Jest JSON reporter
@@ -1794,15 +2136,15 @@ interface JsonTestResults {
 	snapshot: SnapshotSummary;
 	coverageMap?: CoverageMap | null | undefined;
 }
-interface JsonOptions$1 {
+interface JsonOptions {
 	outputFile?: string;
 }
 declare class JsonReporter implements Reporter {
 	start: number;
 	ctx: Vitest;
-	options: JsonOptions$1;
+	options: JsonOptions;
 	coverageMap?: CoverageMap;
-	constructor(options: JsonOptions$1);
+	constructor(options: JsonOptions);
 	onInit(ctx: Vitest): void;
 	onCoverage(coverageMap: unknown): void;
 	onTestRunEnd(testModules: ReadonlyArray<TestModule>): Promise<void>;
@@ -1926,391 +2268,107 @@ declare function renderTable(options: {
 	compare?: Record<Task["id"], FormattedBenchmarkResult>;
 }): string;
 
-declare class BenchmarkReporter extends DefaultReporter {
-	compare?: Parameters<typeof renderTable>[0]["compare"];
-	onInit(ctx: Vitest): Promise<void>;
-	onTaskUpdate(packs: TaskResultPack[]): void;
-	onTestSuiteResult(testSuite: TestSuite): void;
-	protected printTestModule(testModule: TestModule): void;
-	private printSuiteTable;
-	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): Promise<void>;
-}
-
-declare class VerboseBenchmarkReporter extends BenchmarkReporter {
-	protected verbose: boolean;
-}
-
-declare const BenchmarkReportsMap: {
-	default: typeof BenchmarkReporter;
-	verbose: typeof VerboseBenchmarkReporter;
-};
-type BenchmarkBuiltinReporters = keyof typeof BenchmarkReportsMap;
-
-declare const ReportersMap: {
-	default: typeof DefaultReporter;
-	blob: typeof BlobReporter;
-	verbose: typeof VerboseReporter;
-	dot: typeof DotReporter;
-	json: typeof JsonReporter;
-	tap: typeof TapReporter;
-	"tap-flat": typeof TapFlatReporter;
-	junit: typeof JUnitReporter;
-	"hanging-process": typeof HangingProcessReporter;
-	"github-actions": typeof GithubActionsReporter;
-};
-type BuiltinReporters = keyof typeof ReportersMap;
-interface BuiltinReporterOptions {
-	"default": DefaultReporterOptions;
-	"verbose": DefaultReporterOptions;
-	"dot": BaseOptions;
-	"json": JsonOptions$1;
-	"blob": BlobOptions;
-	"tap": never;
-	"tap-flat": never;
-	"junit": JUnitOptions;
-	"hanging-process": never;
-	"html": HTMLOptions;
-}
-
-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[]>;
-}
-interface TestSequencerConstructor {
-	new (ctx: Vitest): TestSequencer;
-}
-
-interface WatcherTriggerPattern {
-	pattern: RegExp;
-	testsToRun: (file: string, match: RegExpMatchArray) => string[] | string | null | undefined | void;
-}
-
-interface BenchmarkUserOptions {
-	/**
-	* Include globs for benchmark test files
-	*
-	* @default ['**\/*.{bench,benchmark}.?(c|m)[jt]s?(x)']
-	*/
-	include?: string[];
-	/**
-	* Exclude globs for benchmark test files
-	* @default ['**\/node_modules/**', '**\/dist/**', '**\/cypress/**', '**\/.{idea,git,cache,output,temp}/**', '**\/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*']
-	*/
-	exclude?: string[];
-	/**
-	* Include globs for in-source benchmark test files
-	*
-	* @default []
-	*/
-	includeSource?: string[];
-	/**
-	* Custom reporter for output. Can contain one or more built-in report names, reporter instances,
-	* and/or paths to custom reporters
-	*
-	* @default ['default']
-	*/
-	reporters?: Arrayable<BenchmarkBuiltinReporters | Reporter>;
-	/**
-	* @deprecated Use `benchmark.outputJson` instead
-	*/
-	outputFile?: string | (Partial<Record<BenchmarkBuiltinReporters, string>> & Record<string, string>);
-	/**
-	* benchmark output file to compare against
-	*/
-	compare?: string;
-	/**
-	* benchmark output file
-	*/
-	outputJson?: string;
-	/**
-	* Include `samples` array of benchmark results for API or custom reporter usages.
-	* This is disabled by default to reduce memory usage.
-	* @default false
-	*/
-	includeSamples?: boolean;
-}
-
-interface Node {
-    isRoot(): boolean;
-    visit(visitor: Visitor, state: any): void;
-}
-
-interface Visitor<N extends Node = Node> {
-    onStart(root: N, state: any): void;
-    onSummary(root: N, state: any): void;
-    onDetail(root: N, state: any): void;
-    onSummaryEnd(root: N, state: any): void;
-    onEnd(root: N, state: any): void;
-}
-
-interface FileOptions {
-    file: string;
-}
-
-interface ProjectOptions {
-    projectRoot: string;
-}
-
-interface ReportOptions {
-    clover: CloverOptions;
-    cobertura: CoberturaOptions;
-    "html-spa": HtmlSpaOptions;
-    html: HtmlOptions;
-    json: JsonOptions;
-    "json-summary": JsonSummaryOptions;
-    lcov: LcovOptions;
-    lcovonly: LcovOnlyOptions;
-    none: never;
-    teamcity: TeamcityOptions;
-    text: TextOptions;
-    "text-lcov": TextLcovOptions;
-    "text-summary": TextSummaryOptions;
-}
-
-interface CloverOptions extends FileOptions, ProjectOptions {}
-
-interface CoberturaOptions extends FileOptions, ProjectOptions {}
-
-interface HtmlSpaOptions extends HtmlOptions {
-    metricsToShow: Array<"lines" | "branches" | "functions" | "statements">;
-}
-interface HtmlOptions {
-    verbose: boolean;
-    skipEmpty: boolean;
-    subdir: string;
-    linkMapper: LinkMapper;
-}
-
-type JsonOptions = FileOptions;
-type JsonSummaryOptions = FileOptions;
-
-interface LcovOptions extends FileOptions, ProjectOptions {}
-interface LcovOnlyOptions extends FileOptions, ProjectOptions {}
-
-interface TeamcityOptions extends FileOptions {
-    blockName: string;
+declare class BenchmarkReporter extends DefaultReporter {
+	compare?: Parameters<typeof renderTable>[0]["compare"];
+	onInit(ctx: Vitest): Promise<void>;
+	onTaskUpdate(packs: TaskResultPack[]): void;
+	onTestSuiteResult(testSuite: TestSuite): void;
+	protected printTestModule(testModule: TestModule): void;
+	private printSuiteTable;
+	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): Promise<void>;
 }
 
-interface TextOptions extends FileOptions {
-    maxCols: number;
-    skipEmpty: boolean;
-    skipFull: boolean;
+declare class VerboseBenchmarkReporter extends BenchmarkReporter {
+	protected verbose: boolean;
 }
-type TextLcovOptions = ProjectOptions;
-type TextSummaryOptions = FileOptions;
 
-interface LinkMapper {
-    getPath(node: string | Node): string;
-    relativePath(source: string | Node, target: string | Node): string;
-    assetPath(node: Node, name: string): string;
-}
+declare const BenchmarkReportsMap: {
+	default: typeof BenchmarkReporter;
+	verbose: typeof VerboseBenchmarkReporter;
+};
+type BenchmarkBuiltinReporters = keyof typeof BenchmarkReportsMap;
 
-type TransformResult = string | Partial<TransformResult$1> | undefined | null | void;
-type CoverageResults = unknown;
-interface CoverageProvider {
-	name: string;
-	/** Called when provider is being initialized before tests run */
-	initialize: (ctx: Vitest) => Promise<void> | void;
-	/** Called when setting coverage options for Vitest context (`ctx.config.coverage`) */
-	resolveOptions: () => ResolvedCoverageOptions;
-	/** Callback to clean previous reports */
-	clean: (clean?: boolean) => void | Promise<void>;
-	/** Called with coverage results after a single test file has been run */
-	onAfterSuiteRun: (meta: AfterSuiteRunMeta) => void | Promise<void>;
-	/** Callback called when test run fails */
-	onTestFailure?: () => void | Promise<void>;
-	/** Callback to generate final coverage results */
-	generateCoverage: (reportContext: ReportContext) => CoverageResults | Promise<CoverageResults>;
-	/** Callback to convert coverage results to coverage reports. Called with results returned from `generateCoverage` */
-	reportCoverage: (coverage: CoverageResults, reportContext: ReportContext) => void | Promise<void>;
-	/** Callback for `--merge-reports` options. Called with multiple coverage results generated by `generateCoverage`. */
-	mergeReports?: (coverages: CoverageResults[]) => void | Promise<void>;
-	/** Callback called for instrumenting files with coverage counters. */
-	onFileTransform?: (sourceCode: string, id: string, pluginCtx: any) => TransformResult | Promise<TransformResult>;
-}
-interface ReportContext {
-	/** Indicates whether all tests were run. False when only specific tests were run. */
-	allTestsRun?: boolean;
+declare const ReportersMap: {
+	default: typeof DefaultReporter;
+	blob: typeof BlobReporter;
+	verbose: typeof VerboseReporter;
+	dot: typeof DotReporter;
+	json: typeof JsonReporter;
+	tap: typeof TapReporter;
+	"tap-flat": typeof TapFlatReporter;
+	junit: typeof JUnitReporter;
+	"hanging-process": typeof HangingProcessReporter;
+	"github-actions": typeof GithubActionsReporter;
+};
+type BuiltinReporters = keyof typeof ReportersMap;
+interface BuiltinReporterOptions {
+	"default": DefaultReporterOptions;
+	"verbose": DefaultReporterOptions;
+	"dot": BaseOptions;
+	"json": JsonOptions;
+	"blob": BlobOptions;
+	"tap": never;
+	"tap-flat": never;
+	"junit": JUnitOptions;
+	"hanging-process": never;
+	"html": HTMLOptions;
 }
-interface CoverageProviderModule extends RuntimeCoverageProviderModule {
+
+interface TestSequencer {
 	/**
-	* Factory for creating a new coverage provider
+	* Slicing tests into shards. Will be run before `sort`.
+	* Only run, if `shard` is defined.
 	*/
-	getProvider: () => CoverageProvider | Promise<CoverageProvider>;
+	shard: (files: TestSpecification[]) => Awaitable$1<TestSpecification[]>;
+	sort: (files: TestSpecification[]) => Awaitable$1<TestSpecification[]>;
 }
-type CoverageReporter = keyof ReportOptions | (string & {});
-type CoverageReporterWithOptions<ReporterName extends CoverageReporter = CoverageReporter> = ReporterName extends keyof ReportOptions ? ReportOptions[ReporterName] extends never ? [ReporterName, object] : [ReporterName, Partial<ReportOptions[ReporterName]>] : [ReporterName, Record<string, unknown>];
-type CoverageProviderName = "v8" | "istanbul" | "custom" | undefined;
-type CoverageOptions<T extends CoverageProviderName = CoverageProviderName> = T extends "istanbul" ? {
-	provider: T;
-} & CoverageIstanbulOptions : T extends "v8" ? {
-	/**
-	* Provider to use for coverage collection.
-	*
-	* @default 'v8'
-	*/
-	provider: T;
-} & CoverageV8Options : T extends "custom" ? {
-	provider: T;
-} & CustomProviderOptions : {
-	provider?: T;
-} & CoverageV8Options;
-/** Fields that have default values. Internally these will always be defined. */
-type FieldsWithDefaultValues = "enabled" | "clean" | "cleanOnRerun" | "reportsDirectory" | "exclude" | "reportOnFailure" | "allowExternal" | "processingConcurrency";
-type ResolvedCoverageOptions<T extends CoverageProviderName = CoverageProviderName> = CoverageOptions<T> & Required<Pick<CoverageOptions<T>, FieldsWithDefaultValues>> & {
-	reporter: CoverageReporterWithOptions[];
-};
-interface BaseCoverageOptions {
-	/**
-	* Enables coverage collection. Can be overridden using `--coverage` CLI option.
-	*
-	* @default false
-	*/
-	enabled?: boolean;
+interface TestSequencerConstructor {
+	new (ctx: Vitest): TestSequencer;
+}
+
+interface BenchmarkUserOptions {
 	/**
-	* List of files included in coverage as glob patterns.
-	* By default only files covered by tests are included.
+	* Include globs for benchmark test files
 	*
-	* See [Including and excluding files from coverage report](https://vitest.dev/guide/coverage.html#including-and-excluding-files-from-coverage-report) for examples.
+	* @default ['**\/*.{bench,benchmark}.?(c|m)[jt]s?(x)']
 	*/
 	include?: string[];
 	/**
-	* List of files excluded from coverage as glob patterns.
-	* Files are first checked against `coverage.include`.
-	*
-	* See [Including and excluding files from coverage report](https://vitest.dev/guide/coverage.html#including-and-excluding-files-from-coverage-report) for examples.
+	* Exclude globs for benchmark test files
+	* @default ['**\/node_modules/**', '**\/dist/**', '**\/cypress/**', '**\/.{idea,git,cache,output,temp}/**', '**\/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*']
 	*/
 	exclude?: string[];
 	/**
-	* Clean coverage results before running tests
-	*
-	* @default true
-	*/
-	clean?: boolean;
-	/**
-	* Clean coverage report on watch rerun
-	*
-	* @default true
-	*/
-	cleanOnRerun?: boolean;
-	/**
-	* Directory to write coverage report to
-	*
-	* @default './coverage'
-	*/
-	reportsDirectory?: string;
-	/**
-	* Coverage reporters to use.
-	* See [istanbul documentation](https://istanbul.js.org/docs/advanced/alternative-reporters/) for detailed list of all reporters.
-	*
-	* @default ['text', 'html', 'clover', 'json']
-	*/
-	reporter?: Arrayable$1<CoverageReporter> | (CoverageReporter | [CoverageReporter] | CoverageReporterWithOptions)[];
-	/**
-	* Do not show files with 100% statement, branch, and function coverage
-	*
-	* @default false
-	*/
-	skipFull?: boolean;
-	/**
-	* Configurations for thresholds
-	*
-	* @example
-	*
-	* ```ts
-	* {
-	*   // Thresholds for all files
-	*   functions: 95,
-	*   branches: 70,
-	*   perFile: true,
-	*   autoUpdate: true,
-	*
-	*   // Thresholds for utilities
-	*   'src/utils/**.ts': {
-	*     lines: 100,
-	*     statements: 95,
-	*   }
-	* }
-	* ```
-	*/
-	thresholds?: Thresholds | ({
-		[glob: string]: Pick<Thresholds, 100 | "statements" | "functions" | "branches" | "lines">;
-	} & Thresholds);
-	/**
-	* Watermarks for statements, lines, branches and functions.
-	*
-	* Default value is `[50,80]` for each property.
-	*/
-	watermarks?: {
-		statements?: [number, number];
-		functions?: [number, number];
-		branches?: [number, number];
-		lines?: [number, number];
-	};
-	/**
-	* Generate coverage report even when tests fail.
+	* Include globs for in-source benchmark test files
 	*
-	* @default false
+	* @default []
 	*/
-	reportOnFailure?: boolean;
+	includeSource?: string[];
 	/**
-	* Collect coverage of files outside the project `root`.
+	* Custom reporter for output. Can contain one or more built-in report names, reporter instances,
+	* and/or paths to custom reporters
 	*
-	* @default false
+	* @default ['default']
 	*/
-	allowExternal?: boolean;
+	reporters?: Arrayable$1<BenchmarkBuiltinReporters | Reporter>;
 	/**
-	* Apply exclusions again after coverage has been remapped to original sources.
-	* This is useful when your source files are transpiled and may contain source maps
-	* of non-source files.
-	*
-	* Use this option when you are seeing files that show up in report even if they
-	* match your `coverage.exclude` patterns.
-	*
-	* @default false
+	* @deprecated Use `benchmark.outputJson` instead
 	*/
-	excludeAfterRemap?: boolean;
+	outputFile?: string | (Partial<Record<BenchmarkBuiltinReporters, string>> & Record<string, string>);
 	/**
-	* Concurrency limit used when processing the coverage results.
-	* Defaults to `Math.min(20, os.availableParallelism?.() ?? os.cpus().length)`
+	* benchmark output file to compare against
 	*/
-	processingConcurrency?: number;
+	compare?: string;
 	/**
-	* Set to array of class method names to ignore for coverage
-	*
-	* @default []
+	* benchmark output file
 	*/
-	ignoreClassMethods?: string[];
-}
-interface CoverageIstanbulOptions extends BaseCoverageOptions {}
-interface CoverageV8Options extends BaseCoverageOptions {}
-interface CustomProviderOptions extends Pick<BaseCoverageOptions, FieldsWithDefaultValues> {
-	/** Name of the module or path to a file to load the custom provider from */
-	customProviderModule: string;
-}
-interface Thresholds {
-	/** Set global thresholds to `100` */
-	100?: boolean;
-	/** Check thresholds per file. */
-	perFile?: boolean;
+	outputJson?: string;
 	/**
-	* Update threshold values automatically when current coverage is higher than earlier thresholds
-	*
+	* Include `samples` array of benchmark results for API or custom reporter usages.
+	* This is disabled by default to reduce memory usage.
 	* @default false
 	*/
-	autoUpdate?: boolean;
-	/** Thresholds for statements */
-	statements?: number;
-	/** Thresholds for functions */
-	functions?: number;
-	/** Thresholds for branches */
-	branches?: number;
-	/** Thresholds for lines */
-	lines?: number;
+	includeSamples?: boolean;
 }
 
 type BuiltinEnvironment = "node" | "jsdom" | "happy-dom" | "edge-runtime";
@@ -2578,7 +2636,7 @@ interface InlineConfig {
 	*
 	* @default []
 	*/
-	reporters?: Arrayable$1<ReporterName | InlineReporter> | ((ReporterName | InlineReporter) | [ReporterName] | ReporterWithOptions)[];
+	reporters?: Arrayable<ReporterName | InlineReporter> | ((ReporterName | InlineReporter) | [ReporterName] | ReporterWithOptions)[];
 	/**
 	* Write test results to a file when the --reporter=json` or `--reporter=junit` option is also specified.
 	* Also definable individually per reporter by using an object instead.
@@ -3172,5 +3230,5 @@ type TestProjectInlineConfiguration = (UserWorkspaceConfig & {
 });
 type TestProjectConfiguration = string | TestProjectInlineConfiguration | Promise<UserWorkspaceConfig> | UserProjectConfigFn;
 
-export { CoverageMap as C, TestSuite as E, Logger as L, TestProject as T, Vitest as V, BenchmarkReporter as aA, BenchmarkReportsMap as aB, DefaultReporter as aC, DotReporter as aD, GithubActionsReporter as aE, HangingProcessReporter as aF, JsonReporter as aG, JUnitReporter as aH, ReportersMap as aI, TapFlatReporter as aJ, TapReporter as aK, VerboseBenchmarkReporter as aL, VerboseReporter as aM, BaseReporter as aN, TestSpecification as l, VitestPackageInstaller as n, getFilePoolName as p, TestCase as s, TestCollection as t, TestModule as v };
-export type { BrowserOrchestrator as $, ApiConfig as A, TestResultSkipped as B, TestState as D, TestSuiteState as F, TestSequencerConstructor as G, HTMLOptions as H, InlineConfig as I, JsonOptions$1 as J, BenchmarkUserOptions as K, ModuleDiagnostic as M, BrowserBuiltinProvider as N, OnServerRestartHandler as O, ProcessPool as P, BrowserCommand as Q, ResolvedCoverageOptions as R, SerializedTestProject as S, UserWorkspaceConfig as U, WatcherTriggerPattern as W, BrowserCommandContext as X, BrowserConfigOptions as Y, BrowserInstanceOption as Z, BrowserModuleMocker as _, TestProjectConfiguration as a, BrowserProvider as a0, BrowserProviderInitializationOptions as a1, BrowserProviderModule as a2, BrowserProviderOptions as a3, BrowserScript as a4, BrowserServerState as a5, BrowserServerStateSession as a6, CDPSession as a7, ParentProjectBrowser as a8, ProjectBrowser as a9, BenchmarkBuiltinReporters as aO, BuiltinReporterOptions as aP, BuiltinReporters as aQ, JsonAssertionResult as aR, JsonTestResult as aS, JsonTestResults as aT, ResolvedBrowserOptions as aa, ToMatchScreenshotComparators as ab, ToMatchScreenshotOptions as ac, BuiltinEnvironment as ad, CSSModuleScopeStrategy as ae, DepsOptimizationOptions as af, EnvironmentOptions as ag, Pool as ah, PoolOptions as ai, ProjectConfig as aj, ResolvedProjectConfig as ak, ResolveSnapshotPathHandler as al, ResolveSnapshotPathHandlerContext as am, TypecheckConfig as an, VitestEnvironment as ao, BaseCoverageOptions as ap, CoverageIstanbulOptions as aq, CoverageOptions as ar, CoverageProvider as as, CoverageProviderModule as at, CoverageReporter as au, CustomProviderOptions as av, TestRunResult as aw, ReportedHookContext as ax, Reporter as ay, TestRunEndReason 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, TestSequencer as k, OnTestsRerunHandler as m, WorkspaceSpec as o, JUnitOptions as q, TaskOptions as r, TestDiagnostic as u, TestModuleState as w, TestResult as x, TestResultFailed as y, TestResultPassed as z };
+export { CoverageMap as C, TestSuite as E, experimental_getRunnerTask as G, Logger as L, TestProject as T, Vitest as V, BenchmarkReporter as aB, BenchmarkReportsMap as aC, DefaultReporter as aD, DotReporter as aE, GithubActionsReporter as aF, HangingProcessReporter as aG, JsonReporter as aH, JUnitReporter as aI, ReportersMap as aJ, TapFlatReporter as aK, TapReporter as aL, VerboseBenchmarkReporter as aM, VerboseReporter as aN, BaseReporter as aO, TestSpecification as l, VitestPackageInstaller as n, getFilePoolName as p, TestCase as s, TestCollection as t, TestModule as v };
+export type { BrowserModuleMocker as $, ApiConfig as A, TestResultSkipped as B, TestState as D, TestSuiteState as F, HTMLOptions as H, InlineConfig as I, JsonOptions as J, TestSequencerConstructor as K, ModuleDiagnostic as M, BenchmarkUserOptions as N, OnServerRestartHandler as O, ProcessPool as P, BrowserBuiltinProvider as Q, ResolvedCoverageOptions as R, SerializedTestProject as S, UserWorkspaceConfig as U, WatcherTriggerPattern as W, BrowserCommand as X, BrowserCommandContext as Y, BrowserConfigOptions as Z, BrowserInstanceOption as _, TestProjectConfiguration as a, BrowserOrchestrator as a0, BrowserProvider as a1, BrowserProviderInitializationOptions as a2, BrowserProviderModule as a3, BrowserProviderOptions as a4, BrowserScript as a5, BrowserServerState as a6, BrowserServerStateSession as a7, CDPSession as a8, ParentProjectBrowser as a9, TestRunEndReason as aA, BenchmarkBuiltinReporters as aP, BuiltinReporterOptions as aQ, BuiltinReporters as aR, JsonAssertionResult as aS, JsonTestResult as aT, JsonTestResults as aU, ProjectBrowser as aa, ResolvedBrowserOptions as ab, ToMatchScreenshotComparators as ac, ToMatchScreenshotOptions as ad, BuiltinEnvironment as ae, CSSModuleScopeStrategy as af, DepsOptimizationOptions as ag, EnvironmentOptions as ah, Pool as ai, PoolOptions as aj, ProjectConfig as ak, ResolvedProjectConfig as al, ResolveSnapshotPathHandler as am, ResolveSnapshotPathHandlerContext as an, TypecheckConfig as ao, VitestEnvironment as ap, BaseCoverageOptions as aq, CoverageIstanbulOptions as ar, CoverageOptions as as, CoverageProvider as at, CoverageProviderModule as au, CoverageReporter as av, CustomProviderOptions as aw, TestRunResult as ax, ReportedHookContext as ay, Reporter 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, TestSequencer as k, OnTestsRerunHandler as m, WorkspaceSpec as o, JUnitOptions as q, TaskOptions as r, TestDiagnostic as u, TestModuleState as w, TestResult as x, TestResultFailed as y, TestResultPassed as z };