@unrift/core 0.3.0 → 0.5.0

package/dist/esm/runner.js

@@ -8,6 +8,11 @@ import { runEngine } from "./run.js";
 import { normalizePath } from "./utils/normalizePath.js";
 import { safeRegExp, isGlobPattern, globToRegex } from "./utils/helpers.js";
 import { TaskStatus } from "./types.js";
+/**
+ * Captured at module load so the runner's own timing measurements
+ * aren't affected by user mocks (e.g. mock.useFakeTimers patches performance.now).
+ */
+const realPerformanceNow = performance.now.bind(performance);
 function debugLog(enabled, json, ...args) {
     // Keep stdout clean for --json mode; use stderr for debug.
     if (!enabled)
@@ -144,7 +149,7 @@ function extractTestName(description) {
 }
 export async function runTestsCLI(options = {}) {
     regExpCache.clear();
-    const runStart = performance.now();
+    const runStart = realPerformanceNow();
     // Cache clean mode
     if (options.cacheClean) {
         const projectRoot = process.cwd();
@@ -159,7 +164,7 @@ export async function runTestsCLI(options = {}) {
             if (result.tempCacheDeleted)
                 lines.push("✔ deleted temp cache");
             if (lines.length === 0)
-                lines.push("— nothing to clean");
+                lines.push("- nothing to clean");
             console.log(lines.join("\n"));
         }
         return;
@@ -215,7 +220,7 @@ export async function runTestsCLI(options = {}) {
                 testDir: dir,
                 configPath: resolvedConfigPath,
                 files: [],
-                durationMs: performance.now() - runStart,
+                durationMs: realPerformanceNow() - runStart,
                 results: [],
             };
             console.log(JSON.stringify(report, null, 2));
@@ -232,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);
@@ -259,13 +266,14 @@ 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,
         });
     }
     const ok = failed === 0;
-    const durationMs = performance.now() - runStart;
+    const durationMs = realPerformanceNow() - runStart;
     // JSON mode: stdout must be JSON only
     if (options.json) {
         const report = {
@@ -288,7 +296,7 @@ export async function runTestsCLI(options = {}) {
             process.exitCode = 1;
         return;
     }
-    // ── Pretty reporting ──────────────────────────────────────────────
+    // Pretty reporting
     const groups = groupResultsByFile(results);
     // File-by-file results
     for (const group of groups) {
@@ -323,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) {
@@ -343,7 +354,7 @@ export async function runTestsCLI(options = {}) {
             }
         }
     }
-    // ── Failure details ────────────────────────────────────────────────
+    // Failure details
     if (failures.length > 0) {
         console.log(`\n${horizontalRule(colors.boldRed(" FAILURES "))}\n`);
         failures.forEach((r, i) => {
@@ -373,7 +384,7 @@ export async function runTestsCLI(options = {}) {
         });
         console.log(`\n${horizontalRule()}`);
     }
-    // ── Summary ────────────────────────────────────────────────────────
+    // Summary
     console.log("");
     const summaryParts = [];
     if (passed > 0)
@@ -461,7 +472,7 @@ export async function watchTestsCLI(options = {}) {
         running = true;
         const shortFile = shortenPath(filename);
         console.log(`\n${colors.dim("─".repeat(Math.min(process.stdout.columns || 80, 80)))}`);
-        console.log(` ${colors.dim("↺")} ${colors.dim(`${shortFile} changed — re-running…`)}\n`);
+        console.log(` ${colors.dim("↺")} ${colors.dim(`${shortFile} changed - re-running…`)}\n`);
         // Reset exit code so each run is evaluated independently
         process.exitCode = 0;
         try {

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;AAGlE,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;CAuDnD"}
+{"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

@@ -1,5 +1,10 @@
 import { TaskMode, TaskStatus } from "./types.js";
 import { toError } from "./utils/toError.js";
+/**
+ * Captured at module load so the runner's own timing measurements are
+ * immune to user mocks (e.g. mock.useFakeTimers patches performance.now).
+ */
+const realPerformanceNow = performance.now.bind(performance);
 export class Test {
     description;
     durationMs = 0;
@@ -8,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;
@@ -26,20 +36,24 @@ export class Test {
             this.durationMs = 0;
             return;
         }
-        const start = performance.now();
+        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);
                 });
-                // NOTE: Promise.race does not cancel the losing promise. A timed-out test
-                // function continues running in the background. True cancellation would
-                // require AbortController integration, which is a larger future change.
+                /**
+                 * NOTE: Promise.race does not cancel the losing promise. A timed-out test
+                 * function continues running in the background. True cancellation would
+                 * require AbortController integration, which is a larger future change.
+                 */
                 try {
                     await Promise.race([exec, timeoutFn]);
                 }
@@ -58,7 +72,7 @@ export class Test {
             this.status = TaskStatus.Fail;
         }
         finally {
-            this.durationMs = performance.now() - start;
+            this.durationMs = realPerformanceNow() - start;
         }
     }
 }

package/dist/esm/utils/compareEngine.js

@@ -142,7 +142,7 @@ export function compareInternal(left, right, options, leftToRightSeen, rightToLe
             const rightSet = currentRight;
             if (leftSet.size !== rightSet.size)
                 return false;
-            // Fast path: primitive-only sets can use has() directly — O(n) vs O(n²)
+            // Fast path: primitive-only sets can use has() directly - O(n) vs O(n²)
             let allPrimitive = true;
             for (const v of leftSet) {
                 if (!isPrimitive(v)) {
@@ -179,7 +179,7 @@ export function compareInternal(left, right, options, leftToRightSeen, rightToLe
             const rightMap = currentRight;
             if (leftMap.size !== rightMap.size)
                 return false;
-            // Fast path: primitive-only keys can use get() directly — O(n) vs O(n²)
+            // Fast path: primitive-only keys can use get() directly - O(n) vs O(n²)
             let allKeysPrimitive = true;
             for (const k of leftMap.keys()) {
                 if (!isPrimitive(k)) {
@@ -230,7 +230,7 @@ export function compareInternal(left, right, options, leftToRightSeen, rightToLe
             }
         }
         else {
-            // Prototype-insensitive (looseEqual) — union-of-keys, missing ≈ undefined
+            // Prototype-insensitive (looseEqual) - union-of-keys, missing ≈ undefined
             const leftKeys = Object.keys(currentLeft);
             const rightKeys = Object.keys(currentRight);
             const allKeys = new Set([...leftKeys, ...rightKeys]);

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

@@ -21,7 +21,7 @@ export function discoverTestFiles(dir) {
                 }
             }
             catch {
-                // Broken symlink — skip silently
+                // Broken symlink - skip silently
             }
             continue;
         }

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

@@ -14,11 +14,23 @@ export declare function isGlobPattern(pattern: string): boolean;
  */
 export declare function globToRegex(glob: string): RegExp;
 export declare function safeRegExp(source: string): RegExp;
+/**
+ * Stateless RegExp match for user-supplied patterns.
+ *
+ * `RegExp.prototype.test` advances `lastIndex` for `/g` and `/y` regexes, so
+ * reusing the same regex object across calls (a matcher tested against several
+ * requests, or the same assertion run twice) can start mid-string and miss.
+ * Resetting `lastIndex` first makes every test independent - "does this pattern
+ * match the string" regardless of prior calls.
+ */
+export declare function regexTest(re: RegExp, value: string): boolean;
 /**
  * SameValueZero-ish semantics:
  * - NaN equals NaN
  * - +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;;;;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

@@ -98,6 +98,19 @@ export function safeRegExp(source) {
         throw new Error(`Invalid regex "${source}": ${msg}`);
     }
 }
+/**
+ * Stateless RegExp match for user-supplied patterns.
+ *
+ * `RegExp.prototype.test` advances `lastIndex` for `/g` and `/y` regexes, so
+ * reusing the same regex object across calls (a matcher tested against several
+ * requests, or the same assertion run twice) can start mid-string and miss.
+ * Resetting `lastIndex` first makes every test independent - "does this pattern
+ * match the string" regardless of prior calls.
+ */
+export function regexTest(re, value) {
+    re.lastIndex = 0;
+    return re.test(value);
+}
 /**
  * SameValueZero-ish semantics:
  * - NaN equals NaN
@@ -111,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/dist/esm/utils/toThrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/toThrow.ts"],"names":[],"mappings":"AAAA,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;AAgED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,KAAK,UAAQ,GACZ,WAAW,CAgEb"}

package/dist/esm/utils/toThrow.js

@@ -1,3 +1,4 @@
+import { regexTest } from "./helpers.js";
 function isErrorConstructor(err) {
     return typeof err === "function";
 }
@@ -24,7 +25,7 @@ function matchThrown(thrown, expected) {
     }
     // toThrow(/regex/)
     if (expected instanceof RegExp) {
-        return expected.test(msg);
+        return regexTest(expected, msg);
     }
     // toThrow(ErrorClass)
     if (isErrorConstructor(expected)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unrift/core",
-  "version": "0.3.0",
-  "description": "Core engine for the Unrift TypeScript test framework — runner, matchers, CLI, and programmatic API",
+  "version": "0.5.0",
+  "description": "Core engine for the Unrift TypeScript test framework - runner, matchers, CLI, and programmatic API",
   "private": false,
   "sideEffects": false,
   "main": "./dist/cjs/index.cjs",
@@ -58,7 +58,8 @@
     "access": "public"
   },
   "dependencies": {
-    "esbuild": "^0.27.2"
+    "esbuild": "^0.27.2",
+    "memfs": "^4.57.7"
   },
   "devDependencies": {
     "ts-node": "^10.9.2",