@dereekb/util 1.2.0 → 3.0.0

package/src/lib/getter/getter.cache.d.ts

@@ -0,0 +1,38 @@
+import { FactoryWithInput, Getter } from "./getter";
+/**
+ * Getter that returns a cached value.
+ */
+export declare type CachedGetter<T> = Getter<T> & {
+    /**
+     * Sets the value in the cache.
+     *
+     * @param value
+     */
+    set(value: T): void;
+    /**
+     * Resets/clears the cache.
+     */
+    reset(): void;
+    /**
+     * Re-initializes the getter and reloads the value from the source.
+     */
+    init(): void;
+};
+export declare type CachedFactoryWithInput<T, A = any> = CachedGetter<T> & FactoryWithInput<T, A> & {
+    /**
+     * Re-initializes the cache using the factory function.
+     *
+     * @param input
+     */
+    init(input?: A): void;
+};
+/**
+ * Creates a CachedGetter from the input Getter.
+ *
+ * The value will be retrieved once, then cached permenantly by this function.
+ *
+ * @param getter
+ * @returns
+ */
+export declare function cachedGetter<T>(getter: Getter<T>): CachedFactoryWithInput<T>;
+export declare function cachedGetter<T, A = any>(factory: FactoryWithInput<T, A>): CachedFactoryWithInput<T, A>;

package/src/lib/getter/getter.cache.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cachedGetter = void 0;
+function cachedGetter(factory) {
+    let loaded;
+    const init = (input) => {
+        loaded = {
+            value: factory(input)
+        };
+    };
+    const result = ((input) => {
+        if (!loaded) {
+            init(input);
+        }
+        return loaded.value;
+    });
+    result.set = (value) => loaded = { value };
+    result.reset = () => loaded = undefined;
+    result.init = init;
+    return result;
+}
+exports.cachedGetter = cachedGetter;
+//# sourceMappingURL=getter.cache.js.map

package/src/lib/getter/getter.cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getter.cache.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.cache.ts"],"names":[],"mappings":";;;AA8CA,SAAgB,YAAY,CAAa,OAA+B;IACtE,IAAI,MAA2B,CAAC;IAEhC,MAAM,IAAI,GAAG,CAAC,KAAS,EAAE,EAAE;QACzB,MAAM,GAAG;YACP,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAS,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,EAAE;YACX,IAAI,CAAC,KAAK,CAAC,CAAC;SACb;QAED,OAAO,MAAO,CAAC,KAAK,CAAC;IACvB,CAAC,CAAiC,CAAC;IAEnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;IAC9C,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAEnB,OAAO,MAAM,CAAC;AAChB,CAAC;AAtBD,oCAsBC"}

package/src/lib/getter/getter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Function that returns a value.
+ */
+export declare type Getter<T> = () => T;
+/**
+ * Getter with the design of returning a new value each time.
+ */
+export declare type Factory<T> = Getter<T>;
+/**
+ * Function that returns a value with an optional single argument.
+ */
+export declare type FactoryWithInput<T, A> = (args?: A) => T;
+/**
+ * Function that returns a value with a single argument.
+ */
+export declare type FactoryWithRequiredInput<T, A> = (args: A) => T;
+/**
+ * Either a Getter, or an instance of the item.
+ */
+export declare type GetterOrValue<T> = T | Getter<T>;
+/**
+ * Either a GetterWithInput, or a Getter.
+ */
+export declare type GetterOrFactoryWithInput<T, A> = Getter<T> | FactoryWithInput<T, A>;
+/**
+ * Either a GetterOrValue, or a FactoryWithInput.
+ */
+export declare type GetterOrValueWithInput<T extends string | number | object | symbol, A> = GetterOrValue<T> | FactoryWithInput<T, A>;
+export declare type StringOrGetter = GetterOrValue<string>;
+/**
+ * Returns true if the input object looks like a Getter (is a function).
+ *
+ * @param value
+ * @returns
+ */
+export declare function isGetter<T = any>(value: any): value is Getter<T>;
+/**
+ * If the input is a function, it is executed. Otherwise, the value is returned.
+ *
+ * @param input
+ * @returns
+ */
+export declare function getValueFromGetter<T>(input: GetterOrValue<T>): T;
+export declare function getValueFromGetter<T>(this: any, input: GetterOrValue<T>): T;
+export declare function getValueFromGetter<T>(this: any, input: GetterOrValue<T>, inputArgs?: any): T;
+export declare function getValueFromGetter<T, A>(this: any, input: GetterOrFactoryWithInput<T, A>, args?: A): T;
+export declare function getValueFromGetter<T extends string | number | object | symbol, A>(this: any, input: GetterOrValueWithInput<T, A>, args?: A): T;
+/**
+ * Returns the input as a getter.
+ *
+ * @param input
+ * @returns
+ */
+export declare function asGetter<T>(input: GetterOrValue<T>): Getter<T>;
+/**
+ * Wraps the input and returns a Getter for that value.
+ *
+ * @param input
+ * @returns
+ */
+export declare function makeGetter<T>(input: T): Getter<T>;

package/src/lib/getter/getter.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeGetter = exports.asGetter = exports.getValueFromGetter = exports.isGetter = void 0;
+/**
+ * Returns true if the input object looks like a Getter (is a function).
+ *
+ * @param value
+ * @returns
+ */
+function isGetter(value) {
+    return (typeof value === 'function');
+}
+exports.isGetter = isGetter;
+function getValueFromGetter(input, args) {
+    if (typeof input === 'function') {
+        return input(args);
+    }
+    else {
+        return input;
+    }
+}
+exports.getValueFromGetter = getValueFromGetter;
+/**
+ * Returns the input as a getter.
+ *
+ * @param input
+ * @returns
+ */
+function asGetter(input) {
+    if (typeof input === 'function') {
+        return input;
+    }
+    else {
+        return makeGetter(input);
+    }
+}
+exports.asGetter = asGetter;
+/**
+ * Wraps the input and returns a Getter for that value.
+ *
+ * @param input
+ * @returns
+ */
+function makeGetter(input) {
+    return () => input;
+}
+exports.makeGetter = makeGetter;
+//# sourceMappingURL=getter.js.map

package/src/lib/getter/getter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.ts"],"names":[],"mappings":";;;AAsCA;;;;;GAKG;AACH,SAAgB,QAAQ,CAAU,KAAU;IAC1C,OAAO,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC;AACvC,CAAC;AAFD,4BAEC;AAaD,SAAgB,kBAAkB,CAAkB,KAAU,EAAE,IAAQ;IACtE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAND,gDAMC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,KAAuB;IACjD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAkB,CAAC;KAC3B;SAAM;QACL,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;KAC1B;AACH,CAAC;AAND,4BAMC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAI,KAAQ;IACpC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,CAAC;AAFD,gCAEC"}

package/src/lib/getter/getter.map.d.ts

@@ -0,0 +1,15 @@
+import { MapFunction } from "../value/map";
+import { Getter } from "./getter";
+export declare type MapGetterFactory<I, O> = (input: Getter<I>) => Getter<O>;
+/**
+ * Maps the input getter.
+ *
+ * @param input
+ */
+export declare function mapGetter<I, O>(input: Getter<I>, mapFn: MapFunction<I, O>): Getter<O>;
+/**
+ * Creates a MapGetter
+ *
+ * @param input
+ */
+export declare function mapGetterFactory<I, O>(mapFn: MapFunction<I, O>): MapGetterFactory<I, O>;

package/src/lib/getter/getter.map.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapGetterFactory = exports.mapGetter = void 0;
+/**
+ * Maps the input getter.
+ *
+ * @param input
+ */
+function mapGetter(input, mapFn) {
+    return mapGetterFactory(mapFn)(input);
+}
+exports.mapGetter = mapGetter;
+/**
+ * Creates a MapGetter
+ *
+ * @param input
+ */
+function mapGetterFactory(mapFn) {
+    return (getter) => {
+        return () => mapFn(getter());
+    };
+}
+exports.mapGetterFactory = mapGetterFactory;
+//# sourceMappingURL=getter.map.js.map

package/src/lib/getter/getter.map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getter.map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.map.ts"],"names":[],"mappings":";;;AAMA;;;;GAIG;AACH,SAAgB,SAAS,CAAO,KAAgB,EAAE,KAAwB;IACxE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAFD,8BAEC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAO,KAAwB;IAC7D,OAAO,CAAC,MAAiB,EAAE,EAAE;QAC3B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAJD,4CAIC"}

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

@@ -0,0 +1,3 @@
+export * from './getter';
+export * from './getter.cache';
+export * from './getter.map';

package/src/lib/getter/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,yDAA+B;AAC/B,uDAA6B"}

package/src/lib/grouping.d.ts

@@ -1,5 +1,5 @@
 import { PrimativeKey, ReadKeyFunction } from "./key";
-import { Maybe } from "./value";
+import { Maybe } from "./value/maybe";
 export interface SeparateResult<T> {
     included: T[];
     excluded: T[];
@@ -7,8 +7,8 @@ export interface SeparateResult<T> {
 export interface GroupingResult<T> {
     [key: string]: T[];
 }
-export declare type KeyedGroupingResult<T, O, K extends keyof O = keyof O> = {
-    [k in K]: T[];
+export declare type KeyedGroupingResult<T, O> = {
+    [K in keyof O]: T[];
 };
 export interface PairsGroupingResult<T> {
     pairs: T[][];
@@ -86,7 +86,7 @@ export declare function separateValues<T>(values: T[], checkInclusion: (x: T) =>
  * @param values
  * @param groupKeyFn
  */
-export declare function groupValues<T, R, K extends PrimativeKey & keyof R>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): KeyedGroupingResult<T, R, K>;
+export declare function groupValues<T, R, K extends PrimativeKey & keyof R>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): KeyedGroupingResult<T, R>;
 export declare function groupValues<T, K extends PrimativeKey = PrimativeKey>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): GroupingResult<T>;
 /**
  * Reads keys from the values in the arrays, and groups them together into a Map.

package/src/lib/index.d.ts

@@ -1,27 +1,31 @@
 export * from './array';
 export * from './assertion';
+export * from './auth';
 export * from './contact';
 export * from './error';
 export * from './filter';
+export * from './function';
+export * from './getter';
+export * from './iterable';
+export * from './map';
+export * from './model';
+export * from './misc';
 export * from './promise';
 export * from './relation';
+export * from './set';
 export * from './storage';
 export * from './tree';
+export * from './value';
 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

@@ -1,32 +1,35 @@
 "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("./tree"), 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);
+tslib_1.__exportStar(require("./array"), exports);
+tslib_1.__exportStar(require("./assertion"), exports);
+tslib_1.__exportStar(require("./auth"), exports);
+tslib_1.__exportStar(require("./contact"), exports);
+tslib_1.__exportStar(require("./error"), exports);
+tslib_1.__exportStar(require("./filter"), exports);
+tslib_1.__exportStar(require("./function"), exports);
+tslib_1.__exportStar(require("./getter"), exports);
+tslib_1.__exportStar(require("./iterable"), exports);
+tslib_1.__exportStar(require("./map"), exports);
+tslib_1.__exportStar(require("./model"), exports);
+tslib_1.__exportStar(require("./misc"), exports);
+tslib_1.__exportStar(require("./promise"), exports);
+tslib_1.__exportStar(require("./relation"), exports);
+tslib_1.__exportStar(require("./set"), exports);
+tslib_1.__exportStar(require("./storage"), exports);
+tslib_1.__exportStar(require("./tree"), exports);
+tslib_1.__exportStar(require("./value"), exports);
+tslib_1.__exportStar(require("./boolean"), exports);
+tslib_1.__exportStar(require("./date"), exports);
+tslib_1.__exportStar(require("./lifecycle"), exports);
+tslib_1.__exportStar(require("./grouping"), exports);
+tslib_1.__exportStar(require("./hash"), exports);
+tslib_1.__exportStar(require("./iterate"), exports);
+tslib_1.__exportStar(require("./key"), exports);
+tslib_1.__exportStar(require("./number"), exports);
+tslib_1.__exportStar(require("./object"), exports);
+tslib_1.__exportStar(require("./page"), exports);
+tslib_1.__exportStar(require("./sort"), exports);
+tslib_1.__exportStar(require("./string"), exports);
+tslib_1.__exportStar(require("./type"), exports);
 //# sourceMappingURL=index.js.map

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,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,sDAA4B;AAC5B,iDAAuB;AACvB,oDAA0B;AAC1B,kDAAwB;AACxB,mDAAyB;AACzB,qDAA2B;AAC3B,mDAAyB;AACzB,qDAA2B;AAC3B,gDAAsB;AACtB,kDAAwB;AACxB,iDAAuB;AACvB,oDAA0B;AAC1B,qDAA2B;AAC3B,gDAAsB;AACtB,oDAA0B;AAC1B,iDAAuB;AACvB,kDAAwB;AACxB,oDAA0B;AAC1B,iDAAuB;AACvB,sDAA4B;AAC5B,qDAA2B;AAC3B,iDAAuB;AACvB,oDAA0B;AAC1B,gDAAsB;AACtB,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB"}

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

@@ -0,0 +1,2 @@
+export * from './iterable';
+export * from './iterable.map';

package/src/lib/iterable/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/iterable/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,yDAA+B"}

package/src/lib/iterable/iterable.d.ts

@@ -0,0 +1,53 @@
+import { Maybe } from "../value/maybe";
+export declare type IterableOrValue<T> = T | Iterable<T>;
+/**
+ * Returns true if the input is an Iterable.
+ *
+ * @param values
+ * @returns
+ */
+export declare function isIterable<T = any>(values: any): values is Iterable<T>;
+/**
+ * Returns the first value from the Iterable. If there are no values, returns undefined. Order is not guranteed.
+ *
+ * @param values
+ * @returns
+ */
+export declare function firstValueFromIterable<T>(values: Iterable<T>): Maybe<T>;
+/**
+ * Takes items from the iterable in the order they are read. Order is not guranteed.
+ *
+ * @param values
+ * @param count
+ * @returns
+ */
+export declare function takeValuesFromIterable<T>(values: Iterable<T>, count: number): T[];
+/**
+ * Iterates over iterable values.
+ *
+ * @param values
+ * @param fn
+ */
+export declare function forEachInIterable<T>(values: Iterable<T>, fn: (value: T) => void): void;
+/**
+ * Uses the input iterable if it is defined.
+ *
+ * @param values
+ * @param fn
+ */
+export declare function useIterableOrValue<T>(values: Maybe<IterableOrValue<T>>, fn: (value: T) => void): void;
+/**
+ * Find the first matching value in the Iterable.
+ *
+ * @param values
+ * @param fn
+ */
+export declare function findInIterable<T>(values: Iterable<T>, fn: (value: T) => boolean): Maybe<T>;
+/**
+ * Whether or not the value exists in the iterable.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+export declare function existsInIterable<T>(values: Iterable<T>, fn: (value: T) => boolean): boolean;

package/src/lib/iterable/iterable.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.existsInIterable = exports.findInIterable = exports.useIterableOrValue = exports.forEachInIterable = exports.takeValuesFromIterable = exports.firstValueFromIterable = exports.isIterable = void 0;
+// MARK: Functions
+/**
+ * Returns true if the input is an Iterable.
+ *
+ * @param values
+ * @returns
+ */
+function isIterable(values) {
+    if (values && values[Symbol.iterator]) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+exports.isIterable = isIterable;
+/**
+ * Returns the first value from the Iterable. If there are no values, returns undefined. Order is not guranteed.
+ *
+ * @param values
+ * @returns
+ */
+function firstValueFromIterable(values) {
+    for (const value of values) {
+        return value;
+    }
+    return undefined;
+}
+exports.firstValueFromIterable = firstValueFromIterable;
+/**
+ * Takes items from the iterable in the order they are read. Order is not guranteed.
+ *
+ * @param values
+ * @param count
+ * @returns
+ */
+function takeValuesFromIterable(values, count) {
+    let result = [];
+    for (const value of values) {
+        if (result.length < count) {
+            result.push(value);
+        }
+        else {
+            break;
+        }
+    }
+    return result;
+}
+exports.takeValuesFromIterable = takeValuesFromIterable;
+/**
+ * Iterates over iterable values.
+ *
+ * @param values
+ * @param fn
+ */
+function forEachInIterable(values, fn) {
+    for (const value of values) {
+        fn(value);
+    }
+}
+exports.forEachInIterable = forEachInIterable;
+/**
+ * Uses the input iterable if it is defined.
+ *
+ * @param values
+ * @param fn
+ */
+function useIterableOrValue(values, fn) {
+    if (values != null) {
+        if (isIterable(values)) {
+            forEachInIterable(values, fn);
+        }
+        else {
+            fn(values);
+        }
+    }
+}
+exports.useIterableOrValue = useIterableOrValue;
+/**
+ * Find the first matching value in the Iterable.
+ *
+ * @param values
+ * @param fn
+ */
+function findInIterable(values, fn) {
+    for (const value of values) {
+        if (fn(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+exports.findInIterable = findInIterable;
+/**
+ * Whether or not the value exists in the iterable.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+function existsInIterable(values, fn) {
+    for (const value of values) {
+        if (fn(value)) {
+            return true;
+        }
+    }
+    return false;
+}
+exports.existsInIterable = existsInIterable;
+//# sourceMappingURL=iterable.js.map

package/src/lib/iterable/iterable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/iterable/iterable.ts"],"names":[],"mappings":";;;AAKA,kBAAkB;AAClB;;;;;GAKG;AACH,SAAgB,UAAU,CAAU,MAAW;IAC7C,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACrC,OAAO,IAAI,CAAC;KACb;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAND,gCAMC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAI,MAAmB;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,OAAO,KAAK,CAAC;KACd;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAND,wDAMC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAI,MAAmB,EAAE,KAAa;IAC1E,IAAI,MAAM,GAAQ,EAAE,CAAC;IAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE;YACzB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACpB;aAAM;YACL,MAAM;SACP;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAZD,wDAYC;AAGD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAI,MAAmB,EAAE,EAAsB;IAC9E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,EAAE,CAAC,KAAK,CAAC,CAAC;KACX;AACH,CAAC;AAJD,8CAIC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAI,MAAiC,EAAE,EAAsB;IAC7F,IAAI,MAAM,IAAI,IAAI,EAAE;QAClB,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE;YACtB,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SAC/B;aAAM;YACL,EAAE,CAAC,MAAM,CAAC,CAAC;SACZ;KACF;AACH,CAAC;AARD,gDAQC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAI,MAAmB,EAAE,EAAyB;IAC9E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;YACb,OAAO,KAAK,CAAC;SACd;KACF;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AARD,wCAQC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAI,MAAmB,EAAE,EAAyB;IAChF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;YACb,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AARD,4CAQC"}

package/src/lib/iterable/iterable.map.d.ts

@@ -0,0 +1,8 @@
+/**
+ * map utility function for an iterable that maps and places the results into an array.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+export declare function mapIterable<I, O>(values: Iterable<I>, fn: (value: I) => O): O[];

package/src/lib/iterable/iterable.map.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapIterable = void 0;
+const iterable_1 = require("./iterable");
+/**
+ * map utility function for an iterable that maps and places the results into an array.
+ *
+ * @param values
+ * @param fn
+ * @returns
+ */
+function mapIterable(values, fn) {
+    const mapping = [];
+    (0, iterable_1.forEachInIterable)(values, (value) => mapping.push(fn(value)));
+    return mapping;
+}
+exports.mapIterable = mapIterable;
+//# sourceMappingURL=iterable.map.js.map

package/src/lib/iterable/iterable.map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable.map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/iterable/iterable.map.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAE/C;;;;;;GAMG;AACH,SAAgB,WAAW,CAAO,MAAmB,EAAE,EAAmB;IACxE,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAA,4BAAiB,EAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC;AACjB,CAAC;AAJD,kCAIC"}

package/src/lib/iterate.js

@@ -6,7 +6,7 @@ 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* () {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
         for (let i = 0; i < values.length; i += 1) {
             yield useFn(values[i]);
         }

package/src/lib/key.d.ts

@@ -1,4 +1,4 @@
-import { Maybe } from "./value";
+import { Maybe } from "./value/maybe";
 /**
  * A key made up of either a string or number value.
  */

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

@@ -0,0 +1,2 @@
+export * from './map';
+export * from './map.intersection';

package/src/lib/map/index.js

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

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

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

package/src/lib/map/map.d.ts

@@ -0,0 +1,9 @@
+import { Maybe } from "../value";
+export declare type MapFn<A, B> = (value: A) => B;
+export declare type MapStringFn<T> = MapFn<string, T>;
+/**
+ *
+ * @param maps
+ * @returns
+ */
+export declare function combineMaps<K, T>(...maps: Maybe<Map<K, T>>[]): Map<K, T>;