@unrift/core 0.2.1 → 0.4.0

package/dist/esm/runner.js

@@ -1,38 +1,33 @@
-import { relative, resolve } from "node:path";
+import { watch as fsWatch, readdirSync } from "node:fs";
+import { relative, resolve, join } from "node:path";
 import { loadConfig, loadConfigFromPath, } from "./utils/loadConfig.js";
 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 { 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)
         return;
     (json ? console.error : console.log)(...args);
 }
-function safeRegExp(source) {
-    try {
-        return new RegExp(source);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`Invalid regex "${source}": ${msg}`);
-    }
-}
 const regExpCache = new Map();
 function getCachedRegExp(pattern) {
     let re = regExpCache.get(pattern);
     if (!re) {
-        re = safeRegExp(pattern);
+        re = isGlobPattern(pattern) ? globToRegex(pattern) : safeRegExp(pattern);
         regExpCache.set(pattern, re);
     }
     return re;
 }
-/**
- * @TODO Add glob support
- */
 function matchesAnyPattern(fileAbs, patterns, baseDir) {
     const absolutePath = normalizePath(fileAbs);
     const relativePath = normalizePath(relative(baseDir, fileAbs));
@@ -51,6 +46,32 @@ function filterByIncludesExcludes(files, baseDir, includes, excludes) {
     }
     return filtered;
 }
+function filterStack(stack) {
+    const lines = stack.split("\n");
+    const message = [];
+    const frames = [];
+    for (const line of lines) {
+        if (line.trimStart().startsWith("at ")) {
+            frames.push(line);
+        }
+        else {
+            message.push(line);
+        }
+    }
+    const filtered = frames.filter((line) => {
+        if (line.includes("node:"))
+            return false;
+        if (line.includes("/@unrift/core/dist/"))
+            return false;
+        if (line.includes("/unrift/dist/"))
+            return false;
+        if (line.includes("/dist/esm/"))
+            return false;
+        return true;
+    });
+    const kept = filtered.length > 0 ? filtered : frames;
+    return [...message, ...kept].join("\n");
+}
 function formatDuration(ms) {
     if (ms < 1000)
         return `${ms.toFixed(0)}ms`;
@@ -127,7 +148,8 @@ function extractTestName(description) {
     return description.replace(/^.*?›\s*/, "");
 }
 export async function runTestsCLI(options = {}) {
-    const runStart = performance.now();
+    regExpCache.clear();
+    const runStart = realPerformanceNow();
     // Cache clean mode
     if (options.cacheClean) {
         const projectRoot = process.cwd();
@@ -142,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;
@@ -162,8 +184,10 @@ export async function runTestsCLI(options = {}) {
     // Test dir is relative to config dir if config is loaded
     const testDir = resolve(configDir, config?.testDir ?? options.testDir ?? "test");
     let files = discoverTestFiles(testDir);
-    if (options.pattern) {
-        files = files.filter((f) => options.pattern.test(normalizePath(f)));
+    const pattern = options.pattern ??
+        (config?.pattern ? safeRegExp(config.pattern) : undefined);
+    if (pattern) {
+        files = files.filter((f) => pattern.test(normalizePath(f)));
     }
     files = filterByIncludesExcludes(files, testDir, config?.includes, config?.excludes).sort((a, b) => normalizePath(a).localeCompare(normalizePath(b)));
     debugLog(options.debug, options.json, "Discovered test files:", files);
@@ -196,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));
@@ -246,7 +270,7 @@ export async function runTestsCLI(options = {}) {
         });
     }
     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 = {
@@ -269,7 +293,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) {
@@ -296,14 +320,13 @@ export async function runTestsCLI(options = {}) {
             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 depth = parts.length - 1;
+            // Print suite name when it changes (depth > 0 guards against top-level it() tests)
+            if (depth > 0 && suitePath && suitePath !== lastSuitePath) {
                 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));
@@ -325,14 +348,14 @@ 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) => {
             const testName = extractTestName(r.description);
             console.log(colors.boldRed(`  ${i + 1}) ${testName}`));
             if (r.error) {
-                const errText = r.error.stack ?? r.error.message;
+                const errText = filterStack(r.error.stack ?? r.error.message);
                 const lines = errText.split("\n");
                 for (const line of lines) {
                     // Highlight the "Received/Expected" lines differently
@@ -355,7 +378,7 @@ export async function runTestsCLI(options = {}) {
         });
         console.log(`\n${horizontalRule()}`);
     }
-    // ── Summary ────────────────────────────────────────────────────────
+    // Summary
     console.log("");
     const summaryParts = [];
     if (passed > 0)
@@ -373,3 +396,90 @@ export async function runTestsCLI(options = {}) {
     if (!ok)
         process.exitCode = 1;
 }
+/**
+ * Watch a directory tree for changes, calling `onChange` after a debounce.
+ * Uses individual `fs.watch()` calls per directory so it works on all
+ * platforms (Linux `fs.watch` does not support `recursive: true` before Node 22).
+ * Returns a cleanup function to stop watching.
+ */
+function watchRecursive(dir, onChange, debounceMs = 150) {
+    let timer = null;
+    let lastFile = "";
+    function trigger(filename) {
+        lastFile = filename;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => onChange(lastFile), debounceMs);
+    }
+    const watchers = [];
+    function watchDir(d) {
+        try {
+            watchers.push(fsWatch(d, (_event, filename) => trigger(filename ?? d)));
+        }
+        catch {
+            return;
+        }
+        let entries;
+        try {
+            entries = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() &&
+                !entry.name.startsWith(".") &&
+                entry.name !== "node_modules") {
+                watchDir(join(d, entry.name));
+            }
+        }
+    }
+    watchDir(dir);
+    return () => {
+        if (timer)
+            clearTimeout(timer);
+        for (const w of watchers) {
+            try {
+                w.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+    };
+}
+export async function watchTestsCLI(options = {}) {
+    // Run once immediately
+    await runTestsCLI(options);
+    // Resolve the directory to watch (same logic as runTestsCLI)
+    const loaded = options.configPath
+        ? await import("./utils/loadConfig").then((m) => m.loadConfigFromPath(options.configPath))
+        : await import("./utils/loadConfig").then((m) => m.loadConfig(process.cwd()));
+    const config = loaded?.config ?? null;
+    const configDir = loaded?.configDir ?? process.cwd();
+    const testDir = resolve(configDir, config?.testDir ?? options.testDir ?? "test");
+    console.log(`\n ${colors.dim("↺")} ${colors.dim("Watching")} ${colors.bold(shortenPath(testDir))} ${colors.dim("for changes…  Ctrl+C to quit")}\n`);
+    let running = false;
+    const stop = watchRecursive(testDir, async (filename) => {
+        if (running)
+            return;
+        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`);
+        // Reset exit code so each run is evaluated independently
+        process.exitCode = 0;
+        try {
+            await runTestsCLI(options);
+        }
+        finally {
+            running = false;
+        }
+        console.log(` ${colors.dim("↺")} ${colors.dim("Watching for changes…  Ctrl+C to quit")}\n`);
+    });
+    // Keep process alive and clean up on exit
+    process.on("SIGINT", () => {
+        stop();
+        process.exit(0);
+    });
+}

package/dist/esm/test.d.ts

@@ -6,7 +6,8 @@ export declare class Test {
     fn: PromisableFn<void>;
     mode: TaskMode;
     status: TaskStatus;
-    constructor(description: string, fn: PromisableFn<void>, mode?: TaskMode);
-    run(timeoutMs?: number): Promise<void>;
+    timeoutMs?: number;
+    constructor(description: string, fn: PromisableFn<void>, mode?: TaskMode, timeoutMs?: 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;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"}
+{"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"}

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;
@@ -7,12 +12,15 @@ export class Test {
     fn;
     mode;
     status = TaskStatus.Pending;
-    constructor(description, fn, mode = TaskMode.Default) {
+    timeoutMs;
+    constructor(description, fn, mode = TaskMode.Default, timeoutMs) {
         this.description = description;
         this.fn = fn;
         this.mode = mode;
+        this.timeoutMs = timeoutMs;
     }
-    async run(timeoutMs) {
+    async run(globalTimeoutMs) {
+        const timeoutMs = this.timeoutMs ?? globalTimeoutMs;
         if (this.mode === TaskMode.Skip) {
             this.status = TaskStatus.Skipped;
             this.durationMs = 0;
@@ -23,7 +31,7 @@ export class Test {
             this.durationMs = 0;
             return;
         }
-        const start = performance.now();
+        const start = realPerformanceNow();
         this.status = TaskStatus.Running;
         const exec = Promise.resolve().then(() => this.fn());
         try {
@@ -34,9 +42,11 @@ export class Test {
                         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]);
                 }
@@ -55,7 +65,7 @@ export class Test {
             this.status = TaskStatus.Fail;
         }
         finally {
-            this.durationMs = performance.now() - start;
+            this.durationMs = realPerformanceNow() - start;
         }
     }
 }

package/dist/esm/types.d.ts

@@ -5,7 +5,6 @@ export declare enum TaskStatus {
     Running = "running",
     Pass = "pass",
     Fail = "fail",
-    Only = "only",
     Skipped = "skipped",
     Todo = "todo"
 }

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

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

@@ -4,7 +4,6 @@ export var TaskStatus;
     TaskStatus["Running"] = "running";
     TaskStatus["Pass"] = "pass";
     TaskStatus["Fail"] = "fail";
-    TaskStatus["Only"] = "only";
     TaskStatus["Skipped"] = "skipped";
     TaskStatus["Todo"] = "todo";
 })(TaskStatus || (TaskStatus = {}));

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

@@ -1 +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"}
+{"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,CA4TT"}

package/dist/esm/utils/compareEngine.js

@@ -142,6 +142,21 @@ 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²)
+            let allPrimitive = true;
+            for (const v of leftSet) {
+                if (!isPrimitive(v)) {
+                    allPrimitive = false;
+                    break;
+                }
+            }
+            if (allPrimitive) {
+                for (const v of leftSet) {
+                    if (!rightSet.has(v))
+                        return false;
+                }
+                continue;
+            }
             const remaining = new Set(rightSet);
             outer: for (const leftValue of leftSet) {
                 for (const rightValue of remaining) {
@@ -164,6 +179,22 @@ 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²)
+            let allKeysPrimitive = true;
+            for (const k of leftMap.keys()) {
+                if (!isPrimitive(k)) {
+                    allKeysPrimitive = false;
+                    break;
+                }
+            }
+            if (allKeysPrimitive) {
+                for (const [leftKey, leftValue] of leftMap.entries()) {
+                    if (!rightMap.has(leftKey))
+                        return false;
+                    worklist.push([leftValue, rightMap.get(leftKey)]);
+                }
+                continue;
+            }
             const remainingEntries = new Set(rightMap.entries());
             outer: for (const [leftKey, leftValue] of leftMap.entries()) {
                 for (const candidate of remainingEntries) {
@@ -199,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

@@ -1,6 +1,5 @@
 export interface UnriftConfigOptions {
     testDir?: string;
-    rootDir?: string;
     timeoutMs?: number;
     bail?: boolean;
     pattern?: 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,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,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/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/utils/diff.ts"],"names":[],"mappings":"AA2EA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CA6BvE"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/utils/diff.ts"],"names":[],"mappings":"AAuGA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAsCvE"}

package/dist/esm/utils/diff.js

@@ -37,6 +37,32 @@ function formatValue(value, indent = 2) {
     }
     return String(value);
 }
+function diffArrays(received, expected) {
+    const len = Math.max(received.length, expected.length);
+    const lines = [];
+    for (let i = 0; i < len; i++) {
+        const inReceived = i < received.length;
+        const inExpected = i < expected.length;
+        if (inReceived && inExpected) {
+            const rv = formatValue(received[i]);
+            const ev = formatValue(expected[i]);
+            if (rv !== ev) {
+                lines.push(colors.red(`  - [${i}]: ${rv}`));
+                lines.push(colors.green(`  + [${i}]: ${ev}`));
+            }
+            else {
+                lines.push(`    [${i}]: ${rv}`);
+            }
+        }
+        else if (inReceived) {
+            lines.push(colors.red(`  - [${i}]: ${formatValue(received[i])}`));
+        }
+        else {
+            lines.push(colors.green(`  + [${i}]: ${formatValue(expected[i])}`));
+        }
+    }
+    return lines.join("\n");
+}
 function diffObjects(received, expected) {
     const allKeys = new Set([...Object.keys(received), ...Object.keys(expected)]);
     const lines = [];
@@ -64,6 +90,11 @@ function diffObjects(received, expected) {
     return lines.join("\n");
 }
 export function formatDiff(received, expected) {
+    // For arrays, provide per-element diffing
+    if (Array.isArray(received) && Array.isArray(expected)) {
+        const diff = diffArrays(received, expected);
+        return (`\n${colors.red("- Received")} / ${colors.green("+ Expected")}\n\n` + diff);
+    }
     // For objects, provide a structural diff
     if (received !== null &&
         expected !== null &&

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

@@ -3,6 +3,27 @@ export type TypedArray = Uint8Array | Int8Array | Uint16Array | Int16Array | Uin
 export declare function isPrimitive(value: unknown): value is Primitive;
 export declare function isObjectLike(value: unknown): value is object;
 export declare function isTypedArray(value: unknown): value is TypedArray;
+/**
+ * Returns true if the string looks like a glob pattern (contains * ? [ { }).
+ * Patterns without these characters are treated as regex strings for backward compatibility.
+ */
+export declare function isGlobPattern(pattern: string): boolean;
+/**
+ * Converts a glob pattern to a RegExp.
+ * Supports: ** (any path), * (any segment), ? (single char), {a,b} (alternation), [abc] (char class).
+ */
+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

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

package/dist/esm/utils/helpers.js

@@ -14,6 +14,103 @@ export function isObjectLike(value) {
 export function isTypedArray(value) {
     return ArrayBuffer.isView(value) && !(value instanceof DataView);
 }
+/**
+ * Returns true if the string looks like a glob pattern (contains * ? [ { }).
+ * Patterns without these characters are treated as regex strings for backward compatibility.
+ */
+export function isGlobPattern(pattern) {
+    return /[*?[\]{]/.test(pattern);
+}
+/**
+ * Converts a glob pattern to a RegExp.
+ * Supports: ** (any path), * (any segment), ? (single char), {a,b} (alternation), [abc] (char class).
+ */
+export function globToRegex(glob) {
+    let src = "";
+    let i = 0;
+    while (i < glob.length) {
+        const c = glob[i];
+        if (c === "*") {
+            if (glob[i + 1] === "*") {
+                // ** matches anything including path separators
+                src += ".*";
+                i += 2;
+                // consume optional trailing slash so "fixtures/**" works
+                if (glob[i] === "/")
+                    i++;
+            }
+            else {
+                // * matches anything within a single path segment
+                src += "[^/]*";
+                i++;
+            }
+        }
+        else if (c === "?") {
+            src += "[^/]";
+            i++;
+        }
+        else if (c === "[") {
+            // Pass character classes through as-is
+            const close = glob.indexOf("]", i);
+            if (close !== -1) {
+                src += glob.slice(i, close + 1);
+                i = close + 1;
+            }
+            else {
+                src += "\\[";
+                i++;
+            }
+        }
+        else if (c === "{") {
+            // {a,b,c} → (a|b|c)
+            const close = glob.indexOf("}", i);
+            if (close !== -1) {
+                const parts = glob
+                    .slice(i + 1, close)
+                    .split(",")
+                    .map((p) => p.replace(/[.+^${}()|[\]\\]/g, "\\$&"));
+                src += `(${parts.join("|")})`;
+                i = close + 1;
+            }
+            else {
+                src += "\\{";
+                i++;
+            }
+        }
+        else if (/[.+^$|()\\]/.test(c)) {
+            // Escape regex special characters
+            src += "\\" + c;
+            i++;
+        }
+        else {
+            src += c;
+            i++;
+        }
+    }
+    return new RegExp(src);
+}
+export function safeRegExp(source) {
+    try {
+        return new RegExp(source);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        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

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

@@ -1 +1 @@
-{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/loadConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAU1D,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAE5B,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAuCF,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAevB;AAqCD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAc9B"}
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../../src/utils/loadConfig.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAU1D,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAE5B,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAuCF,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAevB;AAqCD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAc9B"}