@pithos/core 2.0.0

package/dist/arkhe/string/upper-case.js

@@ -0,0 +1,129 @@
+// Stryker disable next-line Regex: Unicode word-splitting regex with Latin-1 + surrogate pair emoji support
+const RE_UNICODE_WORDS = /[A-Z\xC0-\xD6\xD8-\xDE]?[a-z\xDF-\xF6\xF8-\xFF]+|[A-Z\xC0-\xD6\xD8-\xDE]+(?![a-z\xDF-\xF6\xF8-\xFF])|[0-9]+|[\ud800-\udbff][\udc00-\udfff][\ufe0e\ufe0f]?(?:\u200d[\ud800-\udbff][\udc00-\udfff][\ufe0e\ufe0f]?)*|[^\x20-\x7F\s_-]+/gu;
+// Stryker disable next-line Regex: ASCII word-splitting regex (camelCase-aware)
+const RE_ASCII_WORDS = /[A-Z]{2,}(?=[A-Z][a-z]|[^A-Za-z]|$)|[A-Z]?[a-z]+|[A-Z]+|[0-9]+/g;
+// Stryker disable next-line Regex: Fast non-ASCII detection
+const RE_HAS_NON_ASCII = /[^\x20-\x7F]/;
+// Threshold: below this length, charCode loop is faster; above, regex wins
+const CHARCODE_THRESHOLD = 128;
+/**
+ * Converts string to upper case with space-separated words.
+ *
+ * @param str - The string to convert.
+ * @returns The upper cased string with words separated by spaces.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase | String.toUpperCase() - MDN}
+ * @since 2.0.0
+ *
+ * @performance O(n) — charCode word splitting for short ASCII, regex for long/Unicode/emoji.
+ *
+ * @example
+ * ```typescript
+ * upperCase('--Foo-Bar--');  // => 'FOO BAR'
+ * upperCase('fooBar');       // => 'FOO BAR'
+ * upperCase('__foo_bar__');  // => 'FOO BAR'
+ * ```
+ */
+export function upperCase(str) {
+    if (str == null)
+        return "";
+    const len = str.length;
+    // Stryker disable next-line EqualityOperator,ConditionalExpression: len === 0 is an optimization — the while loop below handles empty strings identically (never iterates, returns "")
+    if (len === 0)
+        return "";
+    // Short strings: charCode fast path (no regex overhead)
+    // Stryker disable next-line EqualityOperator,ConditionalExpression: both charCode and regex paths produce identical results — this is a performance optimization only
+    if (len <= CHARCODE_THRESHOLD) {
+        let result = "";
+        let i = 0;
+        // Stryker disable next-line EqualityOperator: i <= len would read charCodeAt(len) → NaN, which fails all comparisons and exits naturally
+        while (i < len) {
+            const c = str.charCodeAt(i);
+            // Non-ASCII → fall back to Unicode regex
+            // Stryker disable next-line EqualityOperator: c >= 127 would include DEL (127), which is non-alphanumeric and handled by the separator skip below
+            if (c > 127) {
+                // Stryker disable next-line all: match always succeeds since c > 127 guarantees a non-ASCII char
+                return str.match(RE_UNICODE_WORDS).map(w => w.toUpperCase()).join(" ");
+            }
+            // Skip non-alphanumeric
+            // Stryker disable next-line EqualityOperator: after c > 127 check, c >= 65 && c <= 90 and c >= 97 && c <= 122 cover all alphanumerics — remaining chars are always separators
+            if (c <= 47 || (c >= 58 && c <= 64) || (c >= 91 && c <= 96) || c >= 123) {
+                i++;
+                continue;
+            }
+            // Stryker disable next-line ConditionalExpression,EqualityOperator: after separator skip, only digits (48-57), uppercase (65-90), and lowercase (97-122) remain — c < 90 would route 'Z' to the else branch which produces identical output since toUpperCase() is a no-op on 'Z'
+            if (c >= 65 && c <= 90) {
+                const uStart = i;
+                i++;
+                // Stryker disable next-line EqualityOperator,ConditionalExpression: i <= len or true would read charCodeAt(len) → NaN, failing >= 65 and exiting naturally
+                while (i < len && str.charCodeAt(i) >= 65 && str.charCodeAt(i) <= 90)
+                    i++;
+                // Stryker disable next-line EqualityOperator,ConditionalExpression: i <= len or true would read charCodeAt(len) → NaN, failing >= 97 and taking the else branch (pure uppercase) which is correct
+                if (i < len && str.charCodeAt(i) >= 97 && str.charCodeAt(i) <= 122) {
+                    if (i - uStart > 1) {
+                        if (result)
+                            result += " ";
+                        result += str.slice(uStart, i - 1);
+                        const wStart = i - 1;
+                        i++;
+                        // Stryker disable next-line EqualityOperator: i <= len would read charCodeAt(len) → NaN, failing all comparisons and exiting naturally
+                        while (i < len) {
+                            const nc = str.charCodeAt(i);
+                            if ((nc >= 97 && nc <= 122) || (nc >= 48 && nc <= 57))
+                                i++;
+                            else
+                                break;
+                        }
+                        result += " " + str.slice(wStart, i).toUpperCase();
+                    }
+                    else {
+                        i++;
+                        // Stryker disable next-line EqualityOperator: i <= len would read charCodeAt(len) → NaN, failing all comparisons and exiting naturally
+                        while (i < len) {
+                            const nc = str.charCodeAt(i);
+                            if ((nc >= 97 && nc <= 122) || (nc >= 48 && nc <= 57))
+                                i++;
+                            else
+                                break;
+                        }
+                        if (result)
+                            result += " ";
+                        result += str.slice(uStart, i).toUpperCase();
+                    }
+                }
+                else {
+                    // Pure uppercase block — already uppercase
+                    if (result)
+                        result += " ";
+                    result += str.slice(uStart, i);
+                }
+            }
+            else {
+                const wStart = i;
+                i++;
+                // Stryker disable next-line EqualityOperator: i <= len would read charCodeAt(len) → NaN, failing all comparisons and exiting naturally
+                while (i < len) {
+                    const nc = str.charCodeAt(i);
+                    if ((nc >= 97 && nc <= 122) || (nc >= 48 && nc <= 57))
+                        i++;
+                    else
+                        break;
+                }
+                if (result)
+                    result += " ";
+                result += str.slice(wStart, i).toUpperCase();
+            }
+        }
+        return result;
+    }
+    // Long strings: regex path (V8 native regex engine is faster than JS charCode loop at scale)
+    const re = RE_HAS_NON_ASCII.test(str) ? RE_UNICODE_WORDS : RE_ASCII_WORDS;
+    const m = str.match(re);
+    if (!m)
+        return "";
+    let result = m[0].toUpperCase();
+    for (let i = 1; i < m.length; i++) {
+        result += " " + m[i].toUpperCase();
+    }
+    return result;
+}
+//# sourceMappingURL=upper-case.js.map

package/dist/arkhe/string/upper-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upper-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/upper-case.ts"],"names":[],"mappings":"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"}

package/dist/arkhe/string/words.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Splits string into an array of its words.
+ *
+ * @param str - The string to inspect.
+ * @param pattern - The pattern to match words (optional).
+ * @returns The array of words.
+ * @since 2.0.0
+ *
+ * @note Default pattern handles camelCase, PascalCase, snake_case, kebab-case, and mixed strings.
+ * @note Includes Unicode letters and numbers in default pattern.
+ *
+ * @performance O(n) where n is string length. Single regex pass.
+ *
+ * @example
+ * ```typescript
+ * words('fred, barney, & pebbles');
+ * // => ['fred', 'barney', 'pebbles']
+ *
+ * words('fred, barney, & pebbles', /[^, ]+/g);
+ * // => ['fred', 'barney', '&', 'pebbles']
+ *
+ * words('camelCase');
+ * // => ['camel', 'Case']
+ *
+ * words('PascalCase');
+ * // => ['Pascal', 'Case']
+ *
+ * words('snake_case');
+ * // => ['snake', 'case']
+ *
+ * words('kebab-case');
+ * // => ['kebab', 'case']
+ *
+ * words('XMLHttpRequest');
+ * // => ['XML', 'Http', 'Request']
+ * ```
+ */
+export declare function words(str: string, pattern?: RegExp | string): string[];
+//# sourceMappingURL=words.d.ts.map

package/dist/arkhe/string/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAsBtE"}

package/dist/arkhe/string/words.js

@@ -0,0 +1,54 @@
+/**
+ * Splits string into an array of its words.
+ *
+ * @param str - The string to inspect.
+ * @param pattern - The pattern to match words (optional).
+ * @returns The array of words.
+ * @since 2.0.0
+ *
+ * @note Default pattern handles camelCase, PascalCase, snake_case, kebab-case, and mixed strings.
+ * @note Includes Unicode letters and numbers in default pattern.
+ *
+ * @performance O(n) where n is string length. Single regex pass.
+ *
+ * @example
+ * ```typescript
+ * words('fred, barney, & pebbles');
+ * // => ['fred', 'barney', 'pebbles']
+ *
+ * words('fred, barney, & pebbles', /[^, ]+/g);
+ * // => ['fred', 'barney', '&', 'pebbles']
+ *
+ * words('camelCase');
+ * // => ['camel', 'Case']
+ *
+ * words('PascalCase');
+ * // => ['Pascal', 'Case']
+ *
+ * words('snake_case');
+ * // => ['snake', 'case']
+ *
+ * words('kebab-case');
+ * // => ['kebab', 'case']
+ *
+ * words('XMLHttpRequest');
+ * // => ['XML', 'Http', 'Request']
+ * ```
+ */
+export function words(str, pattern) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string match returns null, ?? [] handles it
+    if (str.length === 0)
+        return [];
+    if (pattern !== undefined) {
+        const regex = 
+        // Stryker disable next-line ConditionalExpression: equivalent mutant - new RegExp(regexObj, flags) works correctly for both string and RegExp
+        typeof pattern === "string"
+            ? new RegExp(pattern, "g")
+            : new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : pattern.flags + "g");
+        return str.match(regex) ?? [];
+    }
+    return (str.match(
+    // Stryker disable next-line Regex: equivalent mutant - [a-z]+ vs [a-z] in lookahead produces same result
+    /[A-Z]{2,}(?=[A-Z][a-z]+|\b)|[A-Z]?[a-z]+|[A-Z]+|[0-9]+/g) ?? []);
+}
+//# sourceMappingURL=words.js.map

package/dist/arkhe/string/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../../src/arkhe/string/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,OAAyB;IAC1D,yHAAyH;IACzH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK;QACT,8IAA8I;QAC9I,OAAO,OAAO,KAAK,QAAQ;YACzB,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;YAC1B,CAAC,CAAC,IAAI,MAAM,CACR,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAClE,CAAC;QACR,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,CACL,GAAG,CAAC,KAAK;IACP,yGAAyG;IACzG,yDAAyD,CAC1D,IAAI,EAAE,CACR,CAAC;AACJ,CAAC"}

package/dist/arkhe/test/console.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Console method names that can be mocked.
+ * @since 2.0.0
+ */
+export type ConsoleMethod = "log" | "warn" | "error" | "info" | "debug" | "trace";
+/**
+ * Recorded call to a console method.
+ * @since 2.0.0
+ */
+export interface ConsoleCall {
+    /** Arguments passed to the console method. */
+    args: unknown[];
+    /** Timestamp of the call. */
+    timestamp: number;
+}
+/**
+ * Mock object for a single console method.
+ * @since 2.0.0
+ */
+export interface ConsoleMock {
+    /** All recorded calls. */
+    calls: ConsoleCall[];
+    /** Number of times the method was called. */
+    callCount: number;
+    /** Clears recorded calls. */
+    clear: () => void;
+}
+/**
+ * Result of mockConsole().
+ * @since 2.0.0
+ */
+export interface MockConsoleResult {
+    /** Mocks for each requested method, keyed by method name. */
+    mocks: Record<string, ConsoleMock>;
+    /** Restores all original console methods. */
+    restore: () => void;
+    /** Clears all recorded calls without restoring. */
+    clearAll: () => void;
+}
+/**
+ * Options for mockConsole.
+ * @since 2.0.0
+ */
+export interface MockConsoleOptions {
+    /** If true, still outputs to console while capturing. */
+    passthrough?: boolean;
+}
+/**
+ * Mocks specified console methods, capturing calls for assertions.
+ *
+ * @param args - Console methods to mock and/or configuration options.
+ * @returns The object with mocks and restore function.
+ * @since 2.0.0
+ *
+ * @performance Uses Map for O(1) lookup of original console methods. Stores calls in arrays for O(1) append.
+ *
+ * @example
+ * ```typescript
+ * const { mocks, restore } = mockConsole("log", "warn");
+ * console.log("test", 123);
+ * console.warn("warning!");
+ * expect(mocks.log.callCount).toBe(1);
+ * expect(mocks.log.calls[0].args).toEqual(["test", 123]);
+ * expect(mocks.warn.callCount).toBe(1);
+ * restore();
+ *
+ * const { mocks: m, restore: r } = mockConsole("log", { passthrough: true });
+ * console.log("captured and printed");
+ * r();
+ * ```
+ */
+export declare function mockConsole(...args: (ConsoleMethod | MockConsoleOptions)[]): MockConsoleResult;
+/**
+ * Silences specified console methods for the duration of a test.
+ *
+ * @param methods - Console methods to silence (defaults to all).
+ * @returns The restore function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const restore = silenceConsole("log", "warn");
+ * console.log("silenced");
+ * console.error("still prints");
+ * restore();
+ * ```
+ */
+export declare function silenceConsole(...methods: ConsoleMethod[]): () => void;
+/**
+ * Executes a function with console methods silenced, restoring automatically.
+ *
+ * @param fn - Function to execute.
+ * @param methods - Console methods to silence (defaults to all).
+ * @returns The return value of fn.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = withSilentConsole(() => {
+ *   console.log("silenced");
+ *   return computeSomething();
+ * });
+ *
+ * const data = await withSilentConsole(async () => {
+ *   console.warn("silenced");
+ *   return await fetchData();
+ * }, "warn");
+ * ```
+ */
+export declare function withSilentConsole<T>(fn: () => T, ...methods: ConsoleMethod[]): T;
+//# sourceMappingURL=console.d.ts.map

package/dist/arkhe/test/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/arkhe/test/console.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CACzB,GAAG,IAAI,EAAE,CAAC,aAAa,GAAG,kBAAkB,CAAC,EAAE,GAC9C,iBAAiB,CAwDnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAUtE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,CAAC,EACX,GAAG,OAAO,EAAE,aAAa,EAAE,GAC1B,CAAC,CAaH"}

package/dist/arkhe/test/console.js

@@ -0,0 +1,162 @@
+import { trackRestore } from "./globals";
+// INTENTIONAL: Encapsulating console access to avoid repeating type casts and no-undef
+const _console = console;
+/**
+ * All available console methods.
+ * @internal
+ */
+const ALL_CONSOLE_METHODS = [
+    "log",
+    "warn",
+    "error",
+    "info",
+    "debug",
+    "trace",
+];
+/**
+ * Creates a restore function for console methods.
+ * @internal
+ */
+function createRestoreFn(methods, originals) {
+    return () => {
+        for (const method of methods) {
+            // INTENTIONAL: Map.get always returns value for iterated methods (set in same loop)
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            _console[method] = originals.get(method);
+        }
+    };
+}
+/**
+ * Mocks specified console methods, capturing calls for assertions.
+ *
+ * @param args - Console methods to mock and/or configuration options.
+ * @returns The object with mocks and restore function.
+ * @since 2.0.0
+ *
+ * @performance Uses Map for O(1) lookup of original console methods. Stores calls in arrays for O(1) append.
+ *
+ * @example
+ * ```typescript
+ * const { mocks, restore } = mockConsole("log", "warn");
+ * console.log("test", 123);
+ * console.warn("warning!");
+ * expect(mocks.log.callCount).toBe(1);
+ * expect(mocks.log.calls[0].args).toEqual(["test", 123]);
+ * expect(mocks.warn.callCount).toBe(1);
+ * restore();
+ *
+ * const { mocks: m, restore: r } = mockConsole("log", { passthrough: true });
+ * console.log("captured and printed");
+ * r();
+ * ```
+ */
+export function mockConsole(...args) {
+    const options = {};
+    const methods = [];
+    for (const arg of args) {
+        if (typeof arg === "string") {
+            methods.push(arg);
+        }
+        else {
+            Object.assign(options, arg);
+        }
+    }
+    if (methods.length === 0) {
+        methods.push("log");
+    }
+    const originals = new Map();
+    const mocks = {};
+    for (const method of methods) {
+        originals.set(method, _console[method]);
+        const mock = {
+            calls: [],
+            callCount: 0,
+            clear: () => {
+                mock.calls = [];
+                mock.callCount = 0;
+            },
+        };
+        mocks[method] = mock;
+        _console[method] = (...callArgs) => {
+            mock.calls.push({
+                args: callArgs,
+                timestamp: Date.now(),
+            });
+            mock.callCount++;
+            if (options.passthrough) {
+                // Stryker disable next-line OptionalChaining: Map.get always returns value - set in same loop
+                originals.get(method)?.apply(console, callArgs);
+            }
+        };
+    }
+    return {
+        mocks,
+        restore: trackRestore(createRestoreFn(methods, originals)),
+        clearAll: () => {
+            for (const mock of Object.values(mocks)) {
+                mock.clear();
+            }
+        },
+    };
+}
+/**
+ * Silences specified console methods for the duration of a test.
+ *
+ * @param methods - Console methods to silence (defaults to all).
+ * @returns The restore function.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const restore = silenceConsole("log", "warn");
+ * console.log("silenced");
+ * console.error("still prints");
+ * restore();
+ * ```
+ */
+export function silenceConsole(...methods) {
+    const toSilence = methods.length > 0 ? methods : [...ALL_CONSOLE_METHODS];
+    const originals = new Map();
+    for (const method of toSilence) {
+        originals.set(method, _console[method]);
+        _console[method] = () => { };
+    }
+    return trackRestore(createRestoreFn(toSilence, originals));
+}
+/**
+ * Executes a function with console methods silenced, restoring automatically.
+ *
+ * @param fn - Function to execute.
+ * @param methods - Console methods to silence (defaults to all).
+ * @returns The return value of fn.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = withSilentConsole(() => {
+ *   console.log("silenced");
+ *   return computeSomething();
+ * });
+ *
+ * const data = await withSilentConsole(async () => {
+ *   console.warn("silenced");
+ *   return await fetchData();
+ * }, "warn");
+ * ```
+ */
+export function withSilentConsole(fn, ...methods) {
+    const restore = silenceConsole(...methods);
+    try {
+        const result = fn();
+        if (result instanceof Promise) {
+            return result.finally(restore);
+        }
+        restore();
+        return result;
+    }
+    catch (error) {
+        restore();
+        throw error;
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/arkhe/test/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/arkhe/test/console.ts"],"names":[],"mappings":"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"}

package/dist/arkhe/test/globals.d.ts

@@ -0,0 +1,144 @@
+declare const _globalThis: any;
+/**
+ * Returns typed reference to globalThis for test environments.
+ *
+ * @returns The global object with any typing.
+ * @since 2.0.0
+ */
+export declare const getGlobalThis: () => typeof _globalThis;
+/**
+ * Wraps a restore function for automatic tracking.
+ * @internal
+ * @since 2.0.0
+ */
+export declare const trackRestore: (restore: () => void) => (() => void);
+/**
+ * @internal
+ * @since 2.0.0
+ */
+export declare const __autoRestoreAll: () => void;
+/**
+ * Result of mockWindow().
+ * @since 2.0.0
+ */
+export interface MockWindowResult {
+    window: Window & typeof _globalThis;
+    restore: () => void;
+}
+/**
+ * Creates a mock window object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to set on the mock window.
+ * @returns Object containing the mock window and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { window, restore } = mockWindow({ innerWidth: 1024 });
+ * expect(window.innerWidth).toBe(1024);
+ * restore();
+ * ```
+ */
+export declare const mockWindow: (overrides?: Partial<Window>) => MockWindowResult;
+/**
+ * Result of mockDocument().
+ * @since 2.0.0
+ */
+export interface MockDocumentResult {
+    document: Document;
+    restore: () => void;
+}
+/**
+ * Creates a mock document object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to set on the mock document.
+ * @returns Object containing the mock document and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { document, restore } = mockDocument({
+ *   querySelector: vi.fn(() => null),
+ * });
+ * restore();
+ * ```
+ */
+export declare const mockDocument: (overrides?: Partial<Document>) => MockDocumentResult;
+/**
+ * Result of mockDOMRect().
+ * @since 2.0.0
+ */
+export interface MockDOMRectResult {
+    DOMRect: typeof DOMRect;
+    restore: () => void;
+}
+/**
+ * Creates a mock DOMRect constructor on globalThis for Node.js tests.
+ *
+ * @param implementation - Optional custom DOMRect implementation.
+ * @returns Object containing the mock DOMRect and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { DOMRect, restore } = mockDOMRect();
+ * const rect = new DOMRect(0, 0, 100, 100);
+ * expect(rect.width).toBe(100);
+ * restore();
+ * ```
+ */
+export declare const mockDOMRect: (implementation?: typeof DOMRect) => MockDOMRectResult;
+/**
+ * Result of mockPerformance().
+ * @since 2.0.0
+ */
+export interface MockPerformanceResult {
+    performance: Performance;
+    restore: () => void;
+}
+/**
+ * Creates a mock performance object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to override on the mock performance.
+ * @returns Object containing the mock performance and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { performance, restore } = mockPerformance({
+ *   now: vi.fn(() => 12345),
+ * });
+ * expect(performance.now()).toBe(12345);
+ * restore();
+ * ```
+ */
+export declare const mockPerformance: (overrides?: Partial<Performance>) => MockPerformanceResult;
+/**
+ * Sets a value on globalThis and returns a restore function.
+ *
+ * @template T - The value type.
+ * @param key - The key to set on globalThis.
+ * @param value - The value to set.
+ * @returns A restore function.
+ * @since 2.0.0
+ *
+ * @note Always call the returned restore function. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const restore = setGlobal('fetch', vi.fn());
+ * // ... tests ...
+ * restore();
+ * ```
+ */
+export declare const setGlobal: <T>(key: string, value: T) => (() => void);
+export {};
+//# sourceMappingURL=globals.d.ts.map

package/dist/arkhe/test/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../src/arkhe/test/globals.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,WAAW,EAAiB,GAAG,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,OAAO,WAA0B,CAAC;AAmBnE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAM7D,CAAC;AAeF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAZF,IAYmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,OAAO,WAAW,CAAC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,GACrB,YAAW,OAAO,CAAC,MAAM,CAAM,KAC9B,gBAgBF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GACvB,YAAW,OAAO,CAAC,QAAQ,CAAM,KAChC,kBAgBF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACtB,iBAAiB,OAAO,OAAO,KAC9B,iBAoDF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAW,OAAO,CAAC,WAAW,CAAM,KACnC,qBAkBF,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,CAAC,KAAG,CAAC,MAAM,IAAI,CAgB/D,CAAC"}