es-toolkit 1.26.1-dev.834 → 1.26.1-dev.836

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

@@ -0,0 +1,8 @@
+type Iteratee<T> = PropertyKey | Partial<T> | ((value: T) => unknown);
+declare function differenceBy<T1, T2>(array: ArrayLike<T1> | null | undefined, values: ArrayLike<T2>, iteratee: Iteratee<T1 | T2>): T1[];
+declare function differenceBy<T1, T2, T3>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, iteratee: Iteratee<T1 | T2 | T3>): T1[];
+declare function differenceBy<T1, T2, T3, T4>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, values3: ArrayLike<T4>, iteratee: Iteratee<T1 | T2 | T3 | T4>): T1[];
+declare function differenceBy<T1, T2, T3, T4, T5>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, values3: ArrayLike<T4>, values4: ArrayLike<T5>, iteratee: Iteratee<T1 | T2 | T3 | T4 | T5>): T1[];
+declare function differenceBy<T>(array: ArrayLike<T> | null | undefined, ...values: Array<ArrayLike<T>>): T[];
+
+export { differenceBy };

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

@@ -0,0 +1,8 @@
+type Iteratee<T> = PropertyKey | Partial<T> | ((value: T) => unknown);
+declare function differenceBy<T1, T2>(array: ArrayLike<T1> | null | undefined, values: ArrayLike<T2>, iteratee: Iteratee<T1 | T2>): T1[];
+declare function differenceBy<T1, T2, T3>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, iteratee: Iteratee<T1 | T2 | T3>): T1[];
+declare function differenceBy<T1, T2, T3, T4>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, values3: ArrayLike<T4>, iteratee: Iteratee<T1 | T2 | T3 | T4>): T1[];
+declare function differenceBy<T1, T2, T3, T4, T5>(array: ArrayLike<T1> | null | undefined, values1: ArrayLike<T2>, values2: ArrayLike<T3>, values3: ArrayLike<T4>, values4: ArrayLike<T5>, iteratee: Iteratee<T1 | T2 | T3 | T4 | T5>): T1[];
+declare function differenceBy<T>(array: ArrayLike<T> | null | undefined, ...values: Array<ArrayLike<T>>): T[];
+
+export { differenceBy };

package/dist/compat/array/differenceBy.mjs

@@ -0,0 +1,19 @@
+import { flatten } from './flatten.mjs';
+import { last } from './last.mjs';
+import { difference } from '../../array/difference.mjs';
+import { differenceBy as differenceBy$1 } from '../../array/differenceBy.mjs';
+import { isArrayLikeObject } from '../predicate/isArrayLikeObject.mjs';
+import { iteratee } from '../util/iteratee.mjs';
+
+function differenceBy(arr, ...values) {
+    if (!isArrayLikeObject(arr)) {
+        return [];
+    }
+    const iteratee$1 = last(values);
+    if (isArrayLikeObject(iteratee$1)) {
+        return difference(Array.from(arr), flatten(values));
+    }
+    return differenceBy$1(Array.from(arr), flatten(values.slice(0, -1)), iteratee(iteratee$1));
+}
+
+export { differenceBy };

package/dist/compat/index.d.mts

@@ -1,6 +1,5 @@
 export { at } from '../array/at.mjs';
 export { countBy } from '../array/countBy.mjs';
-export { differenceBy } from '../array/differenceBy.mjs';
 export { differenceWith } from '../array/differenceWith.mjs';
 export { flatMap } from '../array/flatMap.mjs';
 export { flatMapDeep } from '../array/flatMapDeep.mjs';
@@ -85,6 +84,7 @@ export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
+export { differenceBy } from './array/differenceBy.mjs';
 export { drop } from './array/drop.mjs';
 export { dropRight } from './array/dropRight.mjs';
 export { dropRightWhile } from './array/dropRightWhile.mjs';
@@ -210,6 +210,7 @@ export { upperCase } from './string/upperCase.mjs';
 export { constant } from './util/constant.mjs';
 export { defaultTo } from './util/defaultTo.mjs';
 export { eq } from './util/eq.mjs';
+export { iteratee } from './util/iteratee.mjs';
 export { times } from './util/times.mjs';
 export { toFinite } from './util/toFinite.mjs';
 export { toInteger } from './util/toInteger.mjs';

package/dist/compat/index.d.ts

@@ -1,6 +1,5 @@
 export { at } from '../array/at.js';
 export { countBy } from '../array/countBy.js';
-export { differenceBy } from '../array/differenceBy.js';
 export { differenceWith } from '../array/differenceWith.js';
 export { flatMap } from '../array/flatMap.js';
 export { flatMapDeep } from '../array/flatMapDeep.js';
@@ -85,6 +84,7 @@ export { chunk } from './array/chunk.js';
 export { compact } from './array/compact.js';
 export { concat } from './array/concat.js';
 export { difference } from './array/difference.js';
+export { differenceBy } from './array/differenceBy.js';
 export { drop } from './array/drop.js';
 export { dropRight } from './array/dropRight.js';
 export { dropRightWhile } from './array/dropRightWhile.js';
@@ -210,6 +210,7 @@ export { upperCase } from './string/upperCase.js';
 export { constant } from './util/constant.js';
 export { defaultTo } from './util/defaultTo.js';
 export { eq } from './util/eq.js';
+export { iteratee } from './util/iteratee.js';
 export { times } from './util/times.js';
 export { toFinite } from './util/toFinite.js';
 export { toInteger } from './util/toInteger.js';

package/dist/compat/index.js

@@ -63,49 +63,40 @@ function difference(arr, ...values) {
     return zipWith.difference(arr1, arr2);
 }
 
-function isSymbol(value) {
-    return typeof value === 'symbol' || value instanceof Symbol;
-}
-
-function toNumber(value) {
-    if (isSymbol(value)) {
-        return NaN;
-    }
-    return Number(value);
-}
-
-function toFinite(value) {
-    if (!value) {
-        return value === 0 ? value : 0;
-    }
-    value = toNumber(value);
-    if (value === Infinity || value === -Infinity) {
-        const sign = value < 0 ? -1 : 1;
-        return sign * Number.MAX_VALUE;
-    }
-    return value === value ? value : 0;
-}
-
-function toInteger(value) {
-    const finite = toFinite(value);
-    const remainder = finite % 1;
-    return remainder ? finite - remainder : finite;
-}
-
-function drop(collection, itemsCount = 1, guard) {
-    if (!isArrayLike(collection)) {
-        return [];
+function flatten(value, depth = 1) {
+    const result = [];
+    const flooredDepth = Math.floor(depth);
+    if (!isArrayLike(value)) {
+        return result;
     }
-    itemsCount = guard ? 1 : toInteger(itemsCount);
-    return zipWith.drop(Array.from(collection), itemsCount);
+    const recursive = (arr, currentDepth) => {
+        for (let i = 0; i < arr.length; i++) {
+            const item = arr[i];
+            if (currentDepth < flooredDepth &&
+                (Array.isArray(item) ||
+                    Boolean(item?.[Symbol.isConcatSpreadable]) ||
+                    (item !== null && typeof item === 'object' && Object.prototype.toString.call(item) === '[object Arguments]'))) {
+                if (Array.isArray(item)) {
+                    recursive(item, currentDepth + 1);
+                }
+                else {
+                    recursive(Array.from(item), currentDepth + 1);
+                }
+            }
+            else {
+                result.push(item);
+            }
+        }
+    };
+    recursive(Array.from(value), 0);
+    return result;
 }
 
-function dropRight(collection, itemsCount = 1, guard) {
-    if (!isArrayLike(collection)) {
-        return [];
+function last(array) {
+    if (!isArrayLike(array)) {
+        return undefined;
     }
-    itemsCount = guard ? 1 : toInteger(itemsCount);
-    return zipWith.dropRight(Array.from(collection), itemsCount);
+    return zipWith.last(Array.from(array));
 }
 
 function isDeepKey(key) {
@@ -441,6 +432,77 @@ function matchesProperty(property, source) {
     };
 }
 
+function iteratee(value) {
+    if (value == null) {
+        return unary.identity;
+    }
+    switch (typeof value) {
+        case 'function': {
+            return value;
+        }
+        case 'object': {
+            return Array.isArray(value) ? matchesProperty(value[0], value[1]) : matches(value);
+        }
+    }
+    return property(value);
+}
+
+function differenceBy(arr, ...values) {
+    if (!isArrayLikeObject(arr)) {
+        return [];
+    }
+    const iteratee$1 = last(values);
+    if (isArrayLikeObject(iteratee$1)) {
+        return zipWith.difference(Array.from(arr), flatten(values));
+    }
+    return zipWith.differenceBy(Array.from(arr), flatten(values.slice(0, -1)), iteratee(iteratee$1));
+}
+
+function isSymbol(value) {
+    return typeof value === 'symbol' || value instanceof Symbol;
+}
+
+function toNumber(value) {
+    if (isSymbol(value)) {
+        return NaN;
+    }
+    return Number(value);
+}
+
+function toFinite(value) {
+    if (!value) {
+        return value === 0 ? value : 0;
+    }
+    value = toNumber(value);
+    if (value === Infinity || value === -Infinity) {
+        const sign = value < 0 ? -1 : 1;
+        return sign * Number.MAX_VALUE;
+    }
+    return value === value ? value : 0;
+}
+
+function toInteger(value) {
+    const finite = toFinite(value);
+    const remainder = finite % 1;
+    return remainder ? finite - remainder : finite;
+}
+
+function drop(collection, itemsCount = 1, guard) {
+    if (!isArrayLike(collection)) {
+        return [];
+    }
+    itemsCount = guard ? 1 : toInteger(itemsCount);
+    return zipWith.drop(Array.from(collection), itemsCount);
+}
+
+function dropRight(collection, itemsCount = 1, guard) {
+    if (!isArrayLike(collection)) {
+        return [];
+    }
+    itemsCount = guard ? 1 : toInteger(itemsCount);
+    return zipWith.dropRight(Array.from(collection), itemsCount);
+}
+
 function dropRightWhile(arr, predicate) {
     if (!isArrayLike(arr)) {
         return [];
@@ -708,35 +770,6 @@ function findLastIndex(arr, doesMatch, fromIndex = arr ? arr.length - 1 : 0) {
     }
 }
 
-function flatten(value, depth = 1) {
-    const result = [];
-    const flooredDepth = Math.floor(depth);
-    if (!isArrayLike(value)) {
-        return result;
-    }
-    const recursive = (arr, currentDepth) => {
-        for (let i = 0; i < arr.length; i++) {
-            const item = arr[i];
-            if (currentDepth < flooredDepth &&
-                (Array.isArray(item) ||
-                    Boolean(item?.[Symbol.isConcatSpreadable]) ||
-                    (item !== null && typeof item === 'object' && Object.prototype.toString.call(item) === '[object Arguments]'))) {
-                if (Array.isArray(item)) {
-                    recursive(item, currentDepth + 1);
-                }
-                else {
-                    recursive(Array.from(item), currentDepth + 1);
-                }
-            }
-            else {
-                result.push(item);
-            }
-        }
-    };
-    recursive(Array.from(value), 0);
-    return result;
-}
-
 function flattenDeep(value) {
     return flatten(value, Infinity);
 }
@@ -859,13 +892,6 @@ function join(array, separator = ',') {
     return Array.from(array).join(separator);
 }
 
-function last(array) {
-    if (!isArrayLike(array)) {
-        return undefined;
-    }
-    return zipWith.last(Array.from(array));
-}
-
 function getPriority(a) {
     if (typeof a === 'symbol') {
         return 1;
@@ -2368,7 +2394,6 @@ function uniqueId(prefix = '') {
 
 exports.at = zipWith.at;
 exports.countBy = zipWith.countBy;
-exports.differenceBy = zipWith.differenceBy;
 exports.differenceWith = zipWith.differenceWith;
 exports.flatMap = zipWith.flatMap;
 exports.flatMapDeep = zipWith.flatMapDeep;
@@ -2475,6 +2500,7 @@ exports.defaultTo = defaultTo;
 exports.defaults = defaults;
 exports.defer = defer;
 exports.difference = difference;
+exports.differenceBy = differenceBy;
 exports.drop = drop;
 exports.dropRight = dropRight;
 exports.dropRightWhile = dropRightWhile;
@@ -2531,6 +2557,7 @@ exports.isSymbol = isSymbol;
 exports.isTypedArray = isTypedArray;
 exports.isWeakMap = isWeakMap;
 exports.isWeakSet = isWeakSet;
+exports.iteratee = iteratee;
 exports.join = join;
 exports.kebabCase = kebabCase;
 exports.last = last;

package/dist/compat/index.mjs

@@ -1,6 +1,5 @@
 export { at } from '../array/at.mjs';
 export { countBy } from '../array/countBy.mjs';
-export { differenceBy } from '../array/differenceBy.mjs';
 export { differenceWith } from '../array/differenceWith.mjs';
 export { flatMap } from '../array/flatMap.mjs';
 export { flatMapDeep } from '../array/flatMapDeep.mjs';
@@ -87,6 +86,7 @@ export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
+export { differenceBy } from './array/differenceBy.mjs';
 export { drop } from './array/drop.mjs';
 export { dropRight } from './array/dropRight.mjs';
 export { dropRightWhile } from './array/dropRightWhile.mjs';
@@ -210,6 +210,7 @@ export { trimStart } from './string/trimStart.mjs';
 export { upperCase } from './string/upperCase.mjs';
 export { constant } from './util/constant.mjs';
 export { defaultTo } from './util/defaultTo.mjs';
+export { iteratee } from './util/iteratee.mjs';
 export { times } from './util/times.mjs';
 export { toFinite } from './util/toFinite.mjs';
 export { toInteger } from './util/toInteger.mjs';

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

@@ -0,0 +1,41 @@
+/**
+ * Returns a `identity` function when `value` is `null` or `undefined`.
+ *
+ * @param {null} [value] - The value to convert to an iteratee.
+ * @returns {<T>(value: T) => T} - Returns a `identity` function.
+ *
+ * @example
+ * const func = iteratee();
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [{ a: 1 }, { a: 2 }, { a: 3 }]
+ */
+declare function iteratee(value?: null): <T>(value: T) => T;
+/**
+ * Returns a given `func` function when `value` is a `function`.
+ *
+ * @template {(...args: any[]) => unknown} F - The function type.
+ * @param {F} func - The function to return.
+ * @returns {F} - Returns the given function.
+ *
+ * @example
+ * const func = iteratee((object) => object.a);
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ */
+declare function iteratee<F extends (...args: any[]) => unknown>(func: F): F;
+/**
+ * Creates a function that invokes `value` with the arguments of the created function.
+ *
+ * The created function returns the property value for a given element.
+ *
+ * @param {symbol | number | string | object} value - The value to convert to an iteratee.
+ * @returns {(...args: any[]) => any} - Returns the new iteratee function.
+ *
+ * @example
+ * const func = iteratee('a');
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ */
+declare function iteratee(value: symbol | number | string | object): (...args: any[]) => any;
+
+export { iteratee };

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

@@ -0,0 +1,41 @@
+/**
+ * Returns a `identity` function when `value` is `null` or `undefined`.
+ *
+ * @param {null} [value] - The value to convert to an iteratee.
+ * @returns {<T>(value: T) => T} - Returns a `identity` function.
+ *
+ * @example
+ * const func = iteratee();
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [{ a: 1 }, { a: 2 }, { a: 3 }]
+ */
+declare function iteratee(value?: null): <T>(value: T) => T;
+/**
+ * Returns a given `func` function when `value` is a `function`.
+ *
+ * @template {(...args: any[]) => unknown} F - The function type.
+ * @param {F} func - The function to return.
+ * @returns {F} - Returns the given function.
+ *
+ * @example
+ * const func = iteratee((object) => object.a);
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ */
+declare function iteratee<F extends (...args: any[]) => unknown>(func: F): F;
+/**
+ * Creates a function that invokes `value` with the arguments of the created function.
+ *
+ * The created function returns the property value for a given element.
+ *
+ * @param {symbol | number | string | object} value - The value to convert to an iteratee.
+ * @returns {(...args: any[]) => any} - Returns the new iteratee function.
+ *
+ * @example
+ * const func = iteratee('a');
+ *
+ * [{ a: 1 }, { a: 2 }, { a: 3 }].map(func) // => [1, 2, 3]
+ */
+declare function iteratee(value: symbol | number | string | object): (...args: any[]) => any;
+
+export { iteratee };

package/dist/compat/util/iteratee.mjs

@@ -0,0 +1,21 @@
+import { identity } from '../../function/identity.mjs';
+import { property } from '../object/property.mjs';
+import { matches } from '../predicate/matches.mjs';
+import { matchesProperty } from '../predicate/matchesProperty.mjs';
+
+function iteratee(value) {
+    if (value == null) {
+        return identity;
+    }
+    switch (typeof value) {
+        case 'function': {
+            return value;
+        }
+        case 'object': {
+            return Array.isArray(value) ? matchesProperty(value[0], value[1]) : matches(value);
+        }
+    }
+    return property(value);
+}
+
+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.26.1-dev.834+10205c01",
+  "version": "1.26.1-dev.836+e94c4012",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {