@rstest/core 0.8.0 → 0.8.1

package/dist/index.d.ts

@@ -359,6 +359,17 @@ declare type CommonOptions = {
     config?: string;
     configLoader?: LoadConfigOptions['loader'];
     globals?: boolean;
+    /**
+     * Pool options.
+     * - `string`: shorthand for `{ type: string }` (from `--pool` flag)
+     * - `object`: detailed pool config (from `--pool.*` options)
+     */
+    pool?: string | {
+        type?: string;
+        maxWorkers?: string | number;
+        minWorkers?: string | number;
+        execArgv?: string[] | string;
+    };
     /**
      * Browser mode options.
      * - `boolean`: shorthand for `{ enabled: boolean }` (from `--browser` flag)
@@ -422,6 +433,8 @@ declare interface Constructable {
     	new (...args: any[]): any;
 }
 
+declare type Constructor<T = any> = new (...args: any[]) => T;
+
 /**
  * Base class for writing content
  */
@@ -1650,12 +1663,22 @@ declare interface MatcherState_2 extends MatcherState {
     snapshotState: SnapshotState;
 }
 
+declare type MaybeMockedDeep<T> = T extends Constructor ? MockedClass<T> : T extends MockProcedure ? MockedFunctionDeep<T> : T extends object ? MockedObjectDeep<T> : T;
+
+declare type MaybePartiallyMocked<T> = T extends Constructor ? MockedClass<T> : T extends MockProcedure ? MockedFunction<T> : T extends object ? MockedObject<T> : T;
+
+declare type MaybePartiallyMockedDeep<T> = T extends Constructor ? MockedClass<T> : T extends MockProcedure ? MockedFunctionDeep<T> : T extends object ? MockedObjectDeep<T> : T;
+
 declare type MaybePromise<T> = T | Promise<T>;
 
 export declare const mergeProjectConfig: (...configs: ProjectConfig[]) => ProjectConfig;
 
 export declare const mergeRstestConfig: (...configs: RstestConfig[]) => RstestConfig;
 
+declare type Methods<T> = {
+    [K in keyof T]: T[K] extends MockProcedure ? K : never;
+}[keyof T];
+
 export declare interface Mock<T extends FunctionLike = FunctionLike> extends MockInstance_2<T> {
     new (...args: Parameters<T>): ReturnType<T>;
     (...args: Parameters<T>): ReturnType<T>;
@@ -1804,6 +1827,31 @@ declare type MockContext_2<T extends FunctionLike = FunctionLike> = {
     settledResults: MockSettledResult_2<Awaited<ReturnType<T>>>[];
 };
 
+export declare type Mocked<T> = T extends Constructor ? MockedClass<T> : T extends MockProcedure ? MockedFunction<T> : T extends object ? MockedObject<T> : T;
+
+declare type MockedClass<T extends Constructor> = Mock<(...args: ConstructorParameters<T>) => InstanceType<T>> & {
+    new (...args: ConstructorParameters<T>): InstanceType<T>;
+    prototype: InstanceType<T>;
+};
+
+declare type MockedFunction<T extends MockProcedure> = Mock<T> & {
+    [K in keyof T]: T[K];
+};
+
+declare type MockedFunctionDeep<T extends MockProcedure> = Mock<T> & MockedObjectDeep<T>;
+
+declare type MockedObject<T> = {
+    [K in Methods<T>]: T[K] extends MockProcedure ? MockedFunction<T[K]> : T[K];
+} & {
+    [K in Properties<T>]: T[K];
+};
+
+declare type MockedObjectDeep<T> = {
+    [K in Methods<T>]: T[K] extends MockProcedure ? MockedFunctionDeep<T[K]> : T[K];
+} & {
+    [K in Properties<T>]: MaybeMockedDeep<T[K]>;
+};
+
 declare type MockFactory<T = unknown> = () => MaybePromise<Partial<T>>;
 
 declare type MockFn = <T extends FunctionLike = FunctionLike>(fn?: T) => Mock<T>;
@@ -2030,6 +2078,37 @@ declare interface MockInstance_2<T extends FunctionLike = FunctionLike> {
     mockRejectedValueOnce(error: unknown): this;
 }
 
+/**
+ * Options for rs.mock module mocking.
+ * Supports `{ spy: true }` or `{ mock: true }`.
+ */
+declare type MockModuleOptions = {
+    /**
+     * If `true`, the module will be auto-mocked but the original implementations
+     * will be preserved - all exports will be wrapped in spy functions that track calls.
+     */
+    spy: true;
+} | {
+    /**
+     * If `true`, the module will be auto-mocked with all exports replaced by mock functions.
+     * Original implementations will NOT be preserved.
+     */
+    mock: true;
+};
+
+/**
+ * Options for mockObject
+ */
+declare interface MockOptions {
+    /**
+     * If `true`, the original implementation will be kept.
+     * All methods will call the original implementation, but you can still track the calls.
+     */
+    spy?: boolean;
+}
+
+declare type MockProcedure = (...args: any[]) => any;
+
 declare type MockResult<T> = MockResultReturn<T> | MockResultThrow | MockResultIncomplete;
 
 declare type MockResult_2<T> = MockResultReturn_2<T> | MockResultThrow_2 | MockResultIncomplete_2;
@@ -2273,6 +2352,10 @@ declare type PromisifyAssertion<T> = Promisify<Assertion_2<T>>;
 
 declare type PromisifyAssertion_2<T> = Promisify_2<Assertion<T>>;
 
+declare type Properties<T> = {
+    [K in keyof T]: T[K] extends MockProcedure ? never : K;
+}[keyof T];
+
 declare interface Range_2 {
     start: Location_3;
     end: Location_3;
@@ -2712,6 +2795,74 @@ export declare interface RstestUtilities {
      * Determines if the given function is a mocked function.
      */
     isMockFunction: (fn: any) => fn is MockInstance_2;
+    /**
+     * Deeply mocks properties and methods of a given object
+     * in the same way as `rstest.mock()` mocks module exports.
+     *
+     * @example
+     * ```ts
+     * const original = {
+     *   simple: () => 'value',
+     *   nested: {
+     *     method: () => 'real'
+     *   },
+     *   prop: 'foo',
+     * }
+     *
+     * const mocked = rstest.mockObject(original)
+     * expect(mocked.simple()).toBe(undefined)
+     * expect(mocked.nested.method()).toBe(undefined)
+     * expect(mocked.prop).toBe('foo')
+     *
+     * mocked.simple.mockReturnValue('mocked')
+     * expect(mocked.simple()).toBe('mocked')
+     *
+     * // With spy option to keep original implementations
+     * const spied = rstest.mockObject(original, { spy: true })
+     * expect(spied.simple()).toBe('value')
+     * expect(spied.simple).toHaveBeenCalled()
+     * ```
+     *
+     * @param value - The object to be mocked
+     * @param options - Mock options
+     * @returns A deeply mocked version of the input object
+     */
+    mockObject: <T>(value: T, options?: MockOptions) => MaybeMockedDeep<T>;
+    /**
+     * Type helper for TypeScript. Just returns the object that was passed.
+     *
+     * When `partial` is `true` it will expect a `Partial<T>` as a return value.
+     * By default, this will only make TypeScript believe that the first level values are mocked.
+     * You can pass down `{ deep: true }` as a second argument to tell TypeScript
+     * that the whole object is mocked, if it actually is.
+     *
+     * @example
+     * ```ts
+     * import example from './example.js'
+     *
+     * rstest.mock('./example.js')
+     *
+     * test('1 + 1 equals 10', async () => {
+     *   rstest.mocked(example.calc).mockReturnValue(10)
+     *   expect(example.calc(1, '+', 1)).toBe(10)
+     * })
+     * ```
+     * @param item - Anything that can be mocked
+     * @returns The same item with mocked type
+     */
+    mocked: (<T>(item: T, deep?: false) => Mocked<T>) & (<T>(item: T, deep: true) => MaybeMockedDeep<T>) & (<T>(item: T, options: {
+        partial?: false;
+        deep?: false;
+    }) => Mocked<T>) & (<T>(item: T, options: {
+        partial?: false;
+        deep: true;
+    }) => MaybeMockedDeep<T>) & (<T>(item: T, options: {
+        partial: true;
+        deep?: false;
+    }) => MaybePartiallyMocked<T>) & (<T>(item: T, options: {
+        partial: true;
+        deep: true;
+    }) => MaybePartiallyMockedDeep<T>);
     /**
      * Calls `.mockClear()` on all spies.
      */
@@ -2725,21 +2876,37 @@ export declare interface RstestUtilities {
      */
     restoreAllMocks: () => RstestUtilities;
     /**
-     * Mock a module
+     * Mock a module.
+     *
+     * When called with a factory function, the module will be replaced with the return value of the factory.
+     * When called with `{ spy: true }`, the module will be auto-mocked but the original implementations
+     * will be preserved - all exports will be wrapped in spy functions that track calls.
+     *
+     * @example
+     * ```ts
+     * // Replace module with factory
+     * rs.mock('./module', () => ({ fn: rs.fn() }))
+     *
+     * // Auto-mock with spy mode - keeps original implementations
+     * rs.mock('./module', { spy: true })
+     * ```
      */
-    mock<T = unknown>(moduleName: string | Promise<T>, moduleFactory?: MockFactory<T>): void;
+    mock<T = unknown>(moduleName: string | Promise<T>, factoryOrOptions?: MockFactory<T> | MockModuleOptions): void;
     /**
-     * Mock a module
+     * Mock a module (CommonJS require)
      */
-    mockRequire: <T = unknown>(moduleName: string, moduleFactory?: () => T) => void;
+    mockRequire: <T = unknown>(moduleName: string, factoryOrOptions?: (() => T) | MockModuleOptions) => void;
     /**
      * Mock a module, not hoisted.
+     *
+     * When called with `{ spy: true }`, the module will be auto-mocked but the original implementations
+     * will be preserved - all exports will be wrapped in spy functions that track calls.
      */
-    doMock<T = unknown>(moduleName: string | Promise<T>, moduleFactory?: MockFactory<T>): void;
+    doMock<T = unknown>(moduleName: string | Promise<T>, factoryOrOptions?: MockFactory<T> | MockModuleOptions): void;
     /**
-     * Mock a module, not hoisted.
+     * Mock a module, not hoisted (CommonJS require).
      */
-    doMockRequire: <T = unknown>(moduleName: string, moduleFactory?: () => T) => void;
+    doMockRequire: <T = unknown>(moduleName: string, factoryOrOptions?: (() => T) | MockModuleOptions) => void;
     /**
      * Hoisted mock function.
      */

package/dist/mockRuntimeCode.js

@@ -39,6 +39,32 @@ __webpack_require__.rstest_mock = (id, modFactory)=>{
         __webpack_require__.rstest_original_modules[id] = requiredModule;
         __webpack_require__.rstest_original_module_factories[id] = __webpack_modules__[id];
     }
+    if (modFactory && 'object' == typeof modFactory) {
+        const isSpy = true === modFactory.spy;
+        const isMock = true === modFactory.mock;
+        if (!isSpy && !isMock) throw new Error('[Rstest] rs.mock() options must be { spy: true } or { mock: true }');
+        if (!requiredModule) {
+            const optionName = isSpy ? 'spy' : 'mock';
+            throw new Error(`[Rstest] rs.mock('${id}', { ${optionName}: true }) failed: cannot load original module`);
+        }
+        const originalModule = requiredModule;
+        const isEsModule = true === originalModule.__esModule;
+        const mockedModule = globalThis.RSTEST_API?.rstest?.mockObject(originalModule, {
+            spy: isSpy
+        }) || originalModule;
+        const finalModFactory = function(__unused_webpack_module, __webpack_exports__, __webpack_require__1) {
+            __webpack_require__1.r(__webpack_exports__);
+            for(const key in mockedModule)__webpack_require__1.d(__webpack_exports__, {
+                [key]: ()=>mockedModule[key]
+            });
+            if (!isEsModule && !('default' in mockedModule)) __webpack_require__1.d(__webpack_exports__, {
+                default: ()=>mockedModule
+            });
+        };
+        __webpack_modules__[id] = finalModFactory;
+        delete __webpack_module_cache__[id];
+        return;
+    }
     if ('string' == typeof modFactory || 'number' == typeof modFactory) __webpack_module_cache__[id] = {
         exports: __webpack_require__(modFactory)
     };
@@ -62,6 +88,28 @@ __webpack_require__.rstest_mock_require = (id, modFactory)=>{
         __webpack_require__.rstest_original_modules[id] = requiredModule;
         __webpack_require__.rstest_original_module_factories[id] = __webpack_modules__[id];
     }
+    if (modFactory && 'object' == typeof modFactory) {
+        const isSpy = true === modFactory.spy;
+        const isMock = true === modFactory.mock;
+        if (!isSpy && !isMock) throw new Error('[Rstest] rs.mockRequire() options must be { spy: true } or { mock: true }');
+        if (!requiredModule) {
+            const optionName = isSpy ? 'spy' : 'mock';
+            throw new Error(`[Rstest] rs.mockRequire('${id}', { ${optionName}: true }) failed: cannot load original module`);
+        }
+        const originalModule = requiredModule;
+        const isEsModule = true === originalModule.__esModule;
+        const mockedModule = globalThis.RSTEST_API?.rstest?.mockObject(originalModule, {
+            spy: isSpy
+        }) || originalModule;
+        if (isEsModule) __webpack_require__.r(mockedModule);
+        else if (!('default' in mockedModule)) mockedModule.default = mockedModule;
+        __webpack_module_cache__[id] = {
+            exports: mockedModule,
+            id,
+            loaded: true
+        };
+        return;
+    }
     if ('string' == typeof modFactory || 'number' == typeof modFactory) __webpack_module_cache__[id] = {
         exports: __webpack_require__(modFactory)
     };
@@ -83,6 +131,28 @@ __webpack_require__.rstest_do_mock = (id, modFactory)=>{
         __webpack_require__.rstest_original_modules[id] = requiredModule;
         __webpack_require__.rstest_original_module_factories[id] = __webpack_modules__[id];
     }
+    if (modFactory && 'object' == typeof modFactory) {
+        const isSpy = true === modFactory.spy;
+        const isMock = true === modFactory.mock;
+        if (!isSpy && !isMock) throw new Error('[Rstest] rs.doMock() options must be { spy: true } or { mock: true }');
+        if (!requiredModule) {
+            const optionName = isSpy ? 'spy' : 'mock';
+            throw new Error(`[Rstest] rs.doMock('${id}', { ${optionName}: true }) failed: cannot load original module`);
+        }
+        const originalModule = requiredModule;
+        const isEsModule = true === originalModule.__esModule;
+        const mockedModule = globalThis.RSTEST_API?.rstest?.mockObject(originalModule, {
+            spy: isSpy
+        }) || originalModule;
+        if (isEsModule) __webpack_require__.r(mockedModule);
+        else if (!('default' in mockedModule)) mockedModule.default = mockedModule;
+        __webpack_module_cache__[id] = {
+            exports: mockedModule,
+            id,
+            loaded: true
+        };
+        return;
+    }
     if ('string' == typeof modFactory || 'number' == typeof modFactory) __webpack_module_cache__[id] = {
         exports: __webpack_require__(modFactory)
     };
@@ -104,6 +174,28 @@ __webpack_require__.rstest_do_mock_require = (id, modFactory)=>{
         __webpack_require__.rstest_original_modules[id] = requiredModule;
         __webpack_require__.rstest_original_module_factories[id] = __webpack_modules__[id];
     }
+    if (modFactory && 'object' == typeof modFactory) {
+        const isSpy = true === modFactory.spy;
+        const isMock = true === modFactory.mock;
+        if (!isSpy && !isMock) throw new Error('[Rstest] rs.doMockRequire() options must be { spy: true } or { mock: true }');
+        if (!requiredModule) {
+            const optionName = isSpy ? 'spy' : 'mock';
+            throw new Error(`[Rstest] rs.doMockRequire('${id}', { ${optionName}: true }) failed: cannot load original module`);
+        }
+        const originalModule = requiredModule;
+        const isEsModule = true === originalModule.__esModule;
+        const mockedModule = globalThis.RSTEST_API?.rstest?.mockObject(originalModule, {
+            spy: isSpy
+        }) || originalModule;
+        if (isEsModule) __webpack_require__.r(mockedModule);
+        else if (!('default' in mockedModule)) mockedModule.default = mockedModule;
+        __webpack_module_cache__[id] = {
+            exports: mockedModule,
+            id,
+            loaded: true
+        };
+        return;
+    }
     if ('string' == typeof modFactory || 'number' == typeof modFactory) __webpack_module_cache__[id] = {
         exports: __webpack_require__(modFactory)
     };

package/dist/rslib-runtime.js

@@ -29,33 +29,6 @@ __webpack_require__.m = __webpack_modules__;
         return getter;
     };
 })();
-(()=>{
-    var getProto = Object.getPrototypeOf ? (obj)=>Object.getPrototypeOf(obj) : (obj)=>obj.__proto__;
-    var leafPrototypes;
-    __webpack_require__.t = function(value, mode) {
-        if (1 & mode) value = this(value);
-        if (8 & mode) return value;
-        if ('object' == typeof value && value) {
-            if (4 & mode && value.__esModule) return value;
-            if (16 & mode && 'function' == typeof value.then) return value;
-        }
-        var ns = Object.create(null);
-        __webpack_require__.r(ns);
-        var def = {};
-        leafPrototypes = leafPrototypes || [
-            null,
-            getProto({}),
-            getProto([]),
-            getProto(getProto)
-        ];
-        for(var current = 2 & mode && value; ('object' == typeof current || 'function' == typeof current) && !~leafPrototypes.indexOf(current); current = getProto(current))Object.getOwnPropertyNames(current).forEach((key)=>{
-            def[key] = ()=>value[key];
-        });
-        def['default'] = ()=>value;
-        __webpack_require__.d(ns, def);
-        return ns;
-    };
-})();
 (()=>{
     __webpack_require__.d = (exports, definition)=>{
         for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {

package/dist/worker.js

@@ -1,7 +1,7 @@
 import 'module';
 /*#__PURE__*/ import.meta.url;
 import { __webpack_require__ } from "./rslib-runtime.js";
-import { basename, isAbsolute, undoSerializableConfig, dirname, resolve as pathe_M_eThtNZ_resolve, join } from "./2672.js";
+import { basename, isAbsolute, undoSerializableConfig, dirname, color, resolve as pathe_M_eThtNZ_resolve, join } from "./3160.js";
 import "./487.js";
 import { node_v8, createBirpc } from "./3216.js";
 import { createCoverageProvider } from "./5734.js";
@@ -106,8 +106,6 @@ class RstestSnapshotEnvironment extends NodeSnapshotEnvironment {
     }
 }
 const source_map_support = __webpack_require__("../../node_modules/.pnpm/source-map-support@0.5.21/node_modules/source-map-support/source-map-support.js");
-const picocolors = __webpack_require__("../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js");
-var picocolors_default = /*#__PURE__*/ __webpack_require__.n(picocolors);
 let sourceMaps = {};
 (0, source_map_support.install)({
     environment: 'node',
@@ -185,7 +183,7 @@ const preparePool = async ({ entryInfo: { distPath, testPath }, updateSnapshot,
         const error = 'string' == typeof e ? new Error(e) : e;
         error.name = type;
         if (isTeardown) {
-            error.stack = `${picocolors_default().yellow('Caught error after test environment was torn down:')}\n\n${error.stack}`;
+            error.stack = `${color.yellow('Caught error after test environment was torn down:')}\n\n${error.stack}`;
             console.error(error);
         } else {
             console.error(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rstest/core",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "The Rsbuild-based test tool.",
   "bugs": {
     "url": "https://github.com/web-infra-dev/rstest/issues"
@@ -60,6 +60,7 @@
   },
   "devDependencies": {
     "@babel/code-frame": "^7.27.1",
+    "@clack/prompts": "^0.10.1",
     "@jridgewell/trace-mapping": "0.3.31",
     "@microsoft/api-extractor": "^7.55.2",
     "@rsbuild/plugin-node-polyfill": "^1.3.0",
@@ -72,8 +73,6 @@
     "@types/jsdom": "^21.1.7",
     "@types/picomatch": "^4.0.2",
     "@types/sinonjs__fake-timers": "^8.1.5",
-    "@clack/prompts": "^0.10.1",
-    "@vercel/detect-agent": "^1.0.0",
     "@types/source-map-support": "^0.5.10",
     "@vitest/expect": "^3.2.4",
     "@vitest/snapshot": "^3.2.4",