@mll-lab/js-utils 2.18.0 → 2.20.0

package/dist/array.d.ts

@@ -1,7 +1,9 @@
+import { Maybe } from './types';
 export declare type NonEmptyArray<T> = Array<T> & {
     0: T;
 };
 export declare function isNonEmptyArray<T>(value: Array<T>): value is NonEmptyArray<T>;
+export declare function isEmptyArray(value: unknown): value is [];
 /**
  * Return a new array that does not contain the item at the specified index.
  */
@@ -40,3 +42,10 @@ export declare function toggleElement<T>(array: Array<T>, element: T): Array<T>;
  *          returns sorted array [Jan, Mar, Dec]
  */
 export declare function sortByArray<T extends string | number>(subject: Array<T>, recipe: Array<T>): Array<T>;
+/**
+ * Takes a function that maps the values to sort and returns a compare function
+ * using `String.prototype.localeCompare`, usable in `Array.sort` or similar APIs.
+ *
+ * null, undefined and the empty string are not distinguished and first in sort order.
+ */
+export declare function makeStringCompareFn<TSortable>(map: (sortable: TSortable) => Maybe<string>): (a: TSortable, b: TSortable) => number;

package/dist/index.common.js

@@ -9435,6 +9435,9 @@ root._=_;}}).call(commonjsGlobal);});
 function isNonEmptyArray(value) {
     return value.length > 0;
 }
+function isEmptyArray(value) {
+    return value instanceof Array && value.length === 0;
+}
 /**
  * Return a new array that does not contain the item at the specified index.
  */
@@ -9491,6 +9494,20 @@ 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
+ * using `String.prototype.localeCompare`, usable in `Array.sort` or similar APIs.
+ *
+ * null, undefined and the empty string are not distinguished and first in sort order.
+ */
+function makeStringCompareFn(map) {
+    return (a, b) => {
+        var _a, _b;
+        const mappedA = (_a = map(a)) !== null && _a !== void 0 ? _a : '';
+        const mappedB = (_b = map(b)) !== null && _b !== void 0 ? _b : '';
+        return mappedA.localeCompare(mappedB);
+    };
+}
 
 function toInteger(dirtyNumber) {
   if (dirtyNumber === null || dirtyNumber === true || dirtyNumber === false) {
@@ -15470,6 +15487,7 @@ exports.insertIf = insertIf;
 exports.isAlphanumeric = isAlphanumeric;
 exports.isBSNR = isBSNR;
 exports.isEmail = isEmail;
+exports.isEmptyArray = isEmptyArray;
 exports.isFuture = isFuture;
 exports.isLabId = isLabId;
 exports.isMobileDevice = isMobileDevice;
@@ -15484,6 +15502,7 @@ exports.isURL = isURL;
 exports.isWord = isWord;
 exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
+exports.makeStringCompareFn = makeStringCompareFn;
 exports.mapSequentially = mapSequentially;
 exports.parseDate = parseDate;
 exports.parseDotlessDate = parseDotlessDate;