es-toolkit 1.52.0-dev.2132 → 1.52.0-dev.2133

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

@@ -1,20 +1,4 @@
 //#region src/fp/array/head.d.ts
-/**
- * Creates a function that returns the first element of a non-empty array.
- *
- * This overload preserves the non-empty tuple guarantee: the returned function
- * always returns T when the piped array has at least one element.
- *
- * @template T - The type of elements in the array.
- * @returns A function that maps a non-empty readonly array to its first element.
- *
- * @example
- * import { head, pipe } from 'es-toolkit/fp';
- *
- * pipe([1, 2, 3] as const, head());
- * // => 1
- */
-declare function head<T>(): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the first element of an array, or undefined.
  *
@@ -27,6 +11,9 @@ declare function head<T>(): (array: readonly [T, ...T[]]) => T;
  * @example
  * import { head, pipe } from 'es-toolkit/fp';
  *
+ * pipe([1, 2, 3], head());
+ * // => 1
+ *
  * pipe([] as number[], head());
  * // => undefined
  */

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

@@ -1,20 +1,4 @@
 //#region src/fp/array/head.d.ts
-/**
- * Creates a function that returns the first element of a non-empty array.
- *
- * This overload preserves the non-empty tuple guarantee: the returned function
- * always returns T when the piped array has at least one element.
- *
- * @template T - The type of elements in the array.
- * @returns A function that maps a non-empty readonly array to its first element.
- *
- * @example
- * import { head, pipe } from 'es-toolkit/fp';
- *
- * pipe([1, 2, 3] as const, head());
- * // => 1
- */
-declare function head<T>(): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the first element of an array, or undefined.
  *
@@ -27,6 +11,9 @@ declare function head<T>(): (array: readonly [T, ...T[]]) => T;
  * @example
  * import { head, pipe } from 'es-toolkit/fp';
  *
+ * pipe([1, 2, 3], head());
+ * // => 1
+ *
  * pipe([] as number[], head());
  * // => undefined
  */

package/dist/fp/array/head.js

@@ -1,5 +1,23 @@
 const require_head = require("../../array/head.js");
 //#region src/fp/array/head.ts
+/**
+* Creates a function that returns the first element of an array, or undefined.
+*
+* Empty arrays return undefined, matching the main {@link head} behavior. Use
+* the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to its first element, or undefined.
+*
+* @example
+* import { head, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], head());
+* // => 1
+*
+* pipe([] as number[], head());
+* // => undefined
+*/
 function head() {
 	return function(array) {
 		return require_head.head(array);

package/dist/fp/array/head.mjs

@@ -1,5 +1,23 @@
 import { head as head$1 } from "../../array/head.mjs";
 //#region src/fp/array/head.ts
+/**
+* Creates a function that returns the first element of an array, or undefined.
+*
+* Empty arrays return undefined, matching the main {@link head} behavior. Use
+* the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to its first element, or undefined.
+*
+* @example
+* import { head, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], head());
+* // => 1
+*
+* pipe([] as number[], head());
+* // => undefined
+*/
 function head() {
 	return function(array) {
 		return head$1(array);

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

@@ -1,20 +1,4 @@
 //#region src/fp/array/last.d.ts
-/**
- * Creates a function that returns the last element of a non-empty array.
- *
- * This overload preserves the non-empty tuple guarantee: the returned function
- * always returns T when the piped array has at least one element.
- *
- * @template T - The type of elements in the array.
- * @returns A function that maps a non-empty readonly array to its last element.
- *
- * @example
- * import { last, pipe } from 'es-toolkit/fp';
- *
- * pipe([1, 2, 3] as const, last());
- * // => 3
- */
-declare function last<T>(): (array: readonly [...T[], T]) => T;
 /**
  * Creates a function that returns the last element of an array, or undefined.
  *
@@ -27,6 +11,9 @@ declare function last<T>(): (array: readonly [...T[], T]) => T;
  * @example
  * import { last, pipe } from 'es-toolkit/fp';
  *
+ * pipe([1, 2, 3], last());
+ * // => 3
+ *
  * pipe([] as number[], last());
  * // => undefined
  */

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

@@ -1,20 +1,4 @@
 //#region src/fp/array/last.d.ts
-/**
- * Creates a function that returns the last element of a non-empty array.
- *
- * This overload preserves the non-empty tuple guarantee: the returned function
- * always returns T when the piped array has at least one element.
- *
- * @template T - The type of elements in the array.
- * @returns A function that maps a non-empty readonly array to its last element.
- *
- * @example
- * import { last, pipe } from 'es-toolkit/fp';
- *
- * pipe([1, 2, 3] as const, last());
- * // => 3
- */
-declare function last<T>(): (array: readonly [...T[], T]) => T;
 /**
  * Creates a function that returns the last element of an array, or undefined.
  *
@@ -27,6 +11,9 @@ declare function last<T>(): (array: readonly [...T[], T]) => T;
  * @example
  * import { last, pipe } from 'es-toolkit/fp';
  *
+ * pipe([1, 2, 3], last());
+ * // => 3
+ *
  * pipe([] as number[], last());
  * // => undefined
  */

package/dist/fp/array/last.js

@@ -1,5 +1,23 @@
 const require_last = require("../../array/last.js");
 //#region src/fp/array/last.ts
+/**
+* Creates a function that returns the last element of an array, or undefined.
+*
+* Empty arrays return undefined, matching the main {@link last} behavior. Use
+* the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to its last element, or undefined.
+*
+* @example
+* import { last, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], last());
+* // => 3
+*
+* pipe([] as number[], last());
+* // => undefined
+*/
 function last() {
 	return function(array) {
 		return require_last.last(array);

package/dist/fp/array/last.mjs

@@ -1,5 +1,23 @@
 import { last as last$1 } from "../../array/last.mjs";
 //#region src/fp/array/last.ts
+/**
+* Creates a function that returns the last element of an array, or undefined.
+*
+* Empty arrays return undefined, matching the main {@link last} behavior. Use
+* the returned function with {@link pipe}.
+*
+* @template T - The type of elements in the array.
+* @returns A function that maps a readonly array to its last element, or undefined.
+*
+* @example
+* import { last, pipe } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], last());
+* // => 3
+*
+* pipe([] as number[], last());
+* // => undefined
+*/
 function last() {
 	return function(array) {
 		return last$1(array);

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

@@ -1,21 +1,4 @@
 //#region src/fp/array/maxBy.d.ts
-/**
- * Creates a function that returns the element with the maximum selected number from a non-empty array.
- *
- * If the selector returns NaN, the element that produced NaN is returned, matching
- * the main {@link maxBy} behavior.
- *
- * @template T - The type of elements in the array.
- * @param getValue - Selects a numeric value from each element, index, and array.
- * @returns A function that maps a non-empty readonly array to the maximum element.
- *
- * @example
- * import { maxBy, pipe } from 'es-toolkit/fp';
- *
- * pipe([{ score: 10 }, { score: 20 }] as const, maxBy(item => item.score));
- * // => { score: 20 }
- */
-declare function maxBy<T>(getValue: (element: T, index: number, array: readonly T[]) => number): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the element with the maximum selected number.
  *
@@ -29,6 +12,9 @@ declare function maxBy<T>(getValue: (element: T, index: number, array: readonly
  * @example
  * import { maxBy, pipe } from 'es-toolkit/fp';
  *
+ * pipe([{ score: 10 }, { score: 20 }], maxBy(item => item.score));
+ * // => { score: 20 }
+ *
  * pipe([] as Array<{ score: number }>, maxBy(item => item.score));
  * // => undefined
  */

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

@@ -1,21 +1,4 @@
 //#region src/fp/array/maxBy.d.ts
-/**
- * Creates a function that returns the element with the maximum selected number from a non-empty array.
- *
- * If the selector returns NaN, the element that produced NaN is returned, matching
- * the main {@link maxBy} behavior.
- *
- * @template T - The type of elements in the array.
- * @param getValue - Selects a numeric value from each element, index, and array.
- * @returns A function that maps a non-empty readonly array to the maximum element.
- *
- * @example
- * import { maxBy, pipe } from 'es-toolkit/fp';
- *
- * pipe([{ score: 10 }, { score: 20 }] as const, maxBy(item => item.score));
- * // => { score: 20 }
- */
-declare function maxBy<T>(getValue: (element: T, index: number, array: readonly T[]) => number): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the element with the maximum selected number.
  *
@@ -29,6 +12,9 @@ declare function maxBy<T>(getValue: (element: T, index: number, array: readonly
  * @example
  * import { maxBy, pipe } from 'es-toolkit/fp';
  *
+ * pipe([{ score: 10 }, { score: 20 }], maxBy(item => item.score));
+ * // => { score: 20 }
+ *
  * pipe([] as Array<{ score: number }>, maxBy(item => item.score));
  * // => undefined
  */

package/dist/fp/array/maxBy.js

@@ -1,5 +1,24 @@
 const require_maxBy = require("../../array/maxBy.js");
 //#region src/fp/array/maxBy.ts
+/**
+* Creates a function that returns the element with the maximum selected number.
+*
+* Empty arrays return undefined. If the selector returns NaN, the element that
+* produced NaN is returned, matching the main {@link maxBy} behavior.
+*
+* @template T - The type of elements in the array.
+* @param getValue - Selects a numeric value from each element, index, and array.
+* @returns A function that maps a readonly array to the maximum element, or undefined.
+*
+* @example
+* import { maxBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ score: 10 }, { score: 20 }], maxBy(item => item.score));
+* // => { score: 20 }
+*
+* pipe([] as Array<{ score: number }>, maxBy(item => item.score));
+* // => undefined
+*/
 function maxBy(getValue) {
 	return function(array) {
 		return require_maxBy.maxBy(array, getValue);

package/dist/fp/array/maxBy.mjs

@@ -1,5 +1,24 @@
 import { maxBy as maxBy$1 } from "../../array/maxBy.mjs";
 //#region src/fp/array/maxBy.ts
+/**
+* Creates a function that returns the element with the maximum selected number.
+*
+* Empty arrays return undefined. If the selector returns NaN, the element that
+* produced NaN is returned, matching the main {@link maxBy} behavior.
+*
+* @template T - The type of elements in the array.
+* @param getValue - Selects a numeric value from each element, index, and array.
+* @returns A function that maps a readonly array to the maximum element, or undefined.
+*
+* @example
+* import { maxBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ score: 10 }, { score: 20 }], maxBy(item => item.score));
+* // => { score: 20 }
+*
+* pipe([] as Array<{ score: number }>, maxBy(item => item.score));
+* // => undefined
+*/
 function maxBy(getValue) {
 	return function(array) {
 		return maxBy$1(array, getValue);

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

@@ -1,21 +1,4 @@
 //#region src/fp/array/minBy.d.ts
-/**
- * Creates a function that returns the element with the minimum selected number from a non-empty array.
- *
- * If the selector returns NaN, the element that produced NaN is returned, matching
- * the main {@link minBy} behavior.
- *
- * @template T - The type of elements in the array.
- * @param getValue - Selects a numeric value from each element, index, and array.
- * @returns A function that maps a non-empty readonly array to the minimum element.
- *
- * @example
- * import { minBy, pipe } from 'es-toolkit/fp';
- *
- * pipe([{ score: 10 }, { score: 20 }] as const, minBy(item => item.score));
- * // => { score: 10 }
- */
-declare function minBy<T>(getValue: (element: T, index: number, array: readonly T[]) => number): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the element with the minimum selected number.
  *
@@ -29,6 +12,9 @@ declare function minBy<T>(getValue: (element: T, index: number, array: readonly
  * @example
  * import { minBy, pipe } from 'es-toolkit/fp';
  *
+ * pipe([{ score: 10 }, { score: 20 }], minBy(item => item.score));
+ * // => { score: 10 }
+ *
  * pipe([] as Array<{ score: number }>, minBy(item => item.score));
  * // => undefined
  */

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

@@ -1,21 +1,4 @@
 //#region src/fp/array/minBy.d.ts
-/**
- * Creates a function that returns the element with the minimum selected number from a non-empty array.
- *
- * If the selector returns NaN, the element that produced NaN is returned, matching
- * the main {@link minBy} behavior.
- *
- * @template T - The type of elements in the array.
- * @param getValue - Selects a numeric value from each element, index, and array.
- * @returns A function that maps a non-empty readonly array to the minimum element.
- *
- * @example
- * import { minBy, pipe } from 'es-toolkit/fp';
- *
- * pipe([{ score: 10 }, { score: 20 }] as const, minBy(item => item.score));
- * // => { score: 10 }
- */
-declare function minBy<T>(getValue: (element: T, index: number, array: readonly T[]) => number): (array: readonly [T, ...T[]]) => T;
 /**
  * Creates a function that returns the element with the minimum selected number.
  *
@@ -29,6 +12,9 @@ declare function minBy<T>(getValue: (element: T, index: number, array: readonly
  * @example
  * import { minBy, pipe } from 'es-toolkit/fp';
  *
+ * pipe([{ score: 10 }, { score: 20 }], minBy(item => item.score));
+ * // => { score: 10 }
+ *
  * pipe([] as Array<{ score: number }>, minBy(item => item.score));
  * // => undefined
  */

package/dist/fp/array/minBy.js

@@ -1,5 +1,24 @@
 const require_minBy = require("../../array/minBy.js");
 //#region src/fp/array/minBy.ts
+/**
+* Creates a function that returns the element with the minimum selected number.
+*
+* Empty arrays return undefined. If the selector returns NaN, the element that
+* produced NaN is returned, matching the main {@link minBy} behavior.
+*
+* @template T - The type of elements in the array.
+* @param getValue - Selects a numeric value from each element, index, and array.
+* @returns A function that maps a readonly array to the minimum element, or undefined.
+*
+* @example
+* import { minBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ score: 10 }, { score: 20 }], minBy(item => item.score));
+* // => { score: 10 }
+*
+* pipe([] as Array<{ score: number }>, minBy(item => item.score));
+* // => undefined
+*/
 function minBy(getValue) {
 	return function(array) {
 		return require_minBy.minBy(array, getValue);

package/dist/fp/array/minBy.mjs

@@ -1,5 +1,24 @@
 import { minBy as minBy$1 } from "../../array/minBy.mjs";
 //#region src/fp/array/minBy.ts
+/**
+* Creates a function that returns the element with the minimum selected number.
+*
+* Empty arrays return undefined. If the selector returns NaN, the element that
+* produced NaN is returned, matching the main {@link minBy} behavior.
+*
+* @template T - The type of elements in the array.
+* @param getValue - Selects a numeric value from each element, index, and array.
+* @returns A function that maps a readonly array to the minimum element, or undefined.
+*
+* @example
+* import { minBy, pipe } from 'es-toolkit/fp';
+*
+* pipe([{ score: 10 }, { score: 20 }], minBy(item => item.score));
+* // => { score: 10 }
+*
+* pipe([] as Array<{ score: number }>, minBy(item => item.score));
+* // => undefined
+*/
 function minBy(getValue) {
 	return function(array) {
 		return minBy$1(array, getValue);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.52.0-dev.2132+19bd2cb1",
+  "version": "1.52.0-dev.2133+1708d315",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",