@bemoje/array 0.0.10 → 0.2.0

package/README.md

@@ -1,39 +1,11 @@
-# @bemoje/array
-array related tools/util.
+# array
 
-![GitHub Top Language](https://img.shields.io/github/languages/top/bemoje/https://github.com/bemoje/tsmono)
+This library was generated with [Nx](https://nx.dev).
 
-##### Github
-![GitHub Last Commit](https://img.shields.io/github/last-commit/bemoje/https://github.com/bemoje/tsmono?color=red)
-![GitHub Stars](https://img.shields.io/github/stars/bemoje/https://github.com/bemoje/tsmono)
-![GitHub Forks](https://img.shields.io/github/forks/bemoje/https://github.com/bemoje/tsmono)
-![GitHub Watchers](https://img.shields.io/github/watchers/bemoje/https://github.com/bemoje/tsmono)
-![GitHub Repo Size](https://img.shields.io/github/repo-size/bemoje/https://github.com/bemoje/tsmono)
+## Building
 
-##### NPM
-<span><a href="https://npmjs.org/@bemoje/array" title="View this project on NPM"><img src="https://img.shields.io/npm/v/@bemoje/array" alt="NPM Version" /></a></span>
-<span><a href="https://npmjs.org/@bemoje/array" title="NPM Downloads"><img src="https://img.shields.io/npm/dt/@bemoje/array" alt="NPM Downloads" /></a></span>
+Run `nx build array` to build the library.
 
-## Documentation
-[array docs](https://bemoje.github.io/tsmono/modules/array.html)
+## Running unit tests
 
-##### Donate
-<span><a href="https://www.patreon.com/user?u=40752770" title="Donate using Patreon"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon Donation" /></a></span>
-
-## Installation
-This library is published in the NPM registry and can be installed using any compatible package manager.
-
-#### NPM
-```sh
-npm install @bemoje/array
-```
-
-
-## Issues
-Please let me know of any bugs or [issues](https://github.com/bemoje/https://github.com/bemoje/tsmono/issues).
-
-## Contribute
-Contributors are welcome to open a [pull request](https://github.com/bemoje/https://github.com/bemoje/tsmono/pulls).
-
-## License
-Released under the [MIT License](./LICENSE).
+Run `nx test array` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -1,13 +1,9 @@
 {
   "name": "@bemoje/array",
-  "version": "0.0.10",
+  "version": "0.2.0",
   "description": "array related tools/util.",
-  "main": "dist/index.cjs.js",
-  "module": "dist/index.esm.js",
-  "types": "dist/types/index.d.ts",
-  "scripts": {
-    "build": "rimraf dist && rollup --config ./rollup.config.js --bundleConfigAsCjs"
-  },
+  "main": "./src/index.js",
+  "scripts": {},
   "author": {
     "name": "Benjamin Møller Jensen",
     "email": "bemoje@bemoje.net",
@@ -19,7 +15,8 @@
     "@bemoje/number": "latest",
     "@bemoje/sort": "latest",
     "@bemoje/string": "latest",
-    "@bemoje/validation": "latest"
+    "@bemoje/validation": "latest",
+    "tslib": "^2.3.0"
   },
   "repository": {
     "type": "git",
@@ -32,5 +29,8 @@
   "bugs": {
     "url": "https://github.com/bemoje/tsmono/issues"
   },
-  "homepage": "https://github.com/bemoje/tsmono"
-}
+  "homepage": "https://github.com/bemoje/tsmono",
+  "type": "commonjs",
+  "typings": "./src/index.d.ts",
+  "types": "./src/index.d.ts"
+}

package/{dist/types → src}/index.d.ts

@@ -27,4 +27,3 @@ export * from './lib/types/ArrayPredicate';
 export * from './lib/types/ArrayValueCallback';
 export * from './lib/types/ArrayVoidCallback';
 export * from './lib/types/NestedArray';
-//# sourceMappingURL=index.d.ts.map

package/src/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/arrAverage"), exports);
+tslib_1.__exportStar(require("./lib/arrEachToString"), exports);
+tslib_1.__exportStar(require("./lib/arrEvery"), exports);
+tslib_1.__exportStar(require("./lib/arrFindIndicesOf"), exports);
+tslib_1.__exportStar(require("./lib/arrFindLast"), exports);
+tslib_1.__exportStar(require("./lib/arrFindLastIndexOf"), exports);
+tslib_1.__exportStar(require("./lib/arrFlatten"), exports);
+tslib_1.__exportStar(require("./lib/arrIndicesOf"), exports);
+tslib_1.__exportStar(require("./lib/arrLast"), exports);
+tslib_1.__exportStar(require("./lib/arrMapMutable"), exports);
+tslib_1.__exportStar(require("./lib/arrObjectsToTable"), exports);
+tslib_1.__exportStar(require("./lib/arrObjectsUniqueKeys"), exports);
+tslib_1.__exportStar(require("./lib/arrRemoveDuplicates"), exports);
+tslib_1.__exportStar(require("./lib/arrShallowEquals"), exports);
+tslib_1.__exportStar(require("./lib/arrShuffle"), exports);
+tslib_1.__exportStar(require("./lib/arrSome"), exports);
+tslib_1.__exportStar(require("./lib/arrSortedInsertionIndex"), exports);
+tslib_1.__exportStar(require("./lib/arrSortNumeric"), exports);
+tslib_1.__exportStar(require("./lib/arrSplit"), exports);
+tslib_1.__exportStar(require("./lib/arrSum"), exports);
+tslib_1.__exportStar(require("./lib/arrSwap"), exports);
+tslib_1.__exportStar(require("./lib/arrTableAssertRowsSameLength"), exports);
+tslib_1.__exportStar(require("./lib/arrTableEachToString"), exports);
+tslib_1.__exportStar(require("./lib/arrTableToCsv"), exports);
+tslib_1.__exportStar(require("./lib/arrTableToObjects"), exports);
+tslib_1.__exportStar(require("./lib/types/ArrayPredicate"), exports);
+tslib_1.__exportStar(require("./lib/types/ArrayValueCallback"), exports);
+tslib_1.__exportStar(require("./lib/types/ArrayVoidCallback"), exports);
+tslib_1.__exportStar(require("./lib/types/NestedArray"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/array/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAgC;AAChC,gEAAqC;AACrC,yDAA8B;AAC9B,iEAAsC;AACtC,4DAAiC;AACjC,mEAAwC;AACxC,2DAAgC;AAChC,6DAAkC;AAClC,wDAA6B;AAC7B,8DAAmC;AACnC,kEAAuC;AACvC,qEAA0C;AAC1C,oEAAyC;AACzC,iEAAsC;AACtC,2DAAgC;AAChC,wDAA6B;AAC7B,wEAA6C;AAC7C,+DAAoC;AACpC,yDAA8B;AAC9B,uDAA4B;AAC5B,wDAA6B;AAC7B,6EAAkD;AAClD,qEAA0C;AAC1C,8DAAmC;AACnC,kEAAuC;AACvC,qEAA0C;AAC1C,yEAA8C;AAC9C,wEAA6C;AAC7C,kEAAuC"}

package/{dist/types → src}/lib/arrAverage.d.ts

@@ -10,4 +10,3 @@
  * ```
  */
 export declare function arrAverage(array: number[]): number;
-//# sourceMappingURL=arrAverage.d.ts.map

package/src/lib/arrAverage.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrAverage = void 0;
+const arrSum_1 = require("./arrSum");
+/**
+ * Calculates the average of an array of numbers.
+ * @returns The average of all numbers in the array.
+ * @throws an error if the input array is empty.
+ * @param array The array of numbers.
+ * @example ```ts
+ * const numbers = [1, 2, 3, 4, 5];
+ * arrAverage(numbers);
+ * //=> 3
+ * ```
+ */
+function arrAverage(array) {
+    if (!array.length)
+        throw new Error('Cannot take an average of zero values.');
+    return (0, arrSum_1.arrSum)(array) / array.length;
+}
+exports.arrAverage = arrAverage;
+//# sourceMappingURL=arrAverage.js.map

package/src/lib/arrAverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrAverage.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrAverage.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAEjC;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAAC,KAAe;IACxC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC5E,OAAO,IAAA,eAAM,EAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;AACrC,CAAC;AAHD,gCAGC"}

package/{dist/types → src}/lib/arrEachToString.d.ts

@@ -10,4 +10,3 @@
  * ```
  */
 export declare function arrEachToString<T>(array: T[]): string[];
-//# sourceMappingURL=arrEachToString.d.ts.map

package/src/lib/arrEachToString.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrEachToString = void 0;
+/**
+ * Coerce each element of an array to string.
+ * @template T - The type of elements in the input array.
+ * @returns A new array where each element is the string representation of the corresponding element in the input array.
+ * @param array The array to iterate over.
+ * @example ```ts
+ * const numbers = [1, 2, 3];
+ * arrEachToString(numbers);
+ * //=> ['1', '2', '3']
+ * ```
+ */
+function arrEachToString(array) {
+    return array.map((element) => '' + element);
+}
+exports.arrEachToString = arrEachToString;
+//# sourceMappingURL=arrEachToString.js.map

package/src/lib/arrEachToString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrEachToString.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrEachToString.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAI,KAAU;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAA;AAC7C,CAAC;AAFD,0CAEC"}

package/{dist/types → src}/lib/arrEvery.d.ts

@@ -15,4 +15,3 @@ import type { ArrayPredicate } from './types/ArrayPredicate';
  * ```
  */
 export declare function arrEvery<T>(input: Array<T>, predicate: ArrayPredicate<T>): boolean;
-//# sourceMappingURL=arrEvery.d.ts.map

package/src/lib/arrEvery.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrEvery = void 0;
+/**
+ * Returns true if the predicate is satisfied for every element of the passed array; otherwise false.
+ * @param input The array
+ * @template T - The type of elements in the array.
+ * @returns Returns `true` if all elements pass the predicate check, else `false`.
+ * @param predicate A predicate callback function
+ * @example ```ts
+ * const numbers = [1, 2, 3, 4, 5];
+ * const isEven = (num) => num % 2 === 0;
+ * arrEvery(numbers, isEven);
+ * //=> false
+ * arrEvery(numbers, (num) => num > 0);
+ * //=> true
+ * ```
+ */
+function arrEvery(input, predicate) {
+    for (let i = 0, len = input.length; i < len; i++) {
+        if (predicate(input[i], i, input) === false) {
+            return false;
+        }
+    }
+    return true;
+}
+exports.arrEvery = arrEvery;
+//# sourceMappingURL=arrEvery.js.map

package/src/lib/arrEvery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrEvery.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrEvery.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACH,SAAgB,QAAQ,CAAI,KAAe,EAAE,SAA4B;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE;QAChD,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,KAAK,EAAE;YAC3C,OAAO,KAAK,CAAA;SACb;KACF;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAPD,4BAOC"}

package/{dist/types → src}/lib/arrFindIndicesOf.d.ts

@@ -5,4 +5,3 @@
  * @returns An array of indices where the predicate function returns true.
  */
 export declare function arrFindIndicesOf<T>(input: Array<T>, predicate: (value: T) => boolean): number[];
-//# sourceMappingURL=arrFindIndicesOf.d.ts.map

package/src/lib/arrFindIndicesOf.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrFindIndicesOf = void 0;
+/**
+ * Returns an array of indices where the predicate function returns true for the corresponding element in the input array.
+ * @param input - The array to search.
+ * @param predicate - The function to test each element of the array.
+ * @returns An array of indices where the predicate function returns true.
+ */
+function arrFindIndicesOf(input, predicate) {
+    const result = [];
+    for (let i = 0; i < input.length; i++) {
+        if (predicate(input[i])) {
+            result.push(i);
+        }
+    }
+    return result;
+}
+exports.arrFindIndicesOf = arrFindIndicesOf;
+//# sourceMappingURL=arrFindIndicesOf.js.map

package/src/lib/arrFindIndicesOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrFindIndicesOf.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrFindIndicesOf.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAI,KAAe,EAAE,SAAgC;IACnF,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACrC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;SACf;KACF;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AARD,4CAQC"}

package/{dist/types → src}/lib/arrFindLast.d.ts

@@ -9,4 +9,3 @@
  * //=> 6
  */
 export declare function arrFindLast<T>(input: Array<T>, predicate: (value: T) => boolean): T | undefined;
-//# sourceMappingURL=arrFindLast.d.ts.map

package/src/lib/arrFindLast.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrFindLast = void 0;
+/**
+ * Searches for the last element in an array that satisfies a provided testing function.
+ * @typeParam T - The type of elements in the input array.
+ * @param input - The array to search within.
+ * @param predicate - The function to test each element for a condition.
+ * @returns The last element in the array that satisfies the provided testing function. Otherwise, undefined if no elements satisfy the testing function.
+ * @example const numbers = [1, 2, 3, 4, 5, 6];
+ * arrFindLast(numbers, num => num % 2 === 0);
+ * //=> 6
+ */
+function arrFindLast(input, predicate) {
+    for (let i = input.length - 1; i >= 0; i--) {
+        if (predicate(input[i]) === true) {
+            return input[i];
+        }
+    }
+}
+exports.arrFindLast = arrFindLast;
+//# sourceMappingURL=arrFindLast.js.map

package/src/lib/arrFindLast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrFindLast.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrFindLast.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAI,KAAe,EAAE,SAAgC;IAC9E,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;YAChC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;SAChB;KACF;AACH,CAAC;AAND,kCAMC"}

package/{dist/types → src}/lib/arrFindLastIndexOf.d.ts

@@ -11,4 +11,3 @@
  * ```
  */
 export declare function arrFindLastIndexOf<T>(input: Array<T>, predicate: (value: T) => boolean): number;
-//# sourceMappingURL=arrFindLastIndexOf.d.ts.map

package/src/lib/arrFindLastIndexOf.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrFindLastIndexOf = void 0;
+/**
+ * Searches for an element in an array in reverse order and returns the index of the last occurrence of the element for which the provided testing function returns true.
+ * If no such element is found, it returns -1.
+ * @param input - The array to search in.
+ * @param predicate - The testing function. Takes a value and returns a boolean.
+ * @returns The index of the last occurrence of the element in the array that passes the test. If no such element is found, it returns -1.
+ * @example ```ts
+ * const arr = [1, 2, 3, 4, 5, 4, 3];
+ * arrFindLastIndexOf(arr, (value) => value === 4);
+ * //=> 5
+ * ```
+ */
+function arrFindLastIndexOf(input, predicate) {
+    for (let i = input.length - 1; i >= 0; i--) {
+        if (predicate(input[i])) {
+            return i;
+        }
+    }
+    return -1;
+}
+exports.arrFindLastIndexOf = arrFindLastIndexOf;
+//# sourceMappingURL=arrFindLastIndexOf.js.map

package/src/lib/arrFindLastIndexOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrFindLastIndexOf.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrFindLastIndexOf.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,SAAgB,kBAAkB,CAAI,KAAe,EAAE,SAAgC;IACrF,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YACvB,OAAO,CAAC,CAAA;SACT;KACF;IACD,OAAO,CAAC,CAAC,CAAA;AACX,CAAC;AAPD,gDAOC"}

package/{dist/types → src}/lib/arrFlatten.d.ts

@@ -14,4 +14,3 @@ import type { NestedArray } from './types/NestedArray';
  * ```
  */
 export declare function arrFlatten<T>(input: NestedArray<T>, maxDepth?: number): Array<T>;
-//# sourceMappingURL=arrFlatten.d.ts.map

package/src/lib/arrFlatten.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrFlatten = void 0;
+/**
+ * Flattens the passed array recursively to a specified depth. Immutable.
+ * @param input the array to flatten
+ * @template T - The type of the elements in the input array.
+ * @param - The maximum depth to flatten. Defaults to the maximum safe integer.
+ * @returns The flattened array.
+ * @throws If the input is not an array.
+ * @param maxDepth the maximum recursive flattening depth.
+ * @example ```ts
+ * const nestedArray = [[1, 2], [3, [4, 5]], [6]];
+ * arrFlatten(nestedArray, 1);
+ * //=> [1, 2, 3, [4, 5], 6]
+ * ```
+ */
+function arrFlatten(input, maxDepth = Number.MAX_SAFE_INTEGER) {
+    const accum = [];
+    function recurse(arr, depth) {
+        for (let i = 0; i < arr.length; i++) {
+            if (Array.isArray(arr[i]) && depth < maxDepth) {
+                recurse(arr[i], depth + 1);
+            }
+            else {
+                accum.push(arr[i]);
+            }
+        }
+    }
+    recurse(input, 0);
+    return accum;
+}
+exports.arrFlatten = arrFlatten;
+//# sourceMappingURL=arrFlatten.js.map

package/src/lib/arrFlatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrFlatten.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrFlatten.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CAAI,KAAqB,EAAE,QAAQ,GAAG,MAAM,CAAC,gBAAgB;IACrF,MAAM,KAAK,GAAQ,EAAE,CAAA;IACrB,SAAS,OAAO,CAAC,GAAmB,EAAE,KAAa;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,QAAQ,EAAE;gBAC7C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;aAClC;iBAAM;gBACL,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,CAAC,CAAA;aACxB;SACF;IACH,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACjB,OAAO,KAAK,CAAA;AACd,CAAC;AAbD,gCAaC"}

package/{dist/types → src}/lib/arrIndicesOf.d.ts

@@ -12,4 +12,3 @@
  *  ```
  */
 export declare function arrIndicesOf<T>(input: Array<T>, element: T): number[];
-//# sourceMappingURL=arrIndicesOf.d.ts.map

package/src/lib/arrIndicesOf.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrIndicesOf = void 0;
+/**
+ * Returns all indexes at which an element is found.
+ * @param input The array to search
+ * @template T - The type of elements in the input array.
+ * @returns An array of indices where the specified element can be found.
+ * @param element The element to find
+ * @example ```ts
+ *  const inputArray = [1, 2, 3, 2, 4, 2, 5];
+ *  const elementToFind = 2;
+ *  arrIndicesOf(inputArray, elementToFind);
+ *  //=> [1, 3, 5]
+ *  ```
+ */
+function arrIndicesOf(input, element) {
+    const result = [];
+    for (let i = 0; i < input.length; i++) {
+        if (element === input[i]) {
+            result.push(i);
+        }
+    }
+    return result;
+}
+exports.arrIndicesOf = arrIndicesOf;
+//# sourceMappingURL=arrIndicesOf.js.map

package/src/lib/arrIndicesOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrIndicesOf.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrIndicesOf.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAAI,KAAe,EAAE,OAAU;IACzD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACrC,IAAI,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE;YACxB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;SACf;KACF;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AARD,oCAQC"}

package/{dist/types → src}/lib/arrLast.d.ts

@@ -10,4 +10,3 @@
  * //=> 5
  */
 export declare function arrLast<T>(array: T[]): T;
-//# sourceMappingURL=arrLast.d.ts.map

package/src/lib/arrLast.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrLast = void 0;
+/**
+ * Returns the last element of an array.
+ * Throws an error if the array is empty.
+ * @template T The type of elements in the array.
+ * @param array The array to get the last element from.
+ * @returns The last element of the array.
+ * @throws If the array is empty.
+ * @example const numbers = [1, 2, 3, 4, 5];
+ * const lastNumber = arrLast(numbers);
+ * //=> 5
+ */
+function arrLast(array) {
+    if (!array.length)
+        throw new Error('Cannot get last element of empty array.');
+    return array[array.length - 1];
+}
+exports.arrLast = arrLast;
+//# sourceMappingURL=arrLast.js.map

package/src/lib/arrLast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrLast.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrLast.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,OAAO,CAAI,KAAU;IACnC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC7E,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC;AAHD,0BAGC"}

package/{dist/types → src}/lib/arrMapMutable.d.ts

@@ -11,4 +11,3 @@ import type { ArrayValueCallback } from './types/ArrayValueCallback';
  * ```
  */
 export declare function arrMapMutable<T>(input: Array<T>, f: ArrayValueCallback<T>): Array<T>;
-//# sourceMappingURL=arrMapMutable.d.ts.map

package/src/lib/arrMapMutable.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrMapMutable = void 0;
+/**
+ * This function takes an array and a callback function as arguments. It applies the callback function to each element of the array, mutating the original array in the process.
+ * @template T The type of elements in the input array.
+ * @param input The array to be mapped over.
+ * @param f The callback function to be applied to each element of the array. This function takes three arguments: the current element, its index, and the original array.
+ * @returns The original array, mutated by the callback function.
+ * @example ```ts
+ * arrMapMutable([1, 2, 3], (value: number) => value * 2);;
+ * //=> [2, 4, 6]
+ * ```
+ */
+function arrMapMutable(input, f) {
+    for (let i = 0; i < input.length; i++) {
+        input[i] = f(input[i], i, input);
+    }
+    return input;
+}
+exports.arrMapMutable = arrMapMutable;
+//# sourceMappingURL=arrMapMutable.js.map

package/src/lib/arrMapMutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrMapMutable.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrMapMutable.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAAI,KAAe,EAAE,CAAwB;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACrC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;KACjC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AALD,sCAKC"}

package/{dist/types → src}/lib/arrObjectsToTable.d.ts

@@ -20,4 +20,3 @@ export declare function arrObjectsToTable<T, E>(objects: Record<string, T | unde
     headers?: string[];
     emptyCell?: E;
 }): Array<Array<string | T | E>>;
-//# sourceMappingURL=arrObjectsToTable.d.ts.map

package/src/lib/arrObjectsToTable.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrObjectsToTable = void 0;
+const arrObjectsUniqueKeys_1 = require("./arrObjectsUniqueKeys");
+/**
+ * Convert an array of objects to a two-dimensional table.
+ * @param objects The array of objects to convert to a table.
+ * @template T - The type of the values in the objects.
+ * @param options.headers An optional array of strings specifying the headers (property names) to use. If not provided, the function will use all unique keys found in the objects.
+ * @param options.emptyCell An optional value to use for empty cells. If not provided, the function will use `undefined`.
+ * @returns A 2D array (table) where each row represents an object and each column represents a property of the object.
+ * @param options The options for converting the objects to a table.
+ * @example ```ts
+ * arrObjectsToTable(
+ *   [
+ *     { a: 1, b: 2 },
+ *     { a: 3, b: 4, c: 5 },
+ *   ],
+ *   { emptyCell:1 },
+ * ) //=> [ [ 'a', 'b', 'c' ], [ 1, 2,1 ], [ 3, 4, 5 ] ]
+ * ```
+ */
+function arrObjectsToTable(objects, options = {}) {
+    var _a;
+    const headers = ((_a = options === null || options === void 0 ? void 0 : options.headers) === null || _a === void 0 ? void 0 : _a.slice()) || (0, arrObjectsUniqueKeys_1.arrObjectsUniqueKeys)(objects);
+    const table = [headers];
+    for (const o of objects) {
+        const row = headers.map((header) => {
+            const value = o[header];
+            return value !== undefined ? value : options.emptyCell;
+        });
+        table.push(row);
+    }
+    return table;
+}
+exports.arrObjectsToTable = arrObjectsToTable;
+//# sourceMappingURL=arrObjectsToTable.js.map

package/src/lib/arrObjectsToTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrObjectsToTable.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrObjectsToTable.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,iBAAiB,CAC/B,OAAwC,EACxC,UAGI,EAAE;;IAEN,MAAM,OAAO,GAAG,CAAA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,0CAAE,KAAK,EAAE,KAAI,IAAA,2CAAoB,EAAC,OAAO,CAAC,CAAA;IAC1E,MAAM,KAAK,GAAiC,CAAC,OAAO,CAAC,CAAA;IACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;YACvB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,OAAO,CAAC,SAAe,CAAA;QAC/D,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;KAChB;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAjBD,8CAiBC"}

package/{dist/types → src}/lib/arrObjectsUniqueKeys.d.ts

@@ -14,4 +14,3 @@
  * ```
  */
 export declare function arrObjectsUniqueKeys<T>(objects: Record<string, T>[]): string[];
-//# sourceMappingURL=arrObjectsUniqueKeys.d.ts.map

package/src/lib/arrObjectsUniqueKeys.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrObjectsUniqueKeys = void 0;
+/**
+ * Returns an array of all unique object keys found in an array of objects.
+ * @template T - The type of values in the input objects.
+ * @returns An array of unique keys present in the input objects.
+ * @param objects The array of objects.
+ * @example ```ts
+ * const objects = [
+ *   { name: 'John', age: 25 },
+ *   { name: 'Jane', gender: 'female' },
+ *   { name: 'Bob', age: 30, gender: 'male' },
+ * ];
+ * arrObjectsUniqueKeys(objects);
+ * //=> ['name', 'age', 'gender']
+ * ```
+ */
+function arrObjectsUniqueKeys(objects) {
+    const keys = new Set();
+    for (const o of objects) {
+        for (const key of Object.keys(o)) {
+            keys.add(key);
+        }
+    }
+    return Array.from(keys);
+}
+exports.arrObjectsUniqueKeys = arrObjectsUniqueKeys;
+//# sourceMappingURL=arrObjectsUniqueKeys.js.map

package/src/lib/arrObjectsUniqueKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrObjectsUniqueKeys.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrObjectsUniqueKeys.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACH,SAAgB,oBAAoB,CAAI,OAA4B;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;QACvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;SACd;KACF;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AARD,oDAQC"}

package/{dist/types → src}/lib/arrRemoveDuplicates.d.ts

@@ -11,4 +11,3 @@
  * ```
  */
 export declare function arrRemoveDuplicates<T>(array: T[]): T[];
-//# sourceMappingURL=arrRemoveDuplicates.d.ts.map

package/src/lib/arrRemoveDuplicates.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrRemoveDuplicates = void 0;
+/**
+ * Remove duplicates from an array
+ * @remarks This function uses the JavaScript Set object to remove duplicate values from an array.
+ * @typeparam T - The type of elements in the array.
+ * @returns The new array with duplicates removed.
+ * @param array The array from which to remove duplicates.
+ * @example ```ts
+ * const array = [1, 2, 2, 3, 4, 4, 5];
+ * arrRemoveDuplicates(array);
+ * //=> [1, 2, 3, 4, 5]
+ * ```
+ */
+function arrRemoveDuplicates(array) {
+    return Array.from(new Set(array));
+}
+exports.arrRemoveDuplicates = arrRemoveDuplicates;
+//# sourceMappingURL=arrRemoveDuplicates.js.map

package/src/lib/arrRemoveDuplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrRemoveDuplicates.js","sourceRoot":"","sources":["../../../../../packages/array/src/lib/arrRemoveDuplicates.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,SAAgB,mBAAmB,CAAI,KAAU;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;AACnC,CAAC;AAFD,kDAEC"}

package/{dist/types → src}/lib/arrShallowEquals.d.ts

@@ -13,4 +13,3 @@
  * ```
  */
 export declare function arrShallowEquals<T>(input1: T[], input2: T[]): boolean;
-//# sourceMappingURL=arrShallowEquals.d.ts.map