@unrift/core 0.4.0 → 0.5.1

package/dist/esm/cli.js

@@ -36,6 +36,7 @@ Usage:
 
 Options:
   -c, --config <path>      Path to config file
+  -g, --grep <pattern>     Only run tests whose full name matches (regex)
   -b, --bail               Stop on first test failure
   -t, --timeout <ms>       Default test timeout in milliseconds
   -w, --watch              Re-run tests on file changes
@@ -49,6 +50,7 @@ Options:
 Examples:
   unrift
   unrift math
+  unrift --grep "adds numbers"
   unrift -c test/config.ts --bail
   unrift --timeout 10000
   unrift --watch
@@ -57,6 +59,7 @@ Examples:
 function parseArgs(argv) {
     let configPath;
     let pattern;
+    let grep;
     let timeoutMs;
     let bail;
     let debug = false;
@@ -85,6 +88,14 @@ function parseArgs(argv) {
             i++;
             continue;
         }
+        if (a === "--grep" || a === "-g") {
+            const next = argv[i + 1];
+            if (!next)
+                throw new Error(`${a} requires a pattern`);
+            grep = safeRegExp(next);
+            i++;
+            continue;
+        }
         if (a === "--bail" || a === "-b") {
             bail = true;
             continue;
@@ -127,6 +138,7 @@ function parseArgs(argv) {
     return {
         configPath,
         pattern,
+        grep,
         timeoutMs,
         bail,
         debug,
@@ -138,7 +150,7 @@ function parseArgs(argv) {
         showVersion,
     };
 }
-const { configPath, pattern, timeoutMs, bail, debug, list, json, cacheClean, watch, help, showVersion, } = parseArgs(process.argv.slice(2));
+const { configPath, pattern, grep, timeoutMs, bail, debug, list, json, cacheClean, watch, help, showVersion, } = parseArgs(process.argv.slice(2));
 if (showVersion) {
     console.log(version);
     process.exit(0);
@@ -149,6 +161,7 @@ if (help) {
 }
 const runOpts = {
     pattern,
+    grep,
     configPath,
     timeoutMs,
     bail,

package/dist/esm/expect.d.ts

@@ -17,6 +17,7 @@ export interface Matchers<T> {
         prototype: unknown;
     }): void | Promise<void>;
     toContain(expected: unknown): void | Promise<void>;
+    toContainEqual(expected: unknown): void | Promise<void>;
     toEqual(expected: unknown): void | Promise<void>;
     toHaveLength(expected: number): void | Promise<void>;
     toMatch(expected: RegExp | string): void | Promise<void>;
@@ -24,6 +25,7 @@ export interface Matchers<T> {
     toThrow(expected?: unknown): void | Promise<void>;
     toBeGreaterThanOrEqual(expected: number): void | Promise<void>;
     toBeLessThanOrEqual(expected: number): void | Promise<void>;
+    toBeCloseTo(expected: number, precision?: number): void | Promise<void>;
     toBeNaN(): void | Promise<void>;
     toBeFinite(): void | Promise<void>;
     toMatchObject(expected: Record<string, unknown>): void | Promise<void>;
@@ -41,7 +43,7 @@ export interface Matchers<T> {
     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 resolves: Matchers<Settled<T>>;
     readonly rejects: Matchers<unknown>;
 }
 export interface Matchers<T> {
@@ -51,5 +53,8 @@ export interface ExpectInterface {
     extend<M extends MatcherMap>(m: M): void;
     readonly matchers: Readonly<MatcherMap>;
 }
+/** What `.resolves` sees: a function's returned promise, or the promise itself. */
+type Settled<T> = Awaited<T extends (...args: never[]) => infer R ? R : T>;
 export declare const expect: ExpectInterface;
+export {};
 //# sourceMappingURL=expect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"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"}

package/dist/esm/expect.js

@@ -1,14 +1,24 @@
 import { formatDiff } from "./utils/diff.js";
+import { isErrorLike, safeString } from "./utils/helpers.js";
 const matcherRegistry = Object.create(null);
 export function extendMatchers(newMatchers) {
     for (const key in newMatchers)
         matcherRegistry[key] = newMatchers[key];
 }
+function describeError(value) {
+    return isErrorLike(value) ? value.message : safeString(value);
+}
+function isThenable(value) {
+    return (value != null &&
+        (typeof value === "object" || typeof value === "function") &&
+        typeof value.then === "function");
+}
 export const expect = (() => {
     function expectFn(received) {
         function makeExpectation(isNot) {
             const ctx = {
                 isNot,
+                promise: "",
                 diff(a, b) {
                     return formatDiff(a, b);
                 },
@@ -18,9 +28,10 @@ export const expect = (() => {
                 const fn = matcherRegistry[name];
                 matcherFns[name] = (...args) => fn.call(ctx, received, ...args);
             }
-            function makeAsyncProxy(getActual, asyncIsNot) {
+            function makeAsyncProxy(getActual, asyncIsNot, promise) {
                 const asyncCtx = {
                     isNot: asyncIsNot,
+                    promise,
                     diff(a, b) {
                         return formatDiff(a, b);
                     },
@@ -28,15 +39,14 @@ export const expect = (() => {
                 const asyncFns = {};
                 for (const name in matcherRegistry) {
                     const fn = matcherRegistry[name];
-                    asyncFns[name] = async (...args) => {
-                        const actual = await getActual();
-                        return fn.call(asyncCtx, actual, ...args);
-                    };
+                    // Not async: getActual() runs now, so a bad received value (a sync
+                    // throw, a non-promise) throws immediately like Jest, even unawaited.
+                    asyncFns[name] = (...args) => getActual().then((actual) => fn.call(asyncCtx, actual, ...args));
                 }
                 return new Proxy(asyncFns, {
                     get(target, prop) {
                         if (prop === "not") {
-                            return makeAsyncProxy(getActual, !asyncIsNot);
+                            return makeAsyncProxy(getActual, !asyncIsNot, promise);
                         }
                         if (typeof prop === "string" && !(prop in target)) {
                             throw new Error(`Unknown matcher: ${prop}`);
@@ -49,30 +59,51 @@ export const expect = (() => {
                 get(target, prop) {
                     if (prop === "not")
                         return makeExpectation(!isNot);
+                    // Same as Jest: a function is called and must return a promise. A
+                    // sync throw from it isn't a rejection, it fails the assertion.
+                    const toPromise = (modifier) => {
+                        const value = typeof received === "function"
+                            ? received()
+                            : received;
+                        if (!isThenable(value)) {
+                            throw new TypeError(`.${modifier}: received value must be a promise or a function returning a promise, got ${describeError(value)}`);
+                        }
+                        return value;
+                    };
                     if (prop === "resolves") {
-                        return makeAsyncProxy(async () => {
-                            try {
-                                return await received;
-                            }
-                            catch (err) {
-                                throw new Error(`Expected promise to resolve, but it rejected with: ${err instanceof Error ? err.message : String(err)}`);
-                            }
-                        }, isNot);
+                        return makeAsyncProxy(() => {
+                            const pending = toPromise("resolves");
+                            return (async () => {
+                                try {
+                                    return await pending;
+                                }
+                                catch (err) {
+                                    throw new Error(`Expected promise to resolve, but it rejected with: ${describeError(err)}`);
+                                }
+                            })();
+                        }, isNot, "resolves");
                     }
                     if (prop === "rejects") {
-                        return makeAsyncProxy(async () => {
-                            try {
-                                await received;
-                                throw new Error("Expected promise to reject, but it resolved");
-                            }
-                            catch (err) {
-                                if (err instanceof Error &&
-                                    err.message === "Expected promise to reject, but it resolved") {
-                                    throw err;
+                        return makeAsyncProxy(() => {
+                            const pending = toPromise("rejects");
+                            return (async () => {
+                                // Tracked with a flag, not by error message, so a promise that
+                                // rejects with that same text is still treated as a rejection.
+                                let resolved = false;
+                                let reason;
+                                try {
+                                    await pending;
+                                    resolved = true;
+                                }
+                                catch (err) {
+                                    reason = err;
+                                }
+                                if (resolved) {
+                                    throw new Error("Expected promise to reject, but it resolved");
                                 }
-                                return err;
-                            }
-                        }, isNot);
+                                return reason;
+                            })();
+                        }, isNot, "rejects");
                     }
                     if (typeof prop === "string" && !(prop in target)) {
                         throw new Error(`Unknown matcher: ${prop}`);

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 export { beforeEach, afterEach, beforeAll, afterAll } from "./hooks";
 export { defineConfig, type UnriftConfigOptions } from "./utils/defineConfig";
-export { describe, it, test } from "./interface";
+export { describe, it, test, type TestOptions } from "./interface";
 export { expect, extendMatchers } from "./expect";
 export type { Matchers, ExpectInterface } from "./expect";
 export type { MatcherContext, MatcherFn, MatcherMap, Promisable, } from "./types";

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,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"}
+{"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,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,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/interface.d.ts

@@ -8,10 +8,14 @@ type DescribeFn = {
     skip: (description: string, fn: () => void) => void;
     todo: (description: string) => void;
 };
+export interface TestOptions {
+    timeout?: number;
+    retries?: number;
+}
 type ItFn = {
-    (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;
+    (description: string, fn: PromisableFn<void>, options?: number | TestOptions): void;
+    only: (description: string, fn: PromisableFn<void>, options?: number | TestOptions) => void;
+    skip: (description: string, fn: PromisableFn<void>, options?: number | TestOptions) => 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,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"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/interface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,SAAS,CAAC;AAGtD;;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,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,IAAI,GAAG;IACV,CACE,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAC7B,IAAI,CAAC;IACR,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,KAC3B,IAAI,CAAC;IACV,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,KAC3B,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AA6BF,QAAA,MAAM,QAAQ,EAAE,UAC8B,CAAC;AAyB/C,QAAA,MAAM,EAAE,EAAE,IACuC,CAAC;AAOlD,QAAA,MAAM,IAAI,EAAE,IAAS,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC"}

package/dist/esm/interface.js

@@ -2,6 +2,7 @@ import { assertRegisterState, unriftGlobalContext } from "./context.js";
 import { getCurrentSuite, Suite } from "./suite.js";
 import { Test } from "./test.js";
 import { TaskMode } from "./types.js";
+import { assertValidRetries } from "./utils/helpers.js";
 function _describe(description, fn, mode) {
     assertRegisterState("describe");
     const parent = getCurrentSuite();
@@ -24,14 +25,17 @@ 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, timeoutMs) {
+function _it(description, fn, mode, options) {
     assertRegisterState("it");
-    const test = new Test(description, fn, mode, timeoutMs);
+    // A bare number is the timeout, kept for backwards compatibility.
+    const { timeout, retries } = typeof options === "number" ? { timeout: options } : (options ?? {});
+    assertValidRetries(retries, `it("${description}")`);
+    const test = new Test(description, fn, mode, timeout, retries);
     getCurrentSuite().addTest(test);
 }
-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);
+const it = (description, fn, options) => _it(description, fn, TaskMode.Default, options);
+it.only = (description, fn, options) => _it(description, fn, TaskMode.Only, options);
+it.skip = (description, fn, options) => _it(description, fn, TaskMode.Skip, options);
 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":"AAyGA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/matchers.ts"],"names":[],"mappings":"AA6GA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}

package/dist/esm/matchers.js

@@ -4,7 +4,7 @@ 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";
+import { toThrow, toThrowFromPromise, } from "./utils/toThrow.js";
 let matchersRegistered = false;
 function ensureSpy(received, matcherName) {
     if (!isSpy(received)) {
@@ -165,6 +165,22 @@ function registerCoreMatchers() {
                 throw new Error(this.diff(received, expected));
             }
         },
+        toContainEqual(received, expected) {
+            if (!Array.isArray(received)) {
+                throw new Error(this.diff(received, "expected an array for toContainEqual()"));
+            }
+            // for...of visits sparse holes as undefined; Array.some would skip them.
+            let pass = false;
+            for (const item of received) {
+                if (looseEqual(item, expected)) {
+                    pass = true;
+                    break;
+                }
+            }
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, expected));
+            }
+        },
         toEqual(received, expected) {
             const pass = looseEqual(received, expected);
             if (this.isNot ? pass : !pass) {
@@ -207,7 +223,10 @@ function registerCoreMatchers() {
             }
         },
         toThrow(received, expected) {
-            const { pass, message } = toThrow(received, expected, this.isNot);
+            // Under .resolves/.rejects, `received` is the settled value itself.
+            const { pass, message } = this.promise
+                ? toThrowFromPromise(received, expected, this.isNot, this.promise)
+                : toThrow(received, expected, this.isNot);
             if (!pass)
                 throw new Error(message());
         },
@@ -229,6 +248,24 @@ function registerCoreMatchers() {
                 throw new Error(this.diff(received, `<= ${expected}`));
             }
         },
+        toBeCloseTo(received, expected, precision = 2) {
+            if (typeof received !== "number") {
+                throw new Error(this.diff(received, "expected a number"));
+            }
+            if (typeof expected !== "number") {
+                throw new Error(this.diff(expected, "a number for expected"));
+            }
+            if (!Number.isFinite(precision)) {
+                throw new Error(this.diff(precision, "a finite number for precision"));
+            }
+            // Same-signed infinities are equal; the subtraction below would be NaN.
+            // Finite values always go through the tolerance check.
+            const pass = (!Number.isFinite(received) && received === expected) ||
+                Math.abs(received - expected) < 10 ** -precision / 2;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, `${expected} (precision ${precision})`));
+            }
+        },
         toBeNaN(received) {
             const pass = Number.isNaN(received);
             if (this.isNot ? pass : !pass) {

package/dist/esm/run.d.ts

@@ -1,20 +1,17 @@
-import { TaskStatus } from "./types";
+import { type TestResult } from "./suite";
 type RunEngineOptions = {
     files: string[];
     timeoutMs?: number;
     bail?: boolean;
+    grep?: RegExp;
+    retries?: number;
     matchers?: string[];
 };
 export type RunEngineResult = {
     isOnly: boolean;
     timeoutMs?: number;
     bail: boolean;
-    results: Array<{
-        description: string;
-        status: TaskStatus;
-        error?: Error;
-        durationMs: number;
-    }>;
+    results: TestResult[];
 };
 export declare function runEngine(options: RunEngineOptions): Promise<RunEngineResult>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,UAAU,EAAE,MAAM,SAAS,CAAC;AAI/C,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ,CAAC;AAQF,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA2D1B"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AASjB,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAQF,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoE1B"}

package/dist/esm/run.js

@@ -1,10 +1,11 @@
-import { clearContext, computeOnlyFlags, rootSuite, Suite } from "./suite.js";
+import { clearContext, computeOnlyFlags, rootSuite, Suite, } from "./suite.js";
 import { ensureInternalMatchers } from "./matchers.js";
 import { RunState, unriftGlobalContext } from "./context.js";
 import { normalizePath } from "./utils/normalizePath.js";
 import { TaskMode } from "./types.js";
 import { toError } from "./utils/toError.js";
 import { toImportUrl } from "./utils/transform.js";
+import { assertValidRetries } from "./utils/helpers.js";
 async function loadMatcherModules(specifiers) {
     for (const spec of specifiers ?? []) {
         await import(spec);
@@ -12,6 +13,9 @@ async function loadMatcherModules(specifiers) {
 }
 export async function runEngine(options) {
     const { files } = options;
+    // Validate before touching global state. A bad value (e.g. "3" from a JSON
+    // config) would otherwise turn into "31" attempts or zero.
+    assertValidRetries(options.retries, "runEngine");
     clearContext();
     ensureInternalMatchers();
     await loadMatcherModules(options.matchers);
@@ -40,7 +44,7 @@ export async function runEngine(options) {
         }
         const isOnly = computeOnlyFlags(rootSuite);
         unriftGlobalContext.state = RunState.Run;
-        await rootSuite.run({ timeoutMs, bail }, { bailed: false }, isOnly, false);
+        await rootSuite.run({ timeoutMs, bail, grep: options.grep, retries: options.retries }, { bailed: false }, isOnly, false);
         const results = rootSuite.getResults();
         return {
             isOnly,

package/dist/esm/runner.d.ts

@@ -2,6 +2,7 @@ interface RunnerOptions {
     configPath?: string;
     testDir?: string;
     pattern?: RegExp;
+    grep?: RegExp;
     timeoutMs?: number;
     bail?: boolean;
     debug?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAwBA,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA0ND,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,iBA8T5D;AA+DD,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,iBAyD9D"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAyBA,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA+MD,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,iBAwU5D;AA+DD,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,iBAyD9D"}

package/dist/esm/runner.js

@@ -237,6 +237,8 @@ export async function runTestsCLI(options = {}) {
         files,
         timeoutMs,
         bail,
+        grep: options.grep,
+        retries: config?.retries,
         matchers: config?.matchers,
     });
     debugLog(options.debug, options.json, "Only mode:", engine.isOnly);
@@ -264,6 +266,7 @@ export async function runTestsCLI(options = {}) {
             description: result.description,
             status: result.status,
             durationMs: result.durationMs ?? 0,
+            attempts: result.attempts && result.attempts > 1 ? result.attempts : undefined,
             error: result.error
                 ? { message: result.error.message, stack: result.error.stack }
                 : undefined,
@@ -328,14 +331,17 @@ export async function runTestsCLI(options = {}) {
                 lastSuitePath = suitePath;
             }
             const indent = "   " + "  ".repeat(depth);
+            const retried = result.attempts && result.attempts > 1
+                ? colors.yellow(` (${result.status === TaskStatus.Fail ? "failed" : "passed"} after ${result.attempts} attempts)`)
+                : "";
             if (result.status === TaskStatus.Pass) {
                 const dur = colors.dim(formatDuration(result.durationMs ?? 0));
-                console.log(`${indent}${colors.green("✔")} ${colors.dim(leaf)} ${dur}`);
+                console.log(`${indent}${colors.green("✔")} ${colors.dim(leaf)}${retried} ${dur}`);
                 continue;
             }
             if (result.status === TaskStatus.Fail) {
                 const dur = colors.dim(formatDuration(result.durationMs ?? 0));
-                console.log(`${indent}${colors.red("✘")} ${colors.boldRed(leaf)} ${dur}`);
+                console.log(`${indent}${colors.red("✘")} ${colors.boldRed(leaf)}${retried} ${dur}`);
                 continue;
             }
             if (result.status === TaskStatus.Skipped) {

package/dist/esm/suite.d.ts

@@ -3,10 +3,20 @@ import { type PromisableFn, TaskMode, TaskStatus } from "./types";
 interface RunOptions {
     timeoutMs?: number;
     bail?: boolean;
+    grep?: RegExp;
+    retries?: number;
 }
 interface SuiteRunState {
     bailed: boolean;
 }
+export interface TestResult {
+    description: string;
+    status: TaskStatus;
+    error?: Error;
+    durationMs: number;
+    /** How many times the test ran. Above 1 means it was retried. */
+    attempts?: number;
+}
 export declare class Suite {
     description: string;
     mode: TaskMode;
@@ -27,20 +37,28 @@ export declare class Suite {
     afterEachHooks: PromisableFn<void>[];
     constructor(description: string, parent?: Suite, mode?: TaskMode);
     markSubtreeSkipped(): void;
+    /**
+     * Used when --grep prunes a suite. Matching todos stay todo so their status
+     * doesn't depend on whether a runnable sibling matched; everything else is
+     * skipped.
+     */
+    private markSubtreeFilteredOut;
     markSubtreeTodo(): void;
     addSuite(suite: Suite): void;
     addTest(test: Test): void;
     private collectBeforeEachHooks;
     private collectAfterEachHooks;
     run(options?: RunOptions, state?: SuiteRunState, isOnly?: boolean, ancestorOnly?: boolean): Promise<void>;
+    private testMatchesGrep;
+    /**
+     * True if a test below this suite matches grep AND would actually run, using
+     * the same skip/todo/only rules as run(). A matching test that won't run
+     * shouldn't cause this suite's hooks to fire.
+     */
+    private hasRunnableMatch;
     getFullDescription(): string;
     reset(): void;
-    getResults(): Array<{
-        description: string;
-        status: TaskStatus;
-        error?: Error;
-        durationMs: number;
-    }>;
+    getResults(): TestResult[];
 }
 export declare function computeOnlyFlags(suite: Suite): boolean;
 export declare const rootSuite: Suite;

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

@@ -1 +1 @@
-{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/suite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGlE,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAsBD,qBAAa,KAAK;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf,cAAc,EAAE,OAAO,CAAS;IAEhC,IAAI,EAAE,OAAO,CAAS;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAM;IACpD,MAAM,EAAE,KAAK,EAAE,CAAM;IACrB,KAAK,EAAE,IAAI,EAAE,CAAM;IAEnB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,cAAc,CAAC,EAAE,KAAK,CAAC;IAEvB,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IAC1C,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IACzC,eAAe,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IAC3C,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;gBAGxC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,KAAK,EACd,IAAI,GAAE,QAA2B;IAO5B,kBAAkB;IASlB,eAAe;IAStB,QAAQ,CAAC,KAAK,EAAE,KAAK;IAIrB,OAAO,CAAC,IAAI,EAAE,IAAI;IAIlB,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,qBAAqB;IAYvB,GAAG,CACP,OAAO,CAAC,EAAE,UAAU,EACpB,KAAK,GAAE,aAAiC,EACxC,MAAM,GAAE,OAAe,EACvB,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IA4JhB,kBAAkB,IAAI,MAAM;IAK5B,KAAK;IAaL,UAAU,IAAI,KAAK,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CAkDH;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAiBtD;AAKD,eAAO,MAAM,SAAS,OAAoB,CAAC;AAG3C,wBAAgB,eAAe,UAE9B;AAED,wBAAgB,YAAY,SAK3B"}
+{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/suite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIlE,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAsBD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,KAAK;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf,cAAc,EAAE,OAAO,CAAS;IAEhC,IAAI,EAAE,OAAO,CAAS;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAM;IACpD,MAAM,EAAE,KAAK,EAAE,CAAM;IACrB,KAAK,EAAE,IAAI,EAAE,CAAM;IAEnB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,cAAc,CAAC,EAAE,KAAK,CAAC;IAEvB,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IAC1C,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IACzC,eAAe,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;IAC3C,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAM;gBAGxC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,KAAK,EACd,IAAI,GAAE,QAA2B;IAO5B,kBAAkB;IASzB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA8BvB,eAAe;IAStB,QAAQ,CAAC,KAAK,EAAE,KAAK;IAIrB,OAAO,CAAC,IAAI,EAAE,IAAI;IAIlB,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,qBAAqB;IAYvB,GAAG,CACP,OAAO,CAAC,EAAE,UAAU,EACpB,KAAK,GAAE,aAAiC,EACxC,MAAM,GAAE,OAAe,EACvB,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IAmNhB,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IA4BxB,kBAAkB,IAAI,MAAM;IAK5B,KAAK;IAaL,UAAU,IAAI,UAAU,EAAE;CA8C3B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAiBtD;AAKD,eAAO,MAAM,SAAS,OAAoB,CAAC;AAG3C,wBAAgB,eAAe,UAE9B;AAED,wBAAgB,YAAY,SAK3B"}

package/dist/esm/suite.js

@@ -1,6 +1,7 @@
 import { unriftGlobalContext } from "./context.js";
 import { resetMatchers } from "./matchers.js";
 import { TaskMode, TaskStatus } from "./types.js";
+import { regexTest } from "./utils/helpers.js";
 import { toError } from "./utils/toError.js";
 function appendHookFailure(existing, hookName, hookError) {
     if (!existing)
@@ -42,6 +43,34 @@ export class Suite {
         for (const suite of this.suites)
             suite.markSubtreeSkipped();
     }
+    /**
+     * Used when --grep prunes a suite. Matching todos stay todo so their status
+     * doesn't depend on whether a runnable sibling matched; everything else is
+     * skipped.
+     */
+    markSubtreeFilteredOut(grep, isOnly, inOnlyContext) {
+        for (const test of this.tests) {
+            if (test.status !== TaskStatus.Pending)
+                continue;
+            test.status =
+                test.mode === TaskMode.Todo && this.testMatchesGrep(test, grep)
+                    ? TaskStatus.Todo
+                    : TaskStatus.Skipped;
+            test.durationMs = 0;
+        }
+        // Same skip and .only rules as run(), so a suite excluded by .only stays
+        // skipped no matter which pattern pruned its parent.
+        for (const suite of this.suites) {
+            const childOnly = inOnlyContext || suite.mode === TaskMode.Only;
+            if (suite.mode === TaskMode.Skip ||
+                (isOnly && !suite.subtreeHasOnly && !childOnly)) {
+                suite.markSubtreeSkipped();
+            }
+            else {
+                suite.markSubtreeFilteredOut(grep, isOnly, childOnly);
+            }
+        }
+    }
     markSubtreeTodo() {
         for (const test of this.tests) {
             if (test.status === TaskStatus.Pending)
@@ -100,6 +129,12 @@ export class Suite {
             this.markSubtreeSkipped();
             return;
         }
+        // Same for --grep: nothing below can run, so don't run hooks either
+        if (options?.grep &&
+            !this.hasRunnableMatch(options.grep, isOnly, inOnlyContext)) {
+            this.markSubtreeFilteredOut(options.grep, isOnly, inOnlyContext);
+            return;
+        }
         let entered = false;
         try {
             // beforeAll
@@ -122,6 +157,12 @@ export class Suite {
                 const test = this.tests[i];
                 if (state.bailed)
                     break;
+                // Checked before skip/todo so a non-matching todo reports as skipped
+                if (options?.grep && !this.testMatchesGrep(test, options.grep)) {
+                    test.status = TaskStatus.Skipped;
+                    test.durationMs = 0;
+                    continue;
+                }
                 if (test.mode === TaskMode.Skip) {
                     test.status = TaskStatus.Skipped;
                     test.durationMs = 0;
@@ -139,32 +180,59 @@ export class Suite {
                     test.durationMs = 0;
                     continue;
                 }
-                try {
-                    for (const hook of beforeEachHooks) {
-                        try {
-                            await hook();
-                        }
-                        catch (error) {
-                            throw appendHookFailure(undefined, "beforeEach", toError(error));
+                // Each attempt gets its own beforeEach/afterEach so state resets between retries.
+                const maxAttempts = (test.retries ?? options?.retries ?? 0) + 1;
+                let totalMs = 0;
+                for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+                    test.attempts = attempt;
+                    test.error = undefined;
+                    // Reset so an attempt whose beforeEach throws doesn't report the
+                    // previous attempt's time.
+                    test.durationMs = 0;
+                    try {
+                        for (const hook of beforeEachHooks) {
+                            try {
+                                await hook();
+                            }
+                            catch (error) {
+                                throw appendHookFailure(undefined, "beforeEach", toError(error));
+                            }
                         }
+                        await test.run(options?.timeoutMs);
                     }
-                    await test.run(options?.timeoutMs);
-                }
-                catch (error) {
-                    test.status = TaskStatus.Fail;
-                    test.error = toError(error);
-                }
-                finally {
-                    for (const hook of afterEachHooks) {
-                        try {
-                            await hook();
+                    catch (error) {
+                        test.status = TaskStatus.Fail;
+                        test.error = toError(error);
+                    }
+                    finally {
+                        for (const hook of afterEachHooks) {
+                            try {
+                                await hook();
+                            }
+                            catch (error) {
+                                test.status = TaskStatus.Fail;
+                                test.error = appendHookFailure(test.error, "afterEach", toError(error));
+                            }
                         }
-                        catch (error) {
-                            test.status = TaskStatus.Fail;
-                            test.error = appendHookFailure(test.error, "afterEach", toError(error));
+                    }
+                    totalMs += test.durationMs;
+                    if (test.status !== TaskStatus.Fail)
+                        break;
+                    // A timed-out body can't be cancelled and may still be running, so
+                    // another attempt could race with it. Stop here instead.
+                    if (test.timedOut) {
+                        if (attempt < maxAttempts && test.error) {
+                            const note = "\n\n[retries] not retried: the timed-out attempt may still be running";
+                            // Read the stack before touching the message: V8 builds it lazily,
+                            // and an afterEach failure may have already combined it.
+                            const stack = test.error.stack ?? test.error.message;
+                            test.error.message += note;
+                            test.error.stack = stack + note;
                         }
+                        break;
                     }
                 }
+                test.durationMs = totalMs;
                 // Mark everything that hasn't run as skipped on bail
                 if (options?.bail && test.status === TaskStatus.Fail) {
                     state.bailed = true;
@@ -212,6 +280,31 @@ export class Suite {
             }
         }
     }
+    testMatchesGrep(test, grep) {
+        return regexTest(grep, `${this.getFullDescription()} › ${test.description}`);
+    }
+    /**
+     * True if a test below this suite matches grep AND would actually run, using
+     * the same skip/todo/only rules as run(). A matching test that won't run
+     * shouldn't cause this suite's hooks to fire.
+     */
+    hasRunnableMatch(grep, isOnly, inOnlyContext) {
+        const runnable = this.tests.some((test) => test.mode !== TaskMode.Skip &&
+            test.mode !== TaskMode.Todo &&
+            (!isOnly || inOnlyContext || test.mode === TaskMode.Only) &&
+            this.testMatchesGrep(test, grep));
+        if (runnable)
+            return true;
+        return this.suites.some((suite) => {
+            if (suite.mode === TaskMode.Skip || suite.mode === TaskMode.Todo) {
+                return false;
+            }
+            const childOnly = inOnlyContext || suite.mode === TaskMode.Only;
+            if (isOnly && !suite.subtreeHasOnly && !childOnly)
+                return false;
+            return suite.hasRunnableMatch(grep, isOnly, childOnly);
+        });
+    }
     getFullDescription() {
         if (!this.parent || this.parent.root)
             return this.description;
@@ -261,6 +354,7 @@ export class Suite {
                 status: test.status,
                 error: test.error,
                 durationMs: test.durationMs ?? 0,
+                attempts: test.attempts,
             });
         }
         for (const child of this.suites) {

package/dist/esm/test.d.ts

@@ -7,7 +7,11 @@ export declare class Test {
     mode: TaskMode;
     status: TaskStatus;
     timeoutMs?: number;
-    constructor(description: string, fn: PromisableFn<void>, mode?: TaskMode, timeoutMs?: number);
+    retries?: number;
+    attempts: number;
+    /** True if the last run timed out. Its body may still be running. */
+    timedOut: boolean;
+    constructor(description: string, fn: PromisableFn<void>, mode?: TaskMode, timeoutMs?: number, retries?: number);
     run(globalTimeoutMs?: number): Promise<void>;
 }
 //# sourceMappingURL=test.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AASlE,qBAAa,IAAI;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,EAAE,QAAQ,CAAC;IAEf,MAAM,EAAE,UAAU,CAAsB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,IAAI,GAAE,QAA2B,EACjC,SAAS,CAAC,EAAE,MAAM;IAQd,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyDnD"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AASlE,qBAAa,IAAI;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,EAAE,QAAQ,CAAC;IAEf,MAAM,EAAE,UAAU,CAAsB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAK;IACrB,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAS;gBAGxB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,IAAI,GAAE,QAA2B,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM;IASZ,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2DnD"}

package/dist/esm/test.js

@@ -13,11 +13,16 @@ export class Test {
     mode;
     status = TaskStatus.Pending;
     timeoutMs;
-    constructor(description, fn, mode = TaskMode.Default, timeoutMs) {
+    retries;
+    attempts = 0;
+    /** True if the last run timed out. Its body may still be running. */
+    timedOut = false;
+    constructor(description, fn, mode = TaskMode.Default, timeoutMs, retries) {
         this.description = description;
         this.fn = fn;
         this.mode = mode;
         this.timeoutMs = timeoutMs;
+        this.retries = retries;
     }
     async run(globalTimeoutMs) {
         const timeoutMs = this.timeoutMs ?? globalTimeoutMs;
@@ -33,12 +38,14 @@ export class Test {
         }
         const start = realPerformanceNow();
         this.status = TaskStatus.Running;
+        this.timedOut = false;
         const exec = Promise.resolve().then(() => this.fn());
         try {
             if (timeoutMs !== undefined) {
                 let timeoutId = null;
                 const timeoutFn = new Promise((_, reject) => {
                     timeoutId = setTimeout(() => {
+                        this.timedOut = true;
                         reject(new Error(`Test "${this.description}" timed out after ${timeoutMs} ms`));
                     }, timeoutMs);
                 });

package/dist/esm/types.d.ts

@@ -16,6 +16,8 @@ export declare enum TaskMode {
 }
 export interface MatcherContext {
     isNot: boolean;
+    /** "resolves" or "rejects" under those modifiers, otherwise "" (same as Jest). */
+    promise: "" | "resolves" | "rejects";
     diff(a: unknown, b: unknown): string;
 }
 export type MatcherFn = (this: MatcherContext, received: unknown, ...args: readonly unknown[]) => void | Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE3C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;AAElD,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,OAAO,EACjB,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE3C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;AAElD,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,OAAO,EAAE,EAAE,GAAG,UAAU,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,OAAO,EACjB,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/esm/utils/defineConfig.d.ts

@@ -2,6 +2,7 @@ export interface UnriftConfigOptions {
     testDir?: string;
     timeoutMs?: number;
     bail?: boolean;
+    retries?: number;
     pattern?: string;
     includes?: string[];
     excludes?: string[];

package/dist/esm/utils/defineConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/defineConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,mBAAmB,CAErB"}
+{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/defineConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,mBAAmB,CAErB"}

package/dist/esm/utils/helpers.d.ts

@@ -30,5 +30,14 @@ export declare function regexTest(re: RegExp, value: string): boolean;
  * - +0 and -0 are equal
  */
 export declare function sameValue(a: unknown, b: unknown): boolean;
+/** Throws unless `retries` is undefined or a non-negative integer. */
+export declare function assertValidRetries(retries: unknown, where: string): void;
+/** String() throws for e.g. null-prototype objects; fall back to the tag. */
+export declare function safeString(value: unknown): string;
+/**
+ * Error check that also works across realms (vm, workers, jsdom), where
+ * `instanceof Error` is false. Same test Jest uses.
+ */
+export declare function isErrorLike(value: unknown): value is Error;
 export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/esm/utils/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhF,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,cAAc,CAAC;AAEnB,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAY9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyDhD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CASzD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhF,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,cAAc,CAAC;AAEnB,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAY9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyDhD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CASzD;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASxE;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWjD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAW1D"}

package/dist/esm/utils/helpers.js

@@ -124,3 +124,40 @@ export function sameValue(a, b) {
         Number.isNaN(a) &&
         Number.isNaN(b));
 }
+/** Throws unless `retries` is undefined or a non-negative integer. */
+export function assertValidRetries(retries, where) {
+    if (retries !== undefined &&
+        !(typeof retries === "number" && Number.isInteger(retries) && retries >= 0)) {
+        throw new TypeError(`${where}: retries must be a non-negative integer, got ${typeof retries === "string" ? JSON.stringify(retries) : String(retries)}`);
+    }
+}
+/** String() throws for e.g. null-prototype objects; fall back to the tag. */
+export function safeString(value) {
+    try {
+        return String(value);
+    }
+    catch {
+        // The tag lookup can throw too (a throwing Symbol.toStringTag getter).
+        try {
+            return Object.prototype.toString.call(value);
+        }
+        catch {
+            return "[unprintable value]";
+        }
+    }
+}
+/**
+ * Error check that also works across realms (vm, workers, jsdom), where
+ * `instanceof Error` is false. Same test Jest uses.
+ */
+export function isErrorLike(value) {
+    // Both checks can throw (Proxy traps, a throwing Symbol.toStringTag getter).
+    // A value that can't be inspected isn't treated as an Error.
+    try {
+        return (value instanceof Error ||
+            Object.prototype.toString.call(value) === "[object Error]");
+    }
+    catch {
+        return false;
+    }
+}

package/dist/esm/utils/toThrow.d.ts

@@ -7,5 +7,10 @@ interface MatchResult {
     message: () => string;
 }
 export declare function toThrow(received: unknown, expected?: ToThrowExpected, isNot?: boolean): MatchResult;
+/**
+ * toThrow under `.resolves` / `.rejects`. `received` is the settled value, not
+ * a function. Same as Jest: it only counts as thrown if it's an Error.
+ */
+export declare function toThrowFromPromise(received: unknown, expected: ToThrowExpected, isNot: boolean, promise: "resolves" | "rejects"): MatchResult;
 export {};
 //# sourceMappingURL=toThrow.d.ts.map

package/dist/esm/utils/toThrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/toThrow.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,MAAM,GACN,MAAM,GACN,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC,GACnC;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,UAAU,WAAW;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AAgED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,KAAK,UAAQ,GACZ,WAAW,CAgEb"}
+{"version":3,"file":"toThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/toThrow.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,MAAM,GACN,MAAM,GACN,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC,GACnC;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,UAAU,WAAW;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AA4ED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,KAAK,UAAQ,GACZ,WAAW,CAwDb;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,WAAW,CAyBb"}

package/dist/esm/utils/toThrow.js

@@ -1,9 +1,9 @@
-import { regexTest } from "./helpers.js";
+import { isErrorLike, regexTest, safeString } from "./helpers.js";
 function isErrorConstructor(err) {
     return typeof err === "function";
 }
 function formatThrown(thrown) {
-    if (thrown instanceof Error) {
+    if (isErrorLike(thrown)) {
         const name = thrown.name || "Error";
         const msg = thrown.message ?? "";
         return msg ? `${name}: ${msg}` : name;
@@ -12,13 +12,22 @@ function formatThrown(thrown) {
         return typeof thrown === "string" ? thrown : JSON.stringify(thrown);
     }
     catch {
-        return String(thrown);
+        return safeString(thrown);
     }
 }
+function formatExpected(expected) {
+    return typeof expected === "string"
+        ? `"${expected}"`
+        : expected instanceof RegExp
+            ? expected.toString()
+            : isErrorConstructor(expected)
+                ? expected.name || "[AnonymousErrorConstructor]"
+                : JSON.stringify(expected, (_key, value) => value instanceof RegExp ? value.toString() : value);
+}
 function matchThrown(thrown, expected) {
     if (expected === undefined)
         return true;
-    const msg = thrown instanceof Error ? thrown.message : String(thrown);
+    const msg = isErrorLike(thrown) ? thrown.message : safeString(thrown);
     // toThrow("substring")
     if (typeof expected === "string") {
         return msg.includes(expected);
@@ -34,7 +43,7 @@ function matchThrown(thrown, expected) {
     // toThrow({ name?, message? })
     if (expected && typeof expected === "object") {
         if (expected.name) {
-            const thrownName = thrown instanceof Error ? thrown.name : undefined;
+            const thrownName = isErrorLike(thrown) ? thrown.name : undefined;
             if (thrownName !== expected.name)
                 return false;
         }
@@ -44,7 +53,7 @@ function matchThrown(thrown, expected) {
                     return false;
             }
             else {
-                if (!expected.message.test(msg))
+                if (!regexTest(expected.message, msg))
                     return false;
             }
         }
@@ -73,7 +82,8 @@ export function toThrow(received, expected, isNot = false) {
         result != null &&
         typeof result.then === "function") {
         // Suppress the unhandled rejection from the returned promise
-        result.catch(() => { });
+        // Promise.resolve so plain thenables without .catch work too
+        Promise.resolve(result).catch(() => { });
         return {
             pass: false,
             message: () => "toThrow() received an async function. Use expect(fn).rejects.toThrow() for async errors.",
@@ -92,14 +102,33 @@ export function toThrow(received, expected, isNot = false) {
             if (expected === undefined) {
                 return `Expected function ${expectation}, but it threw: ${thrownStr}`;
             }
-            const expectedStr = typeof expected === "string"
-                ? `"${expected}"`
-                : expected instanceof RegExp
-                    ? expected.toString()
-                    : isErrorConstructor(expected)
-                        ? expected.name || "[AnonymousErrorConstructor]"
-                        : JSON.stringify(expected);
-            return `Expected function ${expectation} ${expectedStr}, but it threw: ${thrownStr}`;
+            return `Expected function ${expectation} ${formatExpected(expected)}, but it threw: ${thrownStr}`;
+        },
+    };
+}
+/**
+ * toThrow under `.resolves` / `.rejects`. `received` is the settled value, not
+ * a function. Same as Jest: it only counts as thrown if it's an Error.
+ */
+export function toThrowFromPromise(received, expected, isNot, promise) {
+    // Same as Jest: a non-Error function is called and treated like a sync
+    // toThrow, so `resolves.toThrow()` works on a promise of a function.
+    if (typeof received === "function" && !isErrorLike(received)) {
+        return toThrow(received, expected, isNot);
+    }
+    const isError = isErrorLike(received);
+    const matched = isError && matchThrown(received, expected);
+    const pass = isNot ? !matched : matched;
+    return {
+        pass,
+        message: () => {
+            const verb = promise === "rejects" ? "reject" : "resolve";
+            const past = promise === "rejects" ? "rejected" : "resolved";
+            const target = expected === undefined ? "an Error" : formatExpected(expected);
+            const got = isError
+                ? formatThrown(received)
+                : `a non-Error value: ${formatThrown(received)}`;
+            return `Expected promise ${isNot ? "not " : ""}to ${verb} with ${target}, but it ${past} with ${got}`;
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unrift/core",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Core engine for the Unrift TypeScript test framework - runner, matchers, CLI, and programmatic API",
   "private": false,
   "sideEffects": false,