es-toolkit 1.27.0-dev.880 → 1.27.0-dev.882

package/dist/compat/array/uniqBy.d.mts

@@ -1,3 +1,15 @@
+/**
+ * Creates a duplicate-free version of an array using a transform function for comparison.
+ *
+ * @template T
+ * @param {ArrayLike<T>} array - The array to inspect.
+ * @returns {T[]} Returns the new duplicate-free array.
+ *
+ * @example
+ * uniqBy([1, 2, 3, 1]);
+ * // => [1, 2, 3]
+ */
+declare function uniqBy<T>(array: ArrayLike<T>): T[];
 /**
  * Creates a duplicate-free version of an array using a transform function for comparison.
  *
@@ -16,7 +28,7 @@ declare function uniqBy<T>(array: ArrayLike<T>, iteratee: (value: T) => unknown)
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {string} path - The property path to get values from.
+ * @param {PropertyKey} iteratee - The property path to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
@@ -28,33 +40,42 @@ declare function uniqBy<T>(array: ArrayLike<T>, iteratee: (value: T) => unknown)
  * uniqBy(users, 'user');
  * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T>, path: string): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: PropertyKey): T[];
 /**
- * Creates a duplicate-free version of an array using a property index for comparison.
+ * Creates a duplicate-free version of an array using a property name for comparison.
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {number} index - The index to get values from.
+ * @param {Partial<T>} iteratee - The partial object to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
- * const arrays = [[2], [3], [1], [2], [3], [1]];
- * uniqBy(arrays, 0);
- * // => [[2], [3], [1]]
+ * const users = [
+ *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'fred',   'age': 40 },
+ *   { 'user': 'barney', 'age': 37 }
+ * ];
+ * uniqBy(users, { 'user': 'barney'});
+ * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T>, index: number): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: Partial<T>): T[];
 /**
- * Creates a duplicate-free version of an array, combining multiple arrays and using an optional transform function.
+ * Creates a duplicate-free version of an array using a property name for comparison.
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {...Array<ArrayLike<T> | ((value: T) => unknown) | string>} values - Additional arrays and/or iteratee.
+ * @param {[keyof T, unknown]} iteratee - The property-value pair to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
- * uniqBy([1, 2], [2, 3], [3, 4], Math.floor);
- * // => [1, 2, 3, 4]
+ * const users = [
+ *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'fred',   'age': 40 },
+ *   { 'user': 'barney', 'age': 37 }
+ * ];
+ * uniqBy(users, ['user', 'barney']);
+ * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T> | null | undefined, ...values: Array<ArrayLike<T> | ((value: T) => unknown) | string>): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: [keyof T, unknown]): T[];
 
 export { uniqBy };

package/dist/compat/array/uniqBy.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Creates a duplicate-free version of an array using a transform function for comparison.
+ *
+ * @template T
+ * @param {ArrayLike<T>} array - The array to inspect.
+ * @returns {T[]} Returns the new duplicate-free array.
+ *
+ * @example
+ * uniqBy([1, 2, 3, 1]);
+ * // => [1, 2, 3]
+ */
+declare function uniqBy<T>(array: ArrayLike<T>): T[];
 /**
  * Creates a duplicate-free version of an array using a transform function for comparison.
  *
@@ -16,7 +28,7 @@ declare function uniqBy<T>(array: ArrayLike<T>, iteratee: (value: T) => unknown)
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {string} path - The property path to get values from.
+ * @param {PropertyKey} iteratee - The property path to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
@@ -28,33 +40,42 @@ declare function uniqBy<T>(array: ArrayLike<T>, iteratee: (value: T) => unknown)
  * uniqBy(users, 'user');
  * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T>, path: string): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: PropertyKey): T[];
 /**
- * Creates a duplicate-free version of an array using a property index for comparison.
+ * Creates a duplicate-free version of an array using a property name for comparison.
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {number} index - The index to get values from.
+ * @param {Partial<T>} iteratee - The partial object to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
- * const arrays = [[2], [3], [1], [2], [3], [1]];
- * uniqBy(arrays, 0);
- * // => [[2], [3], [1]]
+ * const users = [
+ *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'fred',   'age': 40 },
+ *   { 'user': 'barney', 'age': 37 }
+ * ];
+ * uniqBy(users, { 'user': 'barney'});
+ * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T>, index: number): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: Partial<T>): T[];
 /**
- * Creates a duplicate-free version of an array, combining multiple arrays and using an optional transform function.
+ * Creates a duplicate-free version of an array using a property name for comparison.
  *
  * @template T
  * @param {ArrayLike<T>} array - The array to inspect.
- * @param {...Array<ArrayLike<T> | ((value: T) => unknown) | string>} values - Additional arrays and/or iteratee.
+ * @param {[keyof T, unknown]} iteratee - The property-value pair to get values from.
  * @returns {T[]} Returns the new duplicate-free array.
  *
  * @example
- * uniqBy([1, 2], [2, 3], [3, 4], Math.floor);
- * // => [1, 2, 3, 4]
+ * const users = [
+ *   { 'user': 'barney', 'age': 36 },
+ *   { 'user': 'fred',   'age': 40 },
+ *   { 'user': 'barney', 'age': 37 }
+ * ];
+ * uniqBy(users, ['user', 'barney']);
+ * // => [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }]
  */
-declare function uniqBy<T>(array: ArrayLike<T> | null | undefined, ...values: Array<ArrayLike<T> | ((value: T) => unknown) | string>): T[];
+declare function uniqBy<T>(array: ArrayLike<T>, iteratee: [keyof T, unknown]): T[];
 
 export { uniqBy };

package/dist/compat/array/uniqBy.mjs

@@ -1,25 +1,12 @@
-import { flatten } from './flatten.mjs';
-import { last } from './last.mjs';
-import { uniq } from '../../array/uniq.mjs';
 import { uniqBy as uniqBy$1 } from '../../array/uniqBy.mjs';
 import { isArrayLikeObject } from '../predicate/isArrayLikeObject.mjs';
 import { iteratee } from '../util/iteratee.mjs';
 
-function uniqBy(arr, ...values) {
-    if (!isArrayLikeObject(arr)) {
+function uniqBy(array, iteratee$1) {
+    if (!isArrayLikeObject(array)) {
         return [];
     }
-    const iteratee$1 = last(values);
-    if (iteratee$1 === undefined) {
-        return Array.from(arr);
-    }
-    const validArrays = values.slice(0, -1).filter(isArrayLikeObject);
-    const flattenedArrays = flatten(validArrays);
-    const allValues = [...Array.from(arr), ...flattenedArrays];
-    if (isArrayLikeObject(iteratee$1)) {
-        return uniq(allValues);
-    }
-    return uniqBy$1(allValues, iteratee(iteratee$1));
+    return uniqBy$1(Array.from(array), iteratee(iteratee$1));
 }
 
 export { uniqBy };

package/dist/compat/index.js

@@ -1229,21 +1229,11 @@ function uniq(arr) {
     return zipWith.uniq(Array.from(arr));
 }
 
-function uniqBy(arr, ...values) {
-    if (!isArrayLikeObject(arr)) {
+function uniqBy(array, iteratee$1) {
+    if (!isArrayLikeObject(array)) {
         return [];
     }
-    const iteratee$1 = last(values);
-    if (iteratee$1 === undefined) {
-        return Array.from(arr);
-    }
-    const validArrays = values.slice(0, -1).filter(isArrayLikeObject);
-    const flattenedArrays = flatten(validArrays);
-    const allValues = [...Array.from(arr), ...flattenedArrays];
-    if (isArrayLikeObject(iteratee$1)) {
-        return zipWith.uniq(allValues);
-    }
-    return zipWith.uniqBy(allValues, iteratee(iteratee$1));
+    return zipWith.uniqBy(Array.from(array), iteratee(iteratee$1));
 }
 
 function unzip(array) {
@@ -2457,7 +2447,7 @@ function trim(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return upperFirst.trim(str, chars.map(x => x.toString()));
+                return upperFirst.trim(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return upperFirst.trim(str, chars.toString().split(''));
@@ -2479,7 +2469,7 @@ function trimEnd(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return upperFirst.trimEnd(str, chars.map(x => x.toString()));
+                return upperFirst.trimEnd(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return upperFirst.trimEnd(str, chars.toString().split(''));
@@ -2501,7 +2491,7 @@ function trimStart(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return upperFirst.trimStart(str, chars.map(x => x.toString()));
+                return upperFirst.trimStart(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return upperFirst.trimStart(str, chars.toString().split(''));

package/dist/compat/string/trim.mjs

@@ -13,7 +13,7 @@ function trim(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return trim$1(str, chars.map(x => x.toString()));
+                return trim$1(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return trim$1(str, chars.toString().split(''));

package/dist/compat/string/trimEnd.mjs

@@ -13,7 +13,7 @@ function trimEnd(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return trimEnd$1(str, chars.map(x => x.toString()));
+                return trimEnd$1(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return trimEnd$1(str, chars.toString().split(''));

package/dist/compat/string/trimStart.mjs

@@ -13,7 +13,7 @@ function trimStart(str, chars, guard) {
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return trimStart$1(str, chars.map(x => x.toString()));
+                return trimStart$1(str, chars.flatMap(x => x.toString().split('')));
             }
             else {
                 return trimStart$1(str, chars.toString().split(''));

package/dist/compat/util/iteratee.d.mts

@@ -39,6 +39,6 @@ declare function iteratee<F extends (...args: any[]) => unknown>(func: F): F;
  * const func = iteratee(['a', 1]);
  * [{ a: 1 }, { a: 2 }, { a: 3 }].find(func) // => { a: 1 }
  */
-declare function iteratee(value: symbol | number | string | object): (...args: any[]) => any;
+declare function iteratee(value?: symbol | number | string | object): (...args: any[]) => any;
 
 export { iteratee };

package/dist/compat/util/iteratee.d.ts

@@ -39,6 +39,6 @@ declare function iteratee<F extends (...args: any[]) => unknown>(func: F): F;
  * const func = iteratee(['a', 1]);
  * [{ a: 1 }, { a: 2 }, { a: 3 }].find(func) // => { a: 1 }
  */
-declare function iteratee(value: symbol | number | string | object): (...args: any[]) => any;
+declare function iteratee(value?: symbol | number | string | object): (...args: any[]) => any;
 
 export { iteratee };

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.27.0-dev.880+0aa9dc20",
+  "version": "1.27.0-dev.882+64368b8b",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {