@dereekb/util 13.15.0 → 13.16.0

package/index.cjs.js

@@ -385,7 +385,7 @@ function _unsupported_iterable_to_array$B(o, minLen) {
  * @throws {Error} If input is not an array.
  */ function wrapTuples(input) {
     if (!Array.isArray(input)) {
-        throw new Error('Input is not an array/tuple...');
+        throw new TypeError('Input is not an array/tuple...');
     }
     var result;
     // check if the first item is an array. Tuples can contain arrays as the first value.
@@ -470,7 +470,7 @@ function _unsupported_iterable_to_array$A(o, minLen) {
  * @dbxUtilTags array, convert, ensure, normalize, maybe, nullish
  * @dbxUtilRelated convert-maybe-to-non-empty-array, convert-to-array, as-array
  */ function convertMaybeToArray(arrayOrValue) {
-    return arrayOrValue != null ? convertToArray(arrayOrValue) : [];
+    return arrayOrValue == null ? [] : convertToArray(arrayOrValue);
 }
 /**
  * Alias for {@link convertMaybeToArray}. Converts a maybe value or array into an array, returning an empty array for nullish input.
@@ -1075,9 +1075,9 @@ function _unsupported_iterable_to_array$z(o, minLen) {
  * @param values - The values to filter.
  * @returns Intersection between the input values and the reference set.
  */ function keepFromSetCopy(set, values) {
-    return values != null ? filterValuesToSet(asIterable(values), function(x) {
+    return values == null ? new Set() : filterValuesToSet(asIterable(values), function(x) {
         return set.has(x);
-    }) : new Set();
+    });
 }
 /**
  * Filters the array to only include values that exist in the given set.
@@ -1274,15 +1274,15 @@ function _unsupported_iterable_to_array$z(o, minLen) {
     var set;
     if (config.keysToFind != null) {
         set = asSet(config.keysToFind);
-    } else if (config.valuesToFind != null) {
-        set = readKeysSetFrom(readKey, config.valuesToFind);
-    } else {
+    } else if (config.valuesToFind == null) {
         set = new Set();
+    } else {
+        set = readKeysSetFrom(readKey, config.valuesToFind);
     }
     var filterFn = setHasValueFunction(set, exclude);
     return values.filter(function(x) {
         var key = readKey(x);
-        return key != null ? filterFn(key) : exclude;
+        return key == null ? exclude : filterFn(key);
     });
 }
 /**
@@ -1838,12 +1838,12 @@ function _type_of$l(obj) {
  */ function filterMaybeArrayFunction(filterFn) {
     return function(values) {
         var result;
-        if (values != null) {
+        if (values == null) {
+            result = [];
+        } else {
             result = values.filter(function(v, i, arr) {
                 return filterFn(v, i, arr);
             });
-        } else {
-            result = [];
         }
         return result;
     };
@@ -2193,7 +2193,7 @@ function _unsupported_iterable_to_array$x(o, minLen) {
  * @param readKey - Function to extract a key from a value.
  * @returns Flat array of resolved non-null keys.
  */ function readKeysFromFilterUniqueFunctionAdditionalKeysInput(additionalKeysInput, readKey) {
-    return filterMaybeArrayValues(additionalKeysInput != null ? Array.isArray(additionalKeysInput) ? additionalKeysInput : readKeysFromFilterUniqueFunctionAdditionalKeys(additionalKeysInput, readKey) : []);
+    return filterMaybeArrayValues(additionalKeysInput == null ? [] : Array.isArray(additionalKeysInput) ? additionalKeysInput : readKeysFromFilterUniqueFunctionAdditionalKeys(additionalKeysInput, readKey));
 }
 /**
  * Reads keys from a {@link FilterUniqueFunctionAdditionalKeys} object by combining explicit keys with keys derived from values.
@@ -3468,12 +3468,12 @@ function makeValuesGroupMap(values, groupKeyFn) {
         values.forEach(function(x) {
             var key = groupKeyFn(x);
             var array = map.get(key);
-            if (array != null) {
-                array.push(x);
-            } else {
+            if (array == null) {
                 map.set(key, [
                     x
                 ]);
+            } else {
+                array.push(x);
             }
         });
     }
@@ -3773,7 +3773,7 @@ function _unsupported_iterable_to_array$s(o, minLen) {
         var selectedValuesSet = new Set(selectedValues);
         return function(value) {
             var key = readKey(value);
-            return key != null ? selectedValuesSet.has(key) : defaultIfKeyNull;
+            return key == null ? defaultIfKeyNull : selectedValuesSet.has(key);
         };
     };
 }
@@ -4654,14 +4654,14 @@ var DOLLAR_AMOUNT_STRING_REGEX = /^\$?(\d+)\.?(\d\d)$/;
     var min = config.min, max = config.max, roundConfig = config.round;
     var round = roundingInput !== null && roundingInput !== void 0 ? roundingInput : roundConfig;
     var fn;
-    if (min != null) {
-        var range = max - min;
+    if (min == null) {
         fn = function fn() {
-            return Math.random() * range + min;
+            return Math.random() * max;
         };
     } else {
+        var range = max - min;
         fn = function fn() {
-            return Math.random() * max;
+            return Math.random() * range + min;
         };
     }
     if (round && round !== 'none') {
@@ -5194,7 +5194,7 @@ function reduceNumbersFn(reduceFn, emptyArrayValue) {
  * @param input - Optional initial values to populate the set.
  * @returns A HashSet keyed by index number.
  */ function hashSetForIndexed(input) {
-    var values = input != null ? asArray(input) : undefined;
+    var values = input == null ? undefined : asArray(input);
     return new HashSet({
         readKey: readIndexNumber
     }, values);
@@ -6534,6 +6534,84 @@ function caseInsensitiveString(input) {
  */ function splitJoinNameString(input) {
     return SPACE_STRING_SPLIT_JOIN.splitJoinRemainder(input, 2);
 }
+/**
+ * Default maximum number of initials produced by a {@link NameToInitialsFunction}.
+ */ var DEFAULT_NAME_TO_INITIALS_MAX_INITIALS = 2;
+/**
+ * Default minimum number of initials produced by a {@link NameToInitialsFunction}.
+ */ var DEFAULT_NAME_TO_INITIALS_MIN_INITIALS = 1;
+/**
+ * Creates a {@link NameToInitialsFunction} that derives display initials from a name or short character string.
+ *
+ * Useful for avatar fallbacks where a name (e.g. `'Michelle B'`) or a literal token (e.g. `'BB'`)
+ * should collapse to a compact label. By default a single-word input yields a single initial; raise
+ * `minInitials` to pull more leading characters from a lone word.
+ *
+ * @param config - Configuration controlling the minimum and maximum number of initials.
+ * @returns A reusable function that derives initials from input names.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory string
+ * @dbxUtilKind factory
+ * @dbxUtilTags string, name, initials, avatar, abbreviate, person, factory
+ * @dbxUtilRelated split-join-name-string, capitalize-first-letter
+ *
+ * @example
+ * ```ts
+ * const toInitials = nameToInitialsFactory();
+ * toInitials('Michelle B'); // 'MB'
+ * toInitials('Michelle'); // 'M'
+ *
+ * const toPaddedInitials = nameToInitialsFactory({ minInitials: 2 });
+ * toPaddedInitials('Michelle'); // 'MI'
+ * toPaddedInitials('BB'); // 'BB'
+ * ```
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function nameToInitialsFactory(config) {
+    var _ref, _ref1;
+    var maxInitials = (_ref = config === null || config === void 0 ? void 0 : config.maxInitials) !== null && _ref !== void 0 ? _ref : DEFAULT_NAME_TO_INITIALS_MAX_INITIALS;
+    var minInitials = Math.min((_ref1 = config === null || config === void 0 ? void 0 : config.minInitials) !== null && _ref1 !== void 0 ? _ref1 : DEFAULT_NAME_TO_INITIALS_MIN_INITIALS, maxInitials);
+    return function(name) {
+        var trimmed = name.trim();
+        var result;
+        if (trimmed) {
+            var words = trimmed.split(/\s+/);
+            if (words.length > 1) {
+                result = words.slice(0, maxInitials).map(function(word) {
+                    return word.charAt(0);
+                }).join('');
+            } else {
+                result = words[0].slice(0, minInitials);
+            }
+        } else {
+            result = '';
+        }
+        return result.toUpperCase();
+    };
+}
+/**
+ * Derives display initials from a name or short character string using the default configuration.
+ *
+ * Multi-word inputs use the first character of each of the first two words; single-word inputs use
+ * the first character verbatim. The result is always uppercased.
+ *
+ * @param name - Name or character string to derive initials from.
+ * @returns Uppercased initials, or an empty string when the input is blank.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory string
+ * @dbxUtilTags string, name, initials, avatar, abbreviate, person
+ * @dbxUtilRelated name-to-initials-factory, split-join-name-string, capitalize-first-letter
+ *
+ * @example
+ * ```ts
+ * nameToInitials('Michelle B'); // 'MB'
+ * nameToInitials('A'); // 'A'
+ * nameToInitials('BB'); // 'B'
+ * nameToInitials('Michelle'); // 'M'
+ * ```
+ */ var nameToInitials = nameToInitialsFactory();
 /**
  * Creates a string that repeats the given string a specified number of times.
  *
@@ -6569,7 +6647,7 @@ function caseInsensitiveString(input) {
  */ function cutStringFunction(config) {
     var inputMaxLength = config.maxLength, maxLengthIncludesEndText = config.maxLengthIncludesEndText, inputEndText = config.endText;
     var endText = inputEndText === undefined ? DEFAULT_CUT_STRING_END_TEXT : '';
-    var maxLength = maxLengthIncludesEndText !== false ? inputMaxLength - endText.length : inputMaxLength;
+    var maxLength = maxLengthIncludesEndText === false ? inputMaxLength : inputMaxLength - endText.length;
     return function(input) {
         var result = input;
         if (input != null) {
@@ -6781,12 +6859,12 @@ function caseInsensitiveString(input) {
     }
     var transform = baseTransform;
     if (config.trim) {
-        if (baseTransform != null) {
+        if (baseTransform == null) {
+            transform = stringTrimFunction;
+        } else {
             transform = function transform(x) {
                 return baseTransform(stringTrimFunction(x));
             };
-        } else {
-            transform = stringTrimFunction;
         }
     }
     transform !== null && transform !== void 0 ? transform : transform = MAP_IDENTITY;
@@ -7581,15 +7659,15 @@ function _unsupported_iterable_to_array$r(o, minLen) {
  * @__NO_SIDE_EFFECTS__
  */ function filterKeyValueTuplesFunction(filter) {
     var result;
-    if (filter != null) {
+    if (filter == null) {
+        result = allKeyValueTuples;
+    } else {
         var filterFn = filterKeyValueTupleFunction(filter);
         result = function result(obj) {
             return allKeyValueTuples(obj).filter(function(kv, i) {
                 return filterFn(kv, i);
             });
         };
-    } else {
-        result = allKeyValueTuples;
     }
     return result;
 }
@@ -8021,10 +8099,10 @@ function _unsupported_iterable_to_array$q(o, minLen) {
  * @__NO_SIDE_EFFECTS__
  */ function overrideInObjectFunctionFactory(param) {
     var filter = param.filter, copy = param.copy, _param_dynamic = param.dynamic, dynamic = _param_dynamic === void 0 ? false : _param_dynamic;
-    var filterToRelevantValuesObject = filter != null ? filterFromPOJOFunction({
+    var filterToRelevantValuesObject = filter == null ? defaultFilterFromPOJOFunctionNoCopy : filterFromPOJOFunction({
         filter: filter,
         copy: false
-    }) : defaultFilterFromPOJOFunctionNoCopy;
+    });
     return function(from) {
         var rebuildTemplate = function rebuildTemplate() {
             var template = {};
@@ -8837,7 +8915,7 @@ function isInSetDecisionFunction(set, inputReadValue) {
  * @param input
  * @returns
  */ function maybeSet(input) {
-    return input != null ? new Set(asArray(input)) : input;
+    return input == null ? input : new Set(asArray(input));
 }
 
 function _array_like_to_array$p(arr, len) {
@@ -8931,7 +9009,7 @@ var DEFAULT_AUTH_ROLE_CLAIMS_EMPTY_VALUE = null;
             // since checking uses equivalence, the objects will never match equivalence via the === properly.
             // AuthRoleClaimsFactoryConfigEntryEncodeOptions is likely to be used for these cases unknownways, but this will help avoid unexpected errors.
             if ((typeof expectedValue === "undefined" ? "undefined" : _type_of$d(expectedValue)) === 'object') {
-                throw new Error("failed decoding claims. Expected value to be a string or number. Object isn't supported with simple claims.");
+                throw new TypeError("failed decoding claims. Expected value to be a string or number. Object isn't supported with simple claims.");
             }
             if (inverse) {
                 var inverseMode = inverse === true ? 'any' : inverse;
@@ -11041,13 +11119,13 @@ function _unsupported_iterable_to_array$n(o, minLen) {
         ]) : splitAt;
         var firstOccurence = findFirstCharacterOccurence(splitSet, input);
         var result;
-        if (firstOccurence != null) {
-            result = splitStringAtIndex(input, firstOccurence, false);
-        } else {
+        if (firstOccurence == null) {
             result = [
                 input,
                 undefined
             ];
+        } else {
+            result = splitStringAtIndex(input, firstOccurence, false);
         }
         return result;
     };
@@ -12437,7 +12515,7 @@ function _unsupported_iterable_to_array$l(o, minLen) {
  * @returns Whether the input is a standard internet-accessible website URL.
  */ function isStandardInternetAccessibleWebsiteUrl(input) {
     var protocol = readWebsiteProtocol(input);
-    return hasWebsiteTopLevelDomain(input) && (protocol != null ? isKnownHttpWebsiteProtocol(protocol) : true);
+    return hasWebsiteTopLevelDomain(input) && (protocol == null ? true : isKnownHttpWebsiteProtocol(protocol));
 }
 /**
  * Creates a {@link WebsiteUrl} by merging the base path with additional path segments, preserving the original protocol.
@@ -12475,22 +12553,22 @@ function _unsupported_iterable_to_array$l(o, minLen) {
     var config = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
     var removeQueryParameters = config.removeQueryParameters, ignoredBasePath = config.ignoredBasePath, isolatePathComponents = config.isolatePathComponents, removeTrailingSlash = config.removeTrailingSlash;
     var basePathRegex = ignoredBasePath ? new RegExp('^' + escapeStringForRegex(toAbsoluteSlashPathStartType(ignoredBasePath))) : undefined;
-    var isolateRange = isolatePathComponents != null ? isolateSlashPathFunction({
+    var isolateRange = isolatePathComponents == null ? undefined : isolateSlashPathFunction({
         range: isolatePathComponents,
         startType: 'absolute'
-    }) : undefined;
+    });
     var replaceTrailingSlash = removeTrailingSlash === true ? replaceLastCharacterIfIsFunction('', SLASH_PATH_SEPARATOR) : undefined;
     var pathTransform = chainMapSameFunctions([
         // remove any base path
-        basePathRegex != null ? function(inputPath) {
+        basePathRegex == null ? undefined : function(inputPath) {
             return inputPath.replace(basePathRegex, '');
-        } : undefined,
+        },
         // remove the query parameters
-        removeQueryParameters != null ? function(inputPath) {
+        removeQueryParameters == null ? undefined : function(inputPath) {
             return websitePathAndQueryPair(inputPath).path;
-        } : undefined,
+        },
         // isolate range
-        isolateRange != null ? function(inputPath) {
+        isolateRange == null ? undefined : function(inputPath) {
             var result = isolateRange(inputPath);
             // retain the query if one is available.
             if (removeQueryParameters !== true) {
@@ -12500,12 +12578,12 @@ function _unsupported_iterable_to_array$l(o, minLen) {
                 }
             }
             return result;
-        } : undefined,
+        },
         // remove trailing slash from path
-        replaceTrailingSlash != null ? function(inputPath) {
+        replaceTrailingSlash == null ? undefined : function(inputPath) {
             var _websitePathAndQueryPair = websitePathAndQueryPair(inputPath), path = _websitePathAndQueryPair.path, query = _websitePathAndQueryPair.query;
             return replaceTrailingSlash(path) + (query !== null && query !== void 0 ? query : '');
-        } : undefined
+        }
     ]);
     return function(input) {
         return pathTransform(websitePathFromWebsiteUrl(input));
@@ -12824,9 +12902,7 @@ function _unsupported_iterable_to_array$k(o, minLen) {
  */ function coerceToEmailParticipants(param) {
     var _param_participants = param.participants, participants = _param_participants === void 0 ? [] : _param_participants, _param_emails = param.emails, emails = _param_emails === void 0 ? [] : _param_emails;
     var result;
-    if (!emails.length) {
-        result = participants;
-    } else {
+    if (emails.length) {
         var participantEmails = participants.map(function(x) {
             return x.email;
         });
@@ -12836,6 +12912,8 @@ function _unsupported_iterable_to_array$k(o, minLen) {
                 email: email
             };
         })));
+    } else {
+        result = participants;
     }
     return result;
 }
@@ -14064,7 +14142,9 @@ function _unsupported_iterable_to_array$g(o, minLen) {
  */ function primativeKeyDencoderMap(values) {
     var map = new Map();
     var valuesArray;
-    if (!Array.isArray(values)) {
+    if (Array.isArray(values)) {
+        valuesArray = values;
+    } else {
         valuesArray = [];
         forEachKeyValue(values, {
             forEach: function forEach(pair) {
@@ -14072,8 +14152,6 @@ function _unsupported_iterable_to_array$g(o, minLen) {
             },
             filter: exports.KeyValueTypleValueFilter.UNDEFINED
         });
-    } else {
-        valuesArray = values;
     }
     valuesArray.forEach(function(value) {
         var _value = _sliced_to_array$c(value, 2), d = _value[0], e = _value[1];
@@ -14363,7 +14441,7 @@ function _unsupported_iterable_to_array$g(o, minLen) {
  * // true
  * ```
  */ function isCompleteUnitedStatesAddress(input) {
-    return input != null ? Boolean(input.line1 && input.city && input.state && input.zip) : false;
+    return input == null ? false : Boolean(input.line1 && input.city && input.state && input.zip);
 }
 /**
  * Regex that matches valid two-letter US state and territory codes (uppercase only).
@@ -14444,8 +14522,8 @@ function _unsupported_iterable_to_array$g(o, minLen) {
  */ function vectorMinimumSizeResizeFunction(minSize) {
     return function(input) {
         return {
-            x: minSize.x != null ? Math.max(input.x, minSize.x) : input.x,
-            y: minSize.y != null ? Math.max(input.y, minSize.y) : input.y
+            x: minSize.x == null ? input.x : Math.max(input.x, minSize.x),
+            y: minSize.y == null ? input.y : Math.max(input.y, minSize.y)
         };
     };
 }
@@ -15087,8 +15165,8 @@ function latLngString(lat, lng) {
  * @__NO_SIDE_EFFECTS__
  */ function latLngPointFunction(config) {
     var _ref = config !== null && config !== void 0 ? config : {}, validate = _ref.validate, wrap = _ref.wrap, defaultValue = _ref.default, _ref_precision = _ref.precision, precision = _ref_precision === void 0 ? LAT_LONG_1MM_PRECISION : _ref_precision, readLonLatTuples = _ref.readLonLatTuples, precisionRounding = _ref.precisionRounding;
-    var precisionFunction = precision != null ? latLngPointPrecisionFunction(precision, precisionRounding) : mapIdentityFunction();
-    var wrapFunction = wrap !== false ? wrapLatLngPoint : validate !== false ? validLatLngPointFunction(defaultValue) : undefined;
+    var precisionFunction = precision == null ? mapIdentityFunction() : latLngPointPrecisionFunction(precision, precisionRounding);
+    var wrapFunction = wrap === false ? validate === false ? undefined : validLatLngPointFunction(defaultValue) : wrapLatLngPoint;
     var mapFn = chainMapSameFunctions([
         wrapFunction,
         precisionFunction
@@ -15118,13 +15196,13 @@ function latLngString(lat, lng) {
                 lat: lat.lat,
                 lng: (_lat_lng = lat.lng) !== null && _lat_lng !== void 0 ? _lat_lng : lat.lon
             };
-        } else if (lng != null) {
+        } else if (lng == null) {
+            throw new Error('Invalid lat/lng input "'.concat(lat, ",").concat(lng, '"'));
+        } else {
             latLng = {
                 lat: lat,
                 lng: lng
             };
-        } else {
-            throw new Error('Invalid lat/lng input "'.concat(lat, ",").concat(lng, '"'));
         }
         return mapFn(latLng); // round to a given precision
     };
@@ -15227,7 +15305,7 @@ function latLngString(lat, lng) {
         min: wrapLngValue(sw.lng),
         max: wrapLngValue(ne.lng)
     }, 'none');
-    var precisionFunction = precision != null ? latLngPointPrecisionFunction(precision, 'round') : mapIdentityFunction();
+    var precisionFunction = precision == null ? mapIdentityFunction() : latLngPointPrecisionFunction(precision, 'round');
     return function() {
         return precisionFunction({
             lat: randomLatFactory(),
@@ -16456,7 +16534,7 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
     return input.getTime() < Date.now();
 }
 function addMilliseconds(input, ms) {
-    return input != null ? new Date(input.getTime() + (ms !== null && ms !== void 0 ? ms : 0)) : input;
+    return input == null ? input : new Date(input.getTime() + (ms !== null && ms !== void 0 ? ms : 0));
 }
 
 /**
@@ -17135,10 +17213,10 @@ function _ts_generator$7(thisArg, body) {
  * ```
  */ function useValue(input, use, defaultValue) {
     var result;
-    if (input != null) {
-        result = use(input);
-    } else {
+    if (input == null) {
         result = getValueFromGetter(defaultValue);
+    } else {
+        result = use(input);
     }
     return result;
 }
@@ -17211,10 +17289,10 @@ function _ts_generator$7(thisArg, body) {
  */ function useContextFunction(use, defaultValue) {
     return function(input) {
         var result;
-        if (input != null) {
-            result = use(input);
-        } else {
+        if (input == null) {
             result = getValueFromGetter(defaultValue);
+        } else {
+            result = use(input);
         }
         return result;
     };
@@ -17238,22 +17316,22 @@ function _ts_generator$7(thisArg, body) {
         return _ts_generator$7(this, function(_state) {
             switch(_state.label){
                 case 0:
-                    if (!(input != null)) return [
+                    if (!(input == null)) return [
                         3,
-                        2
+                        1
                     ];
+                    result = getValueFromGetter(defaultValue);
                     return [
-                        4,
-                        use(input)
+                        3,
+                        3
                     ];
                 case 1:
-                    result = _state.sent();
                     return [
-                        3,
-                        3
+                        4,
+                        use(input)
                     ];
                 case 2:
-                    result = getValueFromGetter(defaultValue);
+                    result = _state.sent();
                     _state.label = 3;
                 case 3:
                     return [
@@ -17366,7 +17444,7 @@ function _ts_generator$7(thisArg, body) {
     var increaseBy = inputIncreaseBy !== null && inputIncreaseBy !== void 0 ? inputIncreaseBy : 1;
     var dencoder = inputDencoder !== null && inputDencoder !== void 0 ? inputDencoder : NUMBER_STRING_DENCODER_64;
     var dencoderNumberValue = numberStringDencoderDecodedNumberValueFunction(dencoder);
-    var startAtFromCurrentIndex = currentIndex != null ? dencoderNumberValue(currentIndex) + increaseBy : undefined;
+    var startAtFromCurrentIndex = currentIndex == null ? undefined : dencoderNumberValue(currentIndex) + increaseBy;
     var startAt = inputStartAt == null ? startAtFromCurrentIndex !== null && startAtFromCurrentIndex !== void 0 ? startAtFromCurrentIndex : 0 : dencoderNumberValue(inputStartAt);
     var transform = inputTranformFunction !== null && inputTranformFunction !== void 0 ? inputTranformFunction : mapIdentityFunction();
     var numberFactory = incrementingNumberFactory({
@@ -17661,7 +17739,7 @@ function _type_of$6(obj) {
     return unixDateTimeSecondsNumberFromDate(new Date());
 }
 function unixDateTimeSecondsNumberFromDate(date) {
-    return date != null ? Math.ceil(date.getTime() / 1000) : date;
+    return date == null ? date : Math.ceil(date.getTime() / 1000);
 }
 function dateFromDateOrTimeSecondsNumber(input) {
     var result;
@@ -17685,7 +17763,7 @@ function dateFromDateOrTimeSecondsNumber(input) {
  * @dbxUtilTags date, unix, seconds, timestamp, convert, parse
  * @dbxUtilRelated unix-date-time-seconds-number-from-date, date-from-date-or-time-seconds-number
  */ function unixDateTimeSecondsNumberToDate(dateTimeNumber) {
-    return dateTimeNumber != null ? new Date(dateTimeNumber * 1000) : dateTimeNumber;
+    return dateTimeNumber == null ? dateTimeNumber : new Date(dateTimeNumber * 1000);
 }
 
 /**
@@ -17742,7 +17820,7 @@ function dateFromDateOrTimeSecondsNumber(input) {
         } else if (expiresAt != null) {
             expirationDate = expiresAt;
         } else if (expiresIn != null) {
-            var date = parsedExpiresFromDate !== null && parsedExpiresFromDate !== void 0 ? parsedExpiresFromDate : defaultExpiresFromDateToNow !== false ? now : null;
+            var date = parsedExpiresFromDate !== null && parsedExpiresFromDate !== void 0 ? parsedExpiresFromDate : defaultExpiresFromDateToNow === false ? null : now;
             expirationDate = addMilliseconds(date, expiresIn);
         }
         return expirationDate;
@@ -18326,10 +18404,10 @@ function _ts_generator$6(thisArg, body) {
                 2,
                 new Promise(function(resolve, reject) {
                     var callback = function callback(err) {
-                        if (err != null) {
-                            reject(err);
-                        } else {
+                        if (err == null) {
                             resolve();
+                        } else {
+                            reject(err);
                         }
                     };
                     use(callback);
@@ -20700,7 +20778,7 @@ function _is_native_reflect_construct$2() {
  * @returns Projected end instant; null when no duration remains to project.
  */ function approximateTimerEndDate(timer) {
     var durationRemaining = timer.durationRemaining;
-    return durationRemaining != null ? new Date(Date.now() + durationRemaining) : null;
+    return durationRemaining == null ? null : new Date(Date.now() + durationRemaining);
 }
 
 /**
@@ -22285,7 +22363,7 @@ function handlerFactory(readKey, options) {
             base: function base(value) {
                 var _ref;
                 var key = readKey(value);
-                var handler = (_ref = key != null ? map.get(key) : undefined) !== null && _ref !== void 0 ? _ref : catchAll;
+                var handler = (_ref = key == null ? undefined : map.get(key)) !== null && _ref !== void 0 ? _ref : catchAll;
                 var handled;
                 if (handler) {
                     handled = Promise.resolve(handler(value)).then(function(x) {
@@ -24342,9 +24420,9 @@ function invertMaybeBoolean(x) {
             return reduceFn(a, b);
         }));
     };
-    return emptyArrayValue != null ? function(array) {
+    return emptyArrayValue == null ? rFn : function(array) {
         return array.length ? rFn(array) : emptyArrayValue;
-    } : rFn;
+    };
 }
 /**
  * Creates a new BooleanFactory that generates random boolean values based on chance.
@@ -24568,6 +24646,40 @@ function _define_property$1(obj, key, value) {
     });
     return filterMaybeArrayValues(values);
 }
+/**
+ * FNV-1a 32-bit offset basis.
+ */ var FNV_1A_OFFSET_BASIS = 0x811c9dc5;
+/**
+ * FNV-1a 32-bit prime.
+ */ var FNV_1A_PRIME = 0x01000193;
+/**
+ * Computes a stable, non-negative 32-bit integer hash for the input string using the FNV-1a algorithm.
+ *
+ * Deterministic and dependency-free (no `Math.random`): the same input always yields the same value,
+ * making it suitable for deterministically mapping a string onto a fixed-size set (e.g. picking a
+ * curated color for a name via `hashStringToNumber(value) % colors.length`).
+ *
+ * @param value - String to hash.
+ * @returns A non-negative integer in the range `[0, 2^32)`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory hash
+ * @dbxUtilTags hash, string, number, deterministic, fnv, bucket, index
+ * @dbxUtilRelated decode-hashed-values
+ *
+ * @example
+ * ```ts
+ * hashStringToNumber('Michelle B'); // stable integer, same every call
+ * hashStringToNumber('Michelle B') % 12; // deterministic bucket index 0-11
+ * ```
+ */ function hashStringToNumber(value) {
+    var hash = FNV_1A_OFFSET_BASIS;
+    for(var i = 0; i < value.length; i += 1){
+        hash ^= value.charCodeAt(i);
+        hash = Math.imul(hash, FNV_1A_PRIME);
+    }
+    return hash >>> 0;
+}
 
 function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -25512,6 +25624,8 @@ exports.DEFAULT_AUTH_ROLE_CLAIMS_EMPTY_VALUE = DEFAULT_AUTH_ROLE_CLAIMS_EMPTY_VA
 exports.DEFAULT_CUT_STRING_END_TEXT = DEFAULT_CUT_STRING_END_TEXT;
 exports.DEFAULT_ENCRYPTED_FIELD_PREFIX = DEFAULT_ENCRYPTED_FIELD_PREFIX;
 exports.DEFAULT_LAT_LNG_STRING_VALUE = DEFAULT_LAT_LNG_STRING_VALUE;
+exports.DEFAULT_NAME_TO_INITIALS_MAX_INITIALS = DEFAULT_NAME_TO_INITIALS_MAX_INITIALS;
+exports.DEFAULT_NAME_TO_INITIALS_MIN_INITIALS = DEFAULT_NAME_TO_INITIALS_MIN_INITIALS;
 exports.DEFAULT_NUMBER_STRING_DENCODER_64_NEGATIVE_PREFIX = DEFAULT_NUMBER_STRING_DENCODER_64_NEGATIVE_PREFIX;
 exports.DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG = DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG;
 exports.DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG = DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG;
@@ -25945,6 +26059,7 @@ exports.hasValueOrNotEmptyObject = hasValueOrNotEmptyObject;
 exports.hasWebsiteDomain = hasWebsiteDomain;
 exports.hasWebsiteTopLevelDomain = hasWebsiteTopLevelDomain;
 exports.hashSetForIndexed = hashSetForIndexed;
+exports.hashStringToNumber = hashStringToNumber;
 exports.hourToFractionalHour = hourToFractionalHour;
 exports.hoursAndMinutesToString = hoursAndMinutesToString;
 exports.hoursAndMinutesToTimeUnit = hoursAndMinutesToTimeUnit;
@@ -26191,6 +26306,8 @@ exports.monthOfYearFromDateMonth = monthOfYearFromDateMonth;
 exports.monthOfYearFromUTCDate = monthOfYearFromUTCDate;
 exports.multiKeyValueMapFactory = multiKeyValueMapFactory;
 exports.multiValueMapBuilder = multiValueMapBuilder;
+exports.nameToInitials = nameToInitials;
+exports.nameToInitialsFactory = nameToInitialsFactory;
 exports.neMostLatLngPoint = neMostLatLngPoint;
 exports.nearestDivisibleValues = nearestDivisibleValues;
 exports.noop = noop;