es-toolkit 1.15.1 → 1.16.0-dev.455

package/dist/index.mjs

@@ -22,6 +22,7 @@ export { maxBy } from './array/maxBy.mjs';
 export { minBy } from './array/minBy.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { partition } from './array/partition.mjs';
+export { sortBy } from './array/sortBy.mjs';
 export { sample } from './array/sample.mjs';
 export { sampleSize } from './array/sampleSize.mjs';
 export { shuffle } from './array/shuffle.mjs';
@@ -59,8 +60,12 @@ export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { memoize } from './function/memoize.mjs';
 export { ary } from './function/ary.mjs';
 export { unary } from './function/unary.mjs';
+export { partial } from './function/partial.mjs';
+export { partialRight } from './function/partialRight.mjs';
+export { rest } from './function/rest.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';
@@ -82,6 +87,7 @@ export { mapKeys } from './object/mapKeys.mjs';
 export { mapValues } from './object/mapValues.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
 export { merge } from './object/merge.mjs';
+export { toMerged } from './object/toMerged.mjs';
 export { mergeWith } from './object/mergeWith.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isNil } from './predicate/isNil.mjs';
@@ -95,6 +101,7 @@ export { isTypedArray } from './predicate/isTypedArray.mjs';
 export { isPrimitive } from './predicate/isPrimitive.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
 export { isSymbol } from './predicate/isSymbol.mjs';
+export { isString } from './predicate/isString.mjs';
 export { delay } from './promise/delay.mjs';
 export { withTimeout } from './promise/withTimeout.mjs';
 export { camelCase } from './string/camelCase.mjs';

package/dist/object/index.d.mts

@@ -9,4 +9,5 @@ export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
 export { merge } from './merge.mjs';
+export { toMerged } from './toMerged.mjs';
 export { mergeWith } from './mergeWith.mjs';

package/dist/object/index.d.ts

@@ -9,4 +9,5 @@ export { mapKeys } from './mapKeys.js';
 export { mapValues } from './mapValues.js';
 export { cloneDeep } from './cloneDeep.js';
 export { merge } from './merge.js';
+export { toMerged } from './toMerged.js';
 export { mergeWith } from './mergeWith.js';

package/dist/object/index.js

@@ -2,26 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isObjectLike = require('../_chunk/isObjectLike-BeLCsr.js');
-
-function merge(target, source) {
-    const sourceKeys = Object.keys(source);
-    for (let i = 0; i < sourceKeys.length; i++) {
-        const key = sourceKeys[i];
-        const sourceValue = source[key];
-        const targetValue = target[key];
-        if (Array.isArray(sourceValue)) {
-            target[key] = merge(targetValue ?? [], sourceValue);
-        }
-        else if (isObjectLike.isObjectLike(targetValue) && isObjectLike.isObjectLike(sourceValue)) {
-            target[key] = merge(targetValue ?? {}, sourceValue);
-        }
-        else if (targetValue === undefined || sourceValue !== undefined) {
-            target[key] = sourceValue;
-        }
-    }
-    return target;
-}
+const toMerged = require('../_chunk/toMerged-BGwYW5.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);
@@ -36,7 +17,7 @@ function mergeWith(target, source, merge) {
         else if (Array.isArray(sourceValue)) {
             target[key] = mergeWith(targetValue ?? [], sourceValue, merge);
         }
-        else if (isObjectLike.isObjectLike(targetValue) && isObjectLike.isObjectLike(sourceValue)) {
+        else if (toMerged.isObjectLike(targetValue) && toMerged.isObjectLike(sourceValue)) {
             target[key] = mergeWith(targetValue ?? {}, sourceValue, merge);
         }
         else if (targetValue === undefined || sourceValue !== undefined) {
@@ -46,15 +27,16 @@ function mergeWith(target, source, merge) {
     return target;
 }
 
-exports.clone = isObjectLike.clone;
-exports.cloneDeep = isObjectLike.cloneDeep;
-exports.flattenObject = isObjectLike.flattenObject;
-exports.invert = isObjectLike.invert;
-exports.mapKeys = isObjectLike.mapKeys;
-exports.mapValues = isObjectLike.mapValues;
-exports.omit = isObjectLike.omit;
-exports.omitBy = isObjectLike.omitBy;
-exports.pick = isObjectLike.pick;
-exports.pickBy = isObjectLike.pickBy;
-exports.merge = merge;
+exports.clone = toMerged.clone;
+exports.cloneDeep = toMerged.cloneDeep;
+exports.flattenObject = toMerged.flattenObject;
+exports.invert = toMerged.invert;
+exports.mapKeys = toMerged.mapKeys;
+exports.mapValues = toMerged.mapValues;
+exports.merge = toMerged.merge;
+exports.omit = toMerged.omit;
+exports.omitBy = toMerged.omitBy;
+exports.pick = toMerged.pick;
+exports.pickBy = toMerged.pickBy;
+exports.toMerged = toMerged.toMerged;
 exports.mergeWith = mergeWith;

package/dist/object/index.mjs

@@ -9,4 +9,5 @@ export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
 export { merge } from './merge.mjs';
+export { toMerged } from './toMerged.mjs';
 export { mergeWith } from './mergeWith.mjs';

package/dist/object/toMerged.d.mts

@@ -0,0 +1,45 @@
+/**
+ * Merges the properties of the source object into a deep clone of the target object.
+ * Unlike `merge`, This function does not modify the original target object.
+ *
+ * This function performs a deep merge, meaning nested objects and arrays are merged recursively.
+ *
+ * - If a property in the source object is an array or object and the corresponding property in the target object is also an array or object, they will be merged.
+ * - If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function does not mutate the target object.
+ *
+ * @param {T} target - The target object to be cloned and merged into. This object is not modified directly.
+ * @param {S} source - The source object whose properties will be merged into the cloned target object.
+ * @returns {T & S} A new object with properties from the source object merged into a deep clone of the target object.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: { x: 1, y: 2 } };
+ * const source = { b: { y: 3, z: 4 }, c: 5 };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: 1, b: { x: 1, y: 3, z: 4 }, c: 5 }
+ *
+ * @example
+ * const target = { a: [1, 2], b: { x: 1 } };
+ * const source = { a: [3], b: { y: 2 } };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: [3, 2], b: { x: 1, y: 2 } }
+ *
+ * @example
+ * const target = { a: null };
+ * const source = { a: [1, 2, 3] };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: [1, 2, 3] }
+ */
+declare function toMerged<T, S>(target: T, source: S): T & S;
+
+export { toMerged };

package/dist/object/toMerged.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Merges the properties of the source object into a deep clone of the target object.
+ * Unlike `merge`, This function does not modify the original target object.
+ *
+ * This function performs a deep merge, meaning nested objects and arrays are merged recursively.
+ *
+ * - If a property in the source object is an array or object and the corresponding property in the target object is also an array or object, they will be merged.
+ * - If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function does not mutate the target object.
+ *
+ * @param {T} target - The target object to be cloned and merged into. This object is not modified directly.
+ * @param {S} source - The source object whose properties will be merged into the cloned target object.
+ * @returns {T & S} A new object with properties from the source object merged into a deep clone of the target object.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: { x: 1, y: 2 } };
+ * const source = { b: { y: 3, z: 4 }, c: 5 };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: 1, b: { x: 1, y: 3, z: 4 }, c: 5 }
+ *
+ * @example
+ * const target = { a: [1, 2], b: { x: 1 } };
+ * const source = { a: [3], b: { y: 2 } };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: [3, 2], b: { x: 1, y: 2 } }
+ *
+ * @example
+ * const target = { a: null };
+ * const source = { a: [1, 2, 3] };
+ *
+ * const result = toMerged(target, source);
+ * console.log(result);
+ * // Output: { a: [1, 2, 3] }
+ */
+declare function toMerged<T, S>(target: T, source: S): T & S;
+
+export { toMerged };

package/dist/object/toMerged.mjs

@@ -0,0 +1,8 @@
+import { cloneDeep } from './cloneDeep.mjs';
+import { merge } from './merge.mjs';
+
+function toMerged(target, source) {
+    return merge(cloneDeep(target), source);
+}
+
+export { toMerged };

package/dist/predicate/index.d.mts

@@ -10,3 +10,4 @@ export { isTypedArray } from './isTypedArray.mjs';
 export { isPrimitive } from './isPrimitive.mjs';
 export { isBoolean } from './isBoolean.mjs';
 export { isSymbol } from './isSymbol.mjs';
+export { isString } from './isString.mjs';

package/dist/predicate/index.d.ts

@@ -10,3 +10,4 @@ export { isTypedArray } from './isTypedArray.js';
 export { isPrimitive } from './isPrimitive.js';
 export { isBoolean } from './isBoolean.js';
 export { isSymbol } from './isSymbol.js';
+export { isString } from './isString.js';

package/dist/predicate/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isFunction = require('../_chunk/isFunction-D0hq6d.js');
+const isFunction = require('../_chunk/isFunction-aCEz9d.js');
 const isTypedArray = require('../_chunk/isTypedArray-BBEkFl.js');
 
 function isBoolean(x) {
@@ -13,6 +13,10 @@ function isSymbol(value) {
     return typeof value === 'symbol';
 }
 
+function isString(value) {
+    return typeof value === 'string';
+}
+
 exports.isEqual = isFunction.isEqual;
 exports.isFunction = isFunction.isFunction;
 exports.isLength = isFunction.isLength;
@@ -24,4 +28,5 @@ exports.isPlainObject = isTypedArray.isPlainObject;
 exports.isPrimitive = isTypedArray.isPrimitive;
 exports.isTypedArray = isTypedArray.isTypedArray;
 exports.isBoolean = isBoolean;
+exports.isString = isString;
 exports.isSymbol = isSymbol;

package/dist/predicate/index.mjs

@@ -10,3 +10,4 @@ export { isTypedArray } from './isTypedArray.mjs';
 export { isPrimitive } from './isPrimitive.mjs';
 export { isBoolean } from './isBoolean.mjs';
 export { isSymbol } from './isSymbol.mjs';
+export { isString } from './isString.mjs';

package/dist/predicate/isEqual.mjs

@@ -47,7 +47,7 @@ function areObjectsEqual(a, b, stack) {
         case numberTag: {
             const x = a.valueOf();
             const y = b.valueOf();
-            return x === y || Number.isNaN(x) && Number.isNaN(y);
+            return x === y || (Number.isNaN(x) && Number.isNaN(y));
         }
         case booleanTag:
         case dateTag:
@@ -57,7 +57,7 @@ function areObjectsEqual(a, b, stack) {
             return a.source === b.source && a.flags === b.flags;
         }
         case functionTag: {
-            return a == b;
+            return a === b;
         }
     }
     stack = stack ?? new Map();
@@ -140,8 +140,7 @@ function areObjectsEqual(a, b, stack) {
                 return a.name === b.name && a.message === b.message;
             }
             case objectTag: {
-                const areEqualInstances = areObjectsEqual(a.constructor, b.constructor, stack) ||
-                    (isPlainObject(a) && isPlainObject(b));
+                const areEqualInstances = areObjectsEqual(a.constructor, b.constructor, stack) || (isPlainObject(a) && isPlainObject(b));
                 if (!areEqualInstances) {
                     return false;
                 }
@@ -153,7 +152,7 @@ function areObjectsEqual(a, b, stack) {
                 for (let i = 0; i < aKeys.length; i++) {
                     const propKey = aKeys[i];
                     const aProp = a[propKey];
-                    if (!b.hasOwnProperty(propKey)) {
+                    if (!Object.prototype.hasOwnProperty.call(b, propKey)) {
                         return false;
                     }
                     const bProp = b[propKey];

package/dist/predicate/isString.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a given value is stirng.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `string`.
+ *
+ * @param {unknown} value The value to check if it is string.
+ * @returns {value is string} Returns `true` if `value` is a stirng, else `false`.
+ *
+ * @example
+ * const value1 = 'abc';
+ * const value2 = 123;
+ * const value3 = true;
+ *
+ * console.log(isString(value1)); // true
+ * console.log(isString(value2)); // false
+ * console.log(isString(value3)); // false
+ */
+declare function isString(value: unknown): value is string;
+
+export { isString };

package/dist/predicate/isString.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a given value is stirng.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `string`.
+ *
+ * @param {unknown} value The value to check if it is string.
+ * @returns {value is string} Returns `true` if `value` is a stirng, else `false`.
+ *
+ * @example
+ * const value1 = 'abc';
+ * const value2 = 123;
+ * const value3 = true;
+ *
+ * console.log(isString(value1)); // true
+ * console.log(isString(value2)); // false
+ * console.log(isString(value3)); // false
+ */
+declare function isString(value: unknown): value is string;
+
+export { isString };

package/dist/predicate/isString.mjs

@@ -0,0 +1,5 @@
+function isString(value) {
+    return typeof value === 'string';
+}
+
+export { isString };

package/dist/string/camelCase.mjs

@@ -4,10 +4,10 @@ import { getWords } from './_internal/getWords.mjs';
 function camelCase(str) {
     const words = getWords(str);
     if (words.length === 0) {
-        return "";
+        return '';
     }
     const [first, ...rest] = words;
-    return `${first.toLowerCase()}${rest.map((word) => capitalize(word)).join("")}`;
+    return `${first.toLowerCase()}${rest.map(word => capitalize(word)).join('')}`;
 }
 
 export { camelCase };

package/dist/string/index.js

@@ -14,10 +14,10 @@ function getWords(str) {
 function camelCase(str) {
     const words = getWords(str);
     if (words.length === 0) {
-        return "";
+        return '';
     }
     const [first, ...rest] = words;
-    return `${first.toLowerCase()}${rest.map((word) => capitalize(word)).join("")}`;
+    return `${first.toLowerCase()}${rest.map(word => capitalize(word)).join('')}`;
 }
 
 const snakeCase = (str) => {

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.15.1",
+  "version": "1.16.0-dev.455+f08fbd1b",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {