@ls-stack/utils 3.34.1 → 3.36.0

package/dist/arrayUtils.cjs

@@ -25,6 +25,7 @@ __export(arrayUtils_exports, {
   arrayWithPrevAndIndex: () => arrayWithPrevAndIndex,
   filterAndMap: () => filterAndMap,
   findAfterIndex: () => findAfterIndex,
+  findAndMap: () => findAndMap,
   findBeforeIndex: () => findBeforeIndex,
   getAscIndexOrder: () => getAscIndexOrder,
   hasDuplicates: () => hasDuplicates,
@@ -160,11 +161,19 @@ function truncateArray(array, maxLength, appendIfTruncated) {
   }
   return result;
 }
+function findAndMap(array, predicate) {
+  for (const item of array) {
+    const value = predicate(item);
+    if (value !== false) return value;
+  }
+  return void 0;
+}
 function arrayOps(array) {
   return {
     filterAndMap: (mapFilter) => filterAndMap(array, mapFilter),
     sortBy: (sortByValue, props) => sortBy(array, sortByValue, props),
-    rejectDuplicates: (getKey) => rejectDuplicates(array, getKey)
+    rejectDuplicates: (getKey) => rejectDuplicates(array, getKey),
+    findAndMap: (predicate) => findAndMap(array, predicate)
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -174,6 +183,7 @@ function arrayOps(array) {
   arrayWithPrevAndIndex,
   filterAndMap,
   findAfterIndex,
+  findAndMap,
   findBeforeIndex,
   getAscIndexOrder,
   hasDuplicates,

package/dist/arrayUtils.d.cts

@@ -94,7 +94,26 @@ type ArrayOps<T> = {
     filterAndMap: <R>(mapFilter: (item: T, index: number) => false | R) => R[];
     sortBy: (sortByValue: SortByValue<T>, props: SortByProps) => T[];
     rejectDuplicates: (getKey: (item: T) => unknown) => T[];
+    findAndMap: <R>(predicate: (value: T) => R | false) => R | undefined;
 };
+/**
+ * Finds the first item in an array where the predicate returns a non-false value and returns that mapped value.
+ *
+ * Combines find and map operations - applies the predicate to each item until one returns
+ * a value that is not `false`, then returns that mapped value. If no item matches, returns `undefined`.
+ *
+ * @param array - The array to search through
+ * @param predicate - Function that returns a mapped value or `false` to skip the item
+ * @returns The first mapped value that is not `false`, or `undefined` if no item matches
+ * @example
+ * const users = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ *
+ * const foundName = findAndMap(users, (user) =>
+ *   user.id === 2 ? user.name.toUpperCase() : false
+ * );
+ * // foundName is 'BOB'
+ */
+declare function findAndMap<T, R>(array: T[], predicate: (value: T) => R | false): R | undefined;
 /**
  * Enhance an array with extra methods
  *
@@ -109,4 +128,4 @@ type ArrayOps<T> = {
  */
 declare function arrayOps<T>(array: T[]): ArrayOps<T>;
 
-export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };
+export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };

package/dist/arrayUtils.d.ts

@@ -94,7 +94,26 @@ type ArrayOps<T> = {
     filterAndMap: <R>(mapFilter: (item: T, index: number) => false | R) => R[];
     sortBy: (sortByValue: SortByValue<T>, props: SortByProps) => T[];
     rejectDuplicates: (getKey: (item: T) => unknown) => T[];
+    findAndMap: <R>(predicate: (value: T) => R | false) => R | undefined;
 };
+/**
+ * Finds the first item in an array where the predicate returns a non-false value and returns that mapped value.
+ *
+ * Combines find and map operations - applies the predicate to each item until one returns
+ * a value that is not `false`, then returns that mapped value. If no item matches, returns `undefined`.
+ *
+ * @param array - The array to search through
+ * @param predicate - Function that returns a mapped value or `false` to skip the item
+ * @returns The first mapped value that is not `false`, or `undefined` if no item matches
+ * @example
+ * const users = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ *
+ * const foundName = findAndMap(users, (user) =>
+ *   user.id === 2 ? user.name.toUpperCase() : false
+ * );
+ * // foundName is 'BOB'
+ */
+declare function findAndMap<T, R>(array: T[], predicate: (value: T) => R | false): R | undefined;
 /**
  * Enhance an array with extra methods
  *
@@ -109,4 +128,4 @@ type ArrayOps<T> = {
  */
 declare function arrayOps<T>(array: T[]): ArrayOps<T>;
 
-export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };
+export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };

package/dist/arrayUtils.js

@@ -4,6 +4,7 @@ import {
   arrayWithPrevAndIndex,
   filterAndMap,
   findAfterIndex,
+  findAndMap,
   findBeforeIndex,
   getAscIndexOrder,
   hasDuplicates,
@@ -12,7 +13,7 @@ import {
   rejectDuplicates,
   sortBy,
   truncateArray
-} from "./chunk-4DVTWCXL.js";
+} from "./chunk-27AL66CH.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {
@@ -21,6 +22,7 @@ export {
   arrayWithPrevAndIndex,
   filterAndMap,
   findAfterIndex,
+  findAndMap,
   findBeforeIndex,
   getAscIndexOrder,
   hasDuplicates,

package/dist/{chunk-4DVTWCXL.js → chunk-27AL66CH.js}

@@ -118,11 +118,19 @@ function truncateArray(array, maxLength, appendIfTruncated) {
   }
   return result;
 }
+function findAndMap(array, predicate) {
+  for (const item of array) {
+    const value = predicate(item);
+    if (value !== false) return value;
+  }
+  return void 0;
+}
 function arrayOps(array) {
   return {
     filterAndMap: (mapFilter) => filterAndMap(array, mapFilter),
     sortBy: (sortByValue, props) => sortBy(array, sortByValue, props),
-    rejectDuplicates: (getKey) => rejectDuplicates(array, getKey)
+    rejectDuplicates: (getKey) => rejectDuplicates(array, getKey),
+    findAndMap: (predicate) => findAndMap(array, predicate)
   };
 }
 
@@ -139,5 +147,6 @@ export {
   hasDuplicates,
   rejectDuplicates,
   truncateArray,
+  findAndMap,
   arrayOps
 };

package/dist/{chunk-XPOGWCUC.js → chunk-6CG6JZKB.js}

@@ -1,6 +1,6 @@
 import {
   sortBy
-} from "./chunk-4DVTWCXL.js";
+} from "./chunk-27AL66CH.js";
 import {
   isPlainObject
 } from "./chunk-JF2MDHOJ.js";

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/concurrentCalls.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-VAAMRG4K.js";
 import {
   truncateArray
-} from "./chunk-4DVTWCXL.js";
+} from "./chunk-27AL66CH.js";
 import {
   invariant
 } from "./chunk-C2SVCIWE.js";

package/dist/filterObjectOrArrayKeys.js

@@ -1,7 +1,7 @@
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XPOGWCUC.js";
-import "./chunk-4DVTWCXL.js";
+} from "./chunk-6CG6JZKB.js";
+import "./chunk-27AL66CH.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {

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/dist/serializeXML.js

@@ -1,6 +1,6 @@
 import {
   filterAndMap
-} from "./chunk-4DVTWCXL.js";
+} from "./chunk-27AL66CH.js";
 import "./chunk-C2SVCIWE.js";
 import {
   isTruthy

package/dist/testUtils.js

@@ -11,7 +11,7 @@ import {
 } from "./chunk-JQFUKJU5.js";
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XPOGWCUC.js";
+} from "./chunk-6CG6JZKB.js";
 import {
   defer
 } from "./chunk-DFXNVEH6.js";
@@ -22,7 +22,7 @@ import "./chunk-KW55OTUG.js";
 import {
   arrayWithPrevAndIndex,
   filterAndMap
-} from "./chunk-4DVTWCXL.js";
+} from "./chunk-27AL66CH.js";
 import {
   isObject
 } from "./chunk-C2SVCIWE.js";

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/arrayUtils/-internal-.md

@@ -63,6 +63,30 @@ const enhancedItems = arrayOps(items);
 enhancedItems.filterAndMap((item) => item === 2 ? false : item);
 ```
 
+##### findAndMap()
+
+```ts
+findAndMap: <R>(predicate) => R | undefined;
+```
+
+Defined in: [packages/utils/src/arrayUtils.ts:275](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L275)
+
+###### Type Parameters
+
+###### R
+
+`R`
+
+###### Parameters
+
+###### predicate
+
+(`value`) => `R` \| `false`
+
+###### Returns
+
+`R` \| `undefined`
+
 ##### rejectDuplicates()
 
 ```ts

package/docs/arrayUtils/README.md

@@ -34,7 +34,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:42](https://github.com/lucasols/ut
 function arrayOps<T>(array): ArrayOps<T>;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:289](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L289)
+Defined in: [packages/utils/src/arrayUtils.ts:318](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L318)
 
 Enhance an array with extra methods
 
@@ -209,6 +209,62 @@ Defined in: [packages/utils/src/arrayUtils.ts:165](https://github.com/lucasols/u
 
 ***
 
+### findAndMap()
+
+```ts
+function findAndMap<T, R>(array, predicate): undefined | R;
+```
+
+Defined in: [packages/utils/src/arrayUtils.ts:295](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L295)
+
+Finds the first item in an array where the predicate returns a non-false value and returns that mapped value.
+
+Combines find and map operations - applies the predicate to each item until one returns
+a value that is not `false`, then returns that mapped value. If no item matches, returns `undefined`.
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+##### R
+
+`R`
+
+#### Parameters
+
+##### array
+
+`T`[]
+
+The array to search through
+
+##### predicate
+
+(`value`) => `false` \| `R`
+
+Function that returns a mapped value or `false` to skip the item
+
+#### Returns
+
+`undefined` \| `R`
+
+The first mapped value that is not `false`, or `undefined` if no item matches
+
+#### Example
+
+```ts
+const users = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+
+const foundName = findAndMap(users, (user) => 
+  user.id === 2 ? user.name.toUpperCase() : false
+);
+// foundName is 'BOB'
+```
+
+***
+
 ### findBeforeIndex()
 
 ```ts

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.36.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"