@unrift/core 0.2.1 → 0.4.0

package/bin/unrift.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 "use strict";
 
-// Run the real CLI
+// Run the real CLI. The CLI installs the module-mock loader itself
+// (see src/mock/register-loader.ts), so this bin stays a thin entry point.
 await import("../dist/esm/cli.js");

package/dist/esm/cli.js

@@ -2,7 +2,13 @@
 import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { runTestsCLI } from "./runner.js";
+import { registerModuleLoader } from "./mock/register-loader.js";
+import { runTestsCLI, watchTestsCLI } from "./runner.js";
+import { safeRegExp } from "./utils/helpers.js";
+// Install the module-mock loader before any test file is imported. Both the
+// core bin and the unrift wrapper bin run this CLI, so this is the single
+// place module mocking is bootstrapped.
+registerModuleLoader();
 const __cliDir = dirname(fileURLToPath(import.meta.url));
 function readVersion() {
     // Walk up from current file to find package.json (works from both src/ and dist/esm/)
@@ -21,15 +27,6 @@ function readVersion() {
     return "0.0.0";
 }
 const version = readVersion();
-function safeRegExp(source) {
-    try {
-        return new RegExp(source);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`Invalid pattern regex "${source}": ${msg}`);
-    }
-}
 function printHelp() {
     console.log(`
 Unrift Test Runner v${version}
@@ -41,6 +38,7 @@ Options:
   -c, --config <path>      Path to config file
   -b, --bail               Stop on first test failure
   -t, --timeout <ms>       Default test timeout in milliseconds
+  -w, --watch              Re-run tests on file changes
   -d, --debug              Enable debug logging
   -l, --list               List discovered test files
   -j, --json               Output test results as JSON
@@ -53,6 +51,7 @@ Examples:
   unrift math
   unrift -c test/config.ts --bail
   unrift --timeout 10000
+  unrift --watch
 `);
 }
 function parseArgs(argv) {
@@ -66,6 +65,7 @@ function parseArgs(argv) {
     let list = false;
     let json = false;
     let cacheClean = false;
+    let watch = false;
     const rest = [];
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
@@ -111,6 +111,10 @@ function parseArgs(argv) {
             i++;
             continue;
         }
+        if (a === "--watch" || a === "-w") {
+            watch = true;
+            continue;
+        }
         if (a === "--cache-clean" || a === "--clear-cache") {
             cacheClean = true;
             continue;
@@ -129,11 +133,12 @@ function parseArgs(argv) {
         list,
         json,
         cacheClean,
+        watch,
         help,
         showVersion,
     };
 }
-const { configPath, pattern, timeoutMs, bail, debug, list, json, cacheClean, help, showVersion, } = parseArgs(process.argv.slice(2));
+const { configPath, pattern, timeoutMs, bail, debug, list, json, cacheClean, watch, help, showVersion, } = parseArgs(process.argv.slice(2));
 if (showVersion) {
     console.log(version);
     process.exit(0);
@@ -142,7 +147,7 @@ if (help) {
     printHelp();
     process.exit(0);
 }
-runTestsCLI({
+const runOpts = {
     pattern,
     configPath,
     timeoutMs,
@@ -151,7 +156,8 @@ runTestsCLI({
     list,
     json,
     cacheClean,
-}).catch((err) => {
+};
+(watch ? watchTestsCLI(runOpts) : runTestsCLI(runOpts)).catch((err) => {
     console.error(err);
     process.exit(1);
 });

package/dist/esm/context.d.ts

@@ -4,10 +4,9 @@ export declare enum RunState {
     Run = "run",
     Idle = "idle"
 }
-type UnriftState = RunState;
 interface UnriftGlobalContext {
     currentSuite: Suite | null;
-    state: UnriftState;
+    state: RunState;
 }
 export declare const unriftGlobalContext: UnriftGlobalContext;
 export declare function assertRegisterState(apiName: string): void;

package/dist/esm/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oBAAY,QAAQ;IAClB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,KAAK,WAAW,GAAG,QAAQ,CAAC;AAE5B,UAAU,mBAAmB;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,mBAGjC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,QAOlD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oBAAY,QAAQ;IAClB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,UAAU,mBAAmB;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,mBAGjC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,QAOlD"}

package/dist/esm/expect.d.ts

@@ -13,13 +13,33 @@ export interface Matchers<T> {
     toBeUndefined(): void | Promise<void>;
     toBeGreaterThan(expected: number): void | Promise<void>;
     toBeLessThan(expected: number): void | Promise<void>;
-    toBeInstanceOf(expected: new (...args: unknown[]) => unknown): void | Promise<void>;
+    toBeInstanceOf(expected: {
+        prototype: unknown;
+    }): void | Promise<void>;
     toContain(expected: unknown): void | Promise<void>;
     toEqual(expected: unknown): void | Promise<void>;
     toHaveLength(expected: number): void | Promise<void>;
     toMatch(expected: RegExp | string): void | Promise<void>;
     toStrictEqual(expected: unknown): void | Promise<void>;
     toThrow(expected?: unknown): void | Promise<void>;
+    toBeGreaterThanOrEqual(expected: number): void | Promise<void>;
+    toBeLessThanOrEqual(expected: number): void | Promise<void>;
+    toBeNaN(): void | Promise<void>;
+    toBeFinite(): void | Promise<void>;
+    toMatchObject(expected: Record<string, unknown>): void | Promise<void>;
+    toHaveProperty(path: string | readonly string[], value?: unknown): void | Promise<void>;
+    toHaveBeenCalled(): void | Promise<void>;
+    toHaveBeenCalledTimes(expected: number): void | Promise<void>;
+    toHaveBeenCalledWith(...args: unknown[]): void | Promise<void>;
+    toHaveBeenLastCalledWith(...args: unknown[]): void | Promise<void>;
+    toHaveBeenNthCalledWith(n: number, ...args: unknown[]): void | Promise<void>;
+    toHaveReturned(): void | Promise<void>;
+    toHaveReturnedTimes(expected: number): void | Promise<void>;
+    toHaveReturnedWith(expected: unknown): void | Promise<void>;
+    toHaveLastReturnedWith(expected: unknown): void | Promise<void>;
+    toHaveNthReturnedWith(n: number, expected: unknown): void | Promise<void>;
+    toHaveFetched(urlOrMatcher: string | RegExp | ((req: Request) => boolean)): void | Promise<void>;
+    toHaveFetchedTimes(expected: number): void | Promise<void>;
     readonly not: Matchers<T>;
     readonly resolves: Matchers<Awaited<T>>;
     readonly rejects: Matchers<unknown>;

package/dist/esm/expect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1D,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,QAErD;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,WAAW,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CACZ,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAC5C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrC;AAID,MAAM,WAAW,QAAQ,CAAC,CAAC;CAAI;AAE/B,MAAM,WAAW,eAAe;IAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,MAAM,EAAE,eAsGjB,CAAC"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -4,5 +4,8 @@ export { describe, it, test } from "./interface";
 export { expect, extendMatchers } from "./expect";
 export type { Matchers, ExpectInterface } from "./expect";
 export type { MatcherContext, MatcherFn, MatcherMap, Promisable, } from "./types";
+export { runEngine } from "./run";
 export type { RunEngineResult } from "./run";
+export { mock, spy, spyOn, isSpy, mockObject, mockClass, stub, mockGlobal, mockFetch, mockFetchOnce, useFakeTimers, useRealTimers, advanceTimersByTime, advanceTimersByTimeAsync, runAllTimers, runAllTimersAsync, runOnlyPendingTimers, runOnlyPendingTimersAsync, getTimerCount, setSystemTime, getRealSystemTime, doMock, unmock, listMockedSpecs, fromModule, mockFs, clearAllMocks, resetAllMocks, restoreAllMocks, } from "./mock/index";
+export type { Spy, MockState, MockResult, MockFetch, FetchMatcher, MockResponseInit, MockFetchResponse, UseFakeTimersOptions, FakeableApi, LoaderMessage, FakeFsHandle, FakeFsState, } from "./mock/index";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EACL,IAAI,EACJ,GAAG,EACH,KAAK,EACL,KAAK,EACL,UAAU,EACV,SAAS,EACT,IAAI,EACJ,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,eAAe,EACf,UAAU,EACV,MAAM,EACN,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/esm/index.js

@@ -2,3 +2,6 @@ export { beforeEach, afterEach, beforeAll, afterAll } from "./hooks.js";
 export { defineConfig } from "./utils/defineConfig.js";
 export { describe, it, test } from "./interface.js";
 export { expect, extendMatchers } from "./expect.js";
+export { runEngine } from "./run.js";
+// Mocking suite
+export { mock, spy, spyOn, isSpy, mockObject, mockClass, stub, mockGlobal, mockFetch, mockFetchOnce, useFakeTimers, useRealTimers, advanceTimersByTime, advanceTimersByTimeAsync, runAllTimers, runAllTimersAsync, runOnlyPendingTimers, runOnlyPendingTimersAsync, getTimerCount, setSystemTime, getRealSystemTime, doMock, unmock, listMockedSpecs, fromModule, mockFs, clearAllMocks, resetAllMocks, restoreAllMocks, } from "./mock/index.js";

package/dist/esm/interface.d.ts

@@ -9,9 +9,9 @@ type DescribeFn = {
     todo: (description: string) => void;
 };
 type ItFn = {
-    (description: string, fn: PromisableFn<void>): void;
-    only: (description: string, fn: PromisableFn<void>) => void;
-    skip: (description: string, fn: PromisableFn<void>) => void;
+    (description: string, fn: PromisableFn<void>, timeoutMs?: number): void;
+    only: (description: string, fn: PromisableFn<void>, timeoutMs?: number) => void;
+    skip: (description: string, fn: PromisableFn<void>, timeoutMs?: number) => void;
     todo: (description: string) => void;
 };
 declare const describe: DescribeFn;

package/dist/esm/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/interface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,SAAS,CAAC;AAEtD;;GAEG;AAEH,KAAK,UAAU,GAAG;IAChB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAmBF,QAAA,MAAM,QAAQ,EAAE,UAC8B,CAAC;AAc/C,QAAA,MAAM,EAAE,EAAE,IAAkE,CAAC;AAK7E,QAAA,MAAM,IAAI,EAAE,IAAS,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/interface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,SAAS,CAAC;AAEtD;;GAEG;AAEH,KAAK,UAAU,GAAG;IAChB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxE,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AA6BF,QAAA,MAAM,QAAQ,EAAE,UAC8B,CAAC;AAmB/C,QAAA,MAAM,EAAE,EAAE,IACyC,CAAC;AAOpD,QAAA,MAAM,IAAI,EAAE,IAAS,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC"}

package/dist/esm/interface.js

@@ -9,7 +9,12 @@ function _describe(description, fn, mode) {
     parent.addSuite(suite);
     unriftGlobalContext.currentSuite = suite;
     try {
-        fn();
+        const result = fn();
+        if (result != null &&
+            typeof result.then === "function") {
+            throw new Error(`describe() callbacks must be synchronous. ` +
+                `Move async setup into beforeAll() or beforeEach().`);
+        }
     }
     finally {
         unriftGlobalContext.currentSuite = parent;
@@ -19,14 +24,14 @@ const describe = (description, fn) => _describe(description, fn, TaskMode.Defaul
 describe.only = (description, fn) => _describe(description, fn, TaskMode.Only);
 describe.skip = (description, fn) => _describe(description, fn, TaskMode.Skip);
 describe.todo = (description) => _describe(description, () => { }, TaskMode.Todo);
-function _it(description, fn, mode) {
+function _it(description, fn, mode, timeoutMs) {
     assertRegisterState("it");
-    const test = new Test(description, fn, mode);
+    const test = new Test(description, fn, mode, timeoutMs);
     getCurrentSuite().addTest(test);
 }
-const it = (description, fn) => _it(description, fn, TaskMode.Default);
-it.only = (description, fn) => _it(description, fn, TaskMode.Only);
-it.skip = (description, fn) => _it(description, fn, TaskMode.Skip);
+const it = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Default, timeoutMs);
+it.only = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Only, timeoutMs);
+it.skip = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Skip, timeoutMs);
 it.todo = (description) => _it(description, () => { }, TaskMode.Todo);
 const test = it;
 export { describe, it, test };

package/dist/esm/matchers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/matchers.ts"],"names":[],"mappings":"AAUA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/matchers.ts"],"names":[],"mappings":"AAyGA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}

package/dist/esm/matchers.js

@@ -1,8 +1,81 @@
 import { expect } from "./expect.js";
+import { isSpy } from "./mock/spy.js";
+import { isFetchMock } from "./mock/fetch.js";
 import { deepEqual } from "./utils/deepEqual.js";
 import { looseEqual } from "./utils/looseEqual.js";
+import { regexTest } from "./utils/helpers.js";
 import { toThrow } from "./utils/toThrow.js";
 let matchersRegistered = false;
+function ensureSpy(received, matcherName) {
+    if (!isSpy(received)) {
+        throw new Error(`${matcherName}() requires a spy or mock function (created via spy() or spyOn()), ` +
+            `but received ${typeof received === "object" ? Object.prototype.toString.call(received) : typeof received}`);
+    }
+}
+function ensureFetchMock(received, matcherName) {
+    if (!isFetchMock(received)) {
+        throw new Error(`${matcherName}() requires \`mock.fetch\` as the received value, ` +
+            `but received ${typeof received === "object" ? Object.prototype.toString.call(received) : typeof received}`);
+    }
+}
+function matchesFetchTarget(req, target) {
+    if (typeof target === "string")
+        return req.url === target;
+    if (target instanceof RegExp)
+        return regexTest(target, req.url);
+    if (typeof target === "function")
+        return Boolean(target(req));
+    return false;
+}
+function argsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!looseEqual(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+function partialMatch(received, expected) {
+    if (expected === null || typeof expected !== "object") {
+        return looseEqual(received, expected);
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(received))
+            return false;
+        if (received.length !== expected.length)
+            return false;
+        return expected.every((e, i) => partialMatch(received[i], e));
+    }
+    if (received === null ||
+        typeof received !== "object" ||
+        Array.isArray(received)) {
+        return false;
+    }
+    const recv = received;
+    const exp = expected;
+    for (const key of Object.keys(exp)) {
+        if (!Object.hasOwn(recv, key))
+            return false;
+        if (!partialMatch(recv[key], exp[key]))
+            return false;
+    }
+    return true;
+}
+function getNestedValue(obj, path) {
+    const keys = Array.isArray(path) ? path : path.split(".");
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== "object") {
+            return { found: false, value: undefined };
+        }
+        const record = current;
+        if (!Object.hasOwn(record, key))
+            return { found: false, value: undefined };
+        current = record[key];
+    }
+    return { found: true, value: current };
+}
 export function ensureInternalMatchers() {
     if (matchersRegistered)
         return;
@@ -123,7 +196,7 @@ function registerCoreMatchers() {
             }
             const pass = typeof expected === "string"
                 ? received.includes(expected)
-                : expected.test(received);
+                : regexTest(expected, received);
             if (this.isNot ? pass : !pass)
                 throw new Error(this.diff(received, expected));
         },
@@ -138,5 +211,192 @@ function registerCoreMatchers() {
             if (!pass)
                 throw new Error(message());
         },
+        toBeGreaterThanOrEqual(received, expected) {
+            if (typeof received !== "number") {
+                throw new Error(this.diff(received, "expected a number"));
+            }
+            const pass = received >= expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, `>= ${expected}`));
+            }
+        },
+        toBeLessThanOrEqual(received, expected) {
+            if (typeof received !== "number") {
+                throw new Error(this.diff(received, "expected a number"));
+            }
+            const pass = received <= expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, `<= ${expected}`));
+            }
+        },
+        toBeNaN(received) {
+            const pass = Number.isNaN(received);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, "NaN"));
+            }
+        },
+        toBeFinite(received) {
+            const pass = Number.isFinite(received);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, "finite number"));
+            }
+        },
+        toMatchObject(received, expected) {
+            if (received === null ||
+                typeof received !== "object" ||
+                Array.isArray(received)) {
+                throw new Error(this.diff(received, "expected a non-array object for toMatchObject()"));
+            }
+            const pass = partialMatch(received, expected);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, expected));
+            }
+        },
+        toHaveBeenCalled(received) {
+            ensureSpy(received, "toHaveBeenCalled");
+            const pass = received.mock.calls.length > 0;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(`${received.getMockName()} called ${received.mock.calls.length} time(s)`, "to have been called"));
+            }
+        },
+        toHaveBeenCalledTimes(received, expected) {
+            ensureSpy(received, "toHaveBeenCalledTimes");
+            if (typeof expected !== "number" || !Number.isFinite(expected)) {
+                throw new Error(this.diff(expected, "toHaveBeenCalledTimes() requires a finite number"));
+            }
+            const actual = received.mock.calls.length;
+            const pass = actual === expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(actual, expected));
+            }
+        },
+        toHaveBeenCalledWith(received, ...expectedArgs) {
+            ensureSpy(received, "toHaveBeenCalledWith");
+            const pass = received.mock.calls.some((call) => argsEqual(call, expectedArgs));
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received.mock.calls, expectedArgs));
+            }
+        },
+        toHaveBeenLastCalledWith(received, ...expectedArgs) {
+            ensureSpy(received, "toHaveBeenLastCalledWith");
+            const last = received.mock.lastCall;
+            const pass = last !== undefined && argsEqual(last, expectedArgs);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(last ?? "no calls", expectedArgs));
+            }
+        },
+        toHaveBeenNthCalledWith(received, n, ...expectedArgs) {
+            ensureSpy(received, "toHaveBeenNthCalledWith");
+            if (typeof n !== "number" || !Number.isInteger(n) || n < 1) {
+                throw new Error(this.diff(n, "toHaveBeenNthCalledWith() requires a 1-indexed integer"));
+            }
+            const call = received.mock.calls[n - 1];
+            const pass = call !== undefined && argsEqual(call, expectedArgs);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(call ?? `call #${n} not found`, expectedArgs));
+            }
+        },
+        toHaveReturned(received) {
+            ensureSpy(received, "toHaveReturned");
+            const pass = received.mock.results.some((r) => r.type === "return");
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(`${received.mock.results.length} result(s)`, "at least one successful return"));
+            }
+        },
+        toHaveReturnedTimes(received, expected) {
+            ensureSpy(received, "toHaveReturnedTimes");
+            if (typeof expected !== "number" || !Number.isFinite(expected)) {
+                throw new Error(this.diff(expected, "toHaveReturnedTimes() requires a finite number"));
+            }
+            const actual = received.mock.results.filter((r) => r.type === "return").length;
+            const pass = actual === expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(actual, expected));
+            }
+        },
+        toHaveReturnedWith(received, expected) {
+            ensureSpy(received, "toHaveReturnedWith");
+            const pass = received.mock.results.some((r) => r.type === "return" && looseEqual(r.value, expected));
+            if (this.isNot ? pass : !pass) {
+                const returnValues = received.mock.results
+                    .filter((r) => r.type === "return")
+                    .map((r) => r.value);
+                throw new Error(this.diff(returnValues, expected));
+            }
+        },
+        toHaveLastReturnedWith(received, expected) {
+            ensureSpy(received, "toHaveLastReturnedWith");
+            const results = received.mock.results;
+            const last = results[results.length - 1];
+            const pass = last !== undefined &&
+                last.type === "return" &&
+                looseEqual(last.value, expected);
+            if (this.isNot ? pass : !pass) {
+                if (last === undefined) {
+                    throw new Error(this.diff("no calls", expected));
+                }
+                if (last.type === "throw") {
+                    throw new Error(this.diff("last call threw", expected));
+                }
+                throw new Error(this.diff(last.value, expected));
+            }
+        },
+        toHaveNthReturnedWith(received, n, expected) {
+            ensureSpy(received, "toHaveNthReturnedWith");
+            if (typeof n !== "number" || !Number.isInteger(n) || n < 1) {
+                throw new Error(this.diff(n, "toHaveNthReturnedWith() requires a 1-indexed integer"));
+            }
+            const result = received.mock.results[n - 1];
+            const pass = result !== undefined &&
+                result.type === "return" &&
+                looseEqual(result.value, expected);
+            if (this.isNot ? pass : !pass) {
+                if (result === undefined) {
+                    throw new Error(this.diff(`call #${n} not found`, expected));
+                }
+                if (result.type === "throw") {
+                    throw new Error(this.diff(`call #${n} threw`, expected));
+                }
+                throw new Error(this.diff(result.value, expected));
+            }
+        },
+        toHaveFetched(received, target) {
+            ensureFetchMock(received, "toHaveFetched");
+            const pass = received.calls.some((req) => matchesFetchTarget(req, target));
+            if (this.isNot ? pass : !pass) {
+                const urls = received.calls.map((r) => `${r.method} ${r.url}`);
+                throw new Error(this.diff(urls, target));
+            }
+        },
+        toHaveFetchedTimes(received, expected) {
+            ensureFetchMock(received, "toHaveFetchedTimes");
+            if (typeof expected !== "number" || !Number.isFinite(expected)) {
+                throw new Error(this.diff(expected, "toHaveFetchedTimes() requires a finite number"));
+            }
+            const actual = received.calls.length;
+            const pass = actual === expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(actual, expected));
+            }
+        },
+        toHaveProperty(received, path, ...rest) {
+            if (received === null || typeof received !== "object") {
+                throw new Error(this.diff(received, "expected an object for toHaveProperty()"));
+            }
+            const normalizedPath = path;
+            const { found, value } = getNestedValue(received, normalizedPath);
+            const hasValue = rest.length > 0;
+            const expectedValue = rest[0];
+            const pass = hasValue ? found && looseEqual(value, expectedValue) : found;
+            if (this.isNot ? pass : !pass) {
+                const pathStr = Array.isArray(normalizedPath)
+                    ? normalizedPath.join(".")
+                    : normalizedPath;
+                if (!found) {
+                    throw new Error(this.diff(Object.keys(received), `property "${pathStr}"`));
+                }
+                throw new Error(this.diff(value, expectedValue));
+            }
+        },
     });
 }

package/dist/esm/mock/auto.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Auto-mocking helpers: `mock.object` and `mock.class`.
+ *
+ * Both walk own + prototype methods and replace each function with a spy.
+ * Restoration uses the same registry as `spyOn`, so `mock.restoreAll()`
+ * cleans up auto mocks too.
+ */
+/**
+ * Replace every method on `obj` (own + inherited, excluding Object.prototype)
+ * with a spy. Returns the same reference, mutated in place.
+ *
+ * Cleanup happens via `mock.restoreAll()` - auto-mock spies share the same
+ * restorer registry as `spyOn`.
+ */
+export declare function mockObject<T extends object>(obj: T): T;
+/**
+ * Wrap a constructor so every instance is auto-mocked, and so static
+ * methods on the constructor itself are spied too. Returns a Proxy that
+ * is `instanceof`-compatible with the original.
+ *
+ * Instance methods are spied as OWN properties on each instance (shadowing
+ * the prototype), NOT by mutating the shared prototype. This keeps call
+ * state per-instance (a.run and b.run are separate spies) and leaves the
+ * class prototype untouched - nothing to restore, nothing to leak.
+ */
+export declare function mockClass<T extends new (...args: any[]) => any>(Ctor: T): T;
+//# sourceMappingURL=auto.d.ts.map

package/dist/esm/mock/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../../src/mock/auto.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+CH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAatD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAEvB,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrC,IAAI,EAAE,CAAC,GAAG,CAAC,CA8BZ"}