@unrift/core 0.2.1 → 0.3.0

package/dist/esm/cli.js

@@ -2,7 +2,8 @@
 import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { runTestsCLI } from "./runner.js";
+import { runTestsCLI, watchTestsCLI } from "./runner.js";
+import { safeRegExp } from "./utils/helpers.js";
 const __cliDir = dirname(fileURLToPath(import.meta.url));
 function readVersion() {
     // Walk up from current file to find package.json (works from both src/ and dist/esm/)
@@ -21,15 +22,6 @@ function readVersion() {
     return "0.0.0";
 }
 const version = readVersion();
-function safeRegExp(source) {
-    try {
-        return new RegExp(source);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`Invalid pattern regex "${source}": ${msg}`);
-    }
-}
 function printHelp() {
     console.log(`
 Unrift Test Runner v${version}
@@ -41,6 +33,7 @@ Options:
   -c, --config <path>      Path to config file
   -b, --bail               Stop on first test failure
   -t, --timeout <ms>       Default test timeout in milliseconds
+  -w, --watch              Re-run tests on file changes
   -d, --debug              Enable debug logging
   -l, --list               List discovered test files
   -j, --json               Output test results as JSON
@@ -53,6 +46,7 @@ Examples:
   unrift math
   unrift -c test/config.ts --bail
   unrift --timeout 10000
+  unrift --watch
 `);
 }
 function parseArgs(argv) {
@@ -66,6 +60,7 @@ function parseArgs(argv) {
     let list = false;
     let json = false;
     let cacheClean = false;
+    let watch = false;
     const rest = [];
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
@@ -111,6 +106,10 @@ function parseArgs(argv) {
             i++;
             continue;
         }
+        if (a === "--watch" || a === "-w") {
+            watch = true;
+            continue;
+        }
         if (a === "--cache-clean" || a === "--clear-cache") {
             cacheClean = true;
             continue;
@@ -129,11 +128,12 @@ function parseArgs(argv) {
         list,
         json,
         cacheClean,
+        watch,
         help,
         showVersion,
     };
 }
-const { configPath, pattern, timeoutMs, bail, debug, list, json, cacheClean, help, showVersion, } = parseArgs(process.argv.slice(2));
+const { configPath, pattern, timeoutMs, bail, debug, list, json, cacheClean, watch, help, showVersion, } = parseArgs(process.argv.slice(2));
 if (showVersion) {
     console.log(version);
     process.exit(0);
@@ -142,7 +142,7 @@ if (help) {
     printHelp();
     process.exit(0);
 }
-runTestsCLI({
+const runOpts = {
     pattern,
     configPath,
     timeoutMs,
@@ -151,7 +151,8 @@ runTestsCLI({
     list,
     json,
     cacheClean,
-}).catch((err) => {
+};
+(watch ? watchTestsCLI(runOpts) : runTestsCLI(runOpts)).catch((err) => {
     console.error(err);
     process.exit(1);
 });

package/dist/esm/context.d.ts

@@ -4,10 +4,9 @@ export declare enum RunState {
     Run = "run",
     Idle = "idle"
 }
-type UnriftState = RunState;
 interface UnriftGlobalContext {
     currentSuite: Suite | null;
-    state: UnriftState;
+    state: RunState;
 }
 export declare const unriftGlobalContext: UnriftGlobalContext;
 export declare function assertRegisterState(apiName: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oBAAY,QAAQ;IAClB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,KAAK,WAAW,GAAG,QAAQ,CAAC;AAE5B,UAAU,mBAAmB;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,mBAGjC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,QAOlD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oBAAY,QAAQ;IAClB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,UAAU,mBAAmB;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,mBAGjC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,QAOlD"}

package/dist/esm/expect.d.ts

@@ -13,13 +13,21 @@ export interface Matchers<T> {
     toBeUndefined(): void | Promise<void>;
     toBeGreaterThan(expected: number): void | Promise<void>;
     toBeLessThan(expected: number): void | Promise<void>;
-    toBeInstanceOf(expected: new (...args: unknown[]) => unknown): void | Promise<void>;
+    toBeInstanceOf(expected: {
+        prototype: unknown;
+    }): void | Promise<void>;
     toContain(expected: unknown): void | Promise<void>;
     toEqual(expected: unknown): void | Promise<void>;
     toHaveLength(expected: number): void | Promise<void>;
     toMatch(expected: RegExp | string): void | Promise<void>;
     toStrictEqual(expected: unknown): void | Promise<void>;
     toThrow(expected?: unknown): void | Promise<void>;
+    toBeGreaterThanOrEqual(expected: number): void | Promise<void>;
+    toBeLessThanOrEqual(expected: number): void | Promise<void>;
+    toBeNaN(): void | Promise<void>;
+    toBeFinite(): void | Promise<void>;
+    toMatchObject(expected: Record<string, unknown>): void | Promise<void>;
+    toHaveProperty(path: string | readonly string[], value?: unknown): void | Promise<void>;
     readonly not: Matchers<T>;
     readonly resolves: Matchers<Awaited<T>>;
     readonly rejects: Matchers<unknown>;

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

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1D,wBAAgB,cAAc,CAAC,WAAW,EAAE,UAAU,QAErD;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,WAAW,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CACZ,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAC5C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACrC;AAID,MAAM,WAAW,QAAQ,CAAC,CAAC;CAAI;AAE/B,MAAM,WAAW,eAAe;IAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,MAAM,EAAE,eAsGjB,CAAC"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -4,5 +4,6 @@ export { describe, it, test } from "./interface";
 export { expect, extendMatchers } from "./expect";
 export type { Matchers, ExpectInterface } from "./expect";
 export type { MatcherContext, MatcherFn, MatcherMap, Promisable, } from "./types";
+export { runEngine } from "./run";
 export type { RunEngineResult } from "./run";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}

package/dist/esm/index.js

@@ -2,3 +2,4 @@ export { beforeEach, afterEach, beforeAll, afterAll } from "./hooks.js";
 export { defineConfig } from "./utils/defineConfig.js";
 export { describe, it, test } from "./interface.js";
 export { expect, extendMatchers } from "./expect.js";
+export { runEngine } from "./run.js";

package/dist/esm/interface.d.ts

@@ -9,9 +9,9 @@ type DescribeFn = {
     todo: (description: string) => void;
 };
 type ItFn = {
-    (description: string, fn: PromisableFn<void>): void;
-    only: (description: string, fn: PromisableFn<void>) => void;
-    skip: (description: string, fn: PromisableFn<void>) => void;
+    (description: string, fn: PromisableFn<void>, timeoutMs?: number): void;
+    only: (description: string, fn: PromisableFn<void>, timeoutMs?: number) => void;
+    skip: (description: string, fn: PromisableFn<void>, timeoutMs?: number) => void;
     todo: (description: string) => void;
 };
 declare const describe: DescribeFn;

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

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/interface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,SAAS,CAAC;AAEtD;;GAEG;AAEH,KAAK,UAAU,GAAG;IAChB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAmBF,QAAA,MAAM,QAAQ,EAAE,UAC8B,CAAC;AAc/C,QAAA,MAAM,EAAE,EAAE,IAAkE,CAAC;AAK7E,QAAA,MAAM,IAAI,EAAE,IAAS,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/interface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,SAAS,CAAC;AAEtD;;GAEG;AAEH,KAAK,UAAU,GAAG;IAChB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxE,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,IAAI,EAAE,CACJ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AA6BF,QAAA,MAAM,QAAQ,EAAE,UAC8B,CAAC;AAmB/C,QAAA,MAAM,EAAE,EAAE,IACyC,CAAC;AAOpD,QAAA,MAAM,IAAI,EAAE,IAAS,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC"}

package/dist/esm/interface.js

@@ -9,7 +9,12 @@ function _describe(description, fn, mode) {
     parent.addSuite(suite);
     unriftGlobalContext.currentSuite = suite;
     try {
-        fn();
+        const result = fn();
+        if (result != null &&
+            typeof result.then === "function") {
+            throw new Error(`describe() callbacks must be synchronous. ` +
+                `Move async setup into beforeAll() or beforeEach().`);
+        }
     }
     finally {
         unriftGlobalContext.currentSuite = parent;
@@ -19,14 +24,14 @@ const describe = (description, fn) => _describe(description, fn, TaskMode.Defaul
 describe.only = (description, fn) => _describe(description, fn, TaskMode.Only);
 describe.skip = (description, fn) => _describe(description, fn, TaskMode.Skip);
 describe.todo = (description) => _describe(description, () => { }, TaskMode.Todo);
-function _it(description, fn, mode) {
+function _it(description, fn, mode, timeoutMs) {
     assertRegisterState("it");
-    const test = new Test(description, fn, mode);
+    const test = new Test(description, fn, mode, timeoutMs);
     getCurrentSuite().addTest(test);
 }
-const it = (description, fn) => _it(description, fn, TaskMode.Default);
-it.only = (description, fn) => _it(description, fn, TaskMode.Only);
-it.skip = (description, fn) => _it(description, fn, TaskMode.Skip);
+const it = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Default, timeoutMs);
+it.only = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Only, timeoutMs);
+it.skip = (description, fn, timeoutMs) => _it(description, fn, TaskMode.Skip, timeoutMs);
 it.todo = (description) => _it(description, () => { }, TaskMode.Todo);
 const test = it;
 export { describe, it, test };

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

@@ -1 +1 @@
-{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/matchers.ts"],"names":[],"mappings":"AAUA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/matchers.ts"],"names":[],"mappings":"AA8DA,wBAAgB,sBAAsB,SAMrC;AAED,wBAAgB,aAAa,SAE5B"}

package/dist/esm/matchers.js

@@ -3,6 +3,46 @@ import { deepEqual } from "./utils/deepEqual.js";
 import { looseEqual } from "./utils/looseEqual.js";
 import { toThrow } from "./utils/toThrow.js";
 let matchersRegistered = false;
+function partialMatch(received, expected) {
+    if (expected === null || typeof expected !== "object") {
+        return looseEqual(received, expected);
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(received))
+            return false;
+        if (received.length !== expected.length)
+            return false;
+        return expected.every((e, i) => partialMatch(received[i], e));
+    }
+    if (received === null ||
+        typeof received !== "object" ||
+        Array.isArray(received)) {
+        return false;
+    }
+    const recv = received;
+    const exp = expected;
+    for (const key of Object.keys(exp)) {
+        if (!Object.hasOwn(recv, key))
+            return false;
+        if (!partialMatch(recv[key], exp[key]))
+            return false;
+    }
+    return true;
+}
+function getNestedValue(obj, path) {
+    const keys = Array.isArray(path) ? path : path.split(".");
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== "object") {
+            return { found: false, value: undefined };
+        }
+        const record = current;
+        if (!Object.hasOwn(record, key))
+            return { found: false, value: undefined };
+        current = record[key];
+    }
+    return { found: true, value: current };
+}
 export function ensureInternalMatchers() {
     if (matchersRegistered)
         return;
@@ -138,5 +178,65 @@ function registerCoreMatchers() {
             if (!pass)
                 throw new Error(message());
         },
+        toBeGreaterThanOrEqual(received, expected) {
+            if (typeof received !== "number") {
+                throw new Error(this.diff(received, "expected a number"));
+            }
+            const pass = received >= expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, `>= ${expected}`));
+            }
+        },
+        toBeLessThanOrEqual(received, expected) {
+            if (typeof received !== "number") {
+                throw new Error(this.diff(received, "expected a number"));
+            }
+            const pass = received <= expected;
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, `<= ${expected}`));
+            }
+        },
+        toBeNaN(received) {
+            const pass = Number.isNaN(received);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, "NaN"));
+            }
+        },
+        toBeFinite(received) {
+            const pass = Number.isFinite(received);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, "finite number"));
+            }
+        },
+        toMatchObject(received, expected) {
+            if (received === null ||
+                typeof received !== "object" ||
+                Array.isArray(received)) {
+                throw new Error(this.diff(received, "expected a non-array object for toMatchObject()"));
+            }
+            const pass = partialMatch(received, expected);
+            if (this.isNot ? pass : !pass) {
+                throw new Error(this.diff(received, expected));
+            }
+        },
+        toHaveProperty(received, path, ...rest) {
+            if (received === null || typeof received !== "object") {
+                throw new Error(this.diff(received, "expected an object for toHaveProperty()"));
+            }
+            const normalizedPath = path;
+            const { found, value } = getNestedValue(received, normalizedPath);
+            const hasValue = rest.length > 0;
+            const expectedValue = rest[0];
+            const pass = hasValue ? found && looseEqual(value, expectedValue) : found;
+            if (this.isNot ? pass : !pass) {
+                const pathStr = Array.isArray(normalizedPath)
+                    ? normalizedPath.join(".")
+                    : normalizedPath;
+                if (!found) {
+                    throw new Error(this.diff(Object.keys(received), `property "${pathStr}"`));
+                }
+                throw new Error(this.diff(value, expectedValue));
+            }
+        },
     });
 }

package/dist/esm/runner.d.ts

@@ -10,5 +10,6 @@ interface RunnerOptions {
     cacheClean?: boolean;
 }
 export declare function runTestsCLI(options?: RunnerOptions): Promise<void>;
+export declare function watchTestsCLI(options?: RunnerOptions): Promise<void>;
 export {};
 //# sourceMappingURL=runner.d.ts.map

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

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

package/dist/esm/runner.js

@@ -1,10 +1,12 @@
-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";
 function debugLog(enabled, json, ...args) {
     // Keep stdout clean for --json mode; use stderr for debug.
@@ -12,27 +14,15 @@ function debugLog(enabled, json, ...args) {
         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 +41,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,6 +143,7 @@ function extractTestName(description) {
     return description.replace(/^.*?›\s*/, "");
 }
 export async function runTestsCLI(options = {}) {
+    regExpCache.clear();
     const runStart = performance.now();
     // Cache clean mode
     if (options.cacheClean) {
@@ -162,8 +179,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);
@@ -296,14 +315,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));
@@ -332,7 +350,7 @@ export async function runTestsCLI(options = {}) {
             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
@@ -373,3 +391,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;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"}

package/dist/esm/test.js

@@ -7,12 +7,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;

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) {

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/helpers.d.ts

@@ -3,6 +3,17 @@ 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;
 /**
  * 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;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CASzD"}

package/dist/esm/utils/helpers.js

@@ -14,6 +14,90 @@ 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}`);
+    }
+}
 /**
  * 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"}

package/dist/esm/utils/loadConfig.js

@@ -1,4 +1,5 @@
 import { toImportUrl } from "./transform.js";
+import { toError } from "./toError.js";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 /**
@@ -18,8 +19,7 @@ async function importConfigFile(configPath) {
             return JSON.parse(raw);
         }
         catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            throw new Error(`Failed to parse JSON config at ${configPath}: ${msg}`);
+            throw new Error(`Failed to parse JSON config at ${configPath}: ${toError(err).message}`);
         }
     }
     const module = await import(toImportUrl(configPath, "bundle-config"));

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@unrift/core",
-  "version": "0.2.1",
-  "description": "unrift core package",
+  "version": "0.3.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",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -53,6 +54,9 @@
   },
   "homepage": "https://unrift.pages.dev",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "esbuild": "^0.27.2"
   },