@rstest/core 0.8.4 → 0.9.0

package/dist/browser.d.ts

@@ -338,6 +338,11 @@ declare type BrowserModeConfig = {
  */
 declare type BrowserName = 'chromium' | 'firefox' | 'webkit';
 
+declare interface BrowserSourcemapResolutionResult {
+    handled: boolean;
+    sourcemap: SourceMapInput | null;
+}
+
 /**
  * Options for running browser tests.
  */
@@ -375,6 +380,12 @@ export declare interface BrowserTestRunResult {
     hasFailure: boolean;
     /** Errors that occurred before/outside test execution (e.g., browser launch failure) */
     unhandledErrors?: Error[];
+    /** Source map resolver used when reporter output is unified in core */
+    getSourcemap?: GetSourcemap;
+    /** Route-aware source map resolver used by core unified reporter flow */
+    resolveSourcemap?: ResolveBrowserSourcemap;
+    /** Deferred cleanup hook for unified reporter mode */
+    close?: () => Promise<void>;
 }
 
 declare type BrowserViewport = {
@@ -681,7 +692,7 @@ declare type CoverageThresholds = CoverageThreshold | (CoverageThreshold & Thres
 export declare const createRstestRuntime: (workerState: WorkerState) => Promise<{
     runner: {
         runTests: (testPath: string, hooks: RunnerHooks, api: Rstest_2) => Promise<TestFileResult>;
-        collectTests: () => Promise<Test[]>;
+        collectTests: () => Promise<TestInfo[]>;
         getCurrentTest: () => TestCase | undefined;
     };
     api: Rstest_2;
@@ -1527,7 +1538,7 @@ declare interface LinkMapper {
 }
 
 export declare type ListCommandResult = {
-    tests: Test[];
+    tests: TestInfo[];
     testPath: string;
     project: string;
     errors?: FormattedError[];
@@ -1642,6 +1653,13 @@ declare type MdReporterOptions = {
      * @default 'file+name'
      */
     reproduction?: boolean | 'file' | 'file+name';
+    /**
+     * Test lists (Passed / Skipped / Todo) display mode.
+     * - `'auto'`: show only when all tests pass and the run is focused
+     * - `'always'`: always show regardless of test status or focus
+     * @default 'auto'
+     */
+    testLists?: 'auto' | 'always';
     /**
      * Failure output controls.
      * @default { max: 50 }
@@ -2274,7 +2292,7 @@ export declare const onTestFinished: Rstest_2['onTestFinished'];
 
 declare type OnTestFinishedHandler = (ctx: TestContext) => MaybePromise<void>;
 
-declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'performance' | 'tools' | 'dev' | 'onConsoleLog' | 'chaiConfig' | 'hideSkippedTestFiles' | 'resolveSnapshotPath' | 'extends' | 'shard';
+declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'tools' | 'dev' | 'onConsoleLog' | 'chaiConfig' | 'hideSkippedTestFiles' | 'resolveSnapshotPath' | 'extends' | 'shard';
 
 declare interface Options {
     logger: {
@@ -2487,6 +2505,8 @@ declare interface ReportOptions {
 
 declare type ReportWithOptions<Name extends keyof ReportOptions = keyof ReportOptions> = Name extends keyof ReportOptions ? [Name, Partial<ReportOptions[Name]>] : [Name, Record<string, unknown>];
 
+declare type ResolveBrowserSourcemap = (sourcePath: string) => Promise<BrowserSourcemapResolutionResult>;
+
 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>[];
@@ -2711,7 +2731,7 @@ declare interface RstestConfig {
      */
     unstubGlobals?: boolean;
     /**
-     * Restores all `process.env` values that were changed with `rstest.stubEnv` before every test.
+     * Restores all runtime env values that were changed with `rstest.stubEnv` before every test.
      * @default false
      */
     unstubEnvs?: boolean;
@@ -2757,7 +2777,6 @@ declare interface RstestConfig {
     includeTaskLocation?: boolean;
     plugins?: RsbuildConfig['plugins'];
     source?: Pick<NonNullable<RsbuildConfig['source']>, 'define' | 'tsconfigPath' | 'decorators' | 'include' | 'exclude'>;
-    performance?: Pick<NonNullable<RsbuildConfig['performance']>, 'bundleAnalyze'>;
     dev?: Pick<NonNullable<RsbuildConfig['dev']>, 'writeToDisk'>;
     output?: Pick<NonNullable<RsbuildConfig['output']>, 'cssModules' | 'externals' | 'cleanDistPath' | 'module'>;
     resolve?: RsbuildConfig['resolve'];
@@ -2978,11 +2997,12 @@ declare interface RstestUtilities {
      */
     resetModules: () => RstestUtilities;
     /**
-     * Changes the value of environmental variable on `process.env`.
+     * Changes the value of an environment variable in the current runtime env store.
+     * Uses `process.env` in Node.js and runtime env store in browser mode.
      */
     stubEnv: (name: string, value: string | undefined) => RstestUtilities;
     /**
-     * Restores all `process.env` values that were changed with `rstest.stubEnv`.
+     * Restores all env values that were changed with `rstest.stubEnv`.
      */
     unstubAllEnvs: () => RstestUtilities;
     /**
@@ -3034,6 +3054,17 @@ declare interface RstestUtilities {
      * Removes all timers that are scheduled to run.
      */
     clearAllTimers: () => RstestUtilities;
+    /**
+     * Retry callback until it succeeds (doesn't throw) or timeout is reached.
+     * If timeout is reached, throws the last error from the callback.
+     */
+    waitFor: <T>(callback: WaitForCallback<T>, options?: number | WaitForOptions) => Promise<T>;
+    /**
+     * Retry callback until it returns a truthy value or timeout is reached.
+     * If callback throws, it interrupts immediately and throws that error.
+     * If timeout is reached, throws an error.
+     */
+    waitUntil: <T>(callback: () => MaybePromise<T>, options?: number | WaitUntilOptions) => Promise<T>;
 }
 
 declare type RunnerAPI = {
@@ -3349,7 +3380,6 @@ declare type TestCallbackFn<ExtraContext = object> = (context: TestContext & Ext
 declare type TestCase = TestCaseInfo & {
     originalFn?: (context: TestContext) => void | Promise<void>;
     fn?: (context: TestContext) => void | Promise<void>;
-    runMode: TestRunMode;
     fails?: boolean;
     each?: boolean;
     fixtures?: NormalizedFixtures;
@@ -3385,6 +3415,7 @@ declare type TestCaseInfo = {
     /** Only included when `includeTaskLocation` config is enabled */
     location?: Location_2;
     type: 'case';
+    runMode: TestRunMode;
 };
 
 declare type TestContext = {
@@ -3422,7 +3453,7 @@ declare type TestFileInfo = {
 export declare type TestFileResult = TestResult & {
     results: TestResult[];
     snapshotResult?: SnapshotResult;
-    coverage?: CoverageMapData;
+    coverage?: Record<string, FileCoverageData>;
 };
 
 declare type TestFn<ExtraContext = object> = (description: string, fn?: TestCallbackFn<ExtraContext>, timeout?: number) => void;
@@ -3471,7 +3502,6 @@ declare class TestStateManager {
 }
 
 declare type TestSuite = TestSuiteInfo & {
-    runMode: TestRunMode;
     each?: boolean;
     inTestEach?: boolean;
     concurrent?: boolean;
@@ -3493,6 +3523,7 @@ declare type TestSuiteInfo = {
     type: 'suite';
     /** Only included when `includeTaskLocation` config is enabled */
     location?: Location_2;
+    runMode: TestRunMode;
 };
 
 declare type TextLcovOptions = ProjectOptions;
@@ -3573,6 +3604,18 @@ declare type VitestAssertion<
 	T
 > = { [K in keyof A] : A[K] extends Chai.Assertion ? Assertion_2<T> : A[K] extends (...args: any[]) => any ? A[K] : VitestAssertion<A[K], T> } & ((type: string, message?: string) => Assertion_2);
 
+declare type WaitForCallback<T> = () => MaybePromise<T>;
+
+declare interface WaitForOptions {
+    timeout?: number;
+    interval?: number;
+}
+
+declare interface WaitUntilOptions {
+    timeout?: number;
+    interval?: number;
+}
+
 declare type Watermark = [number, number];
 
 declare interface Watermarks {

package/dist/index.d.ts

@@ -885,7 +885,7 @@ declare interface ExpectPollOptions {
     message?: string;
 }
 
-declare interface ExpectStatic extends ExpectStatic_2 {
+export declare interface ExpectStatic extends ExpectStatic_2 {
     <T>(actual: T, message?: string): Assertion<T>;
     unreachable: (message?: string) => never;
     soft: <T>(actual: T, message?: string) => Assertion<T>;
@@ -1536,7 +1536,7 @@ declare type ListCommandOptions = {
 };
 
 declare type ListCommandResult = {
-    tests: Test_2[];
+    tests: TestInfo[];
     testPath: string;
     project: string;
     errors?: FormattedError[];
@@ -1652,6 +1652,13 @@ declare type MdReporterOptions = {
      * @default 'file+name'
      */
     reproduction?: boolean | 'file' | 'file+name';
+    /**
+     * Test lists (Passed / Skipped / Todo) display mode.
+     * - `'auto'`: show only when all tests pass and the run is focused
+     * - `'always'`: always show regardless of test status or focus
+     * @default 'auto'
+     */
+    testLists?: 'auto' | 'always';
     /**
      * Failure output controls.
      * @default { max: 50 }
@@ -2261,15 +2268,6 @@ export declare type NormalizedCoverageOptions = Required<Omit<CoverageOptions, '
     include?: string[];
 };
 
-declare type NormalizedFixture = {
-    isFn: boolean;
-    deps?: string[];
-    value: FixtureFn<any, any, any> | any;
-    options?: FixtureOptions;
-};
-
-declare type NormalizedFixtures = Record<string, NormalizedFixture>;
-
 declare type NormalizedProcedure<T extends Procedure> = (...args: Parameters<T>) => ReturnType<T>;
 
 declare type NormalizedProcedure_2<T extends Procedure_2> = (...args: Parameters<T>) => ReturnType<T>;
@@ -2292,7 +2290,7 @@ export declare const onTestFinished: Rstest['onTestFinished'];
 
 declare type OnTestFinishedHandler = (ctx: TestContext) => MaybePromise<void>;
 
-declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'performance' | 'tools' | 'dev' | 'onConsoleLog' | 'chaiConfig' | 'hideSkippedTestFiles' | 'resolveSnapshotPath' | 'extends' | 'shard';
+declare type OptionalKeys = 'testNamePattern' | 'plugins' | 'source' | 'resolve' | 'output' | 'tools' | 'dev' | 'onConsoleLog' | 'chaiConfig' | 'hideSkippedTestFiles' | 'resolveSnapshotPath' | 'extends' | 'shard';
 
 declare interface Options {
     logger: {
@@ -2703,7 +2701,7 @@ export declare interface RstestConfig {
      */
     unstubGlobals?: boolean;
     /**
-     * Restores all `process.env` values that were changed with `rstest.stubEnv` before every test.
+     * Restores all runtime env values that were changed with `rstest.stubEnv` before every test.
      * @default false
      */
     unstubEnvs?: boolean;
@@ -2749,7 +2747,6 @@ export declare interface RstestConfig {
     includeTaskLocation?: boolean;
     plugins?: RsbuildConfig['plugins'];
     source?: Pick<NonNullable<RsbuildConfig['source']>, 'define' | 'tsconfigPath' | 'decorators' | 'include' | 'exclude'>;
-    performance?: Pick<NonNullable<RsbuildConfig['performance']>, 'bundleAnalyze'>;
     dev?: Pick<NonNullable<RsbuildConfig['dev']>, 'writeToDisk'>;
     output?: Pick<NonNullable<RsbuildConfig['output']>, 'cssModules' | 'externals' | 'cleanDistPath' | 'module'>;
     resolve?: RsbuildConfig['resolve'];
@@ -2980,11 +2977,12 @@ export declare interface RstestUtilities {
      */
     resetModules: () => RstestUtilities;
     /**
-     * Changes the value of environmental variable on `process.env`.
+     * Changes the value of an environment variable in the current runtime env store.
+     * Uses `process.env` in Node.js and runtime env store in browser mode.
      */
     stubEnv: (name: string, value: string | undefined) => RstestUtilities;
     /**
-     * Restores all `process.env` values that were changed with `rstest.stubEnv`.
+     * Restores all env values that were changed with `rstest.stubEnv`.
      */
     unstubAllEnvs: () => RstestUtilities;
     /**
@@ -3036,9 +3034,20 @@ export declare interface RstestUtilities {
      * Removes all timers that are scheduled to run.
      */
     clearAllTimers: () => RstestUtilities;
+    /**
+     * Retry callback until it succeeds (doesn't throw) or timeout is reached.
+     * If timeout is reached, throws the last error from the callback.
+     */
+    waitFor: <T>(callback: WaitForCallback<T>, options?: number | WaitForOptions) => Promise<T>;
+    /**
+     * Retry callback until it returns a truthy value or timeout is reached.
+     * If callback throws, it interrupts immediately and throws that error.
+     * If timeout is reached, throws an error.
+     */
+    waitUntil: <T>(callback: () => MaybePromise<T>, options?: number | WaitUntilOptions) => Promise<T>;
 }
 
-export declare function runCLI(): Promise<void>;
+export declare function runCLI(): void;
 
 declare type RunnerAPI = {
     describe: Describe;
@@ -3253,23 +3262,6 @@ declare interface SyncExpectationResult {
     	expected?: any;
 }
 
-declare interface TaskResult {
-    /**
-     * State of the task. Inherits the `task.mode` during collection.
-     * When the task has finished, it will be changed to `pass` or `fail`.
-     * - **pass**: task ran successfully
-     * - **fail**: task failed
-     */
-    state: TaskState;
-    /**
-     * Errors that occurred during the task execution. It is possible to have several errors
-     * if `expect.soft()` failed multiple times or `retry` was triggered.
-     */
-    errors?: FormattedError[];
-}
-
-declare type TaskState = 'pass' | 'fail';
-
 declare interface TeamcityOptions extends FileOptions {
     blockName: string;
 }
@@ -3278,8 +3270,6 @@ declare type Test = (arg0: any) => boolean;
 
 export declare const test: Rstest['test'];
 
-declare type Test_2 = TestSuite | TestCase;
-
 declare type TestAPI<ExtraContext = object> = TestFn<ExtraContext> & {
     each: TestEachFn;
     for: TestForFn<ExtraContext>;
@@ -3301,34 +3291,6 @@ declare type TestAPIs<ExtraContext = object> = TestAPI<ExtraContext> & {
 
 declare type TestCallbackFn<ExtraContext = object> = (context: TestContext & ExtraContext) => MaybePromise<void>;
 
-declare type TestCase = TestCaseInfo & {
-    originalFn?: (context: TestContext) => void | Promise<void>;
-    fn?: (context: TestContext) => void | Promise<void>;
-    runMode: TestRunMode;
-    fails?: boolean;
-    each?: boolean;
-    fixtures?: NormalizedFixtures;
-    concurrent?: boolean;
-    sequential?: boolean;
-    inTestEach?: boolean;
-    context: TestContext;
-    only?: boolean;
-    onFinished: OnTestFinishedHandler[];
-    onFailed: OnTestFailedHandler[];
-    /**
-     * Store promises (from async expects) to wait for them before finishing the test
-     */
-    promises?: Promise<any>[];
-    /**
-     * Store stack trace error created when test is registered, used for trace original position
-     */
-    stackTraceError: Error;
-    /**
-     * Result of the task. if `expect.soft()` failed multiple times or `retry` was triggered.
-     */
-    result?: TaskResult;
-};
-
 export declare type TestCaseInfo = {
     testId: string;
     testPath: TestPath;
@@ -3340,6 +3302,7 @@ export declare type TestCaseInfo = {
     /** Only included when `includeTaskLocation` config is enabled */
     location?: Location_2;
     type: 'case';
+    runMode: TestRunMode;
 };
 
 declare type TestContext = {
@@ -3377,7 +3340,7 @@ export declare type TestFileInfo = {
 export declare type TestFileResult = TestResult & {
     results: TestResult[];
     snapshotResult?: SnapshotResult;
-    coverage?: CoverageMapData;
+    coverage?: Record<string, FileCoverageData>;
 };
 
 declare type TestFn<ExtraContext = object> = (description: string, fn?: TestCallbackFn<ExtraContext>, timeout?: number) => void;
@@ -3425,20 +3388,6 @@ declare class TestStateManager {
     reset(): void;
 }
 
-declare type TestSuite = TestSuiteInfo & {
-    runMode: TestRunMode;
-    each?: boolean;
-    inTestEach?: boolean;
-    concurrent?: boolean;
-    sequential?: boolean;
-    /** nested cases and suite could in a suite */
-    tests: Test_2[];
-    afterAllListeners?: AfterAllListener[];
-    beforeAllListeners?: BeforeAllListener[];
-    afterEachListeners?: AfterEachListener[];
-    beforeEachListeners?: BeforeEachListener[];
-};
-
 export declare type TestSuiteInfo = {
     testId: string;
     name: string;
@@ -3448,6 +3397,7 @@ export declare type TestSuiteInfo = {
     type: 'suite';
     /** Only included when `includeTaskLocation` config is enabled */
     location?: Location_2;
+    runMode: TestRunMode;
 };
 
 declare type TextLcovOptions = ProjectOptions;
@@ -3528,6 +3478,18 @@ declare type VitestAssertion<
 	T
 > = { [K in keyof A] : A[K] extends Chai.Assertion ? Assertion_2<T> : A[K] extends (...args: any[]) => any ? A[K] : VitestAssertion<A[K], T> } & ((type: string, message?: string) => Assertion_2);
 
+declare type WaitForCallback<T> = () => MaybePromise<T>;
+
+declare interface WaitForOptions {
+    timeout?: number;
+    interval?: number;
+}
+
+declare interface WaitUntilOptions {
+    timeout?: number;
+    interval?: number;
+}
+
 declare type Watermark = [number, number];
 
 declare interface Watermarks {

package/dist/mockRuntimeCode.js

@@ -40,7 +40,9 @@ __webpack_require__.rstest_require_actual = __webpack_require__.rstest_import_ac
     }
     return __webpack_require__(id);
 };
-const getMockImplementation = (mockType = 'mock')=>(id, modFactory)=>{
+const getMockImplementation = (mockType = 'mock')=>{
+    const isMockRequire = 'mockRequire' === mockType || 'doMockRequire' === mockType;
+    return (id, modFactory)=>{
         let requiredModule = __webpack_module_cache__[id]?.exports;
         const wasAlreadyLoaded = !!requiredModule;
         if (requiredModule) {
@@ -66,7 +68,11 @@ const getMockImplementation = (mockType = 'mock')=>(id, modFactory)=>{
             const mockedModule = globalThis.RSTEST_API?.rstest?.mockObject(originalModule, {
                 spy: isSpy
             }) || originalModule;
-            const finalModFactory = function(__unused_webpack_module, __webpack_exports__, __webpack_require__1) {
+            const finalModFactory = function(__webpack_module__, __webpack_exports__, __webpack_require__1) {
+                if (isMockRequire) {
+                    __webpack_module__.exports = mockedModule;
+                    return;
+                }
                 __webpack_require__1.r(__webpack_exports__);
                 for(const key in mockedModule)__webpack_require__1.d(__webpack_exports__, {
                     [key]: ()=>mockedModule[key]
@@ -83,9 +89,13 @@ const getMockImplementation = (mockType = 'mock')=>(id, modFactory)=>{
             exports: __webpack_require__(modFactory)
         };
         else if ('function' == typeof modFactory) {
-            const finalModFactory = function(__unused_webpack_module, __webpack_exports__, __webpack_require__1) {
-                __webpack_require__1.r(__webpack_exports__);
+            const finalModFactory = function(__webpack_module__, __webpack_exports__, __webpack_require__1) {
                 const res = modFactory();
+                if (isMockRequire) {
+                    __webpack_module__.exports = res;
+                    return;
+                }
+                __webpack_require__1.r(__webpack_exports__);
                 for(const key in res)__webpack_require__1.d(__webpack_exports__, {
                     [key]: ()=>res[key]
                 });
@@ -94,6 +104,7 @@ const getMockImplementation = (mockType = 'mock')=>(id, modFactory)=>{
             delete __webpack_module_cache__[id];
         }
     };
+};
 __webpack_require__.rstest_mock = getMockImplementation('mock');
 __webpack_require__.rstest_mock_require = getMockImplementation('mockRequire');
 __webpack_require__.rstest_do_mock = getMockImplementation('doMock');