@mll-lab/js-utils 2.33.0 → 2.34.0

package/dist/index.js

@@ -9505,7 +9505,7 @@ function sortByArray(subject, recipe) {
     return lodash.sortBy(subject, (value) => recipe.indexOf(value));
 }
 /**
- * Takes a function that maps the values to sort and returns a compare function
+ * Takes a function that maps the values to sort to strings and returns a compare function
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.
  *
  * null, undefined and the empty string are not distinguished and first in sort order.
@@ -9518,6 +9518,20 @@ function makeStringCompareFn(map) {
         return mappedA.localeCompare(mappedB);
     };
 }
+/**
+ * Takes a function that maps the values to sort to numbers and returns a compare function
+ * using subtraction, usable in `Array.toSorted` or similar APIs.
+ *
+ * null and undefined are coalesced to `fallbackValue`, by default 0, and thus not distinguished and first in sort order.
+ */
+function makeNumberCompareFn(map, fallbackValue = 0) {
+    return (a, b) => {
+        var _a, _b;
+        const mappedA = (_a = map(a)) !== null && _a !== void 0 ? _a : fallbackValue;
+        const mappedB = (_b = map(b)) !== null && _b !== void 0 ? _b : fallbackValue;
+        return mappedA - mappedB;
+    };
+}
 /**
  * Returns a compare function for values that are string, null or undefined,
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.
@@ -16223,6 +16237,7 @@ exports.isZeroish = isZeroish;
 exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
 exports.localeCompareStrings = localeCompareStrings;
+exports.makeNumberCompareFn = makeNumberCompareFn;
 exports.makeStringCompareFn = makeStringCompareFn;
 exports.mapSequentially = mapSequentially;
 exports.parseDate = parseDate;