@bitfiber/utils 1.1.1 → 1.1.2

package/dist/esm/obj/for-each-obj/for-each-obj.js.map

@@ -1 +1 @@
-{"version":3,"file":"for-each-obj.js","sourceRoot":"","sources":["../../../../src/obj/for-each-obj/for-each-obj.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,SAAS,EAAa,MAAM,cAAc,CAAC;AACxD,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAQ3B,MAAM,UAAU,UAAU,CACxB,GAAM,EACN,OAAsD;IAEtD,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;QACrB,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAsB,GAAG,EAAE,GAAG,CAAC,KAAK,SAAS,EAAE;YACrF,OAAO;SACR;KACF;AACH,CAAC"}
+{"version":3,"file":"for-each-obj.js","sourceRoot":"","sources":["../../../../src/obj/for-each-obj/for-each-obj.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,SAAS,EAAa,MAAM,cAAc,CAAC;AACxD,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAQ3B,MAAM,UAAU,UAAU,CACxB,GAAM,EACN,OAAsD;IAEtD,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAsB,GAAG,EAAE,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACtF,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/obj/has-own/has-own.js

@@ -1,4 +1,4 @@
-export function hasOwn(obj, property) {
-    return Object.prototype.hasOwnProperty.call(obj, property);
-}
+export function hasOwn(obj, property) {
+    return Object.hasOwn(obj, property);
+}
 //# sourceMappingURL=has-own.js.map

package/dist/esm/obj/has-own/has-own.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../../src/obj/has-own/has-own.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,MAAM,CAAC,GAAQ,EAAE,QAAmB;IAElD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"has-own.js","sourceRoot":"","sources":["../../../../src/obj/has-own/has-own.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,MAAM,CAAC,GAAQ,EAAE,QAAmB;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,QAA2B,CAAC,CAAC;AACzD,CAAC"}

package/dist/esm/obj/include/include.js

@@ -1,12 +1,12 @@
-import { isDefined } from '../../common';
-import { hasOwn } from '../';
-export function include(obj, ...fields) {
-    const result = {};
-    fields.forEach(key => {
-        if (hasOwn(obj, key) && isDefined(obj[key])) {
-            result[key] = obj[key];
-        }
-    });
-    return result;
-}
+import { isDefined } from '../../common';
+import { hasOwn } from '../';
+export function include(obj, ...fields) {
+    const result = {};
+    fields.forEach(key => {
+        if (hasOwn(obj, key) && isDefined(obj[key])) {
+            result[key] = obj[key];
+        }
+    });
+    return result;
+}
 //# sourceMappingURL=include.js.map

package/dist/esm/obj/include/include.js.map

@@ -1 +1 @@
-{"version":3,"file":"include.js","sourceRoot":"","sources":["../../../../src/obj/include/include.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAO3B,MAAM,UAAU,OAAO,CAAmC,GAAM,EAAE,GAAG,MAAW;IAC9E,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACnB,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;SACxB;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"include.js","sourceRoot":"","sources":["../../../../src/obj/include/include.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAO3B,MAAM,UAAU,OAAO,CAAmC,GAAM,EAAE,GAAG,MAAW;IAC9E,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACnB,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/obj/index.js

@@ -1,13 +1,13 @@
-export { hasOwn } from './has-own/has-own';
-export { forEachObj } from './for-each-obj/for-each-obj';
-export { keys } from './keys/keys';
-export { values } from './values/values';
-export { include } from './include/include';
-export { exclude } from './exclude/exclude';
-export { constant } from './constant/constant';
-export { deepConstant } from './deep-constant/deep-constant';
-export { mapObj } from './map-obj/map-obj';
-export { mapObjToArr } from './map-obj-to-arr/map-obj-to-arr';
-export { diffObj } from './diff-obj/diff-obj';
-export { extend, extendAll } from './extend/extend';
+export { hasOwn } from './has-own/has-own';
+export { forEachObj } from './for-each-obj/for-each-obj';
+export { keys } from './keys/keys';
+export { values } from './values/values';
+export { include } from './include/include';
+export { exclude } from './exclude/exclude';
+export { constant } from './constant/constant';
+export { deepConstant } from './deep-constant/deep-constant';
+export { mapObj } from './map-obj/map-obj';
+export { mapObjToArr } from './map-obj-to-arr/map-obj-to-arr';
+export { diffObj } from './diff-obj/diff-obj';
+export { extend, extendAll } from './extend/extend';
 //# sourceMappingURL=index.js.map

package/dist/esm/obj/keys/keys.js

@@ -1,4 +1,4 @@
-export function keys(obj) {
-    return Object.keys(obj);
-}
+export function keys(obj) {
+    return Object.keys(obj);
+}
 //# sourceMappingURL=keys.js.map

package/dist/esm/obj/map-obj/map-obj.js

@@ -1,7 +1,7 @@
-import { forEachObj } from '../';
-export function mapObj(obj, handler) {
-    const result = {};
-    forEachObj(obj, (value, key) => result[key] = handler(value, key, obj));
-    return result;
-}
+import { forEachObj } from '../';
+export function mapObj(obj, handler) {
+    const result = {};
+    forEachObj(obj, (value, key) => result[key] = handler(value, key, obj));
+    return result;
+}
 //# sourceMappingURL=map-obj.js.map

package/dist/esm/obj/map-obj-to-arr/map-obj-to-arr.js

@@ -1,7 +1,7 @@
-import { forEachObj } from '../';
-export function mapObjToArr(obj, handler) {
-    const result = [];
-    forEachObj(obj, (value, key) => result.push(handler(value, key, obj)));
-    return result;
-}
+import { forEachObj } from '../';
+export function mapObjToArr(obj, handler) {
+    const result = [];
+    forEachObj(obj, (value, key) => result.push(handler(value, key, obj)));
+    return result;
+}
 //# sourceMappingURL=map-obj-to-arr.js.map

package/dist/esm/obj/values/values.js

@@ -1,7 +1,7 @@
-import { forEachObj } from '../';
-export function values(obj) {
-    const result = [];
-    forEachObj(obj, value => result.push(value));
-    return result;
-}
+import { forEachObj } from '../';
+export function values(obj) {
+    const result = [];
+    forEachObj(obj, value => result.push(value));
+    return result;
+}
 //# sourceMappingURL=values.js.map

package/dist/esm/str/index.js

@@ -1,4 +1,4 @@
-export { withCapital } from './with-capital/with-capital';
-export { toCamelCase } from './to-camel-case/to-camel-case';
-export { toHash } from './to-hash/to-hash';
+export { withCapital } from './with-capital/with-capital';
+export { toCamelCase } from './to-camel-case/to-camel-case';
+export { toHash } from './to-hash/to-hash';
 //# sourceMappingURL=index.js.map

package/dist/esm/str/to-camel-case/to-camel-case.js

@@ -1,9 +1,13 @@
-export function toCamelCase(str, separators = ['-', '_', ' ']) {
-    return separators.reduce((acc, separator) => {
-        const reg = new RegExp(separator + '([\\da-z])', 'gi');
-        return acc.replace(reg, (all, letter) => {
-            return letter.toUpperCase();
-        });
-    }, str);
-}
+const REGEX_SPECIAL_CHARS = /[.*+?^${}()|[\]\\]/g;
+function escapeRegExp(str) {
+    return str.replace(REGEX_SPECIAL_CHARS, '\\$&');
+}
+export function toCamelCase(str, separators = ['-', '_', ' ']) {
+    return separators.reduce((acc, separator) => {
+        const reg = new RegExp(escapeRegExp(separator) + '([\\da-z])', 'gi');
+        return acc.replace(reg, (all, letter) => {
+            return letter.toUpperCase();
+        });
+    }, str);
+}
 //# sourceMappingURL=to-camel-case.js.map

package/dist/esm/str/to-camel-case/to-camel-case.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-camel-case.js","sourceRoot":"","sources":["../../../../src/str/to-camel-case/to-camel-case.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,aAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC7E,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,SAAiB,EAAE,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAW,EAAE,MAAc,EAAE,EAAE;YACtD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC"}
+{"version":3,"file":"to-camel-case.js","sourceRoot":"","sources":["../../../../src/str/to-camel-case/to-camel-case.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAWD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,aAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC7E,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,SAAiB,EAAE,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC;QACrE,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAW,EAAE,MAAc,EAAE,EAAE;YACtD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/esm/str/to-hash/to-hash.js

@@ -1,15 +1,14 @@
-export function toHash(str) {
-    if (str) {
-        let hash = 0;
-        for (let i = 0; i < str.length; i++) {
-            const char = str.charCodeAt(i);
-            hash = ((hash << 5) - hash) + char;
-            hash = hash & hash;
-        }
-        return hash < 0 ? 'hn' + Math.abs(hash) : 'hp' + hash;
-    }
-    else {
-        return '';
-    }
-}
+export function toHash(str) {
+    if (str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (((hash << 5) - hash) + char) | 0;
+        }
+        return hash < 0 ? 'hn' + Math.abs(hash) : 'hp' + hash;
+    }
+    else {
+        return '';
+    }
+}
 //# sourceMappingURL=to-hash.js.map

package/dist/esm/str/to-hash/to-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-hash.js","sourceRoot":"","sources":["../../../../src/str/to-hash/to-hash.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,GAAG,EAAE;QACP,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;SACpB;QAED,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;KACvD;SAAM;QACL,OAAO,EAAE,CAAC;KACX;AACH,CAAC"}
+{"version":3,"file":"to-hash.js","sourceRoot":"","sources":["../../../../src/str/to-hash/to-hash.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/esm/str/with-capital/with-capital.js

@@ -1,4 +1,4 @@
-export function withCapital(str) {
-    return str.charAt(0).toUpperCase() + str.substring(1);
-}
+export function withCapital(str) {
+    return str.charAt(0).toUpperCase() + str.substring(1);
+}
 //# sourceMappingURL=with-capital.js.map

package/dist/types/arr/at/at.d.ts

@@ -1,8 +1,8 @@
-/**
- * Returns the array item at index, or undefined if there is no index.
- * For negative indexes, returns items from the end
- * @param arr - any array
- * @param index - item index
- */
-export declare function at<T>(arr: T[], index: number): T | undefined;
+/**
+ * Returns the array item at index, or undefined if there is no index.
+ * For negative indexes, returns items from the end
+ * @param arr - any array
+ * @param index - item index
+ */
+export declare function at<T>(arr: T[], index: number): T | undefined;
 //# sourceMappingURL=at.d.ts.map

package/dist/types/arr/at/at.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"at.d.ts","sourceRoot":"","sources":["../../../../src/arr/at/at.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAG5D"}
+{"version":3,"file":"at.d.ts","sourceRoot":"","sources":["../../../../src/arr/at/at.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE5D"}

package/dist/types/arr/cnd/cnd.d.ts

@@ -1,118 +1,118 @@
-/**
- * Represents a condition that is true if the function returns true
- * Used for the cnd function
- */
-export declare type MatchConditionFn = (value: any) => boolean;
-/**
- * Represents a condition that is true if the value is the same as the condition
- * Used for the cnd function
- */
-export declare type MatchConditionIs = {
-    is: any;
-};
-/**
- * Represents a condition that is true if the value is the same for at least one part of the condition
- * Used for the cnd function
- */
-export declare type MatchConditionOr = {
-    or: any[];
-};
-/**
- * Represents a condition that is true if the value is not the same for each part of the condition
- * Used for the cnd function
- */
-export declare type MatchConditionNot = {
-    not: any[];
-};
-/**
- * Represents a condition that is true if the value is equal to the condition
- * Used for the cnd function
- */
-export declare type MatchConditionEqual = {
-    equal: any;
-};
-/**
- * Represents a condition that is true if the value is equal to at least one part of the condition
- * Used for the cnd function
- */
-export declare type MatchConditionOrEqual = {
-    orEqual: any[];
-};
-/**
- * Represents a condition that is true if the value is not equal to each part of the condition
- * Used for the cnd function
- */
-export declare type MatchConditionNotEqual = {
-    notEqual: any[];
-};
-/**
- * Represents a group of all object condition types
- * Used for the cnd function
- */
-export declare type MatchConditionObj = MatchConditionIs | MatchConditionOr | MatchConditionNot | MatchConditionEqual | MatchConditionOrEqual | MatchConditionNotEqual;
-/**
- * Represents a condition that is true if the value of each field matches each field condition
- * Used for the cnd function
- */
-export declare type MatchConditionsByFields = {
-    [field: string]: MatchConditionObj | RegExp;
-};
-/**
- * Represents all condition types for the cnd function
- */
-export declare type MatchConditions = MatchConditionFn | MatchConditionObj | MatchConditionsByFields;
-/**
- * Returns a function that checks if a value matches the conditions
- * @example
- * import {cnd} from '@bitfiber/utils/arr';
- *
- * const obj1 = {name: 'Alex'};
- * const obj2 = {name: 'Mary'};
- * const obj3 = {name: 'Jack'};
- * const arr = [obj1, obj2, obj3];
- * const strArr = ['Alex', 'Mary', 'Jack'];
- *
- * // Handler for comparison
- * arr.filter(cnd(obj => obj.name === 'Alex')); // [{name: 'Alex'}]
- *
- * // Strict value comparison
- * arr.filter(cnd({is: obj1})); // [{name: 'Alex'}]
- * arr.filter(cnd({is: {name: 'Alex'}})); // []
- * arr.filter(cnd({or: [obj1, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({or: [{name: 'Alex'}, obj2]})); // [{name: 'Mary'}]
- * arr.filter(cnd({not: [obj1, obj2]})); // [{name: 'Jack'}]
- * arr.filter(cnd({not: [{name: 'Alex'}, obj2]})); // [{name: 'Alex'}, {name: 'Jack'}]
- *
- * // Value equivalence comparison
- * arr.filter(cnd({equal: obj1})); // [{name: 'Alex'}]
- * arr.filter(cnd({equal: {name: 'Alex'}})); // [{name: 'Alex'}]
- * arr.filter(cnd({orEqual: [obj1, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({orEqual: [{name: 'Alex'}, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({notEqual: [obj1, obj2]})); // [{name: 'Jack'}]
- * arr.filter(cnd({notEqual: [{name: 'Alex'}, obj2]})); // [{name: 'Jack'}]
- *
- * // String value RegExp comparison
- * strArr.filter(cnd({equal: /^Alex$/})); // ['Alex']
- * strArr.filter(cnd({orEqual: [/^Alex$/, /^Mary$/]})); // ['Alex', 'Mary']
- * strArr.filter(cnd({notEqual: [/^Alex$/, /^Mary$/]})); // ['Jack']
- *
- * // Strict comparison of field value in objects
- * arr.filter(cnd({name: {is: 'Alex'}})); // [{name: 'Alex'}]
- * arr.filter(cnd({name: {or: ['Alex', 'Mary']}})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({name: {not: ['Alex', 'Mary']}})); // [{name: 'Jack'}]
- *
- * // Comparison of field value equivalence in objects
- * arr.filter(cnd({name: {equal: 'Alex'}})); // [{name: 'Alex'}]
- * arr.filter(cnd({name: {orEqual: ['Alex', 'Mary']}})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({name: {notEqual: ['Alex', 'Mary']}})); // [{name: 'Jack'}]
- *
- * // Comparing string fields in objects using RegExp
- * arr.filter(cnd({name: /^Alex$/})); // [{name: 'Alex'}]
- * arr.filter(cnd({name: {equal: /^Alex$/}})); // [{name: 'Alex'}]
- * arr.filter(cnd({name: {orEqual: [/^Alex$/, /^Mary$/]}})); // [{name: 'Alex'}, {name: 'Mary'}]
- * arr.filter(cnd({name: {notEqual: [/^Alex$/, /^Mary$/]}})); // [{name: 'Jack'}]
- *
- * @param conditions
- */
-export declare function cnd(conditions: MatchConditions): MatchConditionFn;
+/**
+ * Represents a condition that is true if the function returns true
+ * Used for the cnd function
+ */
+export type MatchConditionFn = (value: any) => boolean;
+/**
+ * Represents a condition that is true if the value is the same as the condition
+ * Used for the cnd function
+ */
+export type MatchConditionIs = {
+    is: any;
+};
+/**
+ * Represents a condition that is true if the value is the same for at least one part of the condition
+ * Used for the cnd function
+ */
+export type MatchConditionOr = {
+    or: any[];
+};
+/**
+ * Represents a condition that is true if the value is not the same for each part of the condition
+ * Used for the cnd function
+ */
+export type MatchConditionNot = {
+    not: any[];
+};
+/**
+ * Represents a condition that is true if the value is equal to the condition
+ * Used for the cnd function
+ */
+export type MatchConditionEqual = {
+    equal: any;
+};
+/**
+ * Represents a condition that is true if the value is equal to at least one part of the condition
+ * Used for the cnd function
+ */
+export type MatchConditionOrEqual = {
+    orEqual: any[];
+};
+/**
+ * Represents a condition that is true if the value is not equal to each part of the condition
+ * Used for the cnd function
+ */
+export type MatchConditionNotEqual = {
+    notEqual: any[];
+};
+/**
+ * Represents a group of all object condition types
+ * Used for the cnd function
+ */
+export type MatchConditionObj = MatchConditionIs | MatchConditionOr | MatchConditionNot | MatchConditionEqual | MatchConditionOrEqual | MatchConditionNotEqual;
+/**
+ * Represents a condition that is true if the value of each field matches each field condition
+ * Used for the cnd function
+ */
+export type MatchConditionsByFields = {
+    [field: string]: MatchConditionObj | RegExp;
+};
+/**
+ * Represents all condition types for the cnd function
+ */
+export type MatchConditions = MatchConditionFn | MatchConditionObj | MatchConditionsByFields;
+/**
+ * Returns a function that checks if a value matches the conditions
+ * @example
+ * import {cnd} from '@bitfiber/utils/arr';
+ *
+ * const obj1 = {name: 'Alex'};
+ * const obj2 = {name: 'Mary'};
+ * const obj3 = {name: 'Jack'};
+ * const arr = [obj1, obj2, obj3];
+ * const strArr = ['Alex', 'Mary', 'Jack'];
+ *
+ * // Handler for comparison
+ * arr.filter(cnd(obj => obj.name === 'Alex')); // [{name: 'Alex'}]
+ *
+ * // Strict value comparison
+ * arr.filter(cnd({is: obj1})); // [{name: 'Alex'}]
+ * arr.filter(cnd({is: {name: 'Alex'}})); // []
+ * arr.filter(cnd({or: [obj1, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({or: [{name: 'Alex'}, obj2]})); // [{name: 'Mary'}]
+ * arr.filter(cnd({not: [obj1, obj2]})); // [{name: 'Jack'}]
+ * arr.filter(cnd({not: [{name: 'Alex'}, obj2]})); // [{name: 'Alex'}, {name: 'Jack'}]
+ *
+ * // Value equivalence comparison
+ * arr.filter(cnd({equal: obj1})); // [{name: 'Alex'}]
+ * arr.filter(cnd({equal: {name: 'Alex'}})); // [{name: 'Alex'}]
+ * arr.filter(cnd({orEqual: [obj1, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({orEqual: [{name: 'Alex'}, obj2]})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({notEqual: [obj1, obj2]})); // [{name: 'Jack'}]
+ * arr.filter(cnd({notEqual: [{name: 'Alex'}, obj2]})); // [{name: 'Jack'}]
+ *
+ * // String value RegExp comparison
+ * strArr.filter(cnd({equal: /^Alex$/})); // ['Alex']
+ * strArr.filter(cnd({orEqual: [/^Alex$/, /^Mary$/]})); // ['Alex', 'Mary']
+ * strArr.filter(cnd({notEqual: [/^Alex$/, /^Mary$/]})); // ['Jack']
+ *
+ * // Strict comparison of field value in objects
+ * arr.filter(cnd({name: {is: 'Alex'}})); // [{name: 'Alex'}]
+ * arr.filter(cnd({name: {or: ['Alex', 'Mary']}})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({name: {not: ['Alex', 'Mary']}})); // [{name: 'Jack'}]
+ *
+ * // Comparison of field value equivalence in objects
+ * arr.filter(cnd({name: {equal: 'Alex'}})); // [{name: 'Alex'}]
+ * arr.filter(cnd({name: {orEqual: ['Alex', 'Mary']}})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({name: {notEqual: ['Alex', 'Mary']}})); // [{name: 'Jack'}]
+ *
+ * // Comparing string fields in objects using RegExp
+ * arr.filter(cnd({name: /^Alex$/})); // [{name: 'Alex'}]
+ * arr.filter(cnd({name: {equal: /^Alex$/}})); // [{name: 'Alex'}]
+ * arr.filter(cnd({name: {orEqual: [/^Alex$/, /^Mary$/]}})); // [{name: 'Alex'}, {name: 'Mary'}]
+ * arr.filter(cnd({name: {notEqual: [/^Alex$/, /^Mary$/]}})); // [{name: 'Jack'}]
+ *
+ * @param conditions
+ */
+export declare function cnd(conditions: MatchConditions): MatchConditionFn;
 //# sourceMappingURL=cnd.d.ts.map

package/dist/types/arr/cnd/cnd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cnd.d.ts","sourceRoot":"","sources":["../../../../src/arr/cnd/cnd.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,oBAAY,gBAAgB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAEvD;;;GAGG;AACH,oBAAY,gBAAgB,GAAG;IAAC,EAAE,EAAE,GAAG,CAAA;CAAC,CAAC;AAEzC;;;GAGG;AACH,oBAAY,gBAAgB,GAAG;IAAC,EAAE,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAE3C;;;GAGG;AACH,oBAAY,iBAAiB,GAAG;IAAC,GAAG,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAE7C;;;GAGG;AACH,oBAAY,mBAAmB,GAAG;IAAC,KAAK,EAAE,GAAG,CAAA;CAAC,CAAC;AAE/C;;;GAGG;AACH,oBAAY,qBAAqB,GAAG;IAAC,OAAO,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAErD;;;GAGG;AACH,oBAAY,sBAAsB,GAAG;IAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAEvD;;;GAGG;AACH,oBAAY,iBAAiB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GACnF,mBAAmB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;AAEzE;;;GAGG;AACH,oBAAY,uBAAuB,GAAG;IACpC,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,oBAAY,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,uBAAuB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,gBAAgB,CAqEjE"}
+{"version":3,"file":"cnd.d.ts","sourceRoot":"","sources":["../../../../src/arr/cnd/cnd.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAC,EAAE,EAAE,GAAG,CAAA;CAAC,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAC,EAAE,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAC,GAAG,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAAC,KAAK,EAAE,GAAG,CAAA;CAAC,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAC,OAAO,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GACnF,mBAAmB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,uBAAuB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,gBAAgB,CAqEjE"}

package/dist/types/arr/diff-arr/diff-arr.d.ts

@@ -1,31 +1,31 @@
-import { NumStr } from '../../common';
-/**
- * Represents response of the diffArr function
- */
-export interface ArrDiff<T> {
-    /**
-     * Contains items that are only in array 1
-     */
-    only1: T[];
-    /**
-     * Contains items that are only in array 2
-     */
-    only2: T[];
-    /**
-     * Contains items that are in both arrays
-     */
-    equal: T[];
-    /**
-     * True if only1 and only2 are empty, otherwise false
-     */
-    isEqual: boolean;
-}
-/**
- * Returns the difference between two arrays
- * Strict comparison of array items is applied
- * The order doesn't matter
- * @param arr1 - array 1
- * @param arr2 - array 2
- */
-export declare function diffArr<T extends NumStr>(arr1: T[], arr2: T[]): ArrDiff<T>;
+import { NumStr } from '../../common';
+/**
+ * Represents response of the diffArr function
+ */
+export interface ArrDiff<T> {
+    /**
+     * Contains items that are only in array 1
+     */
+    only1: T[];
+    /**
+     * Contains items that are only in array 2
+     */
+    only2: T[];
+    /**
+     * Contains items that are in both arrays
+     */
+    equal: T[];
+    /**
+     * True if only1 and only2 are empty, otherwise false
+     */
+    isEqual: boolean;
+}
+/**
+ * Returns the difference between two arrays
+ * Strict comparison of array items is applied
+ * The order doesn't matter, duplicate values are ignored
+ * @param arr1 - array 1
+ * @param arr2 - array 2
+ */
+export declare function diffArr<T extends NumStr>(arr1: T[], arr2: T[]): ArrDiff<T>;
 //# sourceMappingURL=diff-arr.d.ts.map

package/dist/types/arr/fill/fill.d.ts

@@ -1,9 +1,9 @@
-/**
- * Fills a new array with items that will be returned by the handler,
- * which will be called a certain number of times
- * @param quantity - number of array items
- * @param handler - a function that should return a new array item
- * @param offset - offset for the index, which is passed to the handler
- */
-export declare function fill<T>(quantity: number, handler: (offsetIndex: number, index: number) => T, offset?: number): T[];
+/**
+ * Fills a new array with items that will be returned by the handler,
+ * which will be called a certain number of times
+ * @param quantity - number of array items
+ * @param handler - a function that should return a new array item
+ * @param offset - offset for the index, which is passed to the handler
+ */
+export declare function fill<T>(quantity: number, handler: (offsetIndex: number, index: number) => T, offset?: number): T[];
 //# sourceMappingURL=fill.d.ts.map

package/dist/types/arr/for-each-arr/for-each-arr.d.ts

@@ -1,10 +1,10 @@
-import { Arr, ValueUnion } from '../../common';
-/**
- * Iterates through all the items of an array and calls a handler for each item
- * If the handler returns INTERRUPT, the loop will be interrupted
- * @param arr - an array or any typed array
- * @param handler - function called for each item
- * @param reverse - iterates in reverse order if true
- */
-export declare function forEachArr<T extends Arr, V extends ValueUnion<T>>(arr: T, handler: (value: V, index: number, arr: T) => any, reverse?: boolean): void;
+import { Arr, ValueUnion } from '../../common';
+/**
+ * Iterates through all the items of an array and calls a handler for each item
+ * If the handler returns INTERRUPT, the loop will be interrupted
+ * @param arr - an array or any typed array
+ * @param handler - function called for each item
+ * @param reverse - iterates in reverse order if true
+ */
+export declare function forEachArr<T extends Arr, V extends ValueUnion<T>>(arr: T, handler: (value: V, index: number, arr: T) => any, reverse?: boolean): void;
 //# sourceMappingURL=for-each-arr.d.ts.map

package/dist/types/arr/index-by/index-by.d.ts

@@ -1,10 +1,10 @@
-import { Obj, Index } from '../../common';
-/**
- * Returns an object indexed by the values from a specific field of each item
- * or from a function that is executed on each item
- * @param arr - array of objects
- * @param fieldOrFn - the name of the field from which the index value should be taken,
- * or the function that should return the index value
- */
-export declare function indexBy<T extends Obj>(arr: T[], fieldOrFn: string | ((item: T) => string)): Index<T>;
+import { Obj, Index } from '../../common';
+/**
+ * Returns an object indexed by the values from a specific field of each item
+ * or from a function that is executed on each item
+ * @param arr - array of objects
+ * @param fieldOrFn - the name of the field from which the index value should be taken,
+ * or the function that should return the index value
+ */
+export declare function indexBy<T extends Obj>(arr: T[], fieldOrFn: string | ((item: T) => string)): Index<T>;
 //# sourceMappingURL=index-by.d.ts.map

package/dist/types/arr/index.d.ts

@@ -1,9 +1,9 @@
-export { at } from './at/at';
-export { within } from './within/within';
-export { pluck } from './pluck/pluck';
-export { indexBy } from './index-by/index-by';
-export { fill } from './fill/fill';
-export { diffArr, ArrDiff } from './diff-arr/diff-arr';
-export { forEachArr } from './for-each-arr/for-each-arr';
-export { cnd, MatchConditionFn, MatchConditionIs, MatchConditionOr, MatchConditionNot, MatchConditionEqual, MatchConditionOrEqual, MatchConditionNotEqual, MatchConditionObj, MatchConditionsByFields, MatchConditions, } from './cnd/cnd';
+export { at } from './at/at';
+export { within } from './within/within';
+export { pluck } from './pluck/pluck';
+export { indexBy } from './index-by/index-by';
+export { fill } from './fill/fill';
+export { diffArr, ArrDiff } from './diff-arr/diff-arr';
+export { forEachArr } from './for-each-arr/for-each-arr';
+export { cnd, MatchConditionFn, MatchConditionIs, MatchConditionOr, MatchConditionNot, MatchConditionEqual, MatchConditionOrEqual, MatchConditionNotEqual, MatchConditionObj, MatchConditionsByFields, MatchConditions, } from './cnd/cnd';
 //# sourceMappingURL=index.d.ts.map