@naturalcycles/js-lib 14.189.0 → 14.190.0

package/dist/datetime/localDate.d.ts

@@ -93,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

@@ -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;
     }
@@ -189,13 +189,13 @@ 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 same or older (<=) than "today" by X units.
      */
     isSameOrOlderThan(n, unit, today) {
-        return this.isSameOrBefore(LocalDate.of(today || new Date()).add(-n, unit));
+        return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Checks if this localDate is younger (>) than "today" by X units.
@@ -207,13 +207,13 @@ class LocalDate {
      * Third argument allows to override "today".
      */
     isYoungerThan(n, unit, today) {
-        return this.isAfter(LocalDate.of(today || new Date()).add(-n, unit));
+        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()).add(-n, unit));
+        return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -297,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;
@@ -361,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

@@ -70,16 +70,16 @@ 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;

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));
@@ -379,13 +379,13 @@ 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()).add(-n, unit));
+        return this.isSameOrBefore(LocalTime.of(now ?? new Date()).plus(-n, unit));
     }
     /**
      * Checks if this localTime is younger (>) than "now" by X units.
@@ -397,13 +397,13 @@ class LocalTime {
      * Third argument allows to override "now".
      */
     isYoungerThan(n, unit, now) {
-        return this.isAfter(LocalTime.of(now ?? new Date()).add(-n, unit));
+        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()).add(-n, unit));
+        return this.isSameOrAfter(LocalTime.of(now ?? new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist-esm/datetime/localDate.js

@@ -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;
     }
@@ -186,13 +186,13 @@ 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 same or older (<=) than "today" by X units.
      */
     isSameOrOlderThan(n, unit, today) {
-        return this.isSameOrBefore(LocalDate.of(today || new Date()).add(-n, unit));
+        return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Checks if this localDate is younger (>) than "today" by X units.
@@ -204,13 +204,13 @@ export class LocalDate {
      * Third argument allows to override "today".
      */
     isYoungerThan(n, unit, today) {
-        return this.isAfter(LocalDate.of(today || new Date()).add(-n, unit));
+        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()).add(-n, unit));
+        return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d
@@ -294,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;
@@ -358,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));
@@ -377,13 +377,13 @@ 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()).add(-n, unit));
+        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.
@@ -395,13 +395,13 @@ export class LocalTime {
      * Third argument allows to override "now".
      */
     isYoungerThan(n, unit, now) {
-        return this.isAfter(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-n, unit));
+        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()).add(-n, unit));
+        return this.isSameOrAfter(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).plus(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.189.0",
+  "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/datetime/localDate.ts

@@ -163,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
@@ -251,14 +251,14 @@ 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 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))
+    return this.isSameOrBefore(LocalDate.of(today || new Date()).plus(-n, unit))
   }
 
   /**
@@ -271,14 +271,14 @@ export class LocalDate {
    * Third argument allows to override "today".
    */
   isYoungerThan(n: number, unit: LocalDateUnit, today?: LocalDateInput): boolean {
-    return this.isAfter(LocalDate.of(today || new Date()).add(-n, unit))
+    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()).add(-n, unit))
+    return this.isSameOrAfter(LocalDate.of(today || new Date()).plus(-n, unit))
   }
 
   /**
@@ -373,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') {
@@ -443,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

@@ -224,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
@@ -267,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'
@@ -281,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 {
@@ -465,14 +465,14 @@ 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 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))
+    return this.isSameOrBefore(LocalTime.of(now ?? new Date()).plus(-n, unit))
   }
 
   /**
@@ -485,14 +485,14 @@ export class LocalTime {
    * Third argument allows to override "now".
    */
   isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
-    return this.isAfter(LocalTime.of(now ?? new Date()).add(-n, unit))
+    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()).add(-n, unit))
+    return this.isSameOrAfter(LocalTime.of(now ?? new Date()).plus(-n, unit))
   }
 
   /**