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

package/dist/chunks/{reporters.d.DGm4k1Wx.d.ts → reporters.d.Bt4IGtsa.d.ts}

@@ -1,13 +1,13 @@
 import { Task, TaskMeta, Suite, File, TaskResultPack, SequenceSetupFiles, SequenceHooks, CancelReason } from '@vitest/runner';
-import { b as Awaitable, U as UserConsoleLog, c as Arrayable$1, A as AfterSuiteRunMeta, L as LabelColor, f as EnvironmentOptions, P as ProvidedContext } from './environment.d.D8YDy2v5.js';
+import { b as Awaitable, U as UserConsoleLog, c as Arrayable$1, A as AfterSuiteRunMeta, L as LabelColor, f as EnvironmentOptions, P as ProvidedContext } from './environment.d.cL3nLXbE.js';
 import { ParsedStack, TestError, SerializedError, ErrorWithDiff, Arrayable, Awaitable as Awaitable$1 } from '@vitest/utils';
 import { Writable } from 'node:stream';
 import { TransformResult as TransformResult$1, UserConfig as UserConfig$1, DepOptimizationConfig, ServerOptions, ConfigEnv, AliasOptions, ViteDevServer, ModuleNode } from 'vite';
 import { Console } from 'node:console';
 import { MockedModule } from '@vitest/mocker';
 import { StackTraceParserOptions } from '@vitest/utils/source-map';
-import { T as TestExecutionMethod } from './worker.d.CoCI7hzP.js';
-import { a as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.UqE-KR0o.js';
+import { T as TestExecutionMethod } from './worker.d.BKbBp2ga.js';
+import { a as SerializedConfig, F as FakeTimerInstallOpts } from './config.d.D2ROskhv.js';
 import { PrettyFormatOptions } from '@vitest/pretty-format';
 import { SnapshotSummary, SnapshotStateOptions } from '@vitest/snapshot';
 import { SerializedDiffOptions } from '@vitest/utils/diff';
@@ -714,7 +714,6 @@ declare class DefaultReporter extends BaseReporter {
 	onHookStart(hook: ReportedHookContext): void;
 	onHookEnd(hook: ReportedHookContext): void;
 	onInit(ctx: Vitest): void;
-	onPathsCollected(paths?: string[]): void;
 	onTestRunEnd(): void;
 }
 
@@ -826,6 +825,9 @@ declare class FileCoverage implements FileCoverageData {
     b: { [key: string]: number[] };
 }
 
+// for compatibility reasons, the reporter produces a JSON similar to the one produced by the Jest JSON reporter
+// the following types are extracted from the Jest repository (and simplified)
+// the commented-out fields are the missing ones
 type Status = "passed" | "failed" | "skipped" | "pending" | "todo" | "disabled";
 type Milliseconds = number;
 interface Callsite {
@@ -946,8 +948,13 @@ declare class DotReporter extends BaseReporter {
 	private createSummary;
 }
 
+interface GithubActionsReporterOptions {
+	onWritePath?: (path: string) => string;
+}
 declare class GithubActionsReporter implements Reporter {
 	ctx: Vitest;
+	options: GithubActionsReporterOptions;
+	constructor(options?: GithubActionsReporterOptions);
 	onInit(ctx: Vitest): void;
 	onFinished(files?: File[], errors?: unknown[]): void;
 }
@@ -1425,6 +1432,7 @@ interface Thresholds {
 }
 
 type BuiltinEnvironment = "node" | "jsdom" | "happy-dom" | "edge-runtime";
+// Record is used, so user can get intellisense for builtin environments, but still allow custom environments
 type VitestEnvironment = BuiltinEnvironment | (string & Record<never, never>);
 
 type CSSModuleScopeStrategy = "stable" | "scoped" | "non-scoped";
@@ -1444,6 +1452,15 @@ interface SequenceOptions {
 	*/
 	sequencer?: TestSequencerConstructor;
 	/**
+	* Controls the order in which this project runs its tests when using multiple [projects](/guide/projects).
+	*
+	* - Projects with the same group order number will run together, and groups are run from lowest to highest.
+	* - If you don’t set this option, all projects run in parallel.
+	* - If several projects use the same group order, they will run at the same time.
+	* @default 0
+	*/
+	groupOrder?: number;
+	/**
 	* Should files and tests run in random order.
 	* @default false
 	*/
@@ -2164,6 +2181,11 @@ interface TypecheckConfig {
 	* Path to tsconfig, relative to the project root.
 	*/
 	tsconfig?: string;
+	/**
+	* Minimum time in milliseconds it takes to spawn the typechecker.
+	* @default 10_000
+	*/
+	spawnTimeout?: number;
 }
 interface UserConfig extends InlineConfig {
 	/**
@@ -2277,6 +2299,7 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, "project" | "config"
 		shuffle?: boolean
 		concurrent?: boolean
 		seed: number
+		groupOrder: number
 	};
 	typecheck: Omit<TypecheckConfig, "enabled"> & {
 		enabled: boolean
@@ -2341,6 +2364,7 @@ interface BrowserProvider {
 	openPage: (sessionId: string, url: string, beforeNavigate?: () => Promise<void>) => Promise<void>;
 	getCDPSession?: (sessionId: string) => Promise<CDPSession>;
 	close: () => Awaitable$1<void>;
+	// eslint-disable-next-line ts/method-signature-style -- we want to allow extended options
 	initialize(ctx: TestProject, options: BrowserProviderInitializationOptions): Awaitable$1<void>;
 }
 interface BrowserProviderModule {
@@ -2598,6 +2622,14 @@ declare class TestProject {
 	private _provided;
 	constructor(path: string | number, vitest: Vitest, options?: InitializeProjectOptions | undefined);
 	/**
+	* The unique hash of this project. This value is consistent between the reruns.
+	*
+	* It is based on the root of the project (not consistent between OS) and its name.
+	*/
+	get hash(): string;
+	// "provide" is a property, not a method to keep the context when destructed in the global setup,
+	// making it a method would be a breaking change, and can be done in Vitest 3 at minimum
+	/**
 	* Provide a value to the test context. This value will be available to all tests with `inject`.
 	*/
 	provide: <T extends keyof ProvidedContext & string>(key: T, value: ProvidedContext[T]) => void;
@@ -2648,6 +2680,7 @@ declare class TestProject {
 	teardownGlobalSetup(): Promise<void>;
 	/** @deprecated use `vitest.logger` instead */
 	get logger(): Logger;
+	// it's possible that file path was imported with different queries (?raw, ?url, etc)
 	/** @deprecated use `.vite` or `.browser.vite` directly */
 	getModulesByFilepath(file: string): Set<ModuleNode>;
 	/** @deprecated use `.vite` or `.browser.vite` directly */
@@ -2698,6 +2731,7 @@ declare class TestProject {
 	getName(): string;
 	/** @deprecated internal */
 	setServer(options: UserConfig, server: ViteDevServer): Promise<void>;
+	private _setHash;
 	private _serializeOverriddenConfig;
 	private clearTmpDir;
 	/** @deprecated */
@@ -2862,7 +2896,7 @@ declare class Vitest {
 	private _cache?;
 	private _snapshot?;
 	private _workspaceConfigPath?;
-	constructor(mode: VitestRunMode, options?: VitestOptions);
+	constructor(mode: VitestRunMode, cliOptions: UserConfig, options?: VitestOptions);
 	private _onRestartListeners;
 	private _onClose;
 	private _onSetServer;
@@ -2897,7 +2931,7 @@ declare class Vitest {
 	*/
 	get cache(): VitestCache;
 	/** @deprecated internal */
-	setServer(options: UserConfig, server: ViteDevServer, cliOptions: UserConfig): Promise<void>;
+	setServer(options: UserConfig, server: ViteDevServer): Promise<void>;
 	/**
 	* Inject new test projects into the workspace.
 	* @param config Glob, config path or a custom config options.
@@ -3029,6 +3063,7 @@ 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.

package/dist/chunks/{rpc.D9_013TY.js → rpc.BKExFSRG.js}

@@ -1,6 +1,6 @@
 import { getSafeTimers } from '@vitest/utils';
 import { c as createBirpc } from './index.CJ0plNrh.js';
-import { g as getWorkerState } from './utils.CgTj3MsC.js';
+import { g as getWorkerState } from './utils.BlI4TC7Y.js';
 
 const { get } = Reflect;
 function withSafeTimers(fn) {
@@ -56,6 +56,7 @@ function createRuntimeRpc(options) {
 			if (functionName === "fetch" || functionName === "transform" || functionName === "resolveId") {
 				message += ` with "${JSON.stringify(args)}"`;
 			}
+			// JSON.stringify cannot serialize Error instances
 			if (functionName === "onUnhandledError") {
 				message += ` with "${args[0]?.message || args[0]}"`;
 			}

package/dist/chunks/{runBaseTests.CguliJB5.js → runBaseTests.B_M1TTsK.js}

@@ -1,9 +1,9 @@
 import { performance } from 'node:perf_hooks';
 import { startTests, collectTests } from '@vitest/runner';
-import { a as resolveSnapshotEnvironment, s as setupChaiConfig, r as resolveTestRunner } from './index.DbWBPwtH.js';
-import { c as setupCommonEnv, s as startCoverageInsideWorker, a as stopCoverageInsideWorker } from './setup-common.BP6KrF_Z.js';
-import { a as globalExpect, v as vi } from './vi.BFR5YIgu.js';
-import { c as closeInspector } from './inspector.DbDkSkFn.js';
+import { a as resolveSnapshotEnvironment, s as setupChaiConfig, r as resolveTestRunner } from './index.CbT4iuwc.js';
+import { c as setupCommonEnv, s as startCoverageInsideWorker, a as stopCoverageInsideWorker } from './setup-common.CF-O-dZX.js';
+import { a as globalExpect, v as vi } from './vi.pkoYCV6A.js';
+import { c as closeInspector } from './inspector.BFsh5KO0.js';
 import { createRequire } from 'node:module';
 import timers from 'node:timers';
 import timersPromises from 'node:timers/promises';
@@ -11,27 +11,27 @@ import util from 'node:util';
 import { getSafeTimers } from '@vitest/utils';
 import { KNOWN_ASSET_TYPES } from 'vite-node/constants';
 import { installSourcemapsSupport } from 'vite-node/source-map';
-import { V as VitestIndex } from './index.BPc7M5ni.js';
-import { g as getWorkerState, r as resetModules } from './utils.CgTj3MsC.js';
+import { V as VitestIndex } from './index.DNgLEKsQ.js';
+import { g as getWorkerState, r as resetModules } from './utils.BlI4TC7Y.js';
 import 'chai';
 import 'node:path';
 import '../path.js';
 import 'node:url';
-import './rpc.D9_013TY.js';
+import './rpc.BKExFSRG.js';
 import './index.CJ0plNrh.js';
 import './coverage.0iPg4Wrz.js';
 import '@vitest/snapshot';
-import './run-once.Dimr7O9f.js';
 import '@vitest/expect';
 import '@vitest/runner/utils';
 import './_commonjsHelpers.BFTU3MAI.js';
 import '@vitest/utils/error';
 import '@vitest/spy';
 import '@vitest/utils/source-map';
-import './date.CDOsz-HY.js';
-import './benchmark.BoF7jW0Q.js';
+import './date.ByMsSlOr.js';
+import './benchmark.Cf_PACH1.js';
 import 'expect-type';
 
+// this should only be used in Node
 let globalSetup = false;
 async function setupGlobalEnv(config, { environment }, executor) {
 	await setupCommonEnv(config);
@@ -49,10 +49,12 @@ async function setupGlobalEnv(config, { environment }, executor) {
 	globalSetup = true;
 	if (environment.transformMode === "web") {
 		const _require = createRequire(import.meta.url);
+		// always mock "required" `css` files, because we cannot process them
 		_require.extensions[".css"] = resolveCss;
 		_require.extensions[".scss"] = resolveCss;
 		_require.extensions[".sass"] = resolveCss;
 		_require.extensions[".less"] = resolveCss;
+		// since we are using Vite, we can assume how these will be resolved
 		KNOWN_ASSET_TYPES.forEach((type) => {
 			_require.extensions[`.${type}`] = resolveAsset;
 		});
@@ -60,6 +62,7 @@ async function setupGlobalEnv(config, { environment }, executor) {
 	} else {
 		process.env.SSR = "1";
 	}
+	// @ts-expect-error not typed global for patched timers
 	globalThis.__vitest_required__ = {
 		util,
 		timers,
@@ -77,22 +80,25 @@ function resolveAsset(mod, url) {
 	mod.exports = url;
 }
 async function setupConsoleLogSpy() {
-	const { createCustomConsole } = await import('./console.K1NMVOSc.js');
+	const { createCustomConsole } = await import('./console.Cwr-MFPV.js');
 	globalThis.console = createCustomConsole();
 }
 async function withEnv({ environment }, options, fn) {
+	// @ts-expect-error untyped global
 	globalThis.__vitest_environment__ = environment.name;
 	globalExpect.setState({ environment: environment.name });
 	const env = await environment.setup(globalThis, options);
 	try {
 		await fn();
 	} finally {
+		// Run possible setTimeouts, e.g. the onces used by ConsoleLogSpy
 		const { setTimeout } = getSafeTimers();
 		await new Promise((resolve) => setTimeout(resolve));
 		await env.teardown(globalThis);
 	}
 }
 
+// browser shouldn't call this!
 async function run(method, files, config, environment, executor) {
 	const workerState = getWorkerState();
 	const isIsolatedThreads = config.pool === "threads" && (config.poolOptions?.threads?.isolate ?? true);
@@ -123,7 +129,9 @@ async function run(method, files, config, environment, executor) {
 			} else {
 				await collectTests([file], runner);
 			}
+			// reset after tests, because user might call `vi.setConfig` in setupFile
 			vi.resetConfig();
+			// mocks should not affect different files
 			vi.restoreAllMocks();
 		}
 		await stopCoverageInsideWorker(config.coverage, executor, { isolate });

package/dist/chunks/{setup-common.BP6KrF_Z.js → setup-common.CF-O-dZX.js}

@@ -1,7 +1,6 @@
 import { r as resolveCoverageProviderModule } from './coverage.0iPg4Wrz.js';
 import { addSerializer } from '@vitest/snapshot';
 import { setSafeTimers } from '@vitest/utils';
-import { r as resetRunOnceCounter } from './run-once.Dimr7O9f.js';
 
 async function startCoverageInsideWorker(options, loader, runtimeOptions) {
 	const coverageModule = await resolveCoverageProviderModule(options, loader);
@@ -27,7 +26,6 @@ async function stopCoverageInsideWorker(options, loader, runtimeOptions) {
 
 let globalSetup = false;
 async function setupCommonEnv(config) {
-	resetRunOnceCounter();
 	setupDefines(config.defines);
 	setupEnv(config.env);
 	if (globalSetup) {
@@ -36,7 +34,7 @@ async function setupCommonEnv(config) {
 	globalSetup = true;
 	setSafeTimers();
 	if (config.globals) {
-		(await import('./globals.Cg4NtV4P.js')).registerApiGlobally();
+		(await import('./globals.CI21aWXF.js')).registerApiGlobally();
 	}
 }
 function setupDefines(defines) {
@@ -48,6 +46,7 @@ function setupEnv(env) {
 	if (typeof process === "undefined") {
 		return;
 	}
+	// same boolean-to-string assignment as VitestPlugin.configResolved
 	const { PROD, DEV,...restEnvs } = env;
 	process.env.PROD = PROD ? "1" : "";
 	process.env.DEV = DEV ? "1" : "";