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

package/dist/compat/compat.js

@@ -1,8 +1,4 @@
 const require_runtime = require("../_virtual/_rolldown/runtime.js");
-const require_isSymbol = require("./predicate/isSymbol.js");
-const require_toNumber = require("./util/toNumber.js");
-const require_toFinite = require("./util/toFinite.js");
-const require_toInteger = require("./util/toInteger.js");
 const require_isArray = require("./predicate/isArray.js");
 const require_isPlainObject = require("./predicate/isPlainObject.js");
 const require_isEqualsSameValueZero = require("../_internal/isEqualsSameValueZero.js");
@@ -34,6 +30,10 @@ const require_difference = require("./array/difference.js");
 const require_last = require("./array/last.js");
 const require_differenceBy = require("./array/differenceBy.js");
 const require_differenceWith = require("./array/differenceWith.js");
+const require_isSymbol = require("./predicate/isSymbol.js");
+const require_toNumber = require("./util/toNumber.js");
+const require_toFinite = require("./util/toFinite.js");
+const require_toInteger = require("./util/toInteger.js");
 const require_drop = require("./array/drop.js");
 const require_dropRight = require("./array/dropRight.js");
 const require_dropRightWhile = require("./array/dropRightWhile.js");

package/dist/compat/compat.mjs

@@ -1,8 +1,4 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.mjs";
-import { isSymbol } from "./predicate/isSymbol.mjs";
-import { toNumber } from "./util/toNumber.mjs";
-import { toFinite } from "./util/toFinite.mjs";
-import { toInteger } from "./util/toInteger.mjs";
 import { isArray } from "./predicate/isArray.mjs";
 import { isPlainObject } from "./predicate/isPlainObject.mjs";
 import { isEqualsSameValueZero } from "../_internal/isEqualsSameValueZero.mjs";
@@ -34,6 +30,10 @@ import { difference } from "./array/difference.mjs";
 import { last } from "./array/last.mjs";
 import { differenceBy } from "./array/differenceBy.mjs";
 import { differenceWith } from "./array/differenceWith.mjs";
+import { isSymbol } from "./predicate/isSymbol.mjs";
+import { toNumber } from "./util/toNumber.mjs";
+import { toFinite } from "./util/toFinite.mjs";
+import { toInteger } from "./util/toInteger.mjs";
 import { drop } from "./array/drop.mjs";
 import { dropRight } from "./array/dropRight.mjs";
 import { dropRightWhile } from "./array/dropRightWhile.mjs";

package/dist/compat/index.js

@@ -2,10 +2,6 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_isSymbol = require("./predicate/isSymbol.js");
-const require_toNumber = require("./util/toNumber.js");
-const require_toFinite = require("./util/toFinite.js");
-const require_toInteger = require("./util/toInteger.js");
 const require_isArray = require("./predicate/isArray.js");
 const require_isPlainObject = require("./predicate/isPlainObject.js");
 const require_isEqualsSameValueZero = require("../_internal/isEqualsSameValueZero.js");
@@ -36,6 +32,10 @@ const require_difference = require("./array/difference.js");
 const require_last = require("./array/last.js");
 const require_differenceBy = require("./array/differenceBy.js");
 const require_differenceWith = require("./array/differenceWith.js");
+const require_isSymbol = require("./predicate/isSymbol.js");
+const require_toNumber = require("./util/toNumber.js");
+const require_toFinite = require("./util/toFinite.js");
+const require_toInteger = require("./util/toInteger.js");
 const require_drop = require("./array/drop.js");
 const require_dropRight = require("./array/dropRight.js");
 const require_dropRightWhile = require("./array/dropRightWhile.js");

package/dist/compat/index.mjs

@@ -1,7 +1,3 @@
-import { isSymbol } from "./predicate/isSymbol.mjs";
-import { toNumber } from "./util/toNumber.mjs";
-import { toFinite } from "./util/toFinite.mjs";
-import { toInteger } from "./util/toInteger.mjs";
 import { isArray } from "./predicate/isArray.mjs";
 import { isPlainObject } from "./predicate/isPlainObject.mjs";
 import { isEqualsSameValueZero } from "../_internal/isEqualsSameValueZero.mjs";
@@ -32,6 +28,10 @@ import { difference } from "./array/difference.mjs";
 import { last } from "./array/last.mjs";
 import { differenceBy } from "./array/differenceBy.mjs";
 import { differenceWith } from "./array/differenceWith.mjs";
+import { isSymbol } from "./predicate/isSymbol.mjs";
+import { toNumber } from "./util/toNumber.mjs";
+import { toFinite } from "./util/toFinite.mjs";
+import { toInteger } from "./util/toInteger.mjs";
 import { drop } from "./array/drop.mjs";
 import { dropRight } from "./array/dropRight.mjs";
 import { dropRightWhile } from "./array/dropRightWhile.mjs";

package/dist/compat/math/add.js

@@ -1,5 +1,5 @@
-const require_toNumber = require("../util/toNumber.js");
 const require_toString = require("../util/toString.js");
+const require_toNumber = require("../util/toNumber.js");
 //#region src/compat/math/add.ts
 /**
 * Adds two numbers while safely handling `NaN` values.

package/dist/compat/math/add.mjs

@@ -1,5 +1,5 @@
-import { toNumber } from "../util/toNumber.mjs";
 import { toString } from "../util/toString.mjs";
+import { toNumber } from "../util/toNumber.mjs";
 //#region src/compat/math/add.ts
 /**
 * Adds two numbers while safely handling `NaN` values.

package/dist/compat/math/divide.js

@@ -1,5 +1,5 @@
-const require_toNumber = require("../util/toNumber.js");
 const require_toString = require("../util/toString.js");
+const require_toNumber = require("../util/toNumber.js");
 //#region src/compat/math/divide.ts
 /**
 * Divide two numbers.

package/dist/compat/math/divide.mjs

@@ -1,5 +1,5 @@
-import { toNumber } from "../util/toNumber.mjs";
 import { toString } from "../util/toString.mjs";
+import { toNumber } from "../util/toNumber.mjs";
 //#region src/compat/math/divide.ts
 /**
 * Divide two numbers.

package/dist/compat/math/multiply.js

@@ -1,5 +1,5 @@
-const require_toNumber = require("../util/toNumber.js");
 const require_toString = require("../util/toString.js");
+const require_toNumber = require("../util/toNumber.js");
 //#region src/compat/math/multiply.ts
 /**
 * Multiply two numbers.

package/dist/compat/math/multiply.mjs

@@ -1,5 +1,5 @@
-import { toNumber } from "../util/toNumber.mjs";
 import { toString } from "../util/toString.mjs";
+import { toNumber } from "../util/toNumber.mjs";
 //#region src/compat/math/multiply.ts
 /**
 * Multiply two numbers.

package/dist/compat/math/subtract.js

@@ -1,5 +1,5 @@
-const require_toNumber = require("../util/toNumber.js");
 const require_toString = require("../util/toString.js");
+const require_toNumber = require("../util/toNumber.js");
 //#region src/compat/math/subtract.ts
 /**
 * Subtracts one number from another.

package/dist/compat/math/subtract.mjs

@@ -1,5 +1,5 @@
-import { toNumber } from "../util/toNumber.mjs";
 import { toString } from "../util/toString.mjs";
+import { toNumber } from "../util/toNumber.mjs";
 //#region src/compat/math/subtract.ts
 /**
 * Subtracts one number from another.

package/dist/compat/object/omitBy.js

@@ -1,5 +1,5 @@
-const require_isSymbol = require("../predicate/isSymbol.js");
 const require_iteratee = require("../util/iteratee.js");
+const require_isSymbol = require("../predicate/isSymbol.js");
 const require_identity = require("../function/identity.js");
 const require_keysIn = require("./keysIn.js");
 const require_getSymbolsIn = require("../_internal/getSymbolsIn.js");

package/dist/compat/object/omitBy.mjs

@@ -1,5 +1,5 @@
-import { isSymbol } from "../predicate/isSymbol.mjs";
 import { iteratee } from "../util/iteratee.mjs";
+import { isSymbol } from "../predicate/isSymbol.mjs";
 import { identity } from "../function/identity.mjs";
 import { keysIn } from "./keysIn.mjs";
 import { getSymbolsIn } from "../_internal/getSymbolsIn.mjs";

package/dist/compat/object/pickBy.js

@@ -1,7 +1,7 @@
-const require_isSymbol = require("../predicate/isSymbol.js");
 const require_range = require("../../math/range.js");
 const require_isArrayLike = require("../predicate/isArrayLike.js");
 const require_iteratee = require("../util/iteratee.js");
+const require_isSymbol = require("../predicate/isSymbol.js");
 const require_identity = require("../function/identity.js");
 const require_keysIn = require("./keysIn.js");
 const require_getSymbolsIn = require("../_internal/getSymbolsIn.js");

package/dist/compat/object/pickBy.mjs

@@ -1,7 +1,7 @@
-import { isSymbol } from "../predicate/isSymbol.mjs";
 import { range } from "../../math/range.mjs";
 import { isArrayLike } from "../predicate/isArrayLike.mjs";
 import { iteratee } from "../util/iteratee.mjs";
+import { isSymbol } from "../predicate/isSymbol.mjs";
 import { identity } from "../function/identity.mjs";
 import { keysIn } from "./keysIn.mjs";
 import { getSymbolsIn } from "../_internal/getSymbolsIn.mjs";

package/dist/compat/string/repeat.js

@@ -1,5 +1,5 @@
-const require_toInteger = require("../util/toInteger.js");
 const require_toString = require("../util/toString.js");
+const require_toInteger = require("../util/toInteger.js");
 const require_isIterateeCall = require("../_internal/isIterateeCall.js");
 const require_MAX_SAFE_INTEGER = require("../_internal/MAX_SAFE_INTEGER.js");
 //#region src/compat/string/repeat.ts

package/dist/compat/string/repeat.mjs

@@ -1,5 +1,5 @@
-import { toInteger } from "../util/toInteger.mjs";
 import { toString } from "../util/toString.mjs";
+import { toInteger } from "../util/toInteger.mjs";
 import { isIterateeCall } from "../_internal/isIterateeCall.mjs";
 import { MAX_SAFE_INTEGER } from "../_internal/MAX_SAFE_INTEGER.mjs";
 //#region src/compat/string/repeat.ts

package/dist/fp/_internal/lazy.js

@@ -0,0 +1,58 @@
+//#region src/fp/_internal/lazy.ts
+/**
+* Pairs an eager data-last function with a lazy transform (see
+* {@link createLazyFunction}).
+*
+* The returned function behaves exactly like `eager` when called directly. When
+* placed inside a {@link pipe}, the attached transform lets `pipe` fuse it with
+* adjacent lazy functions into a single, short-circuiting pass.
+*
+* @template Eager - The eager data-last function type.
+* @param eager - The eager `(array) => result` implementation.
+* @param lazy - The lazy transform built by {@link createLazyFunction}.
+* @param options - Set `shortCircuit: true` for functions that can end a run early.
+* @returns `eager`, augmented in place with the lazy metadata.
+*/
+function combineEagerAndLazyFunctions(eager, lazy, { shortCircuit } = {}) {
+	return Object.assign(eager, {
+		lazy,
+		shortCircuit
+	});
+}
+/**
+* Builds a {@link LazyTransform} from a per-element `step`.
+*
+* `step` receives each input `value`, its zero-based `index` within this stage,
+* and an `emit` callback that forwards a result to the next stage. Call `emit`
+* zero times (drop), once (`map`), or many times (`flatMap`). Return
+* `false` to end the run after this element (used by short-circuiting functions
+* like `take`); returning nothing continues.
+*
+* @template T - The type of values entering this stage.
+* @template U - The type of values it emits.
+* @param step - The per-element push function.
+* @returns A lazy transform that `pipe` can fuse and drive.
+*
+* @example
+* // map
+* createLazyFunction<T, U>((value, index, emit) => {
+*   emit(callback(value, index));
+* });
+*/
+function createLazyFunction(step) {
+	return (emit) => {
+		let index = 0;
+		let active = true;
+		const _emit = (value) => {
+			if (!active) return;
+			if (emit(value) === false) active = false;
+		};
+		return (value) => {
+			if (step(value, index++, _emit) === false) active = false;
+			return active;
+		};
+	};
+}
+//#endregion
+exports.combineEagerAndLazyFunctions = combineEagerAndLazyFunctions;
+exports.createLazyFunction = createLazyFunction;

package/dist/fp/_internal/lazy.mjs

@@ -0,0 +1,57 @@
+//#region src/fp/_internal/lazy.ts
+/**
+* Pairs an eager data-last function with a lazy transform (see
+* {@link createLazyFunction}).
+*
+* The returned function behaves exactly like `eager` when called directly. When
+* placed inside a {@link pipe}, the attached transform lets `pipe` fuse it with
+* adjacent lazy functions into a single, short-circuiting pass.
+*
+* @template Eager - The eager data-last function type.
+* @param eager - The eager `(array) => result` implementation.
+* @param lazy - The lazy transform built by {@link createLazyFunction}.
+* @param options - Set `shortCircuit: true` for functions that can end a run early.
+* @returns `eager`, augmented in place with the lazy metadata.
+*/
+function combineEagerAndLazyFunctions(eager, lazy, { shortCircuit } = {}) {
+	return Object.assign(eager, {
+		lazy,
+		shortCircuit
+	});
+}
+/**
+* Builds a {@link LazyTransform} from a per-element `step`.
+*
+* `step` receives each input `value`, its zero-based `index` within this stage,
+* and an `emit` callback that forwards a result to the next stage. Call `emit`
+* zero times (drop), once (`map`), or many times (`flatMap`). Return
+* `false` to end the run after this element (used by short-circuiting functions
+* like `take`); returning nothing continues.
+*
+* @template T - The type of values entering this stage.
+* @template U - The type of values it emits.
+* @param step - The per-element push function.
+* @returns A lazy transform that `pipe` can fuse and drive.
+*
+* @example
+* // map
+* createLazyFunction<T, U>((value, index, emit) => {
+*   emit(callback(value, index));
+* });
+*/
+function createLazyFunction(step) {
+	return (emit) => {
+		let index = 0;
+		let active = true;
+		const _emit = (value) => {
+			if (!active) return;
+			if (emit(value) === false) active = false;
+		};
+		return (value) => {
+			if (step(value, index++, _emit) === false) active = false;
+			return active;
+		};
+	};
+}
+//#endregion
+export { combineEagerAndLazyFunctions, createLazyFunction };

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

@@ -0,0 +1,20 @@
+//#region src/fp/array/at.d.ts
+/**
+ * Creates a function that retrieves elements from the piped array at the specified indices.
+ *
+ * Negative indices count back from the end of the array, matching the main {@link at}
+ * implementation. Use the returned function with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param indices - The indices of the elements to retrieve from the piped array.
+ * @returns A function that maps a readonly array to a new array of selected values.
+ *
+ * @example
+ * import { at, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([10, 20, 30, 40], at([1, -1]));
+ * // => [20, 40]
+ */
+declare function at<T>(indices: number[]): (array: readonly T[]) => T[];
+//#endregion
+export { at };

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

@@ -0,0 +1,20 @@
+//#region src/fp/array/at.d.ts
+/**
+ * Creates a function that retrieves elements from the piped array at the specified indices.
+ *
+ * Negative indices count back from the end of the array, matching the main {@link at}
+ * implementation. Use the returned function with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param indices - The indices of the elements to retrieve from the piped array.
+ * @returns A function that maps a readonly array to a new array of selected values.
+ *
+ * @example
+ * import { at, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([10, 20, 30, 40], at([1, -1]));
+ * // => [20, 40]
+ */
+declare function at<T>(indices: number[]): (array: readonly T[]) => T[];
+//#endregion
+export { at };

package/dist/fp/array/at.js

@@ -0,0 +1,25 @@
+const require_at = require("../../array/at.js");
+//#region src/fp/array/at.ts
+/**
+* Creates a function that retrieves elements from the piped array at the specified indices.
+*
+* Negative indices count back from the end of the array, matching the main {@link at}
+* implementation. Use the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param indices - The indices of the elements to retrieve from the piped array.
+* @returns A function that maps a readonly array to a new array of selected values.
+*
+* @example
+* import { at, pipe } from 'es-toolkit/fp';
+*
+* pipe([10, 20, 30, 40], at([1, -1]));
+* // => [20, 40]
+*/
+function at(indices) {
+	return function(array) {
+		return require_at.at(array, indices);
+	};
+}
+//#endregion
+exports.at = at;

package/dist/fp/array/at.mjs

@@ -0,0 +1,25 @@
+import { at as at$1 } from "../../array/at.mjs";
+//#region src/fp/array/at.ts
+/**
+* Creates a function that retrieves elements from the piped array at the specified indices.
+*
+* Negative indices count back from the end of the array, matching the main {@link at}
+* implementation. Use the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param indices - The indices of the elements to retrieve from the piped array.
+* @returns A function that maps a readonly array to a new array of selected values.
+*
+* @example
+* import { at, pipe } from 'es-toolkit/fp';
+*
+* pipe([10, 20, 30, 40], at([1, -1]));
+* // => [20, 40]
+*/
+function at(indices) {
+	return function(array) {
+		return at$1(array, indices);
+	};
+}
+//#endregion
+export { at };

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

@@ -0,0 +1,61 @@
+//#region src/fp/array/cartesianProduct.d.ts
+/**
+ * Creates a function that wraps each element of the piped array in a one-item tuple.
+ *
+ * @template T - The type of elements in the piped array.
+ * @returns A function that maps the piped array to one-item cartesian product tuples.
+ *
+ * @example
+ * import { cartesianProduct, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2], cartesianProduct());
+ * // => [[1], [2]]
+ */
+declare function cartesianProduct<T>(): (array: readonly T[]) => Array<[T]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and one configured array.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the configured array.
+ * @param arr2 - The second array in the cartesian product.
+ * @returns A function that maps the piped array to two-item cartesian product tuples.
+ *
+ * @example
+ * pipe([1, 2], cartesianProduct(['a', 'b']));
+ * // => [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
+ */
+declare function cartesianProduct<T, U>(arr2: readonly U[]): (array: readonly T[]) => Array<[T, U]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and two configured arrays.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the second array.
+ * @template V - The type of elements in the third array.
+ * @param arr2 - The second array in the cartesian product.
+ * @param arr3 - The third array in the cartesian product.
+ * @returns A function that maps the piped array to three-item cartesian product tuples.
+ */
+declare function cartesianProduct<T, U, V>(arr2: readonly U[], arr3: readonly V[]): (array: readonly T[]) => Array<[T, U, V]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and three configured arrays.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the second array.
+ * @template V - The type of elements in the third array.
+ * @template W - The type of elements in the fourth array.
+ * @param arr2 - The second array in the cartesian product.
+ * @param arr3 - The third array in the cartesian product.
+ * @param arr4 - The fourth array in the cartesian product.
+ * @returns A function that maps the piped array to four-item cartesian product tuples.
+ */
+declare function cartesianProduct<T, U, V, W>(arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): (array: readonly T[]) => Array<[T, U, V, W]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and any number of configured arrays.
+ *
+ * @template T - The shared element type of the arrays.
+ * @param arrs - Additional arrays included in the cartesian product.
+ * @returns A function that maps the piped array to cartesian product rows.
+ */
+declare function cartesianProduct<T>(...arrs: Array<readonly T[]>): (array: readonly T[]) => T[][];
+//#endregion
+export { cartesianProduct };

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

@@ -0,0 +1,61 @@
+//#region src/fp/array/cartesianProduct.d.ts
+/**
+ * Creates a function that wraps each element of the piped array in a one-item tuple.
+ *
+ * @template T - The type of elements in the piped array.
+ * @returns A function that maps the piped array to one-item cartesian product tuples.
+ *
+ * @example
+ * import { cartesianProduct, pipe } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2], cartesianProduct());
+ * // => [[1], [2]]
+ */
+declare function cartesianProduct<T>(): (array: readonly T[]) => Array<[T]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and one configured array.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the configured array.
+ * @param arr2 - The second array in the cartesian product.
+ * @returns A function that maps the piped array to two-item cartesian product tuples.
+ *
+ * @example
+ * pipe([1, 2], cartesianProduct(['a', 'b']));
+ * // => [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
+ */
+declare function cartesianProduct<T, U>(arr2: readonly U[]): (array: readonly T[]) => Array<[T, U]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and two configured arrays.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the second array.
+ * @template V - The type of elements in the third array.
+ * @param arr2 - The second array in the cartesian product.
+ * @param arr3 - The third array in the cartesian product.
+ * @returns A function that maps the piped array to three-item cartesian product tuples.
+ */
+declare function cartesianProduct<T, U, V>(arr2: readonly U[], arr3: readonly V[]): (array: readonly T[]) => Array<[T, U, V]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and three configured arrays.
+ *
+ * @template T - The type of elements in the piped array.
+ * @template U - The type of elements in the second array.
+ * @template V - The type of elements in the third array.
+ * @template W - The type of elements in the fourth array.
+ * @param arr2 - The second array in the cartesian product.
+ * @param arr3 - The third array in the cartesian product.
+ * @param arr4 - The fourth array in the cartesian product.
+ * @returns A function that maps the piped array to four-item cartesian product tuples.
+ */
+declare function cartesianProduct<T, U, V, W>(arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): (array: readonly T[]) => Array<[T, U, V, W]>;
+/**
+ * Creates a function that computes the cartesian product of the piped array and any number of configured arrays.
+ *
+ * @template T - The shared element type of the arrays.
+ * @param arrs - Additional arrays included in the cartesian product.
+ * @returns A function that maps the piped array to cartesian product rows.
+ */
+declare function cartesianProduct<T>(...arrs: Array<readonly T[]>): (array: readonly T[]) => T[][];
+//#endregion
+export { cartesianProduct };

package/dist/fp/array/cartesianProduct.js

@@ -0,0 +1,9 @@
+const require_cartesianProduct = require("../../array/cartesianProduct.js");
+//#region src/fp/array/cartesianProduct.ts
+function cartesianProduct(...arrs) {
+	return function(array) {
+		return require_cartesianProduct.cartesianProduct(array, ...arrs);
+	};
+}
+//#endregion
+exports.cartesianProduct = cartesianProduct;

package/dist/fp/array/cartesianProduct.mjs

@@ -0,0 +1,9 @@
+import { cartesianProduct as cartesianProduct$1 } from "../../array/cartesianProduct.mjs";
+//#region src/fp/array/cartesianProduct.ts
+function cartesianProduct(...arrs) {
+	return function(array) {
+		return cartesianProduct$1(array, ...arrs);
+	};
+}
+//#endregion
+export { cartesianProduct };

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

@@ -0,0 +1,19 @@
+//#region src/fp/array/chunk.d.ts
+/**
+ * Creates a function that splits an array into sub-arrays of length `size`. The
+ * final chunk holds the remaining elements when the array cannot be divided
+ * evenly. Use it with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param size - The length of each chunk. Must be a positive integer.
+ * @returns A function that maps a `readonly T[]` to a `T[][]`.
+ * @throws {Error} When `size` is not a positive integer (propagated from the underlying implementation).
+ *
+ * @example
+ * import { pipe, chunk } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3, 4, 5], chunk(2)); // => [[1, 2], [3, 4], [5]]
+ */
+declare function chunk<T>(size: number): (array: readonly T[]) => T[][];
+//#endregion
+export { chunk };

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

@@ -0,0 +1,19 @@
+//#region src/fp/array/chunk.d.ts
+/**
+ * Creates a function that splits an array into sub-arrays of length `size`. The
+ * final chunk holds the remaining elements when the array cannot be divided
+ * evenly. Use it with {@link pipe}.
+ *
+ * @template T - The type of elements in the array.
+ * @param size - The length of each chunk. Must be a positive integer.
+ * @returns A function that maps a `readonly T[]` to a `T[][]`.
+ * @throws {Error} When `size` is not a positive integer (propagated from the underlying implementation).
+ *
+ * @example
+ * import { pipe, chunk } from 'es-toolkit/fp';
+ *
+ * pipe([1, 2, 3, 4, 5], chunk(2)); // => [[1, 2], [3, 4], [5]]
+ */
+declare function chunk<T>(size: number): (array: readonly T[]) => T[][];
+//#endregion
+export { chunk };

package/dist/fp/array/chunk.js

@@ -0,0 +1,24 @@
+const require_chunk = require("../../array/chunk.js");
+//#region src/fp/array/chunk.ts
+/**
+* Creates a function that splits an array into sub-arrays of length `size`. The
+* final chunk holds the remaining elements when the array cannot be divided
+* evenly. Use it with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param size - The length of each chunk. Must be a positive integer.
+* @returns A function that maps a `readonly T[]` to a `T[][]`.
+* @throws {Error} When `size` is not a positive integer (propagated from the underlying implementation).
+*
+* @example
+* import { pipe, chunk } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3, 4, 5], chunk(2)); // => [[1, 2], [3, 4], [5]]
+*/
+function chunk(size) {
+	return function(array) {
+		return require_chunk.chunk(array, size);
+	};
+}
+//#endregion
+exports.chunk = chunk;

package/dist/fp/array/chunk.mjs

@@ -0,0 +1,24 @@
+import { chunk as chunk$1 } from "../../array/chunk.mjs";
+//#region src/fp/array/chunk.ts
+/**
+* Creates a function that splits an array into sub-arrays of length `size`. The
+* final chunk holds the remaining elements when the array cannot be divided
+* evenly. Use it with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @param size - The length of each chunk. Must be a positive integer.
+* @returns A function that maps a `readonly T[]` to a `T[][]`.
+* @throws {Error} When `size` is not a positive integer (propagated from the underlying implementation).
+*
+* @example
+* import { pipe, chunk } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3, 4, 5], chunk(2)); // => [[1, 2], [3, 4], [5]]
+*/
+function chunk(size) {
+	return function(array) {
+		return chunk$1(array, size);
+	};
+}
+//#endregion
+export { chunk };