@naturalcycles/js-lib 14.188.1 → 14.189.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:
      *
@@ -58,9 +58,13 @@ export declare class LocalDate {
      *
      * Third argument allows to override "today".
      */
-    isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean;
+    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:
      *
@@ -68,7 +72,11 @@ export declare class LocalDate {
      *
      * Third argument allows to override "today".
      */
-    isYoungerThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean;
+    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
@@ -91,6 +99,10 @@ export declare class LocalDate {
      * Alias to subtract
      */
     minus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
+    /**
+     * Alias to add
+     */
+    plus(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) {
@@ -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:
      *
@@ -192,7 +192,13 @@ class LocalDate {
         return this.isBefore(LocalDate.of(today || new Date()).add(-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()).add(-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()).add(-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()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -358,6 +370,12 @@ class LocalDate {
     minus(num, unit, mutate = false) {
         return this.add(-num, unit, mutate);
     }
+    /**
+     * Alias to add
+     */
+    plus(num, unit, mutate = false) {
+        return this.add(num, unit, mutate);
+    }
     startOf(unit) {
         if (unit === 'day')
             return this;

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';
@@ -76,11 +76,15 @@ export declare class LocalTime {
      * Alias to subtract.
      */
     minus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
+    /**
+     * Alias to add.
+     */
+    plus(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;
@@ -92,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:
      *
@@ -102,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:
      *
@@ -111,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

@@ -220,6 +220,12 @@ class LocalTime {
     minus(num, unit, mutate = false) {
         return this.add(num * -1, unit, mutate);
     }
+    /**
+     * Alias to add.
+     */
+    plus(num, unit, mutate = false) {
+        return this.add(num, unit, mutate);
+    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }
@@ -308,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();
@@ -364,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:
      *
@@ -376,7 +382,13 @@ class LocalTime {
         return this.isBefore(LocalTime.of(now ?? new Date()).add(-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, unit, now) {
+        return this.isSameOrBefore(LocalTime.of(now ?? new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localTime is younger (>) than "now" by X units.
      *
      * Example:
      *
@@ -385,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()).add(-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()).add(-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) {
@@ -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:
      *
@@ -189,7 +189,13 @@ export class LocalDate {
         return this.isBefore(LocalDate.of(today || new Date()).add(-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()).add(-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()).add(-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()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -355,6 +367,12 @@ export class LocalDate {
     minus(num, unit, mutate = false) {
         return this.add(-num, unit, mutate);
     }
+    /**
+     * Alias to add
+     */
+    plus(num, unit, mutate = false) {
+        return this.add(num, unit, mutate);
+    }
     startOf(unit) {
         if (unit === 'day')
             return this;

package/dist-esm/datetime/localTime.js

@@ -218,6 +218,12 @@ export class LocalTime {
     minus(num, unit, mutate = false) {
         return this.add(num * -1, unit, mutate);
     }
+    /**
+     * Alias to add.
+     */
+    plus(num, unit, mutate = false) {
+        return this.add(num, unit, mutate);
+    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }
@@ -306,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();
@@ -362,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:
      *
@@ -374,7 +380,13 @@ export class LocalTime {
         return this.isBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-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, unit, now) {
+        return this.isSameOrBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localTime is younger (>) than "now" by X units.
      *
      * Example:
      *
@@ -383,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()).add(-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()).add(-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.1",
+  "version": "14.189.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

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)
   }
 
@@ -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:
    *
@@ -249,12 +250,19 @@ export class LocalDate {
    *
    * Third argument allows to override "today".
    */
-  isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
+  isOlderThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
     return this.isBefore(LocalDate.of(today || new Date()).add(-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()).add(-n, unit))
+  }
+
+  /**
+   * Checks if this localDate is younger (>) than "today" by X units.
    *
    * Example:
    *
@@ -262,8 +270,15 @@ export class LocalDate {
    *
    * Third argument allows to override "today".
    */
-  isYoungerThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
-    return !this.isOlderThan(n, unit, today)
+  isYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
+    return this.isAfter(LocalDate.of(today || new Date()).add(-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()).add(-n, unit))
   }
 
   /**
@@ -439,6 +454,13 @@ export class LocalDate {
     return this.add(-num, unit, mutate)
   }
 
+  /**
+   * Alias to add
+   */
+  plus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
+    return this.add(num, unit, mutate)
+  }
+
   startOf(unit: LocalDateUnitStrict): LocalDate {
     if (unit === 'day') return this
     if (unit === 'month') return LocalDate.create(this.$year, this.$month, 1)

package/src/datetime/localTime.ts

@@ -4,6 +4,7 @@ import type {
   IsoDateString,
   IsoDateTimeString,
   MonthId,
+  SortDirection,
   UnixTimestampMillisNumber,
   UnixTimestampNumber,
 } from '../types'
@@ -291,6 +292,13 @@ export class LocalTime {
     return this.add(num * -1, unit, mutate)
   }
 
+  /**
+   * Alias to add.
+   */
+  plus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
+    return this.add(num, unit, mutate)
+  }
+
   absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number {
     return Math.abs(this.diff(other, unit))
   }
@@ -382,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()
@@ -448,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:
    *
@@ -461,7 +469,14 @@ export class LocalTime {
   }
 
   /**
-   * 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()).add(-n, unit))
+  }
+
+  /**
+   * Checks if this localTime is younger (>) than "now" by X units.
    *
    * Example:
    *
@@ -470,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()).add(-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()).add(-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'