@mll-lab/js-utils 2.31.0 → 2.32.0

package/dist/array.d.ts

@@ -56,3 +56,5 @@ export declare function makeStringCompareFn<TSortable>(map: (sortable: TSortable
  * The empty string is first in sort order.
  */
 export declare function localeCompareStrings(a: string, b: string): number;
+/** If the given array contains exactly one item, return that, otherwise null. */
+export declare function soleItem<T>(array: Maybe<Array<T>>): T | null;

package/dist/index.common.js

@@ -9527,6 +9527,13 @@ function makeStringCompareFn(map) {
 function localeCompareStrings(a, b) {
     return a.localeCompare(b);
 }
+/** If the given array contains exactly one item, return that, otherwise null. */
+function soleItem(array) {
+    if (!array || array.length !== 1) {
+        return null;
+    }
+    return array[0];
+}
 
 /**
  * @name toDate
@@ -15928,6 +15935,7 @@ exports.pick = pick;
 exports.pluralize = pluralize;
 exports.pxToNumber = pxToNumber;
 exports.round = round;
+exports.soleItem = soleItem;
 exports.sortByArray = sortByArray;
 exports.toggleElement = toggleElement;
 exports.withoutIndex = withoutIndex;