@unrift/core 0.4.0 → 0.5.0

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>;

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/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.js

@@ -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) {
@@ -229,6 +245,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/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,7 @@ 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;
 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"}

package/dist/esm/utils/helpers.js

@@ -124,3 +124,10 @@ 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)}`);
+    }
+}

package/package.json

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