@naturalcycles/js-lib 14.184.1 → 14.185.0

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/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.185.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/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])
+}