vitest 0.15.2 → 0.17.1

package/dist/node.d.ts

@@ -1,5 +1,87 @@
 import { ViteDevServer, TransformResult, CommonServerOptions, UserConfig as UserConfig$1, Plugin as Plugin$1 } from 'vite';
+import { Stats } from 'fs';
 
+interface UpdatePayload {
+  type: 'update'
+  updates: Update[]
+}
+
+interface Update {
+  type: 'js-update' | 'css-update'
+  path: string
+  acceptedPath: string
+  timestamp: number
+}
+
+interface PrunePayload {
+  type: 'prune'
+  paths: string[]
+}
+
+interface FullReloadPayload {
+  type: 'full-reload'
+  path?: string
+}
+
+interface ErrorPayload {
+  type: 'error'
+  err: {
+    [name: string]: any
+    message: string
+    stack: string
+    id?: string
+    frame?: string
+    plugin?: string
+    pluginCode?: string
+    loc?: {
+      file?: string
+      line: number
+      column: number
+    }
+  }
+}
+
+interface CustomEventMap {
+  'vite:beforeUpdate': UpdatePayload
+  'vite:beforePrune': PrunePayload
+  'vite:beforeFullReload': FullReloadPayload
+  'vite:error': ErrorPayload
+}
+
+type InferCustomEventPayload<T extends string> =
+  T extends keyof CustomEventMap ? CustomEventMap[T] : any
+
+type ModuleNamespace = Record<string, any> & {
+  [Symbol.toStringTag]: 'Module'
+}
+
+interface ViteHotContext {
+  readonly data: any
+
+  accept(): void
+  accept(cb: (mod: ModuleNamespace | undefined) => void): void
+  accept(dep: string, cb: (mod: ModuleNamespace | undefined) => void): void
+  accept(
+    deps: readonly string[],
+    cb: (mods: Array<ModuleNamespace | undefined>) => void
+  ): void
+
+  acceptExports(exportNames: string | readonly string[]): void
+  acceptExports(
+    exportNames: string | readonly string[],
+    cb: (mod: ModuleNamespace | undefined) => void
+  ): void
+
+  dispose(cb: (data: any) => void): void
+  decline(): void
+  invalidate(): void
+
+  on<T extends string>(
+    event: T,
+    cb: (payload: InferCustomEventPayload<T>) => void
+  ): void
+  send<T extends string>(event: T, data?: InferCustomEventPayload<T>): void
+}
 declare class ModuleCacheMap extends Map<string, ModuleCache> {
     normalizePath(fsPath: string): string;
     set(fsPath: string, mod: Partial<ModuleCache>): this;
@@ -61,8 +143,10 @@ interface FetchResult {
     externalize?: string;
     map?: RawSourceMap;
 }
+declare type HotContext = Omit<ViteHotContext, 'acceptDeps' | 'decline'>;
 declare type FetchFunction = (id: string) => Promise<FetchResult>;
 declare type ResolveIdFunction = (id: string, importer?: string) => Promise<ViteNodeResolveId | null>;
+declare type CreateHotContextFunction = (runner: ViteNodeRunner, url: string) => HotContext;
 interface ModuleCache {
     promise?: Promise<any>;
     exports?: any;
@@ -72,6 +156,7 @@ interface ViteNodeRunnerOptions {
     root: string;
     fetchModule: FetchFunction;
     resolveId?: ResolveIdFunction;
+    createHotContext?: CreateHotContextFunction;
     base?: string;
     moduleCache?: ModuleCacheMap;
     interopDefault?: boolean;
@@ -389,6 +474,18 @@ declare const ReportersMap: {
 };
 declare type BuiltinReporters = keyof typeof ReportersMap;
 
+interface TestSequencer {
+    /**
+     * Slicing tests into shards. Will be run before `sort`.
+     * Only run, if `shard` is defined.
+     */
+    shard(files: string[]): Awaitable<string[]>;
+    sort(files: string[]): Awaitable<string[]>;
+}
+interface TestSequencerContructor {
+    new (ctx: Vitest): TestSequencer;
+}
+
 declare type Awaitable<T> = T | PromiseLike<T>;
 declare type Arrayable<T> = T | Array<T>;
 declare type ArgumentsType<T> = T extends (...args: infer U) => any ? U : never;
@@ -572,6 +669,7 @@ interface TaskBase {
     name: string;
     mode: RunMode;
     concurrent?: boolean;
+    shuffle?: boolean;
     suite?: Suite;
     file?: File;
     result?: TaskResult;
@@ -604,11 +702,12 @@ interface Test<ExtraContext = {}> extends TaskBase {
     context: TestContext & ExtraContext;
 }
 declare type Task = Test | Suite | File;
-declare type HookListener<T extends any[], Return = void> = (...args: T) => Awaitable<Return | void>;
+declare type HookListener<T extends any[], Return = void> = (...args: T) => Awaitable<Return>;
+declare type HookCleanupCallback = (() => Awaitable<unknown>) | void;
 interface SuiteHooks {
-    beforeAll: HookListener<[Suite | File], () => Awaitable<void>>[];
+    beforeAll: HookListener<[Suite | File], HookCleanupCallback>[];
     afterAll: HookListener<[Suite | File]>[];
-    beforeEach: HookListener<[TestContext, Suite], () => Awaitable<void>>[];
+    beforeEach: HookListener<[TestContext, Suite], HookCleanupCallback>[];
     afterEach: HookListener<[TestContext, Suite]>[];
 }
 interface TestContext {
@@ -684,7 +783,7 @@ interface SnapshotSummary {
     updated: number;
 }
 
-declare type BuiltinEnvironment = 'node' | 'jsdom' | 'happy-dom';
+declare type BuiltinEnvironment = 'node' | 'jsdom' | 'happy-dom' | 'edge-runtime';
 declare type ApiConfig = Pick<CommonServerOptions, 'port' | 'strictPort' | 'host'>;
 
 interface EnvironmentOptions {
@@ -762,7 +861,7 @@ interface InlineConfig {
     /**
      * Running environment
      *
-     * Supports 'node', 'jsdom', 'happy-dom'
+     * Supports 'node', 'jsdom', 'happy-dom', 'edge-runtime'
      *
      * @default 'node'
      */
@@ -987,6 +1086,35 @@ interface InlineConfig {
      * @default 5
      */
     maxConcurrency?: number;
+    /**
+     * Options for configuring cache policy.
+     * @default { dir: 'node_modules/.vitest' }
+     */
+    cache?: false | {
+        dir?: string;
+    };
+    /**
+     * Options for configuring the order of running tests.
+     */
+    sequence?: {
+        /**
+         * Class that handles sorting and sharding algorithm.
+         * If you only need to change sorting, you can extend
+         * your custom sequencer from `BaseSequencer` from `vitest/node`.
+         * @default BaseSequencer
+         */
+        sequencer?: TestSequencerContructor;
+        /**
+         * Should tests run in random order.
+         * @default false
+         */
+        shuffle?: boolean;
+        /**
+         * Seed for the random number generator.
+         * @default Date.now()
+         */
+        seed?: number;
+    };
 }
 interface UserConfig extends InlineConfig {
     /**
@@ -1026,7 +1154,7 @@ interface UserConfig extends InlineConfig {
      */
     shard?: string;
 }
-interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters' | 'coverage' | 'testNamePattern' | 'related' | 'api' | 'reporters' | 'resolveSnapshotPath' | 'shard'> {
+interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters' | 'coverage' | 'testNamePattern' | 'related' | 'api' | 'reporters' | 'resolveSnapshotPath' | 'shard' | 'cache' | 'sequence'> {
     base?: string;
     config?: string;
     filters?: string[];
@@ -1041,6 +1169,14 @@ interface ResolvedConfig extends Omit<Required<UserConfig>, 'config' | 'filters'
         index: number;
         count: number;
     };
+    cache: {
+        dir: string;
+    } | false;
+    sequence: {
+        sequencer: TestSequencerContructor;
+        shuffle?: boolean;
+        seed?: number;
+    };
 }
 
 declare type VitestInlineConfig = InlineConfig;
@@ -1321,11 +1457,42 @@ interface WorkerPool {
     close: () => Promise<void>;
 }
 
+interface SuiteResultCache {
+    failed: boolean;
+    duration: number;
+}
+declare class ResultsCache {
+    private cache;
+    private cachePath;
+    private version;
+    private root;
+    setConfig(root: string, config: ResolvedConfig['cache']): void;
+    getResults(fsPath: string): SuiteResultCache | undefined;
+    readFromCache(): Promise<void>;
+    updateResults(files: File[]): void;
+    removeFromCache(filepath: string): void;
+    writeToCache(): Promise<void>;
+}
+
+declare type FileStatsCache = Pick<Stats, 'size'>;
+declare class FilesStatsCache {
+    cache: Map<string, FileStatsCache>;
+    getStats(fsPath: string): FileStatsCache | undefined;
+    updateStats(fsPath: string): Promise<void>;
+    removeStats(fsPath: string): void;
+}
+
 declare class StateManager {
     filesMap: Map<string, File>;
     idMap: Map<string, Task>;
     taskFileMap: WeakMap<Task, File>;
     errorsSet: Set<unknown>;
+    results: ResultsCache;
+    stats: FilesStatsCache;
+    getFileTestResults(id: string): SuiteResultCache | undefined;
+    getFileStats(id: string): {
+        size: number;
+    } | undefined;
     catchError(err: unknown, type: string): void;
     clearErrors(): void;
     getUnhandledErrors(): unknown[];
@@ -1368,7 +1535,7 @@ declare class Vitest {
     start(filters?: string[]): Promise<void>;
     private getTestDependencies;
     filterTestsBySource(tests: string[]): Promise<string[]>;
-    runFiles(files: string[]): Promise<void>;
+    runFiles(paths: string[]): Promise<void>;
     rerunFiles(files?: string[], trigger?: string): Promise<void>;
     changeNamePattern(pattern: string, files?: string[], trigger?: string): Promise<void>;
     rerunFailed(): Promise<void>;
@@ -1406,7 +1573,6 @@ interface CliOptions extends UserConfig {
 }
 declare function startVitest(cliFilters: string[], options: CliOptions, viteOverrides?: UserConfig$1): Promise<boolean>;
 
-declare type Callback = (...args: any[]) => unknown;
 interface ViteRunnerRequest {
     (dep: string): any;
     callstack: string[];
@@ -1414,15 +1580,13 @@ interface ViteRunnerRequest {
 declare class VitestMocker {
     options: ExecuteOptions;
     private moduleCache;
+    private request;
     private static pendingIds;
     private static spyModule?;
-    private request;
-    private root;
-    private callbacks;
-    constructor(options: ExecuteOptions, moduleCache: ModuleCacheMap, request?: ViteRunnerRequest);
-    get mockMap(): MockMap;
-    on(event: string, cb: Callback): void;
-    private emit;
+    constructor(options: ExecuteOptions, moduleCache: ModuleCacheMap, request: ViteRunnerRequest);
+    private get root();
+    private get base();
+    private get mockMap();
     getSuiteFilepath(): string;
     getMocks(): {
         [x: string]: string | (() => unknown) | null;
@@ -1431,7 +1595,6 @@ declare class VitestMocker {
     private resolveMocks;
     private callFunctionMock;
     getDependencyMock(dep: string): string | (() => unknown) | null;
-    resolveDependency(dep: string): string;
     normalizePath(path: string): string;
     getFsPath(path: string, external: string | null): string;
     resolveMockPath(mockPath: string, external: string | null): string | null;
@@ -1444,7 +1607,6 @@ declare class VitestMocker {
     requestWithMock(dep: string): Promise<any>;
     queueMock(id: string, importer: string, factory?: () => unknown): void;
     queueUnmock(id: string, importer: string): void;
-    withRequest(request: ViteRunnerRequest): VitestMocker;
 }
 
 interface ExecuteOptions extends ViteNodeRunnerOptions {
@@ -1452,8 +1614,6 @@ interface ExecuteOptions extends ViteNodeRunnerOptions {
 }
 declare class VitestRunner extends ViteNodeRunner {
     options: ExecuteOptions;
-    mocker: VitestMocker;
-    entries: Set<string>;
     constructor(options: ExecuteOptions);
     prepareContext(context: Record<string, any>): Record<string, any> & {
         __vite_ssr_import__: (dep: string) => Promise<any>;
@@ -1462,4 +1622,11 @@ declare class VitestRunner extends ViteNodeRunner {
     };
 }
 
-export { ExecuteOptions, Vitest, VitestPlugin, VitestRunner, createVitest, startVitest };
+declare class BaseSequencer implements TestSequencer {
+    protected ctx: Vitest;
+    constructor(ctx: Vitest);
+    shard(files: string[]): Promise<string[]>;
+    sort(files: string[]): Promise<string[]>;
+}
+
+export { BaseSequencer, ExecuteOptions, TestSequencer, TestSequencerContructor, Vitest, VitestPlugin, VitestRunner, createVitest, startVitest };

package/dist/node.mjs

@@ -1,33 +1,33 @@
-export { V as VitestPlugin, c as createVitest, s as startVitest } from './chunk-vite-node-externalize.0ec89ad1.mjs';
-export { V as VitestRunner } from './chunk-runtime-mocker.d3ca0a4e.mjs';
-import './chunk-utils-global.79a8b1cc.mjs';
-import 'tty';
+export { B as BaseSequencer, V as VitestPlugin, c as createVitest, s as startVitest } from './chunk-vite-node-externalize.0fc8ed68.mjs';
+export { V as VitestRunner } from './chunk-runtime-mocker.34b9d585.mjs';
+import './chunk-env-node.aa51c4cc.mjs';
 import 'local-pkg';
+import 'fs';
+import 'module';
+import 'url';
+import './chunk-utils-global.4828c2e2.mjs';
+import 'tty';
 import 'path';
 import 'vite';
-import 'url';
 import 'process';
-import 'fs';
-import './chunk-defaults.dc6dc23d.mjs';
-import 'module';
-import './chunk-constants.7b9cfc82.mjs';
+import './chunk-constants.27550afb.mjs';
 import 'readline';
 import 'os';
 import 'util';
 import 'stream';
 import 'events';
 import './vendor-_commonjsHelpers.4da45ef5.mjs';
-import './chunk-vite-node-utils.1bbdb2c1.mjs';
+import './chunk-vite-node-utils.0f776286.mjs';
 import 'vm';
 import 'assert';
 import 'debug';
 import 'worker_threads';
-import 'crypto';
 import 'tinypool';
 import 'perf_hooks';
-import './chunk-utils-source-map.2556cba8.mjs';
-import './vendor-index.e5dc6622.mjs';
+import './chunk-utils-source-map.a9047343.mjs';
+import './vendor-index.a2a385d8.mjs';
 import 'child_process';
 import 'buffer';
+import 'crypto';
 import './chunk-magic-string.efe26975.mjs';
 import './vendor-index.98e769c1.mjs';