@naturalcycles/js-lib 14.188.2 → 14.190.0

package/dist/array/array.util.d.ts

@@ -1,4 +1,4 @@
-import type { FalsyValue, Mapper, Predicate, StringMap } from '../types';
+import type { FalsyValue, Mapper, Predicate, SortDirection, StringMap } from '../types';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -93,7 +93,11 @@ export declare function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>)
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean, descending?: boolean): T[];
+export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean, dir?: SortDirection): T[];
+/**
+ * Alias for _sortBy with descending order.
+ */
+export declare function _sortDescBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean): T[];
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -151,8 +151,8 @@ exports._groupBy = _groupBy;
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-function _sortBy(items, mapper, mutate = false, descending = false) {
-    const mod = descending ? -1 : 1;
+function _sortBy(items, mapper, mutate = false, dir = 'asc') {
+    const mod = dir === 'desc' ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper);
         if (typeof a === 'number' && typeof b === 'number')
@@ -161,6 +161,13 @@ function _sortBy(items, mapper, mutate = false, descending = false) {
     });
 }
 exports._sortBy = _sortBy;
+/**
+ * Alias for _sortBy with descending order.
+ */
+function _sortDescBy(items, mapper, mutate = false) {
+    return _sortBy(items, mapper, mutate, 'desc');
+}
+exports._sortDescBy = _sortDescBy;
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/dist/datetime/localDate.d.ts

@@ -1,4 +1,4 @@
-import type { IsoDateString, IsoDateTimeString, MonthId, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
+import type { IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { LocalTime } from './localTime';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
 export type LocalDateUnitStrict = 'year' | 'month' | 'day';
@@ -29,7 +29,7 @@ export declare class LocalDate {
     static isValid(iso: string | undefined | null): boolean;
     static today(): LocalDate;
     static todayUTC(): LocalDate;
-    static sort(items: LocalDate[], mutate?: boolean, descending?: boolean): LocalDate[];
+    static sort(items: LocalDate[], mutate?: boolean, dir?: SortDirection): LocalDate[];
     static earliestOrUndefined(items: LocalDateInput[]): LocalDate | undefined;
     static earliest(items: LocalDateInput[]): LocalDate;
     static latestOrUndefined(items: LocalDateInput[]): LocalDate | undefined;
@@ -50,7 +50,7 @@ export declare class LocalDate {
     isSameOrAfter(d: LocalDateInput): boolean;
     isBetween(min: LocalDateInput, max: LocalDateInput, incl?: Inclusiveness): boolean;
     /**
-     * Checks if this localDate is older than "today" by X units.
+     * Checks if this localDate is older (<) than "today" by X units.
      *
      * Example:
      *
@@ -60,7 +60,11 @@ export declare class LocalDate {
      */
     isOlderThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean;
     /**
-     * Checks if this localDate is younger than "today" by X units.
+     * Checks if this localDate is same or older (<=) than "today" by X units.
+     */
+    isSameOrOlderThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean;
+    /**
+     * Checks if this localDate is younger (>) than "today" by X units.
      *
      * Example:
      *
@@ -69,6 +73,10 @@ export declare class LocalDate {
      * Third argument allows to override "today".
      */
     isYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean;
+    /**
+     * Checks if this localDate is same or younger (>=) than "today" by X units.
+     */
+    isSameOrYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal
@@ -85,16 +93,16 @@ export declare class LocalDate {
      * a.diff(b) means "a minus b"
      */
     diff(d: LocalDateInput, unit: LocalDateUnit): number;
-    add(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
-    subtract(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
+    plus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     /**
-     * Alias to subtract
+     * @deprecated use `minus` instead
      */
+    subtract(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     minus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     /**
-     * Alias to add
+     * @deprecated use `plus` instead
      */
-    plus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
+    add(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     startOf(unit: LocalDateUnitStrict): LocalDate;
     endOf(unit: LocalDateUnitStrict): LocalDate;
     static getYearLength(year: number): number;

package/dist/datetime/localDate.js

@@ -81,8 +81,8 @@ class LocalDate {
     static todayUTC() {
         return this.fromDateUTC(new Date());
     }
-    static sort(items, mutate = false, descending = false) {
-        const mod = descending ? -1 : 1;
+    static sort(items, mutate = false, dir = 'asc') {
+        const mod = dir === 'desc' ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);
     }
     static earliestOrUndefined(items) {
@@ -117,12 +117,12 @@ class LocalDate {
             // ok
         }
         else {
-            current.add(1, stepUnit, true);
+            current.plus(1, stepUnit, true);
         }
         const incl2 = incl[1] === ']';
         while (current.isBefore($max, incl2)) {
             dates.push(current);
-            current = current.add(step, stepUnit);
+            current = current.plus(step, stepUnit);
         }
         return dates;
     }
@@ -180,7 +180,7 @@ class LocalDate {
         return true;
     }
     /**
-     * Checks if this localDate is older than "today" by X units.
+     * Checks if this localDate is older (<) than "today" by X units.
      *
      * Example:
      *
@@ -189,10 +189,16 @@ class LocalDate {
      * Third argument allows to override "today".
      */
     isOlderThan(n, unit, today) {
-        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
+        return this.isBefore(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
-     * Checks if this localDate is younger than "today" by X units.
+     * Checks if this localDate is same or older (<=) than "today" by X units.
+     */
+    isSameOrOlderThan(n, unit, today) {
+        return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localDate is younger (>) than "today" by X units.
      *
      * Example:
      *
@@ -201,7 +207,13 @@ class LocalDate {
      * Third argument allows to override "today".
      */
     isYoungerThan(n, unit, today) {
-        return !this.isOlderThan(n, unit, today);
+        return this.isAfter(LocalDate.of(today || new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localDate is same or younger (>=) than "today" by X units.
+     */
+    isSameOrYoungerThan(n, unit, today) {
+        return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -285,7 +297,7 @@ class LocalDate {
         }
         return days * sign || 0;
     }
-    add(num, unit, mutate = false) {
+    plus(num, unit, mutate = false) {
         let { $day, $month, $year } = this;
         if (unit === 'week') {
             num *= 7;
@@ -349,20 +361,20 @@ class LocalDate {
         }
         return new LocalDate($year, $month, $day);
     }
-    subtract(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
-    }
     /**
-     * Alias to subtract
+     * @deprecated use `minus` instead
      */
+    subtract(num, unit, mutate = false) {
+        return this.plus(-num, unit, mutate);
+    }
     minus(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
+        return this.plus(-num, unit, mutate);
     }
     /**
-     * Alias to add
+     * @deprecated use `plus` instead
      */
-    plus(num, unit, mutate = false) {
-        return this.add(num, unit, mutate);
+    add(num, unit, mutate = false) {
+        return this.plus(num, unit, mutate);
     }
     startOf(unit) {
         if (unit === 'day')

package/dist/datetime/localTime.d.ts

@@ -1,4 +1,4 @@
-import type { IsoDateString, IsoDateTimeString, MonthId, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
+import type { IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import type { Inclusiveness } from './localDate';
 import { LocalDate } from './localDate';
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
@@ -70,21 +70,21 @@ export declare class LocalTime {
     second(): number;
     second(v: number): LocalTime;
     setComponents(c: Partial<LocalTimeComponents>, mutate?: boolean): LocalTime;
-    add(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
-    subtract(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
+    plus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     /**
-     * Alias to subtract.
+     * @deprecated use `minus` instead
      */
+    subtract(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     minus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     /**
-     * Alias to add.
+     * @deprecated use `plus` instead
      */
-    plus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
+    add(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     diff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     startOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     endOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;
-    static sort(items: LocalTime[], mutate?: boolean, descending?: boolean): LocalTime[];
+    static sort(items: LocalTime[], mutate?: boolean, dir?: SortDirection): LocalTime[];
     static earliestOrUndefined(items: LocalTimeInput[]): LocalTime | undefined;
     static earliest(items: LocalTimeInput[]): LocalTime;
     static latestOrUndefined(items: LocalTimeInput[]): LocalTime | undefined;
@@ -96,7 +96,7 @@ export declare class LocalTime {
     isSameOrAfter(d: LocalTimeInput): boolean;
     isBetween(min: LocalTimeInput, max: LocalTimeInput, incl?: Inclusiveness): boolean;
     /**
-     * Checks if this localTime is older than "now" by X units.
+     * Checks if this localTime is older (<) than "now" by X units.
      *
      * Example:
      *
@@ -106,7 +106,11 @@ export declare class LocalTime {
      */
     isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
     /**
-     * Checks if this localTime is younger than "now" by X units.
+     * Checks if this localTime is same or older (<=) than "now" by X units.
+     */
+    isSameOrOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
+    /**
+     * Checks if this localTime is younger (>) than "now" by X units.
      *
      * Example:
      *
@@ -115,6 +119,10 @@ export declare class LocalTime {
      * Third argument allows to override "now".
      */
     isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
+    /**
+     * Checks if this localTime is same or younger (>=) than "now" by X units.
+     */
+    isSameOrYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/dist/datetime/localTime.js

@@ -172,7 +172,7 @@ class LocalTime {
             return dow;
         }
         (0, assert_1._assert)(VALID_DAYS_OF_WEEK.has(v), `Invalid dayOfWeek: ${v}`);
-        return this.add(v - dow, 'day');
+        return this.plus(v - dow, 'day');
     }
     hour(v) {
         return v === undefined ? this.get('hour') : this.set('hour', v);
@@ -200,7 +200,7 @@ class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
-    add(num, unit, mutate = false) {
+    plus(num, unit, mutate = false) {
         if (unit === 'week') {
             num *= 7;
             unit = 'day';
@@ -211,20 +211,20 @@ class LocalTime {
         }
         return this.set(unit, this.get(unit) + num, mutate);
     }
-    subtract(num, unit, mutate = false) {
-        return this.add(num * -1, unit, mutate);
-    }
     /**
-     * Alias to subtract.
+     * @deprecated use `minus` instead
      */
+    subtract(num, unit, mutate = false) {
+        return this.plus(num * -1, unit, mutate);
+    }
     minus(num, unit, mutate = false) {
-        return this.add(num * -1, unit, mutate);
+        return this.plus(num * -1, unit, mutate);
     }
     /**
-     * Alias to add.
+     * @deprecated use `plus` instead
      */
-    plus(num, unit, mutate = false) {
-        return this.add(num, unit, mutate);
+    add(num, unit, mutate = false) {
+        return this.plus(num, unit, mutate);
     }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
@@ -314,8 +314,8 @@ class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
-    static sort(items, mutate = false, descending = false) {
-        const mod = descending ? -1 : 1;
+    static sort(items, mutate = false, dir = 'asc') {
+        const mod = dir === 'desc' ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => {
             const v1 = a.$date.valueOf();
             const v2 = b.$date.valueOf();
@@ -370,7 +370,7 @@ class LocalTime {
         return true;
     }
     /**
-     * Checks if this localTime is older than "now" by X units.
+     * Checks if this localTime is older (<) than "now" by X units.
      *
      * Example:
      *
@@ -379,10 +379,16 @@ class LocalTime {
      * Third argument allows to override "now".
      */
     isOlderThan(n, unit, now) {
-        return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit));
+        return this.isBefore(LocalTime.of(now ?? new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localTime is same or older (<=) than "now" by X units.
+     */
+    isSameOrOlderThan(n, unit, now) {
+        return this.isSameOrBefore(LocalTime.of(now ?? new Date()).plus(-n, unit));
     }
     /**
-     * Checks if this localTime is younger than "now" by X units.
+     * Checks if this localTime is younger (>) than "now" by X units.
      *
      * Example:
      *
@@ -391,7 +397,13 @@ class LocalTime {
      * Third argument allows to override "now".
      */
     isYoungerThan(n, unit, now) {
-        return !this.isOlderThan(n, unit, now);
+        return this.isAfter(LocalTime.of(now ?? new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localTime is same or younger (>=) than "now" by X units.
+     */
+    isSameOrYoungerThan(n, unit, now) {
+        return this.isSameOrAfter(LocalTime.of(now ?? new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist/is.util.d.ts

@@ -28,6 +28,7 @@ export declare const _isFalsy: <T>(v: T) => v is Falsy<T>;
 export declare function _isObject(obj: any): obj is AnyObject;
 export declare function _isPrimitive(v: any): v is Primitive;
 export declare function _isEmptyObject(obj: AnyObject): boolean;
+export declare function _isNotEmptyObject(obj: AnyObject): boolean;
 /**
  * Object is considered empty if it's one of:
  * undefined

package/dist/is.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._isNotEmpty = exports._isEmpty = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._isFalsy = exports._isTruthy = exports._isNotNullish = exports._isNullish = exports._isUndefined = exports._isNull = void 0;
+exports._isNotEmpty = exports._isEmpty = exports._isNotEmptyObject = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._isFalsy = exports._isTruthy = exports._isNotNullish = exports._isNullish = exports._isUndefined = exports._isNull = void 0;
 const _isNull = (v) => v === null;
 exports._isNull = _isNull;
 const _isUndefined = (v) => v === undefined;
@@ -47,6 +47,10 @@ function _isEmptyObject(obj) {
     return Object.keys(obj).length === 0;
 }
 exports._isEmptyObject = _isEmptyObject;
+function _isNotEmptyObject(obj) {
+    return Object.keys(obj).length > 0;
+}
+exports._isNotEmptyObject = _isNotEmptyObject;
 /**
  * Object is considered empty if it's one of:
  * undefined

package/dist/number/number.util.d.ts

@@ -1,3 +1,4 @@
+import { SortDirection } from '../types';
 export declare function _randomInt(minIncl: number, maxIncl: number): number;
 /**
  * Returns random item from an array.
@@ -23,7 +24,7 @@ export declare function _clamp(x: number, minIncl: number, maxIncl: number): num
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export declare function _sortNumbers(numbers: number[], mutate?: boolean, descending?: boolean): number[];
+export declare function _sortNumbers(numbers: number[], mutate?: boolean, dir?: SortDirection): number[];
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.
  *

package/dist/number/number.util.js

@@ -39,8 +39,8 @@ exports._clamp = _clamp;
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-function _sortNumbers(numbers, mutate = false, descending = false) {
-    const mod = descending ? -1 : 1;
+function _sortNumbers(numbers, mutate = false, dir = 'asc') {
+    const mod = dir === 'desc' ? -1 : 1;
     return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 exports._sortNumbers = _sortNumbers;

package/dist/types.d.ts

@@ -242,3 +242,4 @@ export declare const _objectAssign: <T extends AnyObject>(target: T, part: Parti
  * Functions like pTry use that.
  */
 export type ErrorDataTuple<T = unknown, ERR = Error> = [err: null, data: T] | [err: ERR, data: null];
+export type SortDirection = 'asc' | 'desc';

package/dist-esm/array/array.util.js

@@ -141,8 +141,8 @@ export function _groupBy(items, mapper) {
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export function _sortBy(items, mapper, mutate = false, descending = false) {
-    const mod = descending ? -1 : 1;
+export function _sortBy(items, mapper, mutate = false, dir = 'asc') {
+    const mod = dir === 'desc' ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper);
         if (typeof a === 'number' && typeof b === 'number')
@@ -150,6 +150,12 @@ export function _sortBy(items, mapper, mutate = false, descending = false) {
         return String(a).localeCompare(String(b)) * mod;
     });
 }
+/**
+ * Alias for _sortBy with descending order.
+ */
+export function _sortDescBy(items, mapper, mutate = false) {
+    return _sortBy(items, mapper, mutate, 'desc');
+}
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/dist-esm/datetime/localDate.js

@@ -78,8 +78,8 @@ export class LocalDate {
     static todayUTC() {
         return this.fromDateUTC(new Date());
     }
-    static sort(items, mutate = false, descending = false) {
-        const mod = descending ? -1 : 1;
+    static sort(items, mutate = false, dir = 'asc') {
+        const mod = dir === 'desc' ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod);
     }
     static earliestOrUndefined(items) {
@@ -114,12 +114,12 @@ export class LocalDate {
             // ok
         }
         else {
-            current.add(1, stepUnit, true);
+            current.plus(1, stepUnit, true);
         }
         const incl2 = incl[1] === ']';
         while (current.isBefore($max, incl2)) {
             dates.push(current);
-            current = current.add(step, stepUnit);
+            current = current.plus(step, stepUnit);
         }
         return dates;
     }
@@ -177,7 +177,7 @@ export class LocalDate {
         return true;
     }
     /**
-     * Checks if this localDate is older than "today" by X units.
+     * Checks if this localDate is older (<) than "today" by X units.
      *
      * Example:
      *
@@ -186,10 +186,16 @@ export class LocalDate {
      * Third argument allows to override "today".
      */
     isOlderThan(n, unit, today) {
-        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
+        return this.isBefore(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
-     * Checks if this localDate is younger than "today" by X units.
+     * Checks if this localDate is same or older (<=) than "today" by X units.
+     */
+    isSameOrOlderThan(n, unit, today) {
+        return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localDate is younger (>) than "today" by X units.
      *
      * Example:
      *
@@ -198,7 +204,13 @@ export class LocalDate {
      * Third argument allows to override "today".
      */
     isYoungerThan(n, unit, today) {
-        return !this.isOlderThan(n, unit, today);
+        return this.isAfter(LocalDate.of(today || new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localDate is same or younger (>=) than "today" by X units.
+     */
+    isSameOrYoungerThan(n, unit, today) {
+        return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -282,7 +294,7 @@ export class LocalDate {
         }
         return days * sign || 0;
     }
-    add(num, unit, mutate = false) {
+    plus(num, unit, mutate = false) {
         let { $day, $month, $year } = this;
         if (unit === 'week') {
             num *= 7;
@@ -346,20 +358,20 @@ export class LocalDate {
         }
         return new LocalDate($year, $month, $day);
     }
-    subtract(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
-    }
     /**
-     * Alias to subtract
+     * @deprecated use `minus` instead
      */
+    subtract(num, unit, mutate = false) {
+        return this.plus(-num, unit, mutate);
+    }
     minus(num, unit, mutate = false) {
-        return this.add(-num, unit, mutate);
+        return this.plus(-num, unit, mutate);
     }
     /**
-     * Alias to add
+     * @deprecated use `plus` instead
      */
-    plus(num, unit, mutate = false) {
-        return this.add(num, unit, mutate);
+    add(num, unit, mutate = false) {
+        return this.plus(num, unit, mutate);
     }
     startOf(unit) {
         if (unit === 'day')

package/dist-esm/datetime/localTime.js

@@ -169,7 +169,7 @@ export class LocalTime {
             return dow;
         }
         _assert(VALID_DAYS_OF_WEEK.has(v), `Invalid dayOfWeek: ${v}`);
-        return this.add(v - dow, 'day');
+        return this.plus(v - dow, 'day');
     }
     hour(v) {
         return v === undefined ? this.get('hour') : this.set('hour', v);
@@ -198,7 +198,7 @@ export class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
-    add(num, unit, mutate = false) {
+    plus(num, unit, mutate = false) {
         if (unit === 'week') {
             num *= 7;
             unit = 'day';
@@ -209,20 +209,20 @@ export class LocalTime {
         }
         return this.set(unit, this.get(unit) + num, mutate);
     }
-    subtract(num, unit, mutate = false) {
-        return this.add(num * -1, unit, mutate);
-    }
     /**
-     * Alias to subtract.
+     * @deprecated use `minus` instead
      */
+    subtract(num, unit, mutate = false) {
+        return this.plus(num * -1, unit, mutate);
+    }
     minus(num, unit, mutate = false) {
-        return this.add(num * -1, unit, mutate);
+        return this.plus(num * -1, unit, mutate);
     }
     /**
-     * Alias to add.
+     * @deprecated use `plus` instead
      */
-    plus(num, unit, mutate = false) {
-        return this.add(num, unit, mutate);
+    add(num, unit, mutate = false) {
+        return this.plus(num, unit, mutate);
     }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
@@ -312,8 +312,8 @@ export class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
-    static sort(items, mutate = false, descending = false) {
-        const mod = descending ? -1 : 1;
+    static sort(items, mutate = false, dir = 'asc') {
+        const mod = dir === 'desc' ? -1 : 1;
         return (mutate ? items : [...items]).sort((a, b) => {
             const v1 = a.$date.valueOf();
             const v2 = b.$date.valueOf();
@@ -368,7 +368,7 @@ export class LocalTime {
         return true;
     }
     /**
-     * Checks if this localTime is older than "now" by X units.
+     * Checks if this localTime is older (<) than "now" by X units.
      *
      * Example:
      *
@@ -377,10 +377,16 @@ export class LocalTime {
      * Third argument allows to override "now".
      */
     isOlderThan(n, unit, now) {
-        return this.isBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-n, unit));
+        return this.isBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localTime is same or older (<=) than "now" by X units.
+     */
+    isSameOrOlderThan(n, unit, now) {
+        return this.isSameOrBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).plus(-n, unit));
     }
     /**
-     * Checks if this localTime is younger than "now" by X units.
+     * Checks if this localTime is younger (>) than "now" by X units.
      *
      * Example:
      *
@@ -389,7 +395,13 @@ export class LocalTime {
      * Third argument allows to override "now".
      */
     isYoungerThan(n, unit, now) {
-        return !this.isOlderThan(n, unit, now);
+        return this.isAfter(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).plus(-n, unit));
+    }
+    /**
+     * Checks if this localTime is same or younger (>=) than "now" by X units.
+     */
+    isSameOrYoungerThan(n, unit, now) {
+        return this.isSameOrAfter(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist-esm/is.util.js

@@ -35,6 +35,9 @@ export function _isPrimitive(v) {
 export function _isEmptyObject(obj) {
     return Object.keys(obj).length === 0;
 }
+export function _isNotEmptyObject(obj) {
+    return Object.keys(obj).length > 0;
+}
 /**
  * Object is considered empty if it's one of:
  * undefined

package/dist-esm/number/number.util.js

@@ -32,8 +32,8 @@ export function _clamp(x, minIncl, maxIncl) {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers, mutate = false, descending = false) {
-    const mod = descending ? -1 : 1;
+export function _sortNumbers(numbers, mutate = false, dir = 'asc') {
+    const mod = dir === 'desc' ? -1 : 1;
     return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.188.2",
+  "version": "14.190.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -22,7 +22,7 @@
     "crypto-js": "^4.1.1",
     "jest": "^29.0.0",
     "prettier": "^3.0.0",
-    "vitepress": "^1.0.0-rc.12",
+    "vitepress": "^1.0.0-rc.22",
     "vue": "^3.2.45"
   },
   "resolutions": {

package/src/array/array.util.ts

@@ -1,5 +1,5 @@
 import { _isNotNullish } from '../is.util'
-import type { FalsyValue, Mapper, Predicate, StringMap } from '../types'
+import type { FalsyValue, Mapper, Predicate, SortDirection, StringMap } from '../types'
 
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -156,9 +156,9 @@ export function _sortBy<T>(
   items: T[],
   mapper: Mapper<T, any>,
   mutate = false,
-  descending = false,
+  dir: SortDirection = 'asc',
 ): T[] {
-  const mod = descending ? -1 : 1
+  const mod = dir === 'desc' ? -1 : 1
   return (mutate ? items : [...items]).sort((_a, _b) => {
     const [a, b] = [_a, _b].map(mapper)
     if (typeof a === 'number' && typeof b === 'number') return (a - b) * mod
@@ -166,6 +166,13 @@ export function _sortBy<T>(
   })
 }
 
+/**
+ * Alias for _sortBy with descending order.
+ */
+export function _sortDescBy<T>(items: T[], mapper: Mapper<T, any>, mutate = false): T[] {
+  return _sortBy(items, mapper, mutate, 'desc')
+}
+
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/src/datetime/localDate.ts

@@ -3,6 +3,7 @@ import type {
   IsoDateString,
   IsoDateTimeString,
   MonthId,
+  SortDirection,
   UnixTimestampMillisNumber,
   UnixTimestampNumber,
 } from '../types'
@@ -112,8 +113,8 @@ export class LocalDate {
     return this.fromDateUTC(new Date())
   }
 
-  static sort(items: LocalDate[], mutate = false, descending = false): LocalDate[] {
-    const mod = descending ? -1 : 1
+  static sort(items: LocalDate[], mutate = false, dir: SortDirection = 'asc'): LocalDate[] {
+    const mod = dir === 'desc' ? -1 : 1
     return (mutate ? items : [...items]).sort((a, b) => a.cmp(b) * mod)
   }
 
@@ -162,13 +163,13 @@ export class LocalDate {
     if (current.isAfter($min, incl[0] === '[')) {
       // ok
     } else {
-      current.add(1, stepUnit, true)
+      current.plus(1, stepUnit, true)
     }
 
     const incl2 = incl[1] === ']'
     while (current.isBefore($max, incl2)) {
       dates.push(current)
-      current = current.add(step, stepUnit)
+      current = current.plus(step, stepUnit)
     }
 
     return dates
@@ -241,7 +242,7 @@ export class LocalDate {
   }
 
   /**
-   * Checks if this localDate is older than "today" by X units.
+   * Checks if this localDate is older (<) than "today" by X units.
    *
    * Example:
    *
@@ -250,11 +251,18 @@ export class LocalDate {
    * Third argument allows to override "today".
    */
   isOlderThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
-    return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit))
+    return this.isBefore(LocalDate.of(today || new Date()).plus(-n, unit))
   }
 
   /**
-   * Checks if this localDate is younger than "today" by X units.
+   * Checks if this localDate is same or older (<=) than "today" by X units.
+   */
+  isSameOrOlderThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
+    return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit))
+  }
+
+  /**
+   * Checks if this localDate is younger (>) than "today" by X units.
    *
    * Example:
    *
@@ -263,7 +271,14 @@ export class LocalDate {
    * Third argument allows to override "today".
    */
   isYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
-    return !this.isOlderThan(n, unit, today)
+    return this.isAfter(LocalDate.of(today || new Date()).plus(-n, unit))
+  }
+
+  /**
+   * Checks if this localDate is same or younger (>=) than "today" by X units.
+   */
+  isSameOrYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
+    return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit))
   }
 
   /**
@@ -358,7 +373,7 @@ export class LocalDate {
     return days * sign || 0
   }
 
-  add(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
+  plus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
     let { $day, $month, $year } = this
 
     if (unit === 'week') {
@@ -428,22 +443,22 @@ export class LocalDate {
     return new LocalDate($year, $month, $day)
   }
 
+  /**
+   * @deprecated use `minus` instead
+   */
   subtract(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
-    return this.add(-num, unit, mutate)
+    return this.plus(-num, unit, mutate)
   }
 
-  /**
-   * Alias to subtract
-   */
   minus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
-    return this.add(-num, unit, mutate)
+    return this.plus(-num, unit, mutate)
   }
 
   /**
-   * Alias to add
+   * @deprecated use `plus` instead
    */
-  plus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
-    return this.add(num, unit, mutate)
+  add(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
+    return this.plus(num, unit, mutate)
   }
 
   startOf(unit: LocalDateUnitStrict): LocalDate {

package/src/datetime/localTime.ts

@@ -4,6 +4,7 @@ import type {
   IsoDateString,
   IsoDateTimeString,
   MonthId,
+  SortDirection,
   UnixTimestampMillisNumber,
   UnixTimestampNumber,
 } from '../types'
@@ -223,7 +224,7 @@ export class LocalTime {
 
     _assert(VALID_DAYS_OF_WEEK.has(v), `Invalid dayOfWeek: ${v}`)
 
-    return this.add(v - dow, 'day')
+    return this.plus(v - dow, 'day')
   }
   hour(): number
   hour(v: number): LocalTime
@@ -266,7 +267,7 @@ export class LocalTime {
     return mutate ? this : new LocalTime(d)
   }
 
-  add(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
+  plus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
     if (unit === 'week') {
       num *= 7
       unit = 'day'
@@ -280,22 +281,22 @@ export class LocalTime {
     return this.set(unit, this.get(unit) + num, mutate)
   }
 
+  /**
+   * @deprecated use `minus` instead
+   */
   subtract(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.add(num * -1, unit, mutate)
+    return this.plus(num * -1, unit, mutate)
   }
 
-  /**
-   * Alias to subtract.
-   */
   minus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.add(num * -1, unit, mutate)
+    return this.plus(num * -1, unit, mutate)
   }
 
   /**
-   * Alias to add.
+   * @deprecated use `plus` instead
    */
-  plus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.add(num, unit, mutate)
+  add(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
+    return this.plus(num, unit, mutate)
   }
 
   absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number {
@@ -389,8 +390,8 @@ export class LocalTime {
     return mutate ? this : new LocalTime(d)
   }
 
-  static sort(items: LocalTime[], mutate = false, descending = false): LocalTime[] {
-    const mod = descending ? -1 : 1
+  static sort(items: LocalTime[], mutate = false, dir: SortDirection = 'asc'): LocalTime[] {
+    const mod = dir === 'desc' ? -1 : 1
     return (mutate ? items : [...items]).sort((a, b) => {
       const v1 = a.$date.valueOf()
       const v2 = b.$date.valueOf()
@@ -455,7 +456,7 @@ export class LocalTime {
   }
 
   /**
-   * Checks if this localTime is older than "now" by X units.
+   * Checks if this localTime is older (<) than "now" by X units.
    *
    * Example:
    *
@@ -464,11 +465,18 @@ export class LocalTime {
    * Third argument allows to override "now".
    */
   isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
-    return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit))
+    return this.isBefore(LocalTime.of(now ?? new Date()).plus(-n, unit))
   }
 
   /**
-   * Checks if this localTime is younger than "now" by X units.
+   * Checks if this localTime is same or older (<=) than "now" by X units.
+   */
+  isSameOrOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return this.isSameOrBefore(LocalTime.of(now ?? new Date()).plus(-n, unit))
+  }
+
+  /**
+   * Checks if this localTime is younger (>) than "now" by X units.
    *
    * Example:
    *
@@ -477,7 +485,14 @@ export class LocalTime {
    * Third argument allows to override "now".
    */
   isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
-    return !this.isOlderThan(n, unit, now)
+    return this.isAfter(LocalTime.of(now ?? new Date()).plus(-n, unit))
+  }
+
+  /**
+   * Checks if this localTime is same or younger (>=) than "now" by X units.
+   */
+  isSameOrYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return this.isSameOrAfter(LocalTime.of(now ?? new Date()).plus(-n, unit))
   }
 
   /**

package/src/is.util.ts

@@ -49,6 +49,10 @@ export function _isEmptyObject(obj: AnyObject): boolean {
   return Object.keys(obj).length === 0
 }
 
+export function _isNotEmptyObject(obj: AnyObject): boolean {
+  return Object.keys(obj).length > 0
+}
+
 /**
  * Object is considered empty if it's one of:
  * undefined

package/src/number/number.util.ts

@@ -1,3 +1,5 @@
+import { SortDirection } from '../types'
+
 export function _randomInt(minIncl: number, maxIncl: number): number {
   return Math.floor(Math.random() * (maxIncl - minIncl + 1) + minIncl)
 }
@@ -37,8 +39,12 @@ export function _clamp(x: number, minIncl: number, maxIncl: number): number {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers: number[], mutate = false, descending = false): number[] {
-  const mod = descending ? -1 : 1
+export function _sortNumbers(
+  numbers: number[],
+  mutate = false,
+  dir: SortDirection = 'asc',
+): number[] {
+  const mod = dir === 'desc' ? -1 : 1
   return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod)
 }
 

package/src/types.ts

@@ -324,3 +324,5 @@ export const _objectAssign = Object.assign as <T extends AnyObject>(
  * Functions like pTry use that.
  */
 export type ErrorDataTuple<T = unknown, ERR = Error> = [err: null, data: T] | [err: ERR, data: null]
+
+export type SortDirection = 'asc' | 'desc'