@bitfiber/utils 1.0.3 → 1.1.0

package/README.md

@@ -13,25 +13,27 @@ different projects and domains.
 
 ## Key Features
 
-1. **Strict Typing:** The library leverages TypeScript to enforce strict typing, ensuring robust type checking at
-   compile time. This reduces the likelihood of runtime errors and enhances code reliability. TypeScript's type
-   inference capabilities also aid in writing cleaner and more maintainable code.
+1. **Strict Typing:** The library leverages TypeScript to enforce strict typing, ensuring robust
+   type checking at compile time. This reduces the likelihood of runtime errors and enhances code
+   reliability. TypeScript's type inference capabilities also aid in writing cleaner and more
+   maintainable code.
 
-2. **Tree Shaking:** The library's modular design enables tree shaking, allowing developers to optimize bundle sizes by
-   selectively importing only the necessary functionalities. This eliminates unused code, resulting in smaller and more
-   efficient applications.
+2. **Tree Shaking:** The library's modular design enables tree shaking, allowing developers to
+   optimize bundle sizes by selectively importing only the necessary functionalities.
+   This eliminates unused code, resulting in smaller and more efficient applications.
 
 3. **Common Use Cases:**
-    * Common Functions: Additional general-purpose utilities for tasks such as type checking, and more.
-    * String Manipulation: Functions for capitalizing strings, converting case, and more.
-    * Working with Numbers: Functions for numerical operations, such as rounding, formatting, converting, and more.
-    * Array Operations: Helper functions for working with arrays, such as comparison, traversal, mapping, and more.
-    * Object Operations: Utilities for working with objects, including functions for merging objects, deep cloning,
-      property access, and more.
-    * DOM Manipulation: Utilities for interacting with the Document Object Model (DOM), including functions for style
-      manipulation, traversal, and more.
-    * Environment Handling: Functions for utilizing User Agent information for tailored content delivery and feature
-      adaptation.
+
+* Common Functions: Additional general-purpose utilities for tasks such as type checking, and more.
+* String Manipulation: Functions for capitalizing strings, converting case, and more.
+* Working with Numbers: Functions for numerical operations, such as rounding, formatting, converting, and more.
+* Array Operations: Helper functions for working with arrays, such as comparison, traversal, mapping, and more.
+* Object Operations: Utilities for working with objects, including functions for merging objects, deep cloning,
+  property access, and more.
+* DOM Manipulation: Utilities for interacting with the Document Object Model (DOM), including functions for style
+  manipulation, traversal, and more.
+* Environment Handling: Functions for utilizing User Agent information for tailored content delivery and feature
+  adaptation.
 
 ---
 
@@ -285,8 +287,16 @@ If the handler returns INTERRUPT, the loop will be interrupted
 ```ts
 import {forEach, INTERRUPT} from '@bitfiber/utils';
 
-forEach(new Set([1, 2, 3]), (item, i) => console.log(item), true); // 3 -> 2 -> 1
-forEach(new Map([[1, 1], [2, 2], [3, 3]]), (item, i) => (item === 2 ? INTERRUPT : console.log(item))); // 1
+forEach(
+  new Set([1, 2, 3]),
+  (item, i) => console.log(item),
+  true
+); // 3 -> 2 -> 1
+
+forEach(
+  new Map([[1, 1], [2, 2], [3, 3]]),
+  (item, i) => (item === 2 ? INTERRUPT : console.log(item))
+); // 1
 ```
 
 ---
@@ -973,10 +983,7 @@ Makes an object and its nested objects read-only
 ```ts
 import {deepConstant} from '@bitfiber/utils/obj';
 
-const readOnlyObj = deepConstant({
-  a: 1,
-  b: {c: 2}
-});
+const readOnlyObj = deepConstant({a: 1, b: {c: 2}});
 ```
 
 ---
@@ -995,19 +1002,10 @@ Returns the difference between two objects
 ```ts
 import {diffObj} from '@bitfiber/utils/obj';
 
-const result = diffObj({
-  a: 1,
-  b: 2,
-  c: {d: 4},
-  e: {f: 5},
-  i: 7
-}, {
-  a: 1,
-  b: 3,
-  c: {d: 4},
-  e: {g: 5},
-  j: 8
-});
+const result = diffObj(
+  {a: 1, b: 2, c: {d: 4}, e: {f: 5}, i: 7},
+  {a: 1, b: 3, c: {d: 4}, e: {g: 5}, j: 8},
+);
 
 /*
 result = {
@@ -1036,10 +1034,7 @@ Returns a new object with the fields of the passed object, excluding the specifi
 ```ts
 import {exclude} from '@bitfiber/utils/obj';
 
-const obj = exclude({
-  a: 1,
-  b: 2
-}, 'b'); // {a: 1}
+const obj = exclude({a: 1, b: 2}, 'b'); // {a: 1}
 ```
 
 ---
@@ -1098,14 +1093,16 @@ If the handler returns INTERRUPT, the loop will be interrupted
 import {INTERRUPT} from '@bitfiber/utils';
 import {forEachObj} from '@bitfiber/utils/obj';
 
-forEachObj({
-  a: 1,
-  b: 2
-}, (v, k) => console.log(v), true); // 2 -> 1
-forEachObj({
-  a: 1,
-  b: 2
-}, (v, k) => (v === 2 ? INTERRUPT : console.log(v))); // 1
+forEachObj(
+  {a: 1, b: 2},
+  (v, k) => console.log(v),
+  true,
+); // 2 -> 1
+
+forEachObj(
+  {a: 1, b: 2},
+  (v, k) => (v === 2 ? INTERRUPT : console.log(v)),
+); // 1
 ```
 
 ---
@@ -1123,14 +1120,8 @@ If the property is inherited, or does not exist, the method returns false
 ```ts
 import {hasOwn} from '@bitfiber/utils/obj';
 
-hasOwn({
-  a: 1,
-  b: 2
-}, 'a'); // true
-hasOwn({
-  a: 1,
-  b: 2
-}, 'c'); // false
+hasOwn({a: 1, b: 2}, 'a'); // true
+hasOwn({a: 1, b: 2}, 'c'); // false
 ```
 
 ---
@@ -1148,10 +1139,7 @@ Returns a new object with the specified set of fields
 ```ts
 import {include} from '@bitfiber/utils/obj';
 
-const obj = include({
-  a: 1,
-  b: 2
-}, 'b'); // {b: 2}
+const obj = include({a: 1, b: 2}, 'b'); // {b: 2}
 ```
 
 ---
@@ -1168,10 +1156,7 @@ Returns an array of the object's own enumerable property names
 ```ts
 import {keys} from '@bitfiber/utils/obj';
 
-const arr = keys({
-  a: 1,
-  b: 2
-}, 'b'); // ['a', 'b']
+const arr = keys({a: 1, b: 2}, 'b'); // ['a', 'b']
 ```
 
 ---
@@ -1189,10 +1174,7 @@ Returns a new object, which has the mapped values of object fields
 ```ts
 import {mapObj} from '@bitfiber/utils/obj';
 
-const obj = mapObj({
-  a: 1,
-  b: 2
-}, (v, k) => k); // {a: 'a', b: 'b'}
+const obj = mapObj({a: 1, b: 2}, (v, k) => k); // {a: 'a', b: 'b'}
 ```
 
 ---
@@ -1210,10 +1192,10 @@ Returns an array, which has the mapped values of object fields
 ```ts
 import {mapObjToArr} from '@bitfiber/utils/obj';
 
-const arr = mapObjToArr({
-  a: 1,
-  b: 2
-}, (v, k) => [k, v]); // [['a', 1], ['b', 2]]
+const arr = mapObjToArr(
+  {a: 1, b: 2},
+  (v, k) => [k, v],
+); // [['a', 1], ['b', 2]]
 ```
 
 ---
@@ -1230,10 +1212,7 @@ Returns an array of values for each object's own enumerable property
 ```ts
 import {values} from '@bitfiber/utils/obj';
 
-const arr = values({
-  a: 1,
-  b: 2
-}); // [1, 2]
+const arr = values({a: 1, b: 2}); // [1, 2]
 ```
 
 ---
@@ -1418,13 +1397,8 @@ or the function that should return the index value
 import {indexBy} from '@bitfiber/utils/arr';
 
 const arr = [
-  {
-    id: '1',
-    name: 'Alex'
-  }, {
-    id: '2',
-    name: 'Mary'
-  }
+  {id: '1', name: 'Alex'},
+  {id: '2', name: 'Mary'},
 ];
 indexBy(arr, 'name'); // {Alex: {id: '1', name: 'Alex'}, Mary: {id: '2', name: 'Mary'}}
 ```
@@ -1445,14 +1419,10 @@ Returns an array with values, each of which corresponds to the value of a certai
 import {pluck} from '@bitfiber/utils/arr';
 
 const arr = [
-  {
-    id: '1',
-    name: 'Alex'
-  }, {
-    id: '2',
-    name: 'Mary'
-  }
+  {id: '1', name: 'Alex'},
+  {id: '2', name: 'Mary'}
 ];
+
 pluck(arr, 'name'); // ['Alex', 'Mary']
 ```
 
@@ -1565,16 +1535,8 @@ inRange(10.11, {precision: 0}); // 10
 inRange(10.11, {precision: 1}); // 10.1
 inRange(null, {required: true}); // 0
 inRange(null, {min: 10}); // null
-inRange(null, {
-  min: 10,
-  required: true
-}); // 10
-inRange(30.555, {
-  min: 10,
-  max: 20.3,
-  precision: 1,
-  required: true
-}); // 20.3
+inRange(null, {min: 10, required: true}); // 10
+inRange(30.555, {min: 10, max: 20.3, precision: 1, required: true}); // 20.3
 ```
 
 ---
@@ -1658,6 +1620,7 @@ setDocument(inject(DOCUMENT));
 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: string` - file URL  
+`@param fetchOptions?: RequestInit` - fetch options  
 `@returns Promise<Blob>`
 
 **Example:**
@@ -2030,10 +1993,7 @@ import {setOffsetFromParent} from '@bitfiber/utils/dom';
 
 const doc = getDocument();
 const div = doc.createElement('div');
-setOffsetFromParent(div, {
-  top: 30,
-  left: 40
-});
+setOffsetFromParent(div, {top: 30, left: 40});
 ```
 
 ---
@@ -2073,10 +2033,10 @@ import {setStyles} from '@bitfiber/utils/dom';
 
 const doc = getDocument();
 const div = doc.createElement('div');
-const prevStyles = setStyles(div, {
-  width: '200px',
-  height: '10px',
-}); // {width: '100px', height: '5px'}
+const prevStyles = setStyles(
+  div,
+  {width: '200px', height: '10px'},
+); // {width: '100px', height: '5px'}
 ```
 
 ---
@@ -2390,8 +2350,7 @@ matches({desktop: {windows: {chrome: '96.0.4664.110'}}});
 matches({
   desktop: {
     windows: {
-      osVersion: '~10',
-      engines: 'blink'
+      osVersion: '~10', engines: 'blink'
     }
   }
 });
@@ -2400,10 +2359,8 @@ matches({
   desktop: {
     anyOS: {
       engines: {
-        blink: '>90.5',
-        gecko: '<=100'
+        blink: '>90.5', gecko: '<=100'
       }
-
     }
   }
 });
@@ -2411,8 +2368,7 @@ matches({
 matches({
   anyPlatform: {
     ios: {
-      chrome: '~96.1',
-      safari: '>80'
+      chrome: '~96.1', safari: '>80'
     }
   }
 });
@@ -2444,22 +2400,13 @@ to browser version conditions
 ```ts
 import {matchesWithBrowsers} from '@bitfiber/utils/env';
 
-matchesWithBrowsers({
-  firefox: '>=95.5',
-  chrome: '~96.0.4664'
-});
+matchesWithBrowsers({firefox: '>=95.5', chrome: '~96.0.4664'});
 
-matchesWithBrowsers({
-  engines: 'gecko',
-  firefox: '>100.1'
-});
+matchesWithBrowsers({engines: 'gecko', firefox: '>100.1'});
 
 matchesWithBrowsers({
-  engines: {
-    blink: '~96',
-    gecko: '110.5.0'
-  },
-  firefox: '>100.1'
+  engines: {blink: '~96', gecko: '110.5.0'},
+  firefox: '>100.1',
 });
 ```
 

package/dist/cjs/arr/at/at.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.at = void 0;
+function at(arr, index) {
+    return index < 0 ? arr[arr.length + index] : arr[index];
+}
+exports.at = at;
+//# sourceMappingURL=at.js.map

package/dist/cjs/arr/at/at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"at.js","sourceRoot":"","sources":["../../../../src/arr/at/at.ts"],"names":[],"mappings":";;;AAMA,SAAgB,EAAE,CAAI,GAAQ,EAAE,KAAa;IAE3C,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;AAHD,gBAGC"}

package/dist/cjs/arr/cnd/cnd.js

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

package/dist/cjs/arr/cnd/cnd.js.map

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

package/dist/cjs/arr/diff-arr/diff-arr.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffArr = void 0;
+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,
+    };
+}
+exports.diffArr = diffArr;
+//# sourceMappingURL=diff-arr.js.map

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

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

package/dist/cjs/arr/fill/fill.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fill = void 0;
+function fill(quantity, handler, offset = 1) {
+    return Array(quantity).fill(null).map((item, index) => handler(index + offset, index));
+}
+exports.fill = fill;
+//# sourceMappingURL=fill.js.map

package/dist/cjs/arr/fill/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../../src/arr/fill/fill.ts"],"names":[],"mappings":";;;AAOA,SAAgB,IAAI,CAClB,QAAgB,EAChB,OAAkD,EAClD,MAAM,GAAG,CAAC;IAEV,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;AAND,oBAMC"}

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forEachArr = void 0;
+const common_1 = require("../../common");
+function forEachArr(arr, handler, reverse) {
+    if (reverse) {
+        for (let i = arr.length - 1; i >= 0; i--) {
+            if (handler(arr[i], i, arr) === common_1.INTERRUPT) {
+                return;
+            }
+        }
+    }
+    else {
+        for (let i = 0; i < arr.length; i++) {
+            if (handler(arr[i], i, arr) === common_1.INTERRUPT) {
+                return;
+            }
+        }
+    }
+}
+exports.forEachArr = forEachArr;
+//# sourceMappingURL=for-each-arr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"for-each-arr.js","sourceRoot":"","sources":["../../../../src/arr/for-each-arr/for-each-arr.ts"],"names":[],"mappings":";;;AAAA,yCAAwD;AASxD,SAAgB,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,kBAAS,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,kBAAS,EAAE;gBACzC,OAAO;aACR;SACF;KACF;AACH,CAAC;AAfD,gCAeC"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexBy = void 0;
+const common_1 = require("../../common");
+function indexBy(arr, fieldOrFn) {
+    const result = {};
+    arr.forEach(item => {
+        const key = (0, common_1.isFunction)(fieldOrFn) ? fieldOrFn(item) : item[fieldOrFn];
+        if (key) {
+            result[key] = item;
+        }
+    });
+    return result;
+}
+exports.indexBy = indexBy;
+//# sourceMappingURL=index-by.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-by.js","sourceRoot":"","sources":["../../../../src/arr/index-by/index-by.ts"],"names":[],"mappings":";;;AAAA,yCAAoD;AASpD,SAAgB,OAAO,CACrB,GAAQ,EACR,SAAyC;IAEzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,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;AAZD,0BAYC"}

package/dist/cjs/arr/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cnd = exports.forEachArr = exports.diffArr = exports.fill = exports.indexBy = exports.pluck = exports.within = exports.at = void 0;
+var at_1 = require("./at/at");
+Object.defineProperty(exports, "at", { enumerable: true, get: function () { return at_1.at; } });
+var within_1 = require("./within/within");
+Object.defineProperty(exports, "within", { enumerable: true, get: function () { return within_1.within; } });
+var pluck_1 = require("./pluck/pluck");
+Object.defineProperty(exports, "pluck", { enumerable: true, get: function () { return pluck_1.pluck; } });
+var index_by_1 = require("./index-by/index-by");
+Object.defineProperty(exports, "indexBy", { enumerable: true, get: function () { return index_by_1.indexBy; } });
+var fill_1 = require("./fill/fill");
+Object.defineProperty(exports, "fill", { enumerable: true, get: function () { return fill_1.fill; } });
+var diff_arr_1 = require("./diff-arr/diff-arr");
+Object.defineProperty(exports, "diffArr", { enumerable: true, get: function () { return diff_arr_1.diffArr; } });
+var for_each_arr_1 = require("./for-each-arr/for-each-arr");
+Object.defineProperty(exports, "forEachArr", { enumerable: true, get: function () { return for_each_arr_1.forEachArr; } });
+var cnd_1 = require("./cnd/cnd");
+Object.defineProperty(exports, "cnd", { enumerable: true, get: function () { return cnd_1.cnd; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/arr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/arr/index.ts"],"names":[],"mappings":";;;AAAA,8BAA2B;AAAnB,wFAAA,EAAE,OAAA;AACV,0CAAuC;AAA/B,gGAAA,MAAM,OAAA;AACd,uCAAoC;AAA5B,8FAAA,KAAK,OAAA;AACb,gDAA4C;AAApC,mGAAA,OAAO,OAAA;AACf,oCAAiC;AAAzB,4FAAA,IAAI,OAAA;AACZ,gDAAqD;AAA7C,mGAAA,OAAO,OAAA;AACf,4DAAuD;AAA/C,0GAAA,UAAU,OAAA;AAClB,iCAImB;AAHjB,0FAAA,GAAG,OAAA"}

package/dist/cjs/arr/pluck/pluck.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluck = void 0;
+function pluck(arr, fieldName) {
+    const result = [];
+    arr.forEach(item => {
+        result.push(item[fieldName]);
+    });
+    return result;
+}
+exports.pluck = pluck;
+//# sourceMappingURL=pluck.js.map

package/dist/cjs/arr/pluck/pluck.js.map

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

package/dist/cjs/arr/within/within.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.within = void 0;
+const __1 = require("../");
+function within(arr, index) {
+    const max = arr.length;
+    return (0, __1.at)(arr, ((index + 1) % max || max) - 1);
+}
+exports.within = within;
+//# sourceMappingURL=within.js.map

package/dist/cjs/arr/within/within.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"within.js","sourceRoot":"","sources":["../../../../src/arr/within/within.ts"],"names":[],"mappings":";;;AAAA,2BAAuB;AAUvB,SAAgB,MAAM,CAAI,GAAQ,EAAE,KAAa;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,OAAO,IAAA,MAAE,EAAC,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAHD,wBAGC"}