@mll-lab/js-utils 2.37.0 → 2.38.0

package/dist/array.d.ts

@@ -56,6 +56,11 @@ export declare function makeStringCompareFn<TSortable>(map: (sortable: TSortable
  * null and undefined are coalesced to `fallbackValue`, by default 0, and thus not distinguished and first in sort order.
  */
 export declare function makeNumberCompareFn<TSortable>(map: (sortable: TSortable) => Maybe<number>, fallbackValue?: number): (a: TSortable, b: TSortable) => number;
+/**
+ * Takes a function that maps the values to sort to booleans and returns a compare function that puts `false` before `true`.
+ * Usable in `Array.toSorted` or similar APIs.
+ */
+export declare function makeBooleanCompareFn<TSortable>(map: (sortable: TSortable) => boolean): (a: TSortable, b: TSortable) => number;
 /**
  * Returns a compare function for values that are string, null or undefined,
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.

package/dist/index.common.js

@@ -9583,6 +9583,17 @@ function makeNumberCompareFn(map, fallbackValue = 0) {
         return mappedA - mappedB;
     };
 }
+/**
+ * Takes a function that maps the values to sort to booleans and returns a compare function that puts `false` before `true`.
+ * Usable in `Array.toSorted` or similar APIs.
+ */
+function makeBooleanCompareFn(map) {
+    return (a, b) => {
+        const mappedA = map(a);
+        const mappedB = map(b);
+        return Number(mappedA) - Number(mappedB);
+    };
+}
 /**
  * Returns a compare function for values that are string, null or undefined,
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.
@@ -16330,6 +16341,7 @@ exports.isZeroish = isZeroish;
 exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
 exports.localeCompareStrings = localeCompareStrings;
+exports.makeBooleanCompareFn = makeBooleanCompareFn;
 exports.makeNumberCompareFn = makeNumberCompareFn;
 exports.makeStringCompareFn = makeStringCompareFn;
 exports.mapSequentially = mapSequentially;