@dereekb/util 7.2.0 → 7.5.0

package/src/lib/set/set.maybe.d.ts

@@ -1,5 +1,5 @@
 import { ArrayOrValue } from './../array/array';
-import { Maybe } from '../value/maybe';
+import { Maybe } from '../value/maybe.type';
 /**
  * Creates a Maybe Set with the input.
  *

package/src/lib/storage/storage.memory.d.ts

@@ -1,4 +1,4 @@
-import { Maybe } from '../value/maybe';
+import { Maybe } from '../value/maybe.type';
 import { StorageObject } from './storage.object';
 export declare class MemoryStorageInstance implements StorageObject {
     private _length;

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

@@ -1,4 +1,4 @@
-import { Maybe } from '../value/maybe';
+import { Maybe } from '../value/maybe.type';
 import { StoredDataStorageKey } from './storage';
 /**
  * Limited Class/Interface for storing string values synchronously.

package/src/lib/storage/storage.object.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorageObjectUtility = exports.FullStorageObject = exports.StorageObject = exports.SimpleStorageObject = void 0;
-const array_1 = require("../array");
+const array_number_1 = require("../array/array.number");
+const maybe_1 = require("../value/maybe");
 /**
  * Limited Class/Interface for storing string values synchronously.
  */
@@ -24,9 +25,9 @@ class StorageObjectUtility {
         const length = storageObject.length;
         let result;
         if (length > 0) {
-            result = (0, array_1.range)({ start: 0, end: length })
+            result = (0, array_number_1.range)({ start: 0, end: length })
                 .map((x) => storageObject.key(x))
-                .filter(array_1.filterMaybeValuesFn);
+                .filter(maybe_1.hasNonNullValue);
             if (prefix) {
                 result = result.filter((x) => x.startsWith(prefix));
             }

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

@@ -1 +1 @@
-{"version":3,"file":"storage.object.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/storage/storage.object.ts"],"names":[],"mappings":";;;AACA,oCAAsD;AAGtD;;GAEG;AACH,MAAsB,mBAAmB;CAMxC;AAND,kDAMC;AAED;;;;GAIG;AACH,MAAsB,aAAc,SAAQ,mBAAmB;CAS9D;AATD,sCASC;AAED,MAAsB,iBAAkB,SAAQ,aAAa;CAM5D;AAND,8CAMC;AAED,MAAa,oBAAoB;IAC/B,MAAM,CAAC,wBAAwB,CAAC,aAA4B,EAAE,MAAe;QAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QACpC,IAAI,MAA8B,CAAC;QAEnC,IAAI,MAAM,GAAG,CAAC,EAAE;YACd,MAAM,GAAG,IAAA,aAAK,EAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAChC,MAAM,CAAC,2BAAmB,CAAC,CAAC;YAE/B,IAAI,MAAM,EAAE;gBACV,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;aACrD;SACF;aAAM;YACL,MAAM,GAAG,EAAE,CAAC;SACb;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAnBD,oDAmBC"}
+{"version":3,"file":"storage.object.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/storage/storage.object.ts"],"names":[],"mappings":";;;AACA,wDAA8C;AAE9C,0CAAiD;AAEjD;;GAEG;AACH,MAAsB,mBAAmB;CAMxC;AAND,kDAMC;AAED;;;;GAIG;AACH,MAAsB,aAAc,SAAQ,mBAAmB;CAS9D;AATD,sCASC;AAED,MAAsB,iBAAkB,SAAQ,aAAa;CAM5D;AAND,8CAMC;AAED,MAAa,oBAAoB;IAC/B,MAAM,CAAC,wBAAwB,CAAC,aAA4B,EAAE,MAAe;QAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QACpC,IAAI,MAA8B,CAAC;QAEnC,IAAI,MAAM,GAAG,CAAC,EAAE;YACd,MAAM,GAAG,IAAA,oBAAK,EAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAChC,MAAM,CAAC,uBAAe,CAAC,CAAC;YAE3B,IAAI,MAAM,EAAE;gBACV,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;aACrD;SACF;aAAM;YACL,MAAM,GAAG,EAAE,CAAC;SACb;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAnBD,oDAmBC"}

package/src/lib/string.d.ts

@@ -1,5 +1,5 @@
 import { MapFunction } from './value/map';
-import { Maybe } from './value/maybe';
+import { Maybe } from './value/maybe.type';
 export declare type MapStringFunction<T> = MapFunction<string, T>;
 /**
  * Represents a string that is made up of comma-separated values.

package/src/lib/tree/tree.expand.d.ts

@@ -1,5 +1,5 @@
 import { TreeNode, TreeNodeWithoutChildren } from './tree';
-import { Maybe } from '../value/maybe';
+import { Maybe } from '../value/maybe.type';
 /**
  * ExpandTreeFunction configuration.
  */

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

@@ -1,6 +1,8 @@
 export * from './build';
 export * from './equal';
 export * from './map';
+export * from './maybe.type';
 export * from './maybe';
 export * from './modifier';
 export * from './url';
+export * from './use';

package/src/lib/value/index.js

@@ -4,7 +4,9 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./build"), exports);
 tslib_1.__exportStar(require("./equal"), exports);
 tslib_1.__exportStar(require("./map"), exports);
+tslib_1.__exportStar(require("./maybe.type"), exports);
 tslib_1.__exportStar(require("./maybe"), exports);
 tslib_1.__exportStar(require("./modifier"), exports);
 tslib_1.__exportStar(require("./url"), exports);
+tslib_1.__exportStar(require("./use"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,kDAAwB;AACxB,gDAAsB;AACtB,kDAAwB;AACxB,qDAA2B;AAC3B,gDAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,kDAAwB;AACxB,gDAAsB;AACtB,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,gDAAsB;AACtB,gDAAsB"}

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

@@ -1,4 +1,4 @@
-import { Maybe } from './maybe';
+import { Maybe } from './maybe.type';
 /**
  * Converts one value to another.
  */
@@ -39,3 +39,7 @@ export declare type MapFunctionOutput<O extends object, I = unknown> = O & {
  */
 export declare function wrapMapFunctionOutput<O extends object, I = unknown>(fn: MapFunction<I, O>): MapFunction<I, MapFunctionOutput<O, I>>;
 export declare function mapFunctionOutput<O extends object, I = unknown>(output: O, input: I): MapFunctionOutput<O, I>;
+/**
+ * A map function that derives a boolean from the input.
+ */
+export declare type DecisionFunction<I> = MapFunction<I, boolean>;

package/src/lib/value/maybe.d.ts

@@ -1,62 +1,40 @@
-import { NonNever } from 'ts-essentials';
-/**
- * A null/undefined value.
- */
-export declare type MaybeNot = null | undefined;
-/**
- * A non-null/undefined value.
- */
-export declare type MaybeSo<T = unknown> = T extends MaybeNot ? never : T;
-/**
- * A value that might exist, or be null/undefined instead.
- */
-export declare type Maybe<T> = T | MaybeNot;
-/**
- * Turns all key values in an object into a Maybe value.
- */
-export declare type MaybeMap<T extends object> = NonNever<{
-    [K in keyof T]: T[K] extends MaybeNot ? never : Maybe<T[K]>;
-}>;
+import { Maybe, MaybeNot, MaybeSo } from './maybe.type';
 /**
  * Returns true if the value is not null or undefined.
  *
  * @param value
  * @returns
  */
-export declare function hasNonNullValue<T>(value: Maybe<T>): value is T;
-export declare function hasNonNullValue(value: true): true;
-export declare function hasNonNullValue(value: false): true;
-export declare function hasNonNullValue(value: number): true;
-export declare function hasNonNullValue(value: ''): true;
-export declare function hasNonNullValue(value: null): false;
-export declare function hasNonNullValue(value: undefined): false;
+export declare function hasNonNullValue<T = unknown>(value: Maybe<T>): value is MaybeSo<T>;
+/**
+ * Whether or not the input has any value.
+ *
+ * Will return false for:
+ * - empty iterables
+ * - empty strings
+ * - null/undefined values.
+ *
+ * NaN has undefined behavior.
+ */
+export declare function hasValueOrNotEmpty<T = unknown>(value: Maybe<T>): value is MaybeSo<T>;
 /**
  * Whether or not the input has any value.
  *
  * Will return false for:
- * - empty arrays
+ * - empty iterables
  * - empty strings
+ * - empty objects (no keys)
  * - null/undefined values.
  *
  * NaN has undefined behavior.
  */
-export declare function hasValueOrNotEmpty<T>(value: T): boolean;
-export declare function hasValueOrNotEmpty(value: true): true;
-export declare function hasValueOrNotEmpty(value: false): true;
-export declare function hasValueOrNotEmpty(value: number): true;
-export declare function hasValueOrNotEmpty(value: ''): false;
-export declare function hasValueOrNotEmpty(value: null): false;
-export declare function hasValueOrNotEmpty(value: undefined): false;
+export declare function hasValueOrNotEmptyObject<T = unknown>(value: Maybe<T>): value is MaybeSo<T>;
 /**
  * Returns true if the input value is a non-empty string or is true.
  *
  * @param value
  * @returns
  */
-export declare function isStringOrTrue(value: ''): false;
-export declare function isStringOrTrue(value: false): false;
-export declare function isStringOrTrue(value: null): false;
-export declare function isStringOrTrue(value: undefined): false;
 export declare function isStringOrTrue(value: Maybe<string | boolean>): boolean;
 /**
  * Returns true if the input is not MaybeNot and not an empty string.
@@ -64,9 +42,6 @@ export declare function isStringOrTrue(value: Maybe<string | boolean>): boolean;
  * @param value
  * @returns
  */
-export declare function isNotNullOrEmptyString<T>(value: ''): false;
-export declare function isNotNullOrEmptyString<T>(value: null): false;
-export declare function isNotNullOrEmptyString<T>(value: undefined): false;
 export declare function isNotNullOrEmptyString<T>(value: Maybe<MaybeNot | '' | T>): value is MaybeSo<T>;
 /**
  * True if the input is MaybeNot.

package/src/lib/value/maybe.js

@@ -1,23 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSameNonNullValue = exports.isDefinedAndNotFalse = exports.isMaybeNotOrTrue = exports.isMaybeSo = exports.isMaybeNot = exports.isNotNullOrEmptyString = exports.isStringOrTrue = exports.hasValueOrNotEmpty = exports.hasNonNullValue = void 0;
+exports.isSameNonNullValue = exports.isDefinedAndNotFalse = exports.isMaybeNotOrTrue = exports.isMaybeSo = exports.isMaybeNot = exports.isNotNullOrEmptyString = exports.isStringOrTrue = exports.hasValueOrNotEmptyObject = exports.hasValueOrNotEmpty = exports.hasNonNullValue = void 0;
+const iterable_1 = require("../iterable/iterable");
+const object_1 = require("../object/object");
+/**
+ * Returns true if the value is not null or undefined.
+ *
+ * @param value
+ * @returns
+ */
 function hasNonNullValue(value) {
     return value != null;
 }
 exports.hasNonNullValue = hasNonNullValue;
+/**
+ * Whether or not the input has any value.
+ *
+ * Will return false for:
+ * - empty iterables
+ * - empty strings
+ * - null/undefined values.
+ *
+ * NaN has undefined behavior.
+ */
 function hasValueOrNotEmpty(value) {
-    if (Array.isArray(value)) {
-        return value.length > 0;
+    if ((0, iterable_1.isIterable)(value, true)) {
+        return !(0, iterable_1.isEmptyIterable)(value);
     }
     else {
-        return value != null && value !== '';
+        return isNotNullOrEmptyString(value);
     }
 }
 exports.hasValueOrNotEmpty = hasValueOrNotEmpty;
+/**
+ * Whether or not the input has any value.
+ *
+ * Will return false for:
+ * - empty iterables
+ * - empty strings
+ * - empty objects (no keys)
+ * - null/undefined values.
+ *
+ * NaN has undefined behavior.
+ */
+function hasValueOrNotEmptyObject(value) {
+    if ((0, iterable_1.isIterable)(value, true)) {
+        return !(0, iterable_1.isEmptyIterable)(value);
+    }
+    else if (isNotNullOrEmptyString(value)) {
+        return typeof value === 'object' ? !(0, object_1.objectHasNoKeys)(value) : true;
+    }
+    else {
+        return false;
+    }
+}
+exports.hasValueOrNotEmptyObject = hasValueOrNotEmptyObject;
+/**
+ * Returns true if the input value is a non-empty string or is true.
+ *
+ * @param value
+ * @returns
+ */
 function isStringOrTrue(value) {
     return Boolean(value || value !== '');
 }
 exports.isStringOrTrue = isStringOrTrue;
+/**
+ * Returns true if the input is not MaybeNot and not an empty string.
+ *
+ * @param value
+ * @returns
+ */
 function isNotNullOrEmptyString(value) {
     return value != null && value !== '';
 }

package/src/lib/value/maybe.js.map

@@ -1 +1 @@
-{"version":3,"file":"maybe.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/maybe.ts"],"names":[],"mappings":";;;AAqCA,SAAgB,eAAe,CAAI,KAAe;IAChD,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,0CAEC;AAmBD,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;KACzB;SAAM;QACL,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;KACtC;AACH,CAAC;AAND,gDAMC;AAaD,SAAgB,cAAc,CAAC,KAA8B;IAC3D,OAAO,OAAO,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC;AAFD,wCAEC;AAYD,SAAgB,sBAAsB,CAAI,KAA+B;IACvE,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;AACvC,CAAC;AAFD,wDAEC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,gCAEC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,KAAe;IAC1C,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,8BAEC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AACzC,CAAC;AAFD,4CAEC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AAC1C,CAAC;AAFD,oDAEC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAI,CAAW,EAAE,CAAW;IAC5D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC;AAFD,gDAEC"}
+{"version":3,"file":"maybe.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/maybe.ts"],"names":[],"mappings":";;;AAAA,mDAAmE;AACnE,6CAAmD;AAGnD;;;;;GAKG;AACH,SAAgB,eAAe,CAAc,KAAe;IAC1D,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,0CAEC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAc,KAAe;IAC7D,IAAI,IAAA,qBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,EAAE;QAC3B,OAAO,CAAC,IAAA,0BAAe,EAAC,KAAK,CAAC,CAAC;KAChC;SAAM;QACL,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;KACtC;AACH,CAAC;AAND,gDAMC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,wBAAwB,CAAc,KAAe;IACnE,IAAI,IAAA,qBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,EAAE;QAC3B,OAAO,CAAC,IAAA,0BAAe,EAAC,KAAK,CAAC,CAAC;KAChC;SAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE;QACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAA,wBAAe,EAAC,KAA0B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;KACxF;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AARD,4DAQC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,KAA8B;IAC3D,OAAO,OAAO,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC;AAFD,wCAEC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAI,KAA+B;IACvE,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;AACvC,CAAC;AAFD,wDAEC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,gCAEC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,KAAe;IAC1C,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,8BAEC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AACzC,CAAC;AAFD,4CAEC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AAC1C,CAAC;AAFD,oDAEC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAI,CAAW,EAAE,CAAW;IAC5D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC;AAFD,gDAEC"}

package/src/lib/value/maybe.type.d.ts

@@ -0,0 +1,19 @@
+import { NonNever } from 'ts-essentials';
+/**
+ * A null/undefined value.
+ */
+export declare type MaybeNot = null | undefined;
+/**
+ * A non-null/undefined value.
+ */
+export declare type MaybeSo<T = unknown> = T extends MaybeNot ? never : T;
+/**
+ * A value that might exist, or be null/undefined instead.
+ */
+export declare type Maybe<T> = T | MaybeNot;
+/**
+ * Turns all key values in an object into a Maybe value.
+ */
+export declare type MaybeMap<T extends object> = NonNever<{
+    [K in keyof T]: T[K] extends MaybeNot ? never : Maybe<T[K]>;
+}>;

package/src/lib/value/maybe.type.js

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

package/src/lib/value/maybe.type.js.map

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

package/src/lib/value/modifier.d.ts

@@ -1,5 +1,5 @@
 import { ArrayOrValue } from '../array';
-import { Maybe } from './maybe';
+import { Maybe } from './maybe.type';
 /**
  * Modifier key
  */

package/src/lib/value/use.d.ts

@@ -0,0 +1,22 @@
+import { GetterOrValue } from '../getter';
+import { MapFunction } from './map';
+import { Maybe } from './maybe.type';
+/**
+ * A map function with the intent of using the input value, and returning another value.
+ */
+export declare type UseValue<I, O = void> = MapFunction<I, O>;
+export declare function useValue<I, O = void>(input: Maybe<I>, use: UseValue<I, O>, defaultValue?: Maybe<GetterOrValue<O>>): Maybe<O>;
+export declare type UseFunction<I> = MappedUseFunction<I, I>;
+export declare type MappedUseFunction<A, I> = <O = void>(input: Maybe<A>, use: UseValue<I, O>, defaultValue?: Maybe<GetterOrValue<O>>) => Maybe<O>;
+/**
+ * Creates a MappedUseFunction.
+ */
+export declare function mappedUseFunction<A, I>(map: MapFunction<A, Maybe<I>>): MappedUseFunction<A, I>;
+/**
+ * Runs a pre-determined function on the input to return a value.
+ */
+export declare type UseContextFunction<I> = <O>(input: Maybe<I>) => Maybe<O>;
+/**
+ * Creates a UseContextFunction.
+ */
+export declare function useContextFunction<I, O>(use: UseValue<I, O>, defaultValue?: GetterOrValue<O>): UseContextFunction<I>;

package/src/lib/value/use.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useContextFunction = exports.mappedUseFunction = exports.useValue = void 0;
+const getter_1 = require("../getter");
+function useValue(input, use, defaultValue) {
+    let result;
+    if (input != null) {
+        result = use(input);
+    }
+    else {
+        result = (0, getter_1.getValueFromGetter)(defaultValue);
+    }
+    return result;
+}
+exports.useValue = useValue;
+/**
+ * Creates a MappedUseFunction.
+ */
+function mappedUseFunction(map) {
+    return ((input, useFn, defaultValue) => {
+        return useValue(input, ((value) => useValue(map(value), useFn, defaultValue)), defaultValue);
+    });
+}
+exports.mappedUseFunction = mappedUseFunction;
+/**
+ * Creates a UseContextFunction.
+ */
+function useContextFunction(use, defaultValue) {
+    return ((input) => {
+        let result;
+        if (input != null) {
+            result = use(input);
+        }
+        else {
+            result = (0, getter_1.getValueFromGetter)(defaultValue);
+        }
+        return result;
+    });
+}
+exports.useContextFunction = useContextFunction;
+//# sourceMappingURL=use.js.map

package/src/lib/value/use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/use.ts"],"names":[],"mappings":";;;AAAA,sCAA8D;AAU9D,SAAgB,QAAQ,CAAc,KAAe,EAAE,GAAmB,EAAE,YAAsC;IAChH,IAAI,MAAgB,CAAC;IAErB,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAa,CAAC;KACjC;SAAM;QACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;KAC3C;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAVD,4BAUC;AAKD;;GAEG;AACH,SAAgB,iBAAiB,CAAO,GAA6B;IACnE,OAAO,CAAC,CAAW,KAAe,EAAE,KAAqB,EAAE,YAAsC,EAAE,EAAE;QACnG,OAAO,QAAQ,CAAO,KAAK,EAAE,CAAC,CAAC,KAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAmB,EAAE,YAAY,CAAC,CAAC;IAC1H,CAAC,CAA4B,CAAC;AAChC,CAAC;AAJD,8CAIC;AAOD;;GAEG;AACH,SAAgB,kBAAkB,CAAO,GAAmB,EAAE,YAA+B;IAC3F,OAAO,CAAC,CAAC,KAAe,EAAE,EAAE;QAC1B,IAAI,MAAgB,CAAC;QAErB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;SACrB;aAAM;YACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;SAC3C;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAA0B,CAAC;AAC9B,CAAC;AAZD,gDAYC"}

package/test/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [7.5.0](https://github.com/dereekb/dbx-components/compare/v7.4.0-dev...v7.5.0) (2022-06-08)
+
+
+
+# [7.4.0](https://github.com/dereekb/dbx-components/compare/v7.3.0-dev...v7.4.0) (2022-06-08)
+
+
+
+# [7.3.0](https://github.com/dereekb/dbx-components/compare/v7.2.0-dev...v7.3.0) (2022-06-08)
+
+
+
 # [7.2.0](https://github.com/dereekb/dbx-components/compare/v7.1.0-dev...v7.2.0) (2022-06-06)
 
 

package/test/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/util/test",
-  "version": "7.2.0",
+  "version": "7.5.0",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "dependencies": {},
   "peerDependencies": {
-    "@dereekb/util": "7.2.0",
+    "@dereekb/util": "7.5.0",
     "make-error": "^1.3.0",
     "ts-essentials": "^9.1.2",
     "extra-set": "^2.2.11",