es-toolkit 1.37.2-dev.1271 → 1.37.2-dev.1273

package/dist/compat/compat.d.mts

@@ -176,6 +176,7 @@ export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
 export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
+export { setWith } from './object/setWith.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';
 export { toPairsIn } from './object/toPairsIn.mjs';

package/dist/compat/compat.d.ts

@@ -176,6 +176,7 @@ export { property } from './object/property.js';
 export { propertyOf } from './object/propertyOf.js';
 export { result } from './object/result.js';
 export { set } from './object/set.js';
+export { setWith } from './object/setWith.js';
 export { toDefaulted } from './object/toDefaulted.js';
 export { toPairs } from './object/toPairs.js';
 export { toPairsIn } from './object/toPairsIn.js';

package/dist/compat/compat.mjs

@@ -176,6 +176,7 @@ export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
 export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
+export { setWith } from './object/setWith.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';
 export { toPairsIn } from './object/toPairsIn.mjs';

package/dist/compat/index.d.mts

@@ -176,6 +176,7 @@ export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
 export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
+export { setWith } from './object/setWith.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';
 export { toPairsIn } from './object/toPairsIn.mjs';

package/dist/compat/index.d.ts

@@ -176,6 +176,7 @@ export { property } from './object/property.js';
 export { propertyOf } from './object/propertyOf.js';
 export { result } from './object/result.js';
 export { set } from './object/set.js';
+export { setWith } from './object/setWith.js';
 export { toDefaulted } from './object/toDefaulted.js';
 export { toPairs } from './object/toPairs.js';
 export { toPairsIn } from './object/toPairsIn.js';

package/dist/compat/index.js

@@ -3689,6 +3689,17 @@ function result(object, path, defaultValue) {
     return object;
 }
 
+function setWith(obj, path, value, customizer) {
+    let customizerFn;
+    if (typeof customizer === 'function') {
+        customizerFn = customizer;
+    }
+    else {
+        customizerFn = () => undefined;
+    }
+    return updateWith(obj, path, () => value, customizerFn);
+}
+
 function toDefaulted(object, ...sources) {
     const cloned = cloneDeep(object);
     return defaults(cloned, ...sources);
@@ -4643,6 +4654,7 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     sample,
     sampleSize,
     set,
+    setWith,
     shuffle,
     size,
     slice,
@@ -4944,6 +4956,7 @@ exports.round = round;
 exports.sample = sample;
 exports.sampleSize = sampleSize;
 exports.set = set;
+exports.setWith = setWith;
 exports.shuffle = shuffle;
 exports.size = size;
 exports.slice = slice;

package/dist/compat/index.mjs

@@ -176,6 +176,7 @@ export { property } from './object/property.mjs';
 export { propertyOf } from './object/propertyOf.mjs';
 export { result } from './object/result.mjs';
 export { set } from './object/set.mjs';
+export { setWith } from './object/setWith.mjs';
 export { toDefaulted } from './object/toDefaulted.mjs';
 export { toPairs } from './object/toPairs.mjs';
 export { toPairsIn } from './object/toPairsIn.mjs';

package/dist/compat/object/setWith.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Sets the value at the specified path of the given object using a customizer function.
+ * If any part of the path does not exist, it will be created based on the customizer's result.
+ *
+ * The customizer is invoked to produce the objects of the path. If the customizer returns
+ * a value, that value is used for the current path segment. If the customizer returns
+ * `undefined`, the method will create an appropriate object based on the path - an array
+ * if the next path segment is a valid array index, or an object otherwise.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to modify.
+ * @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to set.
+ * @param {unknown} value - The value to set.
+ * @param {(value: unknown) => unknown} [customizer] - The function to customize assigned values.
+ * @returns {T} - The modified object.
+ *
+ * @example
+ * // Set a value with a customizer that creates arrays for numeric path segments
+ * const object = {};
+ * setWith(object, '[0][1]', 'a', (value) => Array.isArray(value) ? value : []);
+ * // => { '0': ['a'] }
+ */
+declare function setWith<T extends object | null | undefined>(obj: T, path: PropertyKey | readonly PropertyKey[], value: unknown, customizer?: (value: unknown) => unknown): T;
+
+export { setWith };

package/dist/compat/object/setWith.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Sets the value at the specified path of the given object using a customizer function.
+ * If any part of the path does not exist, it will be created based on the customizer's result.
+ *
+ * The customizer is invoked to produce the objects of the path. If the customizer returns
+ * a value, that value is used for the current path segment. If the customizer returns
+ * `undefined`, the method will create an appropriate object based on the path - an array
+ * if the next path segment is a valid array index, or an object otherwise.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to modify.
+ * @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to set.
+ * @param {unknown} value - The value to set.
+ * @param {(value: unknown) => unknown} [customizer] - The function to customize assigned values.
+ * @returns {T} - The modified object.
+ *
+ * @example
+ * // Set a value with a customizer that creates arrays for numeric path segments
+ * const object = {};
+ * setWith(object, '[0][1]', 'a', (value) => Array.isArray(value) ? value : []);
+ * // => { '0': ['a'] }
+ */
+declare function setWith<T extends object | null | undefined>(obj: T, path: PropertyKey | readonly PropertyKey[], value: unknown, customizer?: (value: unknown) => unknown): T;
+
+export { setWith };

package/dist/compat/object/setWith.mjs

@@ -0,0 +1,14 @@
+import { updateWith } from './updateWith.mjs';
+
+function setWith(obj, path, value, customizer) {
+    let customizerFn;
+    if (typeof customizer === 'function') {
+        customizerFn = customizer;
+    }
+    else {
+        customizerFn = () => undefined;
+    }
+    return updateWith(obj, path, () => value, customizerFn);
+}
+
+export { setWith };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.37.2-dev.1271+04776a4b",
+  "version": "1.37.2-dev.1273+cdc77fe5",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {