@bitfiber/utils 1.0.0

package/common/is/is.js

@@ -0,0 +1,214 @@
+/*
+ * Why is typeof or constructor used to check type?
+ * For 100 000 000 iterations type checking is spending:
+ * by typeof: ~75 milliseconds
+ * by constructor: ~75 milliseconds
+ * by instanceof: ~255 milliseconds
+ * by toString.call: ~850 milliseconds
+ */
+/**
+ * Returns true if the value is null, otherwise false
+ * @param value - anything
+ */
+export function isNull(value) {
+    return value === null;
+}
+/**
+ * Returns true if the value is undefined, otherwise false
+ * @param value - anything
+ */
+export function isUndefined(value) {
+    return typeof value === 'undefined';
+}
+/**
+ * Returns true if the value is defined, otherwise false
+ * @param value - anything
+ */
+export function isDefined(value) {
+    return typeof value !== 'undefined';
+}
+/**
+ * Returns true if the value is undefined or null, otherwise false
+ * @param value - anything
+ */
+export function isNullish(value) {
+    return isNull(value) || isUndefined(value);
+}
+/**
+ * Returns true if the value is NaN, otherwise false
+ * @param value - anything
+ */
+export function isNaN(value) {
+    return Number.isNaN(value);
+}
+/**
+ * Returns true if the value is a string, otherwise false
+ * @param value - anything
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Returns true if the value is a number, otherwise false
+ * @param value - anything
+ */
+export function isNumber(value) {
+    return typeof value === 'number';
+}
+/**
+ * Returns true if the value is a big integer, otherwise false
+ * @param value - anything
+ */
+export function isBigInt(value) {
+    return typeof value === 'bigint';
+}
+/**
+ * Returns true if the value is a boolean, otherwise false
+ * @param value - anything
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Returns true if the value is a symbol, otherwise false
+ * @param value - anything
+ */
+export function isSymbol(value) {
+    return typeof value === 'symbol';
+}
+/**
+ * Returns true if the value is a function, otherwise false
+ * @param value - anything
+ */
+export function isFunction(value) {
+    return typeof value === 'function';
+}
+/**
+ * Returns true if the value is an object, otherwise false
+ * @param value - anything
+ */
+export function isObject(value) {
+    return !!value && typeof value === 'object';
+}
+/**
+ * Returns true if the value is an array, otherwise false
+ * @param value - anything
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Returns true if the value is a set, otherwise false
+ * @param value - anything
+ */
+export function isSet(value) {
+    return !!value && value.constructor === Set;
+}
+/**
+ * Returns true if the value is a map, otherwise false
+ * @param value - anything
+ */
+export function isMap(value) {
+    return !!value && value.constructor === Map;
+}
+/**
+ * Returns true if the value is a date, otherwise false
+ * @param value - anything
+ */
+export function isDate(value) {
+    return !!value && value.constructor === Date;
+}
+/**
+ * Returns true if the value is a regular expression, otherwise false
+ * @param value - anything
+ */
+export function isRegExp(value) {
+    return !!value && value.constructor === RegExp;
+}
+/**
+ * Returns true if the value is a file, otherwise false
+ * @param value - anything
+ */
+export function isFile(value) {
+    return !!value && value.constructor === File;
+}
+/**
+ * Returns true if the value is a blob, otherwise false
+ * @param value - anything
+ */
+export function isBlob(value) {
+    return !!value && value.constructor === Blob;
+}
+/**
+ * Returns true if the value is form data, otherwise false
+ * @param value - anything
+ */
+export function isFormData(value) {
+    return !!value && value.constructor === FormData;
+}
+/**
+ * Returns true if the value is an array buffer, otherwise false
+ * @param value - anything
+ */
+export function isArrayBuffer(value) {
+    return !!value && value.constructor === ArrayBuffer;
+}
+/**
+ * Returns true if the value is a document, otherwise false
+ * @param value - anything
+ */
+export function isDocument(value) {
+    return !!value && typeof Document === 'function' && value.constructor === Document;
+}
+/**
+ * Returns true if the value is a window, otherwise false
+ * @param value - anything
+ */
+export function isWindow(value) {
+    return !!value && value.window === value;
+}
+/**
+ * Returns true if the value is a promise, otherwise false
+ * @param value - anything
+ */
+export function isPromise(value) {
+    return !!value && (value.constructor === Promise || (isFunction(value.then) && isFunction(value.catch)));
+}
+/**
+ * Returns true if the value is an observable, otherwise false
+ * @param value - anything
+ */
+export function isObservable(value) {
+    return !!value && isFunction(value.pipe) && isFunction(value.subscribe);
+}
+/**
+ * Returns true if the value is a typed array, otherwise false
+ * @param value - anything
+ */
+export function isTypedArray(value) {
+    switch (value === null || value === void 0 ? void 0 : value.constructor) {
+        case Int8Array:
+        case Int16Array:
+        case Int32Array:
+        case Float32Array:
+        case Float64Array:
+        case Uint8Array:
+        case Uint8ClampedArray:
+        case Uint16Array:
+        case Uint32Array:
+            // case BigInt64Array:
+            // case BigUint64Array:
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Returns true if the value is a usual object, otherwise false
+ * @param value - anything
+ */
+export function isUsualObject(value) {
+    return isObject(value) && !isArray(value) && !isTypedArray(value) && !isSet(value) && !isMap(value) && !isDate(value)
+        && !isRegExp(value) && !isFile(value) && !isBlob(value) && !isFormData(value) && !isArrayBuffer(value) && !isWindow(value) && !isDocument(value) && !isPromise(value) && !isObservable(value);
+}
+//# sourceMappingURL=is.js.map

package/common/is/is.js.map

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

package/common/is-empty/is-empty.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true if the value is empty (null, undefined, NaN, Infinity, '', {}, [], Int32Array(), Set(), Map()),
+ * otherwise false
+ * @param value - anything
+ */
+export declare function isEmpty(value: any): boolean;

package/common/is-empty/is-empty.js

@@ -0,0 +1,30 @@
+import { isNumber, isBigInt, isBoolean, isSymbol, isString, isDate, isRegExp, isFunction, isDefined } from '../';
+import { hasOwn } from '../../obj';
+/**
+ * Returns true if the value is empty (null, undefined, NaN, Infinity, '', {}, [], Int32Array(), Set(), Map()),
+ * otherwise false
+ * @param value - anything
+ */
+export function isEmpty(value) {
+    if (isNumber(value) || isBigInt(value) || isBoolean(value) || isSymbol(value)) {
+        return false;
+    }
+    else if (!value) {
+        return true;
+    }
+    else if (isString(value) || isDate(value) || isRegExp(value) || isFunction(value)) {
+        return false;
+    }
+    else if (isFunction(value.forEach)) {
+        return value.length === 0 || value.size === 0;
+    }
+    else {
+        for (const key in value) {
+            if (hasOwn(value, key) && isDefined(value[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=is-empty.js.map

package/common/is-empty/is-empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-empty.js","sourceRoot":"","sources":["../../../../package/src/common/is-empty/is-empty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAC,MAAM,KAAK,CAAC;AAC/G,OAAO,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAU;IAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE;QAC7E,OAAO,KAAK,CAAC;KACd;SAAM,IAAI,CAAC,KAAK,EAAE;QACjB,OAAO,IAAI,CAAC;KACb;SAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE;QACnF,OAAO,KAAK,CAAC;KACd;SAAM,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;QACpC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;KAC/C;SAAM;QACL,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;YACvB,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE;gBAC/C,OAAO,KAAK,CAAC;aACd;SACF;QACD,OAAO,IAAI,CAAC;KACb;AACH,CAAC"}

package/common/random/random.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a random integer between 0 and number, not exceeding a certain number of digits
+ * @param numberOfDigits - number of digits (default: 7, maximum: 15)
+ */
+export declare function random(numberOfDigits?: number): number;

package/common/random/random.js

@@ -0,0 +1,9 @@
+/**
+ * Returns a random integer between 0 and number, not exceeding a certain number of digits
+ * @param numberOfDigits - number of digits (default: 7, maximum: 15)
+ */
+export function random(numberOfDigits = 7) {
+    numberOfDigits = numberOfDigits <= 15 ? numberOfDigits : 15;
+    return Math.round(Math.random() * Math.pow(10, numberOfDigits));
+}
+//# sourceMappingURL=random.js.map

package/common/random/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../package/src/common/random/random.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,cAAc,GAAG,CAAC;IACvC,cAAc,GAAG,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/common/same/same.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Determines whether two values are the same value
+ * @param value1 - anything
+ * @param value2 - anything
+ */
+export declare function same(value1: any, value2: any): boolean;

package/common/same/same.js

@@ -0,0 +1,9 @@
+/**
+ * Determines whether two values are the same value
+ * @param value1 - anything
+ * @param value2 - anything
+ */
+export function same(value1, value2) {
+    return (value1 === 0 && value2 === 0) || Object.is(value1, value2);
+}
+//# sourceMappingURL=same.js.map

package/common/same/same.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"same.js","sourceRoot":"","sources":["../../../../package/src/common/same/same.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAAW,EAAE,MAAW;IAC3C,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC"}

package/common/stub/stub.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Can replace any required function,
+ * takes any arguments and returns anything
+ */ export declare function stub(...args: any[]): any;

package/common/stub/stub.js

@@ -0,0 +1,8 @@
+/**
+ * Can replace any required function,
+ * takes any arguments and returns anything
+ */ // eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function stub(...args) {
+    return;
+}
+//# sourceMappingURL=stub.js.map

package/common/stub/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../../../package/src/common/stub/stub.ts"],"names":[],"mappings":"AAAA;;;GAGG,CAAA,6DAA6D;AAChE,MAAM,UAAU,IAAI,CAAC,GAAG,IAAW;IACjC,OAAO;AACT,CAAC"}

package/common/to-float/to-float.d.ts

@@ -0,0 +1,6 @@
+import { NumStr } from '../';
+/**
+ * Converts a string to a float and replaces NaN and Infinity with 0
+ * @param value - a string or number
+ */
+export declare function toFloat(value: NumStr): number;

package/common/to-float/to-float.js

@@ -0,0 +1,10 @@
+import { isNumber } from '../';
+/**
+ * Converts a string to a float and replaces NaN and Infinity with 0
+ * @param value - a string or number
+ */
+export function toFloat(value) {
+    const num = isNumber(value) ? value : parseFloat(value);
+    return isFinite(num) ? num : 0;
+}
+//# sourceMappingURL=to-float.js.map

package/common/to-float/to-float.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-float.js","sourceRoot":"","sources":["../../../../package/src/common/to-float/to-float.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,QAAQ,EAAC,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/common/to-int/to-int.d.ts

@@ -0,0 +1,6 @@
+import { NumStr } from '../';
+/**
+ * Converts a string to an integer and replaces NaN and Infinity with 0
+ * @param value - a string or number
+ */
+export declare function toInt(value: NumStr): number;

package/common/to-int/to-int.js

@@ -0,0 +1,10 @@
+import { isNumber } from '../';
+/**
+ * Converts a string to an integer and replaces NaN and Infinity with 0
+ * @param value - a string or number
+ */
+export function toInt(value) {
+    const num = isNumber(value) ? value : parseInt(value, 10);
+    return isFinite(num) ? num : 0;
+}
+//# sourceMappingURL=to-int.js.map

package/common/to-int/to-int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-int.js","sourceRoot":"","sources":["../../../../package/src/common/to-int/to-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,QAAQ,EAAC,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/common/to-sorted-string/to-sorted-string.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Converts any value to a sorted string.
+ * Sorts arrays, maps and sets by value and sorts objects by field name before adding them to a string.
+ * Objects, arrays, sets, maps etc. will be ignored if they have been visited to prevent looping
+ * @param value - anything
+ */
+export declare function toSortedString(value: any): string;

package/common/to-sorted-string/to-sorted-string.js

@@ -0,0 +1,53 @@
+import { isString, isDate, isRegExp, isFunction, isMap, isSet, isObject, isArray, isTypedArray } from '../';
+/**
+ * Converts any value to a sorted string.
+ * Sorts arrays, maps and sets by value and sorts objects by field name before adding them to a string.
+ * Objects, arrays, sets, maps etc. will be ignored if they have been visited to prevent looping
+ * @param value - anything
+ */
+export function toSortedString(value) {
+    return _toSortedString(value, null, 0, new Map());
+}
+function _toSortedString(value, index, field, visited) {
+    let str = index === null ? '' : ((index === 0 ? '' : ',') + (isString(field) ? field + ':' : ''));
+    if (isMap(value) || isSet(value)) {
+        if (visited.has(value)) {
+            return '';
+        }
+        visited.set(value, true);
+        value = Array.from(value);
+    }
+    if (isArray(value) || isTypedArray(value)) {
+        if (visited.has(value)) {
+            return '';
+        }
+        visited.set(value, true);
+        str += '[';
+        value.sort();
+        value.forEach((value, i) => {
+            str += _toSortedString(value, i, i, visited);
+        });
+        str += ']';
+    }
+    else if (isFunction(value)) {
+        str += value.toString();
+    }
+    else if (isObject(value) && !isDate(value) && !isRegExp(value)) {
+        if (visited.has(value)) {
+            return '';
+        }
+        visited.set(value, true);
+        const fields = Object.keys(value);
+        str += '{';
+        fields.sort();
+        fields.forEach((field, i) => {
+            str += _toSortedString(value[field], i, field, visited);
+        });
+        str += '}';
+    }
+    else {
+        str += value;
+    }
+    return str;
+}
+//# sourceMappingURL=to-sorted-string.js.map

package/common/to-sorted-string/to-sorted-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-sorted-string.js","sourceRoot":"","sources":["../../../../package/src/common/to-sorted-string/to-sorted-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAC,MAAM,KAAK,CAAC;AAElH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,EAAa,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,KAAU,EAAE,KAAoB,EAAE,KAAa,EAAE,OAAuB;IAC/F,IAAI,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACtB,OAAO,EAAE,CAAC;SACX;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEzB,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KAC3B;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACtB,OAAO,EAAE,CAAC;SACX;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEzB,GAAG,IAAI,GAAG,CAAC;QACX,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,KAAK,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,CAAS,EAAE,EAAE;YACtC,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,GAAG,IAAI,GAAG,CAAC;KACZ;SAAM,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE;QAC5B,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;KACzB;SAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;QAChE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACtB,OAAO,EAAE,CAAC;SACX;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAElC,GAAG,IAAI,GAAG,CAAC;QACX,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,GAAG,IAAI,GAAG,CAAC;KACZ;SAAM;QACL,GAAG,IAAI,KAAK,CAAC;KACd;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/common/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Represents a value, which can be undefined or null
+ */
+export declare type Nullish = undefined | null;
+/**
+ * Represents a value, which can be a number or string
+ */
+export declare type NumStr = number | string;
+/**
+ * Represents a value, which can be a number, string or symbol
+ */
+export declare type NumStrSym = NumStr | symbol;
+/**
+ * Represents any function
+ */
+export declare type Fn = (...args: any[]) => any;
+/**
+ * Represents any array
+ */
+export declare type Arr<T = any> = ReadonlyArray<T> | ArrayLike<T>;
+/**
+ * Represents all typed array types
+ */
+export declare type TypedArr = Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | BigInt64Array | BigUint64Array;
+/**
+ * Represents any object
+ */
+export interface Obj<T = any> {
+    [key: NumStrSym]: T;
+}
+/**
+ * Represents an object with an indefinite number of string keys of type T
+ */
+export interface Index<T = any> {
+    [key: string]: T;
+}
+/**
+ * Represents the union of any array type and any object type
+ */
+export declare type ArrObj<T = any> = Arr<T> | Obj<T>;
+/**
+ * Converts a type union to a type intersection
+ */
+export declare type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
+/**
+ * Represents the union of object value types or array value types
+ */
+export declare type ValueUnion<T extends ArrObj, K extends keyof T = keyof T> = T extends ReadonlyArray<any> ? T[number] : T extends ArrayLike<any> ? T[number] : T extends object ? T[K] : never;
+/**
+ * Represents the intersection of object value types or array value types
+ */
+export declare type ValueIntersection<T extends ArrObj> = UnionToIntersection<ValueUnion<T>>;
+/**
+ * Represents additional error options the BfError class
+ */
+export interface BfErrorOptions {
+    code?: string;
+    data?: any;
+}
+/**
+ * This symbol is used in forEach handlers to interrupt the loop
+ */
+export declare const INTERRUPT: unique symbol;

package/common/types.js

@@ -0,0 +1,5 @@
+/**
+ * This symbol is used in forEach handlers to interrupt the loop
+ */
+export const INTERRUPT = Symbol('Symbol.INTERRUPT');
+//# sourceMappingURL=types.js.map

package/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../package/src/common/types.ts"],"names":[],"mappings":"AA2EA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dom/closest/closest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the same element or the closest parent element matching the selectors, otherwise null
+ * @param element - any HTML element
+ * @param selectors - target HTML element or string of valid CSS selectors
+ */
+export declare function closest(element: HTMLElement, selectors: string | HTMLElement): HTMLElement | null;

package/dom/closest/closest.js

@@ -0,0 +1,26 @@
+/**
+ * Returns the same element or the closest parent element matching the selectors, otherwise null
+ * @param element - any HTML element
+ * @param selectors - target HTML element or string of valid CSS selectors
+ */
+export function closest(element, selectors) {
+    let currentElem = element;
+    while (currentElem) {
+        if (selectors instanceof Element) {
+            if (currentElem === selectors) {
+                return currentElem;
+            }
+            else {
+                currentElem = currentElem.parentElement;
+            }
+        }
+        else if (currentElem.matches(selectors)) {
+            return currentElem;
+        }
+        else {
+            currentElem = currentElem.parentElement;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=closest.js.map

package/dom/closest/closest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closest.js","sourceRoot":"","sources":["../../../../package/src/dom/closest/closest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAoB,EAAE,SAA+B;IAC3E,IAAI,WAAW,GAAuB,OAAO,CAAC;IAE9C,OAAO,WAAW,EAAE;QAClB,IAAI,SAAS,YAAY,OAAO,EAAE;YAChC,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC7B,OAAO,WAAW,CAAC;aACpB;iBAAM;gBACL,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC;aACzC;SACF;aAAM,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YACzC,OAAO,WAAW,CAAC;SACpB;aAAM;YACL,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC;SACzC;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dom/document/document.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the document object representing the HTML document in the current environment
+ */
+export declare function getDocument(): Document;
+/**
+ * If the global object is not a window, you can use this function to set up a stub document implementation
+ * @example
+ * For Angular:
+ * setDocument(inject(DOCUMENT));
+ * @param document - The document object representing the HTML document in the current environment
+ */
+export declare function setDocument(document: Document): void;

package/dom/document/document.js

@@ -0,0 +1,24 @@
+import { BfError } from '../../';
+let doc = typeof document === 'object' ? document : undefined;
+/**
+ * Returns the document object representing the HTML document in the current environment
+ */
+export function getDocument() {
+    if (doc) {
+        return doc;
+    }
+    else {
+        throw new BfError('Document is absent', { code: 'bf_utils_dom_getDocument_1' });
+    }
+}
+/**
+ * If the global object is not a window, you can use this function to set up a stub document implementation
+ * @example
+ * For Angular:
+ * setDocument(inject(DOCUMENT));
+ * @param document - The document object representing the HTML document in the current environment
+ */
+export function setDocument(document) {
+    doc = document;
+}
+//# sourceMappingURL=document.js.map

package/dom/document/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../../package/src/dom/document/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAE/B,IAAI,GAAG,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAE9D;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,GAAG,EAAE;QACP,OAAO,GAAG,CAAC;KACZ;SAAM;QACL,MAAM,IAAI,OAAO,CAAC,oBAAoB,EAAE,EAAC,IAAI,EAAE,4BAA4B,EAAC,CAAC,CAAC;KAC/E;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB;IAC5C,GAAG,GAAG,QAAQ,CAAC;AACjB,CAAC"}

package/dom/download-file/download-file.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates an offer to download a file from URL in the browser.
+ * Returns a promise that returns a blob if the download is successful
+ * @param url - file URL
+ */
+export declare function downloadFile(url: string): Promise<Blob>;

package/dom/download-file/download-file.js

@@ -0,0 +1,32 @@
+import { BfError } from '../../';
+import { getBody, getDocument, getWindow } from '../';
+/**
+ * Creates an offer to download a file from URL in the browser.
+ * Returns a promise that returns a blob if the download is successful
+ * @param url - file URL
+ */
+export function downloadFile(url) {
+    return fetch(url)
+        .then(response => {
+        if (response.ok) {
+            return response.blob();
+        }
+        else {
+            return Promise.reject(new BfError('Network response was not ok', { code: 'bf_utils_dom_downloadFile_1' }));
+        }
+    })
+        .then(blob => {
+        const doc = getDocument();
+        const win = getWindow();
+        const body = getBody();
+        const url = win.URL.createObjectURL(blob);
+        const link = doc.createElement('a');
+        link.href = url;
+        link.download = 'downloaded_file';
+        body.appendChild(link);
+        link.click();
+        body.removeChild(link);
+        return blob;
+    });
+}
+//# sourceMappingURL=download-file.js.map

package/dom/download-file/download-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-file.js","sourceRoot":"","sources":["../../../../package/src/dom/download-file/download-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,KAAK,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,KAAK,CAAC,GAAG,CAAC;SACd,IAAI,CAAC,QAAQ,CAAC,EAAE;QACf,IAAI,QAAQ,CAAC,EAAE,EAAE;YACf,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;SACxB;aAAM;YACL,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,6BAA6B,EAAE,EAAC,IAAI,EAAE,6BAA6B,EAAC,CAAC,CAAC,CAAC;SAC1G;IACH,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,EAAE;QACX,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dom/for-each-elements/for-each-elements.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Iterates through all child elements of the parent element to the full depth of the tree
+ * and calls a handler for each element.
+ * If the handler returns INTERRUPT, the loop will be interrupted
+ * @param parent - a parent element
+ * @param handler - function called for each element
+ */
+export declare function forEachElements(parent: Element, handler: (child: Element, index: number, parent: Element) => any): void;