@rstest/core 0.3.3 → 0.4.0

package/dist/worker.js

@@ -1,22 +1,18 @@
 /*! For license information please see worker.js.LICENSE.txt */
 import __rslib_shim_module__ from 'module';
 const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(import.meta.url);
-import node_process from "node:process";
-import * as __WEBPACK_EXTERNAL_MODULE_chai__ from "chai";
-import * as __WEBPACK_EXTERNAL_MODULE_node_assert_3e74d44e__ from "node:assert";
-import * as __WEBPACK_EXTERNAL_MODULE_node_console_8631dfae__ from "node:console";
 import * as __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__ from "node:fs";
-import * as __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__ from "node:fs/promises";
 import * as __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__ from "node:module";
 import * as __WEBPACK_EXTERNAL_MODULE_node_os_74b4b876__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE_node_tty_c64aab7e__ from "node:tty";
 import * as __WEBPACK_EXTERNAL_MODULE_node_util_1b29d436__ from "node:util";
 import * as __WEBPACK_EXTERNAL_MODULE_pathe__ from "pathe";
-import { pathToFileURL } from "node:url";
-import node_vm from "node:vm";
-import node_v8 from "node:v8";
-import { createBirpc } from "birpc";
+import * as __WEBPACK_EXTERNAL_MODULE_node_process_786449bf__ from "node:process";
+import * as __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__ from "node:url";
+import * as __WEBPACK_EXTERNAL_MODULE_node_vm_bd3d9cea__ from "node:vm";
+import * as __WEBPACK_EXTERNAL_MODULE_node_v8_d0df5498__ from "node:v8";
+import * as __WEBPACK_EXTERNAL_MODULE_birpc__ from "birpc";
 var __webpack_modules__ = {
     "../../node_modules/.pnpm/@jest+diff-sequences@30.0.1/node_modules/@jest/diff-sequences/build/index.js": function(module) {
         /*!
@@ -335,7 +331,7 @@ var __webpack_modules__ = {
             module.exports = __nested_webpack_exports__;
         })();
     },
-    "../../node_modules/.pnpm/@jest+get-type@30.0.1/node_modules/@jest/get-type/build/index.js": function(module) {
+    "../../node_modules/.pnpm/@jest+get-type@30.1.0/node_modules/@jest/get-type/build/index.js": function(module) {
         /*!
  * /**
  *  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -2880,7 +2876,7 @@ var __webpack_modules__ = {
             return -1 !== position && (-1 === terminatorPosition || position < terminatorPosition);
         };
     },
-    "../../node_modules/.pnpm/jest-diff@30.0.5/node_modules/jest-diff/build/index.js": function(module, __unused_webpack_exports, __webpack_require__) {
+    "../../node_modules/.pnpm/jest-diff@30.1.2/node_modules/jest-diff/build/index.js": function(module, __unused_webpack_exports, __webpack_require__) {
         /*!
  * /**
  *  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -3744,7 +3740,7 @@ var __webpack_modules__ = {
                     }
                 });
                 var _chalk = _interopRequireDefault(__webpack_require__("../../node_modules/.pnpm/chalk@4.1.2/node_modules/chalk/source/index.js"));
-                var _getType = __webpack_require__("../../node_modules/.pnpm/@jest+get-type@30.0.1/node_modules/@jest/get-type/build/index.js");
+                var _getType = __webpack_require__("../../node_modules/.pnpm/@jest+get-type@30.1.0/node_modules/@jest/get-type/build/index.js");
                 var _prettyFormat = __webpack_require__("../../node_modules/.pnpm/pretty-format@30.0.5/node_modules/pretty-format/build/index.js");
                 var _cleanupSemantic = __nested_webpack_require_48295__("./src/cleanupSemantic.ts");
                 var _constants = __nested_webpack_require_48295__("./src/constants.ts");
@@ -4976,7 +4972,7 @@ var __webpack_modules__ = {
         });
         var external_node_module_ = __webpack_require__("node:module");
         var external_node_util_ = __webpack_require__("node:util");
-        var build = __webpack_require__("../../node_modules/.pnpm/jest-diff@30.0.5/node_modules/jest-diff/build/index.js");
+        var build = __webpack_require__("../../node_modules/.pnpm/jest-diff@30.1.2/node_modules/jest-diff/build/index.js");
         build.DIFF_DELETE;
         build.DIFF_EQUAL;
         build.DIFF_INSERT;
@@ -5066,10 +5062,8 @@ var __webpack_modules__ = {
     "./src/utils/constants.ts": function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
             TE: ()=>globalApis,
-            q_: ()=>ROOT_SUITE_NAME,
-            vO: ()=>TEST_DELIMITER
+            q_: ()=>ROOT_SUITE_NAME
         });
-        const TEST_DELIMITER = '>';
         const ROOT_SUITE_NAME = 'Rstest:_internal_root_suite';
         const globalApis = [
             'test',
@@ -5099,7 +5093,7 @@ var __webpack_modules__ = {
         __webpack_require__("pathe");
         var picocolors__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js");
         var picocolors__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/ __webpack_require__.n(picocolors__WEBPACK_IMPORTED_MODULE_2__);
-        var _constants__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("./src/utils/constants.ts");
+        __webpack_require__("./src/utils/constants.ts");
         const isObject = (obj)=>'[object Object]' === Object.prototype.toString.call(obj);
         const castArray = (arr)=>{
             if (void 0 === arr) return [];
@@ -5126,7 +5120,7 @@ var __webpack_modules__ = {
             return time;
         };
         const getTaskNames = (test)=>(test.parentNames || []).concat(test.name).filter(Boolean);
-        const getTaskNameWithPrefix = (test, delimiter = _constants__WEBPACK_IMPORTED_MODULE_1__.vO)=>getTaskNames(test).join(` ${delimiter} `);
+        const getTaskNameWithPrefix = (test, delimiter = ">")=>getTaskNames(test).join(` ${delimiter} `);
         const REGEXP_FLAG_PREFIX = 'RSTEST_REGEXP:';
         const unwrapRegex = (value)=>{
             if (value.startsWith(REGEXP_FLAG_PREFIX)) {
@@ -5153,13 +5147,13 @@ var __webpack_modules__ = {
         });
         var external_node_os_ = __webpack_require__("node:os");
         var external_node_tty_ = __webpack_require__("node:tty");
-        function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : node_process.argv) {
+        function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : __WEBPACK_EXTERNAL_MODULE_node_process_786449bf__["default"].argv) {
             const prefix = flag.startsWith('-') ? '' : 1 === flag.length ? '-' : '--';
             const position = argv.indexOf(prefix + flag);
             const terminatorPosition = argv.indexOf('--');
             return -1 !== position && (-1 === terminatorPosition || position < terminatorPosition);
         }
-        const { env } = node_process;
+        const { env } = __WEBPACK_EXTERNAL_MODULE_node_process_786449bf__["default"];
         let flagForceColor;
         if (hasFlag('no-color') || hasFlag('no-colors') || hasFlag('color=false') || hasFlag('color=never')) flagForceColor = 0;
         else if (hasFlag('color') || hasFlag('colors') || hasFlag('color=true') || hasFlag('color=always')) flagForceColor = 1;
@@ -5199,7 +5193,7 @@ var __webpack_modules__ = {
             if (haveStream && !streamIsTTY && void 0 === forceColor) return 0;
             const min = forceColor || 0;
             if ('dumb' === env.TERM) return min;
-            if ('win32' === node_process.platform) {
+            if ('win32' === __WEBPACK_EXTERNAL_MODULE_node_process_786449bf__["default"].platform) {
                 const osRelease = external_node_os_["default"].release().split('.');
                 if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) return Number(osRelease[2]) >= 14931 ? 3 : 2;
                 return 1;
@@ -5431,21 +5425,9 @@ var __webpack_modules__ = {
     "timers/promises": function(module) {
         module.exports = require("timers/promises");
     },
-    chai: function(module) {
-        module.exports = __WEBPACK_EXTERNAL_MODULE_chai__;
-    },
-    "node:assert": function(module) {
-        module.exports = __WEBPACK_EXTERNAL_MODULE_node_assert_3e74d44e__;
-    },
-    "node:console": function(module) {
-        module.exports = __WEBPACK_EXTERNAL_MODULE_node_console_8631dfae__;
-    },
     "node:fs": function(module) {
         module.exports = __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__;
     },
-    "node:fs/promises": function(module) {
-        module.exports = __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__;
-    },
     "node:module": function(module) {
         module.exports = __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__;
     },
@@ -5531,7 +5513,7 @@ __webpack_require__.m = __webpack_modules__;
         }, []));
 })();
 (()=>{
-    __webpack_require__.u = (chunkId)=>"" + chunkId + ".js";
+    __webpack_require__.u = (chunkId)=>"0~" + chunkId + ".js";
 })();
 (()=>{
     __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
@@ -5591,10 +5573,41 @@ __webpack_require__.m = __webpack_modules__;
     };
 })();
 __webpack_require__("./src/runtime/worker/setup.ts");
+var external_node_module_ = __webpack_require__("node:module");
+const CoverageProviderMap = {
+    istanbul: '@rstest/coverage-istanbul'
+};
+const loadCoverageProvider = async (options, root)=>{
+    const rootPath = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(root).toString();
+    const moduleName = CoverageProviderMap[options.provider || 'istanbul'];
+    if (!moduleName) throw new Error(`Unknown coverage provider: ${options.provider}`);
+    try {
+        const require = (0, external_node_module_.createRequire)(rootPath);
+        const modulePath = require.resolve(moduleName, {
+            paths: [
+                rootPath
+            ]
+        });
+        const { pluginCoverage, CoverageProvider } = await import((0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(modulePath).toString());
+        return {
+            pluginCoverage,
+            CoverageProvider
+        };
+    } catch (error) {
+        throw new Error(`Failed to load coverage provider module: ${moduleName} in ${root}. Make sure it is installed.\nOriginal error: ${error.message}`);
+    }
+};
+async function createCoverageProvider(options, root) {
+    if (!options.enabled) return null;
+    if (!options.provider || CoverageProviderMap[options.provider]) {
+        const { CoverageProvider } = await loadCoverageProvider(options, root);
+        return new CoverageProvider(options);
+    }
+    throw new Error(`Unknown coverage provider: ${options.provider}`);
+}
 var constants = __webpack_require__("./src/utils/constants.ts");
 var helper = __webpack_require__("./src/utils/helper.ts");
 var util = __webpack_require__("./src/runtime/util.ts");
-var external_node_module_ = __webpack_require__("node:module");
 var external_node_path_ = __webpack_require__("node:path");
 var external_pathe_ = __webpack_require__("pathe");
 var logger = __webpack_require__("./src/utils/logger.ts");
@@ -5673,7 +5686,7 @@ const createRequire = (filename, distPath, rstestContext, assetFiles, interopDef
     return require;
 };
 const defineRstestDynamicImport = ({ testPath, interopDefault, returnModule = false })=>async (specifier, importAttributes)=>{
-        const resolvedPath = (0, external_node_path_.isAbsolute)(specifier) ? pathToFileURL(specifier) : import.meta.resolve(specifier, pathToFileURL(testPath));
+        const resolvedPath = (0, external_node_path_.isAbsolute)(specifier) ? (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(specifier) : import.meta.resolve(specifier, (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(testPath));
         const modulePath = 'string' == typeof resolvedPath ? resolvedPath : resolvedPath.pathname;
         if (importAttributes?.with?.rstest) delete importAttributes.with.rstest;
         const importedModule = await import(modulePath, importAttributes);
@@ -5731,7 +5744,7 @@ const loadModule = ({ codeContent, distPath, testPath, rstestContext, assetFiles
     };
     const codeDefinition = `'use strict';(${Object.keys(context).join(',')})=>{`;
     const code = `${codeDefinition}${codeContent}\n}`;
-    const fn = node_vm.runInThisContext(code, {
+    const fn = __WEBPACK_EXTERNAL_MODULE_node_vm_bd3d9cea__["default"].runInThisContext(code, {
         filename: distPath,
         lineOffset: 0,
         columnOffset: -codeDefinition.length,
@@ -5762,7 +5775,7 @@ const processSend = process.send.bind(process);
 const processOn = process.on.bind(process);
 const processOff = process.off.bind(process);
 const dispose = [];
-function createForksRpcOptions(nodeV8 = node_v8) {
+function createForksRpcOptions(nodeV8 = __WEBPACK_EXTERNAL_MODULE_node_v8_d0df5498__["default"]) {
     return {
         serialize: nodeV8.serialize,
         deserialize: (v)=>nodeV8.deserialize(Buffer.from(v)),
@@ -5780,7 +5793,7 @@ function createForksRpcOptions(nodeV8 = node_v8) {
     };
 }
 function createRuntimeRpc(options) {
-    const rpc = createBirpc({}, options);
+    const rpc = (0, __WEBPACK_EXTERNAL_MODULE_birpc__.createBirpc)({}, options);
     return {
         rpc
     };
@@ -5826,8 +5839,8 @@ class RstestSnapshotEnvironment extends NodeSnapshotEnvironment {
         return `// Rstest Snapshot v${this.getVersion()}`;
     }
 }
-const getGlobalApi = (api)=>constants.TE.reduce((apis, key)=>{
-        apis[key] = api[key];
+const registerGlobalApi = (api)=>constants.TE.reduce((apis, key)=>{
+        globalThis[key] = api[key];
         return apis;
     }, {});
 const listeners = [];
@@ -5839,7 +5852,7 @@ const preparePool = async ({ entryInfo: { distPath, testPath }, sourceMaps, upda
     const { rpc } = createRuntimeRpc(createForksRpcOptions());
     const { runtimeConfig: { globals, printConsoleTrace, disableConsoleIntercept, testEnvironment } } = context;
     if (!disableConsoleIntercept) {
-        const { createCustomConsole } = await __webpack_require__.e("607").then(__webpack_require__.bind(__webpack_require__, "./src/runtime/worker/console.ts"));
+        const { createCustomConsole } = await __webpack_require__.e("493").then(__webpack_require__.bind(__webpack_require__, "./src/runtime/worker/console.ts"));
         global.console = createCustomConsole({
             rpc,
             testPath,
@@ -5916,11 +5929,11 @@ const preparePool = async ({ entryInfo: { distPath, testPath }, sourceMaps, upda
         default:
             throw new Error(`Unknown test environment: ${testEnvironment}`);
     }
+    if (globals) registerGlobalApi(api);
     const rstestContext = {
         global,
         console: global.console,
-        Error,
-        ...globals ? getGlobalApi(api) : {}
+        Error
     };
     rstestContext.global['@rstest/core'] = api;
     return {
@@ -6018,6 +6031,8 @@ const runInPool = async (options)=>{
     }
     try {
         const { rstestContext, runner, rpc, api, cleanup, unhandledErrors, interopDefault } = await preparePool(options);
+        const coverageProvider = await createCoverageProvider(options.context.runtimeConfig.coverage || {}, options.context.rootPath);
+        if (coverageProvider) coverageProvider.init();
         cleanups.push(cleanup);
         await loadFiles({
             rstestContext,
@@ -6033,6 +6048,10 @@ const runInPool = async (options)=>{
                 await rpc.onTestFileStart(test);
             },
             onTestFileResult: async (test)=>{
+                if (coverageProvider) {
+                    const coverageMap = coverageProvider.collect();
+                    if (coverageMap) test.coverage = coverageMap.toJSON();
+                }
                 await rpc.onTestFileResult(test);
             },
             onTestCaseResult: async (result)=>{

package/dist-types/index.d.ts

@@ -1,5 +1,8 @@
 import type { assert as assert_2 } from 'chai';
+import type { CoverageMap } from 'istanbul-lib-coverage';
+import type { ReportOptions } from 'istanbul-reports';
 import type { RsbuildConfig } from '@rsbuild/core';
+import { RsbuildPlugin } from '@rsbuild/core';
 
 /**
  * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
@@ -328,6 +331,80 @@ declare class CounterMap<K> extends DefaultMap<K, number> {
     	total(): number;
 }
 
+export declare type CoverageOptions = {
+    /**
+     * Enable coverage collection.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * A list of glob patterns that should be excluded from coverage collection.
+     *
+     * This option accepts an array of wax(https://crates.io/crates/wax)-compatible glob patterns
+     *
+     * @default ['**\/node_modules/**',
+     *           '**\/dist/**',
+     *           '**\/test/**',
+     *           '**\/__tests__/**',
+     *           '**\/*.{test,spec}.?(c|m)[jt]s?(x)',
+     *           '**\/__mocks__/**'
+     * ]
+     */
+    exclude?: string[];
+    /**
+     * The provider to use for coverage collection.
+     * @default 'istanbul'
+     */
+    provider?: 'istanbul';
+    /**
+     * The reporters to use for coverage collection.
+     * @default ['text', 'html', 'clover', 'json']
+     */
+    reporters?: (keyof ReportOptions | ReportWithOptions)[];
+    /**
+     * The directory to store coverage reports.
+     * @default './coverage'
+     */
+    reportsDirectory?: string;
+    /**
+     * Whether to clean the coverage directory before running tests.
+     * @default true
+     */
+    clean?: boolean;
+    /**
+     * Coverage thresholds
+     *
+     * @default undefined
+     */
+    thresholds?: CoverageThresholds;
+};
+
+export declare class CoverageProvider {
+    constructor(options: CoverageOptions);
+    /**
+     * Initialize coverage collection
+     */
+    init(): void;
+    /**
+     * Collect coverage data from global coverage object
+     */
+    collect(): CoverageMap | null;
+    /**
+     * Create a new coverage map
+     */
+    createCoverageMap(): CoverageMap;
+    /**
+     * Generate coverage reports
+     */
+    generateReports(coverageMap: CoverageMap, options: CoverageOptions): Promise<void>;
+    /**
+     * Clean up coverage data
+     */
+    cleanup(): void;
+}
+
+declare type CoverageThresholds = Thresholds;
+
 declare interface CustomMatcher {
     	/**
      	* Checks that a value satisfies a custom matcher function.
@@ -1589,18 +1666,23 @@ declare interface NewPlugin {
     	test: Test;
 }
 
-declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects'>> & {
+declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage'>> & {
     [key in OptionalKeys]?: RstestConfig[key];
 } & {
     pool: RstestPoolOptions;
+    coverage: NormalizedCoverageOptions;
+};
+
+export declare type NormalizedCoverageOptions = Required<Omit<CoverageOptions, 'thresholds'>> & {
+    thresholds?: CoverageThresholds;
 };
 
 declare type NormalizedProcedure<T extends Procedure> = (...args: Parameters<T>) => ReturnType<T>;
 
 declare type NormalizedProcedure_2<T extends Procedure_2> = (...args: Parameters<T>) => ReturnType<T>;
 
-declare type NormalizedProjectConfig = Required<Omit<RstestConfig, OptionalKeys | 'projects' | 'reporters' | 'pool'>> & {
-    [key in OptionalKeys]?: RstestConfig[key];
+declare type NormalizedProjectConfig = Required<Omit<NormalizedConfig, OptionalKeys | 'projects' | 'reporters' | 'pool'>> & {
+    [key in OptionalKeys]?: NormalizedConfig[key];
 };
 
 declare interface OldPlugin {
@@ -1676,11 +1758,12 @@ declare type Procedure = (...args: any[]) => any;
 
 declare type Procedure_2 = (...args: any[]) => any;
 
-export declare type ProjectConfig = Omit<RstestConfig, 'projects' | 'reporters' | 'pool' | 'isolate'>;
+export declare type ProjectConfig = Omit<RstestConfig, 'projects' | 'reporters' | 'pool' | 'isolate' | 'coverage'>;
 
 declare type ProjectContext = {
     name: string;
     environmentName: string;
+    /** The root path of current project. */
     rootPath: string;
     configFilePath?: string;
     normalizedConfig: NormalizedProjectConfig;
@@ -1754,6 +1837,8 @@ declare const reportersMap: {
 
 declare type ReporterWithOptions<Name extends BuiltInReporterNames = BuiltInReporterNames> = Name extends keyof BuiltinReporterOptions ? [Name, Partial<BuiltinReporterOptions[Name]>] : [Name, Record<string, unknown>];
 
+declare type ReportWithOptions<Name extends keyof ReportOptions = keyof ReportOptions> = Name extends keyof ReportOptions ? [Name, Partial<ReportOptions[Name]>] : [Name, Record<string, unknown>];
+
 declare type Ro<T> = T extends Array<infer V> ? V[] | Readonly<V[]> | RoArray<V> | Readonly<RoArray<V>> : T extends object ? T | Readonly<T> | RoObject<T> | Readonly<RoObject<T>> : T;
 
 declare type RoArray<T> = Ro<T>[];
@@ -1764,6 +1849,8 @@ declare type RoObject<T> = {
 
 export declare const rs: RstestUtilities;
 
+export { RsbuildPlugin }
+
 declare type Rstest = RunnerAPI & {
     expect: RstestExpect;
     assert: typeof assert_2;
@@ -1923,6 +2010,10 @@ export declare interface RstestConfig {
      * Custom handler for console log in tests
      */
     onConsoleLog?: (content: string) => boolean | void;
+    /**
+     * Coverage options
+     */
+    coverage?: CoverageOptions;
     plugins?: RsbuildConfig['plugins'];
     source?: Pick<NonNullable<RsbuildConfig['source']>, 'define' | 'tsconfigPath' | 'decorators' | 'include' | 'exclude'>;
     performance?: Pick<NonNullable<RsbuildConfig['performance']>, 'bundleAnalyze'>;
@@ -1941,7 +2032,7 @@ export declare type RstestConfigSyncFn = () => RstestConfig;
 declare type RstestContext = {
     /** The Rstest core version. */
     version: string;
-    /** The root path of current project. */
+    /** The root path of rstest. */
     rootPath: string;
     /** The original Rstest config passed from the createRstest method. */
     originalConfig: Readonly<RstestConfig>;
@@ -1958,8 +2049,9 @@ declare type RstestContext = {
     /**
      * The command type.
      *
-     * - dev: `rstest dev`
-     * - run: `rstest run`
+     * - run: `rstest`
+     * - dev: `rstest dev` or watch mode
+     * - list: `rstest list`
      */
     command: RstestCommand;
     reporters: Reporter[];
@@ -2119,7 +2211,7 @@ declare type RunnerAPI = {
     onTestFailed: (fn: OnTestFailedHandler, timeout?: number) => void;
 };
 
-declare type RuntimeConfig = Pick<RstestContext['normalizedConfig'], 'testTimeout' | 'testNamePattern' | 'globals' | 'passWithNoTests' | 'retry' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'unstubEnvs' | 'unstubGlobals' | 'maxConcurrency' | 'printConsoleTrace' | 'disableConsoleIntercept' | 'testEnvironment' | 'isolate' | 'hookTimeout'>;
+declare type RuntimeConfig = Pick<RstestContext['normalizedConfig'], 'testTimeout' | 'testNamePattern' | 'globals' | 'passWithNoTests' | 'retry' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'unstubEnvs' | 'unstubGlobals' | 'maxConcurrency' | 'printConsoleTrace' | 'disableConsoleIntercept' | 'testEnvironment' | 'isolate' | 'hookTimeout' | 'coverage'>;
 
 declare type RuntimeOptions = Partial<Pick<RuntimeConfig, 'testTimeout' | 'hookTimeout' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'maxConcurrency' | 'retry'>>;
 
@@ -2397,6 +2489,17 @@ export declare type TestResult = {
 
 declare type TestResultStatus = 'skip' | 'pass' | 'fail' | 'todo';
 
+declare type Thresholds = {
+    /** Thresholds for statements */
+    statements?: number;
+    /** Thresholds for functions */
+    functions?: number;
+    /** Thresholds for branches */
+    branches?: number;
+    /** Thresholds for lines */
+    lines?: number;
+};
+
 declare class TraceMap implements SourceMap {
     version: SourceMapV3['version'];
     file: SourceMapV3['file'];

package/dist-types/worker.d.ts

@@ -1,3 +1,4 @@
+import type { ReportOptions } from 'istanbul-reports';
 import type { RsbuildConfig } from '@rsbuild/core';
 
 /**
@@ -317,6 +318,56 @@ declare class CounterMap<K> extends DefaultMap<K, number> {
     	total(): number;
 }
 
+declare type CoverageOptions = {
+    /**
+     * Enable coverage collection.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * A list of glob patterns that should be excluded from coverage collection.
+     *
+     * This option accepts an array of wax(https://crates.io/crates/wax)-compatible glob patterns
+     *
+     * @default ['**\/node_modules/**',
+     *           '**\/dist/**',
+     *           '**\/test/**',
+     *           '**\/__tests__/**',
+     *           '**\/*.{test,spec}.?(c|m)[jt]s?(x)',
+     *           '**\/__mocks__/**'
+     * ]
+     */
+    exclude?: string[];
+    /**
+     * The provider to use for coverage collection.
+     * @default 'istanbul'
+     */
+    provider?: 'istanbul';
+    /**
+     * The reporters to use for coverage collection.
+     * @default ['text', 'html', 'clover', 'json']
+     */
+    reporters?: (keyof ReportOptions | ReportWithOptions)[];
+    /**
+     * The directory to store coverage reports.
+     * @default './coverage'
+     */
+    reportsDirectory?: string;
+    /**
+     * Whether to clean the coverage directory before running tests.
+     * @default true
+     */
+    clean?: boolean;
+    /**
+     * Coverage thresholds
+     *
+     * @default undefined
+     */
+    thresholds?: CoverageThresholds;
+};
+
+declare type CoverageThresholds = Thresholds;
+
 declare interface CustomMatcher {
     	/**
      	* Checks that a value satisfies a custom matcher function.
@@ -1363,10 +1414,15 @@ declare interface NewPlugin {
     	test: Test;
 }
 
-declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects'>> & {
+declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage'>> & {
     [key in OptionalKeys]?: RstestConfig[key];
 } & {
     pool: RstestPoolOptions;
+    coverage: NormalizedCoverageOptions;
+};
+
+declare type NormalizedCoverageOptions = Required<Omit<CoverageOptions, 'thresholds'>> & {
+    thresholds?: CoverageThresholds;
 };
 
 declare type NormalizedFixture = {
@@ -1380,8 +1436,8 @@ declare type NormalizedFixtures = Record<string, NormalizedFixture>;
 
 declare type NormalizedProcedure<T extends Procedure> = (...args: Parameters<T>) => ReturnType<T>;
 
-declare type NormalizedProjectConfig = Required<Omit<RstestConfig, OptionalKeys | 'projects' | 'reporters' | 'pool'>> & {
-    [key in OptionalKeys]?: RstestConfig[key];
+declare type NormalizedProjectConfig = Required<Omit<NormalizedConfig, OptionalKeys | 'projects' | 'reporters' | 'pool'>> & {
+    [key in OptionalKeys]?: NormalizedConfig[key];
 };
 
 declare interface OldPlugin {
@@ -1451,11 +1507,12 @@ declare function printWithType<T>(name: string, value: T, print: (value: T) => s
 
 declare type Procedure = (...args: any[]) => any;
 
-declare type ProjectConfig = Omit<RstestConfig, 'projects' | 'reporters' | 'pool' | 'isolate'>;
+declare type ProjectConfig = Omit<RstestConfig, 'projects' | 'reporters' | 'pool' | 'isolate' | 'coverage'>;
 
 declare type ProjectContext = {
     name: string;
     environmentName: string;
+    /** The root path of current project. */
     rootPath: string;
     configFilePath?: string;
     normalizedConfig: NormalizedProjectConfig;
@@ -1529,6 +1586,8 @@ declare const reportersMap: {
 
 declare type ReporterWithOptions<Name extends BuiltInReporterNames = BuiltInReporterNames> = Name extends keyof BuiltinReporterOptions ? [Name, Partial<BuiltinReporterOptions[Name]>] : [Name, Record<string, unknown>];
 
+declare type ReportWithOptions<Name extends keyof ReportOptions = keyof ReportOptions> = Name extends keyof ReportOptions ? [Name, Partial<ReportOptions[Name]>] : [Name, Record<string, unknown>];
+
 declare type Ro<T> = T extends Array<infer V> ? V[] | Readonly<V[]> | RoArray<V> | Readonly<RoArray<V>> : T extends object ? T | Readonly<T> | RoObject<T> | Readonly<RoObject<T>> : T;
 
 declare type RoArray<T> = Ro<T>[];
@@ -1687,6 +1746,10 @@ declare interface RstestConfig {
      * Custom handler for console log in tests
      */
     onConsoleLog?: (content: string) => boolean | void;
+    /**
+     * Coverage options
+     */
+    coverage?: CoverageOptions;
     plugins?: RsbuildConfig['plugins'];
     source?: Pick<NonNullable<RsbuildConfig['source']>, 'define' | 'tsconfigPath' | 'decorators' | 'include' | 'exclude'>;
     performance?: Pick<NonNullable<RsbuildConfig['performance']>, 'bundleAnalyze'>;
@@ -1699,7 +1762,7 @@ declare interface RstestConfig {
 declare type RstestContext = {
     /** The Rstest core version. */
     version: string;
-    /** The root path of current project. */
+    /** The root path of rstest. */
     rootPath: string;
     /** The original Rstest config passed from the createRstest method. */
     originalConfig: Readonly<RstestConfig>;
@@ -1716,8 +1779,9 @@ declare type RstestContext = {
     /**
      * The command type.
      *
-     * - dev: `rstest dev`
-     * - run: `rstest run`
+     * - run: `rstest`
+     * - dev: `rstest dev` or watch mode
+     * - list: `rstest list`
      */
     command: RstestCommand;
     reporters: Reporter[];
@@ -1757,7 +1821,7 @@ declare type RunnerAPI = {
     onTestFailed: (fn: OnTestFailedHandler, timeout?: number) => void;
 };
 
-declare type RuntimeConfig = Pick<RstestContext['normalizedConfig'], 'testTimeout' | 'testNamePattern' | 'globals' | 'passWithNoTests' | 'retry' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'unstubEnvs' | 'unstubGlobals' | 'maxConcurrency' | 'printConsoleTrace' | 'disableConsoleIntercept' | 'testEnvironment' | 'isolate' | 'hookTimeout'>;
+declare type RuntimeConfig = Pick<RstestContext['normalizedConfig'], 'testTimeout' | 'testNamePattern' | 'globals' | 'passWithNoTests' | 'retry' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'unstubEnvs' | 'unstubGlobals' | 'maxConcurrency' | 'printConsoleTrace' | 'disableConsoleIntercept' | 'testEnvironment' | 'isolate' | 'hookTimeout' | 'coverage'>;
 
 /** Runtime to Server */
 declare type RuntimeRPC = {
@@ -2122,6 +2186,17 @@ declare type TestSuite = {
     beforeEachListeners?: BeforeEachListener[];
 };
 
+declare type Thresholds = {
+    /** Thresholds for statements */
+    statements?: number;
+    /** Thresholds for functions */
+    functions?: number;
+    /** Thresholds for branches */
+    branches?: number;
+    /** Thresholds for lines */
+    lines?: number;
+};
+
 declare class TraceMap implements SourceMap {
     version: SourceMapV3['version'];
     file: SourceMapV3['file'];
@@ -2167,6 +2242,7 @@ declare type WithAsymmetricMatcher<T> = T | AsymmetricMatcher<unknown>;
 
 declare type WorkerContext = {
     rootPath: RstestContext['rootPath'];
+    projectRoot: ProjectContext['rootPath'];
     project: string;
     runtimeConfig: RuntimeConfig;
 };