@unrift/core 0.0.0 → 0.2.0

package/dist/esm/runner.js

@@ -4,11 +4,8 @@ import { cleanUnriftCaches } from "./utils/transform.js";
 import { colors } from "./utils/colors.js";
 import { discoverTestFiles } from "./utils/discoverTestFiles.js";
 import { runEngine } from "./run.js";
+import { normalizePath } from "./utils/normalizePath.js";
 import { TaskStatus } from "./types.js";
-function normalizePath(p) {
-    // stable for matching/reporting across platforms
-    return p.replace(/\\/g, "/");
-}
 function debugLog(enabled, json, ...args) {
     // Keep stdout clean for --json mode; use stderr for debug.
     if (!enabled)
@@ -24,6 +21,15 @@ function safeRegExp(source) {
         throw new Error(`Invalid regex "${source}": ${msg}`);
     }
 }
+const regExpCache = new Map();
+function getCachedRegExp(pattern) {
+    let re = regExpCache.get(pattern);
+    if (!re) {
+        re = safeRegExp(pattern);
+        regExpCache.set(pattern, re);
+    }
+    return re;
+}
 /**
  * @TODO Add glob support
  */
@@ -31,7 +37,7 @@ function matchesAnyPattern(fileAbs, patterns, baseDir) {
     const absolutePath = normalizePath(fileAbs);
     const relativePath = normalizePath(relative(baseDir, fileAbs));
     return patterns.some((pattern) => {
-        const re = safeRegExp(pattern);
+        const re = getCachedRegExp(pattern);
         return re.test(relativePath) || re.test(absolutePath);
     });
 }
@@ -50,15 +56,76 @@ function formatDuration(ms) {
         return `${ms.toFixed(0)}ms`;
     return `${(ms / 1000).toFixed(2)}s`;
 }
-function padRight(str, width) {
-    return str.length >= width ? str : str + " ".repeat(width - str.length);
-}
 function getFileHeadingFromDescription(description) {
     const index = description.indexOf("›");
     if (index === -1)
         return null;
     return description.slice(0, index).trim();
 }
+function shortenPath(absPath) {
+    const cwd = normalizePath(process.cwd());
+    const norm = normalizePath(absPath);
+    if (norm.startsWith(cwd + "/"))
+        return norm.slice(cwd.length + 1);
+    return norm;
+}
+function horizontalRule(label) {
+    const width = Math.min(process.stdout.columns || 80, 80);
+    if (!label)
+        return colors.dim("─".repeat(width));
+    const padding = 2;
+    const labelLen = label.length + padding * 2;
+    const sideLen = Math.max(1, Math.floor((width - labelLen) / 2));
+    const left = "─".repeat(sideLen);
+    const right = "─".repeat(Math.max(1, width - sideLen - labelLen));
+    return (colors.dim(`${left}${"─".repeat(padding)}`) +
+        label +
+        colors.dim(`${"─".repeat(padding)}${right}`));
+}
+function groupResultsByFile(results) {
+    const groups = [];
+    let current = null;
+    for (const result of results) {
+        const heading = getFileHeadingFromDescription(result.description);
+        const key = heading ?? "";
+        if (!current || current.heading !== key) {
+            current = { heading: key, results: [] };
+            groups.push(current);
+        }
+        current.results.push(result);
+    }
+    return groups;
+}
+function getFileStats(group) {
+    let pass = 0;
+    let fail = 0;
+    let skip = 0;
+    let todoCount = 0;
+    let totalDuration = 0;
+    for (const r of group.results) {
+        if (r.status === TaskStatus.Pass)
+            pass++;
+        else if (r.status === TaskStatus.Fail)
+            fail++;
+        else if (r.status === TaskStatus.Skipped)
+            skip++;
+        else if (r.status === TaskStatus.Todo)
+            todoCount++;
+        totalDuration += r.durationMs;
+    }
+    return {
+        pass,
+        fail,
+        skip,
+        todo: todoCount,
+        total: group.results.length,
+        totalDuration,
+    };
+}
+function extractTestName(description) {
+    // Remove the file heading and first suite separator, keep nested describe structure
+    return description.replace(/^.*?›\s*/, "");
+}
 export async function runTestsCLI(options = {}) {
     const runStart = performance.now();
     // Cache clean mode
@@ -113,6 +180,33 @@ export async function runTestsCLI(options = {}) {
         }
         return;
     }
+    // No test files found
+    if (files.length === 0) {
+        const dir = normalizePath(testDir);
+        if (options.json) {
+            const report = {
+                ok: false,
+                failed: 0,
+                passed: 0,
+                skipped: 0,
+                todo: 0,
+                total: 0,
+                bail: options.bail ?? config?.bail ?? false,
+                timeoutMs: options.timeoutMs ?? config?.timeoutMs,
+                testDir: dir,
+                configPath: resolvedConfigPath,
+                files: [],
+                durationMs: performance.now() - runStart,
+                results: [],
+            };
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(`\n ${colors.boldYellow("!")} No test files found in ${colors.bold(dir)}\n`);
+        }
+        process.exitCode = 1;
+        return;
+    }
     const timeoutMs = options.timeoutMs ?? config?.timeoutMs;
     const bail = options.bail ?? config?.bail ?? false;
     const engine = await runEngine({
@@ -127,6 +221,7 @@ export async function runTestsCLI(options = {}) {
     let passed = 0;
     let failed = 0;
     let skipped = 0;
+    let todo = 0;
     const failures = [];
     const serializedResults = [];
     for (const result of results) {
@@ -137,6 +232,8 @@ export async function runTestsCLI(options = {}) {
             skipped++;
         else if (result.status === TaskStatus.Fail)
             failed++;
+        else if (result.status === TaskStatus.Todo)
+            todo++;
         if (result.status === TaskStatus.Fail)
             failures.push(result);
         serializedResults.push({
@@ -157,6 +254,7 @@ export async function runTestsCLI(options = {}) {
             failed,
             passed,
             skipped,
+            todo,
             total,
             bail,
             timeoutMs,
@@ -171,37 +269,107 @@ export async function runTestsCLI(options = {}) {
             process.exitCode = 1;
         return;
     }
-    // Standard reporting
-    const durationColWidth = 8;
-    let lastHeading = null;
-    for (const result of results) {
-        const heading = getFileHeadingFromDescription(result.description);
-        if (heading && heading !== lastHeading) {
-            console.log(colors.bold(`\n${heading}`));
-            lastHeading = heading;
-        }
-        const duration = formatDuration(result.durationMs ?? 0);
-        const durationPadded = padRight(duration, durationColWidth);
-        if (result.status === TaskStatus.Pass) {
-            console.log(colors.green("✔"), durationPadded, result.description.replace(/^.*?›\s*/, ""));
-            continue;
-        }
-        if (result.status === TaskStatus.Skipped) {
-            console.log(colors.yellow("↷"), padRight("—", durationColWidth), result.description.replace(/^.*?›\s*/, ""));
-            continue;
+    // ── Pretty reporting ──────────────────────────────────────────────
+    const groups = groupResultsByFile(results);
+    // File-by-file results
+    for (const group of groups) {
+        const stats = getFileStats(group);
+        const shortPath = shortenPath(group.heading);
+        // File heading with inline summary
+        const fileIcon = stats.fail > 0 ? colors.boldRed("✘") : colors.boldGreen("✓");
+        const countParts = [];
+        if (stats.pass > 0)
+            countParts.push(colors.green(`${stats.pass} passed`));
+        if (stats.fail > 0)
+            countParts.push(colors.red(`${stats.fail} failed`));
+        if (stats.skip > 0)
+            countParts.push(colors.yellow(`${stats.skip} skipped`));
+        if (stats.todo > 0)
+            countParts.push(colors.magenta(`${stats.todo} todo`));
+        const fileDuration = colors.dim(formatDuration(stats.totalDuration));
+        const countSummary = colors.dim("(") + countParts.join(colors.dim(", ")) + colors.dim(")");
+        console.log(`\n ${fileIcon} ${colors.bold(shortPath)} ${countSummary} ${fileDuration}`);
+        // Individual test results, indented
+        let lastSuitePath = "";
+        for (const result of group.results) {
+            const testName = extractTestName(result.description);
+            const parts = testName.split(" › ");
+            const leaf = parts[parts.length - 1];
+            const suitePath = parts.slice(0, -1).join(" › ");
+            // Print suite name when it changes
+            if (suitePath && suitePath !== lastSuitePath) {
+                const depth = parts.length - 1;
+                const suiteIndent = "   " + "  ".repeat(Math.max(0, depth - 1));
+                console.log(`${suiteIndent}${colors.dim("›")} ${colors.bold(parts[depth - 1])}`);
+                lastSuitePath = suitePath;
+            }
+            const depth = parts.length - 1;
+            const indent = "   " + "  ".repeat(depth);
+            if (result.status === TaskStatus.Pass) {
+                const dur = colors.dim(formatDuration(result.durationMs ?? 0));
+                console.log(`${indent}${colors.green("✔")} ${colors.dim(leaf)} ${dur}`);
+                continue;
+            }
+            if (result.status === TaskStatus.Fail) {
+                const dur = colors.dim(formatDuration(result.durationMs ?? 0));
+                console.log(`${indent}${colors.red("✘")} ${colors.boldRed(leaf)} ${dur}`);
+                continue;
+            }
+            if (result.status === TaskStatus.Skipped) {
+                console.log(`${indent}${colors.yellow("↷")} ${colors.dim(leaf)}`);
+                continue;
+            }
+            if (result.status === TaskStatus.Todo) {
+                console.log(`${indent}${colors.magenta("○")} ${colors.dim(leaf)}`);
+                continue;
+            }
         }
-        // Fail
-        console.log(colors.red("✘"), durationPadded, result.description.replace(/^.*?›\s*/, ""));
     }
+    // ── Failure details ────────────────────────────────────────────────
     if (failures.length > 0) {
-        console.log(colors.bold("\nFailures:"));
+        console.log(`\n${horizontalRule(colors.boldRed(" FAILURES "))}\n`);
         failures.forEach((r, i) => {
-            console.log(colors.red(`\n${i + 1}) ${r.description}`));
-            if (r.error)
-                console.log(colors.red(r.error.stack ?? r.error.message));
+            const testName = extractTestName(r.description);
+            console.log(colors.boldRed(`  ${i + 1}) ${testName}`));
+            if (r.error) {
+                const errText = r.error.stack ?? r.error.message;
+                const lines = errText.split("\n");
+                for (const line of lines) {
+                    // Highlight the "Received/Expected" lines differently
+                    if (line.trimStart().startsWith("Received:")) {
+                        console.log(colors.red(`     ${line.trim()}`));
+                    }
+                    else if (line.trimStart().startsWith("Expected:")) {
+                        console.log(colors.green(`     ${line.trim()}`));
+                    }
+                    else if (line.trim().startsWith("at ")) {
+                        console.log(colors.dim(`     ${line.trim()}`));
+                    }
+                    else {
+                        console.log(`     ${colors.red(line.trim())}`);
+                    }
+                }
+            }
+            if (i < failures.length - 1)
+                console.log("");
         });
+        console.log(`\n${horizontalRule()}`);
     }
-    console.log(colors.bold(`\nPassed: ${passed}  Failed: ${failed}  Skipped: ${skipped}  Total: ${total}  Time: ${formatDuration(durationMs)}\n`));
+    // ── Summary ────────────────────────────────────────────────────────
+    console.log("");
+    const summaryParts = [];
+    if (passed > 0)
+        summaryParts.push(colors.boldGreen(`${passed} passed`));
+    if (failed > 0)
+        summaryParts.push(colors.boldRed(`${failed} failed`));
+    if (skipped > 0)
+        summaryParts.push(colors.boldYellow(`${skipped} skipped`));
+    if (todo > 0)
+        summaryParts.push(colors.magenta(`${todo} todo`));
+    const badge = ok ? colors.badgePass(" PASS ") : colors.badgeFail(" FAIL ");
+    console.log(` ${badge}  ${summaryParts.join(colors.dim("  ·  "))}  ${colors.dim("of")} ${colors.bold(String(total))} ${colors.dim("tests")}  ${colors.dim("in")} ${colors.bold(formatDuration(durationMs))}`);
+    console.log(`         ${colors.dim(`${files.length} test file${files.length === 1 ? "" : "s"}`)}${bail ? colors.dim("  ·  bail mode") : ""}`);
+    console.log("");
     if (!ok)
         process.exitCode = 1;
 }

package/dist/esm/suite.d.ts

@@ -7,16 +7,7 @@ interface RunOptions {
 interface SuiteRunState {
     bailed: boolean;
 }
-interface SuiteTask {
-    description: string;
-    parent?: Suite;
-    suites: Suite[];
-    tests: Test[];
-    addSuite(suite: Suite): void;
-    addTest(test: Test): void;
-    run(): Promise<void>;
-}
-export declare class Suite implements SuiteTask {
+export declare class Suite {
     description: string;
     mode: TaskMode;
     parent?: Suite;
@@ -36,6 +27,7 @@ export declare class Suite implements SuiteTask {
     afterEachHooks: PromisableFn<void>[];
     constructor(description: string, parent?: Suite, mode?: TaskMode);
     markSubtreeSkipped(): void;
+    markSubtreeTodo(): void;
     addSuite(suite: Suite): void;
     addTest(test: Test): void;
     private collectBeforeEachHooks;

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

@@ -1 +1 @@
-{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAElE,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAE1B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAsBD,qBAAa,KAAM,YAAW,SAAS;IACrC,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,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;IAwJhB,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;AAED,eAAO,MAAM,SAAS,OAAoB,CAAC;AAG3C,wBAAgB,eAAe,UAE9B;AAED,wBAAgB,YAAY,SAI3B"}
+{"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"}

package/dist/esm/suite.js

@@ -1,5 +1,7 @@
 import { unriftGlobalContext } from "./context.js";
+import { resetMatchers } from "./matchers.js";
 import { TaskMode, TaskStatus } from "./types.js";
+import { toError } from "./utils/toError.js";
 function appendHookFailure(existing, hookName, hookError) {
     if (!existing)
         return hookError;
@@ -40,6 +42,15 @@ export class Suite {
         for (const suite of this.suites)
             suite.markSubtreeSkipped();
     }
+    markSubtreeTodo() {
+        for (const test of this.tests) {
+            if (test.status === TaskStatus.Pending)
+                test.status = TaskStatus.Todo;
+            test.durationMs = 0;
+        }
+        for (const suite of this.suites)
+            suite.markSubtreeTodo();
+    }
     addSuite(suite) {
         this.suites.push(suite);
     }
@@ -78,6 +89,10 @@ export class Suite {
             this.markSubtreeSkipped();
             return;
         }
+        if (this.mode === TaskMode.Todo) {
+            this.markSubtreeTodo();
+            return;
+        }
         const suiteHasOnly = this.subtreeHasOnly;
         const inOnlyContext = ancestorOnly || this.mode === TaskMode.Only;
         // If only is on and this suite has no runnable-only content, skip it entirely
@@ -94,8 +109,7 @@ export class Suite {
                 }
             }
             catch (error) {
-                this.beforeAllError =
-                    error instanceof Error ? error : new Error(String(error));
+                this.beforeAllError = toError(error);
                 // Prevent "pending" tests from showing up if beforeAll fails
                 this.markSubtreeSkipped();
                 return;
@@ -113,6 +127,11 @@ export class Suite {
                     test.durationMs = 0;
                     continue;
                 }
+                if (test.mode === TaskMode.Todo) {
+                    test.status = TaskStatus.Todo;
+                    test.durationMs = 0;
+                    continue;
+                }
                 const testIsOnly = inOnlyContext || test.mode === TaskMode.Only;
                 // If onlyMode, skip tests that are not in only context
                 if (isOnly && !testIsOnly) {
@@ -126,16 +145,14 @@ export class Suite {
                             await hook();
                         }
                         catch (error) {
-                            const hookError = error instanceof Error ? error : new Error(String(error));
-                            throw appendHookFailure(undefined, "beforeEach", hookError);
+                            throw appendHookFailure(undefined, "beforeEach", toError(error));
                         }
                     }
                     await test.run(options?.timeoutMs);
                 }
                 catch (error) {
                     test.status = TaskStatus.Fail;
-                    test.error =
-                        error instanceof Error ? error : new Error(String(error));
+                    test.error = toError(error);
                 }
                 finally {
                     for (const hook of afterEachHooks) {
@@ -143,9 +160,8 @@ export class Suite {
                             await hook();
                         }
                         catch (error) {
-                            const hookError = error instanceof Error ? error : new Error(String(error));
                             test.status = TaskStatus.Fail;
-                            test.error = appendHookFailure(test.error, "afterEach", hookError);
+                            test.error = appendHookFailure(test.error, "afterEach", toError(error));
                         }
                     }
                 }
@@ -189,8 +205,7 @@ export class Suite {
                     catch (error) {
                         // Record once; keep running remaining afterAll hooks
                         if (!this.afterAllError) {
-                            this.afterAllError =
-                                error instanceof Error ? error : new Error(String(error));
+                            this.afterAllError = toError(error);
                         }
                     }
                 }
@@ -269,6 +284,9 @@ export function computeOnlyFlags(suite) {
     suite.subtreeHasOnly = subtreeHasOnly;
     return subtreeHasOnly;
 }
+// KNOWN LIMITATION: rootSuite is a global singleton. This means parallel test
+// execution in the same process is not supported. A future DI/context-container
+// pattern would be needed to support worker-based parallelism.
 export const rootSuite = new Suite("root");
 rootSuite.root = true;
 export function getCurrentSuite() {
@@ -277,5 +295,6 @@ export function getCurrentSuite() {
 export function clearContext() {
     rootSuite.reset();
     rootSuite.subtreeHasOnly = false;
+    resetMatchers();
     unriftGlobalContext.currentSuite = rootSuite;
 }

package/dist/esm/test.d.ts

@@ -1,10 +1,5 @@
 import { TaskMode, TaskStatus, type PromisableFn } from "./types";
-interface TestTask {
-    description: string;
-    fn: PromisableFn<void>;
-    run(): Promise<void>;
-}
-export declare class Test implements TestTask {
+export declare class Test {
     description: string;
     durationMs: number;
     error?: Error;
@@ -14,5 +9,4 @@ export declare class Test implements TestTask {
     constructor(description: string, fn: PromisableFn<void>, mode?: TaskMode);
     run(timeoutMs?: number): Promise<void>;
 }
-export {};
 //# 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;AAElE,UAAU,QAAQ;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACvB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,qBAAa,IAAK,YAAW,QAAQ;IACnC,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;gBAGtC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,IAAI,GAAE,QAA2B;IAO7B,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC7C"}
+{"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;gBAGtC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,IAAI,GAAE,QAA2B;IAO7B,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsD7C"}

package/dist/esm/test.js

@@ -1,4 +1,5 @@
 import { TaskMode, TaskStatus } from "./types.js";
+import { toError } from "./utils/toError.js";
 export class Test {
     description;
     durationMs = 0;
@@ -17,6 +18,11 @@ export class Test {
             this.durationMs = 0;
             return;
         }
+        if (this.mode === TaskMode.Todo) {
+            this.status = TaskStatus.Todo;
+            this.durationMs = 0;
+            return;
+        }
         const start = performance.now();
         this.status = TaskStatus.Running;
         const exec = Promise.resolve().then(() => this.fn());
@@ -25,9 +31,12 @@ export class Test {
                 let timeoutId = null;
                 const timeoutFn = new Promise((_, reject) => {
                     timeoutId = setTimeout(() => {
-                        reject(new Error(`Test timed out after ${timeoutMs} ms`));
+                        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.
                 try {
                     await Promise.race([exec, timeoutFn]);
                 }
@@ -42,7 +51,7 @@ export class Test {
             this.status = TaskStatus.Pass;
         }
         catch (error) {
-            this.error = error instanceof Error ? error : new Error(String(error));
+            this.error = toError(error);
             this.status = TaskStatus.Fail;
         }
         finally {

package/dist/esm/types.d.ts

@@ -1,4 +1,4 @@
-type Promisable<T> = Promise<T> | T;
+export type Promisable<T> = Promise<T> | T;
 export type PromisableFn<T> = () => Promisable<T>;
 export declare enum TaskStatus {
     Pending = "pending",
@@ -12,7 +12,8 @@ export declare enum TaskStatus {
 export declare enum TaskMode {
     Default = "default",
     Only = "only",
-    Skip = "skip"
+    Skip = "skip",
+    Todo = "todo"
 }
 export interface MatcherContext {
     isNot: boolean;
@@ -20,5 +21,4 @@ export interface MatcherContext {
 }
 export type MatcherFn = (this: MatcherContext, received: unknown, ...args: readonly unknown[]) => void | Promise<void>;
 export type MatcherMap = Record<string, MatcherFn>;
-export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpC,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,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,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,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"}

package/dist/esm/types.js

@@ -13,4 +13,5 @@ export var TaskMode;
     TaskMode["Default"] = "default";
     TaskMode["Only"] = "only";
     TaskMode["Skip"] = "skip";
+    TaskMode["Todo"] = "todo";
 })(TaskMode || (TaskMode = {}));

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

@@ -2,6 +2,27 @@ export declare const colors: {
     green: (text: string) => string;
     red: (text: string) => string;
     yellow: (text: string) => string;
+    cyan: (text: string) => string;
+    magenta: (text: string) => string;
+    white: (text: string) => string;
     bold: (text: string) => string;
+    dim: (text: string) => string;
+    italic: (text: string) => string;
+    underline: (text: string) => string;
+    strikethrough: (text: string) => string;
+    gray: (text: string) => string;
+    bgRed: (text: string) => string;
+    bgGreen: (text: string) => string;
+    bgYellow: (text: string) => string;
+    bgCyan: (text: string) => string;
+    boldGreen: (text: string) => string;
+    boldRed: (text: string) => string;
+    boldYellow: (text: string) => string;
+    boldCyan: (text: string) => string;
+    boldDim: (text: string) => string;
+    badgePass: (text: string) => string;
+    badgeFail: (text: string) => string;
+    badgeSkip: (text: string) => string;
+    badgeTodo: (text: string) => string;
 };
 //# sourceMappingURL=colors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;kBAHH,MAAM;gBAAN,MAAM;mBAAN,MAAM;iBAAN,MAAM;CAQrB,CAAC"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM;kBARH,MAAM;gBAAN,MAAM;mBAAN,MAAM;iBAAN,MAAM;oBAAN,MAAM;kBAAN,MAAM;iBAAN,MAAM;gBAAN,MAAM;mBAAN,MAAM;sBAAN,MAAM;0BAAN,MAAM;iBAAN,MAAM;kBAAN,MAAM;oBAAN,MAAM;qBAAN,MAAM;mBAAN,MAAM;sBAIN,MAAM;oBAAN,MAAM;uBAAN,MAAM;qBAAN,MAAM;oBAAN,MAAM;sBAAN,MAAM;sBAAN,MAAM;sBAAN,MAAM;sBAAN,MAAM;CAyCrB,CAAC"}

package/dist/esm/utils/colors.js

@@ -4,9 +4,39 @@ const enabled = process.stdout.isTTY &&
 function wrap(code) {
     return (text) => (enabled ? `\x1b[${code}m${text}\x1b[0m` : text);
 }
+function compose(...codes) {
+    return (text) => enabled ? `\x1b[${codes.join(";")}m${text}\x1b[0m` : text;
+}
 export const colors = {
-    green: wrap(32),
-    red: wrap(31),
-    yellow: wrap(33),
-    bold: wrap(1),
+    // Basic colors
+    green: wrap("32"),
+    red: wrap("31"),
+    yellow: wrap("33"),
+    cyan: wrap("36"),
+    magenta: wrap("35"),
+    white: wrap("37"),
+    // Modifiers
+    bold: wrap("1"),
+    dim: wrap("2"),
+    italic: wrap("3"),
+    underline: wrap("4"),
+    strikethrough: wrap("9"),
+    // Bright colors
+    gray: wrap("90"),
+    // Backgrounds
+    bgRed: wrap("41"),
+    bgGreen: wrap("42"),
+    bgYellow: wrap("43"),
+    bgCyan: wrap("46"),
+    // Composites
+    boldGreen: compose("1", "32"),
+    boldRed: compose("1", "31"),
+    boldYellow: compose("1", "33"),
+    boldCyan: compose("1", "36"),
+    boldDim: compose("1", "2"),
+    // Badge-style (white on colored background)
+    badgePass: compose("1", "30", "42"),
+    badgeFail: compose("1", "37", "41"),
+    badgeSkip: compose("1", "30", "43"),
+    badgeTodo: compose("1", "35"),
 };

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

@@ -0,0 +1,10 @@
+export interface CompareOptions {
+    /** true for deepEqual (prototype-sensitive), false for looseEqual */
+    checkPrototype: boolean;
+    /** true for looseEqual (sparse holes → undefined), false for deepEqual */
+    treatSparseAsUndefined: boolean;
+    /** true for looseEqual (bidirectional cycle tracking) */
+    bijectiveCycleCheck: boolean;
+}
+export declare function compareInternal(left: unknown, right: unknown, options: CompareOptions, leftToRightSeen: WeakMap<object, object>, rightToLeftSeen?: WeakMap<object, object>): boolean;
+//# sourceMappingURL=compareEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compareEngine.d.ts","sourceRoot":"","sources":["../../../src/utils/compareEngine.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,sBAAsB,EAAE,OAAO,CAAC;IAChC,yDAAyD;IACzD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAID,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,cAAc,EACvB,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CA6RT"}