@rstest/core 0.4.1 → 0.5.1

package/dist-types/worker.d.ts

@@ -1,4 +1,3 @@
-import type { ReportOptions } from 'istanbul-reports';
 import type { RsbuildConfig } from '@rsbuild/core';
 
 /**
@@ -247,12 +246,23 @@ declare type BeforeAllListener = (ctx: SuiteContext) => MaybePromise<void | Afte
 
 declare type BeforeEachListener = () => MaybePromise<void | AfterEachListener>;
 
+declare interface BranchMapping {
+    loc: Range_2;
+    type: string;
+    locations: Range_2[];
+    line: number;
+}
+
 declare type BuiltInReporterNames = keyof typeof reportersMap;
 
 declare type BuiltinReporterOptions = {
     default: DefaultReporterOptions;
 };
 
+declare interface CloverOptions extends FileOptions, ProjectOptions {}
+
+declare interface CoberturaOptions extends FileOptions, ProjectOptions {}
+
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
@@ -318,12 +328,29 @@ declare class CounterMap<K> extends DefaultMap<K, number> {
     	total(): number;
 }
 
+declare interface Coverage {
+    covered: number;
+    total: number;
+    coverage: number;
+}
+
+declare interface CoverageMapData {
+    [key: string]: FileCoverage | FileCoverageData;
+}
+
 declare type CoverageOptions = {
     /**
      * Enable coverage collection.
      * @default false
      */
     enabled?: boolean;
+    /**
+     * A list of glob patterns that should be included for coverage collection.
+     * Only collect coverage for tested files by default.
+     *
+     * @default undefined
+     */
+    include?: string[];
     /**
      * A list of glob patterns that should be excluded from coverage collection.
      *
@@ -364,9 +391,53 @@ declare type CoverageOptions = {
      * @default undefined
      */
     thresholds?: CoverageThresholds;
+    /**
+     * Whether to report coverage when tests fail.
+     * @default false
+     */
+    reportOnFailure?: boolean;
 };
 
-declare type CoverageThresholds = Thresholds;
+declare class CoverageSummary {
+    constructor(data: CoverageSummary | CoverageSummaryData);
+    merge(obj: CoverageSummary): CoverageSummary;
+    toJSON(): CoverageSummaryData;
+    isEmpty(): boolean;
+    data: CoverageSummaryData;
+    lines: Totals;
+    statements: Totals;
+    branches: Totals;
+    functions: Totals;
+}
+
+declare interface CoverageSummaryData {
+    lines: Totals;
+    statements: Totals;
+    branches: Totals;
+    functions: Totals;
+}
+
+declare type CoverageThreshold = {
+    /** Threshold for statements */
+    statements?: number;
+    /** Threshold for functions */
+    functions?: number;
+    /** Threshold for branches */
+    branches?: number;
+    /** Threshold for lines */
+    lines?: number;
+};
+
+declare type CoverageThresholds = CoverageThreshold | (CoverageThreshold & {
+    /** check thresholds for matched files */
+    [glob: string]: CoverageThreshold & {
+        /**
+         * check thresholds per file
+         * @default false
+         */
+        perFile?: boolean;
+    };
+});
 
 declare interface CustomMatcher {
     	/**
@@ -571,6 +642,42 @@ declare interface ExpectStatic_2 extends Chai.ExpectStatic, Matchers, Asymmetric
     	not: AsymmetricMatchersContaining;
 }
 
+declare class FileCoverage implements FileCoverageData {
+    constructor(data: string | FileCoverage | FileCoverageData);
+    merge(other: FileCoverageData): void;
+    getBranchCoverageByLine(): { [line: number]: Coverage };
+    getLineCoverage(): { [line: number]: number };
+    getUncoveredLines(): number[];
+    resetHits(): void;
+    computeBranchTotals(): Totals;
+    computeSimpleTotals(): Totals;
+    toSummary(): CoverageSummary;
+    toJSON(): object;
+
+    data: FileCoverageData;
+    path: string;
+    statementMap: { [key: string]: Range_2 };
+    fnMap: { [key: string]: FunctionMapping };
+    branchMap: { [key: string]: BranchMapping };
+    s: { [key: string]: number };
+    f: { [key: string]: number };
+    b: { [key: string]: number[] };
+}
+
+declare interface FileCoverageData {
+    path: string;
+    statementMap: { [key: string]: Range_2 };
+    fnMap: { [key: string]: FunctionMapping };
+    branchMap: { [key: string]: BranchMapping };
+    s: { [key: string]: number };
+    f: { [key: string]: number };
+    b: { [key: string]: number[] };
+}
+
+declare interface FileOptions {
+    file: string;
+}
+
 declare type Fixture<T, K extends keyof T, ExtraContext = object> = ((...args: any) => any) extends T[K] ? T[K] extends any ? FixtureFn<T, K, Omit<ExtraContext, Exclude<keyof T, K>>> : never : T[K] | (T[K] extends any ? FixtureFn<T, K, Omit<ExtraContext, Exclude<keyof T, K>>> : never);
 
 declare type FixtureFn<T, K extends keyof T, ExtraContext> = (context: Omit<T, K> & ExtraContext, use: Use<T[K]>) => Promise<void>;
@@ -600,6 +707,13 @@ declare interface Formatter {
     close: string;
 }
 
+declare interface FunctionMapping {
+    name: string;
+    decl: Range_2;
+    loc: Range_2;
+    line: number;
+}
+
 declare type GeneratedColumn = number;
 
 declare function getMatcherUtils(): {
@@ -638,6 +752,17 @@ declare class GithubActionsReporter {
     }): Promise<void>;
 }
 
+declare interface HtmlOptions {
+    verbose: boolean;
+    skipEmpty: boolean;
+    subdir: string;
+    linkMapper: LinkMapper;
+}
+
+declare interface HtmlSpaOptions extends HtmlOptions {
+    metricsToShow: Array<"lines" | "branches" | "functions" | "statements">;
+}
+
 declare type Indent = (arg0: string) => string;
 
 declare interface InlineSnapshotMatcher<T> {
@@ -1036,6 +1161,10 @@ declare interface JestAssertion<T = any> extends jest.Matchers<void, T>, CustomM
     	nthReturnedWith: <E>(nthCall: number, value: E) => void;
 }
 
+declare type JsonOptions = FileOptions;
+
+declare type JsonSummaryOptions = FileOptions;
+
 declare class JUnitReporter implements Reporter {
     private rootPath;
     private outputPath?;
@@ -1058,6 +1187,21 @@ declare class JUnitReporter implements Reporter {
     }): Promise<void>;
 }
 
+declare interface LcovOnlyOptions extends FileOptions, ProjectOptions {}
+
+declare interface LcovOptions extends FileOptions, ProjectOptions {}
+
+declare interface LinkMapper {
+    getPath(node: string | Node_2): string;
+    relativePath(source: string | Node_2, target: string | Node_2): string;
+    assetPath(node: Node_2, name: string): string;
+}
+
+declare interface Location_2 {
+    line: number;
+    column: number;
+}
+
 declare function matcherHint(matcherName: string, received?: string, expected?: string, options?: MatcherHintOptions): string;
 
 declare interface MatcherHintOptions {
@@ -1414,15 +1558,26 @@ declare interface NewPlugin {
     	test: Test;
 }
 
-declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage'>> & {
+declare interface Node_2 {
+    isRoot(): boolean;
+    visit(visitor: Visitor, state: any): void;
+}
+
+declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage' | 'setupFiles' | 'exclude'>> & {
     [key in OptionalKeys]?: RstestConfig[key];
 } & {
     pool: RstestPoolOptions;
     coverage: NormalizedCoverageOptions;
+    setupFiles: string[];
+    exclude: {
+        patterns: string[];
+        override?: boolean;
+    };
 };
 
-declare type NormalizedCoverageOptions = Required<Omit<CoverageOptions, 'thresholds'>> & {
+declare type NormalizedCoverageOptions = Required<Omit<CoverageOptions, 'thresholds' | 'include'>> & {
     thresholds?: CoverageThresholds;
+    include?: string[];
 };
 
 declare type NormalizedFixture = {
@@ -1436,8 +1591,10 @@ declare type NormalizedFixtures = Record<string, NormalizedFixture>;
 
 declare type NormalizedProcedure<T extends Procedure> = (...args: Parameters<T>) => ReturnType<T>;
 
-declare type NormalizedProjectConfig = Required<Omit<NormalizedConfig, OptionalKeys | 'projects' | 'reporters' | 'pool'>> & {
+declare type NormalizedProjectConfig = Required<Omit<NormalizedConfig, OptionalKeys | 'projects' | 'reporters' | 'pool' | 'setupFiles'>> & {
     [key in OptionalKeys]?: NormalizedConfig[key];
+} & {
+    setupFiles: string[];
 };
 
 declare interface OldPlugin {
@@ -1457,7 +1614,7 @@ declare type OnTestFinishedHandler = (params: {
     };
 }) => MaybePromise<void>;
 
-declare type OptionalKeys = 'setupFiles' | 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'performance' | 'tools' | 'dev' | 'onConsoleLog';
+declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'performance' | 'tools' | 'dev' | 'onConsoleLog';
 
 declare type OptionsReceived = PrettyFormatOptions;
 
@@ -1518,6 +1675,10 @@ declare type ProjectContext = {
     normalizedConfig: NormalizedProjectConfig;
 };
 
+declare interface ProjectOptions {
+    projectRoot: string;
+}
+
 declare type Promisify<O> = { [K in keyof O] : O[K] extends (...args: infer A) => infer R ? Promisify<O[K]> & ((...args: A) => Promise<R>) : O[K] };
 
 declare type Promisify_2<O> = {
@@ -1528,6 +1689,11 @@ declare type PromisifyAssertion<T> = Promisify<Assertion<T>>;
 
 declare type PromisifyAssertion_2<T> = Promisify_2<Assertion_2<T>>;
 
+declare interface Range_2 {
+    start: Location_2;
+    end: Location_2;
+}
+
 declare interface RawMatcherFn<
 	T extends MatcherState = MatcherState,
 	E extends Array<any> = Array<any>
@@ -1586,6 +1752,22 @@ declare const reportersMap: {
 
 declare type ReporterWithOptions<Name extends BuiltInReporterNames = BuiltInReporterNames> = Name extends keyof BuiltinReporterOptions ? [Name, Partial<BuiltinReporterOptions[Name]>] : [Name, Record<string, unknown>];
 
+declare interface ReportOptions {
+    clover: CloverOptions;
+    cobertura: CoberturaOptions;
+    "html-spa": HtmlSpaOptions;
+    html: HtmlOptions;
+    json: JsonOptions;
+    "json-summary": JsonSummaryOptions;
+    lcov: LcovOptions;
+    lcovonly: LcovOnlyOptions;
+    none: never;
+    teamcity: TeamcityOptions;
+    text: TextOptions;
+    "text-lcov": TextLcovOptions;
+    "text-summary": TextSummaryOptions;
+}
+
 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;
@@ -1626,7 +1808,14 @@ declare interface RstestConfig {
      *
      * @default ['**\/node_modules/**', '**\/dist/**']
      */
-    exclude?: string[];
+    exclude?: string[] | {
+        patterns: string[];
+        /**
+         * override default exclude patterns
+         * @default false
+         */
+        override?: boolean;
+    };
     /**
      * A list of glob patterns that match your in-source test files
      *
@@ -1746,6 +1935,8 @@ declare interface RstestConfig {
      * Custom handler for console log in tests
      */
     onConsoleLog?: (content: string) => boolean | void;
+    /** Format snapshot output */
+    snapshotFormat?: SnapshotFormat;
     /**
      * Coverage options
      */
@@ -1821,7 +2012,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' | 'coverage'>;
+declare type RuntimeConfig = Pick<RstestContext['normalizedConfig'], 'testTimeout' | 'testNamePattern' | 'globals' | 'passWithNoTests' | 'retry' | 'clearMocks' | 'resetMocks' | 'restoreMocks' | 'unstubEnvs' | 'unstubGlobals' | 'maxConcurrency' | 'printConsoleTrace' | 'disableConsoleIntercept' | 'testEnvironment' | 'isolate' | 'hookTimeout' | 'coverage' | 'snapshotFormat'>;
 
 /** Runtime to Server */
 declare type RuntimeRPC = {
@@ -1860,6 +2051,8 @@ declare interface SnapshotEnvironment {
     	processStackTrace?: (stack: ParsedStack) => ParsedStack;
 }
 
+declare type SnapshotFormat = Omit<NonNullable<SnapshotStateOptions['snapshotFormat']>, 'plugins' | 'compareKeys'>;
+
 declare class SnapshotManager {
     	options: Omit<SnapshotStateOptions, "snapshotEnvironment">;
     	summary: SnapshotSummary;
@@ -2057,6 +2250,10 @@ declare interface TaskResult {
 
 declare type TaskState = 'pass' | 'fail';
 
+declare interface TeamcityOptions extends FileOptions {
+    blockName: string;
+}
+
 declare type Test = (arg0: any) => boolean;
 
 declare type Test_2 = TestSuite | TestCase;
@@ -2136,6 +2333,7 @@ declare type TestFileInfo = {
 declare type TestFileResult = TestResult & {
     results: TestResult[];
     snapshotResult?: SnapshotResult;
+    coverage?: CoverageMapData;
 };
 
 declare type TestFn<ExtraContext = object> = (description: string, fn?: TestCallbackFn<ExtraContext>, timeout?: number) => void;
@@ -2186,16 +2384,22 @@ 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 type TextLcovOptions = ProjectOptions;
+
+declare interface TextOptions extends FileOptions {
+    maxCols: number;
+    skipEmpty: boolean;
+    skipFull: boolean;
+}
+
+declare type TextSummaryOptions = FileOptions;
+
+declare interface Totals {
+    total: number;
+    covered: number;
+    skipped: number;
+    pct: number;
+}
 
 declare class TraceMap implements SourceMap {
     version: SourceMapV3['version'];
@@ -2233,6 +2437,14 @@ declare class VerboseReporter extends DefaultReporter {
     onTestFileResult(test: TestFileResult): void;
 }
 
+declare interface Visitor<N extends Node_2 = Node_2> {
+    onStart(root: N, state: any): void;
+    onSummary(root: N, state: any): void;
+    onDetail(root: N, state: any): void;
+    onSummaryEnd(root: N, state: any): void;
+    onEnd(root: N, state: any): void;
+}
+
 declare type VitestAssertion<
 	A,
 	T

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rstest/core",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "The Rsbuild-based test tool.",
   "bugs": {
     "url": "https://github.com/web-infra-dev/rstest/issues"
@@ -44,15 +44,14 @@
     "importMeta.d.ts"
   ],
   "dependencies": {
-    "chai": "^5.3.3",
     "@types/chai": "^5.2.2",
     "@rsbuild/core": "1.5.0",
-    "birpc": "2.5.0",
-    "pathe": "^2.0.3",
-    "std-env": "^3.9.0",
     "tinypool": "^1.1.1"
   },
   "devDependencies": {
+    "chai": "^5.3.3",
+    "pathe": "^2.0.3",
+    "birpc": "2.5.0",
     "@vitest/expect": "^3.2.4",
     "@vitest/snapshot": "^3.2.4",
     "@babel/code-frame": "^7.27.1",
@@ -66,6 +65,7 @@
     "@types/jsdom": "^21.1.7",
     "@types/sinonjs__fake-timers": "^8.1.5",
     "@types/source-map-support": "^0.5.10",
+    "@types/picomatch": "^4.0.2",
     "cac": "^6.7.14",
     "chokidar": "^4.0.3",
     "happy-dom": "^18.0.1",
@@ -75,10 +75,12 @@
     "picocolors": "^1.1.1",
     "rslog": "^1.2.11",
     "source-map-support": "^0.5.21",
+    "std-env": "^3.9.0",
     "stacktrace-parser": "0.1.11",
     "strip-ansi": "^7.1.2",
     "tinyglobby": "^0.2.15",
     "tinyspy": "^4.0.3",
+    "picomatch": "^4.0.3",
     "@rstest/tsconfig": "0.0.1"
   },
   "peerDependencies": {