@mll-lab/js-utils 2.38.0 → 2.39.0

package/dist/array.d.ts

@@ -61,6 +61,13 @@ export declare function makeNumberCompareFn<TSortable>(map: (sortable: TSortable
  * Usable in `Array.toSorted` or similar APIs.
  */
 export declare function makeBooleanCompareFn<TSortable>(map: (sortable: TSortable) => boolean): (a: TSortable, b: TSortable) => number;
+/**
+ * Takes a function that maps the values to sort to Dates and returns a compare function
+ * using their timestamps, usable in `Array.toSorted` or similar APIs.
+ *
+ * null and undefined are coalesced to 0 and thus not distinguished and first in sort order.
+ */
+export declare function makeDateCompareFn<TSortable>(map: (sortable: TSortable) => Maybe<Date>): (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

@@ -9594,6 +9594,15 @@ function makeBooleanCompareFn(map) {
         return Number(mappedA) - Number(mappedB);
     };
 }
+/**
+ * Takes a function that maps the values to sort to Dates and returns a compare function
+ * using their timestamps, usable in `Array.toSorted` or similar APIs.
+ *
+ * null and undefined are coalesced to 0 and thus not distinguished and first in sort order.
+ */
+function makeDateCompareFn(map) {
+    return makeNumberCompareFn((sortable) => { var _a; return (_a = map(sortable)) === null || _a === void 0 ? void 0 : _a.getTime(); });
+}
 /**
  * Returns a compare function for values that are string, null or undefined,
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.
@@ -16342,6 +16351,7 @@ exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
 exports.localeCompareStrings = localeCompareStrings;
 exports.makeBooleanCompareFn = makeBooleanCompareFn;
+exports.makeDateCompareFn = makeDateCompareFn;
 exports.makeNumberCompareFn = makeNumberCompareFn;
 exports.makeStringCompareFn = makeStringCompareFn;
 exports.mapSequentially = mapSequentially;