@dereekb/util 0.0.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
+
+# 1.0.0 (2022-02-23)
+
+
+### Features
+
+* added dbxList ([83ddb00](https://github.com/dereekb/dbcomponents/commit/83ddb006548602640ec312594b9bb9f26f3417de))
+* added dbxSearchableTextFieldComponent ([42ae14c](https://github.com/dereekb/dbcomponents/commit/42ae14c7709f6603db676c94f1df2017fdad59ca))
+* added dbxStyleBody ([5b624ae](https://github.com/dereekb/dbcomponents/commit/5b624ae0c77ea935fe874dcb977eb22dd17cd60c))
+* added makeBestFit() ([b0cf900](https://github.com/dereekb/dbcomponents/commit/b0cf900247ab0490fcb35f845cefecc82e45332b))
+* added treeNode ([1aa120f](https://github.com/dereekb/dbcomponents/commit/1aa120f7f8c83ccc46d440b77fbd234dec564aea))
+* segment analytics ([b81d5a6](https://github.com/dereekb/dbcomponents/commit/b81d5a6a70ecf3bc35852d441cfd79e91e5dcb51))
+
+
+
+# 0.1.0 (2022-01-29)

package/README.md

@@ -1,7 +1,6 @@
-# util
+@dereekb/util
+=======
 
-This library was generated with [Nx](https://nx.dev).
+The sources for this package are in the main [@dereekb/dbcomponents](https://github.com/dereekb/dbcomponents) repo. Please file issues and pull requests against that repo.
 
-## Running unit tests
-
-Run `nx test util` to execute the unit tests via [Jest](https://jestjs.io).
+License: MIT

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@dereekb/util",
-  "version": "0.0.1",
+  "version": "1.0.0",
+  "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "dependencies": {

package/src/lib/array/array.d.ts

@@ -30,7 +30,21 @@ export declare function concatArrays<T>(...arrays: (Maybe<T[]>)[]): T[];
 export declare function flattenArray<T>(array: T[][]): T[];
 export declare function copyArray<T>(input: Maybe<T[]>): T[];
 export declare function pushElementOntoArray<T>(target: T[], element: T, times: number): T[];
-export declare function mergeIntoArray<T>(target: Maybe<T[]>, ...arrays: T[][]): T[];
+/**
+ * Merges all input arrays into a single array.
+ *
+ * @param arrays
+ * @returns
+ */
+export declare function mergeArrays<T>(arrays: Maybe<T[]>[]): T[];
+/**
+ * Merges the input arrays into the target.
+ *
+ * @param target
+ * @param arrays
+ * @returns
+ */
+export declare function mergeIntoArray<T>(target: Maybe<T[]>, ...arrays: Maybe<T[]>[]): T[];
 export declare function mergeArrayOrValueIntoArray<T>(target: T[], value: ArrayOrValue<T>): T[];
 /**
  * Merges all the values from the second array into the first using push.
@@ -58,3 +72,9 @@ export declare function takeFront<T>(values: T[], maxToTake: number): T[];
  * @returns New array with the subset of taken values.
  */
 export declare function takeLast<T>(values: T[], maxToTake: number, keepFromFront?: number): T[];
+/**
+ * Picks an item randomly from the input array. If the array is empty, returns undefined.
+ *
+ * @param values
+ */
+export declare function pickOneRandomly<T>(values: T[]): T;

package/src/lib/array/array.filter.d.ts

@@ -11,3 +11,23 @@ export declare function filterValuesByDistance<T>(input: T[], minDistance: numbe
  * we are only interested in seeing one of those items.
  */
 export declare function filterValuesByDistanceNoOrder<T>(input: T[], minDistance: number, getValue: (value: T) => number | null): T[];
+/**
+ * Same as applyBestFit, but returns a new array, rather than modifying the existing array.
+ *
+ * @param input
+ * @param filter
+ * @param updateNonBestFit
+ */
+export declare function makeBestFit<T>(input: T[], filter: (value: T) => boolean, compare: (a: T, b: T) => number, updateNonBestFit: (value: T) => T): T[];
+/**
+ * Used for updating an array so that a single element becomes the "best fit" in whatever context is provided.
+ *
+ * For instance, if two items are selected but only one can be selected by design, this function can be used to
+ * pick the best fit, and update the input array.
+ *
+ * @param input
+ * @param filter
+ * @param updateNonBestFit
+ * @returns
+ */
+export declare function applyBestFit<T>(input: T[], filter: (value: T) => boolean, compare: (a: T, b: T) => number, updateNonBestFit: (value: T) => T): T[];

package/src/lib/array/array.filter.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterValuesByDistanceNoOrder = exports.filterValuesByDistance = void 0;
+exports.applyBestFit = exports.makeBestFit = exports.filterValuesByDistanceNoOrder = exports.filterValuesByDistance = void 0;
+const array_1 = require("./array");
+const array_index_1 = require("./array.index");
 /**
  * Filters the input values by distance. The original order is retained.
  *
@@ -45,4 +47,40 @@ function _filterValuesByDistance(values, minDistance, toOutputValue) {
     }
     return filtered;
 }
+/**
+ * Same as applyBestFit, but returns a new array, rather than modifying the existing array.
+ *
+ * @param input
+ * @param filter
+ * @param updateNonBestFit
+ */
+function makeBestFit(input, filter, compare, updateNonBestFit) {
+    return applyBestFit((0, array_1.copyArray)(input), filter, compare, updateNonBestFit);
+}
+exports.makeBestFit = makeBestFit;
+/**
+ * Used for updating an array so that a single element becomes the "best fit" in whatever context is provided.
+ *
+ * For instance, if two items are selected but only one can be selected by design, this function can be used to
+ * pick the best fit, and update the input array.
+ *
+ * @param input
+ * @param filter
+ * @param updateNonBestFit
+ * @returns
+ */
+function applyBestFit(input, filter, compare, updateNonBestFit) {
+    const matchIndexSet = (0, array_index_1.findToIndexSet)(input, filter);
+    if (matchIndexSet.length > 1) {
+        const expansion = (0, array_index_1.expandIndexSet)(input, matchIndexSet);
+        const bestPair = (0, array_index_1.findBestIndexSetPair)(expansion, compare);
+        expansion.forEach(({ i, item }) => {
+            if (i !== bestPair.i) {
+                input[i] = updateNonBestFit(item); // Update value on input.
+            }
+        });
+    }
+    return input;
+}
+exports.applyBestFit = applyBestFit;
 //# sourceMappingURL=array.filter.js.map

package/src/lib/array/array.filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.filter.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,SAAgB,sBAAsB,CAAI,KAAU,EAAE,WAAmB,EAAE,QAAqC;IAE9G,6BAA6B;IAE7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;AAChD,CAAC;AALD,wDAKC;AAED;;;;;GAKG;AACH,SAAgB,6BAA6B,CAAI,KAAU,EAAE,WAAmB,EAAE,QAAqC;IACrH,MAAM,MAAM,GAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxG,OAAO,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAHD,sEAGC;AAED,oGAAoG;AAEpG,SAAS,uBAAuB,CAAO,MAAqB,EAAE,WAAmB,EAAE,aAAwC;IAEzH,yBAAyB;IACzB,QAAQ,MAAM,CAAC,MAAM,EAAE;QACrB,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC;YACJ,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACrC;IAED,cAAc;IACd,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAErB,MAAM,QAAQ,GAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhD,IAAI,QAAQ,GAAG,WAAW,EAAE;YAC1B,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,IAAI,GAAG,OAAO,CAAC;SAChB;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"array.filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.filter.ts"],"names":[],"mappings":"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"}

package/src/lib/array/array.index.d.ts

@@ -0,0 +1,36 @@
+import { Maybe } from "../value";
+/**
+ * A set of number corresponding to items in an array.
+ *
+ * This is useful for cases where you need the items in their index in the array.
+ */
+export declare type IndexSet = number[];
+export declare type IndexSetPairSet<T> = IndexSetPair<T>[];
+export interface IndexSetPair<T> {
+    i: number;
+    item: Maybe<T>;
+}
+/**
+ * Runs a filter on an array and returns an IndexSet for values that match.
+ *
+ * @param input
+ * @param filter
+ * @returns
+ */
+export declare function findToIndexSet<T>(input: T[], filter: (value: T) => boolean): IndexSet;
+export declare function expandIndexSet<T>(input: T[], indexSet: IndexSet): IndexSetPairSet<T>;
+/**
+ * Finds the best item in the input array using the compare function, and returns an IndexSetPair value.
+ *
+ * @param input
+ * @param compare
+ */
+export declare function findBest<T>(input: T[], compare: (a: T, b: T) => number): IndexSetPair<T>;
+/**
+ * Finds the best item in the input IndexSetPairSet, and returns it.
+ *
+ * @param input
+ * @param compare
+ * @returns
+ */
+export declare function findBestIndexSetPair<T>(input: IndexSetPairSet<T>, compare: (a: T, b: T) => number): IndexSetPair<T>;

package/src/lib/array/array.index.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBestIndexSetPair = exports.findBest = exports.expandIndexSet = exports.findToIndexSet = void 0;
+/**
+ * Runs a filter on an array and returns an IndexSet for values that match.
+ *
+ * @param input
+ * @param filter
+ * @returns
+ */
+function findToIndexSet(input, filter) {
+    let filterIndexes = [];
+    input.forEach((x, i) => {
+        if (filter(x)) {
+            filterIndexes.push(i);
+        }
+    });
+    return filterIndexes;
+}
+exports.findToIndexSet = findToIndexSet;
+function expandIndexSet(input, indexSet) {
+    return indexSet.map(i => ({ i, item: input[i] }));
+}
+exports.expandIndexSet = expandIndexSet;
+/**
+ * Finds the best item in the input array using the compare function, and returns an IndexSetPair value.
+ *
+ * @param input
+ * @param compare
+ */
+function findBest(input, compare) {
+    let bestIndex = 0;
+    let best = input[0];
+    for (let i = 1; i < input.length; i += 1) {
+        const next = input[i];
+        if (next != null && compare(best, next) < 0) {
+            bestIndex = i;
+            best = next;
+        }
+    }
+    return {
+        i: bestIndex,
+        item: best
+    };
+}
+exports.findBest = findBest;
+/**
+ * Finds the best item in the input IndexSetPairSet, and returns it.
+ *
+ * @param input
+ * @param compare
+ * @returns
+ */
+function findBestIndexSetPair(input, compare) {
+    let best = input[0];
+    for (let i = 1; i < input.length; i += 1) {
+        const next = input[i];
+        if (best.item == null || (next.item != null && compare(best.item, next.item) < 0)) {
+            best = next;
+        }
+    }
+    return best;
+}
+exports.findBestIndexSetPair = findBestIndexSetPair;
+//# sourceMappingURL=array.index.js.map

package/src/lib/array/array.index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.index.ts"],"names":[],"mappings":";;;AAgBA;;;;;;GAMG;AACH,SAAgB,cAAc,CAAI,KAAU,EAAE,MAA6B;IACzE,IAAI,aAAa,GAAa,EAAE,CAAC;IAEjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE;YACb,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACvB;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,aAAa,CAAC;AACvB,CAAC;AAVD,wCAUC;AAGD,SAAgB,cAAc,CAAI,KAAU,EAAE,QAAkB;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC;AAFD,wCAEC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,KAAU,EAAE,OAA+B;IACrE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;YAC3C,SAAS,GAAG,CAAC,CAAC;YACd,IAAI,GAAG,IAAI,CAAC;SACb;KACF;IAED,OAAO;QACL,CAAC,EAAE,SAAS;QACZ,IAAI,EAAE,IAAI;KACX,CAAC;AACJ,CAAC;AAjBD,4BAiBC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAI,KAAyB,EAAE,OAA+B;IAChG,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;YACjF,IAAI,GAAG,IAAI,CAAC;SACb;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAZD,oDAYC"}

package/src/lib/array/array.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.takeLast = exports.takeFront = exports.mergeArrayIntoArray = exports.mergeArrayOrValueIntoArray = exports.mergeIntoArray = exports.pushElementOntoArray = exports.copyArray = exports.flattenArray = exports.concatArrays = exports.valueAtIndex = exports.lastValue = exports.firstValue = exports.convertToArray = exports.convertMaybeToArray = void 0;
+exports.pickOneRandomly = exports.takeLast = exports.takeFront = exports.mergeArrayIntoArray = exports.mergeArrayOrValueIntoArray = exports.mergeIntoArray = exports.mergeArrays = exports.pushElementOntoArray = exports.copyArray = exports.flattenArray = exports.concatArrays = exports.valueAtIndex = exports.lastValue = exports.firstValue = exports.convertToArray = exports.convertMaybeToArray = void 0;
 // MARK: Functions
 /**
  * Converts the input value to an array containing itself, or returns itself if it is an array.
@@ -77,12 +77,31 @@ function pushElementOntoArray(target, element, times) {
     return target;
 }
 exports.pushElementOntoArray = pushElementOntoArray;
+/**
+ * Merges all input arrays into a single array.
+ *
+ * @param arrays
+ * @returns
+ */
+function mergeArrays(arrays) {
+    return mergeIntoArray([], ...arrays);
+}
+exports.mergeArrays = mergeArrays;
+/**
+ * Merges the input arrays into the target.
+ *
+ * @param target
+ * @param arrays
+ * @returns
+ */
 function mergeIntoArray(target, ...arrays) {
     if (target == null) {
         target = [];
     }
     arrays.forEach((array) => {
-        mergeArrayIntoArray(target, array);
+        if (array != null) {
+            mergeArrayIntoArray(target, array);
+        }
     });
     return target;
 }
@@ -146,4 +165,15 @@ function takeLast(values, maxToTake, keepFromFront = 0) {
     return results;
 }
 exports.takeLast = takeLast;
+/**
+ * Picks an item randomly from the input array. If the array is empty, returns undefined.
+ *
+ * @param values
+ */
+function pickOneRandomly(values) {
+    const random = Math.random();
+    const index = Math.round(random * (values.length - 1));
+    return values[index];
+}
+exports.pickOneRandomly = pickOneRandomly;
 //# sourceMappingURL=array.js.map

package/src/lib/array/array.js.map

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

package/src/lib/array/array.make.d.ts

@@ -0,0 +1,22 @@
+import { MakeRandomFunctionInput, RandomNumberFunction } from "../number";
+export interface MakeArray<T> {
+    count: number;
+    make: (i: number) => T;
+}
+/**
+ * Makes an array of values of a certain length using a generator function.
+ *
+ * @param param0
+ * @returns
+ */
+export declare function makeArray<T>({ count, make }: MakeArray<T>): T[];
+export interface MakeArrayRandom<T> extends Omit<MakeArray<T>, 'count'> {
+    random: RandomNumberFunction | MakeRandomFunctionInput;
+}
+/**
+ * Makes a function that generates arrays of a random length of a specific type.
+ *
+ * @param config
+ * @returns
+ */
+export declare function makeRandomArrayFn<T>(config: MakeArrayRandom<T>): () => T[];

package/src/lib/array/array.make.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRandomArrayFn = exports.makeArray = void 0;
+const number_1 = require("../number");
+/**
+ * Makes an array of values of a certain length using a generator function.
+ *
+ * @param param0
+ * @returns
+ */
+function makeArray({ count, make }) {
+    let array = [];
+    for (let i = 0; i < count; i += 1) {
+        array.push(make(i));
+    }
+    return array;
+}
+exports.makeArray = makeArray;
+/**
+ * Makes a function that generates arrays of a random length of a specific type.
+ *
+ * @param config
+ * @returns
+ */
+function makeRandomArrayFn(config) {
+    const randomFn = (typeof config.random === 'function') ? config.random : (0, number_1.makeRandomFunction)(config.random);
+    return () => makeArray({ count: Math.abs(randomFn()), make: config.make });
+}
+exports.makeRandomArrayFn = makeRandomArrayFn;
+//# sourceMappingURL=array.make.js.map

package/src/lib/array/array.make.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.make.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.make.ts"],"names":[],"mappings":";;;AAAA,sCAA8F;AAO9F;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,EAAE,KAAK,EAAE,IAAI,EAAgB;IACxD,IAAI,KAAK,GAAQ,EAAE,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;QACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;KACrB;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AARD,8BAQC;AAMD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAI,MAA0B;IAC7D,MAAM,QAAQ,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,2BAAkB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3G,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC;AAHD,8CAGC"}

package/src/lib/array/array.number.d.ts

@@ -15,7 +15,7 @@ export declare function reduceNumbersFn<D extends number>(reduceFn: ((a: number,
  * @param param0
  * @returns
  */
-export declare function range({ start, end }: {
+export declare function range(input: number | {
     start?: number;
     end: number;
 }): number[];

package/src/lib/array/array.number.js

@@ -47,8 +47,19 @@ exports.reduceNumbersFn = reduceNumbersFn;
  * @param param0
  * @returns
  */
-function range({ start = 0, end }) {
+function range(input) {
+    var _a;
     const range = [];
+    let start;
+    let end;
+    if (typeof input === 'number') {
+        start = 0;
+        end = input;
+    }
+    else {
+        start = (_a = input.start) !== null && _a !== void 0 ? _a : 0;
+        end = input.end;
+    }
     for (let i = start; i < end; i += 1) {
         range.push(i);
     }

package/src/lib/array/array.number.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.number.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.number.ts"],"names":[],"mappings":";;;AACA,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAwB;IAC5E,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAwB;IAC7D,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAwB;IAC5E,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAwB;IAC7D,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAe,GAAG,CAAC;IACvE,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAe,GAAG,CAAC;IACxD,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAFD,wDAEC;AAED,SAAgB,aAAa,CAAC,QAA4C,EAAE,KAAe,EAAE,eAAwB;IACnH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,OAAO,eAAe,CAAC;KACxB;SAAM;QACL,OAAO,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;KAC1D;AACH,CAAC;AAND,sCAMC;AAID,SAAgB,eAAe,CAAmB,QAA4C,EAAE,eAAmB;IACjH,MAAM,GAAG,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxD,OAAO,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;AAC5E,CAAC;AAHD,0CAGC;AAED;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAmC;IACvE,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;QACnC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACf;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AARD,sBAQC"}
+{"version":3,"file":"array.number.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.number.ts"],"names":[],"mappings":";;;AACA,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAwB;IAC5E,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAwB;IAC7D,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAwB;IAC5E,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAwB;IAC7D,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED,SAAgB,oBAAoB,CAAC,KAAe,EAAE,eAAe,GAAG,CAAC;IACvE,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,sBAAsB,CAAC,eAAe,GAAG,CAAC;IACxD,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAFD,wDAEC;AAED,SAAgB,aAAa,CAAC,QAA4C,EAAE,KAAe,EAAE,eAAwB;IACnH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,OAAO,eAAe,CAAC;KACxB;SAAM;QACL,OAAO,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;KAC1D;AACH,CAAC;AAND,sCAMC;AAID,SAAgB,eAAe,CAAmB,QAA4C,EAAE,eAAmB;IACjH,MAAM,GAAG,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxD,OAAO,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;AAC5E,CAAC;AAHD,0CAGC;AAED;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAC,KAA+C;;IACnE,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,IAAI,KAAa,CAAC;IAClB,IAAI,GAAW,CAAC;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,KAAK,GAAG,CAAC,CAAC;QACV,GAAG,GAAG,KAAK,CAAC;KACb;SAAM;QACL,KAAK,GAAG,MAAA,KAAK,CAAC,KAAK,mCAAI,CAAC,CAAC;QACzB,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;KACjB;IAED,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;QACnC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACf;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAnBD,sBAmBC"}

package/src/lib/array/index.d.ts

@@ -1,6 +1,8 @@
 export * from './array.boolean';
 export * from './array.filter';
+export * from './array.index';
 export * from './array.limit';
+export * from './array.make';
 export * from './array.map';
 export * from './array.number';
 export * from './array.set';

package/src/lib/array/index.js

@@ -3,7 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 (0, tslib_1.__exportStar)(require("./array.boolean"), exports);
 (0, tslib_1.__exportStar)(require("./array.filter"), exports);
+(0, tslib_1.__exportStar)(require("./array.index"), exports);
 (0, tslib_1.__exportStar)(require("./array.limit"), exports);
+(0, tslib_1.__exportStar)(require("./array.make"), exports);
 (0, tslib_1.__exportStar)(require("./array.map"), exports);
 (0, tslib_1.__exportStar)(require("./array.number"), exports);
 (0, tslib_1.__exportStar)(require("./array.set"), exports);

package/src/lib/array/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgC;AAChC,8DAA+B;AAC/B,6DAA8B;AAC9B,2DAA4B;AAC5B,8DAA+B;AAC/B,2DAA4B;AAC5B,8DAA+B;AAC/B,uDAAwB;AACxB,8DAA+B;AAC/B,6DAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgC;AAChC,8DAA+B;AAC/B,6DAA8B;AAC9B,6DAA8B;AAC9B,4DAA6B;AAC7B,2DAA4B;AAC5B,8DAA+B;AAC/B,2DAA4B;AAC5B,8DAA+B;AAC/B,uDAAwB;AACxB,8DAA+B;AAC/B,6DAA8B"}

package/src/lib/assertion/assertion.js

@@ -11,7 +11,7 @@ class PropertyDescriptorUtility {
             return function (value) {
                 if (assertValueFn(value)) {
                     const mappedValue = map(value);
-                    setValue.call(this, mappedValue); // TODO: "this" may not be necessary here, if setValue is expected to always be an arrow function.
+                    setValue.call(this, mappedValue);
                 }
                 else {
                     const error = { target, propertyKey, options };

package/src/lib/assertion/assertion.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertion.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assertion.ts"],"names":[],"mappings":";;;AACA,iDAAmE;AAqBnE,MAAa,yBAAyB;IAEpC,MAAM,CAAC,+BAA+B,CAAI,aAAwC,EAAE,OAA0C,EAAE,cAAiD;QAE/K,gBAAgB;QAChB,OAAO,mCACF,cAAc,GACd,OAAO,CACX,CAAC;QAEF,OAAO,IAAI,CAAC,oCAAoC,CAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;YACxF,MAAM,GAAG,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,KAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvC,OAAO,UAAqB,KAAQ;gBAClC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE;oBACxB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,kGAAkG;iBACrI;qBAAM;oBACL,MAAM,KAAK,GAAmB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;oBAC/D,gCAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBACjC;YACH,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,oCAAoC,CAAI,yBAAgE;QAC7G,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,WAAmB,EAAE,UAAsC,EAAE,EAAE;YAClG,IAAI,UAAU,CAAC,GAAG,EAAE;gBAClB,MAAM,QAAQ,GAA2B,UAAU,CAAC,GAAG,CAAC;gBAExD,wCAAwC;gBACxC,UAAU,CAAC,GAAG,GAAG,yBAAyB,CAAC;oBACzC,MAAM;oBACN,WAAW;oBACX,UAAU;oBACV,QAAQ;iBACT,CAAC,CAAC;aACJ;QACH,CAAC,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;CAEF;AA1CD,8DA0CC"}
+{"version":3,"file":"assertion.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assertion.ts"],"names":[],"mappings":";;;AACA,iDAAmE;AAqBnE,MAAa,yBAAyB;IAEpC,MAAM,CAAC,+BAA+B,CAAI,aAAwC,EAAE,OAA0C,EAAE,cAAiD;QAE/K,gBAAgB;QAChB,OAAO,mCACF,cAAc,GACd,OAAO,CACX,CAAC;QAEF,OAAO,IAAI,CAAC,oCAAoC,CAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;YACxF,MAAM,GAAG,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,KAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvC,OAAO,UAAqB,KAAQ;gBAClC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE;oBACxB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;iBAClC;qBAAM;oBACL,MAAM,KAAK,GAAmB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;oBAC/D,gCAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBACjC;YACH,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,oCAAoC,CAAI,yBAAgE;QAC7G,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,WAAmB,EAAE,UAAsC,EAAE,EAAE;YAClG,IAAI,UAAU,CAAC,GAAG,EAAE;gBAClB,MAAM,QAAQ,GAA2B,UAAU,CAAC,GAAG,CAAC;gBAExD,wCAAwC;gBACxC,UAAU,CAAC,GAAG,GAAG,yBAAyB,CAAC;oBACzC,MAAM;oBACN,WAAW;oBACX,UAAU;oBACV,QAAQ;iBACT,CAAC,CAAC;aACJ;QACH,CAAC,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;CAEF;AA1CD,8DA0CC"}

package/src/lib/date/date.d.ts

@@ -43,6 +43,7 @@ export declare type UnixDateTimeNumber = number;
  * A date or a unix timestamp
  */
 export declare type DateOrUnixDateTimeNumber = Date | UnixDateTimeNumber;
+export declare type Milliseconds = number;
 export declare type Seconds = number;
 export declare type Minutes = number;
 export declare type Hours = number;

package/src/lib/date/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/date/date.ts"],"names":[],"mappings":";;;AAmBa,QAAA,mBAAmB,GAAG,KAAK,CAAC;AAazC,SAAgB,6BAA6B,CAAC,QAA+B;IAC3E,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,2BAAmB,CAAC,CAAC;AAChE,CAAC;AAFD,sEAEC;AA6BY,QAAA,cAAc,GAAG,IAAI,CAAC;AACtB,QAAA,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;AACzB,QAAA,UAAU,GAAG,oBAAY,GAAG,EAAE,CAAC"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/date/date.ts"],"names":[],"mappings":";;;AAmBa,QAAA,mBAAmB,GAAG,KAAK,CAAC;AAazC,SAAgB,6BAA6B,CAAC,QAA+B;IAC3E,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,2BAAmB,CAAC,CAAC;AAChE,CAAC;AAFD,sEAEC;AA8BY,QAAA,cAAc,GAAG,IAAI,CAAC;AACtB,QAAA,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;AACzB,QAAA,UAAU,GAAG,oBAAY,GAAG,EAAE,CAAC"}

package/src/lib/filter/filter.d.ts

@@ -3,3 +3,11 @@ export interface Filter<F> {
 }
 export interface OptionalFilter<F> extends Partial<Filter<F>> {
 }
+/**
+ * Used to invert a filter function by returning the opposite of what it returns.
+ *
+ * @param filterFn
+ * @param invert whether or not to apply the inversion.
+ * @returns
+ */
+export declare function invertFilter<F extends (((value: any, index: number) => boolean) | ((value: any) => boolean) | (() => boolean)) = () => boolean>(filterFn: F, invert?: boolean): F;

package/src/lib/filter/filter.js

@@ -1,3 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.invertFilter = void 0;
+/**
+ * Used to invert a filter function by returning the opposite of what it returns.
+ *
+ * @param filterFn
+ * @param invert whether or not to apply the inversion.
+ * @returns
+ */
+function invertFilter(filterFn, invert = true) {
+    if (invert) {
+        return function () {
+            const result = filterFn.apply(undefined, arguments);
+            return !result;
+        };
+    }
+    else {
+        return filterFn;
+    }
+}
+exports.invertFilter = invertFilter;
 //# sourceMappingURL=filter.js.map

package/src/lib/filter/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/filter/filter.ts"],"names":[],"mappings":""}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/filter/filter.ts"],"names":[],"mappings":";;;AAOA;;;;;;GAMG;AACH,SAAgB,YAAY,CAAqH,QAAW,EAAE,MAAM,GAAG,IAAI;IACzK,IAAI,MAAM,EAAE;QACV,OAAO;YACL,MAAM,MAAM,GAAa,QAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACtE,OAAO,CAAC,MAAM,CAAC;QACjB,CAAM,CAAC;KACR;SAAM;QACL,OAAO,QAAQ,CAAC;KACjB;AACH,CAAC;AATD,oCASC"}

package/src/lib/getter.d.ts

@@ -2,10 +2,18 @@
  * Function that returns a value.
  */
 export declare type Getter<T> = () => T;
+/**
+ * Function that returns a value with a single argument.
+ */
+export declare type GetterWithInput<T, A> = (args?: A) => T;
 /**
  * Either a Getter, or an instance of the item.
  */
 export declare type ObjectOrGetter<T> = T | Getter<T>;
+/**
+ * Either a GetterWithInput, or a Getter.
+ */
+export declare type ObjectOrGetterWithInput<T, A> = Getter<T> | GetterWithInput<T, A>;
 export declare type StringOrGetter = ObjectOrGetter<string>;
 /**
  * If the input is a function, it is executed. Otherwise, the value is returned.
@@ -14,3 +22,5 @@ export declare type StringOrGetter = ObjectOrGetter<string>;
  * @returns
  */
 export declare function getValueFromObjectOrGetter<T>(input: ObjectOrGetter<T>): T;
+export declare function getValueFromObjectOrGetter<T>(this: any, input: ObjectOrGetter<T>, inputArgs?: any): T;
+export declare function getValueFromObjectOrGetter<T, A>(this: any, input: ObjectOrGetterWithInput<T, A>, args?: A): T;

package/src/lib/getter.js

@@ -1,15 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getValueFromObjectOrGetter = void 0;
-/**
- * If the input is a function, it is executed. Otherwise, the value is returned.
- *
- * @param input
- * @returns
- */
-function getValueFromObjectOrGetter(input) {
+function getValueFromObjectOrGetter(input, args) {
     if (typeof input === 'function') {
-        return input();
+        return input(args);
     }
     else {
         return input;

package/src/lib/getter.js.map

@@ -1 +1 @@
-{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/getter.ts"],"names":[],"mappings":";;;AAaA;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAI,KAAwB;IACpE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAQ,KAAiB,EAAE,CAAC;KAC7B;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAND,gEAMC"}
+{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/getter.ts"],"names":[],"mappings":";;;AAgCA,SAAgB,0BAA0B,CAAkB,KAAoC,EAAE,IAAQ;IACxG,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAND,gEAMC"}

package/src/lib/index.d.ts

@@ -6,6 +6,7 @@ export * from './filter';
 export * from './promise';
 export * from './relation';
 export * from './storage';
+export * from './tree';
 export * from './boolean';
 export * from './date';
 export * from './lifecycle';

package/src/lib/index.js

@@ -9,6 +9,7 @@ const tslib_1 = require("tslib");
 (0, tslib_1.__exportStar)(require("./promise"), exports);
 (0, tslib_1.__exportStar)(require("./relation"), exports);
 (0, tslib_1.__exportStar)(require("./storage"), exports);
+(0, tslib_1.__exportStar)(require("./tree"), exports);
 (0, tslib_1.__exportStar)(require("./boolean"), exports);
 (0, tslib_1.__exportStar)(require("./date"), exports);
 (0, tslib_1.__exportStar)(require("./lifecycle"), exports);

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,uDAAwB;AACxB,2DAA4B;AAC5B,yDAA0B;AAC1B,uDAAwB;AACxB,wDAAyB;AACzB,yDAA0B;AAC1B,0DAA2B;AAC3B,yDAA0B;AAC1B,yDAA0B;AAC1B,sDAAuB;AACvB,2DAA4B;AAC5B,wDAAyB;AACzB,0DAA2B;AAC3B,sDAAuB;AACvB,yDAA0B;AAC1B,qDAAsB;AACtB,qDAAsB;AACtB,uDAAwB;AACxB,wDAAyB;AACzB,wDAAyB;AACzB,sDAAuB;AACvB,6DAA8B;AAC9B,6BAA6B;AAC7B,sDAAuB;AACvB,wDAAyB;AACzB,sDAAuB;AACvB,uDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,uDAAwB;AACxB,2DAA4B;AAC5B,yDAA0B;AAC1B,uDAAwB;AACxB,wDAAyB;AACzB,yDAA0B;AAC1B,0DAA2B;AAC3B,yDAA0B;AAC1B,sDAAuB;AACvB,yDAA0B;AAC1B,sDAAuB;AACvB,2DAA4B;AAC5B,wDAAyB;AACzB,0DAA2B;AAC3B,sDAAuB;AACvB,yDAA0B;AAC1B,qDAAsB;AACtB,qDAAsB;AACtB,uDAAwB;AACxB,wDAAyB;AACzB,wDAAyB;AACzB,sDAAuB;AACvB,6DAA8B;AAC9B,6BAA6B;AAC7B,sDAAuB;AACvB,wDAAyB;AACzB,sDAAuB;AACvB,uDAAwB"}