es-toolkit 1.48.1-dev.1890 → 1.48.1-dev.1894

package/dist/fp/array/chunkBy.d.mts

@@ -0,0 +1,20 @@
+//#region src/fp/array/chunkBy.d.ts
+/**
+ * Creates a function that splits consecutive elements whenever the derived key changes.
+ *
+ * The iteratee is called from left to right. A new chunk starts when its key differs
+ * from the previous key by strict inequality. Use the returned function with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param iteratee - Called for each value to produce the comparison key.
+ * @returns A function that maps a readonly array to consecutive same-key chunks.
+ *
+ * @example
+ * import { chunkBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 1, 2, 3, 3], chunkBy(value => value));
+ * // => [[1, 1], [2], [3, 3]]
+ */
+declare function chunkBy<T>(iteratee: (value: T) => unknown): (array: readonly T[]) => T[][];
+//#endregion
+export { chunkBy };

package/dist/fp/array/chunkBy.d.ts

@@ -0,0 +1,20 @@
+//#region src/fp/array/chunkBy.d.ts
+/**
+ * Creates a function that splits consecutive elements whenever the derived key changes.
+ *
+ * The iteratee is called from left to right. A new chunk starts when its key differs
+ * from the previous key by strict inequality. Use the returned function with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param iteratee - Called for each value to produce the comparison key.
+ * @returns A function that maps a readonly array to consecutive same-key chunks.
+ *
+ * @example
+ * import { chunkBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 1, 2, 3, 3], chunkBy(value => value));
+ * // => [[1, 1], [2], [3, 3]]
+ */
+declare function chunkBy<T>(iteratee: (value: T) => unknown): (array: readonly T[]) => T[][];
+//#endregion
+export { chunkBy };

package/dist/fp/array/chunkBy.js

@@ -0,0 +1,25 @@
+const require_chunkBy = require("../../array/chunkBy.js");
+//#region src/fp/array/chunkBy.ts
+/**
+* Creates a function that splits consecutive elements whenever the derived key changes.
+*
+* The iteratee is called from left to right. A new chunk starts when its key differs
+* from the previous key by strict inequality. Use the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param iteratee - Called for each value to produce the comparison key.
+* @returns A function that maps a readonly array to consecutive same-key chunks.
+*
+* @example
+* import { chunkBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 1, 2, 3, 3], chunkBy(value => value));
+* // => [[1, 1], [2], [3, 3]]
+*/
+function chunkBy(iteratee) {
+	return function(array) {
+		return require_chunkBy.chunkBy(array, iteratee);
+	};
+}
+//#endregion
+exports.chunkBy = chunkBy;

package/dist/fp/array/chunkBy.mjs

@@ -0,0 +1,25 @@
+import { chunkBy as chunkBy$1 } from "../../array/chunkBy.mjs";
+//#region src/fp/array/chunkBy.ts
+/**
+* Creates a function that splits consecutive elements whenever the derived key changes.
+*
+* The iteratee is called from left to right. A new chunk starts when its key differs
+* from the previous key by strict inequality. Use the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param iteratee - Called for each value to produce the comparison key.
+* @returns A function that maps a readonly array to consecutive same-key chunks.
+*
+* @example
+* import { chunkBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 1, 2, 3, 3], chunkBy(value => value));
+* // => [[1, 1], [2], [3, 3]]
+*/
+function chunkBy(iteratee) {
+	return function(array) {
+		return chunkBy$1(array, iteratee);
+	};
+}
+//#endregion
+export { chunkBy };

package/dist/fp/array/combinations.d.mts

@@ -0,0 +1,21 @@
+//#region src/fp/array/combinations.d.ts
+/**
+ * Creates a function that returns every combination of the configured size.
+ *
+ * Elements are treated as unique by position, so duplicate values can produce identical-looking
+ * combinations. The returned function throws when size is not a non-negative integer.
+ *
+ * @template T - The type of elements in the array.
+ * @param size - The number of items in each combination.
+ * @returns A function that maps a readonly array to its size-length combinations.
+ * @throws {Error} When size is not a non-negative integer.
+ *
+ * @example
+ * import { combinations, pipe } from 'es-toolkit/fp';
+ *
+ * pipe(['A', 'B', 'C'], combinations(2));
+ * // => [['A', 'B'], ['A', 'C'], ['B', 'C']]
+ */
+declare function combinations<T>(size: number): (array: readonly T[]) => T[][];
+//#endregion
+export { combinations };

package/dist/fp/array/combinations.d.ts

@@ -0,0 +1,21 @@
+//#region src/fp/array/combinations.d.ts
+/**
+ * Creates a function that returns every combination of the configured size.
+ *
+ * Elements are treated as unique by position, so duplicate values can produce identical-looking
+ * combinations. The returned function throws when size is not a non-negative integer.
+ *
+ * @template T - The type of elements in the array.
+ * @param size - The number of items in each combination.
+ * @returns A function that maps a readonly array to its size-length combinations.
+ * @throws {Error} When size is not a non-negative integer.
+ *
+ * @example
+ * import { combinations, pipe } from 'es-toolkit/fp';
+ *
+ * pipe(['A', 'B', 'C'], combinations(2));
+ * // => [['A', 'B'], ['A', 'C'], ['B', 'C']]
+ */
+declare function combinations<T>(size: number): (array: readonly T[]) => T[][];
+//#endregion
+export { combinations };

package/dist/fp/array/combinations.js

@@ -0,0 +1,26 @@
+const require_combinations = require("../../array/combinations.js");
+//#region src/fp/array/combinations.ts
+/**
+* Creates a function that returns every combination of the configured size.
+*
+* Elements are treated as unique by position, so duplicate values can produce identical-looking
+* combinations. The returned function throws when size is not a non-negative integer.
+*
+* @template T - The type of elements in the array.
+* @param size - The number of items in each combination.
+* @returns A function that maps a readonly array to its size-length combinations.
+* @throws {Error} When size is not a non-negative integer.
+*
+* @example
+* import { combinations, pipe } from 'es-toolkit/fp';
+*
+* pipe(['A', 'B', 'C'], combinations(2));
+* // => [['A', 'B'], ['A', 'C'], ['B', 'C']]
+*/
+function combinations(size) {
+	return function(array) {
+		return require_combinations.combinations(array, size);
+	};
+}
+//#endregion
+exports.combinations = combinations;

package/dist/fp/array/combinations.mjs

@@ -0,0 +1,26 @@
+import { combinations as combinations$1 } from "../../array/combinations.mjs";
+//#region src/fp/array/combinations.ts
+/**
+* Creates a function that returns every combination of the configured size.
+*
+* Elements are treated as unique by position, so duplicate values can produce identical-looking
+* combinations. The returned function throws when size is not a non-negative integer.
+*
+* @template T - The type of elements in the array.
+* @param size - The number of items in each combination.
+* @returns A function that maps a readonly array to its size-length combinations.
+* @throws {Error} When size is not a non-negative integer.
+*
+* @example
+* import { combinations, pipe } from 'es-toolkit/fp';
+*
+* pipe(['A', 'B', 'C'], combinations(2));
+* // => [['A', 'B'], ['A', 'C'], ['B', 'C']]
+*/
+function combinations(size) {
+	return function(array) {
+		return combinations$1(array, size);
+	};
+}
+//#endregion
+export { combinations };

package/dist/fp/array/compact.d.mts

@@ -0,0 +1,22 @@
+//#region src/fp/array/compact.d.ts
+type NotFalsey<T> = Exclude<T, false | null | 0 | 0n | '' | undefined>;
+/**
+ * Creates a function that removes falsey values from an array. Use it with {@link pipe}.
+ *
+ * Falsey values include false, null, 0, -0, 0n, an empty string, undefined,
+ * and NaN. The returned function is lazy-capable inside {@link pipe}, so a
+ * trailing short-circuiting operator such as {@link take} can stop once enough
+ * truthy values have been emitted.
+ *
+ * @template T - The type of elements in the array.
+ * @returns A function that maps a readonly array to a new array with falsey values removed.
+ *
+ * @example
+ * import { compact, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([0, 1, false, 2, '', 3], compact());
+ * // => [1, 2, 3]
+ */
+declare function compact<T>(): (array: readonly T[]) => Array<NotFalsey<T>>;
+//#endregion
+export { compact };

package/dist/fp/array/compact.d.ts

@@ -0,0 +1,22 @@
+//#region src/fp/array/compact.d.ts
+type NotFalsey<T> = Exclude<T, false | null | 0 | 0n | '' | undefined>;
+/**
+ * Creates a function that removes falsey values from an array. Use it with {@link pipe}.
+ *
+ * Falsey values include false, null, 0, -0, 0n, an empty string, undefined,
+ * and NaN. The returned function is lazy-capable inside {@link pipe}, so a
+ * trailing short-circuiting operator such as {@link take} can stop once enough
+ * truthy values have been emitted.
+ *
+ * @template T - The type of elements in the array.
+ * @returns A function that maps a readonly array to a new array with falsey values removed.
+ *
+ * @example
+ * import { compact, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([0, 1, false, 2, '', 3], compact());
+ * // => [1, 2, 3]
+ */
+declare function compact<T>(): (array: readonly T[]) => Array<NotFalsey<T>>;
+//#endregion
+export { compact };

package/dist/fp/array/compact.js

@@ -0,0 +1,31 @@
+const require_compact = require("../../array/compact.js");
+const require_lazy = require("../_internal/lazy.js");
+//#region src/fp/array/compact.ts
+/**
+* Creates a function that removes falsey values from an array. Use it with {@link pipe}.
+*
+* Falsey values include false, null, 0, -0, 0n, an empty string, undefined,
+* and NaN. The returned function is lazy-capable inside {@link pipe}, so a
+* trailing short-circuiting operator such as {@link take} can stop once enough
+* truthy values have been emitted.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to a new array with falsey values removed.
+*
+* @example
+* import { compact, pipe } from 'es-toolkit/fp';
+*
+* pipe([0, 1, false, 2, '', 3], compact());
+* // => [1, 2, 3]
+*/
+function compact() {
+	function compactEager(array) {
+		return require_compact.compact(array);
+	}
+	const compactLazy = require_lazy.createLazyFunction((value, _index, emit) => {
+		if (value) emit(value);
+	});
+	return require_lazy.combineEagerAndLazyFunctions(compactEager, compactLazy);
+}
+//#endregion
+exports.compact = compact;

package/dist/fp/array/compact.mjs

@@ -0,0 +1,30 @@
+import { compact as compact$1 } from "../../array/compact.mjs";
+import { combineEagerAndLazyFunctions, createLazyFunction } from "../_internal/lazy.mjs";
+//#region src/fp/array/compact.ts
+/**
+* Creates a function that removes falsey values from an array. Use it with {@link pipe}.
+*
+* Falsey values include false, null, 0, -0, 0n, an empty string, undefined,
+* and NaN. The returned function is lazy-capable inside {@link pipe}, so a
+* trailing short-circuiting operator such as {@link take} can stop once enough
+* truthy values have been emitted.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to a new array with falsey values removed.
+*
+* @example
+* import { compact, pipe } from 'es-toolkit/fp';
+*
+* pipe([0, 1, false, 2, '', 3], compact());
+* // => [1, 2, 3]
+*/
+function compact() {
+	function compactEager(array) {
+		return compact$1(array);
+	}
+	return combineEagerAndLazyFunctions(compactEager, createLazyFunction((value, _index, emit) => {
+		if (value) emit(value);
+	}));
+}
+//#endregion
+export { compact };

package/dist/fp/array/countBy.d.mts

@@ -0,0 +1,21 @@
+//#region src/fp/array/countBy.d.ts
+/**
+ * Creates a function that counts values by a derived key.
+ *
+ * The mapper receives each value, its index, and the full input array. The returned object
+ * uses mapper results as keys and occurrence counts as values.
+ *
+ * @template T - The type of elements in the array.
+ * @template K - The property-key type produced by the mapper.
+ * @param mapper - Called with each value, index, and array to produce a key.
+ * @returns A function that maps a readonly array to counts by key.
+ *
+ * @example
+ * import { countBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3, 4, 5], countBy(value => (value % 2 === 0 ? 'even' : 'odd')));
+ * // => { odd: 3, even: 2 }
+ */
+declare function countBy<T, K extends PropertyKey>(mapper: (item: T, index: number, array: readonly T[]) => K): (array: readonly T[]) => Record<K, number>;
+//#endregion
+export { countBy };

package/dist/fp/array/countBy.d.ts

@@ -0,0 +1,21 @@
+//#region src/fp/array/countBy.d.ts
+/**
+ * Creates a function that counts values by a derived key.
+ *
+ * The mapper receives each value, its index, and the full input array. The returned object
+ * uses mapper results as keys and occurrence counts as values.
+ *
+ * @template T - The type of elements in the array.
+ * @template K - The property-key type produced by the mapper.
+ * @param mapper - Called with each value, index, and array to produce a key.
+ * @returns A function that maps a readonly array to counts by key.
+ *
+ * @example
+ * import { countBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3, 4, 5], countBy(value => (value % 2 === 0 ? 'even' : 'odd')));
+ * // => { odd: 3, even: 2 }
+ */
+declare function countBy<T, K extends PropertyKey>(mapper: (item: T, index: number, array: readonly T[]) => K): (array: readonly T[]) => Record<K, number>;
+//#endregion
+export { countBy };

package/dist/fp/array/countBy.js

@@ -0,0 +1,26 @@
+const require_countBy = require("../../array/countBy.js");
+//#region src/fp/array/countBy.ts
+/**
+* Creates a function that counts values by a derived key.
+*
+* The mapper receives each value, its index, and the full input array. The returned object
+* uses mapper results as keys and occurrence counts as values.
+*
+* @template T - The type of elements in the array.
+* @template K - The property-key type produced by the mapper.
+* @param mapper - Called with each value, index, and array to produce a key.
+* @returns A function that maps a readonly array to counts by key.
+*
+* @example
+* import { countBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3, 4, 5], countBy(value => (value % 2 === 0 ? 'even' : 'odd')));
+* // => { odd: 3, even: 2 }
+*/
+function countBy(mapper) {
+	return function(array) {
+		return require_countBy.countBy(array, mapper);
+	};
+}
+//#endregion
+exports.countBy = countBy;

package/dist/fp/array/countBy.mjs

@@ -0,0 +1,26 @@
+import { countBy as countBy$1 } from "../../array/countBy.mjs";
+//#region src/fp/array/countBy.ts
+/**
+* Creates a function that counts values by a derived key.
+*
+* The mapper receives each value, its index, and the full input array. The returned object
+* uses mapper results as keys and occurrence counts as values.
+*
+* @template T - The type of elements in the array.
+* @template K - The property-key type produced by the mapper.
+* @param mapper - Called with each value, index, and array to produce a key.
+* @returns A function that maps a readonly array to counts by key.
+*
+* @example
+* import { countBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3, 4, 5], countBy(value => (value % 2 === 0 ? 'even' : 'odd')));
+* // => { odd: 3, even: 2 }
+*/
+function countBy(mapper) {
+	return function(array) {
+		return countBy$1(array, mapper);
+	};
+}
+//#endregion
+export { countBy };

package/dist/fp/array/difference.d.mts

@@ -0,0 +1,21 @@
+//#region src/fp/array/difference.d.ts
+/**
+ * Creates a function that returns values from the piped array that are not present in another array.
+ *
+ * Equality follows SameValueZero through Set membership, matching the main
+ * {@link difference} implementation. The returned function is lazy-capable
+ * inside {@link pipe}.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param secondArray - Values to exclude from the piped array.
+ * @returns A function that maps the piped array to its difference.
+ *
+ * @example
+ * import { difference, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3], difference([2, 4]));
+ * // => [1, 3]
+ */
+declare function difference<T>(secondArray: readonly T[]): (array: readonly T[]) => T[];
+//#endregion
+export { difference };

package/dist/fp/array/difference.d.ts

@@ -0,0 +1,21 @@
+//#region src/fp/array/difference.d.ts
+/**
+ * Creates a function that returns values from the piped array that are not present in another array.
+ *
+ * Equality follows SameValueZero through Set membership, matching the main
+ * {@link difference} implementation. The returned function is lazy-capable
+ * inside {@link pipe}.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param secondArray - Values to exclude from the piped array.
+ * @returns A function that maps the piped array to its difference.
+ *
+ * @example
+ * import { difference, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3], difference([2, 4]));
+ * // => [1, 3]
+ */
+declare function difference<T>(secondArray: readonly T[]): (array: readonly T[]) => T[];
+//#endregion
+export { difference };

package/dist/fp/array/difference.js

@@ -0,0 +1,32 @@
+const require_difference = require("../../array/difference.js");
+const require_lazy = require("../_internal/lazy.js");
+//#region src/fp/array/difference.ts
+/**
+* Creates a function that returns values from the piped array that are not present in another array.
+*
+* Equality follows SameValueZero through Set membership, matching the main
+* {@link difference} implementation. The returned function is lazy-capable
+* inside {@link pipe}.
+*
+* @template T - The type of elements in the arrays.
+* @param secondArray - Values to exclude from the piped array.
+* @returns A function that maps the piped array to its difference.
+*
+* @example
+* import { difference, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], difference([2, 4]));
+* // => [1, 3]
+*/
+function difference(secondArray) {
+	const secondSet = new Set(secondArray);
+	function differenceEager(array) {
+		return require_difference.difference(array, secondArray);
+	}
+	const differenceLazy = require_lazy.createLazyFunction((value, _index, emit) => {
+		if (!secondSet.has(value)) emit(value);
+	});
+	return require_lazy.combineEagerAndLazyFunctions(differenceEager, differenceLazy);
+}
+//#endregion
+exports.difference = difference;

package/dist/fp/array/difference.mjs

@@ -0,0 +1,31 @@
+import { difference as difference$1 } from "../../array/difference.mjs";
+import { combineEagerAndLazyFunctions, createLazyFunction } from "../_internal/lazy.mjs";
+//#region src/fp/array/difference.ts
+/**
+* Creates a function that returns values from the piped array that are not present in another array.
+*
+* Equality follows SameValueZero through Set membership, matching the main
+* {@link difference} implementation. The returned function is lazy-capable
+* inside {@link pipe}.
+*
+* @template T - The type of elements in the arrays.
+* @param secondArray - Values to exclude from the piped array.
+* @returns A function that maps the piped array to its difference.
+*
+* @example
+* import { difference, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], difference([2, 4]));
+* // => [1, 3]
+*/
+function difference(secondArray) {
+	const secondSet = new Set(secondArray);
+	function differenceEager(array) {
+		return difference$1(array, secondArray);
+	}
+	return combineEagerAndLazyFunctions(differenceEager, createLazyFunction((value, _index, emit) => {
+		if (!secondSet.has(value)) emit(value);
+	}));
+}
+//#endregion
+export { difference };

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

@@ -0,0 +1,22 @@
+//#region src/fp/array/differenceBy.d.ts
+/**
+ * Creates a function that returns values whose mapped identity is absent from another array.
+ *
+ * The mapper is applied to values from both arrays. The returned function is
+ * lazy-capable inside {@link pipe}.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the configured array.
+ * @param secondArray - Values to exclude from the piped array after mapping.
+ * @param mapper - Maps values from both arrays to comparison keys.
+ * @returns A function that maps the piped array to its mapped difference.
+ *
+ * @example
+ * import { differenceBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([{ id: 1 }, { id: 2 }], differenceBy([2], value => typeof value === 'number' ? value : value.id));
+ * // => [{ id: 1 }]
+ */
+declare function differenceBy<T, U>(secondArray: readonly U[], mapper: (value: T | U) => unknown): (array: readonly T[]) => T[];
+//#endregion
+export { differenceBy };

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

@@ -0,0 +1,22 @@
+//#region src/fp/array/differenceBy.d.ts
+/**
+ * Creates a function that returns values whose mapped identity is absent from another array.
+ *
+ * The mapper is applied to values from both arrays. The returned function is
+ * lazy-capable inside {@link pipe}.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the configured array.
+ * @param secondArray - Values to exclude from the piped array after mapping.
+ * @param mapper - Maps values from both arrays to comparison keys.
+ * @returns A function that maps the piped array to its mapped difference.
+ *
+ * @example
+ * import { differenceBy, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([{ id: 1 }, { id: 2 }], differenceBy([2], value => typeof value === 'number' ? value : value.id));
+ * // => [{ id: 1 }]
+ */
+declare function differenceBy<T, U>(secondArray: readonly U[], mapper: (value: T | U) => unknown): (array: readonly T[]) => T[];
+//#endregion
+export { differenceBy };

package/dist/fp/array/differenceBy.js

@@ -0,0 +1,33 @@
+const require_differenceBy = require("../../array/differenceBy.js");
+const require_lazy = require("../_internal/lazy.js");
+//#region src/fp/array/differenceBy.ts
+/**
+* Creates a function that returns values whose mapped identity is absent from another array.
+*
+* The mapper is applied to values from both arrays. The returned function is
+* lazy-capable inside {@link pipe}.
+*
+* @template T - The type of elements in the piped array.
+* @template U - The type of elements in the configured array.
+* @param secondArray - Values to exclude from the piped array after mapping.
+* @param mapper - Maps values from both arrays to comparison keys.
+* @returns A function that maps the piped array to its mapped difference.
+*
+* @example
+* import { differenceBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ id: 1 }, { id: 2 }], differenceBy([2], value => typeof value === 'number' ? value : value.id));
+* // => [{ id: 1 }]
+*/
+function differenceBy(secondArray, mapper) {
+	const mappedSecondSet = new Set(secondArray.map((item) => mapper(item)));
+	function differenceByEager(array) {
+		return require_differenceBy.differenceBy(array, secondArray, mapper);
+	}
+	const differenceByLazy = require_lazy.createLazyFunction((value, _index, emit) => {
+		if (!mappedSecondSet.has(mapper(value))) emit(value);
+	});
+	return require_lazy.combineEagerAndLazyFunctions(differenceByEager, differenceByLazy);
+}
+//#endregion
+exports.differenceBy = differenceBy;

package/dist/fp/array/differenceBy.mjs

@@ -0,0 +1,32 @@
+import { differenceBy as differenceBy$1 } from "../../array/differenceBy.mjs";
+import { combineEagerAndLazyFunctions, createLazyFunction } from "../_internal/lazy.mjs";
+//#region src/fp/array/differenceBy.ts
+/**
+* Creates a function that returns values whose mapped identity is absent from another array.
+*
+* The mapper is applied to values from both arrays. The returned function is
+* lazy-capable inside {@link pipe}.
+*
+* @template T - The type of elements in the piped array.
+* @template U - The type of elements in the configured array.
+* @param secondArray - Values to exclude from the piped array after mapping.
+* @param mapper - Maps values from both arrays to comparison keys.
+* @returns A function that maps the piped array to its mapped difference.
+*
+* @example
+* import { differenceBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ id: 1 }, { id: 2 }], differenceBy([2], value => typeof value === 'number' ? value : value.id));
+* // => [{ id: 1 }]
+*/
+function differenceBy(secondArray, mapper) {
+	const mappedSecondSet = new Set(secondArray.map((item) => mapper(item)));
+	function differenceByEager(array) {
+		return differenceBy$1(array, secondArray, mapper);
+	}
+	return combineEagerAndLazyFunctions(differenceByEager, createLazyFunction((value, _index, emit) => {
+		if (!mappedSecondSet.has(mapper(value))) emit(value);
+	}));
+}
+//#endregion
+export { differenceBy };

package/dist/fp/array/differenceWith.d.mts

@@ -0,0 +1,22 @@
+//#region src/fp/array/differenceWith.d.ts
+/**
+ * Creates a function that returns values that are not equal to any configured value.
+ *
+ * Equality is decided by the provided comparator. The returned function is
+ * lazy-capable inside {@link pipe}.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the configured array.
+ * @param secondArray - Values to compare against the piped array.
+ * @param areItemsEqual - Returns true when a piped value equals a configured value.
+ * @returns A function that maps the piped array to its custom difference.
+ *
+ * @example
+ * import { differenceWith, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([{ id: 1 }, { id: 2 }], differenceWith([2], (item, id) => item.id === id));
+ * // => [{ id: 1 }]
+ */
+declare function differenceWith<T, U>(secondArray: readonly U[], areItemsEqual: (item: T, other: U) => boolean): (array: readonly T[]) => T[];
+//#endregion
+export { differenceWith };