@develia/commons 0.4.22 → 0.4.24

package/dist/cjs/triggers.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountTrigger = exports.TimeTrigger = void 0;
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+class TimeTrigger {
+    constructor(callback, interval) {
+        this.callback = callback;
+        this.interval = interval;
+        this.lastRunTime = null;
+    }
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    async check() {
+        const currentTime = performance.now();
+        if (this.lastRunTime === null
+            || currentTime - this.lastRunTime >= this.interval.milliseconds) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    async trigger() {
+        this.lastRunTime = performance.now();
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured time interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured time interval.
+     */
+    setInterval(interval) {
+        this.interval = interval;
+    }
+}
+exports.TimeTrigger = TimeTrigger;
+/**
+ * Runs a callback after a configured number of checks.
+ */
+class CountTrigger {
+    constructor(callback, interval) {
+        this.interval = 1;
+        this.checkCount = 0;
+        this.callback = callback;
+        this.setInterval(interval);
+    }
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    async check() {
+        this.checkCount++;
+        if (this.checkCount >= this.interval) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    async trigger() {
+        this.checkCount = 0;
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured check interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    setInterval(interval) {
+        if (interval < 1) {
+            throw new RangeError('Interval must be greater than zero.');
+        }
+        this.interval = interval;
+    }
+}
+exports.CountTrigger = CountTrigger;
+//# sourceMappingURL=triggers.js.map

package/dist/cjs/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/triggers.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,WAAW;IAKpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAGJ;AAxDD,kCAwDC;AAED;;GAEG;AACH,MAAa,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,aAAQ,GAAW,CAAC,CAAC;QACrB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAgB;QAC/B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAzDD,oCAyDC","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured time interval.\n     */\n    public getInterval(): TimeSpan {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured time interval.\n     */\n    public setInterval(interval: TimeSpan): void {\n        this.interval = interval;\n    }\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.setInterval(interval);\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this.interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured check interval.\n     */\n    public getInterval(): number {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured check interval.\n     *\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public setInterval(interval: number): void {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this.interval = interval;\n    }\n}\n"]}

package/dist/cjs/utilities.js

@@ -332,11 +332,34 @@ function shallowEqual(a, b) {
 /**
  * Pauses the execution of an asynchronous function for a specified duration.
  *
- * @param {number} ms - The delay duration in milliseconds.
- * @return {Promise<void>} A promise that resolves after the specified delay.
+ * When `signal` is provided, the returned promise rejects with `signal.reason`
+ * as soon as the signal is aborted (or immediately if it is already aborted),
+ * and the pending timer is cleared.
+ *
+ * @param ms - The delay duration in milliseconds.
+ * @param signal - Optional signal that cancels the wait.
+ * @return A promise that resolves after the specified delay.
  */
-async function delay(ms) {
-    await new Promise(resolve => setTimeout(resolve, ms));
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal === undefined) {
+            setTimeout(resolve, ms);
+            return;
+        }
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
 }
 /**
  * Checks if a value is undefined.

package/dist/cjs/utilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../src/utilities.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection JSUnusedGlobalSymbols\n\n\nimport KeyValuePair from \"./key-value-pair.js\";\nimport type {Resolvable, Constructor} from \"./types.js\";\nimport Type from \"./type.js\";\n\nexport function lazy<T extends object>(factory: () => T): T {\n    let created = false;\n    let instance: T;\n\n    const getInstance = (): T => {\n        if (!created) {\n            instance = factory();\n            created = true;\n        }\n        return instance;\n    };\n\n    return new Proxy({} as T, {\n        get(_, prop, receiver) {\n            return Reflect.get(getInstance(), prop, receiver);\n        },\n        set(_, prop, value) {\n            return Reflect.set(getInstance(), prop, value, getInstance());\n        },\n        defineProperty(_, prop, descriptor) {\n            return Reflect.defineProperty(getInstance(), prop, descriptor);\n        },\n        has(_, prop) {\n            return Reflect.has(getInstance(), prop);\n        },\n        deleteProperty(_, prop) {\n            return Reflect.deleteProperty(getInstance(), prop);\n        },\n        ownKeys() {\n            return Reflect.ownKeys(getInstance());\n        },\n        getOwnPropertyDescriptor(_, prop) {\n            const descriptor = Reflect.getOwnPropertyDescriptor(getInstance(), prop);\n            if (descriptor == null || descriptor.configurable) {\n                return descriptor;\n            }\n            return {...descriptor, configurable: true};\n        },\n        getPrototypeOf() {\n            return Reflect.getPrototypeOf(getInstance());\n        },\n    });\n}\n\n/**\n * Checks if an object is iterable.\n *\n * @param {any} obj - The object to check.\n * @return {boolean} - Returns true if the object is iterable, otherwise false.\n */\nexport function isIterable(obj: any): boolean {\n    return obj != null && typeof obj[Symbol.iterator] === 'function';\n}\n\n/**\n * Checks if a given value is a string.\n *\n * @param {*} value - The value to check.\n * @return {boolean} - Returns true if the value is a string, otherwise returns false.\n */\nexport function isString(value: any): value is string {\n    return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is a number, otherwise false.\n */\nexport function isNumber(value: any): value is number {\n    return typeof value === 'number';\n}\n\n/**\n * Checks if a given value is a boolean.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - Returns true if the value is a boolean, otherwise false.\n */\nexport function isBoolean(value: any): value is boolean {\n    return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an object.\n * @param {any} value - The value to be checked.\n * @returns {boolean} - Returns true if the value is an object, otherwise returns false.\n */\nexport function isObject(value: any): value is object {\n    return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Determines if a value is an array.\n *\n * @param value - The value to be checked.\n *\n * @return Whether the value is an array.\n */\nexport function isArray(value: any): value is any[] {\n    return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a function, otherwise returns false.\n */\nexport function isFunction(value: any): value is Function {\n    return typeof value === 'function';\n}\n\n\n/**\n * Structural deep equality check.\n *\n * Compares primitives by value, and objects/arrays/Maps/Sets/Dates/RegExps\n * by structure. Handles circular references.\n *\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared. Defaults to `true`.\n * @returns `true` if `a` and `b` are structurally equal.\n */\nexport function deepEqual(a: unknown, b: unknown, includeInherited = true): boolean {\n    return _deepEqual(a, b, includeInherited);\n}\n\n/**\n * Internal implementation of deep equality check.\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepEqual(\n    a: unknown,\n    b: unknown,\n    includeInherited: boolean,\n    seen: Map<object, unknown> = new Map()\n): boolean {\n    if (a === b) return true;\n    if (a === null || b === null) return false;\n    if (typeof a !== typeof b) return false;\n    if (typeof a !== \"object\") return false;\n\n    if (a instanceof Date || b instanceof Date) {\n        return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();\n    }\n\n    if (a instanceof RegExp || b instanceof RegExp) {\n        return a instanceof RegExp && b instanceof RegExp && a.toString() === b.toString();\n    }\n\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n    if (a instanceof Map || b instanceof Map) {\n        if (!(a instanceof Map) || !(b instanceof Map)) return false;\n    }\n\n    if (a instanceof Set || b instanceof Set) {\n        if (!(a instanceof Set) || !(b instanceof Set)) return false;\n    }\n\n    const objA = a as object;\n    if (seen.has(objA)) return seen.get(objA) === b;\n    seen.set(objA, b);\n\n    if (a instanceof Map && b instanceof Map) {\n        return _deepEqualMap(a, b, includeInherited, seen);\n    }\n\n    if (a instanceof Set && b instanceof Set) {\n        return _deepEqualSet(a, b, includeInherited, seen);\n    }\n\n    const objB = b as object;\n    const keysA = _deepEqualKeys(objA, includeInherited);\n    const keysB = _deepEqualKeys(objB, includeInherited);\n    if (keysA.length !== keysB.length) return false;\n\n    for (const key of keysA) {\n        if (!_deepEqualHasKey(objB, key, includeInherited)) return false;\n        if (!_deepEqual((a as any)[key], (b as any)[key], includeInherited, seen)) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualMap(\n    a: Map<unknown, unknown>,\n    b: Map<unknown, unknown>,\n    includeInherited: boolean,\n    seen: Map<object, unknown>\n): boolean {\n    if (a.size !== b.size) return false;\n\n    const entriesB = Array.from(b.entries());\n    const matched = new Set<number>();\n\n    for (const [keyA, valueA] of a) {\n        let found = false;\n\n        for (let i = 0; i < entriesB.length; i++) {\n            if (matched.has(i)) continue;\n\n            const [keyB, valueB] = entriesB[i];\n            const candidateSeen = new Map(seen);\n            if (\n                _deepEqual(keyA, keyB, includeInherited, candidateSeen) &&\n                _deepEqual(valueA, valueB, includeInherited, candidateSeen)\n            ) {\n                matched.add(i);\n                _mergeDeepEqualSeen(candidateSeen, seen);\n                found = true;\n                break;\n            }\n        }\n\n        if (!found) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualSet(\n    a: Set<unknown>,\n    b: Set<unknown>,\n    includeInherited: boolean,\n    seen: Map<object, unknown>\n): boolean {\n    if (a.size !== b.size) return false;\n\n    const valuesB = Array.from(b.values());\n    const matched = new Set<number>();\n\n    for (const valueA of a) {\n        let found = false;\n\n        for (let i = 0; i < valuesB.length; i++) {\n            if (matched.has(i)) continue;\n\n            const candidateSeen = new Map(seen);\n            if (_deepEqual(valueA, valuesB[i], includeInherited, candidateSeen)) {\n                matched.add(i);\n                _mergeDeepEqualSeen(candidateSeen, seen);\n                found = true;\n                break;\n            }\n        }\n\n        if (!found) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualKeys(value: object, includeInherited: boolean): PropertyKey[] {\n    const keys: PropertyKey[] = [];\n    const seen = new Set<PropertyKey>();\n    const addKey = (key: PropertyKey) => {\n        if (seen.has(key)) return;\n        seen.add(key);\n        keys.push(key);\n    };\n\n    for (const key of Reflect.ownKeys(value)) {\n        addKey(key);\n    }\n\n    if (!includeInherited) return keys;\n\n    let prototype = Object.getPrototypeOf(value);\n    while (prototype !== null) {\n        for (const key of Reflect.ownKeys(prototype)) {\n            const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n            if (descriptor?.enumerable) addKey(key);\n        }\n        prototype = Object.getPrototypeOf(prototype);\n    }\n\n    return keys;\n}\n\nfunction _deepEqualHasKey(value: object, key: PropertyKey, includeInherited: boolean): boolean {\n    return includeInherited\n        ? key in value\n        : Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction _mergeDeepEqualSeen(source: Map<object, unknown>, target: Map<object, unknown>): void {\n    for (const [key, value] of source) {\n        target.set(key, value);\n    }\n}\n\n\n/**\n * Submits an HTML form programmatically using the specified HTTP method (default is POST),\n * without using AJAX. Supports nested objects and arrays using bracket notation (e.g., `user[name]`, `tags[]`).\n *\n * @param url - The destination URL where the form will be submitted.\n * @param data - An object containing key-value pairs. Supports nested structures and arrays.\n * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').\n * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').\n */\n\n\n/**\n * Compares two objects or arrays to check if they have the same immediate fields and values,\n * or the same immediate elements if they are arrays (shallow equality check).\n *\n * @param {any} a - The first object or array.\n * @param {any} b - The second object or array.\n * @return {boolean} - Returns true if the objects/arrays are shallowly equal, otherwise false.\n */\nexport function shallowEqual(a: any, b: any): boolean {\n    if (a === b) {\n        return true;\n    }\n\n    if (a === null || b === null || typeof a !== typeof b) {\n        return false;\n    }\n\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) {\n            return false;\n        }\n        return a.every((value, index) => value === b[index]);\n    }\n\n    if (typeof a === \"object\" && typeof b === \"object\") {\n        const keysA = Object.keys(a);\n        const keysB = Object.keys(b);\n\n        if (keysA.length !== keysB.length) {\n            return false;\n        }\n        return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && a[key] === b[key]);\n    }\n\n    return false;\n}\n\n\n/**\n * Pauses the execution of an asynchronous function for a specified duration.\n *\n * @param {number} ms - The delay duration in milliseconds.\n * @return {Promise<void>} A promise that resolves after the specified delay.\n */\nexport async function delay(ms: number): Promise<void> {\n    await new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Checks if a value is undefined.\n *\n * @param {any} value - The value to check.\n * @returns {boolean} - True if the value is undefined, false otherwise.\n */\nexport function isUndefined(value: any): value is undefined {\n    return typeof value === 'undefined';\n}\n\n/**\n * Checks if a value is defined or not.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - True if the value is defined, false otherwise.\n */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n    return typeof value !== 'undefined';\n}\n\n/**\n * Checks if a given value is null.\n *\n * @param {any} value - The value to check for null.\n * @return {boolean} - Returns true if the value is null, otherwise returns false.\n */\nexport function isNull(value: any): value is null {\n    return value === null;\n}\n\n\n/**\n * Determines whether the given value is of type bigint.\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is of type bigint, false otherwise.\n */\nexport function isBigInt(value: any): value is bigint {\n    return typeof value === 'bigint';\n}\n\n/**\n * Checks if a given value is a symbol.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a symbol, false otherwise.\n */\nexport function isSymbol(value: any): value is symbol {\n    return typeof value === 'symbol';\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n * @deprecated\n */\nexport function isNullOrUndefined(value: any): boolean {\n    return isNullish(value);\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n\n */\nexport function isNullish(value: any): boolean {\n    return value === null || typeof value === 'undefined';\n}\n\n/**\n * Checks if a given value is empty.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is empty, otherwise returns false.\n */\nexport function isEmpty(value: any): boolean {\n    if (isNullish(value)) return true;\n    if (Array.isArray(value)) return value.length === 0;\n    if (typeof value === 'string') return value === '';\n    return false;\n}\n\n/**\n * Check if a value is empty or contains only whitespace characters.\n *\n * @param {any} value - The value to check.\n * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.\n */\nexport function isEmptyOrWhitespace(value: any): boolean {\n    if (typeof value === 'string') return value.trim() === '';\n    return isEmpty(value);\n}\n\n\n/**\n * Converts an object into an array of key-value pairs.\n *\n * @param {Record<string, any>} obj - The object to convert.\n * @return {KeyValuePair<string, any>[]} - The array of key-value pairs.\n */\nexport function toPairs(obj: Record<string, any>): KeyValuePair<string, any>[] {\n\n    let output = [];\n    for (const key in obj) {\n        output.push(new KeyValuePair(key, obj[key]));\n    }\n    return output;\n\n}\n\n/**\n * Creates an object composed of the picked object properties.\n *\n * @template T - The type of the source object.\n * @template K - The type of the keys to pick.\n * @param obj - The source object.\n * @param props - The property names to pick.\n * @returns A new object with the picked properties.\n */\nexport function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K> {\n    const result = {} as Pick<T, K>;\n    if (obj === null || typeof obj !== 'object') {\n        return result;\n    }\n\n    for (const key of props) {\n        if (key in obj) {\n            result[key] = obj[key];\n        }\n    }\n    return result;\n}\n\n/**\n * Converts a given thing into a Promise.\n * @template T\n * @param {any} thing - The thing to be converted into a Promise.\n * @returns {Promise<T>} - A Promise representing the given thing.\n */\nexport function promisify<T>(thing: Resolvable<T>): Promise<T> {\n\n    if (thing instanceof Promise)\n        return thing;\n\n\n    if (isFunction(thing)) {\n        return new Promise<T>((resolve, reject) => {\n            try {\n                const result = thing();\n                resolve(result);\n            } catch (error) {\n                reject(error);\n            }\n        });\n    }\n\n    return Promise.resolve(thing);\n}\n\n\n/**\n * Create a deep, independent copy of a value.\n *\n * Supports primitives, plain objects, arrays, `Date`, `RegExp`, `Map`, `Set`,\n * symbol-keyed properties and circular references. Functions are copied by\n * reference. Class instances preserve their prototype.\n *\n * @template T - The value's type.\n * @param value - The value to clone.\n * @returns A deep clone of `value`.\n */\nexport function deepClone<T>(value: T): T {\n    return _deepClone(value);\n}\n\n/**\n * Internal implementation of deep clone.\n * @param value - The value to clone.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepClone<T>(\n    value: T,\n    seen: WeakMap<object, unknown> = new WeakMap()\n): T {\n    if (value === null || typeof value !== \"object\") return value;\n\n    const obj = value as unknown as object;\n    if (seen.has(obj)) return seen.get(obj) as T;\n\n    if (value instanceof Date) return new Date(value) as T;\n    if (value instanceof RegExp) {\n        const copy = new RegExp(value);\n        copy.lastIndex = value.lastIndex;\n        return copy as T;\n    }\n\n    if (value instanceof Map) {\n        const copy = new Map();\n        seen.set(value, copy);\n        for (const [k, v] of value) {\n            copy.set(_deepClone(k, seen), _deepClone(v, seen));\n        }\n        return copy as T;\n    }\n\n    if (value instanceof Set) {\n        const copy = new Set();\n        seen.set(value, copy);\n        for (const v of value) {\n            copy.add(_deepClone(v, seen));\n        }\n        return copy as T;\n    }\n\n    const copy: any = Array.isArray(value)\n        ? []\n        : Object.create(Object.getPrototypeOf(value));\n\n    seen.set(obj, copy);\n\n    for (const key of Reflect.ownKeys(obj)) {\n        copy[key] = _deepClone((value as any)[key], seen);\n    }\n\n    return copy as T;\n}\n\n\n/**\n * Returns the type of the given value.\n *\n * @param {any} value - The value to determine the type of.\n * @return {Type} - The type of the given value.\n * @deprecated use Type.of(...)\n */\nexport function getType(value: any): Type {\n\n    return Type.of(value);\n}\n\n/**\n * Patches a method onto a class prototype.\n *\n * This function allows adding new methods to existing classes (monkey-patching).\n * If the method name already exists on the prototype, a warning is issued\n * and the method is not overwritten.\n *\n * If `method` is a function, its name is extracted (if not provided) and\n * it is wrapped to pass the instance (`this`) as the first argument.\n *\n * @template T - The type of the class constructor.\n * @param {T} target - The class constructor whose prototype will be patched.\n * @param {any} method - The implementation or value to patch.\n * @param {string | symbol} [name] - Optional name for the method. If not provided and method is a function, method.name is used.\n * @returns {boolean} Returns `true` if the method was successfully added, or `false` if it already existed.\n */\nexport function monkeyPatch<T extends Constructor>(\n    target: T,\n    method: any,\n    name?: string | symbol\n): boolean {\n\n    let methodName;\n    let methodValue = method;\n\n    if (typeof method === 'function') {\n        methodName = name ?? (method as Function).name;\n        methodValue = function (this: any, ...args: any[]) {\n            return method.apply(this, [this, ...args]);\n        };\n    } else {\n        methodName = name;\n    }\n\n    if (!methodName) {\n        throw new Error(\"Monkey patch failed: No name provided and could not be extracted from function.\");\n    }\n\n    if (methodName in target.prototype) {\n        console.warn(`Method '${String(methodName)}' already exists on ${target.name}`);\n        return false;\n    }\n\n    Object.defineProperty(target.prototype, methodName, {\n        value: methodValue,\n        writable: true,\n        configurable: true,\n        enumerable: false\n    });\n\n    return true;\n}"]}
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../src/utilities.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection JSUnusedGlobalSymbols\n\n\nimport KeyValuePair from \"./key-value-pair.js\";\nimport type {Resolvable, Constructor} from \"./types.js\";\nimport Type from \"./type.js\";\n\nexport function lazy<T extends object>(factory: () => T): T {\n    let created = false;\n    let instance: T;\n\n    const getInstance = (): T => {\n        if (!created) {\n            instance = factory();\n            created = true;\n        }\n        return instance;\n    };\n\n    return new Proxy({} as T, {\n        get(_, prop, receiver) {\n            return Reflect.get(getInstance(), prop, receiver);\n        },\n        set(_, prop, value) {\n            return Reflect.set(getInstance(), prop, value, getInstance());\n        },\n        defineProperty(_, prop, descriptor) {\n            return Reflect.defineProperty(getInstance(), prop, descriptor);\n        },\n        has(_, prop) {\n            return Reflect.has(getInstance(), prop);\n        },\n        deleteProperty(_, prop) {\n            return Reflect.deleteProperty(getInstance(), prop);\n        },\n        ownKeys() {\n            return Reflect.ownKeys(getInstance());\n        },\n        getOwnPropertyDescriptor(_, prop) {\n            const descriptor = Reflect.getOwnPropertyDescriptor(getInstance(), prop);\n            if (descriptor == null || descriptor.configurable) {\n                return descriptor;\n            }\n            return {...descriptor, configurable: true};\n        },\n        getPrototypeOf() {\n            return Reflect.getPrototypeOf(getInstance());\n        },\n    });\n}\n\n/**\n * Checks if an object is iterable.\n *\n * @param {any} obj - The object to check.\n * @return {boolean} - Returns true if the object is iterable, otherwise false.\n */\nexport function isIterable(obj: any): boolean {\n    return obj != null && typeof obj[Symbol.iterator] === 'function';\n}\n\n/**\n * Checks if a given value is a string.\n *\n * @param {*} value - The value to check.\n * @return {boolean} - Returns true if the value is a string, otherwise returns false.\n */\nexport function isString(value: any): value is string {\n    return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is a number, otherwise false.\n */\nexport function isNumber(value: any): value is number {\n    return typeof value === 'number';\n}\n\n/**\n * Checks if a given value is a boolean.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - Returns true if the value is a boolean, otherwise false.\n */\nexport function isBoolean(value: any): value is boolean {\n    return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an object.\n * @param {any} value - The value to be checked.\n * @returns {boolean} - Returns true if the value is an object, otherwise returns false.\n */\nexport function isObject(value: any): value is object {\n    return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Determines if a value is an array.\n *\n * @param value - The value to be checked.\n *\n * @return Whether the value is an array.\n */\nexport function isArray(value: any): value is any[] {\n    return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a function, otherwise returns false.\n */\nexport function isFunction(value: any): value is Function {\n    return typeof value === 'function';\n}\n\n\n/**\n * Structural deep equality check.\n *\n * Compares primitives by value, and objects/arrays/Maps/Sets/Dates/RegExps\n * by structure. Handles circular references.\n *\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared. Defaults to `true`.\n * @returns `true` if `a` and `b` are structurally equal.\n */\nexport function deepEqual(a: unknown, b: unknown, includeInherited = true): boolean {\n    return _deepEqual(a, b, includeInherited);\n}\n\n/**\n * Internal implementation of deep equality check.\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepEqual(\n    a: unknown,\n    b: unknown,\n    includeInherited: boolean,\n    seen: Map<object, unknown> = new Map()\n): boolean {\n    if (a === b) return true;\n    if (a === null || b === null) return false;\n    if (typeof a !== typeof b) return false;\n    if (typeof a !== \"object\") return false;\n\n    if (a instanceof Date || b instanceof Date) {\n        return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();\n    }\n\n    if (a instanceof RegExp || b instanceof RegExp) {\n        return a instanceof RegExp && b instanceof RegExp && a.toString() === b.toString();\n    }\n\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n    if (a instanceof Map || b instanceof Map) {\n        if (!(a instanceof Map) || !(b instanceof Map)) return false;\n    }\n\n    if (a instanceof Set || b instanceof Set) {\n        if (!(a instanceof Set) || !(b instanceof Set)) return false;\n    }\n\n    const objA = a as object;\n    if (seen.has(objA)) return seen.get(objA) === b;\n    seen.set(objA, b);\n\n    if (a instanceof Map && b instanceof Map) {\n        return _deepEqualMap(a, b, includeInherited, seen);\n    }\n\n    if (a instanceof Set && b instanceof Set) {\n        return _deepEqualSet(a, b, includeInherited, seen);\n    }\n\n    const objB = b as object;\n    const keysA = _deepEqualKeys(objA, includeInherited);\n    const keysB = _deepEqualKeys(objB, includeInherited);\n    if (keysA.length !== keysB.length) return false;\n\n    for (const key of keysA) {\n        if (!_deepEqualHasKey(objB, key, includeInherited)) return false;\n        if (!_deepEqual((a as any)[key], (b as any)[key], includeInherited, seen)) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualMap(\n    a: Map<unknown, unknown>,\n    b: Map<unknown, unknown>,\n    includeInherited: boolean,\n    seen: Map<object, unknown>\n): boolean {\n    if (a.size !== b.size) return false;\n\n    const entriesB = Array.from(b.entries());\n    const matched = new Set<number>();\n\n    for (const [keyA, valueA] of a) {\n        let found = false;\n\n        for (let i = 0; i < entriesB.length; i++) {\n            if (matched.has(i)) continue;\n\n            const [keyB, valueB] = entriesB[i];\n            const candidateSeen = new Map(seen);\n            if (\n                _deepEqual(keyA, keyB, includeInherited, candidateSeen) &&\n                _deepEqual(valueA, valueB, includeInherited, candidateSeen)\n            ) {\n                matched.add(i);\n                _mergeDeepEqualSeen(candidateSeen, seen);\n                found = true;\n                break;\n            }\n        }\n\n        if (!found) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualSet(\n    a: Set<unknown>,\n    b: Set<unknown>,\n    includeInherited: boolean,\n    seen: Map<object, unknown>\n): boolean {\n    if (a.size !== b.size) return false;\n\n    const valuesB = Array.from(b.values());\n    const matched = new Set<number>();\n\n    for (const valueA of a) {\n        let found = false;\n\n        for (let i = 0; i < valuesB.length; i++) {\n            if (matched.has(i)) continue;\n\n            const candidateSeen = new Map(seen);\n            if (_deepEqual(valueA, valuesB[i], includeInherited, candidateSeen)) {\n                matched.add(i);\n                _mergeDeepEqualSeen(candidateSeen, seen);\n                found = true;\n                break;\n            }\n        }\n\n        if (!found) return false;\n    }\n\n    return true;\n}\n\nfunction _deepEqualKeys(value: object, includeInherited: boolean): PropertyKey[] {\n    const keys: PropertyKey[] = [];\n    const seen = new Set<PropertyKey>();\n    const addKey = (key: PropertyKey) => {\n        if (seen.has(key)) return;\n        seen.add(key);\n        keys.push(key);\n    };\n\n    for (const key of Reflect.ownKeys(value)) {\n        addKey(key);\n    }\n\n    if (!includeInherited) return keys;\n\n    let prototype = Object.getPrototypeOf(value);\n    while (prototype !== null) {\n        for (const key of Reflect.ownKeys(prototype)) {\n            const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n            if (descriptor?.enumerable) addKey(key);\n        }\n        prototype = Object.getPrototypeOf(prototype);\n    }\n\n    return keys;\n}\n\nfunction _deepEqualHasKey(value: object, key: PropertyKey, includeInherited: boolean): boolean {\n    return includeInherited\n        ? key in value\n        : Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction _mergeDeepEqualSeen(source: Map<object, unknown>, target: Map<object, unknown>): void {\n    for (const [key, value] of source) {\n        target.set(key, value);\n    }\n}\n\n\n/**\n * Submits an HTML form programmatically using the specified HTTP method (default is POST),\n * without using AJAX. Supports nested objects and arrays using bracket notation (e.g., `user[name]`, `tags[]`).\n *\n * @param url - The destination URL where the form will be submitted.\n * @param data - An object containing key-value pairs. Supports nested structures and arrays.\n * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').\n * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').\n */\n\n\n/**\n * Compares two objects or arrays to check if they have the same immediate fields and values,\n * or the same immediate elements if they are arrays (shallow equality check).\n *\n * @param {any} a - The first object or array.\n * @param {any} b - The second object or array.\n * @return {boolean} - Returns true if the objects/arrays are shallowly equal, otherwise false.\n */\nexport function shallowEqual(a: any, b: any): boolean {\n    if (a === b) {\n        return true;\n    }\n\n    if (a === null || b === null || typeof a !== typeof b) {\n        return false;\n    }\n\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) {\n            return false;\n        }\n        return a.every((value, index) => value === b[index]);\n    }\n\n    if (typeof a === \"object\" && typeof b === \"object\") {\n        const keysA = Object.keys(a);\n        const keysB = Object.keys(b);\n\n        if (keysA.length !== keysB.length) {\n            return false;\n        }\n        return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && a[key] === b[key]);\n    }\n\n    return false;\n}\n\n\n/**\n * Pauses the execution of an asynchronous function for a specified duration.\n *\n * When `signal` is provided, the returned promise rejects with `signal.reason`\n * as soon as the signal is aborted (or immediately if it is already aborted),\n * and the pending timer is cleared.\n *\n * @param ms - The delay duration in milliseconds.\n * @param signal - Optional signal that cancels the wait.\n * @return A promise that resolves after the specified delay.\n */\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        if (signal === undefined) {\n            setTimeout(resolve, ms);\n            return;\n        }\n\n        if (signal.aborted) {\n            reject(signal.reason);\n            return;\n        }\n\n        const onAbort = (): void => {\n            clearTimeout(timer);\n            reject(signal.reason);\n        };\n        const timer = setTimeout(() => {\n            signal.removeEventListener(\"abort\", onAbort);\n            resolve();\n        }, ms);\n\n        signal.addEventListener(\"abort\", onAbort, {once: true});\n    });\n}\n\n/**\n * Checks if a value is undefined.\n *\n * @param {any} value - The value to check.\n * @returns {boolean} - True if the value is undefined, false otherwise.\n */\nexport function isUndefined(value: any): value is undefined {\n    return typeof value === 'undefined';\n}\n\n/**\n * Checks if a value is defined or not.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - True if the value is defined, false otherwise.\n */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n    return typeof value !== 'undefined';\n}\n\n/**\n * Checks if a given value is null.\n *\n * @param {any} value - The value to check for null.\n * @return {boolean} - Returns true if the value is null, otherwise returns false.\n */\nexport function isNull(value: any): value is null {\n    return value === null;\n}\n\n\n/**\n * Determines whether the given value is of type bigint.\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is of type bigint, false otherwise.\n */\nexport function isBigInt(value: any): value is bigint {\n    return typeof value === 'bigint';\n}\n\n/**\n * Checks if a given value is a symbol.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a symbol, false otherwise.\n */\nexport function isSymbol(value: any): value is symbol {\n    return typeof value === 'symbol';\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n * @deprecated\n */\nexport function isNullOrUndefined(value: any): boolean {\n    return isNullish(value);\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n\n */\nexport function isNullish(value: any): boolean {\n    return value === null || typeof value === 'undefined';\n}\n\n/**\n * Checks if a given value is empty.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is empty, otherwise returns false.\n */\nexport function isEmpty(value: any): boolean {\n    if (isNullish(value)) return true;\n    if (Array.isArray(value)) return value.length === 0;\n    if (typeof value === 'string') return value === '';\n    return false;\n}\n\n/**\n * Check if a value is empty or contains only whitespace characters.\n *\n * @param {any} value - The value to check.\n * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.\n */\nexport function isEmptyOrWhitespace(value: any): boolean {\n    if (typeof value === 'string') return value.trim() === '';\n    return isEmpty(value);\n}\n\n\n/**\n * Converts an object into an array of key-value pairs.\n *\n * @param {Record<string, any>} obj - The object to convert.\n * @return {KeyValuePair<string, any>[]} - The array of key-value pairs.\n */\nexport function toPairs(obj: Record<string, any>): KeyValuePair<string, any>[] {\n\n    let output = [];\n    for (const key in obj) {\n        output.push(new KeyValuePair(key, obj[key]));\n    }\n    return output;\n\n}\n\n/**\n * Creates an object composed of the picked object properties.\n *\n * @template T - The type of the source object.\n * @template K - The type of the keys to pick.\n * @param obj - The source object.\n * @param props - The property names to pick.\n * @returns A new object with the picked properties.\n */\nexport function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K> {\n    const result = {} as Pick<T, K>;\n    if (obj === null || typeof obj !== 'object') {\n        return result;\n    }\n\n    for (const key of props) {\n        if (key in obj) {\n            result[key] = obj[key];\n        }\n    }\n    return result;\n}\n\n/**\n * Converts a given thing into a Promise.\n * @template T\n * @param {any} thing - The thing to be converted into a Promise.\n * @returns {Promise<T>} - A Promise representing the given thing.\n */\nexport function promisify<T>(thing: Resolvable<T>): Promise<T> {\n\n    if (thing instanceof Promise)\n        return thing;\n\n\n    if (isFunction(thing)) {\n        return new Promise<T>((resolve, reject) => {\n            try {\n                const result = thing();\n                resolve(result);\n            } catch (error) {\n                reject(error);\n            }\n        });\n    }\n\n    return Promise.resolve(thing);\n}\n\n\n/**\n * Create a deep, independent copy of a value.\n *\n * Supports primitives, plain objects, arrays, `Date`, `RegExp`, `Map`, `Set`,\n * symbol-keyed properties and circular references. Functions are copied by\n * reference. Class instances preserve their prototype.\n *\n * @template T - The value's type.\n * @param value - The value to clone.\n * @returns A deep clone of `value`.\n */\nexport function deepClone<T>(value: T): T {\n    return _deepClone(value);\n}\n\n/**\n * Internal implementation of deep clone.\n * @param value - The value to clone.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepClone<T>(\n    value: T,\n    seen: WeakMap<object, unknown> = new WeakMap()\n): T {\n    if (value === null || typeof value !== \"object\") return value;\n\n    const obj = value as unknown as object;\n    if (seen.has(obj)) return seen.get(obj) as T;\n\n    if (value instanceof Date) return new Date(value) as T;\n    if (value instanceof RegExp) {\n        const copy = new RegExp(value);\n        copy.lastIndex = value.lastIndex;\n        return copy as T;\n    }\n\n    if (value instanceof Map) {\n        const copy = new Map();\n        seen.set(value, copy);\n        for (const [k, v] of value) {\n            copy.set(_deepClone(k, seen), _deepClone(v, seen));\n        }\n        return copy as T;\n    }\n\n    if (value instanceof Set) {\n        const copy = new Set();\n        seen.set(value, copy);\n        for (const v of value) {\n            copy.add(_deepClone(v, seen));\n        }\n        return copy as T;\n    }\n\n    const copy: any = Array.isArray(value)\n        ? []\n        : Object.create(Object.getPrototypeOf(value));\n\n    seen.set(obj, copy);\n\n    for (const key of Reflect.ownKeys(obj)) {\n        copy[key] = _deepClone((value as any)[key], seen);\n    }\n\n    return copy as T;\n}\n\n\n/**\n * Returns the type of the given value.\n *\n * @param {any} value - The value to determine the type of.\n * @return {Type} - The type of the given value.\n * @deprecated use Type.of(...)\n */\nexport function getType(value: any): Type {\n\n    return Type.of(value);\n}\n\n/**\n * Patches a method onto a class prototype.\n *\n * This function allows adding new methods to existing classes (monkey-patching).\n * If the method name already exists on the prototype, a warning is issued\n * and the method is not overwritten.\n *\n * If `method` is a function, its name is extracted (if not provided) and\n * it is wrapped to pass the instance (`this`) as the first argument.\n *\n * @template T - The type of the class constructor.\n * @param {T} target - The class constructor whose prototype will be patched.\n * @param {any} method - The implementation or value to patch.\n * @param {string | symbol} [name] - Optional name for the method. If not provided and method is a function, method.name is used.\n * @returns {boolean} Returns `true` if the method was successfully added, or `false` if it already existed.\n */\nexport function monkeyPatch<T extends Constructor>(\n    target: T,\n    method: any,\n    name?: string | symbol\n): boolean {\n\n    let methodName;\n    let methodValue = method;\n\n    if (typeof method === 'function') {\n        methodName = name ?? (method as Function).name;\n        methodValue = function (this: any, ...args: any[]) {\n            return method.apply(this, [this, ...args]);\n        };\n    } else {\n        methodName = name;\n    }\n\n    if (!methodName) {\n        throw new Error(\"Monkey patch failed: No name provided and could not be extracted from function.\");\n    }\n\n    if (methodName in target.prototype) {\n        console.warn(`Method '${String(methodName)}' already exists on ${target.name}`);\n        return false;\n    }\n\n    Object.defineProperty(target.prototype, methodName, {\n        value: methodValue,\n        writable: true,\n        configurable: true,\n        enumerable: false\n    });\n\n    return true;\n}"]}

package/dist/esm/collections/cache-dictionary.js

@@ -39,9 +39,7 @@ export default class CacheDictionary {
             delete this.expiration[key];
         }
         else {
-            const expiration = new Date();
-            expiration.setSeconds(expiration.getSeconds() + duration);
-            this.expiration[key] = expiration;
+            this.expiration[key] = this.calculateExpiration(duration);
         }
     }
     /**
@@ -95,9 +93,7 @@ export default class CacheDictionary {
         if (duration === null) {
             return undefined;
         }
-        const expiration = new Date();
-        expiration.setSeconds(expiration.getSeconds() + duration);
-        return expiration;
+        return new Date(Date.now() + duration * 1000);
     }
 }
 //# sourceMappingURL=cache-dictionary.js.map

package/dist/esm/collections/cache-dictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            const expiration = new Date();\n            expiration.setSeconds(expiration.getSeconds() + duration);\n            this.expiration[key] = expiration;\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        const expiration = new Date();\n        expiration.setSeconds(expiration.getSeconds() + duration);\n        return expiration;\n    }\n}"]}
+{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            this.expiration[key] = this.calculateExpiration(duration);\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        return new Date(Date.now() + duration * 1000);\n    }\n}"]}

package/dist/esm/debouncer.js

@@ -0,0 +1,118 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Debouncer_instances, _Debouncer_controller, _Debouncer_delayMs, _Debouncer_onSchedule, _Debouncer_onStart, _Debouncer_onSuccess, _Debouncer_onCancel, _Debouncer_onError, _Debouncer_onIdle, _Debouncer_run, _Debouncer_becomeIdle;
+import { delay } from "./utilities.js";
+import { noop } from "./functions.js";
+/**
+ * Keeps at most one live task.
+ * Scheduling a new task cancels the previous one, whether it was still
+ * waiting or already running.
+ *
+ * @example
+ * ```ts
+ * const debouncer = new Debouncer({delayMs: 1500});
+ *
+ * debouncer.schedule(async (signal) => {
+ *     const reply = await callAI(messages, {signal});
+ *     if (signal.aborted) return;
+ *     await sendReply(reply);
+ * });
+ * ```
+ */
+class Debouncer {
+    constructor(options) {
+        _Debouncer_instances.add(this);
+        _Debouncer_controller.set(this, void 0);
+        _Debouncer_delayMs.set(this, void 0);
+        _Debouncer_onSchedule.set(this, void 0);
+        _Debouncer_onStart.set(this, void 0);
+        _Debouncer_onSuccess.set(this, void 0);
+        _Debouncer_onCancel.set(this, void 0);
+        _Debouncer_onError.set(this, void 0);
+        _Debouncer_onIdle.set(this, void 0);
+        assertValidDelay(options.delayMs);
+        __classPrivateFieldSet(this, _Debouncer_delayMs, options.delayMs, "f");
+        __classPrivateFieldSet(this, _Debouncer_onSchedule, options.onSchedule ?? noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onStart, options.onStart ?? noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onSuccess, options.onSuccess ?? noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onCancel, options.onCancel ?? noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onError, options.onError ?? console.error, "f");
+        __classPrivateFieldSet(this, _Debouncer_onIdle, options.onIdle ?? noop, "f");
+    }
+    /** Whether a task is waiting or running. */
+    get isPending() {
+        return __classPrivateFieldGet(this, _Debouncer_controller, "f") !== undefined;
+    }
+    /**
+     * Schedule `task`, cancelling any previous task.
+     *
+     * @param task - The task to run once the delay elapses.
+     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.
+     */
+    schedule(task, delayMs = __classPrivateFieldGet(this, _Debouncer_delayMs, "f")) {
+        assertValidDelay(delayMs);
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") !== undefined) {
+            __classPrivateFieldGet(this, _Debouncer_controller, "f").abort();
+            __classPrivateFieldGet(this, _Debouncer_onCancel, "f").call(this);
+        }
+        const controller = new AbortController();
+        __classPrivateFieldSet(this, _Debouncer_controller, controller, "f");
+        __classPrivateFieldGet(this, _Debouncer_onSchedule, "f").call(this);
+        void __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_run).call(this, task, delayMs, controller);
+    }
+    /** Cancel the current task, if any. */
+    cancel() {
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") === undefined) {
+            return;
+        }
+        __classPrivateFieldGet(this, _Debouncer_controller, "f").abort();
+        __classPrivateFieldGet(this, _Debouncer_onCancel, "f").call(this);
+        __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_becomeIdle).call(this);
+    }
+}
+_Debouncer_controller = new WeakMap(), _Debouncer_delayMs = new WeakMap(), _Debouncer_onSchedule = new WeakMap(), _Debouncer_onStart = new WeakMap(), _Debouncer_onSuccess = new WeakMap(), _Debouncer_onCancel = new WeakMap(), _Debouncer_onError = new WeakMap(), _Debouncer_onIdle = new WeakMap(), _Debouncer_instances = new WeakSet(), _Debouncer_run = async function _Debouncer_run(task, delayMs, controller) {
+    const signal = controller.signal;
+    try {
+        await delay(delayMs, signal);
+        __classPrivateFieldGet(this, _Debouncer_onStart, "f").call(this);
+        await task(signal);
+        if (!signal.aborted) {
+            __classPrivateFieldGet(this, _Debouncer_onSuccess, "f").call(this);
+        }
+    }
+    catch (error) {
+        if (!signal.aborted) {
+            __classPrivateFieldGet(this, _Debouncer_onError, "f").call(this, error);
+        }
+    }
+    finally {
+        // A replaced or cancelled task must not touch the current state.
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") === controller) {
+            __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_becomeIdle).call(this);
+        }
+    }
+}, _Debouncer_becomeIdle = function _Debouncer_becomeIdle() {
+    __classPrivateFieldSet(this, _Debouncer_controller, undefined, "f");
+    __classPrivateFieldGet(this, _Debouncer_onIdle, "f").call(this);
+};
+export default Debouncer;
+/**
+ * Throw a `RangeError` unless `delayMs` is a finite number >= 0.
+ *
+ * @internal Shared with `KeyedDebouncer`; not part of the public API.
+ */
+export function assertValidDelay(delayMs) {
+    if (!Number.isFinite(delayMs) || delayMs < 0) {
+        throw new RangeError(`delayMs must be a number >= 0 (received: ${delayMs})`);
+    }
+}
+//# sourceMappingURL=debouncer.js.map

package/dist/esm/debouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.js","sourceRoot":"","sources":["../../src/debouncer.ts"],"names":[],"mappings":"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","sourcesContent":["import {delay} from \"./utilities.js\";\nimport {noop} from \"./functions.js\";\n\n/**\n * Cancellable task. It must honour `signal`: pass it to fetch/SDKs and check\n * `signal.aborted` before producing irreversible side effects.\n */\nexport type DebouncedTask = (signal: AbortSignal) => Promise<void>;\n\n/** Options accepted by {@link Debouncer}. */\nexport interface DebouncerOptions {\n    /** Default wait, in milliseconds, before a task is executed. */\n    delayMs: number;\n    /** Called every time a task is scheduled, after any previous task has been cancelled. */\n    onSchedule?: () => void;\n    /** Called when the wait elapses and the task is about to run. */\n    onStart?: () => void;\n    /** Called when a task completes without throwing and without being cancelled. */\n    onSuccess?: () => void;\n    /** Called when a live task is cancelled, either by {@link Debouncer.cancel} or by being replaced. */\n    onCancel?: () => void;\n    /** Receives task errors. Cancellations never reach this callback. Defaults to `console.error`. */\n    onError?: (error: unknown) => void;\n    /** Called every time the debouncer goes from busy to idle. */\n    onIdle?: () => void;\n}\n\n/**\n * Keeps at most one live task.\n * Scheduling a new task cancels the previous one, whether it was still\n * waiting or already running.\n *\n * @example\n * ```ts\n * const debouncer = new Debouncer({delayMs: 1500});\n *\n * debouncer.schedule(async (signal) => {\n *     const reply = await callAI(messages, {signal});\n *     if (signal.aborted) return;\n *     await sendReply(reply);\n * });\n * ```\n */\nexport default class Debouncer {\n    #controller: AbortController | undefined;\n    readonly #delayMs: number;\n    readonly #onSchedule: () => void;\n    readonly #onStart: () => void;\n    readonly #onSuccess: () => void;\n    readonly #onCancel: () => void;\n    readonly #onError: (error: unknown) => void;\n    readonly #onIdle: () => void;\n\n    constructor(options: DebouncerOptions) {\n        assertValidDelay(options.delayMs);\n        this.#delayMs = options.delayMs;\n        this.#onSchedule = options.onSchedule ?? noop;\n        this.#onStart = options.onStart ?? noop;\n        this.#onSuccess = options.onSuccess ?? noop;\n        this.#onCancel = options.onCancel ?? noop;\n        this.#onError = options.onError ?? console.error;\n        this.#onIdle = options.onIdle ?? noop;\n    }\n\n    /** Whether a task is waiting or running. */\n    get isPending(): boolean {\n        return this.#controller !== undefined;\n    }\n\n    /**\n     * Schedule `task`, cancelling any previous task.\n     *\n     * @param task - The task to run once the delay elapses.\n     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.\n     */\n    schedule(task: DebouncedTask, delayMs: number = this.#delayMs): void {\n        assertValidDelay(delayMs);\n        if (this.#controller !== undefined) {\n            this.#controller.abort();\n            this.#onCancel();\n        }\n\n        const controller = new AbortController();\n        this.#controller = controller;\n        this.#onSchedule();\n        void this.#run(task, delayMs, controller);\n    }\n\n    /** Cancel the current task, if any. */\n    cancel(): void {\n        if (this.#controller === undefined) {\n            return;\n        }\n        this.#controller.abort();\n        this.#onCancel();\n        this.#becomeIdle();\n    }\n\n    async #run(task: DebouncedTask, delayMs: number, controller: AbortController): Promise<void> {\n        const signal = controller.signal;\n        try {\n            await delay(delayMs, signal);\n            this.#onStart();\n            await task(signal);\n            if (!signal.aborted) {\n                this.#onSuccess();\n            }\n        } catch (error) {\n            if (!signal.aborted) {\n                this.#onError(error);\n            }\n        } finally {\n            // A replaced or cancelled task must not touch the current state.\n            if (this.#controller === controller) {\n                this.#becomeIdle();\n            }\n        }\n    }\n\n    #becomeIdle(): void {\n        this.#controller = undefined;\n        this.#onIdle();\n    }\n}\n\n/**\n * Throw a `RangeError` unless `delayMs` is a finite number >= 0.\n *\n * @internal Shared with `KeyedDebouncer`; not part of the public API.\n */\nexport function assertValidDelay(delayMs: number): void {\n    if (!Number.isFinite(delayMs) || delayMs < 0) {\n        throw new RangeError(`delayMs must be a number >= 0 (received: ${delayMs})`);\n    }\n}\n"]}

package/dist/esm/functions.js

@@ -113,91 +113,6 @@ export function memoize(fn, resolver, cache = new Map()) {
     memoized.has = (...args) => cache.has(resolveKey(...args));
     return memoized;
 }
-/**
- * Delay a function until no calls have been made for the configured wait time.
- * The latest arguments and this-context are used for the trailing execution.
- *
- * @example
- * ```ts
- * const search = debounce((query: string) => {
- *     console.log(query);
- * }, 300);
- *
- * search("com");
- * search("commons"); // only this value is printed after 300 ms
- * ```
- *
- * @example
- * ```ts
- * const track = debounce(sendAnalytics, 1000, {leading: true, trailing: false});
- *
- * track("open"); // executed immediately
- * track.cancel(); // cancel the pending debounce window
- * ```
- */
-export function debounce(fn, wait, options = {}) {
-    const delay = normalizeDelay(wait);
-    const leading = options.leading ?? false;
-    const trailing = options.trailing ?? true;
-    let timer;
-    let lastArgs;
-    let lastThis;
-    let result;
-    const invoke = () => {
-        const args = lastArgs;
-        const context = lastThis;
-        lastArgs = undefined;
-        lastThis = undefined;
-        result = fn.apply(context, args);
-        return result;
-    };
-    const expire = () => {
-        timer = undefined;
-        if (trailing && lastArgs) {
-            invoke();
-        }
-        else {
-            lastArgs = undefined;
-            lastThis = undefined;
-        }
-    };
-    const start = () => {
-        timer = setTimeout(expire, delay);
-    };
-    const debounced = function (...args) {
-        const invokeLeading = leading && timer === undefined;
-        lastArgs = args;
-        lastThis = this;
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-        start();
-        if (invokeLeading) {
-            return invoke();
-        }
-        return result;
-    };
-    debounced.cancel = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-        timer = undefined;
-        lastArgs = undefined;
-        lastThis = undefined;
-    };
-    debounced.flush = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-            timer = undefined;
-            if (lastArgs && trailing) {
-                return invoke();
-            }
-        }
-        return result;
-    };
-    debounced.pending = () => timer !== undefined;
-    return debounced;
-}
 /**
  * Limit how often a function can run during a time window.
  * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.