@voidzero-dev/vite-plus-test 0.1.9 → 0.1.11

package/dist/chunks/{reporters.d.CWXNI2jG.d.ts → reporters.d.DVUYHHhe.d.ts}

@@ -1,27 +1,27 @@
-import { TaskMeta, Suite, File, TestAnnotation, TestArtifact, ImportDuration, Test, Task, TaskResultPack, FileSpecification, CancelReason, SequenceSetupFiles, SequenceHooks } from '../@vitest/runner/index.js';
+import { TaskMeta, Suite, File, SerializableRetry, TestAnnotation, TestArtifact, ImportDuration, Test, Task, TaskResultPack, FileSpecification, CancelReason, SequenceSetupFiles, SequenceHooks, TestTagDefinition } from '../@vitest/runner/index.js';
 import { TestError, SerializedError, Arrayable, ParsedStack, Awaitable } from '../@vitest/utils/index.js';
-import { A as AfterSuiteRunMeta, U as UserConsoleLog, P as ProvidedContext, L as LabelColor } from './rpc.d.RH3apGEf.js';
+import { A as AfterSuiteRunMeta, U as UserConsoleLog, b as AsyncLeak, P as ProvidedContext, L as LabelColor } from './rpc.d.BFMWpdph.js';
 import { Writable } from 'node:stream';
 import { DevEnvironment, TransformResult as TransformResult$1, ViteDevServer, Plugin, UserConfig as UserConfig$1, DepOptimizationConfig, ServerOptions, ConfigEnv, AliasOptions } from '@voidzero-dev/vite-plus-core';
-import { S as SerializedTestSpecification, c as SourceModuleDiagnostic, B as BrowserTesterOptions } from './browser.d.ChKACdzH.js';
-import { MockedModule } from '../@vitest/mocker/index.js';
-import { StackTraceParserOptions } from '../@vitest/utils/source-map.js';
-import { BrowserCommands } from '../@vitest/browser/index.js';
-import { B as BrowserTraceViewMode, S as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.Cy95HiCx.js';
+import { S as SerializedTestSpecification, c as SourceModuleDiagnostic, B as BrowserTesterOptions } from './browser.d.X3SXoOCV.js';
+import { B as BrowserTraceViewMode, S as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.EJLVE3es.js';
 import { PrettyFormatOptions } from '../@vitest/pretty-format/index.js';
 import { SnapshotSummary, SnapshotStateOptions } from '../@vitest/snapshot/index.js';
 import { SerializedDiffOptions } from '../@vitest/utils/diff.js';
 import { chai } from '../@vitest/expect/index.js';
 import { happyDomTypes, jsdomTypes } from 'vitest/optional-types.js';
-import { c as ContextTestEnvironment, d as WorkerExecuteContext, e as WorkerTestEnvironment } from './worker.d.Dyxm8DEL.js';
+import { c as ContextTestEnvironment, d as WorkerExecuteContext, e as WorkerTestEnvironment } from './worker.d.B84sVRy0.js';
 import { O as OTELCarrier } from './traces.d.402V_yFI.js';
 import { B as BenchmarkResult } from './benchmark.d.DAaHLpsq.js';
+import { MockedModule } from '../@vitest/mocker/index.js';
+import { StackTraceParserOptions } from '../@vitest/utils/source-map.js';
+import { CDPSession, BrowserCommands } from '../@vitest/browser/index.js';
 import { a as RuntimeCoverageProviderModule } from './coverage.d.BZtK59WP.js';
 import { SnapshotManager } from '../@vitest/snapshot/manager.js';
 import { Console } from 'node:console';
 import { Stats } from 'node:fs';
 
-type ChaiConfig = Omit<Partial<typeof chai.config>, "useProxy" | "proxyExcludedKeys">;
+type ChaiConfig = Omit<Partial<typeof chai.config>, "useProxy" | "proxyExcludedKeys" | "deepEqual">;
 
 type HappyDOMOptions = Omit<NonNullable<ConstructorParameters<typeof happyDomTypes.Window>[0]>, "console">;
 
@@ -72,6 +72,52 @@ interface ConstructorOptionsOverride {
 	resources?: "usable";
 }
 
+interface TestSpecificationOptions {
+	testNamePattern?: RegExp;
+	testIds?: string[];
+	testLines?: number[];
+	testTagsFilter?: string[];
+}
+declare class TestSpecification {
+	/**
+	* The task id associated with the test module.
+	*/
+	readonly taskId: string;
+	/**
+	* The test project that the module belongs to.
+	*/
+	readonly project: TestProject;
+	/**
+	* The id of the module in the Vite module graph. It is usually an absolute file path.
+	*/
+	readonly moduleId: string;
+	/**
+	* The current test pool. It's possible to have multiple pools in a single test project with `typecheck.enabled`.
+	*/
+	readonly pool: Pool;
+	/**
+	* Line numbers of the test locations to run.
+	*/
+	readonly testLines: number[] | undefined;
+	/**
+	* Regular expression pattern to filter test names.
+	*/
+	readonly testNamePattern: RegExp | undefined;
+	/**
+	* The ids of tasks inside of this specification to run.
+	*/
+	readonly testIds: string[] | undefined;
+	/**
+	* The tags of tests to run.
+	*/
+	readonly testTagsFilter: string[] | undefined;
+	/**
+	* Test module associated with the specification. This will be `undefined` if tests have not been run yet.
+	*/
+	get testModule(): TestModule | undefined;
+	toJSON(): SerializedTestSpecification;
+}
+
 declare class ReportedTaskImplementation {
 	/**
 	* The project associated with the test or suite.
@@ -120,6 +166,10 @@ declare class TestCase extends ReportedTaskImplementation {
 	*/
 	readonly parent: TestSuite | TestModule;
 	/**
+	* Tags associated with the test.
+	*/
+	readonly tags: string[];
+	/**
 	* Full name of the test including all parent suites separated with `>`.
 	*/
 	get fullName(): string;
@@ -146,6 +196,10 @@ declare class TestCase extends ReportedTaskImplementation {
 	* Diagnostic is only available after the test has finished.
 	*/
 	diagnostic(): TestDiagnostic | undefined;
+	/**
+	* Returns a new test specification that can be used to filter or run this specific test case.
+	*/
+	toTestSpecification(): TestSpecification;
 }
 declare class TestCollection {
 	#private;
@@ -231,6 +285,10 @@ declare class TestSuite extends SuiteImplementation {
 	*/
 	state(): TestSuiteState;
 	/**
+	* Returns a new test specification that can be used to filter or run this specific test suite.
+	*/
+	toTestSpecification(): TestSpecification;
+	/**
 	* Full name of the suite including all parent suites separated with `>`.
 	*/
 	get fullName(): string;
@@ -255,6 +313,10 @@ declare class TestModule extends SuiteImplementation {
 	*/
 	readonly relativeModuleId: string;
 	/**
+	* Returns a new test specification that can be used to filter or run this specific test module.
+	*/
+	toTestSpecification(testCases?: TestCase[]): TestSpecification;
+	/**
 	* Checks the running state of the test file.
 	*/
 	state(): TestModuleState;
@@ -278,8 +340,13 @@ interface TaskOptions {
 	readonly fails: boolean | undefined;
 	readonly concurrent: boolean | undefined;
 	readonly shuffle: boolean | undefined;
-	readonly retry: number | undefined;
+	readonly retry: SerializableRetry | undefined;
 	readonly repeats: number | undefined;
+	readonly tags: string[] | undefined;
+	/**
+	* Only tests have a `timeout` option.
+	*/
+	readonly timeout: number | undefined;
 	readonly mode: "run" | "only" | "skip" | "todo";
 }
 type TestSuiteState = "skipped" | "pending" | "failed" | "passed";
@@ -402,36 +469,6 @@ 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 {
-	/**
-	* The task ID associated with the test module.
-	*/
-	readonly taskId: string;
-	/**
-	* The test project that the module belongs to.
-	*/
-	readonly project: TestProject;
-	/**
-	* The ID of the module in the Vite module graph. It is usually an absolute file path.
-	*/
-	readonly moduleId: string;
-	/**
-	* The current test pool. It's possible to have multiple pools in a single test project with `poolMatchGlob` and `typecheck.enabled`.
-	* @experimental In Vitest 4, the project will only support a single pool and this property will be removed.
-	*/
-	readonly pool: Pool;
-	/**
-	* Line numbers of the test locations to run.
-	*/
-	readonly testLines: number[] | undefined;
-	constructor(project: TestProject, moduleId: string, pool: Pool, testLines?: number[] | undefined);
-	/**
-	* Test module associated with the specification.
-	*/
-	get testModule(): TestModule | undefined;
-	toJSON(): SerializedTestSpecification;
-}
-
 interface CoverageSummaryData {
     lines: Totals;
     statements: Totals;
@@ -623,7 +660,9 @@ interface CoverageProvider {
 	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 */
+	/** Callback called when test run starts */
+	onTestRunStart?: () => void | Promise<void>;
+	/** Callback called when test run fails due to test failures */
 	onTestFailure?: () => void | Promise<void>;
 	/** Callback to generate final coverage results */
 	generateCoverage: (reportContext: ReportContext) => CoverageResults | Promise<CoverageResults>;
@@ -673,6 +712,7 @@ type CoverageOptions<T extends CoverageProviderName = CoverageProviderName> = T
 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[];
+	htmlDir?: string;
 };
 interface BaseCoverageOptions {
 	/**
@@ -795,10 +835,23 @@ interface BaseCoverageOptions {
 	* @default []
 	*/
 	ignoreClassMethods?: string[];
+	/**
+	* Directory of HTML coverage output to be served in UI mode and HTML reporter.
+	* This is automatically configured for builtin reporter with html output (`html`, `html-spa`, and `lcov` reporters).
+	* Use this option to override with custom coverage reporting location.
+	*/
+	htmlDir?: string;
+	/**
+	* Collect coverage only for files changed since a specified commit or branch.
+	* Inherits the default value from `test.changed`.
+	*
+	* @default false
+	*/
+	changed?: boolean | string;
 }
 interface CoverageIstanbulOptions extends BaseCoverageOptions {}
 interface CoverageV8Options extends BaseCoverageOptions {}
-interface CustomProviderOptions extends Pick<BaseCoverageOptions, FieldsWithDefaultValues> {
+interface CustomProviderOptions extends Pick<BaseCoverageOptions, FieldsWithDefaultValues | "changed"> {
 	/** Name of the module or path to a file to load the custom provider from */
 	customProviderModule: string;
 }
@@ -865,6 +918,8 @@ declare class Logger {
 	deprecate(message: string): void;
 	clearHighlightCache(filename?: string): void;
 	highlight(filename: string, source: string): string;
+	printNoTestTagsFound(): void;
+	printTags(): void;
 	printNoTestFound(filters?: string[]): void;
 	printBanner(): void;
 	printBrowserBanner(project: TestProject): void;
@@ -931,7 +986,6 @@ interface Reporter {
 	/**
 	* 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>;
@@ -1029,6 +1083,7 @@ declare class StateManager {
 	idMap: Map<string, Task>;
 	taskFileMap: WeakMap<Task, File>;
 	errorsSet: Set<unknown>;
+	leakSet: Set<AsyncLeak>;
 	reportedTasksMap: WeakMap<Task, TestModule | TestCase | TestSuite>;
 	blobs?: MergedBlobs;
 	transformTime: number;
@@ -1047,6 +1102,7 @@ declare class StateManager {
 		onUnhandledError?: OnUnhandledErrorCallback;
 	});
 	catchError(error: unknown, type: string): void;
+	catchLeaks(leaks: AsyncLeak[]): void;
 	clearErrors(): void;
 	getUnhandledErrors(): unknown[];
 	getPaths(): string[];
@@ -1081,6 +1137,7 @@ declare class VitestWatcher {
 	readonly changedTests: Set<string>;
 	private readonly _onRerun;
 	constructor(vitest: Vitest);
+	close(): void;
 	unregisterWatcher: () => void;
 	registerWatcher(): this;
 	private scheduleRerun;
@@ -1149,7 +1206,6 @@ declare class Vitest {
 	private restartsCount;
 	private readonly specifications;
 	private pool;
-	private _config?;
 	private _vite?;
 	private _state?;
 	private _cache?;
@@ -1183,6 +1239,7 @@ declare class Vitest {
 	* Test results and test file stats cache. Primarily used by the sequencer to sort tests.
 	*/
 	get cache(): VitestCache;
+	listTags(): Promise<void>;
 	enableCoverage(): Promise<void>;
 	disableCoverage(): void;
 	private clearAllCachePaths;
@@ -1235,7 +1292,10 @@ declare class Vitest {
 	* Returns the seed, if tests are running in a random order.
 	*/
 	getSeed(): number | null;
-	collect(filters?: string[]): Promise<TestRunResult>;
+	collect(filters?: string[], options?: {
+		staticParse?: boolean;
+		staticParseConcurrency?: number;
+	}): Promise<TestRunResult>;
 	/**
 	* Returns the list of test files that match the config and filters.
 	* @param filters String filters to match the test files
@@ -1278,6 +1338,12 @@ declare class Vitest {
 	*/
 	runTestSpecifications(specifications: TestSpecification[], allTestsRun?: boolean): Promise<TestRunResult>;
 	/**
+	* Runs tests for the given file paths. This does not trigger `onWatcher*` events.
+	* @param filepaths A list of file paths to run tests for.
+	* @param allTestsRun Indicates whether all tests were run. This only matters for coverage.
+	*/
+	runTestFiles(filepaths: string[], 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.
@@ -1390,12 +1456,6 @@ declare class Vitest {
 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>;
@@ -1428,7 +1488,9 @@ interface BrowserProvider {
 	*/
 	supportsParallelism: boolean;
 	getCommandsContext: (sessionId: string) => Record<string, unknown>;
-	openPage: (sessionId: string, url: string) => Promise<void>;
+	openPage: (sessionId: string, url: string, options: {
+		parallel: boolean;
+	}) => Promise<void>;
 	getCDPSession?: (sessionId: string) => Promise<CDPSession>;
 	close: () => Awaitable<void>;
 }
@@ -1503,6 +1565,13 @@ interface BrowserConfigOptions {
 	*/
 	ui?: boolean;
 	/**
+	* Default position for the details panel in browser mode
+	* 'right' shows the details panel on the right side (horizontal split)
+	* 'bottom' shows the details panel at the bottom (vertical split)
+	* @default 'right'
+	*/
+	detailsPanelPosition?: "right" | "bottom";
+	/**
 	* Default viewport size
 	*/
 	viewport?: {
@@ -1597,7 +1666,7 @@ interface BrowserConfigOptions {
 	/**
 	* 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.
+	* 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
@@ -1695,6 +1764,7 @@ interface ResolvedBrowserOptions extends BrowserConfigOptions {
 		tracesDir?: string;
 		screenshots?: boolean;
 		snapshots?: boolean;
+		sources?: boolean;
 	};
 }
 type ToMatchScreenshotResolvePath = (data: {
@@ -1742,12 +1812,12 @@ type ToMatchScreenshotResolvePath = (data: {
 	screenshotDirectory: string;
 	/**
 	* Absolute path to the project's
-	* {@linkcode https://vitest.dev/config/#root|root}.
+	* {@linkcode https://vitest.dev/config/root|root}.
 	*/
 	root: string;
 	/**
 	* Path to the test file, relative to the project's
-	* {@linkcode https://vitest.dev/config/#root|root}.
+	* {@linkcode https://vitest.dev/config/root|root}.
 	*/
 	testFileDirectory: string;
 	/**
@@ -1761,7 +1831,7 @@ type ToMatchScreenshotResolvePath = (data: {
 	testName: string;
 	/**
 	* The value provided to
-	* {@linkcode https://vitest.dev/config/#attachmentsdir|attachmentsDir},
+	* {@linkcode https://vitest.dev/config/attachmentsdir|attachmentsDir},
 	* if none is provided, its default value.
 	*/
 	attachmentsDir: string;
@@ -1825,7 +1895,7 @@ declare class TestProject {
 	* 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;
+	createSpecification(moduleId: string, locationsOrOptions?: number[] | TestSpecificationOptions | undefined, pool?: string): TestSpecification;
 	toJSON(): SerializedTestProject;
 	/**
 	* Vite's dev server instance. Every workspace project has its own server.
@@ -1995,6 +2065,7 @@ type WorkerResponse = {
 
 interface BaseOptions {
 	isTTY?: boolean;
+	silent?: boolean | "passed-only";
 }
 declare abstract class BaseReporter implements Reporter {
 	start: number;
@@ -2005,6 +2076,7 @@ declare abstract class BaseReporter implements Reporter {
 	ctx: Vitest;
 	renderSucceed: boolean;
 	protected verbose: boolean;
+	protected silent?: boolean | "passed-only";
 	private _filesInWatchMode;
 	private _timeStart;
 	constructor(options?: BaseOptions);
@@ -2017,7 +2089,7 @@ declare abstract class BaseReporter implements Reporter {
 	onTestCaseResult(testCase: TestCase): void;
 	onTestSuiteResult(testSuite: TestSuite): void;
 	onTestModuleEnd(testModule: TestModule): void;
-	private logFailedTask;
+	protected logFailedTask(task: Task): void;
 	protected printTestModule(testModule: TestModule): void;
 	protected printTestCase(moduleState: TestModuleState, test: TestCase): void;
 	private getModuleLog;
@@ -2037,11 +2109,12 @@ declare abstract class BaseReporter implements Reporter {
 	shouldLog(log: UserConsoleLog, taskState?: TestResult["state"]): boolean;
 	onServerRestart(reason?: string): void;
 	reportSummary(files: File[], errors: unknown[]): void;
-	reportTestSummary(files: File[], errors: unknown[]): void;
-	private printImportsBreakdown;
+	reportTestSummary(files: File[], errors: unknown[], leakCount: number): void;
+	private reportImportDurations;
 	private importDurationTime;
 	private ellipsisPath;
 	private printErrorsSummary;
+	private printLeaksSummary;
 	reportBenchmarkSummary(files: File[]): void;
 	private printTaskErrors;
 }
@@ -2071,10 +2144,58 @@ interface GithubActionsReporterOptions {
 	* @default true
 	*/
 	displayAnnotations?: boolean;
+	/**
+	* Configuration for the GitHub Actions Job Summary.
+	*
+	* When enabled, a markdown summary of test results is written to the path specified by `outputPath`.
+	*/
+	jobSummary?: Partial<JobSummaryOptions>;
 }
+interface JobSummaryOptions {
+	/**
+	* Whether to generate the summary.
+	*
+	* @default true
+	*/
+	enabled: boolean;
+	/**
+	* File path to write the summary to.
+	*
+	* @default process.env.GITHUB_STEP_SUMMARY
+	*/
+	outputPath: string | undefined;
+	/**
+	* Configuration for generating permalink URLs to source files in the GitHub repository.
+	*
+	* When all three values are available (either from this config or the defaults picked from environment variables), test names in the summary will link to the relevant source lines.
+	*/
+	fileLinks: {
+		/**
+		* The GitHub repository in `owner/repo` format.
+		*
+		* @default process.env.GITHUB_REPOSITORY
+		*/
+		repository?: string | undefined;
+		/**
+		* The commit SHA to use in permalink URLs.
+		*
+		* @default process.env.GITHUB_SHA
+		*/
+		commitHash?: string | undefined;
+		/**
+		* The absolute path to the root of the repository on disk.
+		*
+		* This value is used to compute relative file paths for the permalink URLs.
+		*
+		* @default process.env.GITHUB_WORKSPACE
+		*/
+		workspacePath?: string | undefined;
+	};
+}
+type ResolvedOptions = Required<GithubActionsReporterOptions>;
 declare class GithubActionsReporter implements Reporter {
 	ctx: Vitest;
-	options: GithubActionsReporterOptions;
+	options: ResolvedOptions;
 	constructor(options?: GithubActionsReporterOptions);
 	onInit(ctx: Vitest): void;
 	onTestCaseAnnotate(testCase: TestCase, annotation: TestAnnotation): void;
@@ -2100,6 +2221,7 @@ interface JsonAssertionResult {
 	duration?: Milliseconds | null;
 	failureMessages: Array<string> | null;
 	location?: Callsite | null;
+	tags: string[];
 }
 interface JsonTestResult {
 	message: string;
@@ -2166,6 +2288,10 @@ interface JUnitOptions {
 	* @default false
 	*/
 	addFileAttribute?: boolean;
+	/**
+	* Hostname to use in the report. By default, it uses os.hostname()
+	*/
+	hostname?: string;
 }
 declare class JUnitReporter implements Reporter {
 	private ctx;
@@ -2183,12 +2309,21 @@ declare class JUnitReporter implements Reporter {
 	onTestRunEnd(testModules: ReadonlyArray<TestModule>): Promise<void>;
 }
 
+declare class AgentReporter extends DefaultReporter {
+	renderSucceed: boolean;
+	constructor(options?: DefaultReporterOptions);
+	onTestRunStart(specifications: ReadonlyArray<TestSpecification>): void;
+	protected printTestModule(testModule: TestModule): void;
+	protected printTestCase(moduleState: TestModuleState, test: TestCase): void;
+}
+
 declare class DotReporter extends BaseReporter {
 	private renderer?;
 	private tests;
 	private finishedTests;
 	onInit(ctx: Vitest): void;
 	printTestModule(): void;
+	onTestRunStart(_specifications: ReadonlyArray<TestSpecification>): void;
 	onWatcherRerun(files: string[], trigger?: string): void;
 	onTestRunEnd(testModules: ReadonlyArray<TestModule>, unhandledErrors: ReadonlyArray<SerializedError>, reason: TestRunEndReason): void;
 	onTestModuleCollected(module: TestModule): void;
@@ -2267,6 +2402,7 @@ type BenchmarkBuiltinReporters = keyof typeof BenchmarkReportsMap;
 
 declare const ReportersMap: {
 	default: typeof DefaultReporter;
+	agent: typeof AgentReporter;
 	blob: typeof BlobReporter;
 	verbose: typeof VerboseReporter;
 	dot: typeof DotReporter;
@@ -2281,6 +2417,7 @@ declare const ReportersMap: {
 type BuiltinReporters = keyof typeof ReportersMap;
 interface BuiltinReporterOptions {
 	"default": DefaultReporterOptions;
+	"agent": DefaultReporterOptions;
 	"verbose": DefaultReporterOptions;
 	"dot": BaseOptions;
 	"tree": BaseOptions;
@@ -2325,12 +2462,12 @@ interface BenchmarkUserOptions {
 	*/
 	includeSource?: string[];
 	/**
-	* Custom reporter for output. Can contain one or more built-in report names, reporter instances,
-	* and/or paths to custom reporters
+	* Custom reporters to use for output. Can contain one or more built-in reporter names, reporter instances,
+	* and/or paths to custom reporter files to import.
 	*
 	* @default ['default']
 	*/
-	reporters?: Arrayable<BenchmarkBuiltinReporters | Reporter>;
+	reporters?: Arrayable<BenchmarkBuiltinReporters | Reporter | (string & {})>;
 	/**
 	* @deprecated Use `benchmark.outputJson` instead
 	*/
@@ -2354,7 +2491,22 @@ interface BenchmarkUserOptions {
 type BuiltinEnvironment = "node" | "jsdom" | "happy-dom" | "edge-runtime";
 type VitestEnvironment = BuiltinEnvironment | (string & Record<never, never>);
 type CSSModuleScopeStrategy = "stable" | "scoped" | "non-scoped";
-type ApiConfig = Pick<ServerOptions, "port" | "strictPort" | "host" | "middlewareMode">;
+type ApiConfig = Pick<ServerOptions, "port" | "strictPort" | "host" | "middlewareMode"> & {
+	/**
+	* Allow any write operations from the API server.
+	*
+	* @default true if `api.host` is exposed to network, false otherwise
+	*/
+	allowWrite?: boolean;
+	/**
+	* Allow running test files via the API.
+	* If `api.host` is exposed to network and `allowWrite` is true,
+	* anyone connected to the API server can run arbitrary code on your machine.
+	*
+	* @default true if `api.host` is exposed to network, false otherwise
+	*/
+	allowExec?: boolean;
+};
 interface EnvironmentOptions {
 	/**
 	* jsdom options.
@@ -2624,7 +2776,7 @@ interface InlineConfig {
 	*
 	* @default false
 	*/
-	update?: boolean;
+	update?: boolean | "all" | "new" | "none";
 	/**
 	* Watch mode
 	*
@@ -2638,10 +2790,10 @@ interface InlineConfig {
 	*/
 	root?: string;
 	/**
-	* Custom reporter for output. Can contain one or more built-in report names, reporter instances,
+	* Custom reporter for output. Can contain one or more built-in reporter names, reporter instances,
 	* and/or paths to custom reporters.
 	*
-	* @default []
+	* @default ['default'] (or ['default', 'github-actions'] when `process.env.GITHUB_ACTIONS === 'true'`)
 	*/
 	reporters?: Arrayable<ReporterName | InlineReporter> | ((ReporterName | InlineReporter) | [ReporterName] | ReporterWithOptions)[];
 	/**
@@ -2707,7 +2859,7 @@ interface InlineConfig {
 	*/
 	coverage?: CoverageOptions;
 	/**
-	* run test names with the specified pattern
+	* Run test names with the specified pattern
 	*/
 	testNamePattern?: string | RegExp;
 	/**
@@ -2804,6 +2956,12 @@ interface InlineConfig {
 	*/
 	logHeapUsage?: boolean;
 	/**
+	* Detect asynchronous resources leaking from the test file.
+	*
+	* @default false
+	*/
+	detectAsyncLeaks?: boolean;
+	/**
 	* Custom environment variables assigned to `process.env` before running tests.
 	*/
 	env?: Partial<NodeJS.ProcessEnv>;
@@ -2976,11 +3134,17 @@ interface InlineConfig {
 	*/
 	bail?: number;
 	/**
-	* Retry the test specific number of times if it fails.
+	* Retry configuration for tests.
+	* - If a number, specifies how many times to retry failed tests
+	* - If an object, allows fine-grained retry control
 	*
-	* @default 0
+	* ⚠️ WARNING: Function form is NOT supported in a config file
+	* because configurations are serialized when passed to worker threads.
+	* Use the function form only in test files directly.
+	*
+	* @default 0 // Don't retry
 	*/
-	retry?: number;
+	retry?: SerializableRetry;
 	/**
 	* Show full diff when snapshot fails instead of a patch.
 	*/
@@ -3037,12 +3201,76 @@ interface InlineConfig {
 			browserSdkPath?: string;
 		};
 		/**
-		* Show imports (top 10) that take a long time.
+		* Configure import duration collection and display.
 		*
-		* Enabling this will also show a breakdown by default in UI, but you can always press a button to toggle it.
+		* The `limit` option controls how many imports to collect and display.
+		* The `print` option controls CLI terminal output.
+		* UI can always toggle the breakdown display regardless of `print` setting.
 		*/
-		printImportBreakdown?: boolean;
+		importDurations?: {
+			/**
+			* When to print import breakdown to CLI terminal after tests finish.
+			* - `true`: Always print
+			* - `false`: Never print (default)
+			* - `'on-warn'`: Print only when any import exceeds the warn threshold
+			* @default false
+			*/
+			print?: boolean | "on-warn";
+			/**
+			* Maximum number of imports to collect and display.
+			* @default 0 (or 10 if `print` or UI is enabled)
+			*/
+			limit?: number;
+			/**
+			* Fail the test run if any import exceeds the danger threshold.
+			* When failing, the breakdown is always printed regardless of `print` setting.
+			* @default false
+			*/
+			failOnDanger?: boolean;
+			/**
+			* Duration thresholds in milliseconds for coloring and warnings.
+			*/
+			thresholds?: {
+				/**
+				* Warning threshold - imports exceeding this are shown in yellow/orange.
+				* @default 100
+				*/
+				warn?: number;
+				/**
+				* Danger threshold - imports exceeding this are shown in red.
+				* @default 500
+				*/
+				danger?: number;
+			};
+		};
+		/**
+		* Controls whether Vitest uses Vite's module runner to run the code or fallback to the native `import`.
+		*
+		* If Node.js cannot process the code, consider registering [module loader](https://nodejs.org/api/module.html#customization-hooks) via `execArgv`.
+		* @default true
+		*/
+		viteModuleRunner?: boolean;
+		/**
+		* If module runner is disabled, Vitest uses a module loader to transform files to support
+		* `import.meta.vitest` and `vi.mock`.
+		*
+		* If you don't use these features, you can disable this.
+		*
+		* This option only affects `loader.load` method, Vitest always defines a `loader.resolve` to populate the module graph.
+		*/
+		nodeLoader?: boolean;
 	};
+	/**
+	* Define tags available in your test files.
+	*
+	* If test defines a tag that is not listed here, an error will be thrown.
+	*/
+	tags?: TestTagDefinition[];
+	/**
+	* Should Vitest throw an error if test has a tag that is not defined in the config.
+	* @default true
+	*/
+	strictTags?: boolean;
 }
 interface TypecheckConfig {
 	/**
@@ -3163,11 +3391,20 @@ interface UserConfig extends InlineConfig {
 	* @experimental
 	*/
 	clearCache?: boolean;
+	/**
+	* Tags expression to filter tests to run. Multiple filters will be applied using AND logic.
+	* @see {@link https://vitest.dev/guide/test-tags#syntax}
+	*/
+	tagsFilter?: string[];
+	/**
+	* Log all available tags instead of running tests.
+	*/
+	listTags?: boolean | "json";
 }
 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" | "pool" | "cliExclude" | "diff" | "setupFiles" | "snapshotEnvironment" | "bail" | "name" | "vmMemoryLimit" | "fileParallelism"> {
+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" | "fileParallelism" | "tagsFilter"> {
 	mode: VitestRunMode;
 	name: ProjectName["label"];
 	color?: ProjectName["color"];
@@ -3220,8 +3457,20 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config"
 	maxWorkers: number;
 	vmMemoryLimit?: UserConfig["vmMemoryLimit"];
 	dumpDir?: string;
+	tagsFilter?: string[];
+	experimental: Omit<Required<UserConfig>["experimental"], "importDurations"> & {
+		importDurations: {
+			print: boolean | "on-warn";
+			limit: number;
+			failOnDanger: boolean;
+			thresholds: {
+				warn: number;
+				danger: number;
+			};
+		};
+	};
 }
-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";
+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" | "tagsFilter";
 interface ServerDepsOptions {
 	/**
 	* Externalize means that Vite will bpass the package to native Node.
@@ -3267,5 +3516,5 @@ type TestProjectInlineConfiguration = (UserWorkspaceConfig & {
 });
 type TestProjectConfiguration = string | TestProjectInlineConfiguration | Promise<UserWorkspaceConfig> | UserProjectConfigFn;
 
-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 _, ReportContext 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, TestProjectConfiguration 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 };
+export { DefaultReporter as $, Logger as L, TestProject as T, Vitest as V, DotReporter as a1, GithubActionsReporter as a3, HangingProcessReporter as a5, JUnitReporter as a7, TestModule as aB, TestSuite as aM, VerboseBenchmarkReporter as aR, VerboseReporter as aS, VitestPackageInstaller as aU, experimental_getRunnerTask as aX, CoverageMap as aY, JsonReporter as aa, ReportersMap as ap, TapFlatReporter as av, TapReporter as aw, TestCase as ay, TestCollection as az, TestSpecification as i, AgentReporter as m, BaseReporter as n, BenchmarkReporter as p, BenchmarkReportsMap as q };
+export type { ApiConfig as A, BaseCoverageOptions as B, CoverageV8Options as C, BrowserProviderOption as D, BrowserScript as E, BrowserServerFactory as F, BrowserServerOptions as G, BrowserServerState as H, InlineConfig as I, BrowserServerStateSession as J, BuiltinEnvironment as K, BuiltinReporterOptions as M, BuiltinReporters as N, CSSModuleScopeStrategy as O, PoolWorker as P, CoverageIstanbulOptions as Q, ResolvedCoverageOptions as R, CoverageOptions as S, UserWorkspaceConfig as U, WatcherTriggerPattern as W, CoverageProvider as X, CoverageProviderModule as Y, CoverageReporter as Z, CustomProviderOptions as _, TestProjectConfiguration as a, DepsOptimizationOptions as a0, EnvironmentOptions as a2, HTMLOptions as a4, JUnitOptions as a6, JsonAssertionResult as a8, JsonOptions as a9, TestDiagnostic as aA, TestModuleState as aC, TestResult as aD, TestResultFailed as aE, TestResultPassed as aF, TestResultSkipped as aG, TestRunEndReason as aH, TestRunResult as aI, TestSequencerConstructor as aJ, TestSpecificationOptions as aK, TestState as aL, TestSuiteState as aN, ToMatchScreenshotComparators as aO, ToMatchScreenshotOptions as aP, TypecheckConfig as aQ, VitestEnvironment as aT, WorkerResponse as aV, _BrowserNames as aW, JsonTestResult as ab, JsonTestResults as ac, ModuleDiagnostic as ad, OnServerRestartHandler as ae, OnTestsRerunHandler as af, ParentProjectBrowser as ag, Pool as ah, PoolRunnerInitializer as ai, PoolTask as aj, ProjectBrowser as ak, ProjectConfig as al, ReportContext as am, ReportedHookContext as an, Reporter as ao, ResolveSnapshotPathHandler as aq, ResolveSnapshotPathHandlerContext as ar, ResolvedBrowserOptions as as, ResolvedProjectConfig as at, SerializedTestProject as au, TaskOptions as ax, UserProjectConfigFn as b, UserProjectConfigExport as c, TestProjectInlineConfiguration as d, UserConfig as e, ResolvedConfig as f, VitestRunMode as g, VitestOptions as h, PoolOptions as j, WorkerRequest as k, TestSequencer as l, BenchmarkBuiltinReporters as o, BenchmarkUserOptions as r, BrowserBuiltinProvider as s, BrowserCommand as t, BrowserCommandContext as u, BrowserConfigOptions as v, BrowserInstanceOption as w, BrowserModuleMocker as x, BrowserOrchestrator as y, BrowserProvider as z };