vitest 2.0.0-beta.8 → 2.0.0

package/dist/{reporters-DaDey3o0.d.ts → reporters-DrhyxxXt.d.ts}

@@ -1,18 +1,19 @@
 import * as vite from 'vite';
-import { TransformResult as TransformResult$1, ViteDevServer, UserConfig as UserConfig$1, ConfigEnv, ServerOptions, DepOptimizationConfig, AliasOptions } from 'vite';
+import { ViteDevServer, TransformResult as TransformResult$1, UserConfig as UserConfig$1, ConfigEnv, ServerOptions, DepOptimizationConfig, AliasOptions } from 'vite';
 import * as _vitest_runner from '@vitest/runner';
-import { File, Test as Test$1, Suite, TaskResultPack, CancelReason, Task, TaskMeta, Custom, SequenceHooks, SequenceSetupFiles } from '@vitest/runner';
-import { RawSourceMap, ViteNodeResolveId, FetchResult, ModuleCacheMap, ViteNodeServerOptions } from 'vite-node';
-import { SnapshotResult, SnapshotSummary, SnapshotStateOptions, SnapshotState } from '@vitest/snapshot';
+import { File, Test as Test$1, Suite, TaskResultPack, Task, CancelReason, TaskMeta, Custom, SequenceHooks, SequenceSetupFiles } from '@vitest/runner';
+import { RawSourceMap, FetchResult, ViteNodeResolveId, ModuleCacheMap, ViteNodeServerOptions } from 'vite-node';
+import { SnapshotSummary, SnapshotResult, SnapshotStateOptions, SnapshotState } from '@vitest/snapshot';
 import { PromisifyAssertion, Tester, ExpectStatic } from '@vitest/expect';
 import { ChainableFunction } from '@vitest/runner/utils';
-import { ParsedStack, Awaitable as Awaitable$1, Arrayable as Arrayable$1 } from '@vitest/utils';
+import { ParsedStack, Awaitable as Awaitable$1, ErrorWithDiff, Arrayable as Arrayable$1 } from '@vitest/utils';
 import { TaskResult, Bench, Options as Options$1 } from 'tinybench';
 import { Writable } from 'node:stream';
 import { ViteNodeRunner } from 'vite-node/client';
 import { SnapshotManager } from '@vitest/snapshot/manager';
 import { ViteNodeServer } from 'vite-node/server';
 import { MessagePort } from 'node:worker_threads';
+import { StackTraceParserOptions } from '@vitest/utils/source-map';
 import { Stats } from 'node:fs';
 import * as chai from 'chai';
 
@@ -380,11 +381,17 @@ interface PoolOptions extends Record<string, unknown> {
      */
     vmForks?: ForksOptions & VmOptions;
 }
+interface ResolvedPoolOptions extends PoolOptions {
+    threads?: ResolvedThreadsOptions & WorkerContextOptions;
+    forks?: ResolvedForksOptions & WorkerContextOptions;
+    vmThreads?: ResolvedThreadsOptions & VmOptions;
+    vmForks?: ResolvedForksOptions & VmOptions;
+}
 interface ThreadsOptions {
     /** Minimum amount of threads to use */
-    minThreads?: number;
+    minThreads?: number | string;
     /** Maximum amount of threads to use */
-    maxThreads?: number;
+    maxThreads?: number | string;
     /**
      * Run tests inside a single thread.
      *
@@ -400,11 +407,15 @@ interface ThreadsOptions {
      */
     useAtomics?: boolean;
 }
+interface ResolvedThreadsOptions extends ThreadsOptions {
+    minThreads?: number;
+    maxThreads?: number;
+}
 interface ForksOptions {
     /** Minimum amount of child processes to use */
-    minForks?: number;
+    minForks?: number | string;
     /** Maximum amount of child processes to use */
-    maxForks?: number;
+    maxForks?: number | string;
     /**
      * Run tests inside a single fork.
      *
@@ -412,6 +423,10 @@ interface ForksOptions {
      */
     singleFork?: boolean;
 }
+interface ResolvedForksOptions extends ForksOptions {
+    minForks?: number;
+    maxForks?: number;
+}
 interface WorkerContextOptions {
     /**
      * Isolate test environment by recycling `worker_threads` or `child_process` after each test
@@ -612,10 +627,18 @@ declare class Typechecker {
     getTestPacks(): TaskResultPack[];
 }
 
+interface PrintErrorResult {
+    nearest?: ParsedStack;
+}
+
 interface ErrorOptions {
     type?: string;
     fullStack?: boolean;
     project?: WorkspaceProject;
+    verbose?: boolean;
+    screenshotPaths?: string[];
+    task?: Task;
+    showCodeFrame?: boolean;
 }
 declare class Logger {
     ctx: Vitest;
@@ -632,7 +655,7 @@ declare class Logger {
     clearFullScreen(message: string): void;
     clearScreen(message: string, force?: boolean): void;
     private _clearScreen;
-    printError(err: unknown, options?: ErrorOptions): void;
+    printError(err: unknown, options?: ErrorOptions): PrintErrorResult | undefined;
     clearHighlightCache(filename?: string): void;
     highlight(filename: string, source: string): string;
     printNoTestFound(filters?: string[]): void;
@@ -645,15 +668,33 @@ interface BrowserProviderInitializationOptions {
     browser: string;
     options?: BrowserProviderOptions;
 }
+interface CDPSession {
+    send: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+    once: (event: string, listener: (...args: unknown[]) => void) => void;
+    off: (event: string, listener: (...args: unknown[]) => void) => void;
+}
 interface BrowserProvider {
     name: string;
+    /**
+     * @experimental opt-in into file parallelisation
+     */
+    supportsParallelism: boolean;
     getSupportedBrowsers: () => readonly string[];
-    openPage: (url: string) => Awaitable$1<void>;
+    beforeCommand?: (command: string, args: unknown[]) => Awaitable$1<void>;
+    afterCommand?: (command: string, args: unknown[]) => Awaitable$1<void>;
+    getCommandsContext: (contextId: string) => Record<string, unknown>;
+    openPage: (contextId: string, url: string) => Promise<void>;
+    getCDPSession?: (contextId: string) => Promise<CDPSession>;
     close: () => Awaitable$1<void>;
     initialize(ctx: WorkspaceProject, options: BrowserProviderInitializationOptions): Awaitable$1<void>;
 }
+interface BrowserProviderModule {
+    new (): BrowserProvider;
+}
 interface BrowserProviderOptions {
 }
+type BrowserBuiltinProvider = 'webdriverio' | 'playwright' | 'preview';
 interface BrowserConfigOptions {
     /**
      * if running tests in the browser should be the default
@@ -670,7 +711,7 @@ interface BrowserConfigOptions {
      *
      * @default 'preview'
      */
-    provider?: 'webdriverio' | 'playwright' | 'preview' | (string & {});
+    provider?: BrowserBuiltinProvider | (string & {});
     /**
      * Options that are passed down to a browser provider.
      * To support type hinting, add one of the types to your tsconfig.json "compilerOptions.types" field:
@@ -700,6 +741,13 @@ interface BrowserConfigOptions {
      * @default true
      */
     isolate?: boolean;
+    /**
+     * Run test files in parallel if provider supports this option
+     * This option only has effect in headless mode (enabled in CI by default)
+     *
+     * @default // Same as "test.fileParallelism"
+     */
+    fileParallelism?: boolean;
     /**
      * Show Vitest UI
      *
@@ -721,6 +769,18 @@ interface BrowserConfigOptions {
          */
         height: number;
     };
+    /**
+     * Directory where screenshots will be saved when page.screenshot() is called
+     * If not set, all screenshots are saved to __screenshots__ directory in the same folder as the test file.
+     * If this is set, it will be resolved relative to the project root.
+     * @default __screenshots__
+     */
+    screenshotDirectory?: string;
+    /**
+     * Should Vitest take screenshots if the test fails
+     * @default !browser.ui
+     */
+    screenshotFailures?: boolean;
     /**
      * Scripts injected into the tester iframe.
      */
@@ -732,7 +792,7 @@ interface BrowserConfigOptions {
     /**
      * Commands that will be executed on the server
      * via the browser `import("@vitest/browser/context").commands` API.
-     * @see {@link https://vitest.dev/guide/browser#commands}
+     * @see {@link https://vitest.dev/guide/browser/commands}
      */
     commands?: Record<string, BrowserCommand<any>>;
 }
@@ -740,6 +800,31 @@ interface BrowserCommandContext {
     testPath: string | undefined;
     provider: BrowserProvider;
     project: WorkspaceProject;
+    contextId: string;
+}
+interface BrowserServerStateContext {
+    files: string[];
+    method: 'run' | 'collect';
+    resolve: () => void;
+    reject: (v: unknown) => void;
+}
+interface BrowserOrchestrator {
+    createTesters: (files: string[]) => Promise<void>;
+    onCancel: (reason: CancelReason) => Promise<void>;
+}
+interface BrowserServerState {
+    orchestrators: Map<string, BrowserOrchestrator>;
+    getContext: (contextId: string) => BrowserServerStateContext | undefined;
+    createAsyncContext: (method: 'collect' | 'run', contextId: string, files: string[]) => Promise<void>;
+}
+interface BrowserServer {
+    vite: ViteDevServer;
+    state: BrowserServerState;
+    provider: BrowserProvider;
+    close: () => Promise<void>;
+    initBrowserProvider: () => Promise<void>;
+    parseStacktrace: (stack: string) => ParsedStack[];
+    parseErrorStacktrace: (error: ErrorWithDiff, options?: StackTraceParserOptions) => ParsedStack[];
 }
 interface BrowserCommand<Payload extends unknown[]> {
     (context: BrowserCommandContext, ...payload: Payload): Awaitable$1<any>;
@@ -776,6 +861,7 @@ interface ResolvedBrowserOptions extends BrowserConfigOptions {
     enabled: boolean;
     headless: boolean;
     isolate: boolean;
+    fileParallelism: boolean;
     api: ApiConfig;
     ui: boolean;
     viewport: {
@@ -784,156 +870,6 @@ interface ResolvedBrowserOptions extends BrowserConfigOptions {
     };
 }
 
-declare class VitestBrowserServerMocker {
-    #private;
-    mocks: Map<string, {
-        sessionId: string;
-        mock: string | null | undefined;
-    }>;
-    constructor(project: WorkspaceProject);
-    mock(sessionId: string, rawId: string, importer: string, hasFactory: boolean): Promise<string>;
-    unmock(rawId: string, importer: string): Promise<string>;
-    resolveMock(rawId: string, importer: string, hasFactory: boolean): Promise<{
-        type: "factory";
-        resolvedId: string;
-        mockPath?: undefined;
-    } | {
-        type: "redirect" | "automock";
-        mockPath: string | null;
-        resolvedId: string;
-    }>;
-    invalidateModuleById(id: string): void;
-    private resolveId;
-    resolveMockPath(mockPath: string, external: string | null): string | null;
-}
-
-type ArgumentsType$1<T> = T extends (...args: infer A) => any ? A : never;
-type ReturnType$1<T> = T extends (...args: any) => infer R ? R : never;
-type PromisifyFn<T> = ReturnType$1<T> extends Promise<any> ? T : (...args: ArgumentsType$1<T>) => Promise<Awaited<ReturnType$1<T>>>;
-type BirpcResolver = (name: string, resolved: (...args: unknown[]) => unknown) => ((...args: unknown[]) => unknown) | undefined;
-interface ChannelOptions {
-    /**
-     * Function to post raw message
-     */
-    post: (data: any, ...extras: any[]) => any | Promise<any>;
-    /**
-     * Listener to receive raw message
-     */
-    on: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
-    /**
-     * Custom function to serialize data
-     *
-     * by default it passes the data as-is
-     */
-    serialize?: (data: any) => any;
-    /**
-     * Custom function to deserialize data
-     *
-     * by default it passes the data as-is
-     */
-    deserialize?: (data: any) => any;
-}
-interface EventOptions<Remote> {
-    /**
-     * Names of remote functions that do not need response.
-     */
-    eventNames?: (keyof Remote)[];
-    /**
-     * Maximum timeout for waiting for response, in milliseconds.
-     *
-     * @default 60_000
-     */
-    timeout?: number;
-    /**
-     * Custom resolver to resolve function to be called
-     *
-     * For advanced use cases only
-     */
-    resolver?: BirpcResolver;
-    /**
-     * Custom error handler
-     */
-    onError?: (error: Error, functionName: string, args: any[]) => boolean | void;
-    /**
-     * Custom error handler for timeouts
-     */
-    onTimeoutError?: (functionName: string, args: any[]) => boolean | void;
-}
-type BirpcOptions<Remote> = EventOptions<Remote> & ChannelOptions;
-type BirpcFn<T> = PromisifyFn<T> & {
-    /**
-     * Send event without asking for response
-     */
-    asEvent: (...args: ArgumentsType$1<T>) => void;
-};
-type BirpcReturn<RemoteFunctions, LocalFunctions = Record<string, never>> = {
-    [K in keyof RemoteFunctions]: BirpcFn<RemoteFunctions[K]>;
-} & {
-    $functions: LocalFunctions;
-};
-
-interface TransformResultWithSource extends TransformResult$1 {
-    source?: string;
-}
-interface WebSocketHandlers {
-    onCollected: (files?: File[]) => Promise<void>;
-    onTaskUpdate: (packs: TaskResultPack[]) => void;
-    getFiles: () => File[];
-    getTestFiles: () => Promise<[{
-        name: string;
-        root: string;
-    }, file: string][]>;
-    getPaths: () => string[];
-    getConfig: () => ResolvedConfig;
-    getModuleGraph: (projectName: string, id: string, browser?: boolean) => Promise<ModuleGraphData>;
-    getTransformResult: (projectName: string, id: string, browser?: boolean) => Promise<TransformResultWithSource | undefined>;
-    readTestFile: (id: string) => Promise<string | null>;
-    saveTestFile: (id: string, content: string) => Promise<void>;
-    rerun: (files: string[]) => Promise<void>;
-    updateSnapshot: (file?: File) => Promise<void>;
-    getUnhandledErrors: () => unknown[];
-}
-interface WebSocketBrowserHandlers {
-    resolveSnapshotPath: (testPath: string) => string;
-    resolveSnapshotRawPath: (testPath: string, rawPath: string) => string;
-    onUnhandledError: (error: unknown, type: string) => Promise<void>;
-    onCollected: (files?: File[]) => Promise<void>;
-    onTaskUpdate: (packs: TaskResultPack[]) => void;
-    onAfterSuiteRun: (meta: AfterSuiteRunMeta) => void;
-    onCancel: (reason: CancelReason) => void;
-    getCountOfFailedTests: () => number;
-    readSnapshotFile: (id: string) => Promise<string | null>;
-    saveSnapshotFile: (id: string, content: string) => Promise<void>;
-    removeSnapshotFile: (id: string) => Promise<void>;
-    sendLog: (log: UserConsoleLog) => void;
-    finishBrowserTests: () => void;
-    snapshotSaved: (snapshot: SnapshotResult) => void;
-    getBrowserFiles: () => string[];
-    debug: (...args: string[]) => void;
-    resolveId: (id: string, importer?: string) => Promise<ViteNodeResolveId | null>;
-    triggerCommand: (command: string, testPath: string | undefined, payload: unknown[]) => Promise<void>;
-    queueMock: (id: string, importer: string, hasFactory: boolean) => Promise<string>;
-    queueUnmock: (id: string, importer: string) => Promise<string>;
-    resolveMock: (id: string, importer: string) => Promise<{
-        type: 'factory' | 'redirect' | 'automock';
-        mockPath?: string | null;
-        resolvedId: string;
-    }>;
-    invalidateMocks: () => void;
-    getBrowserFileSourceMap: (id: string) => Promise<TransformResult$1['map'] | undefined>;
-    getProvidedContext: () => ProvidedContext;
-}
-interface WebSocketEvents extends Pick<Reporter, 'onCollected' | 'onFinished' | 'onTaskUpdate' | 'onUserConsoleLog' | 'onPathsCollected' | 'onSpecsCollected'> {
-    onFinishedReportCoverage: () => void;
-}
-interface WebSocketBrowserEvents {
-    onCancel: (reason: CancelReason) => void;
-    startMocking: (id: string) => Promise<string[]>;
-    createTesters: (files: string[]) => Promise<void>;
-}
-type WebSocketRPC = BirpcReturn<WebSocketEvents, WebSocketHandlers>;
-type WebSocketBrowserRPC = BirpcReturn<WebSocketBrowserEvents, WebSocketBrowserHandlers>;
-
 interface InitializeProjectOptions extends UserWorkspaceConfig {
     workspaceConfigPath: string;
     extends?: string;
@@ -947,20 +883,9 @@ declare class WorkspaceProject {
     server: ViteDevServer;
     vitenode: ViteNodeServer;
     runner: ViteNodeRunner;
-    browser?: ViteDevServer;
+    browser?: BrowserServer;
     typechecker?: Typechecker;
     closingPromise: Promise<unknown> | undefined;
-    browserProvider: BrowserProvider | undefined;
-    browserMocker: VitestBrowserServerMocker;
-    browserRpc: {
-        orchestrators: Map<string, WebSocketBrowserRPC>;
-        testers: Map<string, WebSocketBrowserRPC>;
-    };
-    browserState: {
-        files: string[];
-        resolve: () => void;
-        reject: (v: unknown) => void;
-    } | undefined;
     testFilesList: string[] | null;
     readonly id: string;
     readonly tmpDir: string;
@@ -969,7 +894,7 @@ declare class WorkspaceProject {
     constructor(path: string | number, ctx: Vitest, options?: InitializeProjectOptions | undefined);
     getName(): string;
     isCore(): boolean;
-    provide: <T extends never>(key: T, value: ProvidedContext[T]) => void;
+    provide<T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]): void;
     getProvidedContext(): ProvidedContext;
     initializeGlobalSetup(): Promise<void>;
     teardownGlobalSetup(): Promise<void>;
@@ -991,7 +916,7 @@ declare class WorkspaceProject {
     static createCoreProject(ctx: Vitest): Promise<WorkspaceProject>;
     setServer(options: UserConfig, server: ViteDevServer): Promise<void>;
     isBrowserEnabled(): boolean;
-    getSerializableConfig(): ResolvedConfig;
+    getSerializableConfig(method?: 'run' | 'collect'): ResolvedConfig;
     close(): Promise<unknown>;
     private clearTmpDir;
     initBrowserProvider(): Promise<void>;
@@ -1002,6 +927,7 @@ type RunWithFiles = (files: WorkspaceSpec[], invalidates?: string[]) => Awaitabl
 interface ProcessPool {
     name: string;
     runTests: RunWithFiles;
+    collectTests: RunWithFiles;
     close?: () => Awaitable$1<void>;
 }
 declare function getFilePoolName(project: WorkspaceProject, file: string): Pool;
@@ -1009,7 +935,7 @@ declare function getFilePoolName(project: WorkspaceProject, file: string): Pool;
 type Awaitable<T> = T | PromiseLike<T>;
 type Nullable<T> = T | null | undefined;
 type Arrayable<T> = T | Array<T>;
-type ArgumentsType<T> = T extends (...args: infer U) => any ? U : never;
+type ArgumentsType$1<T> = T extends (...args: infer U) => any ? U : never;
 type MutableArray<T extends readonly any[]> = {
     -readonly [k in keyof T]: T[k];
 };
@@ -1171,6 +1097,7 @@ declare class Vitest {
     private _onSetServer;
     private _onCancelListeners;
     setServer(options: UserConfig, server: ViteDevServer, cliOptions: UserConfig): Promise<void>;
+    provide<T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]): void;
     private createCoreProject;
     getCoreWorkspaceProject(): WorkspaceProject;
     getProjectByTaskId(taskId: string): WorkspaceProject;
@@ -1180,6 +1107,10 @@ declare class Vitest {
     private initCoverageProvider;
     private initBrowserProviders;
     mergeReports(): Promise<void>;
+    collect(filters?: string[]): Promise<{
+        tests: File[];
+        errors: unknown[];
+    }>;
     start(filters?: string[]): Promise<void>;
     init(): Promise<void>;
     private getTestDependencies;
@@ -1188,6 +1119,7 @@ declare class Vitest {
     initializeGlobalSetup(paths: WorkspaceSpec[]): Promise<void>;
     private initializeDistPath;
     runFiles(specs: WorkspaceSpec[], allTestsRun: boolean): Promise<void>;
+    collectFiles(specs: WorkspaceSpec[]): Promise<void>;
     cancelCurrentRun(reason: CancelReason): Promise<void>;
     rerunFiles(files?: string[], trigger?: string): Promise<void>;
     changeProjectName(pattern: string): Promise<void>;
@@ -1214,7 +1146,7 @@ declare class Vitest {
      * Close the thread pool and exit the process
      */
     exit(force?: boolean): Promise<void>;
-    report<T extends keyof Reporter>(name: T, ...args: ArgumentsType<Reporter[T]>): Promise<void>;
+    report<T extends keyof Reporter>(name: T, ...args: ArgumentsType$1<Reporter[T]>): Promise<void>;
     getTestFilepaths(): Promise<string[]>;
     globTestFiles(filters?: string[]): Promise<WorkspaceSpec[]>;
     shouldKeepServer(): boolean;
@@ -1299,7 +1231,7 @@ interface Reporter {
     onPathsCollected?: (paths?: string[]) => Awaitable<void>;
     onSpecsCollected?: (specs?: SerializableSpec[]) => Awaitable<void>;
     onCollected?: (files?: File[]) => Awaitable<void>;
-    onFinished?: (files?: File[], errors?: unknown[], coverage?: unknown) => Awaitable<void>;
+    onFinished?: (files: File[], errors: unknown[], coverage?: unknown) => Awaitable<void>;
     onTaskUpdate?: (packs: TaskResultPack[]) => Awaitable<void>;
     onTestRemoved?: (trigger?: string) => Awaitable<void>;
     onWatcherStart?: (files?: File[], errors?: unknown[]) => Awaitable<void>;
@@ -1309,10 +1241,13 @@ interface Reporter {
     onProcessTimeout?: () => Awaitable<void>;
 }
 
-type SerializableSpec = [project: {
-    name: string | undefined;
-    root: string;
-}, file: string];
+type SerializableSpec = [
+    project: {
+        name: string | undefined;
+        root: string;
+    },
+    file: string
+];
 
 interface JUnitOptions {
     outputFile?: string;
@@ -1356,8 +1291,10 @@ declare abstract class BaseReporter implements Reporter {
     start: number;
     end: number;
     watchFilters?: string[];
+    failedUnwatchedFiles: Task[];
     isTTY: boolean;
     ctx: Vitest;
+    protected verbose: boolean;
     private _filesInWatchMode;
     private _lastRunTimeout;
     private _lastRunTimer;
@@ -1370,6 +1307,7 @@ declare abstract class BaseReporter implements Reporter {
     relative(path: string): string;
     onFinished(files?: File[], errors?: unknown[]): void;
     onTaskUpdate(packs: TaskResultPack[]): void;
+    protected printTask(task: Task): void;
     onWatcherStart(files?: File[], errors?: unknown[]): void;
     private resetLastRunLog;
     onWatcherRerun(files: string[], trigger?: string): void;
@@ -1385,7 +1323,7 @@ declare abstract class BaseReporter implements Reporter {
 }
 
 declare class BasicReporter extends BaseReporter {
-    isTTY: boolean;
+    constructor();
     reportSummary(files: File[], errors: unknown[]): void;
 }
 
@@ -1438,6 +1376,7 @@ declare class DotReporter extends BaseReporter {
 }
 
 declare class VerboseReporter extends DefaultReporter {
+    protected verbose: boolean;
     constructor();
     onTaskUpdate(packs: TaskResultPack[]): void;
 }
@@ -1626,6 +1565,71 @@ interface LinkMapper {
     assetPath(node: Node, name: string): string;
 }
 
+type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never;
+type ReturnType$1<T> = T extends (...args: any) => infer R ? R : never;
+type PromisifyFn<T> = ReturnType$1<T> extends Promise<any> ? T : (...args: ArgumentsType<T>) => Promise<Awaited<ReturnType$1<T>>>;
+type BirpcResolver = (name: string, resolved: (...args: unknown[]) => unknown) => ((...args: unknown[]) => unknown) | undefined;
+interface ChannelOptions {
+    /**
+     * Function to post raw message
+     */
+    post: (data: any, ...extras: any[]) => any | Promise<any>;
+    /**
+     * Listener to receive raw message
+     */
+    on: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
+    /**
+     * Custom function to serialize data
+     *
+     * by default it passes the data as-is
+     */
+    serialize?: (data: any) => any;
+    /**
+     * Custom function to deserialize data
+     *
+     * by default it passes the data as-is
+     */
+    deserialize?: (data: any) => any;
+}
+interface EventOptions<Remote> {
+    /**
+     * Names of remote functions that do not need response.
+     */
+    eventNames?: (keyof Remote)[];
+    /**
+     * Maximum timeout for waiting for response, in milliseconds.
+     *
+     * @default 60_000
+     */
+    timeout?: number;
+    /**
+     * Custom resolver to resolve function to be called
+     *
+     * For advanced use cases only
+     */
+    resolver?: BirpcResolver;
+    /**
+     * Custom error handler
+     */
+    onError?: (error: Error, functionName: string, args: any[]) => boolean | void;
+    /**
+     * Custom error handler for timeouts
+     */
+    onTimeoutError?: (functionName: string, args: any[]) => boolean | void;
+}
+type BirpcOptions<Remote> = EventOptions<Remote> & ChannelOptions;
+type BirpcFn<T> = PromisifyFn<T> & {
+    /**
+     * Send event without asking for response
+     */
+    asEvent: (...args: ArgumentsType<T>) => void;
+};
+type BirpcReturn<RemoteFunctions, LocalFunctions = Record<string, never>> = {
+    [K in keyof RemoteFunctions]: BirpcFn<RemoteFunctions[K]>;
+} & {
+    $functions: LocalFunctions;
+};
+
 type MockFactoryWithHelper<M = unknown> = (importOriginal: <T extends M>() => Promise<T>) => any;
 type MockFactory = () => any;
 type MockMap = Map<string, Record<string, string | null | MockFactory>>;
@@ -1756,20 +1760,20 @@ interface CoverageProviderModule {
 type CoverageReporter = keyof ReportOptions | (string & {});
 type CoverageReporterWithOptions<ReporterName extends CoverageReporter = CoverageReporter> = ReporterName extends keyof ReportOptions ? ReportOptions[ReporterName] extends never ? [ReporterName, {}] : [ReporterName, Partial<ReportOptions[ReporterName]>] : [ReporterName, Record<string, unknown>];
 type Provider = 'v8' | 'istanbul' | 'custom' | undefined;
-type CoverageOptions<T extends Provider = Provider> = T extends 'istanbul' ? ({
+type CoverageOptions<T extends Provider = Provider> = T extends 'istanbul' ? {
     provider: T;
-} & CoverageIstanbulOptions) : T extends 'v8' ? ({
+} & CoverageIstanbulOptions : T extends 'v8' ? {
     /**
      * Provider to use for coverage collection.
      *
      * @default 'v8'
      */
     provider: T;
-} & CoverageV8Options) : T extends 'custom' ? ({
+} & CoverageV8Options : T extends 'custom' ? {
     provider: T;
-} & CustomProviderOptions) : ({
+} & CustomProviderOptions : {
     provider?: T;
-} & (CoverageV8Options));
+} & CoverageV8Options;
 /** Fields that have default values. Internally these will always be defined. */
 type FieldsWithDefaultValues = 'enabled' | 'clean' | 'cleanOnRerun' | 'reportsDirectory' | 'exclude' | 'extension' | 'reportOnFailure' | 'allowExternal' | 'processingConcurrency';
 type ResolvedCoverageOptions<T extends Provider = Provider> = CoverageOptions<T> & Required<Pick<CoverageOptions<T>, FieldsWithDefaultValues>> & {
@@ -2089,6 +2093,9 @@ type BenchmarkAPI = ChainableBenchmarkAPI & {
     runIf: (condition: any) => ChainableBenchmarkAPI;
 };
 
+declare const defaultBrowserPort = 63315;
+declare const extraInlineDeps: (string | RegExp)[];
+
 declare const defaultInclude: string[];
 declare const defaultExclude: string[];
 declare const coverageConfigDefaults: ResolvedCoverageOptions;
@@ -2104,8 +2111,6 @@ declare const configDefaults: Readonly<{
     mockReset: false;
     include: string[];
     exclude: string[];
-    testTimeout: number;
-    hookTimeout: number;
     teardownTimeout: number;
     forceRerunTriggers: string[];
     update: false;
@@ -2136,8 +2141,6 @@ declare const configDefaults: Readonly<{
     disableConsoleIntercept: false;
 }>;
 
-declare const extraInlineDeps: (string | RegExp)[];
-
 interface UserWorkspaceConfig extends UserConfig$1 {
     test?: ProjectConfig;
 }
@@ -2153,9 +2156,9 @@ declare function defineConfig(config: Promise<UserConfig$1>): Promise<UserConfig
 declare function defineConfig(config: UserConfigFnObject): UserConfigFnObject;
 declare function defineConfig(config: UserConfigExport): UserConfigExport;
 declare function defineProject<T extends UserProjectConfigExport>(config: T): T;
-type Workspace = (string | (UserProjectConfigExport & {
+type Workspace = string | (UserProjectConfigExport & {
     extends?: string;
-}));
+});
 declare function defineWorkspace(config: Workspace[]): Workspace[];
 
 type BuiltinEnvironment = 'node' | 'jsdom' | 'happy-dom' | 'edge-runtime';
@@ -2423,7 +2426,7 @@ interface InlineConfig {
      *
      * Supports 'threads', 'forks', 'vmThreads'
      *
-     * @default 'threads'
+     * @default 'forks'
      */
     pool?: Exclude<Pool, 'browser'>;
     /**
@@ -2431,13 +2434,13 @@ interface InlineConfig {
      */
     poolOptions?: PoolOptions;
     /**
-     * Maximum number of workers to run tests in. `poolOptions.{threads,vmThreads}.maxThreads`/`poolOptions.forks.maxForks` has higher priority.
+     * Maximum number or percentage of workers to run tests in. `poolOptions.{threads,vmThreads}.maxThreads`/`poolOptions.forks.maxForks` has higher priority.
      */
-    maxWorkers?: number;
+    maxWorkers?: number | string;
     /**
-     * Minimum number of workers to run tests in. `poolOptions.{threads,vmThreads}.minThreads`/`poolOptions.forks.minForks` has higher priority.
+     * Minimum number or percentage of workers to run tests in. `poolOptions.{threads,vmThreads}.minThreads`/`poolOptions.forks.minForks` has higher priority.
      */
-    minWorkers?: number;
+    minWorkers?: number | string;
     /**
      * Should all test files run in parallel. Doesn't affect tests running in the same file.
      * Setting this to `false` will override `maxWorkers` and `minWorkers` options to `1`.
@@ -2626,7 +2629,7 @@ interface InlineConfig {
      */
     resolveSnapshotPath?: (path: string, extension: string) => string;
     /**
-     * Path to a custom snapshot environment module that has a defualt export of `SnapshotEnvironment` object.
+     * Path to a custom snapshot environment module that has a default export of `SnapshotEnvironment` object.
      */
     snapshotEnvironment?: string;
     /**
@@ -2934,9 +2937,10 @@ interface UserConfig extends InlineConfig {
      */
     mergeReports?: string;
 }
-interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters' | 'browser' | 'coverage' | 'testNamePattern' | 'related' | 'api' | 'reporters' | 'resolveSnapshotPath' | 'benchmark' | 'shard' | 'cache' | 'sequence' | 'typecheck' | 'runner' | 'poolOptions' | 'pool' | 'cliExclude'> {
+interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters' | 'browser' | 'coverage' | 'testNamePattern' | 'related' | 'api' | 'reporters' | 'resolveSnapshotPath' | 'benchmark' | 'shard' | 'cache' | 'sequence' | 'typecheck' | 'runner' | 'poolOptions' | 'pool' | 'cliExclude' | 'diff'> {
     mode: VitestRunMode;
     base?: string;
+    diff?: string;
     config?: string;
     filters?: string[];
     testNamePattern?: RegExp;
@@ -2945,7 +2949,7 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters'
     snapshotOptions: SnapshotStateOptions;
     browser: ResolvedBrowserOptions;
     pool: Pool;
-    poolOptions?: PoolOptions;
+    poolOptions?: ResolvedPoolOptions;
     reporters: (InlineReporter | ReporterWithOptions)[];
     defines: Record<string, any>;
     api?: ApiConfig;
@@ -2973,8 +2977,10 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters'
         enabled: boolean;
     };
     runner?: string;
+    maxWorkers: number;
+    minWorkers: number;
 }
-type ProjectConfig = Omit<UserConfig, 'sequencer' | 'shard' | 'watch' | 'run' | 'cache' | 'update' | 'reporters' | 'outputFile' | 'poolOptions' | 'teardownTimeout' | 'silent' | 'forceRerunTriggers' | 'testNamePattern' | 'ui' | 'open' | 'uiBase' | 'snapshotFormat' | 'resolveSnapshotPath' | 'passWithNoTests' | 'onConsoleLog' | 'onStackTrace' | 'dangerouslyIgnoreUnhandledErrors' | 'slowTestThreshold' | 'inspect' | 'inspectBrk' | 'deps' | 'coverage'> & {
+type ProjectConfig = Omit<UserConfig, 'sequencer' | 'shard' | 'watch' | 'run' | 'cache' | 'update' | 'reporters' | 'outputFile' | 'poolOptions' | 'teardownTimeout' | 'silent' | 'forceRerunTriggers' | 'testNamePattern' | 'ui' | 'open' | 'uiBase' | 'snapshotFormat' | 'resolveSnapshotPath' | 'passWithNoTests' | 'onConsoleLog' | 'onStackTrace' | 'dangerouslyIgnoreUnhandledErrors' | 'slowTestThreshold' | 'inspect' | 'inspectBrk' | 'deps' | 'coverage' | 'maxWorkers' | 'minWorkers' | 'fileParallelism'> & {
     sequencer?: Omit<SequenceOptions, 'sequencer' | 'seed'>;
     deps?: Omit<DepsOptions, 'moduleDirectories'>;
     poolOptions?: {
@@ -3057,6 +3063,7 @@ declare module '@vitest/runner' {
     interface TaskMeta {
         typecheck?: boolean;
         benchmark?: boolean;
+        failScreenshotPath?: string;
     }
     interface File {
         prepareDuration?: number;
@@ -3096,4 +3103,4 @@ type Context = RootAndTarget & {
     lastActivePath?: string;
 };
 
-export { type CoverageIstanbulOptions as $, type AfterSuiteRunMeta as A, type BaseCoverageOptions as B, type CoverageOptions as C, type BenchFunction as D, type Environment as E, type FakeTimerInstallOpts as F, type Benchmark as G, type HTMLOptions as H, type BenchmarkAPI as I, type JsonOptions$1 as J, type BenchmarkResult as K, type BenchmarkUserOptions as L, type MockFactoryWithHelper as M, type BrowserConfigOptions as N, type BuiltinEnvironment as O, type ProvidedContext as P, type CSSModuleScopeStrategy as Q, type ResolvedConfig as R, type CollectLineNumbers as S, type TestSequencer as T, type UserConfig as U, type VitestRunMode as V, type WorkerGlobalState as W, type CollectLines as X, type Constructable as Y, type Context as Z, type ContextTestEnvironment as _, type ResolvedCoverageOptions as a, JUnitReporter as a$, type CoverageReporter as a0, type CoverageV8Options as a1, type CustomProviderOptions as a2, type DepsOptimizationOptions as a3, type EnvironmentOptions as a4, type EnvironmentReturn as a5, type HappyDOMOptions as a6, type InlineConfig as a7, type JSDOMOptions as a8, type ModuleCache as a9, type WebSocketEvents as aA, type WebSocketHandlers as aB, type WebSocketRPC as aC, type WorkerRPC as aD, type PendingSuiteMock as aE, type MockFactory as aF, type MockMap as aG, type UserConfigFnObject as aH, type UserConfigFnPromise as aI, type UserConfigFn as aJ, type UserConfigExport as aK, type UserProjectConfigFn as aL, type UserProjectConfigExport as aM, defineConfig as aN, defineProject as aO, defineWorkspace as aP, configDefaults as aQ, defaultInclude as aR, defaultExclude as aS, coverageConfigDefaults as aT, extraInlineDeps as aU, DefaultReporter as aV, BasicReporter as aW, DotReporter as aX, JsonReporter as aY, VerboseReporter as aZ, TapReporter as a_, type ModuleGraphData as aa, type MutableArray as ab, type Nullable as ac, type OnServerRestartHandler as ad, type Pool as ae, type PoolOptions as af, type ProjectConfig as ag, type RawErrsMap as ah, type ReportContext as ai, type Reporter as aj, type ResolveIdFunction as ak, type ResolvedTestEnvironment as al, type RootAndTarget as am, type RunnerRPC as an, type SerializableSpec as ao, type TransformModePatterns as ap, type TransformResultWithSource as aq, type TscErrorInfo as ar, type TypecheckConfig as as, type UserConsoleLog as at, type UserWorkspaceConfig as au, type VitestEnvironment as av, type VmEnvironmentReturn as aw, type WebSocketBrowserEvents as ax, type WebSocketBrowserHandlers as ay, type WebSocketBrowserRPC as az, type CoverageProvider as b, TapFlatReporter as b0, HangingProcessReporter as b1, GithubActionsReporter as b2, BaseReporter as b3, ReportersMap as b4, type BuiltinReporters as b5, type BuiltinReporterOptions as b6, type JsonAssertionResult as b7, type JsonTestResult as b8, type JsonTestResults as b9, BenchmarkReportsMap as ba, type BenchmarkBuiltinReporters as bb, type CoverageProviderModule as c, type BirpcOptions as d, type RuntimeRPC as e, type ContextRPC as f, type WorkerContext as g, type VitestOptions as h, Vitest as i, WorkspaceProject as j, type WorkspaceSpec as k, type ProcessPool as l, getFilePoolName as m, VitestPackageInstaller as n, type TestSequencerConstructor as o, type BrowserProviderInitializationOptions as p, type BrowserProvider as q, type BrowserProviderOptions as r, type BrowserScript as s, type BrowserCommand as t, type JUnitOptions as u, type RuntimeConfig as v, type ApiConfig as w, type ArgumentsType as x, type Arrayable as y, type Awaitable as z };
+export { type Nullable as $, type ApiConfig as A, type BaseCoverageOptions as B, type CoverageOptions as C, type DepsOptimizationOptions as D, type Environment as E, type FakeTimerInstallOpts as F, type BrowserConfigOptions as G, type HappyDOMOptions as H, type InlineConfig as I, type JSDOMOptions as J, type UserWorkspaceConfig as K, type RunnerRPC as L, type MockFactoryWithHelper as M, type ContextTestEnvironment as N, type ResolvedTestEnvironment as O, type Pool as P, Vitest as Q, type ResolvedConfig as R, type SerializableSpec as S, type TscErrorInfo as T, type UserConfig as U, type VitestEnvironment as V, type WorkerGlobalState as W, type ResolveIdFunction as X, type AfterSuiteRunMeta as Y, type WorkerRPC as Z, type Awaitable as _, type ResolvedCoverageOptions as a, BasicReporter as a$, type Arrayable as a0, type ArgumentsType$1 as a1, type MutableArray as a2, type Constructable as a3, type ModuleCache as a4, type EnvironmentReturn as a5, type VmEnvironmentReturn as a6, type UserConsoleLog as a7, type OnServerRestartHandler as a8, type ReportContext as a9, type BrowserCommandContext as aA, type BrowserServer as aB, type BrowserServerState as aC, type BrowserServerStateContext as aD, type BrowserOrchestrator as aE, type JsonOptions$1 as aF, type JUnitOptions as aG, type HTMLOptions as aH, type PendingSuiteMock as aI, type MockFactory as aJ, type MockMap as aK, type UserConfigFnObject as aL, type UserConfigFnPromise as aM, type UserConfigFn as aN, type UserConfigExport as aO, type UserProjectConfigFn as aP, type UserProjectConfigExport as aQ, defineConfig as aR, defineProject as aS, defineWorkspace as aT, defaultBrowserPort as aU, configDefaults as aV, defaultInclude as aW, defaultExclude as aX, coverageConfigDefaults as aY, extraInlineDeps as aZ, DefaultReporter as a_, type CoverageReporter as aa, type CoverageIstanbulOptions as ab, type CoverageV8Options as ac, type CustomProviderOptions as ad, type BenchmarkUserOptions as ae, type Benchmark as af, type BenchmarkResult as ag, type BenchFunction as ah, type BenchmarkAPI as ai, type VitestOptions as aj, WorkspaceProject as ak, Logger as al, type TestSequencer as am, type WorkspaceSpec as an, type ProcessPool as ao, getFilePoolName as ap, VitestPackageInstaller as aq, type TestSequencerConstructor as ar, type BrowserProviderInitializationOptions as as, type BrowserProvider as at, type CDPSession as au, type BrowserProviderModule as av, type ResolvedBrowserOptions as aw, type BrowserProviderOptions as ax, type BrowserBuiltinProvider as ay, type BrowserCommand as az, type CoverageProvider as b, DotReporter as b0, JsonReporter as b1, VerboseReporter as b2, TapReporter as b3, JUnitReporter as b4, TapFlatReporter as b5, HangingProcessReporter as b6, GithubActionsReporter as b7, BaseReporter as b8, ReportersMap as b9, type BuiltinReporters as ba, type BuiltinReporterOptions as bb, type JsonAssertionResult as bc, type JsonTestResult as bd, type JsonTestResults as be, BenchmarkReportsMap as bf, type BenchmarkBuiltinReporters as bg, type CoverageProviderModule as c, type BirpcOptions as d, type RuntimeRPC as e, type ContextRPC as f, type WorkerContext as g, type RuntimeConfig as h, type ProvidedContext as i, type ModuleGraphData as j, type Reporter as k, type BirpcReturn as l, type RawErrsMap as m, type CollectLineNumbers as n, type CollectLines as o, type RootAndTarget as p, type Context as q, type PoolOptions as r, type BuiltinEnvironment as s, type CSSModuleScopeStrategy as t, type EnvironmentOptions as u, type VitestRunMode as v, type TransformModePatterns as w, type TypecheckConfig as x, type ProjectConfig as y, type BrowserScript as z };