@ls-stack/utils 3.34.1 → 3.35.0

package/dist/chunk-QQS7I7ZL.js

@@ -0,0 +1,16 @@
+import {
+  deepEqual
+} from "./chunk-JQFUKJU5.js";
+
+// src/keepPrevIfUnchanged.ts
+function keepPrevIfUnchanged({
+  prev,
+  newValue,
+  equalityFn = deepEqual
+}) {
+  return equalityFn(prev, newValue) ? prev : newValue;
+}
+
+export {
+  keepPrevIfUnchanged
+};

package/dist/keepPrevIfUnchanged.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/keepPrevIfUnchanged.ts
+var keepPrevIfUnchanged_exports = {};
+__export(keepPrevIfUnchanged_exports, {
+  keepPrevIfUnchanged: () => keepPrevIfUnchanged
+});
+module.exports = __toCommonJS(keepPrevIfUnchanged_exports);
+
+// src/deepEqual.ts
+var has = Object.prototype.hasOwnProperty;
+function find(iter, tar, maxDepth) {
+  for (const key of iter.keys()) {
+    if (deepEqual(key, tar, maxDepth)) return key;
+  }
+}
+function deepEqual(foo, bar, maxDepth = 20) {
+  let ctor, len, tmp;
+  if (foo === bar) return true;
+  if (maxDepth && maxDepth <= 0) return false;
+  if (foo && bar && (ctor = foo.constructor) === bar.constructor) {
+    if (ctor === Date)
+      return deepEqual(foo.getTime(), bar.getTime(), maxDepth - 1);
+    if (ctor === RegExp) return foo.toString() === bar.toString();
+    if (ctor === Array) {
+      if ((len = foo.length) === bar.length) {
+        while (len-- && deepEqual(foo[len], bar[len], maxDepth - 1)) ;
+      }
+      return len === -1;
+    }
+    if (ctor === Set) {
+      if (foo.size !== bar.size) {
+        return false;
+      }
+      for (len of foo) {
+        tmp = len;
+        if (tmp && typeof tmp === "object") {
+          tmp = find(bar, tmp, maxDepth - 1);
+          if (!tmp) return false;
+        }
+        if (!bar.has(tmp)) return false;
+      }
+      return true;
+    }
+    if (ctor === Map) {
+      if (foo.size !== bar.size) {
+        return false;
+      }
+      for (len of foo) {
+        tmp = len[0];
+        if (tmp && typeof tmp === "object") {
+          tmp = find(bar, tmp, maxDepth - 1);
+          if (!tmp) return false;
+        }
+        if (!deepEqual(len[1], bar.get(tmp), maxDepth - 1)) {
+          return false;
+        }
+      }
+      return true;
+    }
+    if (!ctor || typeof foo === "object") {
+      len = 0;
+      for (ctor in foo) {
+        if (has.call(foo, ctor) && ++len && !has.call(bar, ctor)) return false;
+        if (!(ctor in bar) || !deepEqual(foo[ctor], bar[ctor], maxDepth - 1))
+          return false;
+      }
+      return Object.keys(bar).length === len;
+    }
+  }
+  return foo !== foo && bar !== bar;
+}
+
+// src/keepPrevIfUnchanged.ts
+function keepPrevIfUnchanged({
+  prev,
+  newValue,
+  equalityFn = deepEqual
+}) {
+  return equalityFn(prev, newValue) ? prev : newValue;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  keepPrevIfUnchanged
+});

package/dist/keepPrevIfUnchanged.d.cts

@@ -0,0 +1,7 @@
+declare function keepPrevIfUnchanged<T>({ prev, newValue, equalityFn, }: {
+    prev: T;
+    newValue: T;
+    equalityFn?: (foo: any, bar: any) => boolean;
+}): T;
+
+export { keepPrevIfUnchanged };

package/dist/keepPrevIfUnchanged.d.ts

@@ -0,0 +1,7 @@
+declare function keepPrevIfUnchanged<T>({ prev, newValue, equalityFn, }: {
+    prev: T;
+    newValue: T;
+    equalityFn?: (foo: any, bar: any) => boolean;
+}): T;
+
+export { keepPrevIfUnchanged };

package/dist/keepPrevIfUnchanged.js

@@ -0,0 +1,7 @@
+import {
+  keepPrevIfUnchanged
+} from "./chunk-QQS7I7ZL.js";
+import "./chunk-JQFUKJU5.js";
+export {
+  keepPrevIfUnchanged
+};

package/dist/mutationUtils.cjs

@@ -0,0 +1,118 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/mutationUtils.ts
+var mutationUtils_exports = {};
+__export(mutationUtils_exports, {
+  updateObject: () => updateObject
+});
+module.exports = __toCommonJS(mutationUtils_exports);
+
+// src/deepEqual.ts
+var has = Object.prototype.hasOwnProperty;
+function find(iter, tar, maxDepth) {
+  for (const key of iter.keys()) {
+    if (deepEqual(key, tar, maxDepth)) return key;
+  }
+}
+function deepEqual(foo, bar, maxDepth = 20) {
+  let ctor, len, tmp;
+  if (foo === bar) return true;
+  if (maxDepth && maxDepth <= 0) return false;
+  if (foo && bar && (ctor = foo.constructor) === bar.constructor) {
+    if (ctor === Date)
+      return deepEqual(foo.getTime(), bar.getTime(), maxDepth - 1);
+    if (ctor === RegExp) return foo.toString() === bar.toString();
+    if (ctor === Array) {
+      if ((len = foo.length) === bar.length) {
+        while (len-- && deepEqual(foo[len], bar[len], maxDepth - 1)) ;
+      }
+      return len === -1;
+    }
+    if (ctor === Set) {
+      if (foo.size !== bar.size) {
+        return false;
+      }
+      for (len of foo) {
+        tmp = len;
+        if (tmp && typeof tmp === "object") {
+          tmp = find(bar, tmp, maxDepth - 1);
+          if (!tmp) return false;
+        }
+        if (!bar.has(tmp)) return false;
+      }
+      return true;
+    }
+    if (ctor === Map) {
+      if (foo.size !== bar.size) {
+        return false;
+      }
+      for (len of foo) {
+        tmp = len[0];
+        if (tmp && typeof tmp === "object") {
+          tmp = find(bar, tmp, maxDepth - 1);
+          if (!tmp) return false;
+        }
+        if (!deepEqual(len[1], bar.get(tmp), maxDepth - 1)) {
+          return false;
+        }
+      }
+      return true;
+    }
+    if (!ctor || typeof foo === "object") {
+      len = 0;
+      for (ctor in foo) {
+        if (has.call(foo, ctor) && ++len && !has.call(bar, ctor)) return false;
+        if (!(ctor in bar) || !deepEqual(foo[ctor], bar[ctor], maxDepth - 1))
+          return false;
+      }
+      return Object.keys(bar).length === len;
+    }
+  }
+  return foo !== foo && bar !== bar;
+}
+
+// src/keepPrevIfUnchanged.ts
+function keepPrevIfUnchanged({
+  prev,
+  newValue,
+  equalityFn = deepEqual
+}) {
+  return equalityFn(prev, newValue) ? prev : newValue;
+}
+
+// src/mutationUtils.ts
+function updateObject(object, updates) {
+  if (!object || typeof object !== "object") {
+    return;
+  }
+  for (const key of Object.keys(updates)) {
+    const value = updates[key];
+    if (value !== void 0) {
+      object[key] = keepPrevIfUnchanged({
+        prev: object[key],
+        newValue: value
+      });
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  updateObject
+});

package/dist/mutationUtils.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Updates an object with a new set of values. undefined values are ignored in the updates object
+ * and deep equal values are not updated.
+ *
+ * @param object - The object to update.
+ * @param updates - The new values to update the object with.
+ */
+declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+
+export { updateObject };

package/dist/mutationUtils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Updates an object with a new set of values. undefined values are ignored in the updates object
+ * and deep equal values are not updated.
+ *
+ * @param object - The object to update.
+ * @param updates - The new values to update the object with.
+ */
+declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+
+export { updateObject };

package/dist/mutationUtils.js

@@ -0,0 +1,23 @@
+import {
+  keepPrevIfUnchanged
+} from "./chunk-QQS7I7ZL.js";
+import "./chunk-JQFUKJU5.js";
+
+// src/mutationUtils.ts
+function updateObject(object, updates) {
+  if (!object || typeof object !== "object") {
+    return;
+  }
+  for (const key of Object.keys(updates)) {
+    const value = updates[key];
+    if (value !== void 0) {
+      object[key] = keepPrevIfUnchanged({
+        prev: object[key],
+        newValue: value
+      });
+    }
+  }
+}
+export {
+  updateObject
+};

package/docs/_media/modules.md

@@ -27,9 +27,11 @@
 - [getValueStableKey](getValueStableKey.md)
 - [hash](hash.md)
 - [interpolate](interpolate/README.md)
+- [keepPrevIfUnchanged](keepPrevIfUnchanged.md)
 - [levenshtein](levenshtein.md)
 - [main](main.md)
 - [mathUtils](mathUtils.md)
+- [mutationUtils](mutationUtils.md)
 - [objUtils](objUtils.md)
 - [parallelAsyncCalls](parallelAsyncCalls/README.md)
 - [promiseUtils](promiseUtils/README.md)

package/docs/keepPrevIfUnchanged.md

@@ -0,0 +1,43 @@
+[**@ls-stack/utils**](README.md)
+
+***
+
+[@ls-stack/utils](modules.md) / keepPrevIfUnchanged
+
+# keepPrevIfUnchanged
+
+## Functions
+
+### keepPrevIfUnchanged()
+
+```ts
+function keepPrevIfUnchanged<T>(__namedParameters): T;
+```
+
+Defined in: [packages/utils/src/keepPrevIfUnchanged.ts:3](https://github.com/lucasols/utils/blob/main/packages/utils/src/keepPrevIfUnchanged.ts#L3)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+#### Parameters
+
+##### \_\_namedParameters
+
+###### equalityFn?
+
+(`foo`, `bar`) => `boolean` = `deepEqual`
+
+###### newValue
+
+`T`
+
+###### prev
+
+`T`
+
+#### Returns
+
+`T`

package/docs/modules.md

@@ -27,9 +27,11 @@
 - [getValueStableKey](getValueStableKey.md)
 - [hash](hash.md)
 - [interpolate](interpolate/README.md)
+- [keepPrevIfUnchanged](keepPrevIfUnchanged.md)
 - [levenshtein](levenshtein.md)
 - [main](main.md)
 - [mathUtils](mathUtils.md)
+- [mutationUtils](mutationUtils.md)
 - [objUtils](objUtils.md)
 - [parallelAsyncCalls](parallelAsyncCalls/README.md)
 - [promiseUtils](promiseUtils/README.md)

package/docs/mutationUtils.md

@@ -0,0 +1,44 @@
+[**@ls-stack/utils**](README.md)
+
+***
+
+[@ls-stack/utils](modules.md) / mutationUtils
+
+# mutationUtils
+
+## Functions
+
+### updateObject()
+
+```ts
+function updateObject<T>(object, updates): void;
+```
+
+Defined in: [packages/utils/src/mutationUtils.ts:10](https://github.com/lucasols/utils/blob/main/packages/utils/src/mutationUtils.ts#L10)
+
+Updates an object with a new set of values. undefined values are ignored in the updates object
+and deep equal values are not updated.
+
+#### Type Parameters
+
+##### T
+
+`T` *extends* `Record`\<`string`, `unknown`\>
+
+#### Parameters
+
+##### object
+
+The object to update.
+
+`undefined` | `null` | `T`
+
+##### updates
+
+`Partial`\<`T`\>
+
+The new values to update the object with.
+
+#### Returns
+
+`void`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.34.1",
+  "version": "3.35.0",
   "license": "MIT",
   "files": [
     "dist",
@@ -108,6 +108,10 @@
       "import": "./dist/interpolate.js",
       "require": "./dist/interpolate.cjs"
     },
+    "./keepPrevIfUnchanged": {
+      "import": "./dist/keepPrevIfUnchanged.js",
+      "require": "./dist/keepPrevIfUnchanged.cjs"
+    },
     "./levenshtein": {
       "import": "./dist/levenshtein.js",
       "require": "./dist/levenshtein.cjs"
@@ -116,6 +120,10 @@
       "import": "./dist/mathUtils.js",
       "require": "./dist/mathUtils.cjs"
     },
+    "./mutationUtils": {
+      "import": "./dist/mutationUtils.js",
+      "require": "./dist/mutationUtils.cjs"
+    },
     "./objUtils": {
       "import": "./dist/objUtils.js",
       "require": "./dist/objUtils.cjs"