es-toolkit 1.23.0-dev.728 → 1.23.0-dev.729

package/dist/compat/index.d.mts

@@ -143,6 +143,7 @@ export { fromPairs } from './object/fromPairs.mjs';
 export { unset } from './object/unset.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
 export { invertBy } from './object/invertBy.mjs';
+export { defaults } from './object/defaults.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';

package/dist/compat/index.d.ts

@@ -143,6 +143,7 @@ export { fromPairs } from './object/fromPairs.js';
 export { unset } from './object/unset.js';
 export { cloneDeep } from './object/cloneDeep.js';
 export { invertBy } from './object/invertBy.js';
+export { defaults } from './object/defaults.js';
 export { isPlainObject } from './predicate/isPlainObject.js';
 export { isArray } from './predicate/isArray.js';
 export { isArguments } from './predicate/isArguments.js';

package/dist/compat/index.js

@@ -1454,6 +1454,28 @@ function invertBy(object, iteratee) {
     return result;
 }
 
+function eq(value, other) {
+    return value === other || (Number.isNaN(value) && Number.isNaN(other));
+}
+
+function defaults(object, ...sources) {
+    object = Object(object);
+    const objectProto = Object.prototype;
+    for (let i = 0; i < sources.length; i++) {
+        const source = sources[i];
+        const keys = Object.keys(source);
+        for (let j = 0; j < keys.length; j++) {
+            const key = keys[j];
+            const value = object[key];
+            if (value === undefined ||
+                (!Object.hasOwn(object, key) && eq(value, objectProto[key]))) {
+                object[key] = source[key];
+            }
+        }
+    }
+    return object;
+}
+
 function isArrayBuffer(value) {
     return isWeakSet$1.isArrayBuffer(value);
 }
@@ -1866,10 +1888,6 @@ function random(...args) {
     }
 }
 
-function eq(value, other) {
-    return value === other || (Number.isNaN(value) && Number.isNaN(other));
-}
-
 exports.at = zipWith.at;
 exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
@@ -1980,6 +1998,7 @@ exports.conforms = conforms;
 exports.conformsTo = conformsTo;
 exports.curry = curry;
 exports.debounce = debounce;
+exports.defaults = defaults;
 exports.defer = defer;
 exports.difference = difference;
 exports.drop = drop;

package/dist/compat/index.mjs

@@ -144,6 +144,7 @@ export { fromPairs } from './object/fromPairs.mjs';
 export { unset } from './object/unset.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
 export { invertBy } from './object/invertBy.mjs';
+export { defaults } from './object/defaults.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';

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

@@ -0,0 +1,108 @@
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @param {T} object - The destination object.
+ * @returns {NonNullable<T>} Returns `object`, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object>(object: T): NonNullable<T>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S - The source object type.
+ * @param {T} object - The destination object.
+ * @param {S} source - The source object.
+ * @returns {NonNullable<T & S>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S extends object>(object: T, source: S): NonNullable<T & S>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @returns {NonNullable<T & S1 & S2>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object>(object: T, source1: S1, source2: S2): NonNullable<T & S1 & S2>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @template S3 - The third source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @param {S3} source3 - The third source object.
+ * @returns {NonNullable<T & S1 & S2 & S3>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object, S3 extends object>(object: T, source1: S1, source2: S2, source3: S3): NonNullable<T & S1 & S2 & S3>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @template S3 - The third source object type.
+ * @template S4 - The fourth source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @param {S3} source3 - The third source object.
+ * @param {S4} source4 - The fourth source object.
+ * @returns {NonNullable<T & S1 & S2 & S3 & S4>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object, S3 extends object, S4 extends object>(object: T, source1: S1, source2: S2, source3: S3, source4: S4): NonNullable<T & S1 & S2 & S3 & S4>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S - The source object type.
+ * @param {T} object - The destination object.
+ * @param {S[]} sources - The source objects.
+ * @returns {object} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ *
+ * @example
+ * defaults({ a: 1 }, { a: 2, b: 2 }, { c: 3 }); // { a: 1, b: 2, c: 3 }
+ * defaults({ a: 1, b: 2 }, { b: 3 }, { c: 3 }); // { a: 1, b: 2, c: 3 }
+ * defaults({ a: null }, { a: 1 }); // { a: null }
+ * defaults({ a: undefined }, { a: 1 }); // { a: 1 }
+ */
+declare function defaults<T extends object, S extends object>(object: T, ...sources: S[]): object;
+
+export { defaults };

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

@@ -0,0 +1,108 @@
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @param {T} object - The destination object.
+ * @returns {NonNullable<T>} Returns `object`, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object>(object: T): NonNullable<T>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S - The source object type.
+ * @param {T} object - The destination object.
+ * @param {S} source - The source object.
+ * @returns {NonNullable<T & S>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S extends object>(object: T, source: S): NonNullable<T & S>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @returns {NonNullable<T & S1 & S2>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object>(object: T, source1: S1, source2: S2): NonNullable<T & S1 & S2>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @template S3 - The third source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @param {S3} source3 - The third source object.
+ * @returns {NonNullable<T & S1 & S2 & S3>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object, S3 extends object>(object: T, source1: S1, source2: S2, source3: S3): NonNullable<T & S1 & S2 & S3>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S1 - The first source object type.
+ * @template S2 - The second source object type.
+ * @template S3 - The third source object type.
+ * @template S4 - The fourth source object type.
+ * @param {T} object - The destination object.
+ * @param {S1} source1 - The first source object.
+ * @param {S2} source2 - The second source object.
+ * @param {S3} source3 - The third source object.
+ * @param {S4} source4 - The fourth source object.
+ * @returns {NonNullable<T & S1 & S2 & S3 & S4>} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ */
+declare function defaults<T extends object, S1 extends object, S2 extends object, S3 extends object, S4 extends object>(object: T, source1: S1, source2: S2, source3: S3, source4: S4): NonNullable<T & S1 & S2 & S3 & S4>;
+/**
+ * Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to `undefined`.
+ *
+ * Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
+ * It ensures that the destination object is not `null` or `undefined`.
+ *
+ * Note: This method mutates a first argument `object`.
+ *
+ * @template T - The destination object type.
+ * @template S - The source object type.
+ * @param {T} object - The destination object.
+ * @param {S[]} sources - The source objects.
+ * @returns {object} Returns the merged object, ensuring that the destination object is not `null` or `undefined`.
+ *
+ * @example
+ * defaults({ a: 1 }, { a: 2, b: 2 }, { c: 3 }); // { a: 1, b: 2, c: 3 }
+ * defaults({ a: 1, b: 2 }, { b: 3 }, { c: 3 }); // { a: 1, b: 2, c: 3 }
+ * defaults({ a: null }, { a: 1 }); // { a: null }
+ * defaults({ a: undefined }, { a: 1 }); // { a: 1 }
+ */
+declare function defaults<T extends object, S extends object>(object: T, ...sources: S[]): object;
+
+export { defaults };

package/dist/compat/object/defaults.mjs

@@ -0,0 +1,21 @@
+import { eq } from '../util/eq.mjs';
+
+function defaults(object, ...sources) {
+    object = Object(object);
+    const objectProto = Object.prototype;
+    for (let i = 0; i < sources.length; i++) {
+        const source = sources[i];
+        const keys = Object.keys(source);
+        for (let j = 0; j < keys.length; j++) {
+            const key = keys[j];
+            const value = object[key];
+            if (value === undefined ||
+                (!Object.hasOwn(object, key) && eq(value, objectProto[key]))) {
+                object[key] = source[key];
+            }
+        }
+    }
+    return object;
+}
+
+export { defaults };

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.23.0-dev.728+0e7ad28d",
+  "version": "1.23.0-dev.729+c6130a41",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {