@dereekb/util 8.8.1 → 8.10.0

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

@@ -1,9 +1,14 @@
+import { ArrayOrValue } from '../array/array';
 import { PromiseOrValue } from '../promise/promise';
-import { Maybe } from './maybe.type';
+import { Maybe, MaybeNot } from './maybe.type';
 /**
  * Converts one value to another.
  */
 export declare type MapFunction<I, O> = (input: I) => O;
+/**
+ * MapFunction with the same input as output.
+ */
+export declare type MapSameFunction<I> = MapFunction<I, I>;
 /**
  * Converts a MapFunction into one that returns a promise.
  */
@@ -23,6 +28,7 @@ export declare type ApplyMapFunctionWithOptions<I, O, C> = (input: I, target?: M
 export declare function mapArrayFunction<I, O>(mapFunction: MapFunction<I, O>): MapArrayFunction<MapFunction<I, O>>;
 export declare const MAP_IDENTITY: (input: unknown) => unknown;
 export declare function mapIdentityFunction<T>(): MapFunction<T, T>;
+export declare function isMapIdentityFunction(fn: unknown): fn is typeof MAP_IDENTITY;
 export declare type MapFunctionOutputPair<O, I = unknown> = {
     input: I;
     output: O;
@@ -47,3 +53,25 @@ 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>;
+/**
+ * Chains together multiple MapSameFunctions in the same order. Functions that are not defined are ignored.
+ *
+ * @param fns
+ */
+export declare function chainMapSameFunctions<I>(input: ArrayOrValue<Maybe<MapSameFunction<I>>>): MapSameFunction<I>;
+/**
+ * Creates a single function that chains the two map functions together, if apply is true or undefined.
+ *
+ * If apply is false, or the second map function is not defined, returns the first map function.
+ *
+ * @param a
+ * @param b
+ */
+export declare function chainMapFunction<I>(a: MapSameFunction<I>, b: Maybe<MapSameFunction<I>>): MapSameFunction<I>;
+export declare function chainMapFunction<I>(a: MapSameFunction<I>, b: Maybe<MapSameFunction<I>>, apply?: boolean): MapSameFunction<I>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: MapFunction<O, B>): MapFunction<I, B>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: MaybeNot): MapFunction<I, O>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: Maybe<MapFunction<O, B>>, apply: false): MapFunction<I, O>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: MaybeNot, apply: true): MapFunction<I, O>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: MapFunction<O, B>, apply: true): MapFunction<I, B>;
+export declare function chainMapFunction<I, O, B>(a: MapFunction<I, O>, b: Maybe<MapFunction<O, B>>, apply: boolean): MapFunction<I, O> | MapFunction<I, B>;

package/src/lib/value/map.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapFunctionOutput = exports.wrapMapFunctionOutput = exports.mapFunctionOutputPair = exports.mapIdentityFunction = exports.MAP_IDENTITY = exports.mapArrayFunction = void 0;
+exports.chainMapFunction = exports.chainMapSameFunctions = exports.mapFunctionOutput = exports.wrapMapFunctionOutput = exports.mapFunctionOutputPair = exports.isMapIdentityFunction = exports.mapIdentityFunction = exports.MAP_IDENTITY = exports.mapArrayFunction = void 0;
+const array_1 = require("../array/array");
+const array_value_1 = require("../array/array.value");
 const build_1 = require("./build");
 function mapArrayFunction(mapFunction) {
     return (input) => input.map(mapFunction);
@@ -12,6 +14,10 @@ function mapIdentityFunction() {
     return exports.MAP_IDENTITY;
 }
 exports.mapIdentityFunction = mapIdentityFunction;
+function isMapIdentityFunction(fn) {
+    return fn === exports.MAP_IDENTITY;
+}
+exports.isMapIdentityFunction = isMapIdentityFunction;
 /**
  * Wraps a MapFunction to instead provide the input and output values.
  *
@@ -49,4 +55,39 @@ function mapFunctionOutput(output, input) {
     });
 }
 exports.mapFunctionOutput = mapFunctionOutput;
+// MARK: Chaining
+/**
+ * Chains together multiple MapSameFunctions in the same order. Functions that are not defined are ignored.
+ *
+ * @param fns
+ */
+function chainMapSameFunctions(input) {
+    const fns = (0, array_value_1.filterMaybeValues)((0, array_1.asArray)(input).filter((x) => !isMapIdentityFunction(x))); // remove all identify functions too
+    let fn;
+    switch (fns.length) {
+        case 0:
+            fn = mapIdentityFunction();
+            break;
+        case 1:
+            fn = fns[0];
+            break;
+        default:
+            fn = fns[0];
+            for (let i = 1; i < fns.length; i += 1) {
+                fn = chainMapFunction(fn, fns[i]);
+            }
+            break;
+    }
+    return fn;
+}
+exports.chainMapSameFunctions = chainMapSameFunctions;
+function chainMapFunction(a, b, apply = true) {
+    if (apply && b != null) {
+        return (x) => b(a(x));
+    }
+    else {
+        return a;
+    }
+}
+exports.chainMapFunction = chainMapFunction;
 //# sourceMappingURL=map.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/map.ts"],"names":[],"mappings":";;;AACA,mCAAgC;AA8BhC,SAAgB,gBAAgB,CAAO,WAA8B;IACnE,OAAO,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAFD,4CAEC;AAEM,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,CAAC;AAAzC,QAAA,YAAY,gBAA6B;AAEtD,SAAgB,mBAAmB;IACjC,OAAO,oBAAiC,CAAC;AAC3C,CAAC;AAFD,kDAEC;AAQD;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAiB,EAAqB;IACzE,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEzB,OAAO;YACL,KAAK;YACL,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AATD,sDASC;AAQD;;;;GAIG;AACH,SAAgB,qBAAqB,CAAgC,EAAqB;IACxF,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC;AALD,sDAKC;AAED,SAAgB,iBAAiB,CAAgC,MAAS,EAAE,KAAQ;IAClF,OAAO,IAAA,aAAK,EAA0B;QACpC,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YACX,CAAC,CAAC,MAAM,GAAG,KAA0C,CAAC;QACxD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAPD,8CAOC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/map.ts"],"names":[],"mappings":";;;AAAA,0CAAuD;AACvD,sDAAyD;AAEzD,mCAAgC;AAmChC,SAAgB,gBAAgB,CAAO,WAA8B;IACnE,OAAO,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAFD,4CAEC;AAEM,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,CAAC;AAAzC,QAAA,YAAY,gBAA6B;AAEtD,SAAgB,mBAAmB;IACjC,OAAO,oBAAiC,CAAC;AAC3C,CAAC;AAFD,kDAEC;AAED,SAAgB,qBAAqB,CAAC,EAAW;IAC/C,OAAO,EAAE,KAAK,oBAAY,CAAC;AAC7B,CAAC;AAFD,sDAEC;AAQD;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAiB,EAAqB;IACzE,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEzB,OAAO;YACL,KAAK;YACL,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AATD,sDASC;AAQD;;;;GAIG;AACH,SAAgB,qBAAqB,CAAgC,EAAqB;IACxF,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC;AALD,sDAKC;AAED,SAAgB,iBAAiB,CAAgC,MAAS,EAAE,KAAQ;IAClF,OAAO,IAAA,aAAK,EAA0B;QACpC,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YACX,CAAC,CAAC,MAAM,GAAG,KAA0C,CAAC;QACxD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAPD,8CAOC;AAED,iBAAiB;AACjB;;;;GAIG;AACH,SAAgB,qBAAqB,CAAI,KAA8C;IACrF,MAAM,GAAG,GAAG,IAAA,+BAAiB,EAAC,IAAA,eAAO,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oCAAoC;IAC5H,IAAI,EAAsB,CAAC;IAE3B,QAAQ,GAAG,CAAC,MAAM,EAAE;QAClB,KAAK,CAAC;YACJ,EAAE,GAAG,mBAAmB,EAAE,CAAC;YAC3B,MAAM;QACR,KAAK,CAAC;YACJ,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,MAAM;QACR;YACE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAEZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;gBACtC,EAAE,GAAG,gBAAgB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aACnC;YACD,MAAM;KACT;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AArBD,sDAqBC;AAkBD,SAAgB,gBAAgB,CAAU,CAAoB,EAAE,CAA2B,EAAE,KAAK,GAAG,IAAI;IACvG,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,EAAE;QACtB,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACvB;SAAM;QACL,OAAO,CAAC,CAAC;KACV;AACH,CAAC;AAND,4CAMC"}

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

@@ -0,0 +1,192 @@
+import { Factory } from '../getter/getter';
+import { NumberPrecision } from '../number/round';
+/**
+ * Latitude value
+ */
+export declare type Latitude = number;
+/**
+ * Longitude value
+ */
+export declare type Longitude = number;
+export declare const MIN_LATITUDE_VALUE = -90;
+export declare const MAX_LATITUDE_VALUE = 90;
+export declare const MIN_LONGITUDE_VALUE = -180;
+export declare const MAX_LONGITUDE_VALUE = 180;
+export interface LatLngPoint {
+    lat: Latitude;
+    lng: Longitude;
+}
+export declare function latLngPoint(lat: Latitude, lng: Longitude): LatLngPoint;
+export declare function isValidLatitude(lat: Latitude): boolean;
+export declare function isValidLongitude(lat: Longitude): boolean;
+export declare function defaultLatLngPoint(): LatLngPoint;
+/**
+ * Returns true if the input point's lat/lng values are within the acceptable values range.
+ *
+ * @param input
+ * @returns
+ */
+export declare function isValidLatLngPoint(input: LatLngPoint): boolean;
+/**
+ * A lat,lng encoded value.
+ */
+export declare type LatLngString = `${Latitude},${Longitude}`;
+export declare type LatLngPrecision = NumberPrecision;
+/**
+ * Creates a LatLngString from the input.
+ *
+ * @param lat
+ * @param lng
+ */
+export declare function latLngString(lat: Latitude, lng?: Longitude): LatLngString;
+export declare function latLngString(latLng: LatLngPoint): LatLngString;
+export declare function latLngString(latLng: LatLngString): LatLngString;
+/**
+ * A lat/lng regex with capture groups for lat and lng.
+ *
+ * Has a max precision of 10, which is easily precise enough for all GPS cases.
+ *
+ * https://stackoverflow.com/questions/3518504/regular-expression-for-matching-latitude-longitude-coordinates
+ */
+export declare const LAT_LNG_PATTERN: RegExp;
+/**
+ * Checks whether or not the input has the expected pattern.
+ *
+ * @param input
+ */
+export declare function isLatLngString(input: string): input is LatLngString;
+/**
+ * 111KM meter preicison, 0 decimal places
+ */
+export declare const LAT_LONG_100KM_PRECISION = 0;
+/**
+ * 11.1KM meter preicison, 1 decimal place
+ */
+export declare const LAT_LONG_10KM_PRECISION = 1;
+/**
+ * 1.11KM meter preicison, 2 decimal places
+ */
+export declare const LAT_LONG_1KM_PRECISION = 2;
+/**
+ * 111 meter preicison, 3 decimal places
+ */
+export declare const LAT_LONG_100M_PRECISION = 3;
+/**
+ * 11.1 meter preicison, 4 decimal places
+ */
+export declare const LAT_LONG_10M_PRECISION = 4;
+/**
+ * 001.11 meter preicison, 5 decimal places
+ */
+export declare const LAT_LONG_1M_PRECISION = 5;
+/**
+ * 011.10 centimeter preicison, 6 decimal places
+ */
+export declare const LAT_LONG_10CM_PRECISION = 6;
+/**
+ * 001.11 centimeter precision, 7 decimal places
+ */
+export declare const LAT_LONG_1CM_PRECISION = 7;
+/**
+ * 001.11 milimeter precision, 8 decimal places
+ */
+export declare const LAT_LONG_1MM_PRECISION = 8;
+/**
+ * 0.1mm precision, 9 decimal places
+ *
+ * "Hey, check out this specific sand grain!"
+ *
+ * https://xkcd.com/2170/
+ */
+export declare const LAT_LONG_GRAINS_OF_SAND_PRECISION = 9;
+/**
+ * Rounds the input latLng value to a given precision.
+ */
+export declare type LatLngPointPrecisionFunction = (latLngPoint: LatLngPoint) => LatLngPoint;
+export declare function latLngPointPrecisionFunction(precision: LatLngPrecision): LatLngPointPrecisionFunction;
+/**
+ * Converts the input to a LatLngString
+ */
+export declare type LatLngStringFunction = ((lat: Latitude | LatLngPoint | LatLngString | string, lng?: Longitude) => LatLngString) & ((latLng: string | LatLngString) => LatLngString) & ((latLng: LatLngPoint) => LatLngString) & ((lat: Latitude, lng?: Longitude) => LatLngString);
+export declare type LatLngStringFunctionConfig = LatLngPointFunctionConfig;
+/**
+ * Creates a LatLngStringFunction
+ *
+ * @param precision
+ * @returns
+ */
+export declare function latLngStringFunction(config?: LatLngStringFunctionConfig): LatLngStringFunction;
+/**
+ * Converts the input to a LatLngPoint
+ */
+export declare type LatLngPointFunction = ((lat: Latitude | LatLngPoint | LatLngString | string, lng?: Longitude) => LatLngPoint) & ((latLng: string | LatLngString) => LatLngPoint) & ((latLng: LatLngPoint) => LatLngPoint) & ((lat: Latitude, lng?: Longitude) => LatLngPoint);
+export interface LatLngPointFunctionConfig {
+    /**
+     * LatLngPrecision to use
+     */
+    precision?: LatLngPrecision;
+    /**
+     * Whether or not to validate and only return valid LatLng values.
+     *
+     * Is true by default.
+     */
+    validate?: boolean;
+    /**
+     * The default LatLngPoint to return.
+     */
+    default?: Factory<LatLngPoint>;
+}
+/**
+ * Creates a LatLngPointFunction
+ *
+ * @param precision
+ * @returns
+ */
+export declare function latLngPointFunction(config?: LatLngPointFunctionConfig): LatLngPointFunction;
+/**
+ * Creates a LatLngPoint from the input latLng string.
+ *
+ * @param latLngString
+ */
+export declare function latLngPointFromString(latLngString: LatLngString | string): LatLngPoint;
+export declare function validLatLngPoint(latLngPoint: LatLngPoint, defaultValue?: Factory<LatLngPoint>): LatLngPoint;
+/**
+ * Returns a valid LatLngPoint by validating the input and returns the input value if it is valid, or a default value that is valid.
+ *
+ * @param latLngPoint
+ */
+export declare type ValidLatLngPointFunction = (latLngPoint: LatLngPoint) => LatLngPoint;
+export declare function validLatLngPointFunction(defaultValue?: Factory<LatLngPoint>): ValidLatLngPointFunction;
+/**
+ * References a latLng using a LatLngPoint
+ */
+export declare type LatLngPointRef = {
+    readonly latLng: LatLngPoint;
+};
+/**
+ * References a latLng using a LatLngString
+ */
+export declare type LatLngStringRef = {
+    readonly latLng: LatLngString;
+};
+/**
+ * An object that references a latLng
+ */
+export declare type LatLngRef = LatLngPointRef | LatLngStringRef;
+/**
+ * A LatLngPointRef with arbitrary data
+ */
+export declare type LatLngDataPoint<T> = LatLngPointRef & {
+    readonly data: T;
+};
+/**
+ * Converts the input value to a LatLngDataPoint
+ */
+export declare type LatLngDataPointFunction<T extends LatLngRef> = (data: T) => LatLngDataPoint<T>;
+/**
+ * Creates a LatLngDataPointFunction
+ *
+ * @param precision
+ * @returns
+ */
+export declare function latLngDataPointFunction<T extends LatLngRef>(config?: LatLngPointFunctionConfig): LatLngDataPointFunction<T>;

package/src/lib/value/point.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latLngDataPointFunction = exports.validLatLngPointFunction = exports.validLatLngPoint = exports.latLngPointFromString = exports.latLngPointFunction = exports.latLngStringFunction = exports.latLngPointPrecisionFunction = exports.LAT_LONG_GRAINS_OF_SAND_PRECISION = exports.LAT_LONG_1MM_PRECISION = exports.LAT_LONG_1CM_PRECISION = exports.LAT_LONG_10CM_PRECISION = exports.LAT_LONG_1M_PRECISION = exports.LAT_LONG_10M_PRECISION = exports.LAT_LONG_100M_PRECISION = exports.LAT_LONG_1KM_PRECISION = exports.LAT_LONG_10KM_PRECISION = exports.LAT_LONG_100KM_PRECISION = exports.isLatLngString = exports.LAT_LNG_PATTERN = exports.latLngString = exports.isValidLatLngPoint = exports.defaultLatLngPoint = exports.isValidLongitude = exports.isValidLatitude = exports.latLngPoint = exports.MAX_LONGITUDE_VALUE = exports.MIN_LONGITUDE_VALUE = exports.MAX_LATITUDE_VALUE = exports.MIN_LATITUDE_VALUE = void 0;
+const round_1 = require("../number/round");
+exports.MIN_LATITUDE_VALUE = -90.0;
+exports.MAX_LATITUDE_VALUE = 90.0;
+exports.MIN_LONGITUDE_VALUE = -180.0;
+exports.MAX_LONGITUDE_VALUE = 180.0;
+function latLngPoint(lat, lng) {
+    return { lat, lng };
+}
+exports.latLngPoint = latLngPoint;
+function isValidLatitude(lat) {
+    return lat >= exports.MIN_LATITUDE_VALUE && lat <= exports.MAX_LATITUDE_VALUE;
+}
+exports.isValidLatitude = isValidLatitude;
+function isValidLongitude(lat) {
+    return lat >= exports.MIN_LONGITUDE_VALUE && lat <= exports.MAX_LONGITUDE_VALUE;
+}
+exports.isValidLongitude = isValidLongitude;
+function defaultLatLngPoint() {
+    return { lat: 0, lng: 0 };
+}
+exports.defaultLatLngPoint = defaultLatLngPoint;
+/**
+ * Returns true if the input point's lat/lng values are within the acceptable values range.
+ *
+ * @param input
+ * @returns
+ */
+function isValidLatLngPoint(input) {
+    return isValidLatitude(input.lat) && isValidLongitude(input.lng);
+}
+exports.isValidLatLngPoint = isValidLatLngPoint;
+function latLngString(lat, lng) {
+    return latLngStringFunction()(lat, lng);
+}
+exports.latLngString = latLngString;
+/**
+ * A lat/lng regex with capture groups for lat and lng.
+ *
+ * Has a max precision of 10, which is easily precise enough for all GPS cases.
+ *
+ * https://stackoverflow.com/questions/3518504/regular-expression-for-matching-latitude-longitude-coordinates
+ */
+exports.LAT_LNG_PATTERN = /(?<lat>^[-+]?(?:[1-8]?\d(?:\.\d{0,10})?|90(?:\.0{0,10})?))\s*,\s*(?<lng>[-+]?(?:180(?:\.0{0,10})?|(?:1[0-7]\d|[1-9]?\d)(?:\.\d{0,10})?))$/;
+/**
+ * Checks whether or not the input has the expected pattern.
+ *
+ * @param input
+ */
+function isLatLngString(input) {
+    return exports.LAT_LNG_PATTERN.test(input);
+}
+exports.isLatLngString = isLatLngString;
+/**
+ * 111KM meter preicison, 0 decimal places
+ */
+exports.LAT_LONG_100KM_PRECISION = 0;
+/**
+ * 11.1KM meter preicison, 1 decimal place
+ */
+exports.LAT_LONG_10KM_PRECISION = 1;
+/**
+ * 1.11KM meter preicison, 2 decimal places
+ */
+exports.LAT_LONG_1KM_PRECISION = 2;
+/**
+ * 111 meter preicison, 3 decimal places
+ */
+exports.LAT_LONG_100M_PRECISION = 3;
+/**
+ * 11.1 meter preicison, 4 decimal places
+ */
+exports.LAT_LONG_10M_PRECISION = 4;
+/**
+ * 001.11 meter preicison, 5 decimal places
+ */
+exports.LAT_LONG_1M_PRECISION = 5;
+/**
+ * 011.10 centimeter preicison, 6 decimal places
+ */
+exports.LAT_LONG_10CM_PRECISION = 6;
+/**
+ * 001.11 centimeter precision, 7 decimal places
+ */
+exports.LAT_LONG_1CM_PRECISION = 7;
+/**
+ * 001.11 milimeter precision, 8 decimal places
+ */
+exports.LAT_LONG_1MM_PRECISION = 8;
+/**
+ * 0.1mm precision, 9 decimal places
+ *
+ * "Hey, check out this specific sand grain!"
+ *
+ * https://xkcd.com/2170/
+ */
+exports.LAT_LONG_GRAINS_OF_SAND_PRECISION = 9;
+function latLngPointPrecisionFunction(precision) {
+    const precisionFunction = (0, round_1.cutValueToPrecisionFunction)(precision);
+    return (latLng) => {
+        const { lat: latInput, lng: lngInput } = latLng;
+        const lat = precisionFunction(latInput);
+        const lng = precisionFunction(lngInput);
+        return { lat, lng };
+    };
+}
+exports.latLngPointPrecisionFunction = latLngPointPrecisionFunction;
+/**
+ * Creates a LatLngStringFunction
+ *
+ * @param precision
+ * @returns
+ */
+function latLngStringFunction(config) {
+    const fn = latLngPointFunction(config);
+    return (lat, lng) => {
+        const latLng = fn(lat, lng);
+        return `${latLng.lat},${latLng.lng}`;
+    };
+}
+exports.latLngStringFunction = latLngStringFunction;
+/**
+ * Creates a LatLngPointFunction
+ *
+ * @param precision
+ * @returns
+ */
+function latLngPointFunction(config) {
+    const { validate, default: defaultValue, precision = exports.LAT_LONG_1MM_PRECISION } = config !== null && config !== void 0 ? config : {};
+    const precisionFunction = latLngPointPrecisionFunction(precision);
+    const validateFunction = validLatLngPointFunction(defaultValue);
+    const mapFn = validate !== false ? (input) => precisionFunction(validateFunction(input)) : precisionFunction;
+    return (lat, lng) => {
+        let latLng;
+        const latType = typeof lat;
+        if (latType === 'string') {
+            latLng = latLngPointFromString(lat);
+        }
+        else if (latType === 'object') {
+            latLng = lat;
+        }
+        else if (lng != null) {
+            latLng = latLngPoint(lat, lng);
+        }
+        else {
+            throw new Error(`Invalid lat/lng input "${lat},${lng}"`);
+        }
+        return mapFn(latLng); // round to a given precision
+    };
+}
+exports.latLngPointFunction = latLngPointFunction;
+/**
+ * Creates a LatLngPoint from the input latLng string.
+ *
+ * @param latLngString
+ */
+function latLngPointFromString(latLngString) {
+    const [latString, lngString] = latLngString.split(',');
+    const lat = Number(latString) || 0; // default lat and lng to 0 if not valid.
+    const lng = Number(lngString) || 0;
+    return { lat, lng };
+}
+exports.latLngPointFromString = latLngPointFromString;
+function validLatLngPoint(latLngPoint, defaultValue) {
+    return validLatLngPointFunction(defaultValue)(latLngPoint);
+}
+exports.validLatLngPoint = validLatLngPoint;
+function validLatLngPointFunction(defaultValue = defaultLatLngPoint) {
+    return (latLngPoint) => (isValidLatLngPoint(latLngPoint) ? latLngPoint : defaultValue());
+}
+exports.validLatLngPointFunction = validLatLngPointFunction;
+/**
+ * Creates a LatLngDataPointFunction
+ *
+ * @param precision
+ * @returns
+ */
+function latLngDataPointFunction(config) {
+    const fn = latLngPointFunction(config);
+    return (data) => {
+        const latLng = fn(data.latLng);
+        return {
+            latLng,
+            data
+        };
+    };
+}
+exports.latLngDataPointFunction = latLngDataPointFunction;
+//# sourceMappingURL=point.js.map

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

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

package/test/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [8.10.0](https://github.com/dereekb/dbx-components/compare/v8.9.1-dev...v8.10.0) (2022-07-04)
+
+
+
+## [8.9.1](https://github.com/dereekb/dbx-components/compare/v8.9.0-dev...v8.9.1) (2022-06-30)
+
+
+
+# [8.9.0](https://github.com/dereekb/dbx-components/compare/v8.8.1-dev...v8.9.0) (2022-06-30)
+
+
+
 ## [8.8.1](https://github.com/dereekb/dbx-components/compare/v8.8.0-dev...v8.8.1) (2022-06-29)
 
 

package/test/package.json

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

package/src/lib/string.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/string.ts"],"names":[],"mappings":";;;AAkBA,SAAgB,qBAAqB,CAAC,KAAoB;IACxD,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAFD,sDAEC;AAID,SAAgB,yBAAyB,CAAc,KAA8B,EAAE,QAA8B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAiB;IAC3I,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAHD,8DAGC;AAED,SAAgB,8BAA8B,CAAC,KAAkC;IAC/E,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAFD,wEAEC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAqB,EAAE,MAAM,GAAG,GAAG;IACvE,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;KACrD;SAAM;QACL,OAAO,SAAS,CAAC;KAClB;AACH,CAAC;AAND,sDAMC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAFD,sDAEC"}