@naturalcycles/js-lib 14.184.1 → 14.186.0

package/dist/datetime/localDate.d.ts

@@ -55,8 +55,10 @@ export declare class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n: number, unit: LocalDateUnitStrict): boolean;
+    isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/dist/datetime/localDate.js

@@ -185,9 +185,11 @@ class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalDate.today().add(-n, unit));
+    isOlderThan(n, unit, today) {
+        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist/datetime/localTime.d.ts

@@ -93,8 +93,10 @@ export declare class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n: number, unit: LocalTimeUnit): boolean;
+    isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/dist/datetime/localTime.js

@@ -363,9 +363,11 @@ class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalTime.now().add(-n, unit));
+    isOlderThan(n, unit, now) {
+        return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist/object/object.util.d.ts

@@ -189,3 +189,21 @@ export declare function _has<T extends AnyObject>(obj: T, path: string): boolean
  * Based on: https://github.com/substack/deep-freeze/blob/master/index.js
  */
 export declare function _deepFreeze(o: any): void;
+/**
+ * let target: T = { a: 'a', n: 1}
+ * let source: T = { a: 'a2', b: 'b' }
+ *
+ * _objectAssignExact(target, source)
+ *
+ * Does the same as `target = source`,
+ * except that it mutates the target to make it exactly the same as source,
+ * while keeping the reference to the same object.
+ *
+ * This way it can "propagate deletions".
+ * E.g source doesn't have the `n` property, so it'll be deleted from target.
+ * With normal Object.assign - it'll override the keys that `source` has, but not the
+ * "missing/deleted keys".
+ *
+ * To make mutation extra clear - function returns void (unlike Object.assign).
+ */
+export declare function _objectAssignExact<T extends AnyObject>(target: T, source: T): void;

package/dist/object/object.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._deepFreeze = exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
+exports._objectAssignExact = exports._deepFreeze = exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
 const is_util_1 = require("../is.util");
 const types_1 = require("../types");
 /**
@@ -384,3 +384,27 @@ function _deepFreeze(o) {
     });
 }
 exports._deepFreeze = _deepFreeze;
+/**
+ * let target: T = { a: 'a', n: 1}
+ * let source: T = { a: 'a2', b: 'b' }
+ *
+ * _objectAssignExact(target, source)
+ *
+ * Does the same as `target = source`,
+ * except that it mutates the target to make it exactly the same as source,
+ * while keeping the reference to the same object.
+ *
+ * This way it can "propagate deletions".
+ * E.g source doesn't have the `n` property, so it'll be deleted from target.
+ * With normal Object.assign - it'll override the keys that `source` has, but not the
+ * "missing/deleted keys".
+ *
+ * To make mutation extra clear - function returns void (unlike Object.assign).
+ */
+function _objectAssignExact(target, source) {
+    Object.assign(target, source);
+    Object.keys(target)
+        .filter(k => !(k in source))
+        .forEach(k => delete target[k]);
+}
+exports._objectAssignExact = _objectAssignExact;

package/dist-esm/datetime/localDate.js

@@ -182,9 +182,11 @@ export class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalDate.today().add(-n, unit));
+    isOlderThan(n, unit, today) {
+        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d

package/dist-esm/datetime/localTime.js

@@ -361,9 +361,11 @@ export class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalTime.now().add(-n, unit));
+    isOlderThan(n, unit, now) {
+        return this.isBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-n, unit));
     }
     /**
      * Returns 1 if this > d

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

@@ -358,3 +358,26 @@ export function _deepFreeze(o) {
         }
     });
 }
+/**
+ * let target: T = { a: 'a', n: 1}
+ * let source: T = { a: 'a2', b: 'b' }
+ *
+ * _objectAssignExact(target, source)
+ *
+ * Does the same as `target = source`,
+ * except that it mutates the target to make it exactly the same as source,
+ * while keeping the reference to the same object.
+ *
+ * This way it can "propagate deletions".
+ * E.g source doesn't have the `n` property, so it'll be deleted from target.
+ * With normal Object.assign - it'll override the keys that `source` has, but not the
+ * "missing/deleted keys".
+ *
+ * To make mutation extra clear - function returns void (unlike Object.assign).
+ */
+export function _objectAssignExact(target, source) {
+    Object.assign(target, source);
+    Object.keys(target)
+        .filter(k => !(k in source))
+        .forEach(k => delete target[k]);
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.184.1",
+  "version": "14.186.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
-    "docs-serve": "NODE_OPTIONS=--openssl-legacy-provider vuepress dev docs",
-    "docs-build": "NODE_OPTIONS=--openssl-legacy-provider vuepress build docs"
+    "docs-dev": "vitepress dev docs --open",
+    "docs-build": "vitepress build docs",
+    "docs-preview": "vitepress preview docs"
   },
   "dependencies": {
     "tslib": "^2.0.0",
@@ -21,8 +22,8 @@
     "crypto-js": "^4.1.1",
     "jest": "^29.0.0",
     "prettier": "^3.0.0",
-    "vuepress": "^1.7.1",
-    "vuepress-plugin-typescript": "^0.3.1"
+    "vitepress": "^1.0.0-rc.12",
+    "vue": "^3.2.45"
   },
   "resolutions": {
     "expect-type": "0.15.0"

package/src/datetime/localDate.ts

@@ -246,9 +246,11 @@ export class LocalDate {
    * Example:
    *
    * localDate(expirationDate).isOlderThan(5, 'day')
+   *
+   * Third argument allows to override "today".
    */
-  isOlderThan(n: number, unit: LocalDateUnitStrict): boolean {
-    return this.isBefore(LocalDate.today().add(-n, unit))
+  isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
+    return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit))
   }
 
   /**

package/src/datetime/localTime.ts

@@ -446,9 +446,11 @@ export class LocalTime {
    * Example:
    *
    * localTime(expirationDate).isOlderThan(5, 'day')
+   *
+   * Third argument allows to override "now".
    */
-  isOlderThan(n: number, unit: LocalTimeUnit): boolean {
-    return this.isBefore(LocalTime.now().add(-n, unit))
+  isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit))
   }
 
   /**

package/src/object/object.util.ts

@@ -419,3 +419,27 @@ export function _deepFreeze(o: any): void {
     }
   })
 }
+
+/**
+ * let target: T = { a: 'a', n: 1}
+ * let source: T = { a: 'a2', b: 'b' }
+ *
+ * _objectAssignExact(target, source)
+ *
+ * Does the same as `target = source`,
+ * except that it mutates the target to make it exactly the same as source,
+ * while keeping the reference to the same object.
+ *
+ * This way it can "propagate deletions".
+ * E.g source doesn't have the `n` property, so it'll be deleted from target.
+ * With normal Object.assign - it'll override the keys that `source` has, but not the
+ * "missing/deleted keys".
+ *
+ * To make mutation extra clear - function returns void (unlike Object.assign).
+ */
+export function _objectAssignExact<T extends AnyObject>(target: T, source: T): void {
+  Object.assign(target, source)
+  Object.keys(target)
+    .filter(k => !(k in source))
+    .forEach(k => delete target[k])
+}