@dereekb/util 0.0.1

package/src/lib/grouping.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeValuesGroupMap = exports.groupValues = exports.separateValues = exports.makeKeyPairs = exports.pairGroupValues = exports.arrayContentsDiffer = exports.restoreOrder = exports.restoreOrderWithValues = exports.batch = void 0;
+const object_1 = require("./object");
+// MARK: Functions
+/**
+ * Batches items from the input array into several batches of a maximum size.
+ *
+ * @param array
+ * @param batchSize
+ * @returns
+ */
+function batch(array, batchSize) {
+    array = [].concat(array); // Copy array before splicing it.
+    const batch = [];
+    while (array.length > 0) {
+        batch.push(array.splice(0, batchSize));
+    }
+    return batch;
+}
+exports.batch = batch;
+/**
+ * Convenience function for calling restoreOrder with two arrays of values, instead of an array of keys and array of values.
+ *
+ * @param orderValues
+ * @param values
+ * @param params
+ * @returns
+ */
+function restoreOrderWithValues(orderValues, values, params) {
+    const { readKey } = params;
+    const orderKeys = orderValues.map(x => readKey(x));
+    return restoreOrder(orderKeys, values, params);
+}
+exports.restoreOrderWithValues = restoreOrderWithValues;
+/**
+ * Restores the order to the input values based on their keys.
+ *
+ * Duplicate values are passed to the chooseRetainedValue function past. When no function is provided, duplicates are ignored.
+ */
+function restoreOrder(orderKeys, values, { readKey, chooseRetainedValue = (values) => values[0], excludeNewItems = false }) {
+    const valuesMap = makeValuesGroupMap(values, readKey);
+    const orderKeysMap = new Map(orderKeys.map((x, i) => [x, i]));
+    const restoredOrder = new Array();
+    const newItems = [];
+    valuesMap.forEach((values, key) => {
+        const index = orderKeysMap.get(key);
+        function getValue() {
+            return (values.length > 1) ? chooseRetainedValue(values) : values[0];
+        }
+        if (index != null) {
+            restoredOrder[index] = getValue();
+        }
+        else if (!excludeNewItems) {
+            newItems.push(getValue());
+        }
+    });
+    const result = [...restoredOrder, ...newItems].filter(x => x !== undefined); // Allow null to be passed.
+    return result;
+}
+exports.restoreOrder = restoreOrder;
+/**
+ * Returns true if the input differs from eachother.
+ *
+ * Input items are uniquely keyed in some fashion. The same items are paired up.
+ */
+function arrayContentsDiffer(a = [], b = [], { groupKeyFn, isEqual }) {
+    let areDifferent = false;
+    if (a.length === b.length) {
+        const pairs = pairGroupValues([...a, ...b], groupKeyFn);
+        if (pairs.unpaired) {
+            // Any unpaired items means there is a difference.
+            areDifferent = true;
+        }
+        else {
+            for (const [aa, bb] of pairs.pairs) {
+                // If any item is not the same, break.
+                if (!isEqual(aa, bb)) {
+                    areDifferent = true;
+                    break;
+                }
+            }
+        }
+    }
+    else {
+        areDifferent = true; // Different lengths, different content.
+    }
+    return areDifferent;
+}
+exports.arrayContentsDiffer = arrayContentsDiffer;
+function pairGroupValues(values, groupKeyFn) {
+    const map = makeValuesGroupMap(values, groupKeyFn);
+    const pairs = [];
+    const unpaired = [];
+    map.forEach((x, key) => {
+        if (x.length === 1) {
+            unpaired.push(x[0]);
+        }
+        else {
+            pairs.push(x);
+        }
+    });
+    return {
+        pairs,
+        unpaired
+    };
+}
+exports.pairGroupValues = pairGroupValues;
+/**
+ * Creates a tuples array of key and value pairs.
+ *
+ * @param values
+ * @param keyFn
+ * @returns
+ */
+function makeKeyPairs(values, keyFn) {
+    return values.map(x => ([keyFn(x), x]));
+}
+exports.makeKeyPairs = makeKeyPairs;
+/**
+ * Separates the input values into an included and excluded group.
+ *
+ * @param values
+ * @param checkInclusion
+ * @returns
+ */
+function separateValues(values, checkInclusion) {
+    const result = groupValues(values, (x) => {
+        return (checkInclusion(x)) ? 'in' : 'out';
+    });
+    return {
+        included: result.in || [],
+        excluded: result.out || []
+    };
+}
+exports.separateValues = separateValues;
+function groupValues(values, groupKeyFn) {
+    const map = makeValuesGroupMap(values, groupKeyFn);
+    return (0, object_1.mapToObject)(map);
+}
+exports.groupValues = groupValues;
+/**
+ * Reads keys from the values in the arrays, and groups them together into a Map.
+ *
+ * @param values
+ * @param groupKeyFn
+ * @returns
+ */
+function makeValuesGroupMap(values, groupKeyFn) {
+    const map = new Map();
+    values.forEach((x) => {
+        const key = groupKeyFn(x);
+        let array = map.get(key);
+        if (array != null) {
+            array.push(x);
+        }
+        else {
+            map.set(key, [x]);
+        }
+    });
+    return map;
+}
+exports.makeValuesGroupMap = makeValuesGroupMap;
+//# sourceMappingURL=grouping.js.map

package/src/lib/grouping.js.map

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

package/src/lib/hash.d.ts

@@ -0,0 +1,5 @@
+export declare type HashSalt = string;
+export declare type HashDecodeMap<H extends string = string, V extends string = string> = Map<H, V>;
+export declare function decodeHashedValues(hashedValues: string[], decodeValues: string[], hashFn: (value: string) => string): string[];
+export declare function makeHashDecodeMap(decodeValues: string[], hashFn: (value: string) => string): HashDecodeMap;
+export declare function decodeHashedValuesWithDecodeMap(hashedValues: string[], decodeMap: HashDecodeMap): string[];

package/src/lib/hash.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeHashedValuesWithDecodeMap = exports.makeHashDecodeMap = exports.decodeHashedValues = void 0;
+const array_1 = require("./array");
+function decodeHashedValues(hashedValues, decodeValues, hashFn) {
+    const hashDecodeMap = makeHashDecodeMap(decodeValues, hashFn);
+    return decodeHashedValuesWithDecodeMap(hashedValues, hashDecodeMap);
+}
+exports.decodeHashedValues = decodeHashedValues;
+function makeHashDecodeMap(decodeValues, hashFn) {
+    const keyValuePairs = decodeValues.map(x => [hashFn(x), x]);
+    const map = new Map(keyValuePairs);
+    return map;
+}
+exports.makeHashDecodeMap = makeHashDecodeMap;
+function decodeHashedValuesWithDecodeMap(hashedValues, decodeMap) {
+    const values = hashedValues.map(x => decodeMap.get(x));
+    return (0, array_1.filterMaybeValues)(values);
+}
+exports.decodeHashedValuesWithDecodeMap = decodeHashedValuesWithDecodeMap;
+//# sourceMappingURL=hash.js.map

package/src/lib/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/hash.ts"],"names":[],"mappings":";;;AAAA,mCAA4C;AAM5C,SAAgB,kBAAkB,CAAC,YAAsB,EAAE,YAAsB,EAAE,MAAiC;IAClH,MAAM,aAAa,GAAG,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,+BAA+B,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAHD,gDAGC;AAED,SAAgB,iBAAiB,CAAC,YAAsB,EAAE,MAAiC;IACzF,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAqB,CAAC,CAAC;IAChF,MAAM,GAAG,GAAkB,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC;AAJD,8CAIC;AAED,SAAgB,+BAA+B,CAAC,YAAsB,EAAE,SAAwB;IAC9F,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAHD,0EAGC"}

package/src/lib/index.d.ts

@@ -0,0 +1,26 @@
+export * from './array';
+export * from './assertion';
+export * from './contact';
+export * from './error';
+export * from './filter';
+export * from './promise';
+export * from './relation';
+export * from './storage';
+export * from './boolean';
+export * from './date';
+export * from './lifecycle';
+export * from './getter';
+export * from './grouping';
+export * from './hash';
+export * from './iterate';
+export * from './key';
+export * from './map';
+export * from './model';
+export * from './number';
+export * from './object';
+export * from './page';
+export * from './set.hashset';
+export * from './sort';
+export * from './string';
+export * from './type';
+export * from './value';

package/src/lib/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./array"), exports);
+(0, tslib_1.__exportStar)(require("./assertion"), exports);
+(0, tslib_1.__exportStar)(require("./contact"), exports);
+(0, tslib_1.__exportStar)(require("./error"), exports);
+(0, tslib_1.__exportStar)(require("./filter"), exports);
+(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("./boolean"), exports);
+(0, tslib_1.__exportStar)(require("./date"), exports);
+(0, tslib_1.__exportStar)(require("./lifecycle"), exports);
+(0, tslib_1.__exportStar)(require("./getter"), exports);
+(0, tslib_1.__exportStar)(require("./grouping"), exports);
+(0, tslib_1.__exportStar)(require("./hash"), exports);
+(0, tslib_1.__exportStar)(require("./iterate"), exports);
+(0, tslib_1.__exportStar)(require("./key"), exports);
+(0, tslib_1.__exportStar)(require("./map"), exports);
+(0, tslib_1.__exportStar)(require("./model"), exports);
+(0, tslib_1.__exportStar)(require("./number"), exports);
+(0, tslib_1.__exportStar)(require("./object"), exports);
+(0, tslib_1.__exportStar)(require("./page"), exports);
+(0, tslib_1.__exportStar)(require("./set.hashset"), exports);
+// export * from './lib/set';
+(0, tslib_1.__exportStar)(require("./sort"), exports);
+(0, tslib_1.__exportStar)(require("./string"), exports);
+(0, tslib_1.__exportStar)(require("./type"), exports);
+(0, tslib_1.__exportStar)(require("./value"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -0,0 +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"}

package/src/lib/iterate.d.ts

@@ -0,0 +1,6 @@
+export declare type IterateFn<T> = (value: T) => void | Promise<void>;
+export declare type IteratePageFn<T> = (values: T[]) => void | Promise<void>;
+/**
+ * Async iteration over the input values in-order.
+ */
+export declare function iterate<T>(values: T[], useFn: IterateFn<T>): Promise<void>;

package/src/lib/iterate.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterate = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Async iteration over the input values in-order.
+ */
+function iterate(values, useFn) {
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+        for (let i = 0; i < values.length; i += 1) {
+            yield useFn(values[i]);
+        }
+    });
+}
+exports.iterate = iterate;
+//# sourceMappingURL=iterate.js.map

package/src/lib/iterate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/iterate.ts"],"names":[],"mappings":";;;;AAIA;;GAEG;AACH,SAAsB,OAAO,CAAI,MAAW,EAAE,KAAmB;;QAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;YACzC,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB;IACH,CAAC;CAAA;AAJD,0BAIC"}

package/src/lib/key.d.ts

@@ -0,0 +1,11 @@
+import { Maybe } from "./value";
+/**
+ * A key made up of either a string or number value.
+ */
+export declare type PrimativeKey = string | number;
+/**
+ * A key of a type.
+ */
+export declare type FieldOfType<T> = keyof T;
+export declare type ReadKeyFunction<T, K extends PrimativeKey = PrimativeKey> = (model: T) => Maybe<K>;
+export declare type ReadKeysFunction<T, K extends PrimativeKey = PrimativeKey> = (model: T) => K[];

package/src/lib/key.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=key.js.map

package/src/lib/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/key.ts"],"names":[],"mappings":""}

package/src/lib/lifecycle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Object that must be "initialized".
+ */
+export interface Initialized {
+    init(): void;
+}
+/**
+ * Object that can be "destroyed" as a way to clean itself up.
+ */
+export interface Destroyable {
+    destroy(): void;
+}

package/src/lib/lifecycle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lifecycle.js.map

package/src/lib/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/lifecycle.ts"],"names":[],"mappings":""}

package/src/lib/map.d.ts

@@ -0,0 +1,2 @@
+export declare type MapFn<A, B> = (value: A) => B;
+export declare type MapStringFn<T> = MapFn<string, T>;

package/src/lib/map.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=map.js.map

package/src/lib/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/map.ts"],"names":[],"mappings":""}

package/src/lib/model.d.ts

@@ -0,0 +1,74 @@
+import { ReadKeyFunction, ReadKeysFunction } from './key';
+import { Maybe } from './value';
+/**
+ * A string model key
+ */
+export declare type ModelKey = string;
+/**
+ * Arbitrary model type.
+ */
+export declare type ModelTypeString = string;
+/**
+ * A model with an identifier on the "id" key.
+ */
+export interface UniqueModel {
+    id?: ModelKey;
+}
+export interface NamedUniqueModel extends UniqueModel {
+    name?: string;
+}
+export declare type ModelOrKey<T extends UniqueModel> = T | ModelKey;
+export interface ModelKeyTypePair {
+    key: ModelKey;
+    type: ModelTypeString;
+}
+/**
+ * An encoded ModelKeyTypePair.
+ */
+export declare type ModelKeyTypePairString = string;
+export interface ModelKeyNamePair extends Pick<ModelKeyTypePair, 'key'> {
+    name?: string;
+}
+export interface ModelKeyTypeNamePair extends ModelKeyNamePair, ModelKeyTypePair {
+}
+export interface ReadModelKeyParams<T> {
+    required?: boolean;
+    read: ReadModelKeyFunction<T>;
+}
+export declare type ReadModelKeyFunction<T> = ReadKeyFunction<T, ModelKey>;
+export declare type ReadRelationKeysFunction<T> = ReadKeysFunction<T, ModelKey>;
+export declare type MultiModelKeyMap<T> = Map<string, T>;
+export declare const readUniqueModelKey: (model: UniqueModel) => string | undefined;
+export declare abstract class AbstractUniqueModel {
+    id?: ModelKey;
+    constructor(template: Partial<AbstractUniqueModel>);
+}
+export declare function uniqueKeys(keys: ModelKey[]): ModelKey[];
+export declare function uniqueModels<T extends UniqueModel>(models: T[], readKey?: ReadModelKeyFunction<T>): T[];
+export declare function uniqueModels<T>(models: T[], readKey: ReadModelKeyFunction<T>): T[];
+export declare function readModelKeysFromObjects<T extends UniqueModel>(input: T[], required?: boolean, read?: ReadModelKeyFunction<T>): Maybe<ModelKey>[];
+export declare function readModelKeysFromObjects<T extends UniqueModel>(input: T[], required: true, read?: ReadModelKeyFunction<T>): ModelKey[];
+export declare function symmetricDifferenceWithModels<T extends UniqueModel>(a: ModelOrKey<T>[], b: ModelOrKey<T>[], required?: boolean, read?: ReadModelKeyFunction<T>): Maybe<ModelKey>[];
+export declare function removeModelsWithSameKey<T>(input: T[], model: T, read: ReadModelKeyFunction<T>): T[];
+export declare function removeModelsWithKey<T extends UniqueModel>(input: T[], key: Maybe<ModelKey>, read?: ReadModelKeyFunction<T>): T[];
+export declare function removeModelsWithKey<T>(input: T[], key: Maybe<ModelKey>, read: ReadModelKeyFunction<T>): T[];
+export declare function makeModelMap<T extends UniqueModel>(input: T[], read?: ReadModelKeyFunction<T>): Map<Maybe<ModelKey>, T>;
+export declare function makeModelMap<T>(input: T[], read: ReadModelKeyFunction<T>): Map<Maybe<ModelKey>, T>;
+/**
+ * Creates a UniqueRelationsMap
+ */
+export declare function makeMultiModelKeyMap<T>(input: T[], read: ReadRelationKeysFunction<T>): MultiModelKeyMap<T>;
+export declare function useModelOrKey<O, T extends UniqueModel>(input: ModelOrKey<T>, { useModel, useKey, required }: {
+    useModel?: (model: T) => O;
+    useKey: (key: Maybe<ModelKey>) => O;
+    required?: boolean;
+}): Maybe<O>;
+export declare function readModelKeys<T extends UniqueModel>(input: (ModelOrKey<T> | undefined)[], required?: boolean, read?: ReadModelKeyFunction<T>): Maybe<ModelKey>[];
+export declare function requireModelKey<T extends UniqueModel>(input: ModelOrKey<T> | undefined): Maybe<ModelKey>;
+export declare function readModelKey<T>(input: ModelOrKey<any> | undefined, params: ReadModelKeyParams<T>): Maybe<ModelKey>;
+export declare function readModelKey<T extends UniqueModel>(input: ModelOrKey<T> | undefined, params?: Partial<ReadModelKeyParams<T>>): Maybe<ModelKey>;
+export declare function readModelKeyFromObject<T extends UniqueModel>(input: T, required?: boolean, read?: ReadModelKeyFunction<T>): Maybe<ModelKey>;
+export declare function isModelKey<T extends UniqueModel>(input: ModelOrKey<T>): input is ModelKey;
+export declare function throwKeyIsRequired(): void;
+export declare function encodeModelKeyTypePair(pair: ModelKeyTypePair): ModelKey;
+export declare function decodeModelKeyTypePair(linkKey: ModelKey): ModelKeyTypePair;

package/src/lib/model.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeModelKeyTypePair = exports.encodeModelKeyTypePair = exports.throwKeyIsRequired = exports.isModelKey = exports.readModelKeyFromObject = exports.readModelKey = exports.requireModelKey = exports.readModelKeys = exports.useModelOrKey = exports.makeMultiModelKeyMap = exports.makeModelMap = exports.removeModelsWithKey = exports.removeModelsWithSameKey = exports.symmetricDifferenceWithModels = exports.readModelKeysFromObjects = exports.uniqueModels = exports.uniqueKeys = exports.AbstractUniqueModel = exports.readUniqueModelKey = void 0;
+const array_set_1 = require("./array/array.set");
+const array_unique_1 = require("./array/array.unique");
+const readUniqueModelKey = (model) => model.id;
+exports.readUniqueModelKey = readUniqueModelKey;
+class AbstractUniqueModel {
+    constructor(template) {
+        if (template) {
+            this.id = template.id;
+        }
+    }
+}
+exports.AbstractUniqueModel = AbstractUniqueModel;
+function uniqueKeys(keys) {
+    return Array.from(new Set(keys));
+}
+exports.uniqueKeys = uniqueKeys;
+function uniqueModels(models, readKey = exports.readUniqueModelKey) {
+    return (0, array_unique_1.findUnique)(models, readKey);
+}
+exports.uniqueModels = uniqueModels;
+function readModelKeysFromObjects(input, required, read) {
+    return input.map(x => readModelKeyFromObject(x, required, read));
+}
+exports.readModelKeysFromObjects = readModelKeysFromObjects;
+function symmetricDifferenceWithModels(a, b, required, read) {
+    return (0, array_set_1.symmetricDifferenceKeys)(readModelKeys(a, required, read), readModelKeys(b, required, read));
+}
+exports.symmetricDifferenceWithModels = symmetricDifferenceWithModels;
+function removeModelsWithSameKey(input, model, read) {
+    const targetKey = read(model);
+    return removeModelsWithKey(input, targetKey, read);
+}
+exports.removeModelsWithSameKey = removeModelsWithSameKey;
+function removeModelsWithKey(input, key, read = exports.readUniqueModelKey) {
+    return input.filter(x => read(x) !== key);
+}
+exports.removeModelsWithKey = removeModelsWithKey;
+function makeModelMap(input, read) {
+    const map = new Map();
+    if (input) {
+        input.forEach((x) => map.set(readModelKey(x, { required: false, read }), x));
+    }
+    return map;
+}
+exports.makeModelMap = makeModelMap;
+/**
+ * Creates a UniqueRelationsMap
+ */
+function makeMultiModelKeyMap(input, read) {
+    const map = new Map();
+    input.forEach((x) => {
+        var _a;
+        const keys = (_a = read(x)) !== null && _a !== void 0 ? _a : [];
+        keys.forEach((key) => map.set(key, x));
+    });
+    return map;
+}
+exports.makeMultiModelKeyMap = makeMultiModelKeyMap;
+function useModelOrKey(input, { useModel, useKey, required = false }) {
+    let result;
+    if (input != null) {
+        if (isModelKey(input)) {
+            result = useKey(input);
+        }
+        else {
+            result = (useModel) ? useModel(input) : useKey(readModelKey(input));
+        }
+    }
+    else if (required) {
+        throwKeyIsRequired();
+    }
+    return result;
+}
+exports.useModelOrKey = useModelOrKey;
+function readModelKeys(input, required, read) {
+    return input.map(x => readModelKey(x, { required, read }));
+}
+exports.readModelKeys = readModelKeys;
+function requireModelKey(input) {
+    return readModelKey(input);
+}
+exports.requireModelKey = requireModelKey;
+function readModelKey(input, { required = false, read = (x) => x.id } = {}) {
+    let key;
+    switch (typeof input) {
+        case 'string':
+            key = input;
+            break;
+        case 'object':
+            key = read(input);
+            break;
+        case 'undefined':
+        default:
+            break;
+    }
+    if (!key && required) {
+        throwKeyIsRequired();
+    }
+    return key;
+}
+exports.readModelKey = readModelKey;
+function readModelKeyFromObject(input, required = false, read = (x) => x.id) {
+    const key = read(input);
+    if (!key && required) {
+        throwKeyIsRequired();
+    }
+    return key;
+}
+exports.readModelKeyFromObject = readModelKeyFromObject;
+function isModelKey(input) {
+    switch (typeof input) {
+        case 'string':
+            return true;
+        default:
+            return false;
+    }
+}
+exports.isModelKey = isModelKey;
+function throwKeyIsRequired() {
+    throw new Error('Key was required.');
+}
+exports.throwKeyIsRequired = throwKeyIsRequired;
+function encodeModelKeyTypePair(pair) {
+    return `${pair.type}_${pair.key}`;
+}
+exports.encodeModelKeyTypePair = encodeModelKeyTypePair;
+function decodeModelKeyTypePair(linkKey) {
+    const split = linkKey.split('_');
+    return {
+        type: split[0],
+        key: split[1]
+    };
+}
+exports.decodeModelKeyTypePair = decodeModelKeyTypePair;
+//# sourceMappingURL=model.js.map

package/src/lib/model.js.map

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

package/src/lib/number.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rounds the input number to the given precision.
+ *
+ * @param value
+ * @param precision
+ * @returns
+ */
+export declare function roundToPrecision(value: number, precision: number): number;
+/**
+ * Rounds the number up to a specific "step" that contains it.
+ *
+ * For example, with the value of 2, and a step size of 5, the value will be rounded up to 1.
+ *
+ * @param value Input value.
+ * @param step Step size.
+ * @returns Step that contains the value.
+ */
+export declare function roundNumberUpToStep(value: number, step: number): number;

package/src/lib/number.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roundNumberUpToStep = exports.roundToPrecision = void 0;
+// MARK: Number/Math
+/**
+ * Rounds the input number to the given precision.
+ *
+ * @param value
+ * @param precision
+ * @returns
+ */
+function roundToPrecision(value, precision) {
+    return +(Math.round(Number(value + 'e+' + precision)) + 'e-' + precision);
+}
+exports.roundToPrecision = roundToPrecision;
+/**
+ * Rounds the number up to a specific "step" that contains it.
+ *
+ * For example, with the value of 2, and a step size of 5, the value will be rounded up to 1.
+ *
+ * @param value Input value.
+ * @param step Step size.
+ * @returns Step that contains the value.
+ */
+function roundNumberUpToStep(value, step) {
+    return Math.ceil(value / step) * step;
+}
+exports.roundNumberUpToStep = roundNumberUpToStep;
+//# sourceMappingURL=number.js.map

package/src/lib/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/number.ts"],"names":[],"mappings":";;;AACA,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC"}

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

@@ -0,0 +1,3 @@
+export * from './object.array';
+export * from './object.equal';
+export * from './object';

package/src/lib/object/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./object.array"), exports);
+(0, tslib_1.__exportStar)(require("./object.equal"), exports);
+(0, tslib_1.__exportStar)(require("./object"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/index.ts"],"names":[],"mappings":";;;AAAA,8DAA+B;AAC/B,8DAA+B;AAC/B,wDAAyB"}