@bitfiber/utils 1.0.0

package/arr/at/at.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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;

package/arr/at/at.js

@@ -0,0 +1,11 @@
+/**
+ * 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 function at(arr, index) {
+    // todo: change on 'Array.at' with ES2022
+    return index < 0 ? arr[arr.length + index] : arr[index];
+}
+//# sourceMappingURL=at.js.map

package/arr/at/at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"at.js","sourceRoot":"","sources":["../../../../package/src/arr/at/at.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,EAAE,CAAI,GAAQ,EAAE,KAAa;IAC3C,yCAAyC;IACzC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/arr/cnd/cnd.d.ts

@@ -0,0 +1,55 @@
+import { MatchConditionFn, MatchConditions } from '../';
+/**
+ * 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;

package/arr/cnd/cnd.js

@@ -0,0 +1,136 @@
+import { BfError, isFunction, isObject, isRegExp, isString, same, equals, isArray } from '../../';
+import { hasOwn } from '../../obj';
+/**
+ * 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 function cnd(conditions) {
+    if (isFunction(conditions)) {
+        return conditions;
+    }
+    else if ('is' in conditions) {
+        return value => same(conditions.is, value);
+    }
+    else if ('or' in conditions) {
+        return value => (isArray(conditions.or) ? conditions.or.some(item => same(item, value)) : cndErr());
+    }
+    else if ('not' in conditions) {
+        return value => (isArray(conditions.not) ? !conditions.not.some(item => same(item, value)) : cndErr());
+    }
+    else if ('equal' in conditions) {
+        return value => fit(conditions.equal, value);
+    }
+    else if ('orEqual' in conditions) {
+        return value => (isArray(conditions.orEqual) ? conditions.orEqual.some(item => fit(item, value)) : cndErr());
+    }
+    else if ('notEqual' in conditions) {
+        return value => (isArray(conditions.notEqual) ? !conditions.notEqual.some(item => fit(item, value)) : cndErr());
+    }
+    else {
+        return obj => {
+            if (isObject(obj)) {
+                for (const key in conditions) {
+                    if (hasOwn(conditions, key)) {
+                        const value = obj[key];
+                        const condition = conditions[key];
+                        if (isRegExp(condition)) {
+                            if (!fit(condition, value)) {
+                                return false;
+                            }
+                        }
+                        else if ('is' in condition) {
+                            if (!same(condition.is, value)) {
+                                return false;
+                            }
+                        }
+                        else if ('or' in condition) {
+                            if (!condition.or.some(item => same(item, value))) {
+                                return false;
+                            }
+                        }
+                        else if ('not' in condition) {
+                            if (condition.not.some(item => same(item, value))) {
+                                return false;
+                            }
+                        }
+                        else if ('equal' in condition) {
+                            if (!fit(condition.equal, value)) {
+                                return false;
+                            }
+                        }
+                        else if ('orEqual' in condition) {
+                            if (!condition.orEqual.some(item => fit(item, value))) {
+                                return false;
+                            }
+                        }
+                        else if ('notEqual' in condition) {
+                            if (condition.notEqual.some(item => fit(item, value))) {
+                                return false;
+                            }
+                        }
+                    }
+                }
+                return true;
+            }
+            else {
+                return false;
+            }
+        };
+    }
+}
+function fit(condition, value) {
+    return isRegExp(condition) ? isString(value) && condition.test(value) : equals(condition, value);
+}
+function cndErr() {
+    throw new BfError('"or", "not", "orEqual" and "notEqual" must be an array', { code: 'bf_utils_arr_cnd_1' });
+}
+//# sourceMappingURL=cnd.js.map

package/arr/cnd/cnd.js.map

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

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

@@ -0,0 +1,10 @@
+import { NumStr } from '../../';
+import { ArrDiff } from '../';
+/**
+ * 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>;

package/arr/diff-arr/diff-arr.js

@@ -0,0 +1,37 @@
+/**
+ * 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 function diffArr(arr1, arr2) {
+    let isEqual = true;
+    const only1 = [];
+    const only2 = [];
+    const equal = [];
+    const map1 = new Map(arr1.map(value => [value, true]));
+    const map2 = new Map(arr2.map(value => [value, true]));
+    for (const value of map1.keys()) {
+        if (!map2.has(value)) {
+            isEqual = false;
+            only1.push(value);
+        }
+        else {
+            equal.push(value);
+        }
+    }
+    for (const value of map2.keys()) {
+        if (!map1.has(value)) {
+            isEqual = false;
+            only2.push(value);
+        }
+    }
+    return {
+        only1,
+        only2,
+        equal,
+        isEqual,
+    };
+}
+//# sourceMappingURL=diff-arr.js.map

package/arr/diff-arr/diff-arr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-arr.js","sourceRoot":"","sources":["../../../../package/src/arr/diff-arr/diff-arr.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAmB,IAAS,EAAE,IAAS;IAC5D,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACpB,OAAO,GAAG,KAAK,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACnB;aAAM;YACL,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACnB;KACF;IAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACpB,OAAO,GAAG,KAAK,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACnB;KACF;IAED,OAAO;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/arr/fill/fill.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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[];

package/arr/fill/fill.js

@@ -0,0 +1,11 @@
+/**
+ * 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 function fill(quantity, handler, offset = 1) {
+    return Array(quantity).fill(null).map((item, index) => handler(index + offset, index));
+}
+//# sourceMappingURL=fill.js.map

package/arr/fill/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../../package/src/arr/fill/fill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAI,QAAgB,EAAE,OAAkD,EAAE,MAAM,GAAG,CAAC;IACtG,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACzF,CAAC"}

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

@@ -0,0 +1,9 @@
+import { Arr, ValueUnion } from '../../';
+/**
+ * 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;

package/arr/for-each-arr/for-each-arr.js

@@ -0,0 +1,25 @@
+import { INTERRUPT } from '../../';
+/**
+ * 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 function forEachArr(arr, handler, reverse) {
+    if (reverse) {
+        for (let i = arr.length - 1; i >= 0; i--) {
+            if (handler(arr[i], i, arr) === INTERRUPT) {
+                return;
+            }
+        }
+    }
+    else {
+        for (let i = 0; i < arr.length; i++) {
+            if (handler(arr[i], i, arr) === INTERRUPT) {
+                return;
+            }
+        }
+    }
+}
+//# sourceMappingURL=for-each-arr.js.map

package/arr/for-each-arr/for-each-arr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for-each-arr.js","sourceRoot":"","sources":["../../../../package/src/arr/for-each-arr/for-each-arr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,SAAS,EAAa,MAAM,QAAQ,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAyC,GAAM,EACvE,OAAiD,EAAE,OAAiB;IACpE,IAAI,OAAO,EAAE;QACX,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;YACxC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,SAAS,EAAE;gBACzC,OAAO;aACR;SACF;KACF;SAAM;QACL,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,SAAS,EAAE;gBACzC,OAAO;aACR;SACF;KACF;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+import { Obj, Index } from '../../';
+/**
+ * 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>;

package/arr/index-by/index-by.js

@@ -0,0 +1,19 @@
+import { isFunction } from '../../';
+/**
+ * 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 function indexBy(arr, fieldOrFn) {
+    const result = {};
+    arr.forEach(item => {
+        const key = isFunction(fieldOrFn) ? fieldOrFn(item) : item[fieldOrFn];
+        if (key) {
+            result[key] = item;
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=index-by.js.map

package/arr/index-by/index-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-by.js","sourceRoot":"","sources":["../../../../package/src/arr/index-by/index-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAa,MAAM,QAAQ,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAgB,GAAQ,EAAE,SAAyC;IACxF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,GAAG,EAAE;YACP,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;SACpB;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/arr/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types';
+export * from './at/at';
+export * from './within/within';
+export * from './pluck/pluck';
+export * from './index-by/index-by';
+export * from './fill/fill';
+export * from './diff-arr/diff-arr';
+export * from './for-each-arr/for-each-arr';
+export * from './cnd/cnd';

package/arr/index.js

@@ -0,0 +1,10 @@
+export * from './types';
+export * from './at/at';
+export * from './within/within';
+export * from './pluck/pluck';
+export * from './index-by/index-by';
+export * from './fill/fill';
+export * from './diff-arr/diff-arr';
+export * from './for-each-arr/for-each-arr';
+export * from './cnd/cnd';
+//# sourceMappingURL=index.js.map

package/arr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../package/src/arr/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,WAAW,CAAC"}

package/arr/pluck/pluck.d.ts

@@ -0,0 +1,7 @@
+import { Obj } from '../../';
+/**
+ * Returns an array with values, each of which corresponds to the value of a certain array item field
+ * @param arr - array of objects
+ * @param fieldName - name of the array item field from which the value is to be taken
+ */
+export declare function pluck<T extends Obj, F extends keyof T>(arr: T[], fieldName: F): (T[F])[];

package/arr/pluck/pluck.js

@@ -0,0 +1,13 @@
+/**
+ * Returns an array with values, each of which corresponds to the value of a certain array item field
+ * @param arr - array of objects
+ * @param fieldName - name of the array item field from which the value is to be taken
+ */
+export function pluck(arr, fieldName) {
+    const result = [];
+    arr.forEach(item => {
+        result.push(item[fieldName]);
+    });
+    return result;
+}
+//# sourceMappingURL=pluck.js.map

package/arr/pluck/pluck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluck.js","sourceRoot":"","sources":["../../../../package/src/arr/pluck/pluck.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAmC,GAAQ,EAAE,SAAY;IAC5E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/arr/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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;
+}
+/**
+ * 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;

package/arr/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/arr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../package/src/arr/types.ts"],"names":[],"mappings":""}

package/arr/within/within.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns an array item by index.
+ * If the index is greater than the array length,
+ * then the array item will be obtained like remainder of division the index by the array length.
+ * For negative indexes, returns items from the end
+ * @param arr - any array
+ * @param index - an array item index
+ */
+export declare function within<T>(arr: T[], index: number): T | undefined;

package/arr/within/within.js

@@ -0,0 +1,14 @@
+import { at } from '../';
+/**
+ * Returns an array item by index.
+ * If the index is greater than the array length,
+ * then the array item will be obtained like remainder of division the index by the array length.
+ * For negative indexes, returns items from the end
+ * @param arr - any array
+ * @param index - an array item index
+ */
+export function within(arr, index) {
+    const max = arr.length;
+    return at(arr, ((index + 1) % max || max) - 1);
+}
+//# sourceMappingURL=within.js.map

package/arr/within/within.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"within.js","sourceRoot":"","sources":["../../../../package/src/arr/within/within.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,EAAE,EAAC,MAAM,KAAK,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAI,GAAQ,EAAE,KAAa;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/common/copy/copy.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a deep copy of a value of any type
+ * Objects, arrays, sets, maps etc. will be ignored if they have been visited to prevent looping
+ * @param value - anything
+ */
+export declare function copy<T>(value: T): T;

package/common/copy/copy.js

@@ -0,0 +1,86 @@
+import { isNumber, isBigInt, isBoolean, isString, isDate, isRegExp, isFunction, isMap, isSet, isObject, isArray, isTypedArray, isBlob, isArrayBuffer, isWindow, isDocument, isFile, isFormData, isPromise, isObservable, } from '../';
+import { forEachObj } from '../../obj';
+/**
+ * Creates a deep copy of a value of any type
+ * Objects, arrays, sets, maps etc. will be ignored if they have been visited to prevent looping
+ * @param value - anything
+ */
+export function copy(value) {
+    return _copy(value, new Map());
+}
+function _copy(value, visited) {
+    if (!value || isString(value) || isNumber(value) || isBigInt(value) || isBoolean(value) || isFunction(value)) {
+        return value;
+    }
+    else if (isDate(value)) {
+        return new Date(value.getTime());
+    }
+    else if (isArray(value)) {
+        if (visited.has(value)) {
+            return visited.get(value);
+        }
+        const arr = [];
+        visited.set(value, arr);
+        value.forEach(item => arr.push(_copy(item, visited)));
+        return arr;
+    }
+    else if (isSet(value)) {
+        if (visited.has(value)) {
+            return visited.get(value);
+        }
+        const newSet = new Set();
+        visited.set(value, newSet);
+        value.forEach(item => newSet.add(_copy(item, visited)));
+        return newSet;
+    }
+    else if (isMap(value)) {
+        if (visited.has(value)) {
+            return visited.get(value);
+        }
+        const newMap = new Map();
+        visited.set(value, newMap);
+        value.forEach((item, key) => newMap.set(_copy(key, visited), _copy(item, visited)));
+        return newMap;
+    }
+    else if (isRegExp(value)) {
+        // @ts-ignore
+        const reg = new RegExp(value.source, value.toString().match(/[^/]*$/)[0]);
+        reg.lastIndex = value.lastIndex;
+        return reg;
+    }
+    else if (isBlob(value)) {
+        return new Blob([value], { type: value.type });
+    }
+    else if (isArrayBuffer(value)) {
+        return value.slice(0);
+    }
+    else if (isTypedArray(value)) {
+        // @ts-ignore
+        return new value.constructor(value.buffer.slice(0), value.byteOffset, value.length);
+    }
+    else if (isWindow(value) || isDocument(value) || isFile(value) || isFormData(value) || isPromise(value)
+        || isObservable(value)) {
+        return value;
+    }
+    else if (isObject(value)) {
+        if (visited.has(value)) {
+            return visited.get(value);
+        }
+        const obj = Object.create(Object.getPrototypeOf(value));
+        visited.set(value, obj);
+        forEachObj(value, (val, key) => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.get) || (descriptor === null || descriptor === void 0 ? void 0 : descriptor.set)) {
+                Object.defineProperty(obj, key, descriptor);
+            }
+            else {
+                obj[key] = _copy(val, visited);
+            }
+        });
+        return obj;
+    }
+    else {
+        return value;
+    }
+}
+//# sourceMappingURL=copy.js.map