@rstest/core 0.7.3 → 0.7.4

package/dist/worker.d.ts

@@ -13,11 +13,7 @@ declare function addSerializer(plugin: Plugin_2): void;
 
 declare type AfterAllListener = (ctx: SuiteContext) => MaybePromise<void>;
 
-declare type AfterEachListener = (params: {
-    task: {
-        result: Readonly<TestResult>;
-    };
-}) => MaybePromise<void>;
+declare type AfterEachListener = (ctx: TestContext) => MaybePromise<void>;
 
 declare interface Assertion<T = any> extends VitestAssertion<Chai.Assertion, T>, JestAssertion<T>, Matchers<T> {
     	/**
@@ -246,7 +242,7 @@ declare type AsyncExpectationResult = Promise<SyncExpectationResult>;
 
 declare type BeforeAllListener = (ctx: SuiteContext) => MaybePromise<void | AfterAllListener>;
 
-declare type BeforeEachListener = () => MaybePromise<void | AfterEachListener>;
+declare type BeforeEachListener = (ctx: TestContext) => MaybePromise<void | AfterEachListener>;
 
 declare interface BranchMapping {
     loc: Range_2;
@@ -319,6 +315,59 @@ declare interface Constructable {
     	new (...args: any[]): any;
 }
 
+/**
+ * Base class for writing content
+ */
+declare class ContentWriter {
+    /**
+     * returns the colorized version of a string. Typically,
+     * content writers that write to files will return the
+     * same string and ones writing to a tty will wrap it in
+     * appropriate escape sequences.
+     */
+    colorize(str: string, clazz?: string): string;
+    /**
+     * writes a string appended with a newline to the destination
+     */
+    println(str: string): void;
+    /**
+     * closes this content writer. Should be called after all writes are complete.
+     */
+    close(): void;
+}
+
+declare interface Context {
+    data: any;
+    dir: string;
+    sourceFinder(filepath: string): string;
+    watermarks: Watermarks;
+    writer: FileWriter;
+    /**
+     * returns the coverage class given a coverage
+     * types and a percentage value.
+     */
+    classForPercent(type: keyof Watermarks, value: number): string;
+    /**
+     * returns the source code for the specified file path or throws if
+     * the source could not be found.
+     */
+    getSource(filepath: string): string;
+    getTree(summarizer?: Summarizers): Tree;
+    /**
+     * returns a full visitor given a partial one.
+     */
+    getVisitor<N extends Node_2 = Node_2>(visitor: Partial<Visitor<N>>): Visitor<N>;
+    /**
+     * returns a FileWriter implementation for reporting use. Also available
+     * as the `writer` property on the context.
+     */
+    getWriter(): FileWriter;
+    /**
+     * returns an XML writer for the supplied content writer
+     */
+    getXmlWriter(contentWriter: ContentWriter): XmlWriter;
+}
+
 declare class CounterMap<K> extends DefaultMap<K, number> {
     	constructor();
     	// compat for jest-image-snapshot https://github.com/vitest-dev/vitest/issues/7322
@@ -378,7 +427,7 @@ declare type CoverageOptions = {
      * The reporters to use for coverage collection.
      * @default ['text', 'html', 'clover', 'json']
      */
-    reporters?: (keyof ReportOptions | ReportWithOptions)[];
+    reporters?: (keyof ReportOptions | ReportWithOptions | ReportBase)[];
     /**
      * The directory to store coverage reports.
      * @default './coverage'
@@ -497,12 +546,13 @@ declare class DefaultReporter implements Reporter {
     onTestCaseResult(): void;
     onUserConsoleLog(log: UserConsoleLog): void;
     onExit(): Promise<void>;
-    onTestRunEnd({ results, testResults, duration, getSourcemap, snapshotSummary, filterRerunTestPaths, }: {
+    onTestRunEnd({ results, testResults, duration, getSourcemap, snapshotSummary, filterRerunTestPaths, unhandledErrors, }: {
         results: TestFileResult[];
         testResults: TestResult[];
         duration: Duration;
         snapshotSummary: SnapshotSummary;
         getSourcemap: GetSourcemap;
+        unhandledErrors?: Error[];
         filterRerunTestPaths?: string[];
     }): Promise<void>;
 }
@@ -680,6 +730,29 @@ declare interface FileOptions {
     file: string;
 }
 
+/**
+ * utility for writing files under a specific directory
+ */
+declare class FileWriter {
+    constructor(baseDir: string);
+    static startCapture(): void;
+    static stopCapture(): void;
+    static getOutput(): string;
+    static resetOutput(): void;
+    /**
+     * returns a FileWriter that is rooted at the supplied subdirectory
+     */
+    writeForDir(subdir: string): FileWriter;
+    /**
+     * copies a file from a source directory to a destination name
+     */
+    copyFile(source: string, dest: string, header?: string): void;
+    /**
+     * returns a content writer for writing content to the supplied file.
+     */
+    writeFile(file: string | null): ContentWriter;
+}
+
 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>;
@@ -1584,10 +1657,11 @@ declare interface Node_2 {
     visit(visitor: Visitor, state: any): void;
 }
 
-declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage' | 'setupFiles' | 'exclude'>> & Partial<Pick<RstestConfig, OptionalKeys>> & {
+declare type NormalizedConfig = Required<Omit<RstestConfig, OptionalKeys | 'pool' | 'projects' | 'coverage' | 'setupFiles' | 'globalSetup' | 'exclude'>> & Partial<Pick<RstestConfig, OptionalKeys>> & {
     pool: RstestPoolOptions;
     coverage: NormalizedCoverageOptions;
     setupFiles: string[];
+    globalSetup: string[];
     exclude: {
         patterns: string[];
         override?: boolean;
@@ -1610,8 +1684,9 @@ 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' | 'setupFiles'>> & Pick<NormalizedConfig, OptionalKeys> & {
+declare type NormalizedProjectConfig = Required<Omit<NormalizedConfig, OptionalKeys | 'projects' | 'reporters' | 'pool' | 'setupFiles' | 'globalSetup'>> & Pick<NormalizedConfig, OptionalKeys> & {
     setupFiles: string[];
+    globalSetup: string[];
 };
 
 declare interface OldPlugin {
@@ -1619,17 +1694,9 @@ declare interface OldPlugin {
     	test: Test;
 }
 
-declare type OnTestFailedHandler = (params: {
-    task: {
-        result: Readonly<TestResult>;
-    };
-}) => MaybePromise<void>;
+declare type OnTestFailedHandler = (ctx: TestContext) => MaybePromise<void>;
 
-declare type OnTestFinishedHandler = (params: {
-    task: {
-        result: Readonly<TestResult>;
-    };
-}) => MaybePromise<void>;
+declare type OnTestFinishedHandler = (ctx: TestContext) => MaybePromise<void>;
 
 declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'performance' | 'tools' | 'dev' | 'onConsoleLog' | 'chaiConfig' | 'resolveSnapshotPath';
 
@@ -1702,6 +1769,7 @@ declare type ProjectContext = {
     outputModule: boolean;
     configFilePath?: string;
     normalizedConfig: NormalizedProjectConfig;
+    _globalSetups: boolean;
 };
 
 declare interface ProjectOptions {
@@ -1738,6 +1806,15 @@ declare interface RawSnapshotInfo {
 
 declare type Refs = Array<unknown>;
 
+declare class ReportBase {
+    constructor(options?: Partial<ReportBaseOptions>);
+    execute(context: Context): void;
+}
+
+declare interface ReportBaseOptions {
+    summarizer: Summarizers;
+}
+
 declare interface Reporter {
     /**
      * Called before test file run.
@@ -1772,11 +1849,12 @@ declare interface Reporter {
     /**
      * Called after all tests have finished running.
      */
-    onTestRunEnd?: ({ results, testResults, duration, getSourcemap, snapshotSummary, }: {
+    onTestRunEnd?: ({ results, testResults, duration, getSourcemap, snapshotSummary, unhandledErrors, }: {
         results: TestFileResult[];
         testResults: TestResult[];
         duration: Duration;
         getSourcemap: GetSourcemap;
+        unhandledErrors?: Error[];
         snapshotSummary: SnapshotSummary;
         filterRerunTestPaths?: string[];
     }) => MaybePromise<void>;
@@ -1873,6 +1951,12 @@ declare interface RstestConfig {
      * Path to setup files. They will be run before each test file.
      */
     setupFiles?: string[] | string;
+    /**
+     * Path to global setup files, relative to project root.
+     * A global setup file can either export named functions `setup` and `teardown`
+     * or a `default` function that returns a teardown function.
+     */
+    globalSetup?: string[] | string;
     /**
      * Retry the test specific number of times if it fails.
      * @default 0
@@ -2336,6 +2420,8 @@ declare type SuiteContext = {
     filepath: TestPath;
 };
 
+declare type Summarizers = "flat" | "nested" | "pkg" | "defaultSummarizer";
+
 declare interface SyncExpectationResult {
     	pass: boolean;
     	message: () => string;
@@ -2431,6 +2517,15 @@ declare type TestCaseInfo = {
 };
 
 declare type TestContext = {
+    /**
+     * Metadata of the current test
+     */
+    task: {
+        /** Test name provided by user */
+        name: string;
+        /** Result of the current test, undefined if the test is not run yet */
+        result?: TestResult;
+    };
     expect: RstestExpect;
     onTestFinished: RunnerAPI['onTestFinished'];
     onTestFailed: RunnerAPI['onTestFailed'];
@@ -2571,6 +2666,11 @@ declare class TraceMap implements SourceMap {
     constructor(map: Ro<SourceMapInput>, mapUrl?: string | null);
 }
 
+declare interface Tree<N extends Node_2 = Node_2> {
+    getRoot(): N;
+    visit(visitor: Partial<Visitor<N>>, state: any): void;
+}
+
 declare interface UncheckedSnapshot {
     	filePath: string;
     	keys: Array<string>;
@@ -2603,6 +2703,15 @@ declare type VitestAssertion<
 	T
 > = { [K in keyof A] : A[K] extends Chai.Assertion ? Assertion<T> : A[K] extends (...args: any[]) => any ? A[K] : VitestAssertion<A[K], T> } & ((type: string, message?: string) => Assertion);
 
+declare type Watermark = [number, number];
+
+declare interface Watermarks {
+    statements: Watermark;
+    functions: Watermark;
+    branches: Watermark;
+    lines: Watermark;
+}
+
 declare type WithAsymmetricMatcher<T> = T | AsymmetricMatcher<unknown>;
 
 declare type WorkerContext = {
@@ -2618,4 +2727,24 @@ declare type XInput = {
     x_google_ignoreList?: SourceMapV3['ignoreList'];
 };
 
+declare interface XmlWriter {
+    indent(str: string): string;
+    /**
+     * writes the opening XML tag with the supplied attributes
+     */
+    openTag(name: string, attrs?: any): void;
+    /**
+     * closes an open XML tag.
+     */
+    closeTag(name: string): void;
+    /**
+     * writes a tag and its value opening and closing it at the same time
+     */
+    inlineTag(name: string, attrs?: any, content?: string): void;
+    /**
+     * closes all open tags and ends the document
+     */
+    closeAll(): void;
+}
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rstest/core",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "The Rsbuild-based test tool.",
   "bugs": {
     "url": "https://github.com/web-infra-dev/rstest/issues"
@@ -64,6 +64,7 @@
     "@types/babel__code-frame": "^7.0.6",
     "@types/istanbul-reports": "^3.0.4",
     "@types/istanbul-lib-coverage": "^2.0.6",
+    "@types/istanbul-lib-report": "^3.0.3",
     "@types/jsdom": "^21.1.7",
     "@types/sinonjs__fake-timers": "^8.1.5",
     "@types/source-map-support": "^0.5.10",