@naturalcycles/js-lib 14.239.0 → 14.240.0

package/dist/datetime/localDate.d.ts

@@ -4,6 +4,7 @@ import { DateObject, ISODayOfWeek, LocalTime } from './localTime';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
 export type LocalDateUnitStrict = 'year' | 'month' | 'day';
 export type LocalDateInput = LocalDate | Date | IsoDateString;
+export type LocalDateInputNullable = LocalDateInput | null | undefined;
 export type LocalDateFormatter = (ld: LocalDate) => string;
 /**
  * LocalDate represents a date without time.
@@ -166,7 +167,7 @@ declare class LocalDateFactory {
      * Tries to construct LocalDate from LocalDateInput, returns null otherwise.
      * Does not throw (returns null instead).
      */
-    parseOrNull(d: LocalDateInput | undefined | null): LocalDate | null;
+    parseOrNull(d: LocalDateInputNullable): LocalDate | null;
     /**
      * Parses "compact iso8601 format", e.g `19840621` into LocalDate.
      * Throws if it fails to do so.
@@ -204,21 +205,21 @@ declare class LocalDateFactory {
     /**
      * Returns the earliest (min) LocalDate from the array, or undefined if the array is empty.
      */
-    minOrUndefined(items: LocalDateInput[]): LocalDate | undefined;
+    minOrUndefined(items: LocalDateInputNullable[]): LocalDate | undefined;
     /**
      * Returns the earliest LocalDate from the array.
      * Throws if the array is empty.
      */
-    min(items: LocalDateInput[]): LocalDate;
+    min(items: LocalDateInputNullable[]): LocalDate;
     /**
      * Returns the latest (max) LocalDate from the array, or undefined if the array is empty.
      */
-    maxOrUndefined(items: LocalDateInput[]): LocalDate | undefined;
+    maxOrUndefined(items: LocalDateInputNullable[]): LocalDate | undefined;
     /**
      * Returns the latest LocalDate from the array.
      * Throws if the array is empty.
      */
-    max(items: LocalDateInput[]): LocalDate;
+    max(items: LocalDateInputNullable[]): LocalDate;
     /**
      * Returns the range (array) of LocalDates between min and max.
      * By default, min is included, max is excluded.
@@ -234,11 +235,11 @@ declare class LocalDateFactory {
      *
      * Similar to `localDate.orToday`, but that will instead return Today on falsy input.
      */
-    orUndefined(d: LocalDateInput | null | undefined): LocalDate | undefined;
+    orUndefined(d: LocalDateInputNullable): LocalDate | undefined;
     /**
      * Creates a LocalDate from the input, unless it's falsy - then returns localDate.today.
      */
-    orToday(d: LocalDateInput | null | undefined): LocalDate;
+    orToday(d: LocalDateInputNullable): LocalDate;
 }
 interface LocalDateFn extends LocalDateFactory {
     (d: LocalDateInput): LocalDate;

package/dist/datetime/localDate.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.todayString = exports.localDate = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
+const is_util_1 = require("../is.util");
 const iterable2_1 = require("../iter/iterable2");
 const localTime_1 = require("./localTime");
 const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -537,8 +538,11 @@ class LocalDateFactory {
      * Throws if the array is empty.
      */
     min(items) {
-        (0, assert_1._assert)(items.length, 'localDate.min called on empty array');
-        return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'localDate.min called on empty array');
+        return items2
+            .map(i => this.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
     }
     /**
      * Returns the latest (max) LocalDate from the array, or undefined if the array is empty.
@@ -551,8 +555,9 @@ class LocalDateFactory {
      * Throws if the array is empty.
      */
     max(items) {
-        (0, assert_1._assert)(items.length, 'localDate.max called on empty array');
-        return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'localDate.max called on empty array');
+        return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     /**
      * Returns the range (array) of LocalDates between min and max.

package/dist/datetime/localTime.d.ts

@@ -12,6 +12,7 @@ export declare enum ISODayOfWeek {
     SUNDAY = 7
 }
 export type LocalTimeInput = LocalTime | Date | IsoDateTimeString | UnixTimestampNumber;
+export type LocalTimeInputNullable = LocalTimeInput | null | undefined;
 export type LocalTimeFormatter = (ld: LocalTime) => string;
 export type DateTimeObject = DateObject & TimeObject;
 export interface DateObject {
@@ -226,10 +227,10 @@ declare class LocalTimeFactory {
     /**
      * Returns null if invalid
      */
-    parseOrNull(d: LocalTimeInput | undefined | null): LocalTime | null;
+    parseOrNull(d: LocalTimeInputNullable): LocalTime | null;
     parseToDate(d: LocalTimeInput): Date;
     parseToUnixTimestamp(d: LocalTimeInput): UnixTimestampNumber;
-    isValid(d: LocalTimeInput | undefined | null): boolean;
+    isValid(d: LocalTimeInputNullable): boolean;
     /**
      * Returns the IANA timezone e.g `Europe/Stockholm`.
      * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
@@ -249,20 +250,20 @@ declare class LocalTimeFactory {
      *
      * `localTime` function will instead return LocalTime of `now` for falsy input.
      */
-    orUndefined(d: LocalTimeInput | null | undefined): LocalTime | undefined;
+    orUndefined(d: LocalTimeInputNullable): LocalTime | undefined;
     /**
      * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
      */
-    orNow(d: LocalTimeInput | null | undefined): LocalTime;
+    orNow(d: LocalTimeInputNullable): LocalTime;
     fromComponents(c: {
         year: number;
         month: number;
     } & Partial<DateTimeObject>): LocalTime;
     sort(items: LocalTime[], dir?: SortDirection, mutate?: boolean): LocalTime[];
-    minOrUndefined(items: LocalTimeInput[]): LocalTime | undefined;
-    min(items: LocalTimeInput[]): LocalTime;
-    maxOrUndefined(items: LocalTimeInput[]): LocalTime | undefined;
-    max(items: LocalTimeInput[]): LocalTime;
+    minOrUndefined(items: LocalTimeInputNullable[]): LocalTime | undefined;
+    min(items: LocalTimeInputNullable[]): LocalTime;
+    maxOrUndefined(items: LocalTimeInputNullable[]): LocalTime | undefined;
+    max(items: LocalTimeInputNullable[]): LocalTime;
 }
 interface LocalTimeFn extends LocalTimeFactory {
     (d: LocalTimeInput): LocalTime;

package/dist/datetime/localTime.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nowUnix = exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
 const assert_1 = require("../error/assert");
+const is_util_1 = require("../is.util");
 const time_util_1 = require("../time/time.util");
 const localDate_1 = require("./localDate");
 const wallTime_1 = require("./wallTime");
@@ -705,8 +706,9 @@ class LocalTimeFactory {
         return items.length ? this.min(items) : undefined;
     }
     min(items) {
-        (0, assert_1._assert)(items.length, 'localTime.min called on empty array');
-        return items
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'localTime.min called on empty array');
+        return items2
             .map(i => this.of(i))
             .reduce((min, item) => (min.$date.valueOf() <= item.$date.valueOf() ? min : item));
     }
@@ -714,8 +716,9 @@ class LocalTimeFactory {
         return items.length ? this.max(items) : undefined;
     }
     max(items) {
-        (0, assert_1._assert)(items.length, 'localTime.max called on empty array');
-        return items
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'localTime.max called on empty array');
+        return items2
             .map(i => this.of(i))
             .reduce((max, item) => (max.$date.valueOf() >= item.$date.valueOf() ? max : item));
     }

package/dist/semver.d.ts

@@ -1,4 +1,6 @@
+import { SortDirection } from './types';
 export type SemverInput = string | Semver;
+export type SemverInputNullable = SemverInput | null | undefined;
 export type SemverTokens = [major: number, minor: number, patch: number];
 /**
  * Simple Semver implementation.
@@ -38,25 +40,29 @@ export declare class Semver {
 }
 declare class SemverFactory {
     of(input: SemverInput): Semver;
-    parseOrNull(input: SemverInput | undefined | null): Semver | null;
+    parseOrNull(input: SemverInputNullable): Semver | null;
     /**
      * Returns the highest (max) Semver from the array, or undefined if the array is empty.
      */
-    maxOrUndefined(items: SemverInput[]): Semver | undefined;
+    maxOrUndefined(items: SemverInputNullable[]): Semver | undefined;
     /**
      * Returns the highest Semver from the array.
      * Throws if the array is empty.
      */
-    max(items: SemverInput[]): Semver;
+    max(items: SemverInputNullable[]): Semver;
     /**
      * Returns the lowest (min) Semver from the array, or undefined if the array is empty.
      */
-    minOrUndefined(items: SemverInput[]): Semver | undefined;
+    minOrUndefined(items: SemverInputNullable[]): Semver | undefined;
     /**
      * Returns the lowest Semver from the array.
      * Throws if the array is empty.
      */
-    min(items: SemverInput[]): Semver;
+    min(items: SemverInputNullable[]): Semver;
+    /**
+     * Sorts an array of Semvers in `dir` order (ascending by default).
+     */
+    sort(items: Semver[], dir?: SortDirection, mutate?: boolean): Semver[];
 }
 interface SemverFn extends SemverFactory {
     (input: SemverInput): Semver;

package/dist/semver.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._quickSemverCompare = exports.semver2 = exports.Semver = void 0;
 const range_1 = require("./array/range");
 const assert_1 = require("./error/assert");
+const is_util_1 = require("./is.util");
 /**
  * Simple Semver implementation.
  *
@@ -86,8 +87,9 @@ class SemverFactory {
      * Throws if the array is empty.
      */
     max(items) {
-        (0, assert_1._assert)(items.length, 'semver.max called on empty array');
-        return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'semver.max called on empty array');
+        return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     /**
      * Returns the lowest (min) Semver from the array, or undefined if the array is empty.
@@ -100,8 +102,18 @@ class SemverFactory {
      * Throws if the array is empty.
      */
     min(items) {
-        (0, assert_1._assert)(items.length, 'semver.min called on empty array');
-        return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        const items2 = items.filter(is_util_1._isTruthy);
+        (0, assert_1._assert)(items2.length, 'semver.min called on empty array');
+        return items2
+            .map(i => this.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+    }
+    /**
+     * Sorts an array of Semvers in `dir` order (ascending by default).
+     */
+    sort(items, dir = 'asc', mutate = false) {
+        const mod = dir === 'desc' ? -1 : 1;
+        return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);
     }
 }
 const semverFactory = new SemverFactory();

package/dist-esm/datetime/localDate.js

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert';
+import { _isTruthy } from '../is.util';
 import { Iterable2 } from '../iter/iterable2';
 import { localTime } from './localTime';
 const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -533,8 +534,11 @@ class LocalDateFactory {
      * Throws if the array is empty.
      */
     min(items) {
-        _assert(items.length, 'localDate.min called on empty array');
-        return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'localDate.min called on empty array');
+        return items2
+            .map(i => this.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
     }
     /**
      * Returns the latest (max) LocalDate from the array, or undefined if the array is empty.
@@ -547,8 +551,9 @@ class LocalDateFactory {
      * Throws if the array is empty.
      */
     max(items) {
-        _assert(items.length, 'localDate.max called on empty array');
-        return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'localDate.max called on empty array');
+        return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     /**
      * Returns the range (array) of LocalDates between min and max.

package/dist-esm/datetime/localTime.js

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert';
+import { _isTruthy } from '../is.util';
 import { _ms } from '../time/time.util';
 import { localDate } from './localDate';
 import { WallTime } from './wallTime';
@@ -701,8 +702,9 @@ class LocalTimeFactory {
         return items.length ? this.min(items) : undefined;
     }
     min(items) {
-        _assert(items.length, 'localTime.min called on empty array');
-        return items
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'localTime.min called on empty array');
+        return items2
             .map(i => this.of(i))
             .reduce((min, item) => (min.$date.valueOf() <= item.$date.valueOf() ? min : item));
     }
@@ -710,8 +712,9 @@ class LocalTimeFactory {
         return items.length ? this.max(items) : undefined;
     }
     max(items) {
-        _assert(items.length, 'localTime.max called on empty array');
-        return items
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'localTime.max called on empty array');
+        return items2
             .map(i => this.of(i))
             .reduce((max, item) => (max.$date.valueOf() >= item.$date.valueOf() ? max : item));
     }

package/dist-esm/semver.js

@@ -1,5 +1,6 @@
 import { _range } from './array/range';
 import { _assert } from './error/assert';
+import { _isTruthy } from './is.util';
 /**
  * Simple Semver implementation.
  *
@@ -82,8 +83,9 @@ class SemverFactory {
      * Throws if the array is empty.
      */
     max(items) {
-        _assert(items.length, 'semver.max called on empty array');
-        return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'semver.max called on empty array');
+        return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     /**
      * Returns the lowest (min) Semver from the array, or undefined if the array is empty.
@@ -96,8 +98,18 @@ class SemverFactory {
      * Throws if the array is empty.
      */
     min(items) {
-        _assert(items.length, 'semver.min called on empty array');
-        return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        const items2 = items.filter(_isTruthy);
+        _assert(items2.length, 'semver.min called on empty array');
+        return items2
+            .map(i => this.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+    }
+    /**
+     * Sorts an array of Semvers in `dir` order (ascending by default).
+     */
+    sort(items, dir = 'asc', mutate = false) {
+        const mod = dir === 'desc' ? -1 : 1;
+        return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);
     }
 }
 const semverFactory = new SemverFactory();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.239.0",
+  "version": "14.240.0",
   "scripts": {
     "prepare": "husky",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/localDate.ts

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert'
+import { _isTruthy } from '../is.util'
 import { Iterable2 } from '../iter/iterable2'
 import type {
   Inclusiveness,
@@ -18,6 +19,7 @@ const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
 const DATE_REGEX = /^(\d\d\d\d)-(\d\d)-(\d\d)$/
 
 export type LocalDateInput = LocalDate | Date | IsoDateString
+export type LocalDateInputNullable = LocalDateInput | null | undefined
 export type LocalDateFormatter = (ld: LocalDate) => string
 
 /**
@@ -517,7 +519,7 @@ class LocalDateFactory {
    * Tries to construct LocalDate from LocalDateInput, returns null otherwise.
    * Does not throw (returns null instead).
    */
-  parseOrNull(d: LocalDateInput | undefined | null): LocalDate | null {
+  parseOrNull(d: LocalDateInputNullable): LocalDate | null {
     if (!d) return null
     if (d instanceof LocalDate) return d
     if (d instanceof Date) {
@@ -619,7 +621,7 @@ class LocalDateFactory {
   /**
    * Returns the earliest (min) LocalDate from the array, or undefined if the array is empty.
    */
-  minOrUndefined(items: LocalDateInput[]): LocalDate | undefined {
+  minOrUndefined(items: LocalDateInputNullable[]): LocalDate | undefined {
     return items.length ? this.min(items) : undefined
   }
 
@@ -627,16 +629,19 @@ class LocalDateFactory {
    * Returns the earliest LocalDate from the array.
    * Throws if the array is empty.
    */
-  min(items: LocalDateInput[]): LocalDate {
-    _assert(items.length, 'localDate.min called on empty array')
+  min(items: LocalDateInputNullable[]): LocalDate {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'localDate.min called on empty array')
 
-    return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
+    return items2
+      .map(i => this.of(i))
+      .reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
   }
 
   /**
    * Returns the latest (max) LocalDate from the array, or undefined if the array is empty.
    */
-  maxOrUndefined(items: LocalDateInput[]): LocalDate | undefined {
+  maxOrUndefined(items: LocalDateInputNullable[]): LocalDate | undefined {
     return items.length ? this.max(items) : undefined
   }
 
@@ -644,10 +649,11 @@ class LocalDateFactory {
    * Returns the latest LocalDate from the array.
    * Throws if the array is empty.
    */
-  max(items: LocalDateInput[]): LocalDate {
-    _assert(items.length, 'localDate.max called on empty array')
+  max(items: LocalDateInputNullable[]): LocalDate {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'localDate.max called on empty array')
 
-    return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
+    return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
   }
 
   /**
@@ -711,14 +717,14 @@ class LocalDateFactory {
    *
    * Similar to `localDate.orToday`, but that will instead return Today on falsy input.
    */
-  orUndefined(d: LocalDateInput | null | undefined): LocalDate | undefined {
+  orUndefined(d: LocalDateInputNullable): LocalDate | undefined {
     return d ? this.of(d) : undefined
   }
 
   /**
    * Creates a LocalDate from the input, unless it's falsy - then returns localDate.today.
    */
-  orToday(d: LocalDateInput | null | undefined): LocalDate {
+  orToday(d: LocalDateInputNullable): LocalDate {
     return d ? this.of(d) : this.today()
   }
 }

package/src/datetime/localTime.ts

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert'
+import { _isTruthy } from '../is.util'
 import { _ms } from '../time/time.util'
 import type {
   Inclusiveness,
@@ -27,6 +28,7 @@ export enum ISODayOfWeek {
 }
 
 export type LocalTimeInput = LocalTime | Date | IsoDateTimeString | UnixTimestampNumber
+export type LocalTimeInputNullable = LocalTimeInput | null | undefined
 export type LocalTimeFormatter = (ld: LocalTime) => string
 
 export type DateTimeObject = DateObject & TimeObject
@@ -711,7 +713,7 @@ class LocalTimeFactory {
   /**
    * Returns null if invalid
    */
-  parseOrNull(d: LocalTimeInput | undefined | null): LocalTime | null {
+  parseOrNull(d: LocalTimeInputNullable): LocalTime | null {
     if (!d) return null
     if (d instanceof LocalTime) return d
 
@@ -768,7 +770,7 @@ class LocalTimeFactory {
     return date.valueOf() / 1000
   }
 
-  isValid(d: LocalTimeInput | undefined | null): boolean {
+  isValid(d: LocalTimeInputNullable): boolean {
     return this.parseOrNull(d) !== null
   }
 
@@ -800,14 +802,14 @@ class LocalTimeFactory {
    *
    * `localTime` function will instead return LocalTime of `now` for falsy input.
    */
-  orUndefined(d: LocalTimeInput | null | undefined): LocalTime | undefined {
+  orUndefined(d: LocalTimeInputNullable): LocalTime | undefined {
     return d ? this.of(d) : undefined
   }
 
   /**
    * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
    */
-  orNow(d: LocalTimeInput | null | undefined): LocalTime {
+  orNow(d: LocalTimeInputNullable): LocalTime {
     return d ? this.of(d) : this.now()
   }
 
@@ -827,26 +829,28 @@ class LocalTimeFactory {
     })
   }
 
-  minOrUndefined(items: LocalTimeInput[]): LocalTime | undefined {
+  minOrUndefined(items: LocalTimeInputNullable[]): LocalTime | undefined {
     return items.length ? this.min(items) : undefined
   }
 
-  min(items: LocalTimeInput[]): LocalTime {
-    _assert(items.length, 'localTime.min called on empty array')
+  min(items: LocalTimeInputNullable[]): LocalTime {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'localTime.min called on empty array')
 
-    return items
+    return items2
       .map(i => this.of(i))
       .reduce((min, item) => (min.$date.valueOf() <= item.$date.valueOf() ? min : item))
   }
 
-  maxOrUndefined(items: LocalTimeInput[]): LocalTime | undefined {
+  maxOrUndefined(items: LocalTimeInputNullable[]): LocalTime | undefined {
     return items.length ? this.max(items) : undefined
   }
 
-  max(items: LocalTimeInput[]): LocalTime {
-    _assert(items.length, 'localTime.max called on empty array')
+  max(items: LocalTimeInputNullable[]): LocalTime {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'localTime.max called on empty array')
 
-    return items
+    return items2
       .map(i => this.of(i))
       .reduce((max, item) => (max.$date.valueOf() >= item.$date.valueOf() ? max : item))
   }

package/src/semver.ts

@@ -1,7 +1,10 @@
 import { _range } from './array/range'
 import { _assert } from './error/assert'
+import { _isTruthy } from './is.util'
+import { SortDirection } from './types'
 
 export type SemverInput = string | Semver
+export type SemverInputNullable = SemverInput | null | undefined
 export type SemverTokens = [major: number, minor: number, patch: number]
 
 /**
@@ -72,7 +75,7 @@ class SemverFactory {
     return s
   }
 
-  parseOrNull(input: SemverInput | undefined | null): Semver | null {
+  parseOrNull(input: SemverInputNullable): Semver | null {
     if (!input) return null
     if (input instanceof Semver) return input
 
@@ -83,7 +86,7 @@ class SemverFactory {
   /**
    * Returns the highest (max) Semver from the array, or undefined if the array is empty.
    */
-  maxOrUndefined(items: SemverInput[]): Semver | undefined {
+  maxOrUndefined(items: SemverInputNullable[]): Semver | undefined {
     return items.length ? this.max(items) : undefined
   }
 
@@ -91,15 +94,16 @@ class SemverFactory {
    * Returns the highest Semver from the array.
    * Throws if the array is empty.
    */
-  max(items: SemverInput[]): Semver {
-    _assert(items.length, 'semver.max called on empty array')
-    return items.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
+  max(items: SemverInputNullable[]): Semver {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'semver.max called on empty array')
+    return items2.map(i => this.of(i)).reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
   }
 
   /**
    * Returns the lowest (min) Semver from the array, or undefined if the array is empty.
    */
-  minOrUndefined(items: SemverInput[]): Semver | undefined {
+  minOrUndefined(items: SemverInputNullable[]): Semver | undefined {
     return items.length ? this.min(items) : undefined
   }
 
@@ -107,9 +111,20 @@ class SemverFactory {
    * Returns the lowest Semver from the array.
    * Throws if the array is empty.
    */
-  min(items: SemverInput[]): Semver {
-    _assert(items.length, 'semver.min called on empty array')
-    return items.map(i => this.of(i)).reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
+  min(items: SemverInputNullable[]): Semver {
+    const items2 = items.filter(_isTruthy)
+    _assert(items2.length, 'semver.min called on empty array')
+    return items2
+      .map(i => this.of(i))
+      .reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
+  }
+
+  /**
+   * Sorts an array of Semvers in `dir` order (ascending by default).
+   */
+  sort(items: Semver[], dir: SortDirection = 'asc', mutate = false): Semver[] {
+    const mod = dir === 'desc' ? -1 : 1
+    return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod)
   }
 }